From 28d218b3a2c17ff1b5b373b52b24b8d3000bfd2e Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 16:48:13 +0200 Subject: [PATCH 001/163] Guests: a bed puts the guest to sleep, not the host The bed's sleeping state, timer and respawn point were the host's fields, so a guest clicking a bed put the host to sleep and moved the host's spawn. as_guest now swaps them with the guest's own; the guest gets its sleeping pose and bed (entity data 14), wakes on STOP_SLEEPING with the WAKE_UP animation, and the night skips only once enough players sleep (players_sleeping_percentage). Guests respawn at their own bed, else the world spawn. Server clients lie in the bed from the synced position. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game.rs | 52 +++++---- crates/horizon-client/src/game/agent.rs | 2 + crates/horizon-client/src/game/lan.rs | 1 + crates/horizon-client/src/game/lan_actions.rs | 106 +++++++++++++++++- crates/horizon-client/src/game/remote.rs | 34 +++++- crates/horizon-client/src/lan/guest.rs | 12 ++ crates/horizon-client/src/lan/hub.rs | 37 +++++- crates/horizon-client/src/lan/playerdata.rs | 2 + tools/lan_e2e.py | 54 ++++++++- 9 files changed, 273 insertions(+), 27 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 238f68e55..5ce509705 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -8057,40 +8057,48 @@ impl Game<'_> { self.stats.reset("custom", "minecraft:time_since_rest"); } fn wake_up(&mut self) { + if self.remote.is_some() { + // InBedChatScreen.sendWakeUp: the server wakes the player. + self.remote_stop_sleeping(); + return; + } self.sleeping = None; self.sleep_timer = 100; } fn tick_sleep(&mut self) { self.sleep_timer = tick_sleep_timer(self.sleep_timer, self.sleeping.is_some()); - let Some(head) = self.sleeping else { - return; - }; - if self.keys.contains(&KeyCode::ShiftLeft) - || self - .player - .as_ref() - .is_none_or(|p| p.health.dead_or_dying()) - { - self.wake_up(); - return; + if let Some(head) = self.sleeping { + if self.keys.contains(&KeyCode::ShiftLeft) + || self + .player + .as_ref() + .is_none_or(|p| p.health.dead_or_dying()) + { + self.wake_up(); + return; + } + if let Some(p) = self.player.as_mut() { + p.position = Vec3::new( + f64::from(head[0]) + 0.5, + f64::from(head[1]) + 0.5625, + f64::from(head[2]) + 0.5, + ); + p.velocity = Vec3::ZERO; + } } - if let Some(p) = self.player.as_mut() { - p.position = Vec3::new( - f64::from(head[0]) + 0.5, - f64::from(head[1]) + 0.5625, - f64::from(head[2]) + 0.5, - ); - p.velocity = Vec3::ZERO; - } - // ServerLevel: once everyone has slept 100 ticks, skip to morning and clear weather. - if self.sleep_timer >= 100 { + // ServerLevel.tick: once enough of the players have slept 100 ticks, + // skip to morning, clear the weather and wake everyone. + if self.enough_slept() { let t = self.world.day_time; self.world.day_time = t + 24000 - t.rem_euclid(24000); self.world.weather.raining = false; self.world.weather.thundering = false; self.world.weather.rain_time = 0; self.world.weather.thunder_time = 0; - self.wake_up(); + if self.sleeping.is_some() { + self.wake_up(); + } + self.wake_guests(); } } fn creative_origin(batch: &HudBatch) -> (f32, f32) { diff --git a/crates/horizon-client/src/game/agent.rs b/crates/horizon-client/src/game/agent.rs index 48b24bbb3..11e4cef07 100644 --- a/crates/horizon-client/src/game/agent.rs +++ b/crates/horizon-client/src/game/agent.rs @@ -466,6 +466,8 @@ impl Game<'_> { }), "dimension": self.dim.id(), "gamemode": format!("{:?}", self.mode).to_lowercase(), + // The bed (its head) the player sleeps in. + "sleeping": self.sleeping, "time": { "day_time": self.world.day_time, "day": self.world.day_time.div_euclid(24000), "time_of_day": self.world.day_time.rem_euclid(24000) }, "weather": { "raining": self.world.weather.raining, "thundering": self.world.weather.thundering }, "paused": self.pause, diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index d574b8928..1c149ba00 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -370,6 +370,7 @@ impl Game<'_> { "loaded": g.loaded, "game_mode": g.game_mode, "sneaking": g.sneaking, + "sleeping": g.bed, "health": g.health, // FoodData: food level, saturation and exhaustion. "food": [ diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index 7cd4b0474..380fa09ec 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -163,6 +163,16 @@ impl Game<'_> { self.right = play.using.is_some() || self.using.is_some(); let riding = self.riding.take(); 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. + let sleeping = std::mem::replace(&mut self.sleeping, g.bed); + let sleep_timer = std::mem::replace(&mut self.sleep_timer, g.sleep_timer); + let spawn = std::mem::replace( + &mut self.spawn, + g.spawn.map(|s| Vec3::new(s[0], s[1], s[2])), + ); + let respawn = (self.respawn_config.take(), self.level.spawn); + let message = self.message.take(); // The guest's own ender inventory; one the host has open goes back // into the host's while the guest acts. let host_ender = self.ender_open; @@ -194,6 +204,12 @@ impl Game<'_> { let opened_table = std::mem::replace(&mut self.craft_size, craft_size) == 3; self.craft_grid = craft_grid; let opened_station = std::mem::replace(&mut self.station, host_station); + let bed = std::mem::replace(&mut self.sleeping, sleeping); + let guest_sleep_timer = std::mem::replace(&mut self.sleep_timer, sleep_timer); + let guest_spawn = std::mem::replace(&mut self.spawn, spawn).map(|s| [s.x, s.y, s.z]); + (self.respawn_config, self.level.spawn) = respawn; + // ServerPlayer.displayClientMessage(_, true): the guest's action bar. + let guest_message = std::mem::replace(&mut self.message, message); self.riding = riding; self.left = left; self.right = right; @@ -211,6 +227,15 @@ impl Game<'_> { self.keys.remove(&KeyCode::ShiftLeft); } let g = &mut host.hub.guests[i]; + let fell_asleep = bed.is_some() && g.bed.is_none(); + (g.bed, g.sleep_timer, g.spawn) = (bed, guest_sleep_timer, guest_spawn); + g.sleeping = g.bed.is_some(); + if let Some((text, _)) = guest_message { + g.send(&C::SystemChat(play::SystemChat { + content: literal(&text), + overlay: true, + })); + } std::mem::swap(&mut self.ender_items, &mut g.ender_items); std::mem::swap(&mut self.adv.progress, &mut g.advancements); std::mem::swap(&mut self.adv.changed, &mut g.advancements_changed); @@ -260,6 +285,19 @@ impl Game<'_> { } } let g = &mut host.hub.guests[i]; + if let Some(head) = g.bed.filter(|_| fell_asleep) { + // LivingEntity.startSleeping: in the bed, still. + let at = [ + f64::from(head[0]) + 0.5, + f64::from(head[1]) + 0.5625, + f64::from(head[2]) + 0.5, + ]; + g.position = at; + if let Some(m) = g.motion.as_mut() { + m.position = Vec3::new(at[0], at[1], at[2]); + m.velocity = Vec3::ZERO; + } + } if new_mode != g.game_mode { let conn = g.conn; host.hub.set_game_mode(conn, new_mode); @@ -903,10 +941,19 @@ impl Game<'_> { } fn guest_respawn(&mut self, host: &mut LanHost, conn: u32) { - let spawn = self.spawn.map_or([0.5, 80.0, 0.5], |s| [s.x, s.y, s.z]); let Some(i) = host.hub.guests.iter().position(|g| g.conn == conn) else { return; }; + // The guest's own bed, else the world spawn: never the host's bed. + let world = self + .level + .world_spawn + .map(|[x, y, z]| [f64::from(x) + 0.5, f64::from(y), f64::from(z) + 0.5]); + let spawn = host.hub.guests[i] + .spawn + .or(world) + .or(self.spawn.map(|s| [s.x, s.y, s.z])) + .unwrap_or([0.5, 80.0, 0.5]); if !host.hub.guests[i].dead { return; } @@ -964,6 +1011,7 @@ impl Game<'_> { let Some(gi) = host.hub.guests.iter().position(|g| g.conn == conn) else { continue; }; + self.guest_sleep_tick(host, gi); if host.hub.guests[gi].dead || self.on_server_trip(conn) { continue; } @@ -1029,6 +1077,62 @@ impl Game<'_> { } } + /// `Player.tick`'s sleep counter, and `LivingEntity.tick`'s wake-up of a + /// sleeper who died or whose bed is gone. + fn guest_sleep_tick(&mut self, host: &mut LanHost, gi: usize) { + let g = &mut host.hub.guests[gi]; + g.sleep_timer = super::tick_sleep_timer(g.sleep_timer, g.bed.is_some()); + if let Some(head) = g.bed { + let block = self.world.block(head[0], head[1], head[2]); + let bed = self.res.facts.get(block).name.ends_with("_bed"); + if g.dead || g.health <= 0.0 || !bed { + host.hub.wake(gi); + } + } + } + + /// `SleepStatus.areEnoughSleeping` and `areEnoughDeepSleeping` over the + /// host's player and the guests: of the players not in spectator mode, + /// players_sleeping_percentage of them (at least one) are in bed, and as + /// many have slept 100 ticks. + pub(super) fn enough_slept(&self) -> bool { + let (mut active, mut sleeping, mut deep) = (0i64, 0i64, 0i64); + let mut count = |in_bed: bool, timer: u32| { + active += 1; + if in_bed { + sleeping += 1; + if timer >= 100 { + deep += 1; + } + } + }; + if self.player.is_some() && !self.spectator() { + count(self.sleeping.is_some(), self.sleep_timer); + } + if let Some(host) = self.lan.as_ref() { + for g in host + .hub + .guests + .iter() + .filter(|g| g.placed && !g.spectator()) + { + count(g.bed.is_some(), g.sleep_timer); + } + } + let percent = i64::from(self.ui.rules.int("players_sleeping_percentage").max(0)); + let needed = ((active * percent + 99) / 100).max(1); + sleeping >= needed && deep >= needed + } + + /// `ServerLevel.wakeUpAllPlayers` for the guests. + pub(super) fn wake_guests(&mut self) { + if let Some(host) = self.lan.as_mut() { + for i in 0..host.hub.guests.len() { + host.hub.wake(i); + } + } + } + /// `PlayerList.broadcastSystemMessage` of the advancements guests made /// (their own actions, commands and ticks). fn announce_guest_advancements(&mut self, host: &mut LanHost) { diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 05e1f81c3..0a2c987d1 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -760,6 +760,7 @@ impl Game<'_> { 0 => { if me { self.sleeping = None; + self.sleep_timer = 100; } return; } @@ -1271,6 +1272,18 @@ impl Game<'_> { } } } + // LivingEntity.onSyncedDataUpdated(SLEEPING_POS_ID): this + // player lies down in the bed, or gets up. + if self.remote.as_ref().is_some_and(|r| r.entity_id == p.id) { + for (index, _, value) in &p.values { + if let (14, Value::OptPos(bed)) = (index, value) { + if bed.is_some() && self.sleeping.is_none() { + self.sleep_timer = 0; + } + self.sleeping = *bed; + } + } + } for (index, _, value) in &p.values { if *index == ITEM_ENTITY_ITEM && let Value::Item(stack) = value @@ -2124,6 +2137,8 @@ impl Game<'_> { self.tick_hand(); self.tick_particles(); self.tick_client_effects(); + // Player.tick's sleep counter (the darkening and the wake-up fade). + self.sleep_timer = super::tick_sleep_timer(self.sleep_timer, self.sleeping.is_some()); let ghast_collisions = self.happy_ghast_player_collisions(); let Some(player) = self.player.as_mut() else { return Ok(()); @@ -2176,7 +2191,15 @@ impl Game<'_> { ); player.yaw = self.yaw; let dead = self.screen == Screen::Dead; - if !dead { + // LivingEntity.isImmobile: a sleeper lies still in the bed. + if let Some(head) = self.sleeping { + player.position = Vec3::new( + f64::from(head[0]) + 0.5, + f64::from(head[1]) + 0.5625, + f64::from(head[2]) + 0.5, + ); + player.velocity = Vec3::ZERO; + } else if !dead { MotionWorld { entities: &ghast_collisions, player, @@ -3134,6 +3157,15 @@ impl Game<'_> { .ok()?; Some((rows, r.menu_title.clone().unwrap_or_default())) } + /// ServerboundPlayerCommandPacket STOP_SLEEPING. + pub(super) fn remote_stop_sleeping(&mut self) { + let id = self.remote.as_ref().map_or(0, |r| r.entity_id); + self.send(S::PlayerCommand(play::PlayerCommand { + id, + action: 0, + data: 0, + })); + } pub(super) fn remote_respawn(&mut self) { self.send(S::ClientCommand(play::ClientCommand { action: 0 })); } diff --git a/crates/horizon-client/src/lan/guest.rs b/crates/horizon-client/src/lan/guest.rs index b0ecf772f..a397e8bc3 100644 --- a/crates/horizon-client/src/lan/guest.rs +++ b/crates/horizon-client/src/lan/guest.rs @@ -69,6 +69,14 @@ pub struct Guest { pub fall_flying: bool, pub flying: bool, pub sleeping: bool, + /// The bed (its head) the player sleeps in (`LivingEntity.getSleepingPos`), + /// `Player.sleepCounter`, and the bed last told to the player itself. + pub bed: Option<[i32; 3]>, + pub sleep_timer: u32, + pub sent_bed: Option<[i32; 3]>, + /// Where the player respawns (a bed's spot; `ServerPlayer.respawnConfig`), + /// None for the world spawn. + pub spawn: Option<[f64; 3]>, /// Pending ClientboundPlayerPositionPacket id; movement is ignored until /// the client accepts it (ServerGamePacketListenerImpl.awaitingPositionFromClient). pub awaiting_teleport: Option<(i32, [f64; 3])>, @@ -201,6 +209,10 @@ impl Guest { fall_flying: false, flying: false, sleeping: false, + bed: None, + sleep_timer: 0, + sent_bed: None, + spawn: None, awaiting_teleport: None, teleport_counter: 0, teleport_tick: 0, diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index 598bbc088..cac03821b 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -1439,10 +1439,44 @@ impl Hub { } } + /// ServerPlayer.stopSleepInBed: the wake-up animation goes to the player + /// and those around, the pose is standing again and the sleep counter + /// starts the wake-up fade (100). + pub fn wake(&mut self, i: usize) { + let g = &mut self.guests[i]; + if g.bed.take().is_none() && !g.sleeping { + return; + } + g.sleeping = false; + g.sleep_timer = 100; + let (id, at) = (g.entity_id, g.position); + // ClientboundAnimatePacket.WAKE_UP. + self.broadcast_near( + at, + 128.0, + &C::Animate(play::Animate { id, action: 0 }), + None, + ); + } + // ---- per-player state ------------------------------------------------ /// ServerPlayer.doTick: health, food, experience and the inventory menu. fn sync_player_state(&mut self, i: usize) { + // LivingEntity.startSleeping / stopSleeping: the pose and the bed go + // to the player too (its client lies down in the bed from them). + let g = &mut self.guests[i]; + if g.bed != g.sent_bed { + g.sent_bed = g.bed; + let pose = if g.bed.is_some() { 2 } else { 0 }; + g.send(&C::SetEntityData(play::SetEntityData { + id: g.entity_id, + values: vec![ + (6, serializer::POSE, Value::Id(pose)), + (14, serializer::OPTIONAL_BLOCK_POS, Value::OptPos(g.bed)), + ], + })); + } // ServerEntity.sendDirtyEntityData on the player's first tick: the // health its creation set is still dirty, and goes to the player too. if self.guests[i].sent_health.is_none() { @@ -1691,7 +1725,8 @@ impl Hub { 1 => self.guests[i].sprinting = true, 2 => self.guests[i].sprinting = false, 6 => self.guests[i].fall_flying = true, - 0 => self.guests[i].sleeping = false, + // STOP_SLEEPING. + 0 => self.wake(i), _ => {} }, S::Chat(c) => { diff --git a/crates/horizon-client/src/lan/playerdata.rs b/crates/horizon-client/src/lan/playerdata.rs index 555463685..770120879 100644 --- a/crates/horizon-client/src/lan/playerdata.rs +++ b/crates/horizon-client/src/lan/playerdata.rs @@ -69,6 +69,7 @@ pub fn apply(guest: &mut Guest, level: &Level) { guest.effects = crate::effects::PlayerEffects::from_saved(&level.active_effects); guest.game_mode = level.mode(); guest.selected = (level.selected_slot.max(0) as usize).min(8); + guest.spawn = level.spawn.map(|s| [s[0] + 0.5, s[1], s[2] + 0.5]); guest.saved = level.player_extra.clone(); guest.recipe_book = level.recipe_book.clone(); if level.ender_items.len() == 27 { @@ -125,6 +126,7 @@ pub fn store(guest: &Guest, level: &mut Level) { level.game_mode = guest.game_mode; level.creative = guest.game_mode == 1; level.selected_slot = guest.selected as i32; + level.spawn = guest.spawn.map(|s| [s[0] - 0.5, s[1], s[2] - 0.5]); level.on_ground = guest.on_ground; level.player_extra = guest.saved.clone(); level.recipe_book = guest.recipe_book.clone(); diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 667fdda2d..c4d5969e4 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -20,6 +20,8 @@ address. The script then checks, from both sides, what a guest's game used to ge - containers: the guest's ender chest holds the guest's items, not the host's, and a double chest opens as 9x6 with the right half first; - feedback: the guest's command feedback names the guest and shows the numbers. +- sleep: at night the guest lies down in its own bed (not the host); alone it stays night, it + gets up with Escape, and once the host sleeps too the night ends and both wake. Each check is reported on its own (a failing one doesn't stop the others) and the screenshots of both sides go to --out (host-*.png, guest-*.png). @@ -48,7 +50,7 @@ from agent_control_e2e import Cli, Failed, game_env # noqa: E402 ROOT = Path(__file__).resolve().parents[1] GUEST_NAME = 'Guest' -CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'damage', 'mobs', 'hazards', 'pvp', 'containers', 'feedback', 'trials'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'damage', 'mobs', 'hazards', 'pvp', 'containers', 'feedback', 'trials', 'sleep'] class Game: @@ -622,11 +624,59 @@ def check_trials(host, guest, out): return {'spawner': trial, 'vault': active, 'rewarded': uuid(rewarded), 'host': uuid(host_uuid)} +def bed_at(game, foot): + """A bed whose foot is at `foot`, its head one block east.""" + x, y, z = foot + game('command', command=f'setblock {x} {y} {z} minecraft:red_bed[facing=east,part=foot]') + game('command', command=f'setblock {x + 1} {y} {z} minecraft:red_bed[facing=east,part=head]') + return [x + 1, y, z] + + +def check_sleep(host, guest, out): + for g in (host, guest): + g('command', command='gamemode survival') + host('command', command='time set midnight') + gx, gy, gz = (int(v // 1) for v in pos_of(guest)) + hx, hy, hz = (int(v // 1) for v in pos_of(host)) + guest_bed = bed_at(guest, (gx, gy, gz + 2)) + host_bed = bed_at(host, (hx, hy, hz + 2)) + guest.wait(10) + guest.raw('interact', *guest_bed) + guest.wait(10) + asleep = {'guest': guest('state').get('sleeping'), 'host': host('state').get('sleeping'), + 'server': host.raw('lan', 'status')['guests'][0].get('sleeping')} + guest.shot(out, 'sleep-guest') + # Alone in bed: still night 120 ticks later (everyone must sleep). + guest.wait(120) + night = host('state')['time']['time_of_day'] + # Escape gets the guest up (InBedChatScreen), then back to bed. + guest.raw('key', 'esc', 'tap') + guest.wait(10) + up = guest('state').get('sleeping') + guest.raw('interact', *guest_bed) + host.raw('interact', *host_bed) + host.wait(130) + after = {'guest': guest('state').get('sleeping'), 'host': host('state').get('sleeping'), + 'time': host('state')['time']['time_of_day']} + guest.shot(out, 'sleep-morning') + for at in (guest_bed, host_bed): + guest('command', command=f'fill {at[0] - 1} {at[1]} {at[2]} {at[0]} {at[1]} {at[2]} minecraft:air') + host('command', command='time set day') + detail = {'asleep': asleep, 'night': night, 'up': up, 'after': after} + assert asleep['guest'] == guest_bed and asleep['server'] == guest_bed, f'the guest is not in its bed: {detail}' + assert asleep['host'] is None, f'the guest\'s bed put the host to sleep: {detail}' + assert 13000 < night < 23000, f'one of two players asleep ended the night: {detail}' + assert up is None, f'Escape did not get the guest up: {detail}' + assert after['guest'] is None and after['host'] is None and after['time'] < 1000, f'no morning: {detail}' + return detail + + CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'nametags': check_nametags, 'chest': check_chest, 'crafting': check_crafting, 'damage': check_damage, 'mobs': check_mobs, 'hazards': check_hazards, 'pvp': check_pvp, 'containers': check_containers, 'feedback': check_feedback, 'trials': check_trials, - 'walls': check_walls} + 'walls': check_walls, + 'sleep': check_sleep} def run(ctl, out, resources, checks): From ce62f9c57f70ea4a50fd6a0d45604f017d9cde38 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 17:34:55 +0200 Subject: [PATCH 002/163] Server clients: eating plays on the player's own screen A server client sent UseItem and never started the use itself, so food showed no eating animation or crumbs, and holding right click sent a new UseItem every 4 ticks. Like MultiPlayerGameMode.useItem, the client now starts eating (Consumable.startConsuming), counts the use down for the animation and its particles, and starts no other use until it ends; the server still eats the item. Looking at another player no longer stops the item from being used (Player.interactOn passes). Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game/agent.rs | 2 + crates/horizon-client/src/game/remote.rs | 56 ++++++++++++++++++++++-- tools/lan_e2e.py | 40 ++++++++++++++++- 3 files changed, 92 insertions(+), 6 deletions(-) diff --git a/crates/horizon-client/src/game/agent.rs b/crates/horizon-client/src/game/agent.rs index 48b24bbb3..1659ab225 100644 --- a/crates/horizon-client/src/game/agent.rs +++ b/crates/horizon-client/src/game/agent.rs @@ -466,6 +466,8 @@ impl Game<'_> { }), "dimension": self.dim.id(), "gamemode": format!("{:?}", self.mode).to_lowercase(), + // The item in use: its slot and for how many ticks. + "using": self.using.map(|(slot, ticks)| json!({ "slot": slot, "ticks": ticks })), "time": { "day_time": self.world.day_time, "day": self.world.day_time.div_euclid(24000), "time_of_day": self.world.day_time.rem_euclid(24000) }, "weather": { "raining": self.world.weather.raining, "thundering": self.world.weather.thundering }, "paused": self.pause, diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 05e1f81c3..a473eeb57 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -2220,10 +2220,12 @@ impl Game<'_> { self.tick_player_model(); if !dead { self.remote_mining(); - if self.right && self.use_delay == 0 && playing { + // Minecraft.handleKeybinds: no new use while an item is in use. + if self.right && self.use_delay == 0 && playing && self.using.is_none() { self.remote_use(); self.use_delay = 4; } + self.remote_tick_using(); } self.remote_send_state(input); self.send(S::ClientTickEnd(Empty)); @@ -2602,8 +2604,16 @@ impl Game<'_> { location: [0.0, 1.0, 0.0], secondary: sneaking, })); - self.swing_arm(); - return; + // Player.interactOn: another player passes, and the held item is + // used instead (Minecraft.startUseItem). + let player = self + .remote + .as_ref() + .is_some_and(|r| r.level_players.contains_key(&id)); + if !player { + self.swing_arm(); + return; + } } if let Some(hit) = self.pick() { let seq = self.next_sequence(); @@ -2636,7 +2646,7 @@ impl Game<'_> { return; } } - if self.held().is_some() { + if let Some(held) = self.held().cloned() { let seq = self.next_sequence(); self.send(S::UseItem(play::UseItem { hand: 0, @@ -2644,6 +2654,44 @@ impl Game<'_> { yaw: self.yaw, pitch: self.pitch, })); + // MultiPlayerGameMode.useItem runs the use here too: food starts + // being eaten (Consumable.startConsuming). + if let Some(info) = self.res.items.get(&held.item).cloned() { + self.start_eating(&info); + } + } + } + /// `LivingEntity.updatingUsingItem` for food on a server client: the + /// eating animation and its crumbs. The server eats it and sends the + /// stack, the hunger and the sounds. + fn remote_tick_using(&mut self) { + let Some((slot, ticks)) = self.using else { + return; + }; + let stack = self.stack_in(slot).cloned(); + let food = stack + .as_ref() + .and_then(|s| self.res.items.get(&s.item)) + .is_some_and(|i| i.consumable && i.food.is_some()); + let (Some(stack), true) = (stack, food) else { + self.using = None; + return; + }; + if !self.right || slot != self.selected || self.screen != Screen::Playing { + self.using = None; + return; + } + // Consumable.shouldEmitParticlesAndSounds, as in tick_used_item. + let duration = 32; + let remaining = duration - ticks.min(duration); + if duration - remaining > (duration as f32 * 0.21875) as u32 && remaining % 4 == 0 { + self.eat_particles(&stack, 5); + } + if ticks + 1 >= duration { + self.using = None; + self.eat_particles(&stack, 16); + } else { + self.using = Some((slot, ticks + 1)); } } /// Left click: attack the targeted entity (MultiPlayerGameMode.attack). diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 667fdda2d..fa8e0ffb9 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -20,6 +20,8 @@ address. The script then checks, from both sides, what a guest's game used to ge - containers: the guest's ender chest holds the guest's items, not the host's, and a double chest opens as 9x6 with the right half first; - feedback: the guest's command feedback names the guest and shows the numbers. +- eat: holding right click with bread, the guest's own screen plays the eating (the item in use + counts up) and the server eats one loaf and feeds the guest. Each check is reported on its own (a failing one doesn't stop the others) and the screenshots of both sides go to --out (host-*.png, guest-*.png). @@ -39,6 +41,7 @@ import shutil import subprocess import sys import tempfile +import threading import time import zlib from pathlib import Path @@ -48,7 +51,7 @@ from agent_control_e2e import Cli, Failed, game_env # noqa: E402 ROOT = Path(__file__).resolve().parents[1] GUEST_NAME = 'Guest' -CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'damage', 'mobs', 'hazards', 'pvp', 'containers', 'feedback', 'trials'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'damage', 'mobs', 'hazards', 'pvp', 'containers', 'feedback', 'trials', 'eat'] class Game: @@ -622,11 +625,44 @@ def check_trials(host, guest, out): return {'spawner': trial, 'vault': active, 'rewarded': uuid(rewarded), 'host': uuid(host_uuid)} +def check_eat(host, guest, out): + guest('command', command='gamemode survival') + guest('command', command='clear @s') + # Hungry: the eating needs food below 20 (Player.canEat). + guest('command', command='effect give @s minecraft:hunger 3 255') + guest.wait(70) + guest('command', command='effect clear @s') + guest('command', command='give @s minecraft:bread 3') + guest.wait(5) + guest.raw('select', 'minecraft:bread') + hungry = guest('state')['player']['food'] + # use-item --hold returns once released: watch the guest's screen meanwhile. + hold = threading.Thread(target=guest.raw, args=('use-item', '--hold', 2.2)) + hold.start() + using = [] + for _ in range(4): + time.sleep(0.2) + using.append(guest('state').get('using')) + guest.shot(out, 'eat') + hold.join() + guest.wait(10) + fed = guest('state')['player']['food'] + left = guest('inventory')['counts'].get('minecraft:bread', 0) + detail = {'hungry': hungry, 'fed': fed, 'bread': left, 'using': using, 'after': guest('state').get('using')} + assert hungry < 20, f'the guest is not hungry: {detail}' + ticks = [u['ticks'] for u in using if u] + assert len(ticks) >= 3 and ticks == sorted(ticks) and ticks[-1] > ticks[0], f'no eating on the guest\'s screen: {detail}' + assert left == 2 and fed > hungry, f'the server did not eat one loaf: {detail}' + assert detail['after'] is None, f'still eating after the release: {detail}' + return detail + + CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'nametags': check_nametags, 'chest': check_chest, 'crafting': check_crafting, 'damage': check_damage, 'mobs': check_mobs, 'hazards': check_hazards, 'pvp': check_pvp, 'containers': check_containers, 'feedback': check_feedback, 'trials': check_trials, - 'walls': check_walls} + 'walls': check_walls, + 'eat': check_eat} def run(ctl, out, resources, checks): From 123e8286ac55894a0e9f61c78b3844fd46241e2a Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 16:13:14 +0200 Subject: [PATCH 003/163] Guests: container clicks reach the server (chests, furnaces, crafting drags) On a LAN world or a server, a guest's clicks that went through the menu engine (placing a carried stack, quick craft drags, double clicks, number keys, Q) ran only on the guest's own copy and were never sent: the item showed in the chest or furnace, the server still had it in the inventory, and the next menu brought it back. menu_ops now sends every click of the server's open menu as vanilla's MultiPlayerGameMode.handleContainerInput does: the engine predicts it on the client's copy, then a ContainerClick goes out with the slots it changed and the carried stack after it (a drag is its three kinds of clicks). The plain inventory and crafting table are predicted too, the Shift double click sends each QUICK_MOVE, and a prediction no longer drops, crafts or makes maps on the client (the server does). tools/lan_e2e.py clicks: real mouse presses put a stack into a chest and a furnace, drag planks over the crafting grid and craft; the server has each. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game.rs | 31 +++-- crates/horizon-client/src/game/remote.rs | 142 ++++++++++++++++++++++- crates/horizon-client/src/game/tweaks.rs | 10 +- crates/horizon-client/src/menu.rs | 13 +++ tools/lan_e2e.py | 92 ++++++++++++++- 5 files changed, 263 insertions(+), 25 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 238f68e55..83b4a665a 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -4524,6 +4524,10 @@ impl Game<'_> { /// Several clicks on one menu instance (a quick craft drag is three). fn menu_ops(&mut self, ops: &[(Option, i32, horizon_client::menu::Input)]) -> bool { use horizon_client::menu::Input; + if self.remote.is_some() && self.screen == Screen::Inventory { + // On a server the clicks are the server's: predicted and sent. + return self.remote_menu_ops(ops); + } if let [(Some(slot), button, input)] = ops { self.crafter_slot_clicked(*slot, *button, *input); } @@ -4698,7 +4702,7 @@ impl Game<'_> { plain: false, }; (kind, map) - } else if self.station.is_none() && !self.mount_active() && self.remote.is_none() { + } else if self.station.is_none() && !self.mount_active() { let table = self.craft_size == 3; let map = Map { container: 0, @@ -4811,7 +4815,12 @@ impl Game<'_> { Some(false) => return true, Some(true) => {} } - self.register_exploration_maps(made); + // On a server the clicks only predict: the server drops, crafts and + // makes maps itself. + let predicting = self.remote.is_some(); + if !predicting { + self.register_exploration_maps(made); + } if let Some(s) = menu.merchant.take() { self.merchant_sync_out(s); } @@ -4829,10 +4838,12 @@ impl Game<'_> { if !offhand_mapped { self.offhand = menu.player_item(40).cloned(); } - for stack in dropped { - self.player_drop(stack); + if !predicting { + for stack in dropped { + self.player_drop(stack); + } + self.award_crafted(&crafted); } - self.award_crafted(&crafted); if kind == Kind::Loom { if let Some(s) = self.station.as_mut() { s.loom.selected = usize::try_from(menu.data[0]).ok(); @@ -4964,9 +4975,13 @@ impl Game<'_> { return; } if let Some(moved) = self.last_quick_moved.clone() { - self.menu_session(|menu, env, to_menu| { - Some(menu.quick_move_all(env, to_menu(slot)?, &moved).is_ok()) - }); + if self.remote.is_some() { + self.remote_quick_move_all(slot, &moved); + } else { + self.menu_session(|menu, env, to_menu| { + Some(menu.quick_move_all(env, to_menu(slot)?, &moved).is_ok()) + }); + } } self.last_inv_click = None; self.inv_clicks.skip_release(); diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 05e1f81c3..37c561476 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -14,6 +14,7 @@ use horizon_client::{ entities::{Experience, ItemEntity}, hud::{HudBatch, rgba}, items::ItemStack, + menu::Input, mobs::{Mob, MobType}, motion::{MotionWorld, PlayerMotion}, net::{Event, Session}, @@ -2880,17 +2881,108 @@ impl Game<'_> { let Some(internal) = self.slot_at(&batch, self.cursor.0, self.cursor.1) else { return; }; - let input = if self.has_shift_down() { 1 } else { 0 }; - self.remote_slot_click(internal, i8::from(right), input); + let input = if self.has_shift_down() { + Input::QuickMove + } else { + Input::Pickup + }; + self.remote_menu_ops(&[(Some(internal), i32::from(right), input)]); + } + /// The server's open menu: its window id and menu type (0, "inventory" + /// when none is open). + fn remote_menu(&self) -> (i32, String) { + match self.remote.as_ref().and_then(|r| r.menu.clone()) { + Some((id, name)) => (id, name), + None => (0, "inventory".to_owned()), + } + } + /// `MultiPlayerGameMode.handleContainerInput` for each click of `ops` on + /// the server's open menu (a quick craft drag is several): the verified + /// menu engine predicts them on this client's copy, then each goes out as + /// a `ContainerClick` with the slots it changed and the carried stack + /// after it; the server corrects anything it sees differently. A menu the + /// engine doesn't model sends the clicks unpredicted. False when a click's + /// slot isn't one of the menu's. + pub(super) fn remote_menu_ops(&mut self, ops: &[(Option, i32, Input)]) -> bool { + let (container, menu) = self.remote_menu(); + let mut clicks = Vec::with_capacity(ops.len()); + for &(slot, button, input) in ops { + let slot = match slot { + None => -999, + Some(internal) => { + match (0..64).find(|&s| Self::menu_slot(&menu, s) == Some(internal)) { + Some(s) => s as i16, + None => return false, + } + } + }; + clicks.push((slot, button, input)); + } + // Unpredicted: nothing changed, the carried stack as it is. + let mut sent: Vec = clicks + .iter() + .map(|&(slot, button, input)| (slot, button, input, Vec::new(), self.carried.clone())) + .collect(); + // The engine's slot indices are the menu's own, as on the network. + self.menu_session(|m, env, _| { + let mut predicted = Vec::with_capacity(clicks.len()); + for &(slot, button, input) in &clicks { + let before = menu_items(m); + if m.click(env, i32::from(slot), button, input).is_err() { + // The server throws on it too: nothing is predicted. + return Some(false); + } + let changed = changed_slots(&before, m); + predicted.push((slot, button, input, changed, m.carried.clone())); + } + sent = predicted; + Some(true) + }); + self.send_clicks(container, sent); + true + } + /// A Shift double click on a server (`AbstractContainerScreen.mouseReleased`): + /// a predicted QUICK_MOVE for every slot the engine moves, each sent. + pub(super) fn remote_quick_move_all(&mut self, slot: usize, moved: &ItemStack) { + let (container, _) = self.remote_menu(); + let mut sent: Vec = Vec::new(); + self.menu_session(|m, env, to_menu| { + let clicked = to_menu(slot)?; + let mut before = menu_items(m); + let mut each = |m: &horizon_client::menu::Menu, t: usize| { + let changed = changed_slots(&before, m); + sent.push((t as i16, 0, Input::QuickMove, changed, m.carried.clone())); + before = menu_items(m); + }; + Some( + m.quick_move_all_each(env, clicked, moved, &mut each) + .is_ok(), + ) + }); + self.send_clicks(container, sent); + } + fn send_clicks(&mut self, container: i32, clicks: Vec) { + let state = self.remote.as_ref().map_or(0, |r| r.state_id); + let hashed = |g: &Self, s: &Option| g.to_network(s).map(|s| Hashed::of(&s)); + for (slot, button, input, changed, carried) in clicks { + let changed = changed.iter().map(|(i, s)| (*i, hashed(self, s))).collect(); + let carried = hashed(self, &carried); + self.send(S::ContainerClick(play::ContainerClick { + container, + state, + slot, + button: button as i8, + input: input_ordinal(input), + changed, + carried, + })); + } } /// A `ContainerClick` on game slot `internal` of the server's open menu /// (`input` is the ContainerInput ordinal). False when the menu has no /// such slot. pub(super) fn remote_slot_click(&mut self, internal: usize, button: i8, input: i32) -> bool { - let (container, menu) = match self.remote.as_ref().and_then(|r| r.menu.clone()) { - Some((id, name)) => (id, name), - None => (0, "inventory".to_owned()), - }; + let (container, menu) = self.remote_menu(); let slot = (0..64).find(|&s| Self::menu_slot(&menu, s) == Some(internal)); let Some(slot) = slot else { return false }; let carried = self.to_network(&self.carried).map(|s| Hashed::of(&s)); @@ -3288,6 +3380,44 @@ impl Game<'_> { } } +/// A click sent to a server: its slot, button and input, the slots it +/// changed and the carried stack after it. +type Predicted = ( + i16, + i32, + Input, + Vec<(i16, Option)>, + Option, +); + +fn menu_items(m: &horizon_client::menu::Menu) -> Vec> { + (0..m.slot_count()).map(|i| m.slot(i).cloned()).collect() +} + +/// The slots whose stack is no longer `before`'s (`ItemStack.matches`). +fn changed_slots( + before: &[Option], + m: &horizon_client::menu::Menu, +) -> Vec<(i16, Option)> { + (0..m.slot_count()) + .filter(|&i| m.slot(i) != before.get(i).and_then(Option::as_ref)) + .map(|i| (i as i16, m.slot(i).cloned())) + .collect() +} + +/// ServerboundContainerClickPacket's `ContainerInput` ordinal. +pub(super) fn input_ordinal(input: Input) -> i32 { + match input { + Input::Pickup => 0, + Input::QuickMove => 1, + Input::Swap => 2, + Input::Clone => 3, + Input::Throw => 4, + Input::QuickCraft => 5, + Input::PickupAll => 6, + } +} + #[cfg(test)] mod tests { use super::Game; diff --git a/crates/horizon-client/src/game/tweaks.rs b/crates/horizon-client/src/game/tweaks.rs index 018b6640b..f15aa9ea7 100644 --- a/crates/horizon-client/src/game/tweaks.rs +++ b/crates/horizon-client/src/game/tweaks.rs @@ -70,15 +70,7 @@ impl Game<'_> { /// One ordinary click on a game slot. False when nothing took it. pub(super) fn tweak_click(&mut self, slot: usize, button: i32, input: Input) -> bool { if self.remote.is_some() { - let ordinal = match input { - Input::Pickup => 0, - Input::QuickMove => 1, - Input::Swap => 2, - Input::Clone => 3, - Input::Throw => 4, - Input::QuickCraft => 5, - Input::PickupAll => 6, - }; + let ordinal = super::remote::input_ordinal(input); return self.remote_slot_click(slot, button as i8, ordinal); } if !self.menu_click(Some(slot), button, input) { diff --git a/crates/horizon-client/src/menu.rs b/crates/horizon-client/src/menu.rs index 5e57edcfc..64286b1fe 100644 --- a/crates/horizon-client/src/menu.rs +++ b/crates/horizon-client/src/menu.rs @@ -1668,6 +1668,18 @@ impl Menu { env: &Env, clicked: usize, moved: &ItemStack, + ) -> Result<(), &'static str> { + self.quick_move_all_each(env, clicked, moved, &mut |_, _| {}) + } + + /// `quick_move_all`, calling `each` with the menu and the slot after each + /// QUICK_MOVE (a server's client sends every one of them). + pub fn quick_move_all_each( + &mut self, + env: &Env, + clicked: usize, + moved: &ItemStack, + each: &mut dyn FnMut(&Self, usize), ) -> Result<(), &'static str> { if clicked >= self.slots.len() || !self.can_take_for_pick_all(clicked) { return Ok(()); @@ -1680,6 +1692,7 @@ impl Menu { && self.quick_replace(t, moved, env) { self.click(env, t as i32, 0, Input::QuickMove)?; + each(self, t); } } Ok(()) diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 667fdda2d..0ced0915d 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -20,6 +20,9 @@ address. The script then checks, from both sides, what a guest's game used to ge - containers: the guest's ender chest holds the guest's items, not the host's, and a double chest opens as 9x6 with the right half first; - feedback: the guest's command feedback names the guest and shows the numbers. +- clicks: with real mouse presses (not click-slot, which skips the screen's press and drag + handling), the guest puts a stack into a chest and a furnace, drags planks across + its crafting grid and gathers a stack with a double click; the server has each. Each check is reported on its own (a failing one doesn't stop the others) and the screenshots of both sides go to --out (host-*.png, guest-*.png). @@ -48,7 +51,7 @@ from agent_control_e2e import Cli, Failed, game_env # noqa: E402 ROOT = Path(__file__).resolve().parents[1] GUEST_NAME = 'Guest' -CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'damage', 'mobs', 'hazards', 'pvp', 'containers', 'feedback', 'trials'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'damage', 'mobs', 'hazards', 'pvp', 'containers', 'feedback', 'trials', 'clicks'] class Game: @@ -456,6 +459,91 @@ def check_containers(host, guest, out): return {'ender': ender, 'double': double, 'taken': taken} +def slot_point(game, slot): + """The GUI point in the middle of slot `slot` of the open screen (`ui`'s slot-N).""" + for w in game.raw('ui')['widgets']: + if w.get('id') == f'slot-{slot}': + x, y, width, height = w['bounds'] + return x + width / 2, y + height / 2 + raise Failed(f'no slot {slot} on the screen') + + +def mouse(game, *slots, right=False): + """Press over the first slot, move over the others and release: one click, or a drag.""" + points = [f'{v:.1f}' for s in slots for v in slot_point(game, s)] + game.raw('drag-at', *(['right'] if right else []), *points) + game.wait(4) + + +def hotbar_slot(game, item): + return next(s['slot'] for s in game('inventory')['hotbar'] if s and s.get('item') == item) + + +def check_clicks(host, guest, out): + guest('command', command='gamemode survival') + guest('command', command='clear @s') + guest('command', command='give @s minecraft:cobblestone 10') + guest('command', command='give @s minecraft:coal 3') + guest('command', command='give @s minecraft:raw_iron 2') + guest('command', command='give @s minecraft:oak_planks 2') + guest.wait(10) + x, y, z = (int(v // 1) for v in pos_of(guest)) + chest, furnace = (x, y, z + 2), (x, y, z - 2) + guest('command', command=f'setblock {chest[0]} {chest[1]} {chest[2]} minecraft:chest') + guest('command', command=f'setblock {furnace[0]} {furnace[1]} {furnace[2]} minecraft:furnace') + guest.wait(10) + # Pick the cobblestone up and put it down in the chest's first slot. + guest.raw('interact', *chest) + guest.raw('wait-for', 'screen', 'container', '--timeout', 10) + guest.wait(10) + mouse(guest, hotbar_slot(guest, 'minecraft:cobblestone')) + mouse(guest, 300) + guest.wait(10) + guest.shot(out, 'clicks-chest') + guest.raw('key', 'esc', 'tap') + guest.wait(10) + in_chest, _ = open_container(guest, chest, out, 'clicks-chest-after') + # Coal into the fuel slot, raw iron into the input. + guest.raw('interact', *furnace) + guest.raw('wait-for', 'screen', 'container', '--timeout', 10) + guest.wait(10) + mouse(guest, hotbar_slot(guest, 'minecraft:coal')) + mouse(guest, 301) + mouse(guest, hotbar_slot(guest, 'minecraft:raw_iron')) + mouse(guest, 300) + guest.wait(10) + guest.shot(out, 'clicks-furnace') + guest.raw('key', 'esc', 'tap') + guest.wait(10) + # Opening the furnace again resends the whole menu: the server's own view. + in_furnace, _ = open_container(guest, furnace, out, 'clicks-furnace-after') + # Two planks dragged over the 2x2 grid's left column: one each, four sticks. + guest.raw('key', 'e', 'tap') + guest.raw('wait-for', 'screen', 'inventory') + guest.wait(5) + mouse(guest, hotbar_slot(guest, 'minecraft:oak_planks')) + mouse(guest, 100, 102) + guest.wait(10) + grid = {s['slot']: (s.get('item'), s.get('count')) for s in guest('screen').get('slots', []) + if s.get('slot') in (100, 102, 200) and s.get('item')} + guest.shot(out, 'clicks-drag') + guest.raw('click-slot', 200, 'shift') + guest.wait(10) + guest.raw('key', 'esc', 'tap') + guest.wait(10) + # The chest's menu brings the whole inventory as the server has it. + open_container(guest, chest, out, 'clicks-inventory') + counts = guest('inventory')['counts'] + for at in (chest, furnace): + guest('command', command=f'setblock {at[0]} {at[1]} {at[2]} minecraft:air') + assert in_chest == {0: 'minecraft:cobblestone'}, f'the chest holds {in_chest} after the guest put cobblestone in' + assert in_furnace == {0: 'minecraft:raw_iron', 1: 'minecraft:coal'}, f'the furnace holds {in_furnace}' + assert grid.get(100) == ('minecraft:oak_planks', 1) and grid.get(102) == ('minecraft:oak_planks', 1), \ + f'the drag left the grid as {grid}' + assert counts.get('minecraft:stick') == 4 and 'minecraft:cobblestone' not in counts, f'inventory after: {counts}' + return {'chest': in_chest, 'furnace': in_furnace, 'grid': grid, 'inventory': counts} + + def check_feedback(host, guest, out): x, y, z = (round(v, 1) for v in pos_of(guest)) guest('command', command='item replace entity @s weapon.mainhand with minecraft:stick') @@ -626,7 +714,7 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'chest': check_chest, 'crafting': check_crafting, 'damage': check_damage, 'mobs': check_mobs, 'hazards': check_hazards, 'pvp': check_pvp, 'containers': check_containers, 'feedback': check_feedback, 'trials': check_trials, - 'walls': check_walls} + 'walls': check_walls, 'clicks': check_clicks} def run(ctl, out, resources, checks): From 69dd4feb316616eef6255a4f41dc3b680a6a43e6 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 16:14:18 +0200 Subject: [PATCH 004/163] Server clients: mobs' and players' heads turn smoothly, not flicker On a LAN world or a server, other entities' heads flickered between two directions. The client wrote ClientboundRotateHeadPacket's head yaw into the entity's yRot and the move packets' yRot into the body yaw, never moved the head's previous yaw and pitch on, and never ran the body rotation, so each frame interpolated the head from stale values. As vanilla: move packets interpolate the position, yRot and xRot over three ticks (LinearInterpolationHandler), RotateHead the head yaw over three (lerpHeadTo), each tick keeps the previous head rotation for the frames, and the body follows (a mob's BodyRotationControl, a player's walk direction within 50 degrees of the look). AddEntity sets yRot and xRot and puts the body and head at the packet's head yaw (recreateFromPacket). Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game/remote.rs | 106 ++++++++++++++++++++--- 1 file changed, 92 insertions(+), 14 deletions(-) diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 05e1f81c3..079f00d59 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -61,8 +61,11 @@ struct Tracked { } /// Smooth an entity toward a new position over three ticks (InterpolationHandler). #[derive(Clone, Copy)] +/// `LinearInterpolationHandler`'s target: a position and rotation (yRot, +/// xRot) reached in `steps` ticks. struct Lerp { target: [f64; 3], + rotation: Option<(f32, f32)>, steps: u32, } @@ -102,6 +105,8 @@ pub(super) struct Remote { use_target: Option<[i32; 3]>, entities: HashMap, lerps: HashMap, + /// `LivingEntity.lerpHeadTo`: the head yaw and the ticks left to reach it. + head_lerps: HashMap, /// Item entities waiting for their item data. pending_items: HashMap, health: (f32, i32, f32), @@ -288,6 +293,7 @@ impl Game<'_> { use_target: None, entities: HashMap::new(), lerps: HashMap::new(), + head_lerps: HashMap::new(), pending_items: HashMap::new(), health: (20.0, 20, 5.0), game_mode: 0, @@ -587,6 +593,7 @@ impl Game<'_> { if let Some(r) = self.remote.as_mut() { r.entities.clear(); r.lerps.clear(); + r.head_lerps.clear(); r.pending_items.clear(); // A new ClientLevel: a new chunk storage, centred on 0, 0. r.chunk_center = (0, 0); @@ -868,7 +875,10 @@ impl Game<'_> { } } } - fn spawn_entity(&mut self, id: i32, kind: &str, position: [f64; 3], yaw: f32, head: f32) { + /// `recreateFromPacket`: yRot and xRot from the packet, the body and head + /// both at its head yaw (LivingEntity). + fn spawn_entity(&mut self, id: i32, kind: &str, position: [f64; 3], rotation: [f32; 3]) { + let [yaw, pitch, head] = rotation; let at = Vec3::new(position[0], position[1], position[2]); let mob_type = if kind == "minecraft:player" { self.remote.as_ref().and_then(|r| r.player_type.clone()) @@ -877,8 +887,8 @@ impl Game<'_> { }; if let Some(t) = mob_type { let mut mob = Mob::new(id as u32, t, at, head); - mob.body_yaw = yaw; - mob.previous_body_yaw = yaw; + (mob.yaw, mob.previous_yaw) = (yaw, yaw); + (mob.head_pitch, mob.previous_head_pitch) = (pitch, pitch); mob.persistent = true; self.mobs.retain(|m| m.id != id as u32); self.mobs.push(mob); @@ -903,14 +913,21 @@ impl Game<'_> { rotation: Option<(f32, f32)>, on_ground: bool, ) { + let mob = self.mobs.iter_mut().find(|m| m.id == id as u32); if let Some(r) = self.remote.as_mut() { if let Some(t) = r.entities.get_mut(&id) { t.position = position; } + // AbstractInterpolationHandler.interpolateTo: without a rotation, + // the one it was heading for (or has). + let rotation = rotation + .or_else(|| r.lerps.get(&id).and_then(|l| l.rotation)) + .or_else(|| mob.as_ref().map(|m| (m.yaw, m.head_pitch))); r.lerps.insert( id, Lerp { target: position, + rotation, steps: 3, }, ); @@ -918,12 +935,8 @@ impl Game<'_> { *p = position; } } - if let Some(m) = self.mobs.iter_mut().find(|m| m.id == id as u32) { + if let Some(m) = mob { m.on_ground = on_ground; - if let Some((yaw, pitch)) = rotation { - m.body_yaw = yaw; - m.head_pitch = pitch; - } } } fn remove_entity(&mut self, id: i32) { @@ -932,6 +945,7 @@ impl Game<'_> { if let Some(r) = self.remote.as_mut() { r.entities.remove(&id); r.lerps.remove(&id); + r.head_lerps.remove(&id); r.pending_items.remove(&id); } } @@ -1181,8 +1195,8 @@ impl Game<'_> { .map(str::to_owned) }) .unwrap_or_default(); - let yaw = horizon_protocol::buf::unpack_degrees(p.yaw); - let head = horizon_protocol::buf::unpack_degrees(p.head_yaw); + let rotation = + [p.yaw, p.pitch, p.head_yaw].map(horizon_protocol::buf::unpack_degrees); if let Some(r) = self.remote.as_mut() { if kind == "minecraft:player" { r.level_players.insert(p.id, p.uuid); @@ -1190,7 +1204,7 @@ impl Game<'_> { r.level_players.remove(&p.id); } } - self.spawn_entity(p.id, &kind, p.position, yaw, head); + self.spawn_entity(p.id, &kind, p.position, rotation); } C::RemoveEntities(p) => { for id in p.ids { @@ -1241,9 +1255,11 @@ impl Game<'_> { ]; self.move_entity(p.id, position, Some((p.yaw, p.pitch)), p.on_ground); } + // ClientPacketListener.handleRotateMob: lerpHeadTo(yHeadRot, 3). C::RotateHead(p) => { - if let Some(m) = self.mobs.iter_mut().find(|m| m.id == p.id as u32) { - m.yaw = horizon_protocol::buf::unpack_degrees(p.head_yaw); + if let Some(r) = self.remote.as_mut() { + let yaw = horizon_protocol::buf::unpack_degrees(p.head_yaw); + r.head_lerps.insert(p.id, (yaw, 3)); } } C::SetEntityData(p) => { @@ -2236,14 +2252,18 @@ impl Game<'_> { return; }; let mut lerps = std::mem::take(&mut r.lerps); + let head_lerps = &mut r.head_lerps; let players = &r.level_players; for m in &mut self.mobs { - if !running && !players.contains_key(&(m.id as i32)) { + let player = players.contains_key(&(m.id as i32)); + if !running && !player { continue; } m.previous = m.position; m.previous_yaw = m.yaw; m.previous_body_yaw = m.body_yaw; + m.previous_head_yaw = m.head_yaw; + m.previous_head_pitch = m.head_pitch; m.previous_limb_speed = m.limb_speed; m.age += 1; if m.species() == horizon_client::mobs::Species::Rabbit { @@ -2258,6 +2278,7 @@ impl Game<'_> { if !m.alive() { m.death_time += 1; } + // Entity.commonTick: LinearInterpolationHandler.interpolate. if let Some(l) = lerps.get_mut(&(m.id as i32)) && l.steps > 0 { @@ -2267,8 +2288,27 @@ impl Game<'_> { m.position.y + (l.target[1] - m.position.y) / n, m.position.z + (l.target[2] - m.position.z) / n, ); + if let Some((yaw, pitch)) = l.rotation { + let alpha = 1.0 / l.steps as f32; + m.yaw += wrap_degrees(yaw - m.yaw) * alpha; + m.head_pitch += (pitch - m.head_pitch) * alpha; + } l.steps -= 1; } + // LivingEntity.aiStep: the head's own interpolation. + if let Some((yaw, steps)) = head_lerps.get_mut(&(m.id as i32)) + && *steps > 0 + { + m.head_yaw += wrap_degrees(*yaw - m.head_yaw) / *steps as f32; + *steps -= 1; + } + // LivingEntity.tick's tickHeadTurn: a mob's BodyRotationControl, + // a player's body following its walk and look. + if player { + remote_player_head_turn(m); + } else if m.alive() { + m.body_rotation_tick(); + } // WalkAnimationState.update from the horizontal distance moved. let (dx, dz) = (m.position.x - m.previous.x, m.position.z - m.previous.z); let target = (((dx * dx + dz * dz).sqrt() * 4.0) as f32).min(1.0); @@ -2294,6 +2334,7 @@ impl Game<'_> { } } lerps.retain(|_, l| l.steps > 0); + head_lerps.retain(|_, (_, steps)| *steps > 0); if let Some(r) = self.remote.as_mut() { for (id, l) in lerps { r.lerps.entry(id).or_insert(l); @@ -3288,6 +3329,43 @@ impl Game<'_> { } } +/// `Mth.wrapDegrees`. +fn wrap_degrees(a: f32) -> f32 { + let a = a % 360.0; + if a >= 180.0 { + a - 360.0 + } else if a < -180.0 { + a + 360.0 + } else { + a + } +} + +/// `LivingEntity.tick`'s body target and `tickHeadTurn` for another player: +/// the body turns toward where it walks (backwards when walking back), or to +/// the look while the arm swings, and stays within 50 degrees of the look. +fn remote_player_head_turn(m: &mut Mob) { + let (dx, dz) = (m.position.x - m.previous.x, m.position.z - m.previous.z); + let mut target = m.body_yaw; + if (dx * dx + dz * dz) as f32 > 0.002_500_000_2 { + let walk = (dz.atan2(dx) as f32).to_degrees() - 90.0; + let facing = (wrap_degrees(m.yaw) - walk).abs(); + target = if 95.0 < facing && facing < 265.0 { + walk - 180.0 + } else { + walk + }; + } + if m.anim.attack_anim > 0.0 { + target = m.yaw; + } + m.body_yaw += wrap_degrees(target - m.body_yaw) * 0.3; + let head = wrap_degrees(m.yaw - m.body_yaw); + if head.abs() > 50.0 { + m.body_yaw += head - head.signum() * 50.0; + } +} + #[cfg(test)] mod tests { use super::Game; From 22dc3e595404dfc0c0143da4ab72edbb82ebe31b Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 17:08:13 +0200 Subject: [PATCH 005/163] Guests: touching mobs push them on their own client, as in vanilla A mob's push of a guest went to the guest as SetEntityMotion carrying the server copy's velocity, which nothing damps: every tick of contact added to it and replaced what the guest's client was doing. Vanilla pushes players on their own client only (EntitySelector.pushableBy): the server no longer sends those pushes, and a server client now pushes its player away from every living entity it touches (Entity.push, team rules, no spectators, bats or passengers of the same vehicle). Co-Authored-By: Claude Opus 5.5 --- .../horizon-client/examples/mob_ai_probe.rs | 1 + crates/horizon-client/src/game/creatures.rs | 1 + crates/horizon-client/src/game/lan_mobs.rs | 2 + crates/horizon-client/src/game/remote.rs | 69 ++++++++++++++++++- .../horizon-client/src/game/respawn_anchor.rs | 2 +- crates/horizon-client/src/mobs.rs | 3 + crates/horizon-client/src/mobs/ai.rs | 12 ++-- tools/lan_e2e.py | 27 +++++++- 8 files changed, 109 insertions(+), 8 deletions(-) diff --git a/crates/horizon-client/examples/mob_ai_probe.rs b/crates/horizon-client/examples/mob_ai_probe.rs index 087fd3edf..0b3adec31 100644 --- a/crates/horizon-client/examples/mob_ai_probe.rs +++ b/crates/horizon-client/examples/mob_ai_probe.rs @@ -999,6 +999,7 @@ fn main() -> horizon_client::Result<()> { hero: false, uuid: PLAYER_UUID, allies: Default::default(), + remote: false, } }); let mut scratch = LegacyRandom::new(0); diff --git a/crates/horizon-client/src/game/creatures.rs b/crates/horizon-client/src/game/creatures.rs index 076c2fbef..acac3b596 100644 --- a/crates/horizon-client/src/game/creatures.rs +++ b/crates/horizon-client/src/game/creatures.rs @@ -196,6 +196,7 @@ impl Game<'_> { hero: self.potions.effects.get("hero_of_the_village").is_some(), uuid: self.level.player_uuid.unwrap_or_default(), allies: std::sync::Arc::new(self.player_allies()), + remote: false, }) } /// Biome facts at a position for finalizeSpawn and variant rules. diff --git a/crates/horizon-client/src/game/lan_mobs.rs b/crates/horizon-client/src/game/lan_mobs.rs index 7cef7cda6..e12446b0c 100644 --- a/crates/horizon-client/src/game/lan_mobs.rs +++ b/crates/horizon-client/src/game/lan_mobs.rs @@ -107,6 +107,7 @@ impl Game<'_> { v.velocity = Vec3::new(moved[0], moved[1], moved[2]); v.uuid = horizon_client::lan::playerdata::uuid_ints(uuid); v.allies = Default::default(); + v.remote = true; views.push((conn, v)); } } @@ -271,6 +272,7 @@ mod tests { hero: false, uuid: [0; 4], allies: Default::default(), + remote: false, } } diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 05e1f81c3..1200da1ca 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -14,12 +14,13 @@ use horizon_client::{ entities::{Experience, ItemEntity}, hud::{HudBatch, rgba}, items::ItemStack, - mobs::{Mob, MobType}, + mobs::{Mob, MobType, Who}, motion::{MotionWorld, PlayerMotion}, net::{Event, Session}, save::SaveDir, sprint::Keys, streaming::{ChunkGenerator, Proto, Streaming}, + tab_list::SPECTATOR, world::World, }; use horizon_core::{geometry::Vec3, paletted::PalettedContainer, random::RandomSource}; @@ -2125,6 +2126,7 @@ impl Game<'_> { self.tick_particles(); self.tick_client_effects(); let ghast_collisions = self.happy_ghast_player_collisions(); + let pushed = self.remote_pushes(); let Some(player) = self.player.as_mut() else { return Ok(()); }; @@ -2177,6 +2179,7 @@ impl Game<'_> { player.yaw = self.yaw; let dead = self.screen == Screen::Dead; if !dead { + player.velocity = player.velocity.add_vector(pushed); MotionWorld { entities: &ghast_collisions, player, @@ -2229,6 +2232,70 @@ impl Game<'_> { self.send(S::ClientTickEnd(Empty)); Ok(()) } + /// The local player's share of every touching entity's + /// `LivingEntity.pushEntities`: on a client `EntitySelector.pushableBy` + /// lets entities push only the local player, so the server never sends + /// these pushes. `doPush(player)` is `player.push(entity)`. + fn remote_pushes(&self) -> Vec3 { + let (Some(p), Some(r)) = (self.player.as_ref(), self.remote.as_ref()) else { + return Vec3::ZERO; + }; + // LivingEntity.isPushable: alive, no spectator, off ladders. + let feet = [ + p.position.x.floor() as i32, + p.position.y.floor() as i32, + p.position.z.floor() as i32, + ]; + if self.screen == Screen::Dead + || p.spectator + || self.block_in_tag("minecraft:climbable", &self.block_name(feet)) + { + return Vec3::ZERO; + } + let bounds = p.bounds(); + let teams = self.mob_teams(); + let mut push = Vec3::ZERO; + for m in &self.mobs { + let spectator = r + .level_players + .get(&(m.id as i32)) + .and_then(|uuid| r.tab_players.get(uuid)) + .is_some_and(|t| t.game_mode == SPECTATOR); + // Bats never push; a spectator has no physics; passengers of the + // same vehicle never push each other. + if !m.alive() + || spectator + || m.species() == horizon_client::mobs::Species::Bat + || self + .riding + .is_some_and(|v| v == m.id || m.extra.mount == Some(v)) + || !m.bounds().intersects(bounds) + || !horizon_client::scoreboard::pushable_by( + teams.of(Who::Mob(m.id)), + teams.of(Who::Player), + true, + ) + { + continue; + } + // Entity.push(Entity), `this` the player. + let (mut xa, mut za) = (m.position.x - p.position.x, m.position.z - p.position.z); + let mut dd = xa.abs().max(za.abs()); + if dd < f64::from(0.01_f32) { + continue; + } + dd = dd.sqrt(); + xa /= dd; + za /= dd; + let pow = (1.0 / dd).min(1.0); + xa *= pow; + za *= pow; + xa *= f64::from(0.05_f32); + za *= f64::from(0.05_f32); + push = Vec3::new(push.x - xa, push.y, push.z - za); + } + push + } /// ClientLevel.tickEntities; a frozen level only ticks the players /// (`TickRateManager.isEntityFrozen`). fn tick_remote_entities(&mut self, running: bool) { diff --git a/crates/horizon-client/src/game/respawn_anchor.rs b/crates/horizon-client/src/game/respawn_anchor.rs index 5a31dfd5c..aa94d5b17 100644 --- a/crates/horizon-client/src/game/respawn_anchor.rs +++ b/crates/horizon-client/src/game/respawn_anchor.rs @@ -324,7 +324,7 @@ impl Game<'_> { ) .unwrap_or_else(|_| VoxelShape::empty()) } - fn block_in_tag(&self, tag: &str, block: &str) -> bool { + pub(super) fn block_in_tag(&self, tag: &str, block: &str) -> bool { self.res .items .block_tags diff --git a/crates/horizon-client/src/mobs.rs b/crates/horizon-client/src/mobs.rs index 2ab4c0557..53143d2df 100644 --- a/crates/horizon-client/src/mobs.rs +++ b/crates/horizon-client/src/mobs.rs @@ -1398,6 +1398,9 @@ pub struct PlayerView { /// The mobs on the player's team (`isAlliedTo`): combat targeting /// leaves the player alone. pub allies: std::sync::Arc>, + /// A LAN guest: its own client moves it, and touching mobs push it there + /// (`EntitySelector.pushableBy` on the client). + pub remote: bool, } pub struct MobWorld<'a> { pub world: &'a World, diff --git a/crates/horizon-client/src/mobs/ai.rs b/crates/horizon-client/src/mobs/ai.rs index 9ab29d0a5..f74a3c7d1 100644 --- a/crates/horizon-client/src/mobs/ai.rs +++ b/crates/horizon-client/src/mobs/ai.rs @@ -822,10 +822,14 @@ fn push_entities(m: &mut Mob, w: &MobWorld, events: &mut Vec) { za *= pow; xa *= f64::from(0.05_f32); za *= f64::from(0.05_f32); - events.push(MobEvent::Push { - target: who, - velocity: [-xa, 0.0, -za], - }); + // A guest's server-side push never reaches its client (ServerPlayer + // motion is synced only when hurt): its client pushes it itself. + if who != Who::Player || w.player.as_ref().is_none_or(|p| !p.remote) { + events.push(MobEvent::Push { + target: who, + velocity: [-xa, 0.0, -za], + }); + } if self_pushable { m.velocity = Vec3::new(m.velocity.x + xa, m.velocity.y, m.velocity.z + za); } diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 667fdda2d..85b2bb12a 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -20,6 +20,8 @@ address. The script then checks, from both sides, what a guest's game used to ge - containers: the guest's ender chest holds the guest's items, not the host's, and a double chest opens as 9x6 with the right half first; - feedback: the guest's command feedback names the guest and shows the numbers. +- push: a cow standing in the guest pushes it just clear of the cow (the guest's own client + pushes it, as in vanilla), not ever faster across the ground. Each check is reported on its own (a failing one doesn't stop the others) and the screenshots of both sides go to --out (host-*.png, guest-*.png). @@ -48,7 +50,7 @@ from agent_control_e2e import Cli, Failed, game_env # noqa: E402 ROOT = Path(__file__).resolve().parents[1] GUEST_NAME = 'Guest' -CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'damage', 'mobs', 'hazards', 'pvp', 'containers', 'feedback', 'trials'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'damage', 'mobs', 'hazards', 'pvp', 'containers', 'feedback', 'trials', 'push'] class Game: @@ -622,11 +624,32 @@ def check_trials(host, guest, out): return {'spawner': trial, 'vault': active, 'rewarded': uuid(rewarded), 'host': uuid(host_uuid)} +def check_push(host, guest, out): + guest('command', command='gamemode survival') + x, y, z = (int(v // 1) + 0.5 for v in pos_of(guest)) + guest('command', command=f'tp @s {x} {y - 0.5} {z}') + guest.wait(20) + x, y, z = pos_of(guest) + # A cow that doesn't walk, 0.3 east of the guest: the two boxes overlap until their centres are + # 0.75 apart, so the push stops a fraction of a block away. + guest('command', command=f'summon minecraft:cow {x + 0.3:.2f} {y:.2f} {z:.2f} {{NoAI:1b}}') + guest.wait(60) + nx, _, nz = pos_of(guest) + guest.shot(out, 'push') + guest('command', command='kill @e[type=minecraft:cow]') + moved = ((nx - x) ** 2 + (nz - z) ** 2) ** 0.5 + detail = {'from': [round(x, 3), round(z, 3)], 'to': [round(nx, 3), round(nz, 3)], 'moved': round(moved, 3)} + assert nx < x, f'the cow did not push the guest west: {detail}' + assert moved < 1.5, f'the cow pushed the guest too far: {detail}' + return detail + + CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'nametags': check_nametags, 'chest': check_chest, 'crafting': check_crafting, 'damage': check_damage, 'mobs': check_mobs, 'hazards': check_hazards, 'pvp': check_pvp, 'containers': check_containers, 'feedback': check_feedback, 'trials': check_trials, - 'walls': check_walls} + 'walls': check_walls, + 'push': check_push} def run(ctl, out, resources, checks): From d1d36f4121bd8eb1a4d3d95b7072420cf3ef6d65 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 16:26:37 +0200 Subject: [PATCH 006/163] Guests: experience orbs fly to them and give them their points On a LAN world or a server, guests never got experience: orbs followed and were taken only by the host's own player (none on a dedicated server), and guests weren't sent orbs at all. - Each orb follows the nearest living, non-spectator player within 8 blocks, the host or a guest (ExperienceOrb.followNearbyPlayer). - A guest takes an orb as Player.aiStep does: one of those in its box grown by 1, 0.5, 1, at random, at most every 2 ticks (takeXpDelay), repairing with Mending first; the rest goes to the guest's experience (sent with SetExperience as before), the level-up sound every fifth level. TakeItemEntity goes to the players around, the pickup sound plays at the orb. - Orbs have entity ids and are tracked to guests (AddEntity, DATA_VALUE). The client shows a server's orbs, moves them with the server's packets and flies them to their collector. tools/lan_e2e.py xp: three 7-point orbs near the guest: it sees three and ends at level 2 (21 points); the host gets none. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/entities.rs | 2 + crates/horizon-client/src/entity_nbt.rs | 2 + crates/horizon-client/src/game.rs | 78 ++++++++++++++----- crates/horizon-client/src/game/commands.rs | 2 + crates/horizon-client/src/game/lan.rs | 19 ++++- crates/horizon-client/src/game/lan_actions.rs | 78 ++++++++++++++++++- crates/horizon-client/src/game/persist.rs | 8 +- crates/horizon-client/src/game/pickups.rs | 1 + crates/horizon-client/src/game/remote.rs | 70 +++++++++++++---- tools/lan_e2e.py | 34 +++++++- 10 files changed, 254 insertions(+), 40 deletions(-) diff --git a/crates/horizon-client/src/entities.rs b/crates/horizon-client/src/entities.rs index 5e6a3336a..c0ee36bcd 100644 --- a/crates/horizon-client/src/entities.rs +++ b/crates/horizon-client/src/entities.rs @@ -178,6 +178,8 @@ impl ItemEntity { /// ExperienceOrb: gravity 0.03, homing towards the player within 8 blocks. #[derive(Clone, Debug)] pub struct ExperienceOrb { + /// The entity id servers track it by. + pub id: u32, pub position: Vec3, pub previous: Vec3, pub velocity: Vec3, diff --git a/crates/horizon-client/src/entity_nbt.rs b/crates/horizon-client/src/entity_nbt.rs index adeb1da25..90e1efc03 100644 --- a/crates/horizon-client/src/entity_nbt.rs +++ b/crates/horizon-client/src/entity_nbt.rs @@ -937,6 +937,7 @@ pub fn orbs_from_nbt(tag: &Tag) -> Vec { }; let count = number(tag.get("Count")).unwrap_or(1).clamp(1, 64) as usize; let orb = ExperienceOrb { + id: 0, position, previous: position, velocity: motion(tag), @@ -1575,6 +1576,7 @@ mod tests { #[test] fn orbs_expand_their_count() { let o = ExperienceOrb { + id: 0, position: Vec3::new(1.0, 2.0, 3.0), previous: Vec3::ZERO, velocity: Vec3::ZERO, diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 238f68e55..4604ce855 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -7352,7 +7352,9 @@ impl Game<'_> { let mut r = dispenser::entity_random(); let _yaw = r.next_float(); let p = Vec3::new(at[0], at[1], at[2]); + self.next_entity += 1; self.orbs.push(ExperienceOrb { + id: self.next_entity, position: p, previous: p, velocity: Vec3::new( @@ -7416,13 +7418,29 @@ impl Game<'_> { .player .as_ref() .filter(|p| !p.health.dead_or_dying() && !spectator); - let target = player.map(|p| { - [ - p.position.x, - p.position.y + f64::from(p.dimensions.eye_height) / 2.0, - p.position.z, - ] - }); + // ExperienceOrb.followNearbyPlayer: each orb goes for the nearest + // living player within 8 blocks, the host's own or a guest. + let mut followed: Vec<([f64; 3], [f64; 3])> = player + .map(|p| { + let feet = [p.position.x, p.position.y, p.position.z]; + let eye = f64::from(p.dimensions.eye_height); + (feet, [feet[0], feet[1] + eye / 2.0, feet[2]]) + }) + .into_iter() + .collect(); + if let Some(host) = self.lan.as_ref() { + followed.extend( + host.hub + .guests + .iter() + .filter(|g| g.placed && g.loaded && !g.dead && g.health > 0.0) + .filter(|g| !g.spectator()) + .map(|g| { + let p = g.position; + (p, [p[0], p[1] + g.eye_height() / 2.0, p[2]]) + }), + ); + } let bounds = player.map(|p| { let w = f64::from(p.dimensions.width) / 2.0; ( @@ -7435,7 +7453,19 @@ impl Game<'_> { ) }); let mut orbs = std::mem::take(&mut self.orbs); - orbs.retain_mut(|o| o.tick(&self.world, &self.res.facts, self.collision, target)); + orbs.retain_mut(|o| { + let distance = |feet: &[f64; 3]| -> f64 { + (feet[0] - o.position.x).powi(2) + + (feet[1] - o.position.y).powi(2) + + (feet[2] - o.position.z).powi(2) + }; + let target = followed + .iter() + .filter(|(feet, _)| distance(feet) < 64.0) + .min_by(|a, b| distance(&a.0).total_cmp(&distance(&b.0))) + .map(|(_, target)| *target); + o.tick(&self.world, &self.res.facts, self.collision, target) + }); let mut gained = 0; let mut taken = Vec::new(); if let Some((min, max)) = bounds { @@ -7469,19 +7499,25 @@ impl Game<'_> { (self.world.random.next_float() - self.world.random.next_float()) * 0.35 + 0.9; self.audio .play("minecraft:entity.experience_orb.pickup", at, 0.1, pitch); - if self.experience.give(gained as i32) - && self.experience.level % 5 == 0 - && self.ticks > self.last_level_up + 100 - { - self.last_level_up = self.ticks; - let volume = if self.experience.level > 30 { - 1.0 - } else { - self.experience.level as f32 / 30.0 - }; - self.audio - .play("minecraft:entity.player.levelup", at, volume * 0.75, 1.0); - } + self.give_orb_points(gained); + } + } + /// `Player.giveExperiencePoints`, and `giveExperienceLevels`' level-up + /// sound every fifth level (at most every 100 ticks). + pub(super) fn give_orb_points(&mut self, gained: u32) { + let at = self.eye_position(); + if self.experience.give(gained as i32) + && self.experience.level % 5 == 0 + && self.ticks > self.last_level_up + 100 + { + self.last_level_up = self.ticks; + let volume = if self.experience.level > 30 { + 1.0 + } else { + self.experience.level as f32 / 30.0 + }; + self.audio + .play("minecraft:entity.player.levelup", at, volume * 0.75, 1.0); } } /// BowItem.releaseUsing: power from charge time, arrows at power * 3. diff --git a/crates/horizon-client/src/game/commands.rs b/crates/horizon-client/src/game/commands.rs index 6c4817f63..4f53f1add 100644 --- a/crates/horizon-client/src/game/commands.rs +++ b/crates/horizon-client/src/game/commands.rs @@ -1418,7 +1418,9 @@ impl Game<'_> { return Err(err("commands.summon.failed", &[])); } "experience_orb" => { + self.next_entity += 1; self.orbs.push(horizon_client::entities::ExperienceOrb { + id: self.next_entity, position: Vec3::new(pos[0], pos[1], pos[2]), previous: Vec3::new(pos[0], pos[1], pos[2]), velocity: Vec3::new(0.0, 0.0, 0.0), diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index d574b8928..1c7b53f2a 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -714,7 +714,7 @@ impl Game<'_> { /// Mobs and items as the entities guests track. fn lan_entities(&self, hub: &mut Hub) -> Vec { - let mut out = Vec::with_capacity(self.mobs.len() + self.dropped.len()); + let mut out = Vec::with_capacity(self.mobs.len() + self.dropped.len() + self.orbs.len()); for m in self.mobs.iter().filter(|m| !m.removed) { let kind = m.kind.id.as_str(); let meta = mob_meta(m, hub); @@ -752,6 +752,23 @@ impl Game<'_> { equipment: Vec::new(), }); } + for o in &self.orbs { + out.push(EntityState { + id: o.id as i32, + uuid: entity_uuid(o.id), + kind: "minecraft:experience_orb".to_owned(), + position: [o.position.x, o.position.y, o.position.z], + yaw: 0.0, + pitch: 0.0, + head_yaw: 0.0, + on_ground: o.on_ground, + velocity: [o.velocity.x, o.velocity.y, o.velocity.z], + data: 0, + // ExperienceOrb.DATA_VALUE. + meta: vec![(8, serializer::INT, Value::Int(o.value as i32))], + equipment: Vec::new(), + }); + } out } diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index 7cd4b0474..240d5fbaa 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -18,7 +18,7 @@ use horizon_client::{ }, motion::{MotionEvent, MotionWorld, PlayerMotion}, }; -use horizon_core::geometry::Vec3; +use horizon_core::{geometry::Vec3, random::RandomSource}; use horizon_protocol::{ packets::play::{self, Clientbound as C, Serverbound as S}, text::literal, @@ -54,6 +54,8 @@ pub(super) struct GuestPlay { /// `ServerPlayer.getStats` and the inventory `inventory_changed` last saw. pub(super) stats: super::stats::Stats, last_inventory: u64, + /// `Player.takeXpDelay`: ticks until the next orb can be taken. + xp_delay: u32, } struct ItemRules<'a>(&'a horizon_client::items::Items); @@ -1006,6 +1008,7 @@ impl Game<'_> { host.hub.flush_progress(conn); self.guest_dig_feedback(host, conn); self.guest_pickups(host, gi); + self.guest_orbs(host, gi); let g = &mut host.hub.guests[gi]; if g.health <= 0.0 && !g.dead { g.dead = true; @@ -1307,6 +1310,79 @@ impl Game<'_> { } } + /// `Player.tick`'s takeXpDelay and `Player.aiStep`'s touch of the + /// experience orbs in the guest's box grown by 1, 0.5, 1: one of them at + /// random, at most every 2 ticks (`ExperienceOrb.playerTouch`), repairs + /// with Mending and gives the rest as points. Everyone near hears it. + fn guest_orbs(&mut self, host: &mut LanHost, gi: usize) { + let g = &host.hub.guests[gi]; + // Player's standing and crouching boxes: 1.8 and 1.5 high. + let height = if g.sneaking { 1.5 } else { 1.8 }; + let (conn, id, at) = (g.conn, g.entity_id, g.position); + let unable = g.spectator() || g.dead || g.health <= 0.0; + let play = host.play.entry(conn).or_default(); + if play.xp_delay > 0 { + play.xp_delay -= 1; + } + if unable || play.xp_delay > 0 { + return; + } + let (min, max) = ( + [at[0] - 1.3, at[1] - 0.5, at[2] - 1.3], + [at[0] + 1.3, at[1] + height + 0.5, at[2] + 1.3], + ); + let touching: Vec = self + .orbs + .iter() + .enumerate() + .filter(|(_, o)| { + o.position.x + 0.25 > min[0] + && o.position.x - 0.25 < max[0] + && o.position.y + 0.5 > min[1] + && o.position.y < max[1] + && o.position.z + 0.25 > min[2] + && o.position.z - 0.25 < max[2] + }) + .map(|(i, _)| i) + .collect(); + if touching.is_empty() { + return; + } + // Util.getRandom(orbs, random). + let pick = self + .world + .random + .next_int_bound(touching.len() as i32) + .unwrap_or(0) as usize; + let orb = self.orbs.remove(touching[pick]); + play.xp_delay = 2; + host.hub.take_item(orb.id as i32, id, 1, at); + // ClientPacketListener.handleTakeItemEntity's sound, at the orb. + let pitch = (self.world.random.next_float() - self.world.random.next_float()) * 0.35 + 0.9; + let p = orb.position; + self.audio.play( + "minecraft:entity.experience_orb.pickup", + Some([p.x, p.y, p.z]), + 0.1, + pitch, + ); + let value = orb.value; + if let Some(target) = super::pickups::guest_target(host, id as u32) { + use super::pickups::{Collector, Taken}; + self.add_pickup_toward( + Taken::Orb(Box::new(orb)), + Collector::Guest(id as u32), + target, + ); + } + self.as_guest(host, conn, |game| { + let rest = game.mending(value); + if rest > 0 { + game.give_orb_points(rest); + } + }); + } + /// The host's own `ItemPickupParticle` toward the guest's model. fn guest_pickup( &mut self, diff --git a/crates/horizon-client/src/game/persist.rs b/crates/horizon-client/src/game/persist.rs index 96d879f13..27fe36694 100644 --- a/crates/horizon-client/src/game/persist.rs +++ b/crates/horizon-client/src/game/persist.rs @@ -176,7 +176,13 @@ impl Game<'_> { self.dropped.push(e); } } - "minecraft:experience_orb" => self.orbs.extend(entity_nbt::orbs_from_nbt(&tag)), + "minecraft:experience_orb" => { + for mut orb in entity_nbt::orbs_from_nbt(&tag) { + self.next_entity += 1; + orb.id = self.next_entity; + self.orbs.push(orb); + } + } "minecraft:arrow" => { if let Some((mut p, in_block)) = entity_nbt::arrow_from_nbt( &tag, diff --git a/crates/horizon-client/src/game/pickups.rs b/crates/horizon-client/src/game/pickups.rs index 2729dc98f..1e19bcfc3 100644 --- a/crates/horizon-client/src/game/pickups.rs +++ b/crates/horizon-client/src/game/pickups.rs @@ -148,6 +148,7 @@ mod tests { fn orb_at(x: f64, y: f64, z: f64) -> Taken { let at = horizon_core::geometry::Vec3::new(x, y, z); Taken::Orb(Box::new(ExperienceOrb { + id: 0, position: at, previous: at, velocity: horizon_core::geometry::Vec3::new(0.0, 0.0, 0.0), diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 05e1f81c3..def1060f7 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -11,7 +11,7 @@ use horizon_client::{ Result, chunk::{BIOME_STRATEGY, BLOCK_STRATEGY, Chunk, Light, MIN_Y, SECTIONS, Section}, containers::{BlockEntity, Furnace, FurnaceKind}, - entities::{Experience, ItemEntity}, + entities::{Experience, ExperienceOrb, ItemEntity}, hud::{HudBatch, rgba}, items::ItemStack, mobs::{Mob, MobType}, @@ -875,6 +875,19 @@ impl Game<'_> { } else { self.res.mob_types.get(kind).cloned() }; + if kind == "minecraft:experience_orb" { + // Its value (ExperienceOrb.DATA_VALUE) follows in SetEntityData. + self.orbs.retain(|o| o.id != id as u32); + self.orbs.push(ExperienceOrb { + id: id as u32, + position: at, + previous: at, + velocity: Vec3::ZERO, + value: 1, + age: 0, + on_ground: false, + }); + } if let Some(t) = mob_type { let mut mob = Mob::new(id as u32, t, at, head); mob.body_yaw = yaw; @@ -928,6 +941,7 @@ impl Game<'_> { } fn remove_entity(&mut self, id: i32) { 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); if let Some(r) = self.remote.as_mut() { r.entities.remove(&id); @@ -1277,6 +1291,13 @@ impl Game<'_> { { self.remote_item_data(p.id, stack); } + // ExperienceOrb.DATA_VALUE (the icon's size). + if *index == 8 + && let Value::Int(v) = value + && let Some(o) = self.orbs.iter_mut().find(|o| o.id == p.id as u32) + { + o.value = (*v).max(0) as u32; + } } } // ClientPacketListener.handleSetEquipment: what a mob or another @@ -1303,10 +1324,13 @@ impl Game<'_> { } } C::TakeItemEntity(p) => { - if self - .remote - .as_ref() - .is_some_and(|r| r.entity_id == p.player) + // An orb's sound comes from the server, at the orb. + let orb = self.orbs.iter().any(|o| o.id == p.item as u32); + if !orb + && self + .remote + .as_ref() + .is_some_and(|r| r.entity_id == p.player) && let Some(eye) = self.eye_position() { let pitch = ((self.world.random.next_float() - self.world.random.next_float()) @@ -1317,17 +1341,20 @@ impl Game<'_> { .play("minecraft:entity.item.pickup", Some(eye), 0.2, pitch); } // ItemPickupParticle toward the collector (this player, another one or a mob). + let collector = if self + .remote + .as_ref() + .is_some_and(|r| r.entity_id == p.player) + { + super::pickups::Collector::Player + } else { + super::pickups::Collector::Mob(p.player as u32) + }; if let Some(item) = self.dropped.iter().find(|d| d.id == p.item as u32).cloned() { - let collector = if self - .remote - .as_ref() - .is_some_and(|r| r.entity_id == p.player) - { - super::pickups::Collector::Player - } else { - super::pickups::Collector::Mob(p.player as u32) - }; self.add_pickup(super::pickups::Taken::Item(Box::new(item)), collector); + } else if let Some(orb) = self.orbs.iter().find(|o| o.id == p.item as u32).cloned() + { + self.add_pickup(super::pickups::Taken::Orb(Box::new(orb)), collector); } self.remove_entity(p.item); } @@ -2278,6 +2305,21 @@ impl Game<'_> { horizon_client::mobs::rabbit::post_tick(m); } } + for o in self.orbs.iter_mut().filter(|_| running) { + o.previous = o.position; + o.age += 1; + if let Some(l) = lerps.get_mut(&(o.id as i32)) + && l.steps > 0 + { + let n = f64::from(l.steps); + o.position = Vec3::new( + o.position.x + (l.target[0] - o.position.x) / n, + o.position.y + (l.target[1] - o.position.y) / n, + o.position.z + (l.target[2] - o.position.z) / n, + ); + l.steps -= 1; + } + } for d in self.dropped.iter_mut().filter(|_| running) { d.previous = d.position; d.age += 1; diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 667fdda2d..7997d001e 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -20,6 +20,8 @@ address. The script then checks, from both sides, what a guest's game used to ge - containers: the guest's ender chest holds the guest's items, not the host's, and a double chest opens as 9x6 with the right half first; - feedback: the guest's command feedback names the guest and shows the numbers. +- xp: experience orbs 4 blocks away fly to the guest, show on the guest's screen and give the + guest their points (not the host). Each check is reported on its own (a failing one doesn't stop the others) and the screenshots of both sides go to --out (host-*.png, guest-*.png). @@ -48,7 +50,7 @@ from agent_control_e2e import Cli, Failed, game_env # noqa: E402 ROOT = Path(__file__).resolve().parents[1] GUEST_NAME = 'Guest' -CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'damage', 'mobs', 'hazards', 'pvp', 'containers', 'feedback', 'trials'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'damage', 'mobs', 'hazards', 'pvp', 'containers', 'feedback', 'trials', 'xp'] class Game: @@ -622,11 +624,39 @@ def check_trials(host, guest, out): return {'spawner': trial, 'vault': active, 'rewarded': uuid(rewarded), 'host': uuid(host_uuid)} +def check_xp(host, guest, out): + for g in (host, guest): + g('command', command='gamemode survival') + g('command', command='xp set @s 0 levels') + g('command', command='xp set @s 0 points') + guest.wait(10) + x, y, z = pos_of(guest) + # Three orbs of 7 points 4 blocks east of the guest (out of reach, within the 8 blocks orbs + # follow from): they fly to the guest. + for _ in range(3): + guest('command', command=f'summon minecraft:experience_orb {x + 4:.2f} {y + 0.5:.2f} {z:.2f} {{Value:7s}}') + guest.wait(2) + seen = remote(guest).get('entities', {}).get('minecraft:experience_orb', 0) + guest.shot(out, 'xp-orbs') + guest.wait(60) + xp = guest('state')['player']['xp'] + host_xp = host('state')['player']['xp'] + left = remote(guest).get('entities', {}).get('minecraft:experience_orb', 0) + detail = {'seen': seen, 'guest': xp, 'host': host_xp, 'left': left} + # ExperienceOrb.scanForMerges: orbs of one value side by side can merge into one. + assert 1 <= seen <= 3, f'the guest saw {seen} orbs: {detail}' + assert xp['total'] == 21 and xp['level'] == 2, f'the guest\'s experience after three 7-point orbs: {detail}' + assert host_xp['total'] == 0, f'the host took the orbs: {detail}' + assert left == 0, f'orbs left on the guest\'s screen: {detail}' + return {'seen': seen, 'guest': xp, 'host': host_xp} + + CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'nametags': check_nametags, 'chest': check_chest, 'crafting': check_crafting, 'damage': check_damage, 'mobs': check_mobs, 'hazards': check_hazards, 'pvp': check_pvp, 'containers': check_containers, 'feedback': check_feedback, 'trials': check_trials, - 'walls': check_walls} + 'walls': check_walls, + 'xp': check_xp} def run(ctl, out, resources, checks): From 2e531f35e52638330e838036d5b74de600a65216 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 21:25:11 +0200 Subject: [PATCH 007/163] Per-state tables: check state identities while reading, never as a tree occlusion.nbt, cached-collision.nbt, cached-support.nbt, block-properties.nbt and movement-properties.nbt each carry the identity of every block state, and every loader parsed them into an NBT tree first: 240 MB per table for ATM10's 153,511 states, about 1.4 GB allocated and freed while the game starts. nbt::read_named_streaming hands a named list to a visitor element by element. registry::BlockTableFile reads a table that way, checking each state against the registry as it comes, and loaders build from a checked registry::BlockTable. from_nbt stays for trees built in memory (tests, fixtures). Co-Authored-By: Claude Opus 5.5 --- .../examples/resource_memory.rs | 14 -- crates/horizon-client/src/collisions.rs | 14 +- crates/horizon-client/src/light.rs | 14 +- crates/horizon-client/src/models.rs | 8 +- crates/horizon-client/src/motion.rs | 12 +- crates/horizon-world/src/block_properties.rs | 35 ++-- crates/horizon-world/src/block_support.rs | 16 +- crates/horizon-world/src/collision.rs | 19 +- crates/horizon-world/src/level/data.rs | 13 +- .../horizon-world/src/movement_properties.rs | 18 +- crates/horizon-world/src/nbt.rs | 167 +++++++++++++++++- crates/horizon-world/src/registry.rs | 117 ++++++++++++ .../src/worldgen/generator_blocks.rs | 26 ++- crates/horizon-world/tests/collision_data.rs | 72 ++++++++ 14 files changed, 421 insertions(+), 124 deletions(-) diff --git a/crates/horizon-client/examples/resource_memory.rs b/crates/horizon-client/examples/resource_memory.rs index 6deb5a9d4..c292ff2f4 100644 --- a/crates/horizon-client/examples/resource_memory.rs +++ b/crates/horizon-client/examples/resource_memory.rs @@ -122,20 +122,6 @@ fn main() -> Result<()> { step("collision"); let motion = MotionResources::load(&root, &assets)?; step("motion"); - for name in [ - "worldgen/blocks/block-properties.nbt", - "worldgen/blocks/cached-collision.nbt", - "worldgen/blocks/cached-support.nbt", - "cached-collision.nbt", - "occlusion.nbt", - "movement-properties.nbt", - ] { - let bytes = std::fs::read(root.join(name))?; - let tree = horizon_world::nbt::read_named(&bytes, horizon_world::nbt::Limits::tables())?; - step(&format!(" tree of {name}")); - drop((tree, bytes)); - step(" dropped"); - } let terrain = VanillaTerrain::new(&root.join("worldgen"), assets.registry, &biomes, 1234)?; step("worldgen"); println!( diff --git a/crates/horizon-client/src/collisions.rs b/crates/horizon-client/src/collisions.rs index d3e00daca..5d5f4c1bb 100644 --- a/crates/horizon-client/src/collisions.rs +++ b/crates/horizon-client/src/collisions.rs @@ -15,24 +15,18 @@ use horizon_world::{ entity_obstruction::EntityIdentity, fluid::{FluidKind, FluidState}, liquid_collision::LiquidCollisionWorld, - nbt::{self, Limits}, powder_snow_collision::{PowderSnowEntity, PowderSnowWorld}, - registry::BlockRegistry, + registry::{BlockRegistry, BlockTableFile}, world_movement::{ CollisionCheckRequest, EntityMovementWorld, MovementRequest, no_world_collision, resolve_world_movement, }, }; -use std::{fs, io, path::Path, sync::Arc}; +use std::{io, path::Path, sync::Arc}; pub fn load<'r>(root: &Path, registry: &'r BlockRegistry) -> Result> { - let data = nbt::read_named( - &fs::read(root.join("cached-collision.nbt"))?, - Limits::tables(), - )? - .0 - .tag; - let cached = CachedCollisionRegistry::from_nbt(&data, registry)?; + let file = BlockTableFile::open(&root.join("cached-collision.nbt"), registry)?; + let cached = CachedCollisionRegistry::from_table(file.table("collision")?)?; if !cached.has_canonical_identities() { return Err("scene collisions require canonical shape identities".into()); } diff --git a/crates/horizon-client/src/light.rs b/crates/horizon-client/src/light.rs index 595efd9b2..dcf4633a9 100644 --- a/crates/horizon-client/src/light.rs +++ b/crates/horizon-client/src/light.rs @@ -65,17 +65,9 @@ impl LightTables { } /// Full tables with the vanilla occlusion shapes from `occlusion.nbt`. pub fn load(root: &Path, registry: &BlockRegistry, facts: &BlockFacts) -> crate::Result { - use horizon_world::{ - collision::CachedCollisionRegistry, - nbt::{self, Limits}, - }; - let data = nbt::read_named( - &std::fs::read(root.join("occlusion.nbt"))?, - Limits::tables(), - )? - .0 - .tag; - let occlusion = CachedCollisionRegistry::from_nbt(&data, registry)?; + use horizon_world::{collision::CachedCollisionRegistry, registry::BlockTableFile}; + let file = BlockTableFile::open(&root.join("occlusion.nbt"), registry)?; + let occlusion = CachedCollisionRegistry::from_table(file.table("occlusion")?)?; let mut tables = Self::new(facts); let block = VoxelShape::block(); let mut shapes: Vec = vec![VoxelShape::empty(), block.clone()]; diff --git a/crates/horizon-client/src/models.rs b/crates/horizon-client/src/models.rs index 110166f29..5979672e9 100644 --- a/crates/horizon-client/src/models.rs +++ b/crates/horizon-client/src/models.rs @@ -117,13 +117,11 @@ pub fn load_visibility( use horizon_world::{ block_render::{FaceVisibility, RenderDefinition, SkipRendering}, collision::CachedCollisionRegistry, - nbt::{self, Limits}, + registry::BlockTableFile, }; use std::{collections::BTreeMap, fs}; - let data = nbt::read_named(&fs::read(root.join("occlusion.nbt"))?, Limits::tables())? - .0 - .tag; - let occlusion = CachedCollisionRegistry::from_nbt(&data, registry)?; + let file = BlockTableFile::open(&root.join("occlusion.nbt"), registry)?; + let occlusion = CachedCollisionRegistry::from_table(file.table("occlusion")?)?; let raw: BTreeMap = serde_json::from_slice(&fs::read(root.join("render-definitions.json"))?)?; let definitions = raw diff --git a/crates/horizon-client/src/motion.rs b/crates/horizon-client/src/motion.rs index 0eb79d65c..4c026ac45 100644 --- a/crates/horizon-client/src/motion.rs +++ b/crates/horizon-client/src/motion.rs @@ -31,8 +31,7 @@ use horizon_world::{ movement_restitution::{self, RestitutionInput, RestitutionWorld}, movement_statistics::{self, MovementStat, MovementStatisticsWorld}, movement_support::{self, MovementLocation}, - nbt::{self, Limits}, - registry::BlockStateId, + registry::{BlockStateId, BlockTableFile}, world_movement::{self, MovementRequest}, worldgen::tags::TagDefinitions, }; @@ -61,13 +60,8 @@ impl MotionResources { let attributes = Arc::new(Catalog::from_json(&serde_json::from_slice(&fs::read( root.join("attributes.json"), )?)?)?); - let data = nbt::read_named( - &fs::read(root.join("movement-properties.nbt"))?, - Limits::tables(), - )? - .0 - .tag; - let properties = MovementProperties::from_nbt(&data, assets.registry)?; + let file = BlockTableFile::open(&root.join("movement-properties.nbt"), assets.registry)?; + let properties = MovementProperties::from_table(file.table("movement")?)?; let bundle: BTreeMap = serde_json::from_slice(&fs::read(root.join("block-tags.json"))?)?; let mut definitions = TagDefinitions::default(); diff --git a/crates/horizon-world/src/block_properties.rs b/crates/horizon-world/src/block_properties.rs index 2a463b9e3..7c0e17f61 100644 --- a/crates/horizon-world/src/block_properties.rs +++ b/crates/horizon-world/src/block_properties.rs @@ -2,11 +2,10 @@ //! collision shapes. Replacement with an item/fluid context is separate behavior. use crate::{ DATA_VERSION, - chunk::BlockState, collision::CachedCollisionRegistry, compression::invalid, nbt::Tag, - registry::{BlockRegistry, BlockStateId}, + registry::{BlockRegistry, BlockStateId, BlockTable}, }; use horizon_core::geometry::{Direction, ShapeError, ShapeOp, VoxelShape}; use std::{ @@ -112,21 +111,25 @@ pub struct BlockPropertiesRegistry<'r> { } impl<'r> BlockPropertiesRegistry<'r> { pub fn from_nbt(tag: &Tag, collisions: &CachedCollisionRegistry<'r>) -> io::Result { + Self::from_table( + BlockTable::check(tag, collisions.registry(), "block property")?, + collisions, + ) + } + pub fn from_table( + table: BlockTable<'_, '_>, + collisions: &CachedCollisionRegistry<'r>, + ) -> io::Result { let registry = collisions.registry(); + if !std::ptr::eq(table.registry(), registry) { + return Err(invalid( + "block properties and collisions use other registries", + )); + } + let tag = table.tag(); if tag.get("DataVersion") != Some(&Tag::Int(DATA_VERSION)) { return Err(invalid("block properties DataVersion mismatch")); } - let Some(Tag::List(states)) = tag.get("states") else { - return Err(invalid("missing block property state identities")); - }; - if states.len() != registry.len() { - return Err(invalid("block property registry size mismatch")); - } - for (id, state) in states.iter().enumerate() { - if registry.state(BlockStateId(id as u32)) != Some(&BlockState::from_nbt(state)?) { - return Err(invalid("block property state identities differ")); - } - } let Some(Tag::Compound(blocks)) = tag.get("blocks") else { return Err(invalid("missing block definition properties")); }; @@ -150,10 +153,8 @@ impl<'r> BlockPropertiesRegistry<'r> { }, ); } - let occlusion = CachedCollisionRegistry::from_nbt( - tag.get("occlusion") - .ok_or_else(|| invalid("missing block occlusion shapes"))?, - registry, + let occlusion = CachedCollisionRegistry::from_table( + table.nested("occlusion", "block occlusion shapes")?, )?; let mut result = Vec::with_capacity(registry.len()); let mut faces = Vec::with_capacity(registry.len()); diff --git a/crates/horizon-world/src/block_support.rs b/crates/horizon-world/src/block_support.rs index 2c7a9aecc..295999d18 100644 --- a/crates/horizon-world/src/block_support.rs +++ b/crates/horizon-world/src/block_support.rs @@ -61,7 +61,7 @@ use crate::{ collision::CachedCollisionRegistry, compression::invalid, nbt::Tag, - registry::{BlockRegistry, BlockStateId}, + registry::{BlockRegistry, BlockStateId, BlockTable}, }; use std::{collections::HashMap, io}; /// Cached branch of BlockState.isFaceSturdy. Dynamic support-shape selection @@ -72,10 +72,14 @@ pub struct CachedBlockSupportRegistry<'r> { } impl<'r> CachedBlockSupportRegistry<'r> { pub fn from_nbt(tag: &Tag, registry: &'r BlockRegistry) -> io::Result { - if tag.get("Kind") != Some(&Tag::String("block_support".into())) { + Self::from_table(BlockTable::check(tag, registry, "support")?) + } + pub fn from_table(table: BlockTable<'_, 'r>) -> io::Result { + if table.get("Kind") != Some(&Tag::String("block_support".into())) { return Err(invalid("wrong cached support data kind")); } - let shapes = CachedCollisionRegistry::from_nbt(tag, registry)?; + let registry = table.registry(); + let shapes = CachedCollisionRegistry::from_table(table)?; let mut cache = HashMap::new(); let mut states = Vec::with_capacity(registry.len()); for id in 0..registry.len() { @@ -163,7 +167,11 @@ impl std::fmt::Display for SupportQueryError { impl std::error::Error for SupportQueryError {} impl<'r> BlockSupportRegistry<'r> { pub fn from_nbt(tag: &Tag, registry: &'r BlockRegistry) -> io::Result { - let cached = CachedBlockSupportRegistry::from_nbt(tag, registry)?; + Self::from_table(BlockTable::check(tag, registry, "support")?) + } + pub fn from_table(table: BlockTable<'_, 'r>) -> io::Result { + let registry = table.registry(); + let cached = CachedBlockSupportRegistry::from_table(table)?; let mut dynamic = HashMap::new(); for id in 0..registry.len() { let id = BlockStateId(id as u32); diff --git a/crates/horizon-world/src/collision.rs b/crates/horizon-world/src/collision.rs index 694264a5e..3d3311646 100644 --- a/crates/horizon-world/src/collision.rs +++ b/crates/horizon-world/src/collision.rs @@ -5,10 +5,10 @@ //! This module covers the cached branch only; uncached states remain explicit. use crate::{ DATA_VERSION, - chunk::{BlockSection, BlockState}, + chunk::BlockSection, compression::invalid, nbt::Tag, - registry::{BlockRegistry, BlockStateId}, + registry::{BlockRegistry, BlockStateId, BlockTable}, }; use horizon_core::geometry::{Axis, VoxelShape}; use std::{collections::HashMap, io}; @@ -35,20 +35,13 @@ impl<'r> CachedCollisionRegistry<'r> { self.registry } pub fn from_nbt(tag: &Tag, registry: &'r BlockRegistry) -> io::Result { + Self::from_table(BlockTable::check(tag, registry, "collision")?) + } + pub fn from_table(table: BlockTable<'_, 'r>) -> io::Result { + let (tag, registry) = (table.tag(), table.registry()); if tag.get("DataVersion") != Some(&Tag::Int(DATA_VERSION)) { return Err(invalid("collision DataVersion mismatch")); } - let Some(Tag::List(states)) = tag.get("states") else { - return Err(invalid("missing collision state identities")); - }; - if states.len() != registry.len() { - return Err(invalid("collision registry size mismatch")); - } - for (id, state) in states.iter().enumerate() { - if registry.state(BlockStateId(id as u32)) != Some(&BlockState::from_nbt(state)?) { - return Err(invalid("collision state identities differ")); - } - } let Some(Tag::List(entries)) = tag.get("shapes") else { return Err(invalid("missing collision shapes")); }; diff --git a/crates/horizon-world/src/level/data.rs b/crates/horizon-world/src/level/data.rs index 280f21582..0862aa5b8 100644 --- a/crates/horizon-world/src/level/data.rs +++ b/crates/horizon-world/src/level/data.rs @@ -8,8 +8,7 @@ use crate::{ collision::CachedCollisionRegistry, compression::invalid, fluid::{FluidBlockBindings, FluidKind, FluidState}, - nbt::{self, Limits}, - registry::{BlockRegistry, BlockStateId}, + registry::{BlockRegistry, BlockStateId, BlockTableFile}, worldgen::tags::TagDefinitions, }; use horizon_core::geometry::{Aabb, Direction, ShapeOp, Vec3, VoxelShape}; @@ -787,14 +786,8 @@ fn build_with_gameplay( }; // Collision shapes. - let collision_tag = nbt::read_named( - &fs::read(root.join("cached-collision.nbt"))?, - Limits::tables(), - ) - .map_err(|e| invalid(e.to_string()))? - .0 - .tag; - let cached = CachedCollisionRegistry::from_nbt(&collision_tag, registry)?; + let collision_file = BlockTableFile::open(&root.join("cached-collision.nbt"), registry)?; + let cached = CachedCollisionRegistry::from_table(collision_file.table("collision")?)?; let mut shapes: Vec = Vec::new(); let mut shape_ids = Vec::with_capacity(table.state_count()); for id in 0..table.state_count() { diff --git a/crates/horizon-world/src/movement_properties.rs b/crates/horizon-world/src/movement_properties.rs index 84cafae1e..9e1dc6236 100644 --- a/crates/horizon-world/src/movement_properties.rs +++ b/crates/horizon-world/src/movement_properties.rs @@ -1,11 +1,10 @@ //! Registry-bound block movement coefficients, identities and reloadable tags. use crate::{ DATA_VERSION, - chunk::BlockState, compression::invalid, movement_support::MovementBlockWorld, nbt::Tag, - registry::{BlockRegistry, BlockStateId}, + registry::{BlockRegistry, BlockStateId, BlockTable}, }; use horizon_core::position::BlockPos; use std::{ @@ -55,20 +54,13 @@ impl<'r> MovementProperties<'r> { } pub fn from_nbt(tag: &Tag, registry: &'r BlockRegistry) -> io::Result { + Self::from_table(BlockTable::check(tag, registry, "movement")?) + } + pub fn from_table(table: BlockTable<'_, 'r>) -> io::Result { + let (tag, registry) = (table.tag(), table.registry()); if tag.get("DataVersion") != Some(&Tag::Int(DATA_VERSION)) { return Err(invalid("movement properties DataVersion mismatch")); } - let Some(Tag::List(states)) = tag.get("states") else { - return Err(invalid("missing movement state identities")); - }; - if states.len() != registry.len() { - return Err(invalid("movement registry size mismatch")); - } - for (id, state) in states.iter().enumerate() { - if registry.state(BlockStateId(id as u32)) != Some(&BlockState::from_nbt(state)?) { - return Err(invalid("movement state identities differ")); - } - } let Some(Tag::Compound(blocks)) = tag.get("blocks") else { return Err(invalid("missing movement definitions")); }; diff --git a/crates/horizon-world/src/nbt.rs b/crates/horizon-world/src/nbt.rs index 414767795..2a8b11591 100644 --- a/crates/horizon-world/src/nbt.rs +++ b/crates/horizon-world/src/nbt.rs @@ -124,13 +124,20 @@ impl std::fmt::Display for Error { } impl std::error::Error for Error {} -struct Reader<'a> { +/// Hands a streamed list's elements to the caller one at a time (see +/// [`read_named_streaming`]). +type Visit<'s> = &'s mut dyn FnMut(&mut ListElements<'_, '_, '_>) -> Result<(), Error>; + +struct Reader<'a, 's> { bytes: &'a [u8], offset: usize, limits: Limits, nodes: usize, + /// Lists with this key in the root compound or in a compound directly + /// under it are streamed to the visitor instead of kept. + stream: Option<(&'s str, Visit<'s>)>, } -impl<'a> Reader<'a> { +impl<'a> Reader<'a, '_> { fn error(&self, reason: &'static str) -> Error { Error { offset: self.offset, @@ -266,7 +273,11 @@ impl<'a> Reader<'a> { break; } let name = self.string()?; - let value = self.payload(id, depth + 1)?; + let value = if id == 9 && depth <= 1 && self.streams(&name) { + self.stream_list(depth + 1)? + } else { + self.payload(id, depth + 1)? + }; map.insert(name, value); // Java maps retain the last duplicate key. } Tag::Compound(map) @@ -290,6 +301,82 @@ impl<'a> Reader<'a> { _ => return Err(self.error("unknown tag type")), }) } + fn streams(&self, name: &JavaString) -> bool { + self.stream + .as_ref() + .is_some_and(|(key, _)| name.0.iter().copied().eq(key.encode_utf16())) + } + /// A list's payload handed to the visitor element by element; the tree + /// keeps it empty. Elements the visitor leaves are read and dropped. + fn stream_list(&mut self, depth: usize) -> Result { + if self.nodes >= self.limits.max_nodes { + return Err(self.error("node limit exceeded")); + } + self.nodes += 1; + if depth >= self.limits.max_depth { + return Err(self.error("depth limit exceeded")); + } + let element_id = self.byte()?; + let len = self.count(0)?; + if len > 0 && (element_id == 0 || element_id > 12) { + return Err(self.error("invalid list element type")); + } + if len > self.bytes.len().saturating_sub(self.offset) { + return Err(self.error("truncated list")); + } + let (key, visit) = self.stream.take().expect("streams() checked the visitor"); + let mut elements = ListElements { + reader: self, + element_id, + depth: depth + 1, + len, + left: len, + }; + let rest = visit(&mut elements).and_then(|()| { + while elements.next_element()?.is_some() {} + Ok(()) + }); + self.stream = Some((key, visit)); + rest.map(|()| Tag::List(Vec::new())) + } +} + +/// The elements of a list [`read_named_streaming`] streams, read one at a +/// time. +pub struct ListElements<'r, 'a, 's> { + reader: &'r mut Reader<'a, 's>, + element_id: u8, + depth: usize, + len: usize, + left: usize, +} +impl ListElements<'_, '_, '_> { + /// The list's length, as its header gives it. + pub fn len(&self) -> usize { + self.len + } + pub fn is_empty(&self) -> bool { + self.len == 0 + } + /// The next element, unwrapped as [`read_named`] unwraps mixed-list + /// elements; `None` past the last. + pub fn next_element(&mut self) -> Result, Error> { + if self.left == 0 { + return Ok(None); + } + self.left -= 1; + let mut value = self.reader.payload(self.element_id, self.depth)?; + if let Tag::Compound(map) = &mut value { + if map.len() == 1 && map.contains_key(&JavaString::default()) { + value = map.remove(&JavaString::default()).unwrap(); + } + } + Ok(Some(value)) + } + /// An error at the current position in the input. + pub fn error(&self, reason: &'static str) -> Error { + self.reader.error(reason) + } } /// Read a file root (type, modified-UTF name, payload), returning bytes consumed. @@ -299,6 +386,35 @@ pub fn read_named(bytes: &[u8], limits: Limits) -> Result<(NamedTag, usize), Err offset: 0, limits, nodes: 0, + stream: None, + }; + let id = reader.byte()?; + let name = if id == 0 { + JavaString::default() + } else { + reader.string()? + }; + let tag = reader.payload(id, 0)?; + Ok((NamedTag { name, tag }, reader.offset)) +} + +/// [`read_named`], except that lists keyed `key` in the root compound or in +/// a compound directly under it are not kept: `visit` reads each one's +/// elements as they come, and the tree holds it as an empty list. Per-state +/// tables check hundreds of thousands of state identities this way without +/// holding them as a tree (crate::registry::BlockTableFile). +pub fn read_named_streaming( + bytes: &[u8], + limits: Limits, + key: &str, + visit: &mut dyn FnMut(&mut ListElements<'_, '_, '_>) -> Result<(), Error>, +) -> Result<(NamedTag, usize), Error> { + let mut reader = Reader { + bytes, + offset: 0, + limits, + nodes: 0, + stream: Some((key, visit)), }; let id = reader.byte()?; let name = if id == 0 { @@ -317,6 +433,7 @@ pub fn read_network(bytes: &[u8], limits: Limits) -> Result<(Tag, usize), Error> offset: 0, limits, nodes: 0, + stream: None, }; let id = reader.byte()?; let tag = reader.payload(id, 0)?; @@ -659,6 +776,50 @@ impl Snbt<'_> { mod tests { use super::*; #[test] + fn streamed_lists_reach_the_visitor_and_stay_empty_in_the_tree() { + let list = |n: i32| Tag::List((0..n).map(Tag::Int).collect()); + let root = NamedTag { + name: "".into(), + tag: Tag::compound([ + ("states", list(3)), + ("inner", Tag::compound([("states", list(2))])), + ( + "deep", + Tag::compound([("inner", Tag::compound([("states", list(1))]))]), + ), + ("other", list(4)), + ]), + }; + let bytes = write_named(&root, Limits::default()).unwrap(); + let mut seen = Vec::new(); + let (read, used) = read_named_streaming(&bytes, Limits::default(), "states", &mut |l| { + let mut values = vec![l.len() as i32]; + // Elements left unread are skipped. + if let Some(Tag::Int(v)) = l.next_element()? { + values.push(v); + } + seen.push(values); + Ok(()) + }) + .unwrap(); + assert_eq!(used, bytes.len()); + // Compounds are written in key order: `inner` before `states`. + assert_eq!(seen, [vec![2, 0], vec![3, 0]]); + assert_eq!(read.tag.get("states"), Some(&Tag::List(Vec::new()))); + assert_eq!( + read.tag.get("inner").unwrap().get("states"), + Some(&Tag::List(Vec::new())) + ); + // Only the root and its direct children stream. + assert_eq!(read.tag.get("deep"), root.tag.get("deep")); + assert_eq!(read.tag.get("other"), root.tag.get("other")); + // A visitor's error stops the read. + let failed = read_named_streaming(&bytes, Limits::default(), "states", &mut |l| { + Err(l.error("refused")) + }); + assert_eq!(failed.unwrap_err().reason, "refused"); + } + #[test] fn wire_node_budget_includes_mixed_list_wrappers() { let tag = Tag::List(vec![Tag::Int(1), Tag::Byte(2)]); let limits = Limits { diff --git a/crates/horizon-world/src/registry.rs b/crates/horizon-world/src/registry.rs index 5ca2e994a..30cd5e83c 100644 --- a/crates/horizon-world/src/registry.rs +++ b/crates/horizon-world/src/registry.rs @@ -132,3 +132,120 @@ impl BlockRegistry { .ok_or_else(|| invalid("invalid block property value")) } } + +/// A per-state table (`occlusion.nbt`, `cached-collision.nbt`, ...) whose +/// `states` list, the identity of every state it describes in id order, has +/// been checked against `registry`. +#[derive(Clone, Copy)] +pub struct BlockTable<'t, 'r> { + tag: &'t Tag, + registry: &'r BlockRegistry, + /// How many levels, from this one down, [`BlockTableFile::read`] checked + /// while reading: their `states` lists are kept empty in the tree. + read_checked: u8, +} +impl<'t, 'r> BlockTable<'t, 'r> { + /// Checks that `tag`'s `states` names the registry's states in id order. + pub fn check(tag: &'t Tag, registry: &'r BlockRegistry, what: &str) -> io::Result { + Self { + tag, + registry, + read_checked: 0, + } + .checked(what) + } + fn checked(self, what: &str) -> io::Result { + let Some(Tag::List(states)) = self.tag.get("states") else { + return Err(invalid(format!("missing {what} state identities"))); + }; + if self.read_checked == 0 { + if states.len() != self.registry.len() { + return Err(invalid(format!("{what} registry size mismatch"))); + } + for (id, state) in states.iter().enumerate() { + if self.registry.state(BlockStateId(id as u32)) + != Some(&BlockState::from_nbt(state)?) + { + return Err(invalid(format!("{what} state identities differ"))); + } + } + } + Ok(self) + } + /// The table nested under `key` (`block-properties.nbt`'s `occlusion`), + /// with its own `states`, checked the same way. + pub fn nested(&self, key: &str, what: &str) -> io::Result { + Self { + tag: self + .tag + .get(key) + .ok_or_else(|| invalid(format!("missing {what}")))?, + registry: self.registry, + read_checked: self.read_checked.saturating_sub(1), + } + .checked(what) + } + pub fn tag(&self) -> &'t Tag { + self.tag + } + pub fn get(&self, key: &str) -> Option<&'t Tag> { + self.tag.get(key) + } + pub fn registry(&self) -> &'r BlockRegistry { + self.registry + } +} + +/// A per-state table read from its file with its state identities checked +/// while reading, so they never exist as a tree: for 190,000 states (a big +/// modpack) that tree took 300-600 MB per table. +pub struct BlockTableFile<'r> { + tag: Tag, + registry: &'r BlockRegistry, +} +impl<'r> BlockTableFile<'r> { + /// [`Self::read`] of the file at `path`. + pub fn open(path: &std::path::Path, registry: &'r BlockRegistry) -> io::Result { + let bytes = std::fs::read(path)?; + Self::read(&bytes, registry).map_err(|e| invalid(format!("{}: {e}", path.display()))) + } + /// Reads `bytes`, checking every `states` list of the root compound and + /// of the compounds directly under it against `registry`. + pub fn read(bytes: &[u8], registry: &'r BlockRegistry) -> io::Result { + let mut visit = |states: &mut crate::nbt::ListElements<'_, '_, '_>| { + if states.len() != registry.len() { + return Err(states.error("table registry size mismatch")); + } + let mut id = 0u32; + while let Some(tag) = states.next_element()? { + let state = + BlockState::from_nbt(&tag).map_err(|_| states.error("invalid table state"))?; + if registry.state(BlockStateId(id)) != Some(&state) { + return Err(states.error("table state identities differ")); + } + id += 1; + } + Ok(()) + }; + let (named, _) = crate::nbt::read_named_streaming( + bytes, + crate::nbt::Limits::tables(), + "states", + &mut visit, + ) + .map_err(|e| invalid(e.to_string()))?; + Ok(Self { + tag: named.tag, + registry, + }) + } + /// The table, checked (`what` names it in errors). + pub fn table(&self, what: &str) -> io::Result> { + BlockTable { + tag: &self.tag, + registry: self.registry, + read_checked: 2, + } + .checked(what) + } +} diff --git a/crates/horizon-world/src/worldgen/generator_blocks.rs b/crates/horizon-world/src/worldgen/generator_blocks.rs index dc7db7d20..ed1182f36 100644 --- a/crates/horizon-world/src/worldgen/generator_blocks.rs +++ b/crates/horizon-world/src/worldgen/generator_blocks.rs @@ -8,8 +8,7 @@ use crate::{ block_support::BlockSupportRegistry, block_survival::{BlockSurvivalRegistry, SurvivalDefinitions, SurvivalRule}, collision::CachedCollisionRegistry, - nbt::{self, Limits, Tag}, - registry::BlockRegistry, + registry::{BlockRegistry, BlockTableFile}, }; use serde_json::Value; use std::{ @@ -102,24 +101,21 @@ impl BlockBehavior { if !dir.join("block-properties.nbt").exists() { return Ok(None); } - let read = |name: &str| -> Result { - Ok( - nbt::read_named(&fs::read(dir.join(name))?, Limits::tables()) - .map_err(|e| resource(format!("{name}: {e:?}")))? - .0 - .tag, - ) + let read = |name: &str| -> Result, GeneratorError> { + BlockTableFile::open(&dir.join(name), registry) + .map_err(|e| resource(format!("{name}: {e}"))) }; let json = |name: &str| -> Result { Ok(serde_json::from_str(&fs::read_to_string(dir.join(name))?)?) }; let collisions = - CachedCollisionRegistry::from_nbt(&read("cached-collision.nbt")?, registry)?; - let properties = - BlockPropertiesRegistry::from_nbt(&read("block-properties.nbt")?, &collisions)?; - let support = Arc::new(BlockSupportRegistry::from_nbt( - &read("cached-support.nbt")?, - registry, + CachedCollisionRegistry::from_table(read("cached-collision.nbt")?.table("collision")?)?; + let properties = BlockPropertiesRegistry::from_table( + read("block-properties.nbt")?.table("block property")?, + &collisions, + )?; + let support = Arc::new(BlockSupportRegistry::from_table( + read("cached-support.nbt")?.table("support")?, )?); let collision = Arc::new(BlockCollisionRegistry::new(Arc::new(collisions))?); let rules = json("survival-rules.json")? diff --git a/crates/horizon-world/tests/collision_data.rs b/crates/horizon-world/tests/collision_data.rs index 3738edf1a..85b41d98e 100644 --- a/crates/horizon-world/tests/collision_data.rs +++ b/crates/horizon-world/tests/collision_data.rs @@ -267,3 +267,75 @@ fn registry_scan_binding_requires_complete_canonical_metadata() { ); } } + +/// A table read from its bytes checks its state identities while reading and +/// keeps none of them, yet loads the same shapes as the tree; a nested table +/// (`block-properties.nbt`'s `occlusion`) is checked the same way. +#[test] +fn streamed_tables_check_states_while_reading() { + use horizon_world::{ + nbt::{self, Limits, NamedTag}, + registry::{BlockTable, BlockTableFile}, + }; + let (registry_tag, collision_tag) = fixture(); + let registry = BlockRegistry::from_nbt(®istry_tag).unwrap(); + let bytes = |tag: &Tag| { + let root = NamedTag { + name: "".into(), + tag: tag.clone(), + }; + nbt::write_named(&root, Limits::tables()).unwrap() + }; + let file = BlockTableFile::read(&bytes(&collision_tag), ®istry).unwrap(); + let table = file.table("collision").unwrap(); + assert_eq!(table.get("states"), Some(&Tag::List(Vec::new()))); + let streamed = CachedCollisionRegistry::from_table(table).unwrap(); + let tree = CachedCollisionRegistry::from_nbt(&collision_tag, ®istry).unwrap(); + for id in 0..3 { + let id = BlockStateId(id); + assert_eq!( + streamed.cached_shape(id).unwrap().map(|s| s.boxes()), + tree.cached_shape(id).unwrap().map(|s| s.boxes()) + ); + } + + let mut outer = Tag::compound([("occlusion", collision_tag.clone())]); + let Tag::Compound(map) = &mut outer else { + unreachable!() + }; + map.insert( + "states".into(), + collision_tag.get("states").unwrap().clone(), + ); + let file = BlockTableFile::read(&bytes(&outer), ®istry).unwrap(); + let nested = file + .table("outer") + .unwrap() + .nested("occlusion", "occlusion") + .unwrap(); + assert_eq!(nested.get("states"), Some(&Tag::List(Vec::new()))); + CachedCollisionRegistry::from_table(nested).unwrap(); + // Checked only as a tree, an emptied list is refused. + assert!(BlockTable::check(nested.tag(), ®istry, "occlusion").is_err()); + + // Other states, a different count or no states at all are refused. + let with_states = |edit: &dyn Fn(&mut Vec)| { + let mut tag = collision_tag.clone(); + let Some(Tag::List(states)) = tag.get_mut("states") else { + unreachable!() + }; + edit(states); + tag + }; + let swapped = with_states(&|s| s.swap(1, 2)); + assert!(BlockTableFile::read(&bytes(&swapped), ®istry).is_err()); + let short = with_states(&|s| drop(s.pop())); + assert!(BlockTableFile::read(&bytes(&short), ®istry).is_err()); + let mut swapped = swapped; + let Tag::Compound(map) = &mut swapped else { + unreachable!() + }; + map.remove(&"states".into()); + let file = BlockTableFile::read(&bytes(&swapped), ®istry).unwrap(); + assert!(file.table("collision").is_err()); +} From 4ae51c1d5ee5e8a06dda0c6aae67cddbde148909 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 21:39:48 +0200 Subject: [PATCH 008/163] perf_bench --warm: measure a later start, after a first one built the caches A Horizon game with content mods builds its content root and block behaviour snapshot on its first start, in its game folder, and reuses them afterwards. perf_bench starts every game from an empty folder, so it only measured first starts. --warm starts the game once to the title screen first, unmeasured. Co-Authored-By: Claude Opus 5.5 --- tools/perf_bench.py | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/tools/perf_bench.py b/tools/perf_bench.py index bbae4934f..6d0c5571d 100644 --- a/tools/perf_bench.py +++ b/tools/perf_bench.py @@ -364,6 +364,20 @@ def run_horizon(args, distance): for carry in dev_mods(args): command += ["--dev-mod", str(carry)] env = dict(os.environ, HORIZON_NO_AUDIO="1") + if args.warm: + # A first start to the title screen builds what later starts reuse (the content-mod + # root, the block behaviour snapshot). It is not measured: players see it once. + with (WORK / f"horizon-rd{distance}-warm.log").open("w") as log: + proc = subprocess.Popen(command, cwd=game_dir, env=env, stdout=log, stderr=subprocess.STDOUT) + try: + poll(Control(sock), lambda s: s.get("screen") == "title", 600) + try: + Control(sock)("quit", timeout=60) + except (OSError, ValueError, RuntimeError): + pass + finally: + stop(proc) + sock.unlink(missing_ok=True) log = (WORK / f"horizon-rd{distance}.log").open("w") started = time.time() proc = subprocess.Popen(command, cwd=game_dir, env=env, stdout=log, stderr=subprocess.STDOUT) @@ -774,6 +788,8 @@ def main(): p.add_argument("--build", default=str(ROOT / "target/release")) p.add_argument("--repeats", type=int, default=3, help="games per render distance; the report gives means and 95%% CIs") p.add_argument("--port-work", help="horizon: also load the mods carried over in this horizon-port-pack work folder") + p.add_argument("--warm", action="store_true", + help="horizon: measure a later start, after one start to the title screen built the caches") p.add_argument("--mod-jars", help="neoforge: the mod jars to load (the user's own; never committed)") p.add_argument("--deps", help="neoforge: their required libraries") p.add_argument("--table", nargs="+", metavar="LABEL", help="print markdown tables of saved runs, and exit") From 238278aa41e208364b394750a3c41c855d07e530 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sat, 17 Oct 2026 20:40:10 +0100 Subject: [PATCH 009/163] Startup: keep the title's atlas and panorama in one UI bundle (#712) The title's GUI atlas and its panorama both come from the resource root and are only needed to draw the title and menus, but they lived apart: the atlas on Game and the panorama inside PackResources. Gather them into UiResources so Stage 2 can load the title bundle before the world bundle. No behaviour change. Part of #712 (stage 2a). --- crates/horizon-client/src/game.rs | 158 ++++++++++-------- .../horizon-client/src/game/advancements.rs | 6 +- .../src/game/advancements_screen.rs | 18 +- .../horizon-client/src/game/armor_stands.rs | 6 +- crates/horizon-client/src/game/beacon.rs | 16 +- crates/horizon-client/src/game/boats.rs | 1 + crates/horizon-client/src/game/books.rs | 6 +- crates/horizon-client/src/game/cartography.rs | 6 +- crates/horizon-client/src/game/chat.rs | 28 ++-- .../horizon-client/src/game/command_blocks.rs | 2 +- crates/horizon-client/src/game/commands.rs | 2 +- crates/horizon-client/src/game/control.rs | 2 +- crates/horizon-client/src/game/creatures.rs | 2 +- crates/horizon-client/src/game/debug_keys.rs | 2 +- crates/horizon-client/src/game/dragon.rs | 16 +- crates/horizon-client/src/game/end.rs | 8 +- crates/horizon-client/src/game/extras.rs | 8 +- crates/horizon-client/src/game/fangs.rs | 1 + crates/horizon-client/src/game/fishing.rs | 1 + crates/horizon-client/src/game/fov.rs | 2 +- crates/horizon-client/src/game/frames.rs | 2 +- .../src/game/gamemode_switcher.rs | 6 +- crates/horizon-client/src/game/integrated.rs | 11 +- crates/horizon-client/src/game/item_draw.rs | 6 +- crates/horizon-client/src/game/lan.rs | 2 +- crates/horizon-client/src/game/lan_screen.rs | 17 +- crates/horizon-client/src/game/leads.rs | 2 +- crates/horizon-client/src/game/lightning.rs | 2 +- crates/horizon-client/src/game/loom.rs | 4 +- crates/horizon-client/src/game/machines.rs | 2 +- .../src/game/machines/crafter.rs | 2 +- crates/horizon-client/src/game/maps.rs | 7 +- crates/horizon-client/src/game/minecarts.rs | 7 +- crates/horizon-client/src/game/mob_blocks.rs | 6 +- crates/horizon-client/src/game/mods.rs | 4 +- crates/horizon-client/src/game/mount_menu.rs | 4 +- crates/horizon-client/src/game/mounts.rs | 2 +- crates/horizon-client/src/game/names.rs | 6 +- crates/horizon-client/src/game/options.rs | 18 +- crates/horizon-client/src/game/packs.rs | 10 +- crates/horizon-client/src/game/pad_menu.rs | 10 +- crates/horizon-client/src/game/paintings.rs | 2 +- crates/horizon-client/src/game/perspective.rs | 11 +- crates/horizon-client/src/game/potions.rs | 6 +- crates/horizon-client/src/game/recipe_book.rs | 8 +- crates/horizon-client/src/game/remote.rs | 11 +- crates/horizon-client/src/game/render_tick.rs | 2 +- crates/horizon-client/src/game/scoreboard.rs | 8 +- crates/horizon-client/src/game/screens.rs | 8 +- crates/horizon-client/src/game/sign_edit.rs | 6 +- crates/horizon-client/src/game/spawner.rs | 2 +- crates/horizon-client/src/game/stations.rs | 22 +-- .../horizon-client/src/game/stats_screen.rs | 10 +- crates/horizon-client/src/game/storage.rs | 2 +- .../horizon-client/src/game/subtitle_hud.rs | 2 +- crates/horizon-client/src/game/titles.rs | 8 +- crates/horizon-client/src/game/tnt.rs | 2 +- crates/horizon-client/src/game/trading.rs | 10 +- crates/horizon-client/src/game/trident.rs | 1 + crates/horizon-client/src/game/tweaks.rs | 2 +- crates/horizon-client/src/game/wind.rs | 1 + 61 files changed, 304 insertions(+), 241 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 00d3f2441..0ae271301 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -693,6 +693,23 @@ pub struct Resources { /// Enchantments, workstation recipes and brewing (game/stations.rs). stations: horizon_client::stations::StationData, } +/// Everything the title and menus draw: the GUI atlas with its font and the +/// title panorama. Kept apart from the world bundle so the title can appear +/// before the block sprites, models and gameplay tables are ready. +pub struct UiResources { + /// The GUI, font, particle, map and skin atlas. + pub atlas: HudAtlas, + /// The title screen's panorama faces. + pub panorama: Arc, +} +impl UiResources { + pub fn load(root: &std::path::Path) -> Result { + Ok(Self { + atlas: HudAtlas::build(root)?, + panorama: Arc::new(horizon_client::gfx::panorama::Faces::load(root)), + }) + } +} /// What a resource pack reload replaces (`Minecraft.reloadResourcePacks`): /// block models and sprites with their meshing tables, item models, /// translations and the textures read on the CPU. Each game holds its own; @@ -702,7 +719,6 @@ pub struct PackResources { assets: Arc, context: Arc, layer_names: Arc>, - panorama: Arc, /// Item definitions, baked item models and special renderers. item_renderer: Arc, names: Arc, @@ -741,7 +757,6 @@ impl PackResources { light, }), assets, - panorama: Arc::new(horizon_client::gfx::panorama::Faces::load(root)), item_renderer: Arc::new(item_renderer), names: Arc::new(Names::load(root)), clouds: Arc::new(load_clouds(root)), @@ -778,8 +793,8 @@ struct Game<'a> { motion: &'a MotionResources, /// This game's resource packs (`reload_packs` replaces them). pack: PackResources, - /// The GUI, font, particle, map and skin atlas. - atlas: HudAtlas, + /// The title and menu bundle (GUI atlas, font and panorama). + gui: UiResources, /// `FogRenderer`'s evolving state. fog: horizon_client::fog::FogState, screen_fx: horizon_client::screen_effects::ScreenEffects, @@ -3741,7 +3756,7 @@ impl Game<'_> { let (stack, capped) = match drag.and_then(|d| d.slots.get(&slot)) { Some(None) => return, Some(Some((count, capped))) => { - batch.fill(&self.atlas, x, y, 16.0, 16.0, rgba(255, 255, 255, 128)); + batch.fill(&self.gui.atlas, x, y, 16.0, 16.0, rgba(255, 255, 255, 128)); let carried = self .carried .clone() @@ -3836,10 +3851,10 @@ impl Game<'_> { 0, 0, &decorations, - &self.atlas.font, + &self.gui.atlas.font, )); draws.push(hud_layout::GuiDraw::Pop); - hud_layout::paint(batch, &self.atlas, &draws); + hud_layout::paint(batch, &self.gui.atlas, &draws); } fn hud(&mut self, size: [u32; 2]) -> HudBatch { let mut batch = self.hud_layers(size); @@ -3847,7 +3862,7 @@ impl Game<'_> { // and the toasts, so it is over everything, menus included. self.draw_debug_overlay(&mut batch, size); self.frame_graph - .draw(self.settings.horizon.overlay, &mut batch, &self.atlas); + .draw(self.settings.horizon.overlay, &mut batch, &self.gui.atlas); self.draw_pad_cursor(&mut batch); batch } @@ -3868,12 +3883,12 @@ impl Game<'_> { if horizon_client::ui_theme::horizon() { let fade = self.backdrop_fade(); let mut ui = - horizon_client::ui_theme::Ui::new(&self.atlas, &mut batch, self.cursor); + horizon_client::ui_theme::Ui::new(&self.gui.atlas, &mut batch, self.cursor); title.draw_horizon(&mut ui, fade); ui.finish(); } else { title.draw( - &self.atlas, + &self.gui.atlas, &mut batch, self.cursor, self.settings.file.bool("hideSplashTexts"), @@ -3881,7 +3896,7 @@ impl Game<'_> { } return batch; } - let atlas_ptr: *const HudAtlas = &self.atlas; + let atlas_ptr: *const HudAtlas = &self.gui.atlas; let _ = atlas_ptr; if self.remote_overlay(&mut batch) { return batch; @@ -3912,7 +3927,7 @@ impl Game<'_> { hud_layout::full_attack_indicator(a, delay, self.crosshair_living()) }); let draws = hud_layout::crosshair(wi, hi, attack, full); - hud_layout::paint(&mut batch, &self.atlas, &draws); + hud_layout::paint(&mut batch, &self.gui.atlas, &draws); } if !spectator { let inputs = hud_layout::HotbarInputs { @@ -3924,7 +3939,7 @@ impl Game<'_> { attack: (indicator == 2).then_some(strength), }; let draws = hud_layout::hotbar(wi, hi, &inputs); - hud_layout::paint(&mut batch, &self.atlas, &draws); + hud_layout::paint(&mut batch, &self.gui.atlas, &draws); for d in &draws { if let hud_layout::GuiDraw::Item { slot, x, y, .. } = *d { let stack = if slot == 40 { @@ -3954,7 +3969,7 @@ impl Game<'_> { && !spectator && let Some(p) = &mut self.player { - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let width = |s: &str| HudBatch::text_width(atlas, s) as i32; let draws = hud_layout::experience( wi, @@ -4017,13 +4032,13 @@ impl Game<'_> { } // Hud.extractSleepOverlay: over all health/food bars, under titles and chat. let draws = hud_overlays::sleep_overlay(wi, hi, self.sleep_timer as i32); - hud_layout::paint(&mut batch, &self.atlas, &draws); + hud_layout::paint(&mut batch, &self.gui.atlas, &draws); if show_hud { self.draw_titles(&mut batch); self.draw_scoreboard(&mut batch); self.draw_subtitles(&mut batch); } - let atlas = &self.atlas; + let atlas = &self.gui.atlas; if show_hud && let Some((text, at)) = &self.message && at.elapsed() < Duration::from_secs(3) @@ -4040,9 +4055,9 @@ impl Game<'_> { // PauseScreen(false): only its title, at the top. Screen::Paused => { let title = self.translate("menu.paused", "Game Paused"); - let tw = HudBatch::text_width(&self.atlas, &title); + let tw = HudBatch::text_width(&self.gui.atlas, &title); batch.text( - &self.atlas, + &self.gui.atlas, &title, ((batch.width / 2.0).floor() - (tw / 2.0).floor()).floor(), 10.0, @@ -4260,7 +4275,7 @@ impl Game<'_> { let (sx, sy) = self.slot_position(i); if i == 504 && self.offhand.is_none() { batch.sprite( - &self.atlas, + &self.gui.atlas, "gui/sprites/container/slot/shield", ox + sx, oy + sy, @@ -4269,7 +4284,7 @@ impl Game<'_> { if (500..504).contains(&i) && self.armor[i - 500].is_none() { let icon = ["helmet", "chestplate", "leggings", "boots"][i - 500]; batch.sprite( - &self.atlas, + &self.gui.atlas, &format!("gui/sprites/container/slot/{icon}"), ox + sx, oy + sy, @@ -4285,7 +4300,7 @@ impl Game<'_> { } let (ox, oy) = self.inventory_origin(batch); { - let atlas = &self.atlas; + let atlas = &self.gui.atlas; batch.fill( atlas, 0.0, @@ -4409,7 +4424,7 @@ impl Game<'_> { if let Some(slot) = self.slot_at(batch, self.cursor.0, self.cursor.1) { let (sx, sy) = self.slot_position(slot); batch.fill( - &self.atlas, + &self.gui.atlas, ox + sx, oy + sy, 16.0, @@ -5435,7 +5450,7 @@ impl Game<'_> { m.height(), camera, fire_yaw, - &self.atlas.sprites, + &self.gui.atlas.sprites, self.world.light( at.x.floor() as i32, at.y.floor() as i32, @@ -5457,7 +5472,7 @@ impl Game<'_> { p.dimensions.height, camera, fire_yaw, - &self.atlas.sprites, + &self.gui.atlas.sprites, self.world.light( feet.x.floor() as i32, feet.y.floor() as i32, @@ -5480,7 +5495,7 @@ impl Game<'_> { 0.25, camera, fire_yaw, - &self.atlas.sprites, + &self.gui.atlas.sprites, self.world.light( at.x.floor() as i32, at.y.floor() as i32, @@ -5499,7 +5514,7 @@ impl Game<'_> { 1.975 * scale, camera, fire_yaw, - &self.atlas.sprites, + &self.gui.atlas.sprites, self.world.light( stand.position.x.floor() as i32, stand.position.y.floor() as i32, @@ -5524,7 +5539,7 @@ impl Game<'_> { self.name_tag_geometry(camera, alpha, &mut out, &mut see_through); self.see_through_vertices = see_through; // Entity shadows (EntityRenderer.extractShadow). - if let Some(sprite) = self.atlas.sprites.get("misc/shadow").copied() { + if let Some(sprite) = self.gui.atlas.sprites.get("misc/shadow").copied() { let ambient = if self.dim == Dim::Nether { 0.1 } else { 0.0 }; let darken = self.sky_darken(); let a = alpha; @@ -5579,7 +5594,7 @@ impl Game<'_> { game_time: self.world.game_time, max_y: self.dim.max_y(), world: &self.world, - sprites: &self.atlas.sprites, + sprites: &self.gui.atlas.sprites, nether: self.dim == Dim::Nether, lid: &lid, sign: &|p| match self.world.block_entities.get(&(p[0], p[1], p[2])) { @@ -5587,7 +5602,7 @@ impl Game<'_> { _ => None, }, banner: &|p| self.banner_layers_at(p), - glyph: &|c| self.atlas.glyph_cell(c), + glyph: &|c| self.gui.atlas.glyph_cell(c), }; // Block entities outside the view frustum are skipped (with a // block of margin for models larger than their block). @@ -5631,7 +5646,7 @@ impl Game<'_> { } if let Some(mining) = &self.mining && mining.progress > 0.0 - && self.atlas.sprites.contains_key(&format!( + && self.gui.atlas.sprites.contains_key(&format!( "block/destroy_stage_{}", ((mining.progress * 10.0) as u32).min(9) )) @@ -5646,6 +5661,7 @@ impl Game<'_> { } // Experience orbs (ExperienceOrbRenderer): pulsing billboards from a 4x4 icon sheet. if let Some(r) = self + .gui .atlas .sprites .get("entity/experience/experience_orb") @@ -5758,7 +5774,7 @@ impl Game<'_> { &|b| world.light(b[0], b[1], b[2]), &mut out, ); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; // Breaking progress overlay (destroy_stage_0..9). if let Some(m) = &self.mining && m.progress > 0.0 @@ -6143,7 +6159,7 @@ impl Game<'_> { /// SkyRenderer.renderSunMoonAndStars: bodies on a frame rotated Y -90 then X by angle. fn celestial_geometry(&self, sky: &horizon_client::environment::Sky) -> Vec { let mut out = Vec::new(); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let frame = |angle: f32| { glam::Mat4::from_rotation_y((-90.0f32).to_radians()) * glam::Mat4::from_rotation_x(angle.to_radians()) @@ -7643,7 +7659,13 @@ impl Game<'_> { let Some(arm) = self.res.player_arm.clone() else { continue; }; - let Some(r) = self.atlas.sprites.get("entity/player/wide/steve").copied() else { + let Some(r) = self + .gui + .atlas + .sprites + .get("entity/player/wide/steve") + .copied() + else { continue; }; // renderPlayerArm (right arm) @@ -7767,22 +7789,22 @@ impl Game<'_> { } out } - /// The renderer for the window, with the current block sprites, shared + /// The renderer for the window, with the current block sprites, GUI /// atlas and world border texture. fn new_renderer(&self, window: Arc) -> Result { - self.renderer_for(window, &self.pack, &self.atlas) + self.renderer_for(window, &self.pack, &self.gui) } fn renderer_for( &self, window: Arc, pack: &PackResources, - atlas: &HudAtlas, + gui: &UiResources, ) -> Result { build_renderer( window, self.options.offscreen, pack, - atlas, + gui, self.renderer.as_ref(), ) } @@ -7899,7 +7921,7 @@ impl Game<'_> { if intensity <= 0.0 { return; } - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let (Some(rain_tex), Some(snow_tex)) = ( atlas.sprites.get("environment/rain").copied(), atlas.sprites.get("environment/snow").copied(), @@ -8095,7 +8117,7 @@ impl Game<'_> { } /// Vanilla tooltip: dark box with a purple gradient border. fn tooltip(&self, batch: &mut HudBatch, text: &str, x: f32, y: f32) { - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let w = HudBatch::text_width(atlas, text); let (x, y) = (x + 12.0, y - 12.0); batch.fill(atlas, x - 3.0, y - 4.0, w + 6.0, 16.0, rgba(16, 0, 16, 240)); @@ -8117,7 +8139,7 @@ impl Game<'_> { ) }; batch.fill( - &self.atlas, + &self.gui.atlas, 0.0, 0.0, batch.width, @@ -8128,7 +8150,7 @@ impl Game<'_> { for (i, t) in tabs.iter().enumerate() { if i != selected { let (tx, ty) = Creative::tab_position(t); - batch.sprite(&self.atlas, &tab_sprite(t, false), ox + tx, oy + ty); + batch.sprite(&self.gui.atlas, &tab_sprite(t, false), ox + tx, oy + ty); } } let background = if tab.search { @@ -8138,13 +8160,13 @@ impl Game<'_> { } else { "gui/container/creative_inventory/tab_items" }; - if let Some(mut r) = self.atlas.sprites.get(background).copied() { + if let Some(mut r) = self.gui.atlas.sprites.get(background).copied() { r.u1 = r.u0 + (r.u1 - r.u0) * Creative::WIDTH / r.w as f32; r.v1 = r.v0 + (r.v1 - r.v0) * Creative::HEIGHT / r.h as f32; batch.rect_uv(ox, oy, Creative::WIDTH, Creative::HEIGHT, r, u32::MAX); } let (tx, ty) = Creative::tab_position(&tab); - batch.sprite(&self.atlas, &tab_sprite(&tab, true), ox + tx, oy + ty); + batch.sprite(&self.gui.atlas, &tab_sprite(&tab, true), ox + tx, oy + ty); for t in &tabs { let (tx, ty) = Creative::tab_position(t); let stack = ItemStack { @@ -8160,7 +8182,7 @@ impl Game<'_> { oy + ty + if t.top { 9.0 } else { 7.0 }, ); } - let atlas = &self.atlas; + let atlas = &self.gui.atlas; if !tab.inventory { batch.text( atlas, @@ -8202,7 +8224,7 @@ impl Game<'_> { if Self::creative_trash_hovered(batch, self.cursor) { let (x, y) = Creative::TRASH_POSITION; batch.fill( - &self.atlas, + &self.gui.atlas, ox + x, oy + y, 16.0, @@ -8213,7 +8235,7 @@ impl Game<'_> { if let Some(slot) = self.slot_at(batch, self.cursor.0, self.cursor.1) { let (x, y) = self.slot_position(slot); batch.fill( - &self.atlas, + &self.gui.atlas, ox + x, oy + y, 16.0, @@ -8236,7 +8258,7 @@ impl Game<'_> { && self.cursor.1 >= y && self.cursor.1 < y + 16.0 { - batch.fill(&self.atlas, x, y, 16.0, 16.0, rgba(255, 255, 255, 128)); + batch.fill(&self.gui.atlas, x, y, 16.0, 16.0, rgba(255, 255, 255, 128)); hovered = Some(stack.clone()); } } @@ -8262,7 +8284,7 @@ impl Game<'_> { "gui/sprites/container/creative_inventory/scroller_disabled" }; batch.sprite( - &self.atlas, + &self.gui.atlas, scroller, ox + Creative::SCROLL_X, oy + Creative::SCROLL_Y + self.creative_screen.scroller_offset(), @@ -8725,7 +8747,7 @@ impl Game<'_> { clouds: ((!title || live) && self.dim == Dim::Overworld && horizon_client::clouds::visible(&self.settings.clouds, sky.cloud_color[3])) - .then(|| self.atlas.sprites.get("horizon/white")) + .then(|| self.gui.atlas.sprites.get("horizon/white")) .flatten() .map(|white| horizon_client::clouds::Input { texture: &self.pack.clouds, @@ -8755,14 +8777,15 @@ impl Game<'_> { .mining .as_ref() .and_then(|m| { - self.atlas.sprites.get(&format!( + self.gui.atlas.sprites.get(&format!( "block/destroy_stage_{}", ((m.progress * 10.0) as u32).min(9) )) }) .map_or([0.0; 4], |r| [r.u0, r.v0, r.u1 - r.u0, r.v1 - r.v0]), end_portal_sprites: ["environment/end_sky", "entity/end_portal/end_portal"].map(|n| { - self.atlas + self.gui + .atlas .sprites .get(n) .map_or([0.0; 4], |r| [r.u0, r.v0, r.u1 - r.u0, r.v1 - r.v0]) @@ -8822,7 +8845,7 @@ impl Game<'_> { reason: horizon_client::level_loading::Reason, ) { use horizon_client::level_loading::{self, Reason, STATUS_RADIUS}; - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let (w, h) = (batch.width, batch.height); match reason { // The panorama and its blur are drawn by the renderer. @@ -9333,7 +9356,7 @@ impl ApplicationHandler for Game<'_> { && !horizon_client::ui_theme::horizon() { title.drag(self.cursor, (b.width, b.height)); - title.drag_field(&self.atlas, self.cursor.0); + title.drag_field(&self.gui.atlas, self.cursor.0); } if self.dragging && self.screen == Screen::Options { let _ = b; @@ -9438,7 +9461,7 @@ impl ApplicationHandler for Game<'_> { .map(|r| [r.config.width, r.config.height]) .unwrap_or([1, 1]); let mut b = HudBatch::new(size); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let shift = self.has_shift_down(); let (action, sound) = self.title.as_mut().map_or((Action::None, false), |t| { if horizon_client::ui_theme::horizon() { @@ -9982,7 +10005,7 @@ impl<'a> Game<'a> { fn new( res: &'a Arc, pack: PackResources, - atlas: HudAtlas, + gui: UiResources, options: Options, settings: Settings, audio: Audio, @@ -10016,13 +10039,13 @@ impl<'a> Game<'a> { let inventory = vec![None; 36]; let now = Instant::now(); let look = options.look; - let particles = horizon_client::particles::ParticleEngine::new(&root, &atlas.sprites); + let particles = horizon_client::particles::ParticleEngine::new(&root, &gui.atlas.sprites); Ok(Game { res: res.clone(), collision: &res.collision, motion: &res.motion, pack, - atlas, + gui, fog: Default::default(), screen_fx: Default::default(), world, @@ -10303,7 +10326,7 @@ struct Loaded { pack_error: Option, resources: Resources, pack: PackResources, - atlas: HudAtlas, + gui: UiResources, } /// The loader's checkpoints, in order; the loading screen reports them. @@ -10407,7 +10430,7 @@ fn load_resources( let pack = PackResources::load(&root, assets.clone(), &facts, biomes.clone(), light)?; log::info!("load pack tables: {:.2}s", started.elapsed().as_secs_f32()); on_stage(4); - let atlas = HudAtlas::build(&root)?; + let gui = UiResources::load(&root)?; horizon_client::ui::load_metadata(&root); horizon_client::lang::set(horizon_client::lang::Language::load( &[&root], @@ -10484,7 +10507,7 @@ fn load_resources( pack_error, resources, pack, - atlas, + gui, }) } @@ -10494,10 +10517,11 @@ fn build_renderer( window: Arc, offscreen: bool, pack: &PackResources, - atlas: &HudAtlas, + gui: &UiResources, previous: Option<&Renderer>, ) -> Result { let assets = &pack.assets; + let atlas = &gui.atlas; let mut renderer = pollster::block_on(Renderer::new( window, offscreen, @@ -10509,7 +10533,7 @@ fn build_renderer( &assets.animations, (&atlas.pixels, atlas.width, atlas.height), (&pack.forcefield.2, pack.forcefield.0), - &pack.panorama, + &gui.panorama, previous, ))?; renderer.hud.fire_animations = atlas @@ -10619,7 +10643,7 @@ fn loading_frame(hud: &HudBatch) -> Frame<'_> { fn start_game<'a>( res: &'a Arc, pack: PackResources, - atlas: HudAtlas, + gui: UiResources, options: Options, pack_error: Option, audio: Audio, @@ -10638,7 +10662,7 @@ fn start_game<'a>( if let Some(d) = options.distance_override { settings.render_distance = d; } - let mut game = Game::new(res, pack, atlas, options, settings, audio)?; + let mut game = Game::new(res, pack, gui, options, settings, audio)?; game.ui.vanilla_root = vanilla_root; if let Some(error) = pack_error { game.open_options_at(true, horizon_client::options_ui::Page::Packs); @@ -10911,7 +10935,7 @@ impl Loading { window.clone(), options.offscreen, &loaded.pack, - &loaded.atlas, + &loaded.gui, self.renderer.as_ref(), )?; let pack_error = loaded.pack_error.or_else(|| self.pack_error.take()); @@ -10921,7 +10945,7 @@ impl Loading { let Some(mut game) = start_game( res, loaded.pack, - loaded.atlas, + loaded.gui, options, pack_error, audio, @@ -11122,7 +11146,7 @@ pub fn run() -> Result<()> { let game = start_game( &resources, loaded.pack, - loaded.atlas, + loaded.gui, options, loaded.pack_error.or(pack_error), audio, diff --git a/crates/horizon-client/src/game/advancements.rs b/crates/horizon-client/src/game/advancements.rs index 882b5cc93..992969907 100644 --- a/crates/horizon-client/src/game/advancements.rs +++ b/crates/horizon-client/src/game/advancements.rs @@ -790,11 +790,11 @@ impl Game<'_> { if let Some((station, item)) = recipe { // RecipeToast: black description under a purple title, the // station at 0.6 scale in the corner over the cycling result. - let atlas = &self.atlas; + let atlas = &self.gui.atlas; batch.sprite(atlas, "gui/sprites/toast/recipe", x, 0.0); let title = self.translate("recipe.toast.title", "New Recipe(s) Unlocked!"); let description = self.translate("recipe.toast.description", "Check your recipe book"); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; batch.text(atlas, &title, x + 30.0, 7.0, 0xFF50_0050, false); batch.text(atlas, &description, x + 30.0, 18.0, 0xFF00_0000, false); let start = batch.vertices.len(); @@ -803,7 +803,7 @@ impl Game<'_> { self.draw_item_model(batch, &item, x + 8.0, 8.0); return; } - let atlas = &self.atlas; + let atlas = &self.gui.atlas; batch.sprite(atlas, "gui/sprites/toast/advancement", x, 0.0); let (key, color) = match frame { Frame::Task => ("advancements.toast.task", 0xFF00_FFFF), diff --git a/crates/horizon-client/src/game/advancements_screen.rs b/crates/horizon-client/src/game/advancements_screen.rs index 759588887..211bab362 100644 --- a/crates/horizon-client/src/game/advancements_screen.rs +++ b/crates/horizon-client/src/game/advancements_screen.rs @@ -269,7 +269,7 @@ impl Game<'_> { } /// `AdvancementWidget`'s title lines, description lines and width. fn adv_widget_text(&self, i: usize) -> (Vec, Vec, f32) { - let font = &self.atlas.font; + let font = &self.gui.atlas.font; let a = &self.adv.tree.list[i]; let Some(d) = &a.display else { return (Vec::new(), Vec::new(), 0.0); @@ -332,7 +332,7 @@ impl Game<'_> { let (sx, sy) = self.adv_ui.scroll.unwrap_or_default(); let (sx, sy) = (sx.floor() as i32, sy.floor() as i32); self.adv_tick_hover(&view, sx, sy, left, top); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; ui::menu_background(batch, atlas, 0.0, 0.0, w, h, true); let title = Text::translate("gui.advancements", &[]); let tw = atlas.font.width_text(&title); @@ -444,7 +444,7 @@ impl Game<'_> { } let (x, y) = pos(i); let (x, y) = ((ox + x) as f32, (oy + y) as f32); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; batch.sprite_scaled( atlas, frame_sprite(d.frame, done), @@ -461,7 +461,7 @@ impl Game<'_> { } } // The window, tabs and title. - let atlas = &self.atlas; + let atlas = &self.gui.atlas; batch.sprite_region( atlas, "gui/advancements/window", @@ -475,7 +475,7 @@ impl Game<'_> { let (x, y) = tab_pos(ty, i); let sprite = tab_sprite(ty, i, ty.3, Some(t) == tab); batch.sprite_scaled( - &self.atlas, + &self.gui.atlas, &sprite, left + x, top + y, @@ -494,7 +494,7 @@ impl Game<'_> { } } } - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let title = tab.and_then(|t| tree.list[t].display.as_ref()).map_or_else( || Text::translate("gui.advancements", &[]), |d| text_of(&d.title), @@ -509,7 +509,7 @@ impl Game<'_> { } } // Done. - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let (bx, by) = ((w / 2.0 - 100.0).floor(), h - FOOTER + 6.0); let hover = ui::hovered(self.cursor, bx, by, 200.0, 20.0); ui::button( @@ -532,7 +532,7 @@ impl Game<'_> { let (cx, cy) = self.cursor; if cx > x && cx < x + ty.1 && cy > y && cy < y + ty.2 { if let Some(d) = &tree.list[t].display { - ui::tooltip(batch, &self.atlas, &[text_of(&d.title)], self.cursor); + ui::tooltip(batch, &self.gui.atlas, &[text_of(&d.title)], self.cursor); } break; } @@ -616,7 +616,7 @@ impl Game<'_> { ], ) }); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let progress_w = progress.as_ref().map_or(0.0, |t| atlas.font.width_text(t)) as i32; let top_side = title_bottom + desc_h >= INSIDE_H; let amount = if a.criteria.is_empty() || total == 0 { diff --git a/crates/horizon-client/src/game/armor_stands.rs b/crates/horizon-client/src/game/armor_stands.rs index 80e42169d..0a00e433c 100644 --- a/crates/horizon-client/src/game/armor_stands.rs +++ b/crates/horizon-client/src/game/armor_stands.rs @@ -124,7 +124,7 @@ impl Game<'_> { continue; }; let (Some(r), Some(part)) = ( - self.atlas.sprites.get(texture.as_str()), + self.gui.atlas.sprites.get(texture.as_str()), assets.player.get(layer), ) else { continue; @@ -403,7 +403,7 @@ impl Game<'_> { out: &mut Vec, ) { let assets = &self.armor_stand_assets; - let sprites = &self.atlas.sprites; + let sprites = &self.gui.atlas.sprites; let uv_of = |name: &str| sprites.get(name).map(|r| [r.u0, r.v0, r.u1, r.v1]); let Some(wood) = uv_of("entity/armorstand/armorstand") else { return; @@ -673,7 +673,7 @@ impl Game<'_> { &serde_json::Value::Null, false, pose, - &self.atlas.sprites, + &self.gui.atlas.sprites, &self.item_host(), &mut sink, ); diff --git a/crates/horizon-client/src/game/beacon.rs b/crates/horizon-client/src/game/beacon.rs index 15a7de79d..322edea3b 100644 --- a/crates/horizon-client/src/game/beacon.rs +++ b/crates/horizon-client/src/game/beacon.rs @@ -385,7 +385,7 @@ impl Game<'_> { let levels = self.beacon_levels(); let sel = self.station.as_ref().map_or([None; 2], |s| s.beacon); let paid = self.station.as_ref().is_some_and(|s| s.inputs[0].is_some()); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; batch.fill( atlas, 0.0, @@ -406,7 +406,7 @@ impl Game<'_> { ("block.minecraft.beacon.secondary", "Secondary Power", 169.0), ] { let text = self.translate(key, fallback); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let w = HudBatch::text_width(atlas, &text); batch.text( atlas, @@ -421,7 +421,7 @@ impl Game<'_> { let x = [20.0, 41.0, 63.0, 86.0, 108.0][i]; self.draw_item(batch, &ItemStack::new(item, 1), bx + x, by + 109.0); } - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let mut tooltip = None; let button = |batch: &mut HudBatch, x: f32, y: f32, active: bool, selected: bool, icon: &str| { @@ -503,7 +503,7 @@ impl Game<'_> { if let Some(slot) = self.slot_at(batch, self.cursor.0, self.cursor.1) { let (sx, sy) = self.slot_position(slot); batch.fill( - &self.atlas, + &self.gui.atlas, ox + sx, oy + sy, 16.0, @@ -524,7 +524,13 @@ impl Game<'_> { } /// `BeaconRenderer`: each section's rotating solid beam and its glow. pub(super) fn beacon_geometry(&self, camera: glam::DVec3, alpha: f64, out: &mut Vec) { - let Some(s) = self.atlas.sprites.get("entity/beacon/beacon_beam").copied() else { + let Some(s) = self + .gui + .atlas + .sprites + .get("entity/beacon/beacon_beam") + .copied() + else { return; }; let time = (self.world.game_time.rem_euclid(40)) as f32 + alpha as f32; diff --git a/crates/horizon-client/src/game/boats.rs b/crates/horizon-client/src/game/boats.rs index a5a609cac..bb351d4bf 100644 --- a/crates/horizon-client/src/game/boats.rs +++ b/crates/horizon-client/src/game/boats.rs @@ -712,6 +712,7 @@ impl Game<'_> { }; let folder = if b.chest { "chest_boat" } else { "boat" }; let Some(uv) = self + .gui .atlas .sprites .get(&format!("entity/{folder}/{}", b.wood)) diff --git a/crates/horizon-client/src/game/books.rs b/crates/horizon-client/src/game/books.rs index 5603e8369..b07a521ec 100644 --- a/crates/horizon-client/src/game/books.rs +++ b/crates/horizon-client/src/game/books.rs @@ -45,7 +45,7 @@ pub(super) enum BookScreen { } impl Game<'_> { fn book_lines(&self, page: &str) -> Vec { - self.atlas.font.split(&Text::literal(page), 114.0) + self.gui.atlas.font.split(&Text::literal(page), 114.0) } /// `WritableBookItem.use` / `WrittenBookItem.use`. pub(super) fn use_book(&mut self, stack: &ItemStack) -> bool { @@ -242,7 +242,7 @@ impl Game<'_> { /// the page (`MultilineTextField.insertText`: line breaks kept, cut to /// the 1024 characters left, rejected when it overflows the 14 lines). fn book_shortcut(&mut self, shortcut: horizon_client::clipboard::EditShortcut) { - let font = &self.atlas.font; + let font = &self.gui.atlas.font; match self.book.as_mut() { Some(BookScreen::Edit { signing: true, @@ -549,7 +549,7 @@ impl Game<'_> { } pub(super) fn draw_book(&self, batch: &mut HudBatch) { let Some(book) = &self.book else { return }; - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let (w, h) = (batch.width, batch.height); let (mx, my) = self.cursor; let hover = diff --git a/crates/horizon-client/src/game/cartography.rs b/crates/horizon-client/src/game/cartography.rs index 86d5d5395..4a5738f6e 100644 --- a/crates/horizon-client/src/game/cartography.rs +++ b/crates/horizon-client/src/game/cartography.rs @@ -89,17 +89,17 @@ impl Game<'_> { if is_locked { locked = true; if scaling || locking { - batch.sprite(&self.atlas, error, ox + 35.0, oy + 31.0); + batch.sprite(&self.gui.atlas, error, ox + 35.0, oy + 31.0); } } if scaling && scale >= 4 { locked = true; - batch.sprite(&self.atlas, error, ox + 35.0, oy + 31.0); + batch.sprite(&self.gui.atlas, error, ox + 35.0, oy + 31.0); } } let sprite = |batch: &mut HudBatch, game: &Self, name: &str, x: f32, y: f32| { batch.sprite( - &game.atlas, + &game.gui.atlas, &format!("gui/sprites/container/cartography_table/{name}"), ox + x, oy + y, diff --git a/crates/horizon-client/src/game/chat.rs b/crates/horizon-client/src/game/chat.rs index bcf6426e1..bd80c06b5 100644 --- a/crates/horizon-client/src/game/chat.rs +++ b/crates/horizon-client/src/game/chat.rs @@ -389,7 +389,7 @@ impl Game<'_> { .as_ref() .map_or([1280, 720], |r| [r.config.width, r.config.height]); let b = HudBatch::new(size); - let m = Measure(&self.atlas.font); + let m = Measure(&self.gui.atlas.font); let c = Commands { dispatcher: self.mods.dispatcher(), registries: &self.ui.registries, @@ -434,7 +434,7 @@ impl Game<'_> { let focused = self.screen == Screen::Chat; let heard = self.mods.mods.is_running().then(|| text.plain()); self.ui.chat.add( - &self.atlas, + &self.gui.atlas, text, Some(SYSTEM_INDICATOR), self.ticks, @@ -447,7 +447,7 @@ impl Game<'_> { /// Keys while the chat screen is open. pub(super) fn chat_key(&mut self, event: &KeyEvent) { if let Some(shortcut) = self.edit_shortcut(event) { - let m = Measure(&self.atlas.font); + let m = Measure(&self.gui.atlas.font); let c = Commands { dispatcher: self.mods.dispatcher(), registries: &self.ui.registries, @@ -493,7 +493,7 @@ impl Game<'_> { let Some(mut screen) = self.ui.chat_screen.take() else { return; }; - let m = Measure(&self.atlas.font); + let m = Measure(&self.gui.atlas.font); let c = Commands { dispatcher: self.mods.dispatcher(), registries: &self.ui.registries, @@ -519,7 +519,7 @@ impl Game<'_> { } /// Text typed into the chat box (control socket `chat`). pub(super) fn chat_type(&mut self, text: &str) { - let m = Measure(&self.atlas.font); + let m = Measure(&self.gui.atlas.font); let c = Commands { dispatcher: self.mods.dispatcher(), registries: &self.ui.registries, @@ -542,7 +542,7 @@ impl Game<'_> { let heard = self.mods.mods.is_running().then(|| line.plain()); self.ui .chat - .add(&self.atlas, line, None, self.ticks, focused); + .add(&self.gui.atlas, line, None, self.ticks, focused); if let Some(line) = heard { self.mods_chat(&line); } @@ -570,7 +570,7 @@ impl Game<'_> { let height = self.renderer.as_ref().map_or(720.0, |r| { HudBatch::new([r.config.width, r.config.height]).height }); - let m = Measure(&self.atlas.font); + let m = Measure(&self.gui.atlas.font); let c = Commands { dispatcher: self.mods.dispatcher(), registries: &self.ui.registries, @@ -583,7 +583,7 @@ impl Game<'_> { return; } match self.ui.chat.click_at( - &self.atlas.font, + &self.gui.atlas.font, height as i32, cursor.0 as f64, cursor.1 as f64, @@ -609,13 +609,15 @@ impl Game<'_> { if self.ui.hide_gui && !focused { return; } - self.ui.chat.draw(batch, &self.atlas, self.ticks, focused); + self.ui + .chat + .draw(batch, &self.gui.atlas, self.ticks, focused); } pub(super) fn draw_chat_screen(&mut self, batch: &mut HudBatch) { let Some(mut screen) = self.ui.chat_screen.take() else { return; }; - let m = Measure(&self.atlas.font); + let m = Measure(&self.gui.atlas.font); let c = Commands { dispatcher: self.mods.dispatcher(), registries: &self.ui.registries, @@ -633,7 +635,7 @@ impl Game<'_> { .chat_opened .map_or(0, |t| t.elapsed().as_millis() as u64); let draws = screen.draw(&m, mouse, blink, background); - horizon_client::screen_draw::paint(batch, &self.atlas, &draws); + horizon_client::screen_draw::paint(batch, &self.gui.atlas, &draws); self.ui.chat_screen = Some(screen); } /// Advance the overworld clock (ServerClockManager.tick) when @@ -825,11 +827,11 @@ impl Game<'_> { let focused = self.screen == Screen::Chat; self.ui .chat - .add(&self.atlas, message, None, self.ticks, focused); + .add(&self.gui.atlas, message, None, self.ticks, focused); } #[allow(dead_code)] fn chat_debug_fill(&self, batch: &mut HudBatch) { - batch.fill(&self.atlas, 0.0, 0.0, 1.0, 1.0, rgba(0, 0, 0, 0)); + batch.fill(&self.gui.atlas, 0.0, 0.0, 1.0, 1.0, rgba(0, 0, 0, 0)); } } /// `yyyy-MM-dd_HH.mm.ss[_n].png` (Util.getFilenameFormattedDateTime, local time diff --git a/crates/horizon-client/src/game/command_blocks.rs b/crates/horizon-client/src/game/command_blocks.rs index 5a5fa11c8..260826626 100644 --- a/crates/horizon-client/src/game/command_blocks.rs +++ b/crates/horizon-client/src/game/command_blocks.rs @@ -458,7 +458,7 @@ impl Game<'_> { self.close_command_block(); return; } - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let (w, h) = (batch.width, batch.height); let mid = (w / 2.0).floor(); ui::menu_background(batch, atlas, 0.0, 0.0, w, h, true); diff --git a/crates/horizon-client/src/game/commands.rs b/crates/horizon-client/src/game/commands.rs index 962075ee7..deee0e967 100644 --- a/crates/horizon-client/src/game/commands.rs +++ b/crates/horizon-client/src/game/commands.rs @@ -2539,7 +2539,7 @@ impl Game<'_> { let focused = self.screen == Screen::Chat; self.ui .chat - .add(&self.atlas, line, None, self.ticks, focused); + .add(&self.gui.atlas, line, None, self.ticks, focused); Ok(1) } /// MessageArgument: `@p`-style selectors in a message become names. diff --git a/crates/horizon-client/src/game/control.rs b/crates/horizon-client/src/game/control.rs index cf7510065..56d738542 100644 --- a/crates/horizon-client/src/game/control.rs +++ b/crates/horizon-client/src/game/control.rs @@ -427,7 +427,7 @@ impl Game<'_> { match self.screen { Screen::Chat => self.chat_type(text), Screen::CommandBlock => self.command_block_type(text), - Screen::Options => self.ui.options.type_text(&self.atlas, text), + Screen::Options => self.ui.options.type_text(&self.gui.atlas, text), // The port, or the game rules' search and number boxes. Screen::WorldOptions if text == "\\b" => self.world_options_text(None), Screen::WorldOptions => self.world_options_text(Some(text)), diff --git a/crates/horizon-client/src/game/creatures.rs b/crates/horizon-client/src/game/creatures.rs index f6526de72..bcb86343a 100644 --- a/crates/horizon-client/src/game/creatures.rs +++ b/crates/horizon-client/src/game/creatures.rs @@ -2771,7 +2771,7 @@ impl Game<'_> { } /// Mob models and projectiles for the entity pass. pub(super) fn mob_geometry(&self, camera: glam::DVec3, alpha: f64, out: &mut Vec) { - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let lookup = |name: &str| atlas.sprites.get(name).map(|r| [r.u0, r.v0, r.u1, r.v1]); let scale = f64::from(self.settings.entity_distance); for mob in &self.mobs { diff --git a/crates/horizon-client/src/game/debug_keys.rs b/crates/horizon-client/src/game/debug_keys.rs index 36761a85e..9f7d3585d 100644 --- a/crates/horizon-client/src/game/debug_keys.rs +++ b/crates/horizon-client/src/game/debug_keys.rs @@ -438,7 +438,7 @@ impl Game<'_> { } } let (left, right) = d.columns(&self.debug_chart_lines()); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let mut draws = debug_overlay::draw(&atlas.font, [&left, &right], scale, width); let charts = self.debug_charts.draw( &atlas.font, diff --git a/crates/horizon-client/src/game/dragon.rs b/crates/horizon-client/src/game/dragon.rs index ff91df583..e8e1fe57e 100644 --- a/crates/horizon-client/src/game/dragon.rs +++ b/crates/horizon-client/src/game/dragon.rs @@ -1866,9 +1866,9 @@ impl Game<'_> { batch.width as i32, batch.height as i32, &bars, - &self.atlas.font, + &self.gui.atlas.font, ); - hud_layout::paint(batch, &self.atlas, &draws); + hud_layout::paint(batch, &self.gui.atlas, &draws); } /// The dragon fight's boss bar shows (`EnderDragonFight.dragonEvent`, /// with `setCreateWorldFog`). @@ -1906,7 +1906,13 @@ impl Game<'_> { return; }; let a = alpha as f32; - let sprite = |n: &str| self.atlas.sprites.get(n).map(|r| [r.u0, r.v0, r.u1, r.v1]); + let sprite = |n: &str| { + self.gui + .atlas + .sprites + .get(n) + .map(|r| [r.u0, r.v0, r.u1, r.v1]) + }; let (Some(skin), Some(eyes)) = ( sprite("entity/enderdragon/dragon"), sprite("entity/enderdragon/dragon_eyes"), @@ -2072,7 +2078,7 @@ impl Game<'_> { } /// `submitRays`: the death rays from a fixed seed, fading in white to magenta. fn dragon_rays(&self, base: glam::Mat4, t: f32, out: &mut Vec) { - let white = self.atlas.font.white(); + let white = self.gui.atlas.font.white(); let uv = [white.u0, white.v0]; let over = if t > 0.8 { ((t - 0.8) / 0.2).min(1.0) @@ -2128,6 +2134,7 @@ impl Game<'_> { out: &mut Vec, ) { let Some(s) = self + .gui .atlas .sprites .get("entity/end_crystal/end_crystal_beam") @@ -2189,6 +2196,7 @@ impl Game<'_> { out: &mut Vec, ) { let Some(s) = self + .gui .atlas .sprites .get("entity/enderdragon/dragon_fireball") diff --git a/crates/horizon-client/src/game/end.rs b/crates/horizon-client/src/game/end.rs index a80c51796..907be60f9 100644 --- a/crates/horizon-client/src/game/end.rs +++ b/crates/horizon-client/src/game/end.rs @@ -142,7 +142,7 @@ impl Game<'_> { /// 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.atlas.sprites.get("environment/end_sky").copied() else { + let Some(r) = self.gui.atlas.sprites.get("environment/end_sky").copied() else { return out; }; use std::f32::consts::FRAC_PI_2; @@ -184,6 +184,7 @@ impl Game<'_> { let intensity = self.end.flash.intensity(self.clock.fraction() as f32); if intensity > 1e-5 && let Some(r) = self + .gui .atlas .sprites .get("environment/celestial/end_flash") @@ -920,7 +921,8 @@ impl Game<'_> { fn end_crystal_geometry(&self, camera: glam::DVec3, out: &mut Vec) { let (Some(model), Some(r)) = ( self.crystal_model.as_ref(), - self.atlas + self.gui + .atlas .sprites .get("entity/end_crystal/end_crystal") .copied(), @@ -1073,7 +1075,7 @@ impl Game<'_> { /// ThrownItemRenderer: the ender eye item facing the camera. fn eye_geometry(&self, camera: glam::DVec3, out: &mut Vec) { - let Some(r) = self.atlas.sprites.get("item/ender_eye").copied() else { + let Some(r) = self.gui.atlas.sprites.get("item/ender_eye").copied() else { return; }; let alpha = self.clock.fraction(); diff --git a/crates/horizon-client/src/game/extras.rs b/crates/horizon-client/src/game/extras.rs index 712796a81..55454f817 100644 --- a/crates/horizon-client/src/game/extras.rs +++ b/crates/horizon-client/src/game/extras.rs @@ -197,10 +197,10 @@ impl Game<'_> { if !self.extras.minimap.compose(view) { return; } - let Some(rect) = self.atlas.sprites.get(MINIMAP_SPRITE).copied() else { + let Some(rect) = self.gui.atlas.sprites.get(MINIMAP_SPRITE).copied() else { return; }; - let (w, h) = (self.atlas.width as f32, self.atlas.height as f32); + let (w, h) = (self.gui.atlas.width as f32, self.gui.atlas.height as f32); self.map_patches.push(horizon_client::font::Patch { x: (rect.u0 * w).round() as u32, y: (rect.v0 * h).round() as u32, @@ -246,7 +246,7 @@ impl Game<'_> { let (map_corner, map_size) = (e.minimap_corner, f32::from(e.minimap_size)); let visible = |corner| !(self.debug && corner == Corner::TopLeft); let mut corners = Corners::new(batch.width, batch.height, self.effect_rows_height()); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; if let Some(view) = self.minimap_view() && visible(map_corner) && !self.extras.minimap.image.is_empty() @@ -290,7 +290,7 @@ impl Game<'_> { use_: self.extras.mouse[1], cps, }; - extras_hud::draw_keystrokes(batch, &self.atlas, &mut corners, keys_corner, &k); + extras_hud::draw_keystrokes(batch, &self.gui.atlas, &mut corners, keys_corner, &k); } if mod_panels { self.draw_mod_panels(batch, &mut corners); diff --git a/crates/horizon-client/src/game/fangs.rs b/crates/horizon-client/src/game/fangs.rs index dd2b9bde6..0939f6490 100644 --- a/crates/horizon-client/src/game/fangs.rs +++ b/crates/horizon-client/src/game/fangs.rs @@ -108,6 +108,7 @@ impl Game<'_> { return; }; let Some(r) = self + .gui .atlas .sprites .get("entity/illager/evoker_fangs") diff --git a/crates/horizon-client/src/game/fishing.rs b/crates/horizon-client/src/game/fishing.rs index 8a63f2cfe..75a67ef58 100644 --- a/crates/horizon-client/src/game/fishing.rs +++ b/crates/horizon-client/src/game/fishing.rs @@ -565,6 +565,7 @@ impl Game<'_> { return; }; let Some(r) = self + .gui .atlas .sprites .get("entity/fishing/fishing_hook") diff --git a/crates/horizon-client/src/game/fov.rs b/crates/horizon-client/src/game/fov.rs index 71b18a97c..6a636152e 100644 --- a/crates/horizon-client/src/game/fov.rs +++ b/crates/horizon-client/src/game/fov.rs @@ -177,6 +177,6 @@ impl Game<'_> { } let draws = hud_overlays::spyglass(batch.width as i32, batch.height as i32, self.scope_scale); - hud_layout::paint(batch, &self.atlas, &draws); + hud_layout::paint(batch, &self.gui.atlas, &draws); } } diff --git a/crates/horizon-client/src/game/frames.rs b/crates/horizon-client/src/game/frames.rs index 3ffa0e67e..2271feeb8 100644 --- a/crates/horizon-client/src/game/frames.rs +++ b/crates/horizon-client/src/game/frames.rs @@ -301,7 +301,7 @@ impl Game<'_> { } /// ItemFrameRenderer: the frame model, then the item half size on its face. pub(super) fn frame_geometry(&mut self, camera: glam::DVec3, out: &mut Vec) { - let sprites = &self.atlas.sprites; + let sprites = &self.gui.atlas.sprites; let mut maps: Vec<(i32, glam::Mat4, u32)> = Vec::new(); let mut items: Vec<(ItemStack, u32, glam::Mat4, u8)> = Vec::new(); for f in &self.item_frames { diff --git a/crates/horizon-client/src/game/gamemode_switcher.rs b/crates/horizon-client/src/game/gamemode_switcher.rs index 5f73080f4..db057ad25 100644 --- a/crates/horizon-client/src/game/gamemode_switcher.rs +++ b/crates/horizon-client/src/game/gamemode_switcher.rs @@ -39,7 +39,7 @@ impl Game<'_> { }; switcher.hover(w, h, (self.cursor.0 as i32, self.cursor.1 as i32)); let selected = switcher.selected; - let atlas = &self.atlas; + let atlas = &self.gui.atlas; batch.sprite_region( atlas, "gui/container/gamemode_switcher", @@ -62,14 +62,14 @@ impl Game<'_> { for (index, mode) in MODES.into_iter().enumerate() { let (x, y) = slot_origin(w, h, index); batch.sprite( - &self.atlas, + &self.gui.atlas, "gui/sprites/gamemode_switcher/slot", x as f32, y as f32, ); if mode == selected { batch.sprite( - &self.atlas, + &self.gui.atlas, "gui/sprites/gamemode_switcher/selection", x as f32, y as f32, diff --git a/crates/horizon-client/src/game/integrated.rs b/crates/horizon-client/src/game/integrated.rs index 7b5f3cced..f3d758c47 100644 --- a/crates/horizon-client/src/game/integrated.rs +++ b/crates/horizon-client/src/game/integrated.rs @@ -10,7 +10,7 @@ //! player joins as a network player, and the server side of a network player //! does not do everything single player does yet. use super::{ - Game, Options, PackResources, Resources, + Game, Options, PackResources, Resources, UiResources, lan::{LanSettings, Owner}, }; use horizon_client::{ @@ -554,7 +554,14 @@ fn serve( ) -> Result<()> { // It draws nothing: only the font, which books and chat measure with. let atlas = HudAtlas::fonts(&options.resources)?; + let gui = UiResources { + atlas, + panorama: Arc::new(horizon_client::gfx::panorama::Faces { + size: 1, + pixels: [0u8; 4].repeat(6), + }), + }; let audio = Audio::silent(&options.resources); - let mut server = Game::new(res, pack, atlas, options, settings, audio)?; + let mut server = Game::new(res, pack, gui, options, settings, audio)?; server.run_integrated(launch, flags, tasks, ready) } diff --git a/crates/horizon-client/src/game/item_draw.rs b/crates/horizon-client/src/game/item_draw.rs index aae200b50..ce571f436 100644 --- a/crates/horizon-client/src/game/item_draw.rs +++ b/crates/horizon-client/src/game/item_draw.rs @@ -255,7 +255,7 @@ impl Game<'_> { item_render::gui::draw( &state, &self.pack.item_renderer, - &self.atlas.sprites, + &self.gui.atlas.sprites, &self.item_host(), batch, x, @@ -279,7 +279,7 @@ impl Game<'_> { }; state.submit( &self.pack.item_renderer, - &self.atlas.sprites, + &self.gui.atlas.sprites, &self.item_host(), pose, &mut sink, @@ -300,7 +300,7 @@ impl Game<'_> { }; state.submit( &self.pack.item_renderer, - &self.atlas.sprites, + &self.gui.atlas.sprites, &self.item_host(), pose, &mut sink, diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index 1113c31f5..79ceffa93 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -1083,7 +1083,7 @@ impl Game<'_> { let Some(host) = &self.lan else { return; }; - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let lookup = |name: &str| atlas.sprites.get(name).map(|r| [r.u0, r.v0, r.u1, r.v1]); for m in host.models.values() { let entity_start = out.len(); diff --git a/crates/horizon-client/src/game/lan_screen.rs b/crates/horizon-client/src/game/lan_screen.rs index 6be6fc7fa..335b5fbae 100644 --- a/crates/horizon-client/src/game/lan_screen.rs +++ b/crates/horizon-client/src/game/lan_screen.rs @@ -596,11 +596,11 @@ impl Game<'_> { View::Restrictions => self.draw_restrictions(batch), View::GameRules => { if let Some(rules) = o.rules.as_mut() { - rules.draw(batch, &self.atlas, self.cursor); + rules.draw(batch, &self.gui.atlas, self.cursor); } else { ui::menu_background( batch, - &self.atlas, + &self.gui.atlas, 0.0, 0.0, batch.width, @@ -614,7 +614,7 @@ impl Game<'_> { } fn draw_lock_question(&self, o: &WorldOptions, batch: &mut HudBatch) { - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let (w, h) = (batch.width, batch.height); // Screen.extractTransparentBackground. batch.fill_gradient( @@ -656,7 +656,7 @@ impl Game<'_> { } fn draw_restrictions(&self, batch: &mut HudBatch) { - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let (w, h) = (batch.width, batch.height); ui::menu_background(batch, atlas, 0.0, 0.0, w, h, true); let title = Text::translate("restrictions_screen.title", &[]); @@ -687,7 +687,7 @@ impl Game<'_> { } fn draw_options_view(&self, o: &mut WorldOptions, batch: &mut HudBatch, cursor: (f32, f32)) { - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let (w, h) = (batch.width, batch.height); o.scroll = o.scroll.clamp(0.0, o.scroll_limit(h)); // extractMenuBackground: the in-world background, the list @@ -810,7 +810,7 @@ impl Game<'_> { match o.view { View::Options => {} View::GameRules => { - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let exit = o.rules.as_mut().and_then(|rules| { if rules.clicks_button(atlas, self.cursor, (w, h)) { self.audio.play_button_click(); @@ -824,7 +824,7 @@ impl Game<'_> { return; } View::LockQuestion => { - let p = Popup::lock_question(&self.atlas.font, o.difficulty, (w, h)); + let p = Popup::lock_question(&self.gui.atlas.font, o.difficulty, (w, h)); let hit = p .buttons .iter() @@ -842,7 +842,8 @@ impl Game<'_> { return; } View::Restrictions => { - let r = Restrictions::new(&self.atlas.font, self.settings.chat_visibility, (w, h)); + let r = + Restrictions::new(&self.gui.atlas.font, self.settings.chat_visibility, (w, h)); let in_body = self.cursor.1 >= r.area.0 && self.cursor.1 < r.area.1; let action = r.action.is_some_and(|(ax, ay)| { in_body && ui::hovered(self.cursor, ax, ay, 200.0, 20.0) diff --git a/crates/horizon-client/src/game/leads.rs b/crates/horizon-client/src/game/leads.rs index 3b8fc29c4..38e0226f1 100644 --- a/crates/horizon-client/src/game/leads.rs +++ b/crates/horizon-client/src/game/leads.rs @@ -283,7 +283,7 @@ impl Game<'_> { } /// `LeashFeatureRenderer` for every lead and `LeashKnotRenderer` for the knots. pub(super) fn leash_geometry(&self, camera: glam::DVec3, alpha: f64, out: &mut Vec) { - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let white = atlas.font.white(); let uv = [ [white.u0, white.v1], diff --git a/crates/horizon-client/src/game/lightning.rs b/crates/horizon-client/src/game/lightning.rs index 834925c57..4b7851edc 100644 --- a/crates/horizon-client/src/game/lightning.rs +++ b/crates/horizon-client/src/game/lightning.rs @@ -348,7 +348,7 @@ impl Game<'_> { /// `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.atlas.font.white(); + 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; diff --git a/crates/horizon-client/src/game/loom.rs b/crates/horizon-client/src/game/loom.rs index 541e4e6a9..795ee918c 100644 --- a/crates/horizon-client/src/game/loom.rs +++ b/crates/horizon-client/src/game/loom.rs @@ -199,7 +199,7 @@ impl Game<'_> { .collect(); horizon_client::item_render::gui::draw_banner_result( &self.pack.item_renderer, - &self.atlas.sprites, + &self.gui.atlas.sprites, batch, x, y, @@ -217,7 +217,7 @@ impl Game<'_> { draws: &[ScreenDraw], background: bool, ) -> Option> { - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let mut tooltip = None; let mut sheet: Option = None; for d in draws { diff --git a/crates/horizon-client/src/game/machines.rs b/crates/horizon-client/src/game/machines.rs index 6947041f2..bc9d98f41 100644 --- a/crates/horizon-client/src/game/machines.rs +++ b/crates/horizon-client/src/game/machines.rs @@ -837,7 +837,7 @@ impl Game<'_> { let Some(screen) = self.machine_screen() else { return false; }; - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let key_is_cart = self .container .is_some_and(|k| k.1 == super::minecarts::CART_KEY_Y); diff --git a/crates/horizon-client/src/game/machines/crafter.rs b/crates/horizon-client/src/game/machines/crafter.rs index 11ca70d5d..62630758f 100644 --- a/crates/horizon-client/src/game/machines/crafter.rs +++ b/crates/horizon-client/src/game/machines/crafter.rs @@ -254,7 +254,7 @@ impl Game<'_> { // The background goes first, then the labels, then the slot decorations. let (background, rest) = draws.split_at(2.min(draws.len())); self.paint_screen(batch, ox, oy, background, true); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let grey = rgba(64, 64, 64, 255); let title = self.container_title(self.translate("container.crafter", "Crafter")); let tw = HudBatch::text_width(atlas, &title); diff --git a/crates/horizon-client/src/game/maps.rs b/crates/horizon-client/src/game/maps.rs index 2d7639260..28d74d56f 100644 --- a/crates/horizon-client/src/game/maps.rs +++ b/crates/horizon-client/src/game/maps.rs @@ -789,6 +789,7 @@ impl Game<'_> { } let slot = self.maps.slots.last()?.1; let rect = self + .gui .atlas .sprites .get(&format!("horizon/map{slot}")) @@ -797,7 +798,7 @@ impl Game<'_> { if m.texture_dirty { m.texture_dirty = false; let rgba: Vec = m.colors.iter().flat_map(|&c| packed_rgba(c)).collect(); - let (w, h) = (self.atlas.width as f32, self.atlas.height as f32); + let (w, h) = (self.gui.atlas.width as f32, self.gui.atlas.height as f32); self.map_patches.push(horizon_client::font::Patch { x: (rect.u0 * w).round() as u32, y: (rect.v0 * h).round() as u32, @@ -855,7 +856,7 @@ impl Game<'_> { .map(|m| m.decorations.clone()) .unwrap_or_default(); for (i, d) in decorations.iter().enumerate() { - let Some(s) = self.atlas.sprites.get(d.sprite).copied() else { + let Some(s) = self.gui.atlas.sprites.get(d.sprite).copied() else { continue; }; let dm = glam::Mat4::from_translation(glam::Vec3::new( @@ -931,7 +932,7 @@ impl Game<'_> { } else { "map/map_background" }; - if let Some(r) = self.atlas.sprites.get(background).copied() { + if let Some(r) = self.gui.atlas.sprites.get(background).copied() { for (c, uv) in [ ([-7.0, 135.0, 0.0], [r.u0, r.v1]), ([135.0, 135.0, 0.0], [r.u1, r.v1]), diff --git a/crates/horizon-client/src/game/minecarts.rs b/crates/horizon-client/src/game/minecarts.rs index 213a21b74..f0cb2b2ad 100644 --- a/crates/horizon-client/src/game/minecarts.rs +++ b/crates/horizon-client/src/game/minecarts.rs @@ -1157,7 +1157,7 @@ impl Game<'_> { .pack .layer_names .get(&face.layer) - .and_then(|n| self.atlas.sprites.get(n)) + .and_then(|n| self.gui.atlas.sprites.get(n)) else { continue; }; @@ -1236,6 +1236,7 @@ impl Game<'_> { continue; }; let Some(uv) = self + .gui .atlas .sprites .get("entity/minecart/minecart") @@ -1342,12 +1343,12 @@ impl Game<'_> { game_time: self.world.game_time, max_y: self.dim.max_y(), world: &self.world, - sprites: &self.atlas.sprites, + sprites: &self.gui.atlas.sprites, nether: self.dim == super::Dim::Nether, lid: &lid, sign: &|_| None, banner: &|_| Vec::new(), - glyph: &|c| self.atlas.glyph_cell(c), + glyph: &|c| self.gui.atlas.glyph_cell(c), }; self.res .block_entity_render diff --git a/crates/horizon-client/src/game/mob_blocks.rs b/crates/horizon-client/src/game/mob_blocks.rs index c2246cf5b..f42648aa6 100644 --- a/crates/horizon-client/src/game/mob_blocks.rs +++ b/crates/horizon-client/src/game/mob_blocks.rs @@ -78,7 +78,7 @@ impl Game<'_> { let Some(kind) = self.res.mob_types.get("minecraft:elder_guardian") else { return; }; - let Some(r) = self.atlas.sprites.get("entity/guardian_elder").copied() else { + let Some(r) = self.gui.atlas.sprites.get("entity/guardian_elder").copied() else { return; }; let age = (APPARITION_TICKS - left) as f32 + alpha as f32; @@ -147,7 +147,7 @@ impl Game<'_> { return; }; let m = banner_matrix(head); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let uv = |name: &str| atlas.sprites.get(name).map(|r| [r.u0, r.v0, r.u1, r.v1]); // BannerRenderer: the flag sways with a per-banner phase. let phase = @@ -187,7 +187,7 @@ impl Game<'_> { ) { for (corners, shade, side) in FACES { let name = cube.sprites[usize::from(side)]; - let Some(r) = self.atlas.sprites.get(name).copied() else { + let Some(r) = self.gui.atlas.sprites.get(name).copied() else { continue; }; let tint = if side == 0 { cube.tint } else { 0xFF_FFFF }; diff --git a/crates/horizon-client/src/game/mods.rs b/crates/horizon-client/src/game/mods.rs index 5a1131c3b..b6abf38ef 100644 --- a/crates/horizon-client/src/game/mods.rs +++ b/crates/horizon-client/src/game/mods.rs @@ -284,7 +284,7 @@ impl Game<'_> { let focused = self.screen == Screen::Chat; self.ui .chat - .add(&self.atlas, line, None, self.ticks, focused); + .add(&self.gui.atlas, line, None, self.ticks, focused); } } /// The mods' HUD panels, stacked with the extras in their corners. @@ -305,7 +305,7 @@ impl Game<'_> { .iter() .map(|l| (l.text.as_str(), l.color)) .collect(); - extras_hud::draw_lines(batch, &self.atlas, corners, corner, &lines); + extras_hud::draw_lines(batch, &self.gui.atlas, corners, corner, &lines); } } } diff --git a/crates/horizon-client/src/game/mount_menu.rs b/crates/horizon-client/src/game/mount_menu.rs index 55e9dde11..1eec17491 100644 --- a/crates/horizon-client/src/game/mount_menu.rs +++ b/crates/horizon-client/src/game/mount_menu.rs @@ -283,7 +283,7 @@ impl Game<'_> { let Some(open) = self.mount_menu.open.as_ref() else { return; }; - let atlas = &self.atlas; + let atlas = &self.gui.atlas; batch.sprite_region( atlas, "gui/container/horse", @@ -376,7 +376,7 @@ impl Game<'_> { m.hurt_time = 0; m.death_time = 0; let camera = glam::DVec3::new(m.position.x, m.position.y, m.position.z); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let lookup = |name: &str| atlas.sprites.get(name).map(|r| [r.u0, r.v0, r.u1, r.v1]); let mut verts = Vec::new(); horizon_client::mobs::render::render_with( diff --git a/crates/horizon-client/src/game/mounts.rs b/crates/horizon-client/src/game/mounts.rs index 869364176..846834615 100644 --- a/crates/horizon-client/src/game/mounts.rs +++ b/crates/horizon-client/src/game/mounts.rs @@ -457,7 +457,7 @@ impl Game<'_> { return (0, false); }; let m = &self.mobs[i]; - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let hearts = horizon_client::hud_layout::vehicle_max_hearts(m.attrs.max_health); let draws = horizon_client::hud_layout::vehicle_health(w, h, hearts, m.health); horizon_client::hud_layout::paint(batch, atlas, &draws); diff --git a/crates/horizon-client/src/game/names.rs b/crates/horizon-client/src/game/names.rs index 368c5c0f2..707b9df96 100644 --- a/crates/horizon-client/src/game/names.rs +++ b/crates/horizon-client/src/game/names.rs @@ -218,7 +218,7 @@ impl Game<'_> { let forward = glam::DVec3::from_array(view_vector(self.yaw, self.pitch)); let right = forward.cross(glam::DVec3::Y).normalize_or_zero(); let up = right.cross(forward).normalize_or_zero(); - let white = self.atlas.font.white(); + let white = self.gui.atlas.font.white(); let away = forward.as_vec3() * 0.002; for (text, lift) in lines { let o = (o + glam::DVec3::new(0.0, *lift, 0.0)).as_vec3(); @@ -240,7 +240,7 @@ impl Game<'_> { .collect(); let width: f32 = chars .iter() - .map(|(c, _)| self.atlas.glyph(*c).map_or(6.0, |g| g.1)) + .map(|(c, _)| self.gui.atlas.glyph(*c).map_or(6.0, |g| g.1)) .sum(); let x0 = -(width / 2.0).trunc(); let y0 = if text.plain() == "deadmau5" { @@ -278,7 +278,7 @@ impl Game<'_> { } let mut x = x0; for (ch, color) in chars { - let Some((g, advance)) = self.atlas.glyph(ch) else { + let Some((g, advance)) = self.gui.atlas.glyph(ch) else { x += 6.0; continue; }; diff --git a/crates/horizon-client/src/game/options.rs b/crates/horizon-client/src/game/options.rs index ed0dccb06..ad4942981 100644 --- a/crates/horizon-client/src/game/options.rs +++ b/crates/horizon-client/src/game/options.rs @@ -111,7 +111,7 @@ impl Game<'_> { } pub(super) fn draw_options(&mut self, batch: &mut HudBatch) { let mut ui = std::mem::take(&mut self.ui.options); - ui.draw(&self.settings, batch, &self.atlas, self.cursor); + ui.draw(&self.settings, batch, &self.gui.atlas, self.cursor); self.ui.options = ui; } pub(super) fn options_mouse(&mut self, pressed: bool, right: bool) -> Result<()> { @@ -133,7 +133,7 @@ impl Game<'_> { let mut ui = std::mem::take(&mut self.ui.options); let events = ui.click( &mut self.settings, - &self.atlas, + &self.gui.atlas, self.cursor.0, self.cursor.1, size, @@ -152,7 +152,7 @@ impl Game<'_> { let mut ui = std::mem::take(&mut self.ui.options); let events = ui.click( &mut self.settings, - &self.atlas, + &self.gui.atlas, self.cursor.0, self.cursor.1, size, @@ -165,7 +165,7 @@ impl Game<'_> { } pub(super) fn options_key(&mut self, key: KeyCode, text: Option<&str>) -> Result<()> { let mut ui = std::mem::take(&mut self.ui.options); - let events = ui.key(&mut self.settings, &self.atlas, key, text); + let events = ui.key(&mut self.settings, &self.gui.atlas, key, text); self.ui.options = ui; self.handle_option_events(events) } @@ -176,7 +176,7 @@ impl Game<'_> { ) -> bool { self.ui .options - .shortcut(&self.atlas, shortcut, &mut self.clipboard) + .shortcut(&self.gui.atlas, shortcut, &mut self.clipboard) } pub(super) fn options_scroll(&mut self, amount: f32) { let size = self.gui_size(); @@ -233,7 +233,7 @@ impl Game<'_> { pub(super) fn load_language(&mut self, code: &str) { let root = self.options.resources.clone(); lang::set(lang::Language::load(&[&root], code)); - self.ui.chat.rescale(&self.atlas); + self.ui.chat.rescale(&self.gui.atlas); } /// Settings that Horizon applies beyond render distance, volume and GUI scale. pub(super) fn apply_ui_settings(&mut self) { @@ -264,14 +264,14 @@ impl Game<'_> { }; self.ui.chat.options = chat; if rescale { - self.ui.chat.rescale(&self.atlas); + self.ui.chat.rescale(&self.gui.atlas); } - let font = &mut self.atlas.font; + let font = &mut self.gui.atlas.font; if font.uniform != s.force_unicode || font.japanese != s.japanese_glyphs { font.uniform = s.force_unicode; font.japanese = s.japanese_glyphs; font.reset_cache(); - self.ui.chat.rescale(&self.atlas); + self.ui.chat.rescale(&self.gui.atlas); } // A new renderer (resource reload, first window) takes the loaded pack. let stale = self diff --git a/crates/horizon-client/src/game/packs.rs b/crates/horizon-client/src/game/packs.rs index 0b95dd2ad..82b228669 100644 --- a/crates/horizon-client/src/game/packs.rs +++ b/crates/horizon-client/src/game/packs.rs @@ -123,6 +123,10 @@ impl Game<'_> { let mut atlas = HudAtlas::build(root)?; atlas.font.uniform = self.settings.force_unicode; atlas.font.japanese = self.settings.japanese_glyphs; + let gui = super::UiResources { + atlas, + panorama: std::sync::Arc::new(horizon_client::gfx::panorama::Faces::load(root)), + }; let pack = super::PackResources::load( root, assets, @@ -137,7 +141,7 @@ impl Game<'_> { let renderer = match self .window .clone() - .map(|window| self.renderer_for(window, &pack, &atlas)) + .map(|window| self.renderer_for(window, &pack, &gui)) .transpose() { Ok(renderer) => renderer, @@ -157,7 +161,7 @@ impl Game<'_> { self.options.resources = root.to_path_buf(); let context = pack.context.clone(); self.pack = pack; - self.atlas = atlas; + self.gui = gui; horizon_client::ui_theme::reset_atlas(); // Villager hats come from the pack's texture metadata (shared data, swapped in place). *self @@ -178,7 +182,7 @@ impl Game<'_> { self.renderer = Some(renderer); self.apply_ui_settings(); } - self.ui.chat.rescale(&self.atlas); + self.ui.chat.rescale(&self.gui.atlas); Ok(()) } } diff --git a/crates/horizon-client/src/game/pad_menu.rs b/crates/horizon-client/src/game/pad_menu.rs index 8f34d2b3a..7c492e46f 100644 --- a/crates/horizon-client/src/game/pad_menu.rs +++ b/crates/horizon-client/src/game/pad_menu.rs @@ -942,7 +942,7 @@ impl Game<'_> { } else if self.screen == Screen::Options { let result = match text { Some(t) => { - self.ui.options.type_text(&self.atlas, t); + self.ui.options.type_text(&self.gui.atlas, t); Ok(()) } None => self.options_key(key.expect("a key"), None), @@ -987,7 +987,7 @@ impl Game<'_> { .is_some_and(|f| f.center().1 > batch.height / 2.0) || self.screen == Screen::Chat || self.remote_chat_open(); - let mut ui = horizon_client::ui_theme::Ui::new(&self.atlas, batch, self.cursor); + let mut ui = horizon_client::ui_theme::Ui::new(&self.gui.atlas, batch, self.cursor); keyboard.draw(&mut ui, at_top, self.ui.options.pad_style); ui.finish(); return; @@ -1002,7 +1002,7 @@ impl Game<'_> { return; } // An arrow, outlined, pointing up-left at (x, y). - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let (x, y) = (x.floor(), y.floor()); const ROWS: [u8; 10] = [1, 2, 3, 4, 5, 6, 7, 4, 2, 1]; for (i, &w) in ROWS.iter().enumerate() { @@ -1047,7 +1047,7 @@ impl Game<'_> { }; if horizon { use horizon_client::ui_theme::{self as theme, Ui, color}; - let mut ui = Ui::new(&self.atlas, batch, self.cursor); + let mut ui = Ui::new(&self.gui.atlas, batch, self.cursor); let k = ui.batch.scale / ui.density; let (x, y, w, h) = (x * k, y * k, w * k, h * k); let radius = match focus.kind { @@ -1070,7 +1070,7 @@ impl Game<'_> { return; } if matches!(focus.kind, Kind::Row | Kind::Field) { - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let white = rgba(255, 255, 255, 255); batch.fill(atlas, x, y, w, 1.0, white); batch.fill(atlas, x, y + h - 1.0, w, 1.0, white); diff --git a/crates/horizon-client/src/game/paintings.rs b/crates/horizon-client/src/game/paintings.rs index 2e5542ccc..7e80f04d2 100644 --- a/crates/horizon-client/src/game/paintings.rs +++ b/crates/horizon-client/src/game/paintings.rs @@ -249,7 +249,7 @@ impl Game<'_> { /// PaintingRenderer: the variant on the front, the back texture behind and /// on the edges. pub(super) fn painting_geometry(&self, camera: glam::DVec3, out: &mut Vec) { - let sprites = &self.atlas.sprites; + let sprites = &self.gui.atlas.sprites; let Some(back) = sprites.get("painting/back").copied() else { return; }; diff --git a/crates/horizon-client/src/game/perspective.rs b/crates/horizon-client/src/game/perspective.rs index 7e9b0eeb6..9e5ea9edf 100644 --- a/crates/horizon-client/src/game/perspective.rs +++ b/crates/horizon-client/src/game/perspective.rs @@ -421,7 +421,7 @@ impl Game<'_> { m.position.z.floor() as i32, ); let packed = (u32::from(light >> 4) * 16) | ((u32::from(light & 15) * 16) << 8); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let lookup = |name: &str| atlas.sprites.get(name).map(|r| [r.u0, r.v0, r.u1, r.v1]); horizon_client::mobs::render::render_with( m, @@ -475,7 +475,7 @@ impl Game<'_> { m.position.y += 0.125 * f64::from(u8::from(m.extra.crouching)); m.previous = m.position; let camera = glam::DVec3::new(m.position.x, m.position.y, m.position.z); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let lookup = |name: &str| atlas.sprites.get(name).map(|r| [r.u0, r.v0, r.u1, r.v1]); let mut verts = Vec::new(); horizon_client::mobs::render::render_with( @@ -546,9 +546,10 @@ impl Game<'_> { let Some((texture, _)) = assets.equipment.get(asset).and_then(|k| k.get("wings")) else { return; }; - let (Some(model), Some(rect)) = - (assets.player.get("elytra"), self.atlas.sprites.get(texture)) - else { + let (Some(model), Some(rect)) = ( + assets.player.get("elytra"), + self.gui.atlas.sprites.get(texture), + ) else { return; }; let base = horizon_client::mobs::render::base_transform(m, partial, camera) diff --git a/crates/horizon-client/src/game/potions.rs b/crates/horizon-client/src/game/potions.rs index a60926256..c360df99f 100644 --- a/crates/horizon-client/src/game/potions.rs +++ b/crates/horizon-client/src/game/potions.rs @@ -613,7 +613,7 @@ impl Game<'_> { .map(hud_overlays::EffectIcon::from) .collect(); let draws = hud_overlays::effects(batch.width as i32, false, &icons); - hud_layout::paint(batch, &self.atlas, &draws); + hud_layout::paint(batch, &self.gui.atlas, &draws); } /// `EffectsInInventory`: panels to the right of survival/creative inventory. pub(super) fn draw_inventory_effects( @@ -629,11 +629,11 @@ impl Game<'_> { &self.potions.effects.list, self.clock.rate(), &|key| self.pack.names.get(key).map(str::to_owned), - &|text| self.atlas.font.width(text).ceil() as i32, + &|text| self.gui.atlas.font.width(text).ceil() as i32, ); if let Some(lines) = inventory_effects::paint( batch, - &self.atlas, + &self.gui.atlas, &panels, [self.cursor.0 as i32, self.cursor.1 as i32], ) { diff --git a/crates/horizon-client/src/game/recipe_book.rs b/crates/horizon-client/src/game/recipe_book.rs index 67fc46b68..e21b3e1bb 100644 --- a/crates/horizon-client/src/game/recipe_book.rs +++ b/crates/horizon-client/src/game/recipe_book.rs @@ -629,7 +629,7 @@ impl Game<'_> { search.focused = true; search.reset_blink(); if !magnifier { - let idx = search.index_at(&self.atlas, cursor.0); + let idx = search.index_at(&self.gui.atlas, cursor.0); search.set_cursor(idx, false); } return true; @@ -871,7 +871,7 @@ impl Game<'_> { let (bx, by) = self.book_button_pos(book_type, ox, batch); let hover = inside(cursor, bx, by, 20.0, 18.0); batch.sprite( - &self.atlas, + &self.gui.atlas, &sprite(if hover { "button_highlighted" } else { @@ -919,7 +919,7 @@ impl Game<'_> { fn draw_book_panel(&mut self, batch: &mut HudBatch, book_type: BookType) { let (xo, yo) = self.book_origin(batch); let cursor = self.cursor; - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let search = match self.recipe_ui.search.as_mut() { Some(edit) => { // The box's place, for clicks and typing. @@ -1042,7 +1042,7 @@ impl Game<'_> { let mut tooltip: Option> = None; for d in calls { let start = batch.vertices.len(); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; match &d.call { Call::Blit { x, y, w, h, u, v, .. diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index c2fab26db..c38b61012 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -1937,10 +1937,11 @@ impl Game<'_> { self.skin_slots.len() } else { let (old, slot) = self.skin_slots.remove(0); - self.atlas.sprites.remove(&old); + self.gui.atlas.sprites.remove(&old); slot }; let Some(rect) = self + .gui .atlas .sprites .get(&format!("horizon/skin{slot}")) @@ -1948,7 +1949,7 @@ impl Game<'_> { else { return; }; - let (w, h) = (self.atlas.width as f32, self.atlas.height as f32); + let (w, h) = (self.gui.atlas.width as f32, self.gui.atlas.height as f32); self.map_patches.push(horizon_client::font::Patch { x: (rect.u0 * w).round() as u32, y: (rect.v0 * h).round() as u32, @@ -1956,7 +1957,7 @@ impl Game<'_> { height: 64, rgba, }); - self.atlas.sprites.insert(location.clone(), rect); + self.gui.atlas.sprites.insert(location.clone(), rect); self.skin_slots.push((location, slot)); } /// Whether a downloaded skin is in the atlas, marking it recently shown. @@ -3169,7 +3170,7 @@ impl Game<'_> { if self.player.is_some() { return false; } - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let (w, h) = (batch.width, batch.height); batch.fill(atlas, 0.0, 0.0, w, h, rgba(20, 20, 20, 255)); let shown = horizon_client::net::shown_address(&r.session.address); @@ -3194,7 +3195,7 @@ impl Game<'_> { /// Chat (ChatComponent), the chat input line and the action bar. pub(super) fn remote_hud(&self, batch: &mut HudBatch) { let Some(r) = &self.remote else { return }; - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let (w, h) = (batch.width, batch.height); let open = r.chat_input.is_some(); let now = Instant::now(); diff --git a/crates/horizon-client/src/game/render_tick.rs b/crates/horizon-client/src/game/render_tick.rs index 4ee10e6d2..2024657b0 100644 --- a/crates/horizon-client/src/game/render_tick.rs +++ b/crates/horizon-client/src/game/render_tick.rs @@ -211,7 +211,7 @@ impl Game<'_> { let gui_overlays = hud_overlays::camera_overlays(size[0] as i32, size[1] as i32, &overlays, &mut scope); self.screen_fx.build(&ScreenInputs { - sprites: &self.atlas.sprites, + sprites: &self.gui.atlas.sprites, aspect: size[0] as f32 / size[1].max(1) as f32, partial, block_overlay, diff --git a/crates/horizon-client/src/game/scoreboard.rs b/crates/horizon-client/src/game/scoreboard.rs index 60894a14e..ab0aa9dcd 100644 --- a/crates/horizon-client/src/game/scoreboard.rs +++ b/crates/horizon-client/src/game/scoreboard.rs @@ -586,11 +586,11 @@ impl Game<'_> { batch.height as i32, board, objective, - &self.atlas.font, + &self.gui.atlas.font, self.settings.text_background(0.3), self.settings.text_background(0.4), ); - hud_layout::paint(batch, &self.atlas, &draws); + hud_layout::paint(batch, &self.gui.atlas, &draws); } } @@ -652,8 +652,8 @@ impl Game<'_> { ), upside_down: &up, }; - let draws = self.tab_list.layout(&inputs, &self.atlas.font); - horizon_client::hud_layout::paint(batch, &self.atlas, &draws); + let draws = self.tab_list.layout(&inputs, &self.gui.atlas.font); + horizon_client::hud_layout::paint(batch, &self.gui.atlas, &draws); } } diff --git a/crates/horizon-client/src/game/screens.rs b/crates/horizon-client/src/game/screens.rs index 365dd5992..e84c194f6 100644 --- a/crates/horizon-client/src/game/screens.rs +++ b/crates/horizon-client/src/game/screens.rs @@ -92,7 +92,7 @@ impl Game<'_> { let (world, quit) = self.pause_labels(); self.tick_friends(); let friends = self.friends_view(); - let mut ui = horizon_client::ui_theme::Ui::new(&self.atlas, batch, self.cursor); + let mut ui = horizon_client::ui_theme::Ui::new(&self.gui.atlas, batch, self.cursor); horizon_client::front::pause::draw( &mut ui, &world, @@ -104,7 +104,7 @@ impl Game<'_> { ui.finish(); return; } - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let (w, h) = (batch.width, batch.height); ui::menu_background(batch, atlas, 0.0, 0.0, w, h, true); let title = Text::translate("menu.game", &[]); @@ -156,7 +156,7 @@ impl Game<'_> { let mut b = HudBatch::new(size); let (world, quit) = self.pause_labels(); horizon_client::front::pause::click( - &self.atlas, + &self.gui.atlas, &mut b, self.cursor.0, self.cursor.1, @@ -197,7 +197,7 @@ impl Game<'_> { } /// DeathScreen: gradient, the title at double size, the cause and score. pub(super) fn draw_death_screen(&mut self, batch: &mut HudBatch) { - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let (w, h) = (batch.width, batch.height); // fillGradient(0x60500000 -> 0xA0803030). let rows = h.ceil() as i32; diff --git a/crates/horizon-client/src/game/sign_edit.rs b/crates/horizon-client/src/game/sign_edit.rs index c0a780063..0804de6be 100644 --- a/crates/horizon-client/src/game/sign_edit.rs +++ b/crates/horizon-client/src/game/sign_edit.rs @@ -88,7 +88,7 @@ impl Game<'_> { return; }; let line = edit.line; - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let width = |s: &str| HudBatch::text_width(atlas, s); let Some(key) = self.sign_edit.as_ref().map(|e| e.pos) else { return; @@ -130,7 +130,7 @@ impl Game<'_> { } else { &mut sign.back }; - let atlas = &self.atlas; + let atlas = &self.gui.atlas; self.text_selection.apply( sign_line_id(front, line), &mut text.lines[line], @@ -163,7 +163,7 @@ impl Game<'_> { let Some(BlockEntity::Sign(sign)) = self.world.block_entities.get(&edit.pos) else { return; }; - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let (w, h) = (batch.width, batch.height); batch.fill(atlas, 0.0, 0.0, w, h, rgba(16, 16, 16, 160)); let title = if sign.hanging { diff --git a/crates/horizon-client/src/game/spawner.rs b/crates/horizon-client/src/game/spawner.rs index c42299c86..66a365835 100644 --- a/crates/horizon-client/src/game/spawner.rs +++ b/crates/horizon-client/src/game/spawner.rs @@ -399,7 +399,7 @@ impl Game<'_> { alpha: f64, out: &mut Vec, ) { - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let lookup = |name: &str| atlas.sprites.get(name).map(|r| [r.u0, r.v0, r.u1, r.v1]); for (key, (_, mob)) in &self.spawners.displays { let at = glam::DVec3::new(f64::from(key.0), f64::from(key.1), f64::from(key.2)); diff --git a/crates/horizon-client/src/game/stations.rs b/crates/horizon-client/src/game/stations.rs index 8cd751548..161c8c556 100644 --- a/crates/horizon-client/src/game/stations.rs +++ b/crates/horizon-client/src/game/stations.rs @@ -1249,7 +1249,7 @@ impl Game<'_> { } /// Text in the Standard Galactic alphabet (`minecraft:alt`), cut to `max` pixels. fn galactic(&self, batch: &mut HudBatch, text: &str, x: f32, y: f32, max: f32, color: u32) { - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let Some(sheet) = atlas.sprites.get("font/ascii_sga").copied() else { batch.text(atlas, text, x, y, color, false); return; @@ -1325,7 +1325,7 @@ impl Game<'_> { let local = (self.cursor.0 - ox, self.cursor.1 - oy); let mut tooltip: Option> = None; { - let atlas = &self.atlas; + let atlas = &self.gui.atlas; batch.fill( atlas, 0.0, @@ -1342,7 +1342,7 @@ impl Game<'_> { }; let (fuel, total_fuel, brew, total_brew) = (b.fuel, b.total_fuel, b.brew_time, b.total_brew_time); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; Self::part( batch, atlas, @@ -1417,7 +1417,7 @@ impl Game<'_> { if self.slot_mut(i).is_none() { let (sx, sy) = self.station_slot_position(i).unwrap_or_default(); batch.sprite( - &self.atlas, + &self.gui.atlas, &format!("gui/sprites/container/slot/{icon}"), ox + sx, oy + sy, @@ -1427,7 +1427,7 @@ impl Game<'_> { } else if let Some(kind) = self.station.as_ref().map(|s| s.kind) { let title = self.translate(kind.title_key(), ""); { - let atlas = &self.atlas; + let atlas = &self.gui.atlas; Self::part( batch, atlas, @@ -1446,7 +1446,7 @@ impl Game<'_> { if kind == Kind::Loom { tooltip = self.draw_loom(batch, ox, oy, local); } - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let s = self.station.as_ref().expect("open station"); let has_input = s.inputs.iter().any(Option::is_some); match kind { @@ -1552,7 +1552,7 @@ impl Game<'_> { ); -8323296 }; - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let cw = HudBatch::text_width(atlas, &cost_text); batch.text( atlas, @@ -1679,7 +1679,7 @@ impl Game<'_> { ) }; if let Some(line) = line { - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let tw = HudBatch::text_width(atlas, &line); let tx = 176.0 - 8.0 - tw - 2.0; batch.fill( @@ -1788,7 +1788,7 @@ impl Game<'_> { "recipe" }; batch.sprite_scaled( - &self.atlas, + &self.gui.atlas, &format!("gui/sprites/container/stonecutter/{sprite}"), ox + x, oy + y - 1.0, @@ -1816,7 +1816,7 @@ impl Game<'_> { if let Some(slot) = self.slot_at(batch, self.cursor.0, self.cursor.1) { let (sx, sy) = self.slot_position(slot); batch.fill( - &self.atlas, + &self.gui.atlas, ox + sx, oy + sy, 16.0, @@ -2065,7 +2065,7 @@ impl Game<'_> { if lines.is_empty() { return; } - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let w = lines .iter() .map(|(t, _)| HudBatch::text_width(atlas, t)) diff --git a/crates/horizon-client/src/game/stats_screen.rs b/crates/horizon-client/src/game/stats_screen.rs index 40b151453..1221cd175 100644 --- a/crates/horizon-client/src/game/stats_screen.rs +++ b/crates/horizon-client/src/game/stats_screen.rs @@ -222,7 +222,7 @@ impl Game<'_> { } pub(super) fn draw_stats(&mut self, batch: &mut HudBatch) { let (w, h) = (batch.width, batch.height); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; ui::menu_background(batch, atlas, 0.0, 0.0, w, h, true); let (top, bottom) = (TAB_H, h - FOOTER); ui::separators(batch, atlas, top, bottom, true); @@ -333,13 +333,13 @@ impl Game<'_> { } let stack = ItemStack::new(item, 1); batch.sprite( - &self.atlas, + &self.gui.atlas, "gui/sprites/container/slot", left + 1.0, y + 1.0, ); self.draw_item(batch, &stack, left + 2.0, y + 2.0); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let color = if (i + 1) % 2 == 0 { u32::MAX } else { @@ -400,7 +400,7 @@ impl Game<'_> { } } } - let atlas = &self.atlas; + let atlas = &self.gui.atlas; ui::scrollbar( batch, atlas, @@ -413,7 +413,7 @@ impl Game<'_> { self.draw_stats_footer(batch, w, h); } fn draw_stats_footer(&self, batch: &mut HudBatch, w: f32, h: f32) { - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let (bx, by) = ((w / 2.0 - 100.0).floor(), h - FOOTER + 6.0); let hover = ui::hovered(self.cursor, bx, by, 200.0, 20.0); ui::button( diff --git a/crates/horizon-client/src/game/storage.rs b/crates/horizon-client/src/game/storage.rs index 44b62e276..f6c38f2cd 100644 --- a/crates/horizon-client/src/game/storage.rs +++ b/crates/horizon-client/src/game/storage.rs @@ -211,7 +211,7 @@ impl Game<'_> { oy: f32, ) { use horizon_client::hud::rgba; - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let grey = rgba(64, 64, 64, 255); if self .container_block() diff --git a/crates/horizon-client/src/game/subtitle_hud.rs b/crates/horizon-client/src/game/subtitle_hud.rs index cf89a4b15..f54ca874d 100644 --- a/crates/horizon-client/src/game/subtitle_hud.rs +++ b/crates/horizon-client/src/game/subtitle_hud.rs @@ -47,7 +47,7 @@ impl Game<'_> { width: batch.width as i32, height: batch.height as i32, }; - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let draws = self .subtitles .overlay diff --git a/crates/horizon-client/src/game/titles.rs b/crates/horizon-client/src/game/titles.rs index 459aab503..70ade5595 100644 --- a/crates/horizon-client/src/game/titles.rs +++ b/crates/horizon-client/src/game/titles.rs @@ -16,10 +16,10 @@ impl Game<'_> { let (w, h) = (batch.width as i32, batch.height as i32); let partial = self.clock.fraction() as f32; let background = self.settings.text_background(0.0); - let font = &self.atlas.font; + let font = &self.gui.atlas.font; let mut draws = self.titles.overlay_message(w, h, partial, font, background); draws.extend(self.titles.title(w, h, partial, font, background)); - hud_layout::paint(batch, &self.atlas, &draws); + hud_layout::paint(batch, &self.gui.atlas, &draws); } /// The selected stack as `Hud.tick` compares it for the name highlight. fn held_name(&self) -> Option { @@ -54,9 +54,9 @@ impl Game<'_> { batch.width as i32, batch.height as i32, can_hurt, - &self.atlas.font, + &self.gui.atlas.font, self.settings.text_background(0.0), ); - hud_layout::paint(batch, &self.atlas, &draws); + hud_layout::paint(batch, &self.gui.atlas, &draws); } } diff --git a/crates/horizon-client/src/game/tnt.rs b/crates/horizon-client/src/game/tnt.rs index 78f107599..5fe87fce3 100644 --- a/crates/horizon-client/src/game/tnt.rs +++ b/crates/horizon-client/src/game/tnt.rs @@ -238,7 +238,7 @@ impl Game<'_> { .pack .layer_names .get(&face.layer) - .and_then(|name| self.atlas.sprites.get(name).copied()); + .and_then(|name| self.gui.atlas.sprites.get(name).copied()); } } for t in &self.tnts { diff --git a/crates/horizon-client/src/game/trading.rs b/crates/horizon-client/src/game/trading.rs index ce389ac84..660738d69 100644 --- a/crates/horizon-client/src/game/trading.rs +++ b/crates/horizon-client/src/game/trading.rs @@ -548,7 +548,7 @@ impl Game<'_> { ); let offers = m.session.offers.clone(); let costs: Vec = offers.iter().map(|o| o.cost_a(&self.res.items)).collect(); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; batch.fill( atlas, 0.0, @@ -687,7 +687,7 @@ impl Game<'_> { } else { "gui/sprites/widget/button" }; - batch.sprite_scaled(&self.atlas, sprite, bx, by, 88.0, 20.0, u32::MAX); + batch.sprite_scaled(&self.gui.atlas, sprite, bx, by, 88.0, 20.0, u32::MAX); let y = oy + 16.0 + 1.0 + 20.0 * row as f32 + 2.0; let base = offer.base_cost_a.stack.clone(); let cost_a = costs[index].clone(); @@ -705,7 +705,7 @@ impl Game<'_> { x, y, ); - let atlas = &self.atlas; + let atlas = &self.gui.atlas; let t = base.count.to_string(); batch.text( atlas, @@ -740,7 +740,7 @@ impl Game<'_> { "trade_arrow" }; batch.sprite( - &self.atlas, + &self.gui.atlas, &format!("gui/sprites/container/villager/{arrow}"), ox + SHIFT + 60.0, y + 3.0, @@ -770,7 +770,7 @@ impl Game<'_> { if let Some(slot) = self.slot_at(batch, self.cursor.0, self.cursor.1) { let (sx, sy) = self.slot_position(slot); batch.fill( - &self.atlas, + &self.gui.atlas, ox + sx, oy + sy, 16.0, diff --git a/crates/horizon-client/src/game/trident.rs b/crates/horizon-client/src/game/trident.rs index 8c372fa46..fc3de7fd7 100644 --- a/crates/horizon-client/src/game/trident.rs +++ b/crates/horizon-client/src/game/trident.rs @@ -343,6 +343,7 @@ impl Game<'_> { return; }; let Some(uv) = self + .gui .atlas .sprites .get("entity/trident/trident") diff --git a/crates/horizon-client/src/game/tweaks.rs b/crates/horizon-client/src/game/tweaks.rs index 018b6640b..dc58a1a45 100644 --- a/crates/horizon-client/src/game/tweaks.rs +++ b/crates/horizon-client/src/game/tweaks.rs @@ -331,7 +331,7 @@ impl Game<'_> { /// The sort buttons: a bordered square with three bars, lighter under /// the cursor. pub(super) fn draw_sort_buttons(&self, batch: &mut HudBatch, ox: f32, oy: f32) { - let atlas = &self.atlas; + let atlas = &self.gui.atlas; for ((x, y), _) in self.sort_buttons() { let (x, y) = (ox + x, oy + y); let (cx, cy) = self.cursor; diff --git a/crates/horizon-client/src/game/wind.rs b/crates/horizon-client/src/game/wind.rs index 07759944f..46a1feed6 100644 --- a/crates/horizon-client/src/game/wind.rs +++ b/crates/horizon-client/src/game/wind.rs @@ -478,6 +478,7 @@ impl Game<'_> { }); let Some(model) = model else { return }; let Some(r) = self + .gui .atlas .sprites .get("entity/projectiles/wind_charge") From 580c2b1dd790d19e7146159d91bd9f8fecb3f4f7 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 21:46:38 +0200 Subject: [PATCH 010/163] Motion: reuse the game's block facts for the fluid tables FluidResources decoded gameplay-facts.json a second time for three per-state columns the game's BlockFacts already has. With ATM10's carried mods that file is 211 MB: the second decode took a few seconds and peaked about 500 MB above what the game keeps. MotionResources::load_with_facts takes the game's facts; load still decodes them itself for tests and tools. Co-Authored-By: Claude Opus 5.5 --- .../horizon-client/examples/resource_memory.rs | 2 +- crates/horizon-client/src/game.rs | 2 +- crates/horizon-client/src/motion.rs | 17 ++++++++++++++++- crates/horizon-client/src/motion/fluids.rs | 3 +-- 4 files changed, 19 insertions(+), 5 deletions(-) diff --git a/crates/horizon-client/examples/resource_memory.rs b/crates/horizon-client/examples/resource_memory.rs index c292ff2f4..1eb6c45b7 100644 --- a/crates/horizon-client/examples/resource_memory.rs +++ b/crates/horizon-client/examples/resource_memory.rs @@ -120,7 +120,7 @@ fn main() -> Result<()> { step("mesh tables"); let collision = collisions::load(&root, assets.registry)?; step("collision"); - let motion = MotionResources::load(&root, &assets)?; + let motion = MotionResources::load_with_facts(&root, &assets, &facts)?; step("motion"); let terrain = VanillaTerrain::new(&root.join("worldgen"), assets.registry, &biomes, 1234)?; step("worldgen"); diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 6de683c67..37b8b1919 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -10379,7 +10379,7 @@ pub fn run() -> Result<()> { log::info!("load atlas: {:.2}s", started.elapsed().as_secs_f32()); let registry_owner = assets.clone(); let collision = collisions::load(&root, registry_owner.registry)?; - let motion = MotionResources::load(&root, ®istry_owner)?; + let motion = MotionResources::load_with_facts(&root, ®istry_owner, &facts)?; log::info!( "load collision+motion: {:.2}s", started.elapsed().as_secs_f32() diff --git a/crates/horizon-client/src/motion.rs b/crates/horizon-client/src/motion.rs index 4c026ac45..321af2458 100644 --- a/crates/horizon-client/src/motion.rs +++ b/crates/horizon-client/src/motion.rs @@ -56,7 +56,22 @@ pub struct MotionResources { pub fluids: FluidResources, } impl MotionResources { + /// [`Self::load_with_facts`] with the block facts decoded here. pub fn load(root: &Path, assets: &Assets) -> Result { + Self::load_with_facts( + root, + assets, + &crate::blocks::BlockFacts::load(root, assets.registry)?, + ) + } + /// The motion tables, with the block facts the game already decoded + /// (decoding `gameplay-facts.json` again costs a second or more and, with + /// a big modpack, hundreds of megabytes while it runs). + pub fn load_with_facts( + root: &Path, + assets: &Assets, + facts: &crate::blocks::BlockFacts, + ) -> Result { let attributes = Arc::new(Catalog::from_json(&serde_json::from_slice(&fs::read( root.join("attributes.json"), )?)?)?); @@ -85,7 +100,7 @@ impl MotionResources { Ok(Self { landing: crate::landing::load(root, &properties)?, health: crate::health::HealthResources::load(root)?, - fluids: FluidResources::load(root, assets)?, + fluids: FluidResources::new(assets, facts)?, attributes, blocks: properties.bind(&MovementTags { fences: tag("minecraft:fences")?, diff --git a/crates/horizon-client/src/motion/fluids.rs b/crates/horizon-client/src/motion/fluids.rs index f85f755a9..89affeb64 100644 --- a/crates/horizon-client/src/motion/fluids.rs +++ b/crates/horizon-client/src/motion/fluids.rs @@ -33,8 +33,7 @@ pub struct FluidResources { pub shapes: Mutex, } impl FluidResources { - pub fn load(root: &Path, assets: &Assets) -> Result { - let facts = crate::blocks::BlockFacts::load(root, assets.registry)?; + pub fn new(assets: &Assets, facts: &crate::blocks::BlockFacts) -> Result { Ok(Self { states: FluidStateTable::new(assets.registry)?, sturdy: facts.states.iter().map(|s| s.sturdy_full).collect(), From 24fd51b186b850b30e12797a5e13767189eb75c7 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 21:51:33 +0200 Subject: [PATCH 011/163] Content mods: keep the built content root for later starts resource_root built the content root again on every start. With ATM10's 40 carried data-tier mods that is about 25 s on a quiet machine (50 s on a busy one) and the biggest memory peak of the start, above 3 GB of footprint. The root now records a stamp of what it was built from (this build of the game, the base's manifest and rewritten tables, every mod file by size and time) and later starts with the same stamp use it as it is. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/mod_content.rs | 60 +++++++++++++++++++ .../horizon-client/src/mod_content_tests.rs | 35 +++++++++++ crates/horizon-mods/src/content.rs | 7 +++ 3 files changed, 102 insertions(+) diff --git a/crates/horizon-client/src/mod_content.rs b/crates/horizon-client/src/mod_content.rs index 25df87352..8176ddfae 100644 --- a/crates/horizon-client/src/mod_content.rs +++ b/crates/horizon-client/src/mod_content.rs @@ -943,15 +943,75 @@ pub fn build(base: &Path, mods: &[ContentMod], out: &Path) -> Result<()> { /// The root to load: `base` itself with no content, else the mods' overlay /// over it, built in `cache/mod-content`. +/// +/// The root is built once and kept: later starts with the same build, base +/// and mod files reuse it. With ATM10's carried mods a build takes about +/// 25 s and peaks above 3 GB, more than everything the game keeps. pub fn resource_root(base: &Path, mods: &[ContentMod], cache: &Path) -> Result { if mods.iter().all(|m| m.content.is_empty()) { return Ok(base.to_owned()); } let out = cache.join("mod-content"); + let stamp = stamp(base, mods)?; + if fs::read(out.join(STAMP)).is_ok_and(|s| s == stamp.as_bytes()) { + return Ok(out); + } build(base, mods, &out)?; + fs::write(out.join(STAMP), stamp)?; Ok(out) } +/// In a root built by [`resource_root`]: what it was built from. +const STAMP: &str = "horizon-mod-content.stamp"; + +/// What a content root is built from: this build of the game, the base's +/// manifest and the tables [`build`] rewrites, and every file of every mod +/// in order. Files count by size and modification time, as build tools do. +fn stamp(base: &Path, mods: &[ContentMod]) -> Result { + use sha2::{Digest, Sha256}; + let meta = |path: &Path| -> Result { + let m = fs::metadata(path).map_err(|e| format!("{}: {e}", path.display()))?; + let modified = m + .modified()? + .duration_since(std::time::UNIX_EPOCH) + .unwrap_or_default(); + Ok(format!( + "{} {} {}", + path.display(), + m.len(), + modified.as_nanos() + )) + }; + let mut parts = vec!["horizon mod content 1".to_owned()]; + parts.push(meta(&std::env::current_exe()?)?); + let base = std::path::absolute(base)?; + parts.push( + String::from_utf8_lossy(&fs::read(base.join("horizon-resources.json"))?).into_owned(), + ); + for name in JSON_TABLES.iter().chain(&NBT_TABLES).chain(&TAG_BUNDLES) { + if base.join(name).exists() { + parts.push(meta(&base.join(name))?); + } + } + for m in mods { + parts.push(m.id.clone()); + let source = m.content.source(); + if source.is_dir() { + for file in &m.content.files { + parts.push(meta(&source.join(file))?); + } + } else { + parts.push(meta(source)?); + } + } + let mut hasher = Sha256::new(); + for part in &parts { + hasher.update((part.len() as u64).to_le_bytes()); + hasher.update(part.as_bytes()); + } + Ok(format!("{:x}", hasher.finalize())) +} + #[cfg(test)] #[path = "mod_content_tests.rs"] mod tests; diff --git a/crates/horizon-client/src/mod_content_tests.rs b/crates/horizon-client/src/mod_content_tests.rs index 2a040b0fc..c086f8c0c 100644 --- a/crates/horizon-client/src/mod_content_tests.rs +++ b/crates/horizon-client/src/mod_content_tests.rs @@ -502,3 +502,38 @@ fn independent_reloads_read_changed_behaviour_json_and_report_invalid_files() { ); fs::remove_dir_all(&scratch).unwrap(); } + +/// A built root is kept for later starts, and built again when a mod's +/// files change. +#[test] +fn content_root_is_reused_until_a_mod_changes() { + let Some(base) = prepared() else { + return; + }; + let scratch = std::env::temp_dir().join(format!("horizon-mod-reuse-{}", std::process::id())); + let _ = fs::remove_dir_all(&scratch); + let m = ruby_mod(&scratch.join("ruby")); + let cache = scratch.join("cache"); + let root = resource_root(&base, std::slice::from_ref(&m), &cache).unwrap(); + // A rebuild starts from an empty folder: this file tells them apart. + let sentinel = root.join("sentinel"); + fs::write(&sentinel, b"").unwrap(); + assert_eq!( + resource_root(&base, std::slice::from_ref(&m), &cache).unwrap(), + root + ); + assert!(sentinel.exists(), "an unchanged mod rebuilt the root"); + let lang = scratch.join("ruby/assets/ruby/lang/en_us.json"); + fs::write(&lang, r#"{"block.ruby.ruby_block": "Ruby Block"}"#).unwrap(); + let file = fs::File::options().write(true).open(&lang).unwrap(); + file.set_modified(std::time::SystemTime::now() + std::time::Duration::from_secs(5)) + .unwrap(); + resource_root(&base, std::slice::from_ref(&m), &cache).unwrap(); + assert!(!sentinel.exists(), "a changed mod kept the old root"); + assert!( + fs::read_to_string(root.join("assets/ruby/lang/en_us.json")) + .unwrap() + .contains("Ruby Block") + ); + let _ = fs::remove_dir_all(&scratch); +} diff --git a/crates/horizon-mods/src/content.rs b/crates/horizon-mods/src/content.rs index 40b641759..9afe95d0a 100644 --- a/crates/horizon-mods/src/content.rs +++ b/crates/horizon-mods/src/content.rs @@ -192,6 +192,13 @@ impl Content { Ok(content) } + /// Where the files are read from: the mod's folder or its `.hmod`. + pub fn source(&self) -> &Path { + match &self.source { + Source::Dir(path) | Source::Zip(path) => path, + } + } + /// No files: a mod with code only. pub fn is_empty(&self) -> bool { self.files.is_empty() From 782924fcb7fda91a8f8425144e392e0f120d45c7 Mon Sep 17 00:00:00 2001 From: LookImEcho-Rick <62575172+LookImEcho-Rick@users.noreply.github.com> Date: Sat, 17 Oct 2026 15:36:13 -0500 Subject: [PATCH 012/163] Add settings search to video and controls --- crates/horizon-client/src/options_horizon.rs | 53 ++++++++- crates/horizon-client/src/options_ui.rs | 112 ++++++++++++++++++- crates/horizon-client/src/ui_theme.rs | 43 +++++++ 3 files changed, 200 insertions(+), 8 deletions(-) diff --git a/crates/horizon-client/src/options_horizon.rs b/crates/horizon-client/src/options_horizon.rs index 634bb8d75..7e2f7e9f1 100644 --- a/crates/horizon-client/src/options_horizon.rs +++ b/crates/horizon-client/src/options_horizon.rs @@ -207,8 +207,15 @@ const DONE: u64 = id("options.done", 0); const ROW: u64 = id("options.row", 0); const STYLE: u64 = id("options.style", 0); const LEVEL: u64 = id("options.level", 0); +const SEARCH: u64 = id("options.search", 0); const ROW_H: f32 = 12.0 + CONTROL + 12.0; const HEADER_H: f32 = 40.0; +pub(crate) fn searchable_section(section: usize) -> bool { + matches!( + SECTIONS.get(section).map(|s| s.name), + Some("Video" | "Controls") + ) +} /// Whether an option is an on/off switch, and its value. fn switch_value(opt: Opt, s: &Settings) -> Option { @@ -258,12 +265,29 @@ fn caption_value(opt: Opt, s: &Settings) -> (String, String) { enum Target { Nav(usize), Done, + Search, Row(usize), Slider(Item, f32), Style(usize), Level(usize), } impl OptionsUi { + fn horizon_rows(&self, s: &Settings, section: usize) -> Vec { + let rows = (SECTIONS[section].rows)(s); + let query = self.settings_search.value.to_lowercase(); + if query.is_empty() || !searchable_section(section) { + return rows; + } + rows.into_iter() + .filter(|row| match row { + HRow::Opt(opt) => caption_value(*opt, s).0.to_lowercase().contains(&query), + HRow::Graphics(item, ..) => item.caption_value(s).0.to_lowercase().contains(&query), + HRow::Page(label, ..) => label.to_lowercase().contains(&query), + HRow::Level => true, + _ => false, + }) + .collect() + } /// Lay out (and draw, on a real frame) the Horizon options shell. /// Returns the sliders' tracks (option, x, width) for dragging. fn horizon_layout( @@ -307,8 +331,17 @@ impl OptionsUi { let sec = &SECTIONS[section]; let mut y = 36.0; y += ui.page_header(x, y, sec.name, sec.blurb) + 24.0; + if searchable_section(section) { + ui.text_field( + SEARCH, + [x + cw - 240.0, y, 240.0, CONTROL], + &self.settings_search.value, + self.settings_search.focused, + ); + y += CONTROL + 12.0; + } let top = y; - let rows = (sec.rows)(s); + let rows = self.horizon_rows(s, section); let content: f32 = rows .iter() .map(|r| { @@ -535,6 +568,9 @@ impl OptionsUi { let mut ui = Ui::dry(atlas, &mut batch, (x, y)); let sliders = self.horizon_layout(s, &mut ui, 1.0); let hit = ui.hit((x, y))?; + if hit == SEARCH { + return Some(Target::Search); + } let section = self.section.min(SECTIONS.len() - 1); if (NAV..NAV + SECTIONS.len() as u64).contains(&hit) { return Some(Target::Nav((hit - NAV) as usize)); @@ -549,7 +585,7 @@ impl OptionsUi { return Some(Target::Level((hit - LEVEL) as usize)); } let i = hit.checked_sub(ROW)? as usize; - let rows = (SECTIONS[section].rows)(s); + let rows = self.horizon_rows(s, section); let item = match rows.get(i) { Some(HRow::Opt(opt)) => Some(Item::Vanilla(*opt)), Some(HRow::Graphics(item, ..)) => Some(*item), @@ -598,11 +634,20 @@ impl OptionsUi { }, ); } - match self.horizon_target(s, atlas, x, y) { + let target = self.horizon_target(s, atlas, x, y); + self.settings_search.focused = false; + match target { Some(Target::Nav(i)) => { + if searchable_section(self.section) || searchable_section(i) { + self.settings_search.set_value(""); + } self.section = i; self.hscroll = 0.0; } + Some(Target::Search) => { + self.settings_search.focused = true; + self.settings_search.move_cursor_to_end(false); + } Some(Target::Done) => events.extend(self.back(s)), Some(Target::Style(i)) => { t::set_style(if i == 1 { @@ -626,7 +671,7 @@ impl OptionsUi { } Some(Target::Row(i)) => { let section = self.section.min(SECTIONS.len() - 1); - match (SECTIONS[section].rows)(s).get(i) { + match self.horizon_rows(s, section).get(i) { Some(HRow::Opt(opt)) => { opt.cycle(s, right, framebuffer); if *opt == Opt::Preset { diff --git a/crates/horizon-client/src/options_ui.rs b/crates/horizon-client/src/options_ui.rs index fab36defa..994cc4793 100644 --- a/crates/horizon-client/src/options_ui.rs +++ b/crates/horizon-client/src/options_ui.rs @@ -823,6 +823,7 @@ pub struct OptionsUi { pub languages: Vec, language_choice: Option, language_search: ui::EditBox, + pub(crate) settings_search: ui::EditBox, /// Packs: the packs found and the selection the screen opens with. pub pack_infos: Vec, pub pack_selection: Vec, @@ -841,6 +842,8 @@ impl Default for OptionsUi { fn default() -> Self { let mut search = ui::EditBox::new(0.0, 0.0, 200.0, 15.0); search.max_length = 32; + let mut settings_search = ui::EditBox::new(0.0, 0.0, 200.0, 15.0); + settings_search.focused = false; Self { stack: vec![Page::Main], scroll: 0.0, @@ -857,6 +860,7 @@ impl Default for OptionsUi { languages: Vec::new(), language_choice: None, language_search: search, + settings_search, pack_infos: Vec::new(), pack_selection: Vec::new(), pack_screen: None, @@ -918,6 +922,13 @@ fn pairs(opts: &[Opt]) -> Vec { .collect() } impl OptionsUi { + fn settings_search_active(&self) -> bool { + self.settings_search.focused + && (matches!(self.page(), Page::Video | Page::Controls | Page::KeyBinds) + || (crate::ui_theme::horizon() + && self.page() == Page::Main + && crate::options_horizon::searchable_section(self.section))) + } pub fn page(&self) -> Page { *self.stack.last().unwrap_or(&Page::Main) } @@ -945,6 +956,10 @@ impl OptionsUi { self.stack.push(page); self.scroll = 0.0; self.scrollbar_drag_y = None; + if matches!(page, Page::Video | Page::Controls | Page::KeyBinds) { + self.settings_search.set_value(""); + self.settings_search.focused = false; + } if page == Page::Language { self.language_choice = None; self.language_search.set_value(""); @@ -993,6 +1008,33 @@ impl OptionsUi { _ => 163.0, } } + fn filter_option_rows(&self, rows: Vec) -> Vec { + let query = self.settings_search.value.to_lowercase(); + if query.is_empty() { + return rows; + } + rows.into_iter() + .flat_map(|row| match row { + Row::Big(opt) if lang::get(opt.caption()).to_lowercase().contains(&query) => { + vec![Row::Big(opt)] + } + Row::Pair(a, b) => { + let matches = + |opt: Opt| lang::get(opt.caption()).to_lowercase().contains(&query); + pairs( + &[Some(a), b] + .into_iter() + .flatten() + .filter(|opt| matches(*opt)) + .collect::>(), + ) + } + // Keep navigation available and omit section headers with no visible options. + Row::Buttons(a, b) => vec![Row::Buttons(a, b)], + _ => Vec::new(), + }) + .collect() + } fn list_rows(&self, s: &Settings) -> Vec { match self.page() { Page::Extras => crate::extras::rows() @@ -1080,7 +1122,7 @@ impl OptionsUi { Opt::AttackIndicator, Opt::ChunkFade, ])); - rows + self.filter_option_rows(rows) } Page::Sound => { let mut rows = vec![Row::Big(Opt::Volume(0))]; @@ -1122,7 +1164,7 @@ impl OptionsUi { ), None, )); - rows + self.filter_option_rows(rows) } Page::Controller => { let mut rows = vec![Row::Buttons( @@ -1227,6 +1269,10 @@ impl OptionsUi { let mut out = Vec::new(); let page = self.page(); let cx = (w / 2.0).floor(); + if matches!(page, Page::Video | Page::Controls | Page::KeyBinds) { + self.settings_search.x = cx - 100.0; + self.settings_search.y = 17.0; + } let done = |y: f32| button(cx - 100.0, y, 200.0, tr("gui.done"), Act::Done); // (list top, list bottom, content height) let (mut top, mut bottom, mut content) = (33.0, h - 33.0, 0.0); @@ -1276,9 +1322,10 @@ impl OptionsUi { bottom = 0.0; } Page::KeyBinds => { + top = 38.0; out.push(Widget { x: 0.0, - y: 12.0, + y: 4.0, w, h: 9.0, kind: WKind::Text { @@ -1290,6 +1337,10 @@ impl OptionsUi { }); let mut mappings: Vec<(&str, &str)> = MAPPINGS.iter().map(|(n, _, c)| (*n, *c)).collect(); + let query = self.settings_search.value.to_lowercase(); + mappings.retain(|(name, _)| { + query.is_empty() || lang::get(name).to_lowercase().contains(&query) + }); mappings.sort_by(|a, b| { let ca = CATEGORIES.iter().position(|c| *c == a.1).unwrap_or(99); let cb = CATEGORIES.iter().position(|c| *c == b.1).unwrap_or(99); @@ -1558,9 +1609,16 @@ impl OptionsUi { // Drawn by `pack_screen`. Page::Packs => {} _ => { + if matches!(page, Page::Video | Page::Controls) { + top = 38.0; + } out.push(Widget { x: 0.0, - y: 12.0, + y: if matches!(page, Page::Video | Page::Controls) { + 4.0 + } else { + 12.0 + }, w, h: 9.0, kind: WKind::Text { @@ -1881,6 +1939,23 @@ impl OptionsUi { } self.language_search = search; } + if matches!(self.page(), Page::Video | Page::Controls | Page::KeyBinds) { + let mut search = self.settings_search.clone(); + search.draw(batch, atlas, None); + if search.value.is_empty() && !search.focused { + batch.text_styled( + atlas, + &Text::literal("Search settings...") + .with_color(text::GRAY) + .italic(), + search.text_x(), + search.text_y(), + u32::MAX, + true, + ); + } + self.settings_search = search; + } if let Some(lines) = tooltip { ui::tooltip(batch, atlas, &lines, cursor); } @@ -1964,6 +2039,16 @@ impl OptionsUi { } let (widgets, top, bottom, content) = self.layout(s, size.0, size.1); let mut events = Vec::new(); + if !drag && matches!(self.page(), Page::Video | Page::Controls | Page::KeyBinds) { + let search = &mut self.settings_search; + search.focused = ui::hovered((x, y), search.x, search.y, search.width, search.height); + if search.focused { + search.click(atlas, x, false, false); + self.scroll = 0.0; + events.push(Event::ButtonClick); + return events; + } + } if drag { if let Some(previous_y) = self.scrollbar_drag_y { if let Some((_, thumb)) = ui::scrollbar_thumb(top, bottom, content, self.scroll) { @@ -2238,6 +2323,9 @@ impl OptionsUi { if self.page() == Page::Language { self.language_search.insert_text(text); self.scroll = 0.0; + } else if self.settings_search_active() { + self.settings_search.insert_text(text); + self.scroll = 0.0; } } /// Ctrl+A/C/V/X in the language or pack search box; false when neither @@ -2263,6 +2351,12 @@ impl OptionsUi { } return true; } + if self.settings_search_active() { + if self.settings_search.shortcut(shortcut, clipboard) { + self.scroll = 0.0; + } + return true; + } false } fn bind_key(&mut self, s: &mut Settings, value: String) -> Vec { @@ -2346,6 +2440,16 @@ impl OptionsUi { } } self.scroll = 0.0; + } else if self.settings_search_active() { + if !self.settings_search.key(key, false, false) + && let Some(t) = text + { + let typed: String = t.chars().filter(|c| !c.is_control()).collect(); + if !typed.is_empty() { + self.settings_search.insert_text(&typed); + } + } + self.scroll = 0.0; } Vec::new() } diff --git a/crates/horizon-client/src/ui_theme.rs b/crates/horizon-client/src/ui_theme.rs index 2cb3b5315..7f99e9830 100644 --- a/crates/horizon-client/src/ui_theme.rs +++ b/crates/horizon-client/src/ui_theme.rs @@ -1042,6 +1042,49 @@ impl<'a> Ui<'a> { self.opacity = saved; hover } + /// A search field styled like the launcher's rounded text inputs. + pub fn text_field(&mut self, id: u64, rect: [f32; 4], value: &str, focused: bool) { + let [x, y, w, h] = rect; + self.record_label(value, rect, true, crate::widgets::Kind::Button); + let hover = self.interact(id, x, y, w, h, true); + self.rounded( + x, + y, + w, + h, + 8.0, + if focused { color::HOVER } else { color::RAISED }, + ); + self.rounded( + x, + y, + w, + h, + 8.0, + color::with_alpha(color::HOVER, hover * 0.5), + ); + let display = if value.is_empty() { + "Search settings".to_owned() + } else if focused { + format!("{value}|") + } else { + value.to_owned() + }; + let display = self.fit(Face::Regular, BODY, &display, w - 24.0); + self.text_line( + Face::Regular, + BODY, + h, + x + 12.0, + y, + if value.is_empty() { + color::FAINT + } else { + color::TEXT + }, + &display, + ); + } /// The width the launcher's button gives a label (padding 16, or 24 large). pub fn button_width(&self, label: &str, large: bool) -> f32 { let (size, pad) = if large { (LARGE, 24.0) } else { (BODY, 16.0) }; From b9d61e5701727cbd7f07018c8780969ab8a7983e Mon Sep 17 00:00:00 2001 From: LookImEcho-Rick <62575172+LookImEcho-Rick@users.noreply.github.com> Date: Sat, 17 Oct 2026 15:48:49 -0500 Subject: [PATCH 013/163] Make pr_ready portable to Windows --- tests/test_parity_runner.py | 2 ++ tools/parity.py | 51 ++++++++++++++--------------- tools/pr_ready.py | 64 ++++++++++++++++++++++++++++++++++++- 3 files changed, 91 insertions(+), 26 deletions(-) diff --git a/tests/test_parity_runner.py b/tests/test_parity_runner.py index 78716787a..ffec8d3d5 100644 --- a/tests/test_parity_runner.py +++ b/tests/test_parity_runner.py @@ -1,4 +1,5 @@ from pathlib import Path +import os import tempfile import unittest from unittest import mock @@ -151,6 +152,7 @@ class ShardTests(unittest.TestCase): self.assertEqual(parity.base_name("x#2"), "x") +@unittest.skipIf(os.name == "nt", "oracle PATH shimming uses Unix executable symlink semantics") class OracleReuseTests(unittest.TestCase): """tools/parity_shim.py replays a run only when its inputs and outputs are as recorded.""" diff --git a/tools/parity.py b/tools/parity.py index 5809f913e..6ba4c0d90 100644 --- a/tools/parity.py +++ b/tools/parity.py @@ -36,8 +36,9 @@ import argparse import hashlib import json import os -from pathlib import Path +from pathlib import Path, PurePosixPath import re +import socket import subprocess import sys import time @@ -61,14 +62,14 @@ SHIM = STATE_DIR / "shim" # so a harness whose inputs match one that passed elsewhere doesn't run again. SHARED = Path(os.environ.get("PARITY_SHARED") or (LOCAL / "minecraft").resolve().parent / "parity-shared") MACHINE_JOBS = int(os.environ.get("PARITY_MACHINE_JOBS") or max(1, (os.cpu_count() or 4) // 2)) -HOST = os.uname().nodename.split(".")[0] +HOST = socket.gethostname().split(".")[0] DEFAULT_MEMORY = 3 << 30 # assumed peak for a harness that never ran here def harness_settings(path): """PARITY_SHARDS and PARITY_RUST_SCOPE, read from a harness's source without running it.""" import ast - text = Path(path).read_text() + text = Path(path).read_text(encoding="utf-8") settings = {} if "PARITY_" in text: for node in ast.parse(text).body: @@ -102,7 +103,7 @@ def base_name(name): def load_state(): - return json.loads(STATE.read_text()) if STATE.exists() else {"harnesses": {}, "hashes": {}} + return json.loads(STATE.read_text(encoding="utf-8")) if STATE.exists() else {"harnesses": {}, "hashes": {}} def save_state(state): @@ -129,7 +130,7 @@ class Hasher: if cached and cached[0] == stamp: return cached[1] if keep: - digest = hashlib.sha256(crate_root_without_modules(Path(real).read_text(), set(keep.split(","))).encode()).hexdigest() + digest = hashlib.sha256(crate_root_without_modules(Path(real).read_text(encoding="utf-8"), set(keep.split(","))).encode()).hexdigest() else: with open(real, "rb") as stream: digest = hashlib.file_digest(stream, "sha256").hexdigest() @@ -168,7 +169,7 @@ def environment_key(hasher): return (result.stdout + result.stderr).strip() except FileNotFoundError: return "missing" - lock = json.loads((ROOT / "research-lock.json").read_text()) + lock = json.loads((ROOT / "research-lock.json").read_text(encoding="utf-8")) version_dir = LOCAL / "minecraft" / lock["minecraft"]["version"] parts = [version(["rustc", "-V"]), version(["java", "-version"]), version(["javac", "-version"]), json.dumps(PROFILE, sort_keys=True), hasher(ROOT / "research-lock.json"), hasher(ROOT / "Cargo.lock"), @@ -197,7 +198,7 @@ def dep_info(binary): if not info.exists(): return [] sources = [] - for line in info.read_text().splitlines(): + for line in info.read_text(encoding="utf-8").splitlines(): _, separator, rest = line.partition(": ") if separator: sources += [part.replace("\\ ", " ") for part in re.split(r"(?/src/... + parts = list(PurePosixPath(path).parts[3:-1] + (PurePosixPath(path).with_suffix("").name,)) return parts[:-1] if parts[-1] in ("mod", "lib") else parts defined_types, used_macros, kept_modules = set(), set(), {} for path in inner + entry: - text = rust_code((ROOT / path).read_text(errors="replace")) - crate_name = Path(path).parts[1].replace("-", "_") + text = rust_code((ROOT / path).read_text(encoding="utf-8", errors="replace")) + crate_name = PurePosixPath(path).parts[1].replace("-", "_") nesting = inline_modules(text) if re.search(r"\binclude!\s*\(", text): return sources, f"{path} includes source" @@ -401,7 +402,7 @@ def narrow_rust_sources(sources, scope): if head in crates: # a workspace crate base, crate_name = [], head elif head.startswith(("crate", "self", "super")) and path in inner: - own, crate_name = module_path(path) + nesting(match.start()), Path(path).parts[1].replace("-", "_") + own, crate_name = module_path(path) + nesting(match.start()), PurePosixPath(path).parts[1].replace("-", "_") ups = head.count("super") if head != "crate" and ups <= len(nesting(match.start())): continue # within this file @@ -415,14 +416,14 @@ def narrow_rust_sources(sources, scope): item = (base + parts)[0] defined_in_root = root.is_file() and re.search( rf"^\s*(?:pub(?:\([^)]*\))?\s+)?(?:const|static|fn|struct|enum|type|trait|union)\s+{item}\b", - root.read_text(), re.MULTILINE) + root.read_text(encoding="utf-8"), re.MULTILINE) if not defined_in_root: return sources, f"{path} names {head}::{rest}, which the crate root doesn't define itself" continue if not scoped(target): return sources, f"{path} names {head}::{rest} ({target})" for path in outside: - text = rust_code((ROOT / path).read_text(errors="replace")) + text = rust_code((ROOT / path).read_text(encoding="utf-8", errors="replace")) defined = set(RUST_MACRO_DEFINITION.findall(text)) & used_macros if defined: return sources, f"the scope uses macro {sorted(defined)[0]}! defined in {path}" @@ -433,7 +434,7 @@ def narrow_rust_sources(sources, scope): kept = [path for path in sources if path not in outside and not path.endswith("/src/lib.rs")] for path in sources: if path.endswith("/src/lib.rs"): - modules = kept_modules.get(Path(path).parts[1].replace("-", "_")) or {"-"} # "-": no module of it is reachable + modules = kept_modules.get(PurePosixPath(path).parts[1].replace("-", "_")) or {"-"} # "-": no module of it is reachable kept.append(f"{path}{KEEP}{','.join(sorted(modules))}") return sorted(kept), None @@ -549,7 +550,7 @@ def clear_large_outputs(name, trace): everything else large under the harness's .local directories is rebuilt on its next run.""" local = LOCAL.resolve() - keep = {os.path.realpath(line) for line in outputs_listing(name).read_text().splitlines() if line} + keep = {os.path.realpath(line) for line in outputs_listing(name).read_text(encoding="utf-8").splitlines() if line} directories = set() for command in trace["commands"]: for argument in command[1:]: @@ -600,7 +601,7 @@ def memory_available(): """Bytes the system can give harnesses now: MemAvailable on Linux, free and reclaimable pages on macOS.""" meminfo = Path("/proc/meminfo") if meminfo.exists(): - for line in meminfo.read_text().splitlines(): + for line in meminfo.read_text(encoding="utf-8").splitlines(): if line.startswith("MemAvailable:"): return int(line.split()[1]) * 1024 try: @@ -634,7 +635,7 @@ def outcome(name, script, passed, elapsed, trace_path, hasher=None): record = {"status": "pass" if passed else "fail", "seconds": round(elapsed, 1), "finished": time.strftime("%Y-%m-%dT%H:%M:%S"), "host": HOST} try: - trace = json.loads(Path(trace_path).read_text()) + trace = json.loads(Path(trace_path).read_text(encoding="utf-8")) except (OSError, ValueError): trace = None # killed before writing it, or the disk was full: the pass can't be keyed if trace: @@ -726,7 +727,7 @@ class LocalExecutor: def host_config(): """tools/parity_hosts.json: the machines harnesses can run on, and the harnesses that must stay local.""" path = ROOT / "tools" / "parity_hosts.json" - return json.loads(path.read_text()) if path.exists() else {"default": [], "hosts": {}, "local_only": {}} + return json.loads(path.read_text(encoding="utf-8")) if path.exists() else {"default": [], "hosts": {}, "local_only": {}} class RemoteExecutor: @@ -1017,11 +1018,11 @@ def stale(name, state, hasher, environment): candidates = [record] if record and record.get("dependencies") else [] template = SHARED / "dependencies" / f"{name}.json" if template.exists(): - candidates.append(json.loads(template.read_text())) + candidates.append(json.loads(template.read_text(encoding="utf-8"))) for candidate in candidates: shared = SHARED / "passes" / name / f"{key(candidate, hasher, environment)}.json" if shared.exists(): - state["harnesses"][name] = dict(json.loads(shared.read_text()), shared=True) + state["harnesses"][name] = dict(json.loads(shared.read_text(encoding="utf-8")), shared=True) return False return True @@ -1088,7 +1089,7 @@ def changed_harnesses(found, records, ref): for name, script in found.items(): specific = [path for path in records.get(name, {}).get("dependencies", []) if path.startswith("mods/horizon/src/test/") or "/examples/" in path or "/src/bin/" in path] - if str(Path(script).relative_to(ROOT)) in changed or any(path in changed for path in specific): + if Path(script).relative_to(ROOT).as_posix() in changed or any(path in changed for path in specific): found_changed.add(name) return found_changed @@ -1103,8 +1104,8 @@ def affected_harnesses(found, records, changed): dependencies = records.get(name, {}).get("dependencies") template = SHARED / "dependencies" / f"{name}.json" if dependencies is None and template.exists(): - dependencies = json.loads(template.read_text()).get("dependencies") - if dependencies is None or str(Path(script).relative_to(ROOT)) in changed or \ + dependencies = json.loads(template.read_text(encoding="utf-8")).get("dependencies") + if dependencies is None or Path(script).relative_to(ROOT).as_posix() in changed or \ any(path.split(KEEP)[0] in changed for path in dependencies): affected.add(name) return affected @@ -1180,7 +1181,7 @@ def main(): chosen = [name for name in found if records.get(name, {}).get("status") == "fail"] elif args.changed or args.changed_files: if args.changed_files: - changed, since = set(Path(args.changed_files).read_text().split("\n")) - {""}, "" + changed, since = set(Path(args.changed_files).read_text(encoding="utf-8").split("\n")) - {""}, "" else: changed, since = changed_files(args.changed), f" since the merge base with {args.changed}" if changed is None: diff --git a/tools/pr_ready.py b/tools/pr_ready.py index 980080284..9ec216fea 100755 --- a/tools/pr_ready.py +++ b/tools/pr_ready.py @@ -29,6 +29,10 @@ import subprocess import sys import time +if os.name == "nt": + sys.stdout.reconfigure(encoding="utf-8", errors="replace") + sys.stderr.reconfigure(encoding="utf-8", errors="replace") + ROOT = Path(__file__).resolve().parents[1] sys.path.insert(0, str(ROOT)) FLEET_SHARED = Path.home() / "code" / "horizon-parity" / "shared-local" / "parity-shared" @@ -184,7 +188,7 @@ def line_counts(base, changed): for path in git("ls-files", "--others", "--exclude-standard").splitlines(): if path in changed: try: - counts[path] = (len((ROOT / path).read_text().splitlines()), 0) + counts[path] = (len((ROOT / path).read_text(encoding="utf-8").splitlines()), 0) except (UnicodeDecodeError, OSError): pass return counts @@ -303,6 +307,9 @@ def run_script(steps, host, verbose): """Runs the steps in one shell on host (here for "local"), each between markers, reading results as they come.""" if not steps: return + if host == "local" and os.name == "nt": + run_windows(steps, verbose) + return parts = [HOST_SETUP.get(host, ""), "set +e"] for index, step in enumerate(steps): parts.append(f"echo '@@pr_ready:begin:{index}'; started=$(date +%s)\n( {step.command}\n) 2>&1 < /dev/null\n" @@ -338,6 +345,61 @@ def run_script(steps, host, verbose): finish(step, verbose) +def run_windows(steps, verbose): + """Run local checks directly on Windows without requiring a Unix shell.""" + for step in steps: + command = shlex.split(step.command) + cwd = ROOT + env = os.environ.copy() + env["PYTHONUTF8"] = "1" + if step.name == "Public tree": + command = [sys.executable, "tools/check_public_tree.py"] + elif step.name == "Python tests": + command = [sys.executable, "-m", "unittest", "discover", "-s", "tests"] + elif step.name == "rustfmt": + command = ["cargo", "fmt", "--all", "--", "--check"] + elif step.name == "clippy": + command = ["cargo", "clippy", "--workspace", "--all-targets", "--locked", "--", "-D", "warnings"] + elif step.name.startswith("tests"): + command = shlex.split(step.command) + elif step.name == "tokens.css up to date": + command = shlex.split(step.command) + elif step.name == "launcher rustfmt": + command = ["cargo", "fmt", "--check"] + cwd = ROOT / "launcher" + elif step.name == "launcher clippy": + command = ["cargo", "clippy", "--all-targets", "--locked", "--", "-D", "warnings"] + cwd = ROOT / "launcher" + elif step.name == "launcher tests": + command = ["cargo", "test", "--locked", "--lib"] + cwd = ROOT / "launcher" + elif step.name == "Parity": + command = shlex.split(step.command) + if command and command[0] == "PARITY_HOSTS=": + command.pop(0) + if command and command[0] == "python3": + command[0] = sys.executable + env["PARITY_HOSTS"] = "" + elif command and command[0] == "python3": + command[0] = sys.executable + + print(f" {step.name}...", file=sys.stderr, flush=True) + started = time.monotonic() + try: + with subprocess.Popen(command, cwd=cwd, env=env, stdout=subprocess.PIPE, + stderr=subprocess.STDOUT, text=True, errors="replace") as process: + for line in process.stdout: + step.output += line + if verbose: + print(" " + line, end="", file=sys.stderr) + status = process.wait() + step.status = "pass" if status == 0 else "fail" + except OSError as error: + step.status, step.detail = "fail", str(error) + step.seconds = int(time.monotonic() - started) + finish(step, verbose) + + def finish(step, verbose): if step.status == "pass" and step.summary: step.detail = step.summary(step.output) From f0215473e3bed0abc33dd3f89f310978621d8479 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sat, 17 Oct 2026 22:08:17 +0100 Subject: [PATCH 014/163] Biome zoom: mix the shared corner prefixes once in quart_at_block getFiddledDistance restarts a six-step LinearCongruentialGenerator mix for each of the eight quart corners. Its first two steps depend only on the X and Y corner offsets, so quart_at_block now mixes the two X states and the four XY states once, then runs the remaining steps across the eight corners. next(m, salt + offset) == next(m, salt) + offset, so a coordinate folds into its step with one addition. Bit-identical to BiomeManager.getBiome and getFiddledDistance; a reference oracle test pins the equivalence over a dense grid and wrapping extremes. --- crates/horizon-core/src/biome.rs | 203 +++++++++++++++++++++++++++---- 1 file changed, 178 insertions(+), 25 deletions(-) diff --git a/crates/horizon-core/src/biome.rs b/crates/horizon-core/src/biome.rs index 4f8c9ff54..96baeda4b 100644 --- a/crates/horizon-core/src/biome.rs +++ b/crates/horizon-core/src/biome.rs @@ -22,20 +22,86 @@ impl BiomeZoom { } /// Choose the closest of eight jittered quart corners, preserving vanilla's /// corner order, strict tie comparison and signed coordinate wrapping. + /// + /// Each corner re-derives its distance from a fresh six-step mix driven by + /// the quart coordinate. The first two steps depend only on the X and Y + /// offsets, so those shared prefixes are mixed once (two X states, then four + /// XY states) instead of eight times, and the six-step tail is evaluated for + /// all eight corners. Since `next(m, salt + offset) == next(m, salt) + + /// offset`, each coordinate is folded into its step with one addition. pub fn quart_at_block(self, block: BlockPos) -> [i32; 3] { let shifted = [block.x, block.y, block.z].map(|v| v.wrapping_sub(2)); let base = shifted.map(|v| v >> 2); let fractions = shifted.map(|v| f64::from(v & 3) / 4.); + let coordinate = base.map(i64::from); + let seed = self.seed; + const A: i64 = 6364136223846793005; + const B: i64 = 1442695040888963407; + let g = |m: i64| m.wrapping_mul(m.wrapping_mul(A).wrapping_add(B)); + let root = g(seed); + let m0: [i64; 2] = + std::array::from_fn(|x: usize| root.wrapping_add(coordinate[0].wrapping_add(x as i64))); + let m1: [[i64; 2]; 2] = std::array::from_fn(|x: usize| { + std::array::from_fn(|y: usize| { + g(m0[x]).wrapping_add(coordinate[1].wrapping_add(y as i64)) + }) + }); + let m2: [[[i64; 2]; 2]; 2] = std::array::from_fn(|x: usize| { + std::array::from_fn(|y: usize| { + std::array::from_fn(|z: usize| { + g(m1[x][y]).wrapping_add(coordinate[2].wrapping_add(z as i64)) + }) + }) + }); + let m3: [[[i64; 2]; 2]; 2] = std::array::from_fn(|x: usize| { + std::array::from_fn(|y: usize| { + std::array::from_fn(|z: usize| { + g(m2[x][y][z]).wrapping_add(coordinate[0].wrapping_add(x as i64)) + }) + }) + }); + let m4: [[[i64; 2]; 2]; 2] = std::array::from_fn(|x: usize| { + std::array::from_fn(|y: usize| { + std::array::from_fn(|z: usize| { + g(m3[x][y][z]).wrapping_add(coordinate[1].wrapping_add(y as i64)) + }) + }) + }); + let m5: [[[i64; 2]; 2]; 2] = std::array::from_fn(|x: usize| { + std::array::from_fn(|y: usize| { + std::array::from_fn(|z: usize| { + g(m4[x][y][z]).wrapping_add(coordinate[2].wrapping_add(z as i64)) + }) + }) + }); + let m6: [[[i64; 2]; 2]; 2] = std::array::from_fn(|x: usize| { + std::array::from_fn(|y: usize| { + std::array::from_fn(|z: usize| g(m5[x][y][z]).wrapping_add(seed)) + }) + }); + let m7: [[[i64; 2]; 2]; 2] = std::array::from_fn(|x: usize| { + std::array::from_fn(|y: usize| { + std::array::from_fn(|z: usize| g(m6[x][y][z]).wrapping_add(seed)) + }) + }); let mut selected = base; let mut best = f64::INFINITY; - for corner in 0..8 { - let offsets = [(corner >> 2) & 1, (corner >> 1) & 1, corner & 1]; - let quart = std::array::from_fn(|i| base[i].wrapping_add(offsets[i])); - let delta = std::array::from_fn(|i| fractions[i] - f64::from(offsets[i])); - let distance = fiddled_distance(self.seed, quart, delta); - if best > distance { - best = distance; - selected = quart; + for x in 0..2 { + for y in 0..2 { + for z in 0..2 { + let dx = fractions[0] - x as f64 + fiddle(m5[x][y][z]); + let dy = fractions[1] - y as f64 + fiddle(m6[x][y][z]); + let dz = fractions[2] - z as f64 + fiddle(m7[x][y][z]); + let distance = dz * dz + dy * dy + dx * dx; + if best > distance { + best = distance; + selected = [ + base[0].wrapping_add(x as i32), + base[1].wrapping_add(y as i32), + base[2].wrapping_add(z as i32), + ]; + } + } } } selected @@ -50,25 +116,112 @@ pub fn noise_quart_at_block(block: BlockPos) -> [i32; 3] { pub fn noise_quart_at_position(position: [f64; 3]) -> [i32; 3] { position.map(|v| (v.floor() as i32) >> 2) } -fn next(seed: i64, salt: i64) -> i64 { - seed.wrapping_mul( - seed.wrapping_mul(6364136223846793005) - .wrapping_add(1442695040888963407), - ) - .wrapping_add(salt) -} fn fiddle(seed: i64) -> f64 { (((seed >> 24) & 1023) as f64 / 1024. - 0.5) * 0.9 } -fn fiddled_distance(seed: i64, quart: [i32; 3], delta: [f64; 3]) -> f64 { - let mut mixed = seed; - for coordinate in quart.into_iter().cycle().take(6) { - mixed = next(mixed, i64::from(coordinate)); + +#[cfg(test)] +mod tests { + use super::*; + + /// The straightforward per-corner formulation, kept as the parity oracle + /// for the prefix-shared implementation. + fn reference(seed: i64, block: BlockPos) -> [i32; 3] { + let shifted = [block.x, block.y, block.z].map(|v| v.wrapping_sub(2)); + let base = shifted.map(|v| v >> 2); + let fractions = shifted.map(|v| f64::from(v & 3) / 4.); + let mut selected = base; + let mut best = f64::INFINITY; + for corner in 0..8 { + let offsets = [(corner >> 2) & 1, (corner >> 1) & 1, corner & 1]; + let quart: [i32; 3] = std::array::from_fn(|i| base[i].wrapping_add(offsets[i])); + let delta: [f64; 3] = std::array::from_fn(|i| fractions[i] - f64::from(offsets[i])); + let mut mixed = seed; + for coordinate in quart.into_iter().cycle().take(6) { + mixed = mixed + .wrapping_mul( + mixed + .wrapping_mul(6364136223846793005) + .wrapping_add(1442695040888963407), + ) + .wrapping_add(i64::from(coordinate)); + } + let x = delta[0] + fiddle(mixed); + mixed = mixed + .wrapping_mul( + mixed + .wrapping_mul(6364136223846793005) + .wrapping_add(1442695040888963407), + ) + .wrapping_add(seed); + let y = delta[1] + fiddle(mixed); + mixed = mixed + .wrapping_mul( + mixed + .wrapping_mul(6364136223846793005) + .wrapping_add(1442695040888963407), + ) + .wrapping_add(seed); + let z = delta[2] + fiddle(mixed); + let distance = z * z + y * y + x * x; + if best > distance { + best = distance; + selected = quart; + } + } + selected + } + + #[test] + fn quart_at_block_matches_reference() { + let seeds = [ + 0i64, + 1, + -1, + i64::MIN, + i64::MAX, + 0x0123_4567_89ab_cdef, + -0x0123_4567_89ab_cdef, + ]; + let extremes = [ + i32::MIN, + i32::MIN + 1, + -1, + 0, + 1, + 2, + 3, + 4, + -2, + i32::MAX - 1, + i32::MAX, + ]; + for &seed in &seeds { + let zoom = BiomeZoom::new(seed); + for x in -34..34 { + for y in -34..34 { + for z in -34..34 { + let block = BlockPos::new(x, y, z); + assert_eq!( + zoom.quart_at_block(block), + reference(seed, block), + "seed {seed} at {x} {y} {z}" + ); + } + } + } + for &x in &extremes { + for &y in &extremes { + for &z in &extremes { + let block = BlockPos::new(x, y, z); + assert_eq!( + zoom.quart_at_block(block), + reference(seed, block), + "seed {seed} at {x} {y} {z}" + ); + } + } + } + } } - let x = delta[0] + fiddle(mixed); - mixed = next(mixed, seed); - let y = delta[1] + fiddle(mixed); - mixed = next(mixed, seed); - let z = delta[2] + fiddle(mixed); - z * z + y * y + x * x } From e25672ed4f9df646317be31e6dda22dfea742f57 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sat, 17 Oct 2026 22:16:45 +0100 Subject: [PATCH 015/163] Startup: split block assets into block data and render assets (#712) --- crates/horizon-client/examples/arrow_probe.rs | 5 ++- .../examples/auto_jump_probe.rs | 5 ++- .../examples/block_particles_fixture.rs | 2 + .../examples/breaking_fixture.rs | 4 +- crates/horizon-client/examples/chunk_bench.rs | 3 ++ .../examples/model_library_bench.rs | 5 ++- .../examples/resource_memory.rs | 8 ++-- .../examples/scene_collision_probe.rs | 5 ++- .../examples/scene_motion_probe.rs | 5 ++- .../examples/section_mesh_fixture.rs | 10 +++-- .../examples/streaming_bench.rs | 3 ++ crates/horizon-client/src/assets.rs | 43 ++++++++----------- crates/horizon-client/src/entities.rs | 3 +- crates/horizon-client/src/game.rs | 37 ++++++++++------ crates/horizon-client/src/game/minecarts.rs | 2 +- crates/horizon-client/src/game/packs.rs | 5 ++- crates/horizon-client/src/game/tnt.rs | 5 ++- crates/horizon-client/src/mesher.rs | 10 +++-- .../src/mesher/leaf_culling_tests.rs | 6 ++- crates/horizon-client/src/motion.rs | 27 ++++++++---- crates/horizon-client/src/streaming.rs | 2 + crates/horizon-client/src/world.rs | 8 +++- .../horizon-client/tests/generation_saves.rs | 4 +- .../horizon-client/tests/streaming_meshes.rs | 9 +++- 24 files changed, 135 insertions(+), 81 deletions(-) diff --git a/crates/horizon-client/examples/arrow_probe.rs b/crates/horizon-client/examples/arrow_probe.rs index 20c0883e3..63ff2df32 100644 --- a/crates/horizon-client/examples/arrow_probe.rs +++ b/crates/horizon-client/examples/arrow_probe.rs @@ -58,11 +58,12 @@ fn main() -> Result<()> { let root = PathBuf::from(&args[0]); let dir = PathBuf::from(&args[1]); let assets = Assets::load(&root)?; - let mut scene = World::test_scene(&assets, 1)?; + let render = assets.reload(&root)?; + let mut scene = World::test_scene(&assets, &render, 1)?; fs::write( dir.join("scene.json"), serde_json::to_vec( - &serde_json::json!({"radius":1,"resident_chunks":scene.chunks.len(),"model_gallery":assets.model_gallery}), + &serde_json::json!({"radius":1,"resident_chunks":scene.chunks.len(),"model_gallery":render.model_gallery}), )?, )?; if args[2] == "--describe" { diff --git a/crates/horizon-client/examples/auto_jump_probe.rs b/crates/horizon-client/examples/auto_jump_probe.rs index e4a9848e8..d8dee95df 100644 --- a/crates/horizon-client/examples/auto_jump_probe.rs +++ b/crates/horizon-client/examples/auto_jump_probe.rs @@ -31,13 +31,14 @@ fn main() -> Result<()> { }; let root = PathBuf::from(root); let assets = Assets::load(&root)?; - let mut scene = World::test_scene(&assets, 1)?; + let render = assets.reload(&root)?; + let mut scene = World::test_scene(&assets, &render, 1)?; let binding = collisions::load(&root, assets.registry)?; let resources = MotionResources::load(&root, &assets)?; fs::write( scene_json, serde_json::to_vec(&serde_json::json!({ - "radius": 1, "resident_chunks": scene.chunks.len(), "model_gallery": assets.model_gallery, + "radius": 1, "resident_chunks": scene.chunks.len(), "model_gallery": render.model_gallery, }))?, )?; let mut out = BufWriter::new(fs::File::create(output)?); diff --git a/crates/horizon-client/examples/block_particles_fixture.rs b/crates/horizon-client/examples/block_particles_fixture.rs index e9c207a7e..63ef242b7 100644 --- a/crates/horizon-client/examples/block_particles_fixture.rs +++ b/crates/horizon-client/examples/block_particles_fixture.rs @@ -12,9 +12,11 @@ fn main() -> Result<(), Box> { let args: Vec<_> = std::env::args().collect(); let root = Path::new(&args[1]); let assets = Assets::load(root)?; + let render = assets.reload(root)?; let facts = BlockFacts::load(root, assets.registry)?; let tables = MeshTables::new( &assets, + &render, &facts, models::load_visibility(root, assets.registry)?, )?; diff --git a/crates/horizon-client/examples/breaking_fixture.rs b/crates/horizon-client/examples/breaking_fixture.rs index ec8f7a68b..2016fd613 100644 --- a/crates/horizon-client/examples/breaking_fixture.rs +++ b/crates/horizon-client/examples/breaking_fixture.rs @@ -18,9 +18,11 @@ fn main() -> Result<(), Box> { let args: Vec<_> = std::env::args().collect(); let root = Path::new(&args[1]); let assets = Assets::load(root)?; + let render = assets.reload(root)?; let facts = BlockFacts::load(root, assets.registry)?; let tables = MeshTables::new( &assets, + &render, &facts, models::load_visibility(root, assets.registry)?, )?; @@ -33,7 +35,7 @@ fn main() -> Result<(), Box> { let mut vertices = Vec::new(); let mut translucent = false; if facts.get(state).render_shape == RenderShape::Model { - let models = assets + let models = render .model_catalog .collect(state, BlockPos::new(p[0], p[1], p[2]))?; let offset = tables.offset(state, p[0], p[2]).unwrap_or([0.0; 3]); diff --git a/crates/horizon-client/examples/chunk_bench.rs b/crates/horizon-client/examples/chunk_bench.rs index 6ad2cbd99..be619245f 100644 --- a/crates/horizon-client/examples/chunk_bench.rs +++ b/crates/horizon-client/examples/chunk_bench.rs @@ -31,10 +31,12 @@ fn main() -> Result<()> { }; let (seed, size) = (flag("--seed", 12345), flag("--size", 8) as i32); let assets = Assets::load(&root)?; + let render = assets.reload(&root)?; let facts = BlockFacts::load(&root, assets.registry)?; let biomes = Biomes::load(&root)?; let tables = MeshTables::new( &assets, + &render, &facts, models::load_visibility(&root, assets.registry)?, )?; @@ -132,6 +134,7 @@ fn main() -> Result<()> { let mut mesher = Mesher { nether_shading: false, assets: &assets, + render: &render, tables: &tables, biomes: &biomes, visibility: tables.visibility.clone(), diff --git a/crates/horizon-client/examples/model_library_bench.rs b/crates/horizon-client/examples/model_library_bench.rs index d3aba51e0..2089e39e1 100644 --- a/crates/horizon-client/examples/model_library_bench.rs +++ b/crates/horizon-client/examples/model_library_bench.rs @@ -56,10 +56,11 @@ fn main() -> horizon_client::Result<()> { let initial = LIVE.load(Relaxed); let start = Instant::now(); let assets = Assets::load(root)?; + let render = assets.reload(root)?; let block_ms = start.elapsed().as_secs_f64() * 1000.; let block_retained = LIVE.load(Relaxed) - initial; let start_items = Instant::now(); - let items = ItemRenderer::load_with_library(root, assets.model_library.clone())?; + let items = ItemRenderer::load_with_library(root, render.model_library.clone())?; let item_ms = start_items.elapsed().as_secs_f64() * 1000.; let total_ms = start.elapsed().as_secs_f64() * 1000.; let retained = LIVE.load(Relaxed) - initial; @@ -74,7 +75,7 @@ fn main() -> horizon_client::Result<()> { horizon_core::position::BlockPos::new(0, 0, 0), horizon_core::position::BlockPos::new(-17, 65, 31), ] { - if let Ok(selected) = assets.model_catalog.collect(id, pos) { + if let Ok(selected) = render.model_catalog.collect(id, pos) { for (variant, model) in selected { format!("{variant:?}").hash(&mut hash); model.ambient_occlusion.hash(&mut hash); diff --git a/crates/horizon-client/examples/resource_memory.rs b/crates/horizon-client/examples/resource_memory.rs index 6deb5a9d4..ec5b15ce7 100644 --- a/crates/horizon-client/examples/resource_memory.rs +++ b/crates/horizon-client/examples/resource_memory.rs @@ -94,12 +94,13 @@ fn main() -> Result<()> { drop(registry); step("registry dropped"); let assets = Assets::load(&root)?; + let render = assets.reload(&root)?; step("assets"); println!( " sprites: {} layers of {}px, {:.0} MB of pixels", - assets.texture_layers, - assets.sprite_size, - assets.pixels.len() as f64 / MB + render.texture_layers, + render.sprite_size, + render.pixels.len() as f64 / MB ); // The game decodes gameplay facts once for both tables (BlockFacts::load_pair). let (facts, behaviours) = BlockFacts::load_pair(&root, assets.registry)?; @@ -114,6 +115,7 @@ fn main() -> Result<()> { step("light tables"); let tables = MeshTables::new( &assets, + &render, &facts, models::load_visibility(&root, assets.registry)?, )?; diff --git a/crates/horizon-client/examples/scene_collision_probe.rs b/crates/horizon-client/examples/scene_collision_probe.rs index c1a1e77ad..ec20eee74 100644 --- a/crates/horizon-client/examples/scene_collision_probe.rs +++ b/crates/horizon-client/examples/scene_collision_probe.rs @@ -40,7 +40,8 @@ fn main() -> Result<()> { return Err("radius must be 1..16".into()); } let assets = assets::Assets::load(&resources)?; - let world = world::World::test_scene(&assets, radius)?; + let render = assets.reload(&resources)?; + let world = world::World::test_scene(&assets, &render, radius)?; let binding = collisions::load(&resources, assets.registry)?; let mut scene = collisions::SceneCollisions { world: &world, @@ -50,7 +51,7 @@ fn main() -> Result<()> { fs::write( dir.join("scene.json"), serde_json::to_vec(&serde_json::json!({ - "radius":radius,"resident_chunks":world.chunks.len(),"model_gallery":assets.model_gallery, + "radius":radius,"resident_chunks":world.chunks.len(),"model_gallery":render.model_gallery, }))?, )?; let mut output = std::io::BufWriter::new(fs::File::create(dir.join("rust.txt"))?); diff --git a/crates/horizon-client/examples/scene_motion_probe.rs b/crates/horizon-client/examples/scene_motion_probe.rs index 6caa51463..f4ff07ebf 100644 --- a/crates/horizon-client/examples/scene_motion_probe.rs +++ b/crates/horizon-client/examples/scene_motion_probe.rs @@ -243,13 +243,14 @@ fn main() -> Result<()> { let root = PathBuf::from(&args[0]); let dir = PathBuf::from(&args[1]); let assets = Assets::load(&root)?; - let mut scene = World::test_scene(&assets, 1)?; + let render = assets.reload(&root)?; + let mut scene = World::test_scene(&assets, &render, 1)?; let binding = collisions::load(&root, assets.registry)?; let resources = MotionResources::load(&root, &assets)?; fs::write( dir.join("scene.json"), serde_json::to_vec( - &serde_json::json!({"radius":1,"resident_chunks":scene.chunks.len(),"model_gallery":assets.model_gallery}), + &serde_json::json!({"radius":1,"resident_chunks":scene.chunks.len(),"model_gallery":render.model_gallery}), )?, )?; if args[2] == "--describe" { diff --git a/crates/horizon-client/examples/section_mesh_fixture.rs b/crates/horizon-client/examples/section_mesh_fixture.rs index 6359f32d0..8703e906e 100644 --- a/crates/horizon-client/examples/section_mesh_fixture.rs +++ b/crates/horizon-client/examples/section_mesh_fixture.rs @@ -3,7 +3,7 @@ //! the oracle's canonical form (vanilla ARGB colours and packed light coords). #![forbid(unsafe_code)] use horizon_client::{ - assets::Assets, + assets::{Assets, RenderAssets}, biome::{BiomeInfo, Biomes, GrassModifier}, blocks::BlockFacts, chunk::{Chunk, Light, MIN_Y, index}, @@ -48,6 +48,7 @@ fn chunk_index(x: i32, z: i32) -> Result { fn scene( row: &Value, assets: &Assets, + render: &RenderAssets, tables: &MeshTables, biomes: &mut Biomes, pristine: &[BiomeInfo], @@ -127,6 +128,7 @@ fn scene( let mut mesher = Mesher { nether_shading: row["nether"].as_bool().unwrap_or(false), assets, + render, tables, biomes: &*biomes, visibility: tables.visibility.clone(), @@ -184,11 +186,12 @@ fn main() -> Result<()> { } let root = PathBuf::from(&args[0]); let assets = Assets::load(&root)?; + let render = assets.reload(&root)?; let facts = BlockFacts::load(&root, assets.registry)?; let mut biomes = Biomes::load(&root)?; let visibility = models::load_visibility(&root, assets.registry)?; - let tables = MeshTables::new(&assets, &facts, visibility)?; - let names: BTreeMap = assets + let tables = MeshTables::new(&assets, &render, &facts, visibility)?; + let names: BTreeMap = render .sprite_layers .iter() .map(|(name, layer)| (*layer, name.as_str())) @@ -222,6 +225,7 @@ fn main() -> Result<()> { let result = scene( &row, &assets, + &render, &tables, &mut biomes, &pristine, diff --git a/crates/horizon-client/examples/streaming_bench.rs b/crates/horizon-client/examples/streaming_bench.rs index f99c594bb..9f8e99899 100644 --- a/crates/horizon-client/examples/streaming_bench.rs +++ b/crates/horizon-client/examples/streaming_bench.rs @@ -144,10 +144,12 @@ fn main() -> Result<()> { let hz = flag("--hz", 240.0); let assets = Arc::new(Assets::load(&root)?); + let render = Arc::new(assets.reload(&root)?); let facts = BlockFacts::load(&root, assets.registry)?; let biomes = Arc::new(Biomes::load(&root)?); let tables = Arc::new(MeshTables::new( &assets, + &render, &facts, models::load_visibility(&root, assets.registry)?, )?); @@ -160,6 +162,7 @@ fn main() -> Result<()> { )?); let context = Arc::new(WorkerContext { assets, + render: render.clone(), tables, biomes, light, diff --git a/crates/horizon-client/src/assets.rs b/crates/horizon-client/src/assets.rs index f278740f5..2887c9afd 100644 --- a/crates/horizon-client/src/assets.rs +++ b/crates/horizon-client/src/assets.rs @@ -49,11 +49,20 @@ impl TerrainBlockStates for Properties { self.0[id.0 as usize] } } +/// The block registry and the facts read from `facts.json` and the block tags: +/// everything world generation and collisions need, with none of the block +/// models or baked sprites. pub struct Assets { /// Leaked once per process: shared by world generation threads. pub registry: &'static BlockRegistry, pub properties: Properties, pub material_states: [BlockStateId; 6], + /// Block names in `#minecraft:blocks_fluid_flow` (fluid flow vectors). + pub blocks_fluid_flow: BTreeSet, +} +/// The block models and their baked sprites, read from the pack at `root` over +/// an existing block registry: everything the mesher and renderer need. +pub struct RenderAssets { pub sprite_size: u32, pub sprite_minimum_size: u32, pub pixels: Vec, @@ -68,8 +77,6 @@ pub struct Assets { pub translucent_layers: Vec, /// Each layer's `MipmapGenerator` settings. pub sprite_mips: Vec, - /// Block names in `#minecraft:blocks_fluid_flow` (fluid flow vectors). - pub blocks_fluid_flow: BTreeSet, } fn invalid(message: &str) -> io::Error { io::Error::new(io::ErrorKind::InvalidData, message) @@ -193,33 +200,23 @@ impl Assets { // past vanilla's 16-bit global palette. crate::chunk::set_block_states(registry.len()); let registry: &'static BlockRegistry = Box::leak(Box::new(registry)); - Self::with_models( - root, + Ok(Self { registry, properties, material_states, blocks_fluid_flow, - ) + }) } - /// The same blocks with the models and sprites of another resource root + /// The models and sprites of another resource root over these blocks /// (resource packs changed): the registry and block facts come from the /// game data, which resource packs do not touch. - pub fn reload(&self, root: &Path) -> Result { - Self::with_models( - root, - self.registry, - self.properties.clone(), - self.material_states, - self.blocks_fluid_flow.clone(), - ) + pub fn reload(&self, root: &Path) -> Result { + RenderAssets::load(root, self) } - fn with_models( - root: &Path, - registry: &'static BlockRegistry, - properties: Properties, - material_states: [BlockStateId; 6], - blocks_fluid_flow: BTreeSet, - ) -> Result { +} +impl RenderAssets { + pub fn load(root: &Path, assets: &Assets) -> Result { + let registry = assets.registry; let mut sprites = crate::sprites::Sprites::default(); for name in MATERIALS { sprites.insert(root, &format!("minecraft:block/{name}"))?; @@ -243,9 +240,6 @@ impl Assets { } sprites.finish(); Ok(Self { - registry, - properties, - material_states, sprite_size: sprites.size, sprite_minimum_size: sprites.minimum_size, texture_layers: u32::try_from(sprites.count())?, @@ -258,7 +252,6 @@ impl Assets { sprite_layers: sprites.layers, translucent_layers: sprites.translucent, sprite_mips: sprites.mips, - blocks_fluid_flow, }) } } diff --git a/crates/horizon-client/src/entities.rs b/crates/horizon-client/src/entities.rs index 3fa6e68a1..c9ede2379 100644 --- a/crates/horizon-client/src/entities.rs +++ b/crates/horizon-client/src/entities.rs @@ -597,9 +597,10 @@ mod fire_environment_tests { return; } let assets = crate::assets::Assets::load(&root).unwrap(); + let render = assets.reload(&root).unwrap(); let facts = BlockFacts::load(&root, assets.registry).unwrap(); let items = crate::items::Items::load(&root, assets.registry, &facts).unwrap(); - let mut world = World::test_scene(&assets, 3).unwrap(); + let mut world = World::test_scene(&assets, &render, 3).unwrap(); let at = Vec3::new(20.5, 4.0, 20.5); world .set( diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 0ae271301..b3ca99d99 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -145,7 +145,7 @@ mod wither; mod zombie_villagers; use horizon_client::{ Result, - assets::Assets, + assets::{Assets, RenderAssets}, audio::Audio, biome::Biomes, blocks::{BlockFacts, Fluid}, @@ -717,6 +717,7 @@ impl UiResources { #[derive(Clone)] pub struct PackResources { assets: Arc, + render: Arc, context: Arc, layer_names: Arc>, /// Item definitions, baked item models and special renderers. @@ -728,23 +729,25 @@ pub struct PackResources { forcefield: Arc<(u32, u32, Vec)>, } impl PackResources { - /// Everything a pack overlay at `root` provides, over `assets` loaded from it. + /// Everything a pack overlay at `root` provides, over `assets` and `render` + /// loaded from it. fn load( root: &std::path::Path, assets: Arc, + render: Arc, facts: &BlockFacts, biomes: Arc, light: Arc, ) -> Result { let visibility = models::load_visibility(root, assets.registry)?; - let tables = Arc::new(MeshTables::new(&assets, facts, visibility)?); + let tables = Arc::new(MeshTables::new(&assets, &render, facts, visibility)?); let item_renderer = horizon_client::item_render::ItemRenderer::load_with_library( root, - assets.model_library.clone(), + render.model_library.clone(), )?; Ok(Self { layer_names: Arc::new( - assets + render .sprite_layers .iter() .map(|(name, layer)| (*layer, name.trim_start_matches("minecraft:").to_owned())) @@ -752,11 +755,13 @@ impl PackResources { ), context: Arc::new(WorkerContext { assets: assets.clone(), + render: render.clone(), tables, biomes, light, }), assets, + render, item_renderer: Arc::new(item_renderer), names: Arc::new(Names::load(root)), clouds: Arc::new(load_clouds(root)), @@ -1466,7 +1471,7 @@ impl Game<'_> { fn particle_sprite(&self, state: BlockStateId) -> Option<(String, u32)> { let models = self .pack - .assets + .render .model_catalog .collect(state, horizon_core::position::BlockPos::new(0, 0, 0)) .ok()?; @@ -5795,7 +5800,7 @@ impl Game<'_> { == horizon_client::blocks::RenderShape::Model && let Ok(models) = self .pack - .assets + .render .model_catalog .collect(state, BlockPos::new(m.pos[0], m.pos[1], m.pos[2])) { @@ -8582,7 +8587,7 @@ impl Game<'_> { let f = self.res.facts.get(state); outline_after_terrain = self .pack - .assets + .render .model_catalog .collect(state, BlockPos::new(h.pos[0], h.pos[1], h.pos[2])) .is_ok_and(|models| { @@ -10388,15 +10393,20 @@ fn load_resources( on_stage: &(dyn Fn(u32) + Sync), ) -> Result { let mut pack_error = None; - let assets = match Assets::load(&root) { - Ok(assets) => assets, + let (assets, render) = match Assets::load(&root).and_then(|assets| { + let render = assets.reload(&root)?; + Ok((assets, render)) + }) { + Ok(bundle) => bundle, // Minecraft.rollbackResourcePacks: the packs break loading, start // with the game's own resources. Err(e) if root != vanilla_root => { log::warn!("Horizon: resource packs failed to load ({e}); using the default resources"); pack_error = Some(e.to_string()); root = vanilla_root.to_path_buf(); - Assets::load(vanilla_root)? + let assets = Assets::load(vanilla_root)?; + let render = assets.reload(vanilla_root)?; + (assets, render) } Err(e) => { return Err(format!( @@ -10406,6 +10416,7 @@ fn load_resources( } }; let assets = Arc::new(assets); + let render = Arc::new(render); log::info!("load assets: {:.2}s", started.elapsed().as_secs_f32()); on_stage(0); let behaviour_json: serde_json::Value = serde_json::from_reader(std::io::BufReader::new( @@ -10427,7 +10438,7 @@ fn load_resources( log::info!("load biomes+env: {:.2}s", started.elapsed().as_secs_f32()); on_stage(3); let light = Arc::new(LightTables::load(&root, assets.registry, &facts)?); - let pack = PackResources::load(&root, assets.clone(), &facts, biomes.clone(), light)?; + let pack = PackResources::load(&root, assets.clone(), render, &facts, biomes.clone(), light)?; log::info!("load pack tables: {:.2}s", started.elapsed().as_secs_f32()); on_stage(4); let gui = UiResources::load(&root)?; @@ -10520,7 +10531,7 @@ fn build_renderer( gui: &UiResources, previous: Option<&Renderer>, ) -> Result { - let assets = &pack.assets; + let assets = &pack.render; let atlas = &gui.atlas; let mut renderer = pollster::block_on(Renderer::new( window, diff --git a/crates/horizon-client/src/game/minecarts.rs b/crates/horizon-client/src/game/minecarts.rs index f0cb2b2ad..8d87bb639 100644 --- a/crates/horizon-client/src/game/minecarts.rs +++ b/crates/horizon-client/src/game/minecarts.rs @@ -1148,7 +1148,7 @@ impl Game<'_> { diffuse: bool, out: &mut Vec, ) { - let Ok(models) = self.pack.assets.model_catalog.collect_seeded(state, seed) else { + let Ok(models) = self.pack.render.model_catalog.collect_seeded(state, seed) else { return; }; for (_, model) in &models { diff --git a/crates/horizon-client/src/game/packs.rs b/crates/horizon-client/src/game/packs.rs index 82b228669..ee026d467 100644 --- a/crates/horizon-client/src/game/packs.rs +++ b/crates/horizon-client/src/game/packs.rs @@ -119,7 +119,7 @@ impl Game<'_> { } } fn reload_resources(&mut self, root: &Path) -> horizon_client::Result<()> { - let assets = std::sync::Arc::new(self.pack.assets.reload(root)?); + let render = std::sync::Arc::new(self.pack.assets.reload(root)?); let mut atlas = HudAtlas::build(root)?; atlas.font.uniform = self.settings.force_unicode; atlas.font.japanese = self.settings.japanese_glyphs; @@ -129,7 +129,8 @@ impl Game<'_> { }; let pack = super::PackResources::load( root, - assets, + self.pack.assets.clone(), + render, &self.res.facts, self.pack.context.biomes.clone(), self.pack.context.light.clone(), diff --git a/crates/horizon-client/src/game/tnt.rs b/crates/horizon-client/src/game/tnt.rs index 5fe87fce3..f488d7a8b 100644 --- a/crates/horizon-client/src/game/tnt.rs +++ b/crates/horizon-client/src/game/tnt.rs @@ -216,7 +216,7 @@ impl Game<'_> { // Face sprites from the block model: up, down, north, south, west, east. let Ok(models) = self .pack - .assets + .render .model_catalog .collect(state, BlockPos::new(0, 0, 0)) else { @@ -467,9 +467,10 @@ mod tests { return; } let assets = horizon_client::assets::Assets::load(&root).unwrap(); + let render = assets.reload(&root).unwrap(); let facts = horizon_client::blocks::BlockFacts::load(&root, assets.registry).unwrap(); let collision = horizon_client::collisions::load(&root, assets.registry).unwrap(); - let mut world = horizon_client::world::World::test_scene(&assets, 3).unwrap(); + let mut world = horizon_client::world::World::test_scene(&assets, &render, 3).unwrap(); let stone = assets.registry.default_state("minecraft:stone").unwrap(); let water = assets.registry.default_state("minecraft:water").unwrap(); let mut state = assets.registry.state(water).unwrap().clone(); diff --git a/crates/horizon-client/src/mesher.rs b/crates/horizon-client/src/mesher.rs index c3990f598..543a8895a 100644 --- a/crates/horizon-client/src/mesher.rs +++ b/crates/horizon-client/src/mesher.rs @@ -7,7 +7,7 @@ mod facing; mod fluid; mod lighting; use crate::{ - assets::Assets, + assets::{Assets, RenderAssets}, biome::Biomes, blocks::{BlockFacts, RenderShape}, chunk::{Chunk, MIN_Y}, @@ -258,18 +258,19 @@ fn redstone_color(power: u8) -> u32 { impl MeshTables { pub fn new( assets: &Assets, + render: &RenderAssets, facts: &BlockFacts, visibility: FaceVisibility, ) -> crate::Result { // Terrain vertices keep the sprite layer below `OPAQUE_LAYER`. - let layers = assets.sprite_layers.values().max().map_or(0, |l| l + 1); + let layers = render.sprite_layers.values().max().map_or(0, |l| l + 1); if layers > u32::from(OPAQUE_LAYER) { return Err( format!("{layers} block sprites, terrain vertices index {OPAQUE_LAYER}").into(), ); } let layer = |name: &str| -> crate::Result { - assets + render .sprite_layers .get(name) .map(|&l| l as u16) @@ -594,6 +595,7 @@ pub struct Mesher<'a> { /// CardinalLighting.NETHER: brighter up/down faces. pub nether_shading: bool, pub assets: &'a Assets, + pub render: &'a RenderAssets, pub tables: &'a MeshTables, pub biomes: &'a Biomes, pub visibility: FaceVisibility, @@ -663,7 +665,7 @@ impl Mesher<'_> { continue; } let world = BlockPos::new(center.x * 16 + x, base_y + y, center.z * 16 + z); - let Ok(models) = self.assets.model_catalog.collect(BlockStateId(id), world) + let Ok(models) = self.render.model_catalog.collect(BlockStateId(id), world) else { continue; }; diff --git a/crates/horizon-client/src/mesher/leaf_culling_tests.rs b/crates/horizon-client/src/mesher/leaf_culling_tests.rs index 9369a1ba2..679b19090 100644 --- a/crates/horizon-client/src/mesher/leaf_culling_tests.rs +++ b/crates/horizon-client/src/mesher/leaf_culling_tests.rs @@ -9,9 +9,10 @@ fn leaf_culling_removes_only_internal_leaf_and_root_faces() { return; } let assets = Assets::load(&root).unwrap(); + let render = assets.reload(&root).unwrap(); let facts = BlockFacts::load(&root, assets.registry).unwrap(); let visibility = crate::models::load_visibility(&root, assets.registry).unwrap(); - let tables = MeshTables::new(&assets, &facts, visibility.clone()).unwrap(); + let tables = MeshTables::new(&assets, &render, &facts, visibility.clone()).unwrap(); let biomes = Biomes::load(&root).unwrap(); let state = |name| assets.registry.default_state(name).unwrap().0; let oak = state("minecraft:oak_leaves"); @@ -31,6 +32,7 @@ fn leaf_culling_removes_only_internal_leaf_and_root_faces() { Mesher { nether_shading: false, assets: &assets, + render: &render, tables: &tables, biomes: &biomes, visibility: visibility.clone(), @@ -49,7 +51,7 @@ fn leaf_culling_removes_only_internal_leaf_and_root_faces() { // preserving every other quad and its full vertex attributes. let without_face = |at: [i32; 3], id, direction| { let vertices = mesh(&[(at, id)], false, true); - let models = assets + let models = render .model_catalog .collect(BlockStateId(id), BlockPos::new(at[0], at[1], at[2])) .unwrap(); diff --git a/crates/horizon-client/src/motion.rs b/crates/horizon-client/src/motion.rs index 0eb79d65c..44d94d857 100644 --- a/crates/horizon-client/src/motion.rs +++ b/crates/horizon-client/src/motion.rs @@ -2042,9 +2042,10 @@ mod tests { return; } let assets = Assets::load(&root).unwrap(); + let render = assets.reload(&root).unwrap(); let binding = crate::collisions::load(&root, assets.registry).unwrap(); let resources = MotionResources::load(&root, &assets).unwrap(); - let mut scene = World::test_scene(&assets, 1).unwrap(); + let mut scene = World::test_scene(&assets, &render, 1).unwrap(); let entities = [Aabb::new( Vec3::new(10.0, 80.0, 10.0), Vec3::new(14.0, 84.0, 14.0), @@ -2112,10 +2113,11 @@ mod tests { return; } let assets = Assets::load(&root).unwrap(); + let render = assets.reload(&root).unwrap(); let binding = crate::collisions::load(&root, assets.registry).unwrap(); let resources = MotionResources::load(&root, &assets).unwrap(); let run = |name: &str, spectator: bool| { - let mut scene = World::test_scene(&assets, 2).unwrap(); + let mut scene = World::test_scene(&assets, &render, 2).unwrap(); let state = assets.registry.default_state(name).unwrap(); for x in 19..=23 { for y in 10..=17 { @@ -2293,10 +2295,11 @@ mod tests { return; } let assets = Assets::load(&root).unwrap(); + let render = assets.reload(&root).unwrap(); let binding = crate::collisions::load(&root, assets.registry).unwrap(); let resources = MotionResources::load(&root, &assets).unwrap(); for wet in [false, true] { - let mut scene = World::test_scene(&assets, 2).unwrap(); + let mut scene = World::test_scene(&assets, &render, 2).unwrap(); if wet { let water = assets.registry.default_state("minecraft:water").unwrap(); for x in 19..=21 { @@ -2334,9 +2337,10 @@ mod tests { return; } let assets = Assets::load(&root).unwrap(); + let render = assets.reload(&root).unwrap(); let binding = crate::collisions::load(&root, assets.registry).unwrap(); let resources = MotionResources::load(&root, &assets).unwrap(); - let mut scene = World::test_scene(&assets, 3).unwrap(); + let mut scene = World::test_scene(&assets, &render, 3).unwrap(); let mut player = PlayerMotion::new(&resources, Vec3::new(20.5, 4.0, 20.5)).unwrap(); let water = assets.registry.default_state("minecraft:water").unwrap(); for x in 19..=21 { @@ -2556,9 +2560,10 @@ mod tests { return; } let assets = Assets::load(&root).unwrap(); + let render = assets.reload(&root).unwrap(); let binding = crate::collisions::load(&root, assets.registry).unwrap(); let resources = MotionResources::load(&root, &assets).unwrap(); - let mut scene = World::test_scene(&assets, 3).unwrap(); + let mut scene = World::test_scene(&assets, &render, 3).unwrap(); let water = assets.registry.default_state("minecraft:water").unwrap(); for y in 4..=6 { scene.set(20, y, 20, water).unwrap(); @@ -2628,10 +2633,11 @@ mod tests { return; } let assets = Assets::load(&root).unwrap(); + let render = assets.reload(&root).unwrap(); let binding = crate::collisions::load(&root, assets.registry).unwrap(); let resources = MotionResources::load(&root, &assets).unwrap(); for name in ["minecraft:lava", "minecraft:water"] { - let mut scene = World::test_scene(&assets, 3).unwrap(); + let mut scene = World::test_scene(&assets, &render, 3).unwrap(); let fluid = assets.registry.default_state(name).unwrap(); scene.set(20, 4, 20, fluid).unwrap(); let mut player = PlayerMotion::new(&resources, Vec3::new(20.5, 4.0, 20.5)).unwrap(); @@ -2679,9 +2685,10 @@ mod tests { return; } let assets = Assets::load(&root).unwrap(); + let render = assets.reload(&root).unwrap(); let binding = crate::collisions::load(&root, assets.registry).unwrap(); let resources = MotionResources::load(&root, &assets).unwrap(); - let mut scene = World::test_scene(&assets, 3).unwrap(); + let mut scene = World::test_scene(&assets, &render, 3).unwrap(); let water = assets.registry.default_state("minecraft:water").unwrap(); scene.set(20, 4, 20, water).unwrap(); scene.set(20, 5, 20, water).unwrap(); @@ -2748,10 +2755,11 @@ mod tests { return; } let assets = Assets::load(&root).unwrap(); + let render = assets.reload(&root).unwrap(); let binding = crate::collisions::load(&root, assets.registry).unwrap(); let resources = MotionResources::load(&root, &assets).unwrap(); for (water_level, lava_level, ground_jump) in [(0, 6, true), (6, 0, false)] { - let mut scene = World::test_scene(&assets, 3).unwrap(); + let mut scene = World::test_scene(&assets, &render, 3).unwrap(); for (name, level, x) in [ ("minecraft:water", water_level, 20), ("minecraft:lava", lava_level, 21), @@ -2796,7 +2804,8 @@ mod tests { return; } let assets = Assets::load(&root).unwrap(); - let mut scene = World::test_scene(&assets, 3).unwrap(); + let render = assets.reload(&root).unwrap(); + let mut scene = World::test_scene(&assets, &render, 3).unwrap(); let binding = crate::collisions::load(&root, assets.registry).unwrap(); let resources = MotionResources::load(&root, &assets).unwrap(); let mut player = PlayerMotion::new(&resources, Vec3::new(20.5, 4.0, 20.5)).unwrap(); diff --git a/crates/horizon-client/src/streaming.rs b/crates/horizon-client/src/streaming.rs index 38fa33c7d..78f13e9ce 100644 --- a/crates/horizon-client/src/streaming.rs +++ b/crates/horizon-client/src/streaming.rs @@ -333,6 +333,7 @@ impl GenerationScan { } pub struct WorkerContext { pub assets: Arc, + pub render: Arc, pub tables: Arc, pub biomes: Arc, pub light: Arc, @@ -422,6 +423,7 @@ impl Streaming { cutout_leaves: settings.cutout_leaves, cull_leaves: settings.cull_leaves, assets: &context.assets, + render: &context.render, tables: &context.tables, biomes: &context.biomes, visibility, diff --git a/crates/horizon-client/src/world.rs b/crates/horizon-client/src/world.rs index 05b89234c..698e0c92c 100644 --- a/crates/horizon-client/src/world.rs +++ b/crates/horizon-client/src/world.rs @@ -137,7 +137,11 @@ impl World { } /// A controlled blockstate scene for the native scene probes: material /// layers, a stepped pyramid and the model gallery. Not generated terrain. - pub fn test_scene(assets: &crate::assets::Assets, radius: i32) -> crate::Result { + pub fn test_scene( + assets: &crate::assets::Assets, + render: &crate::assets::RenderAssets, + radius: i32, + ) -> crate::Result { let air = assets .registry .default_state("minecraft:air") @@ -182,7 +186,7 @@ impl World { } } } - for (position, state) in &assets.model_placements { + for (position, state) in &render.model_placements { world.set(position.x, position.y, position.z, *state)?; } world.revision = 0; diff --git a/crates/horizon-client/tests/generation_saves.rs b/crates/horizon-client/tests/generation_saves.rs index 26da11efe..ce91a1096 100644 --- a/crates/horizon-client/tests/generation_saves.rs +++ b/crates/horizon-client/tests/generation_saves.rs @@ -170,13 +170,15 @@ fn chunks_left_behind_keep_their_decoration() { return; }; let assets = Arc::new(Assets::load(&root).unwrap()); + let render = Arc::new(assets.reload(&root).unwrap()); let facts = BlockFacts::load(&root, assets.registry).unwrap(); let visibility = models::load_visibility(&root, assets.registry).unwrap(); let context = Arc::new(WorkerContext { - tables: Arc::new(MeshTables::new(&assets, &facts, visibility).unwrap()), + tables: Arc::new(MeshTables::new(&assets, &render, &facts, visibility).unwrap()), light: Arc::new(LightTables::load(&root, assets.registry, &facts).unwrap()), biomes: Arc::new(Biomes::load(&root).unwrap()), assets, + render: render.clone(), }); let generator = Arc::new(Recorder::default()); let mut session = Session::new(generator.clone(), context.clone()); diff --git a/crates/horizon-client/tests/streaming_meshes.rs b/crates/horizon-client/tests/streaming_meshes.rs index 6804d197e..220dbb6b8 100644 --- a/crates/horizon-client/tests/streaming_meshes.rs +++ b/crates/horizon-client/tests/streaming_meshes.rs @@ -55,13 +55,15 @@ fn columns_loaded_past_the_render_distance_mesh_when_they_come_in_range() { return; }; let assets = Arc::new(Assets::load(&root).unwrap()); + let render = Arc::new(assets.reload(&root).unwrap()); let facts = BlockFacts::load(&root, assets.registry).unwrap(); let visibility = models::load_visibility(&root, assets.registry).unwrap(); let context = Arc::new(WorkerContext { - tables: Arc::new(MeshTables::new(&assets, &facts, visibility).unwrap()), + tables: Arc::new(MeshTables::new(&assets, &render, &facts, visibility).unwrap()), light: Arc::new(LightTables::load(&root, assets.registry, &facts).unwrap()), biomes: Arc::new(Biomes::load(&root).unwrap()), assets, + render: render.clone(), }); let mut streaming = Streaming::new(Arc::new(Saved), context, 3); streaming.radius = 4; @@ -135,13 +137,15 @@ fn relit_columns_keep_every_mesh_current() { return; }; let assets = Arc::new(Assets::load(&root).unwrap()); + let render = Arc::new(assets.reload(&root).unwrap()); let facts = BlockFacts::load(&root, assets.registry).unwrap(); let visibility = models::load_visibility(&root, assets.registry).unwrap(); let context = Arc::new(WorkerContext { - tables: Arc::new(MeshTables::new(&assets, &facts, visibility).unwrap()), + tables: Arc::new(MeshTables::new(&assets, &render, &facts, visibility).unwrap()), light: Arc::new(LightTables::load(&root, assets.registry, &facts).unwrap()), biomes: Arc::new(Biomes::load(&root).unwrap()), assets: assets.clone(), + render: render.clone(), }); let state = |name: &str| assets.registry.default_state(name).unwrap().0; let (stone, glowstone, torch) = ( @@ -210,6 +214,7 @@ fn relit_columns_keep_every_mesh_current() { cutout_leaves: true, cull_leaves: false, assets: &context.assets, + render: &context.render, tables: &context.tables, biomes: &context.biomes, visibility: context.tables.visibility.clone(), From a2f8952d05484387833d693de8b78a61d7f0697a Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 23:13:16 +0200 Subject: [PATCH 016/163] Compression: flate2's zlib-rs backend instead of miniz_oxide Halves the CPU of deflating a chunk column and makes small packets about 20 % cheaper. The compressed bytes change; what they inflate to doesn't. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/Cargo.toml | 2 +- crates/horizon-protocol/Cargo.toml | 2 +- crates/horizon-world/Cargo.toml | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/crates/horizon-client/Cargo.toml b/crates/horizon-client/Cargo.toml index 29a02553f..ffccb88e8 100644 --- a/crates/horizon-client/Cargo.toml +++ b/crates/horizon-client/Cargo.toml @@ -37,7 +37,7 @@ miniz_oxide = "0.8" ab_glyph = "0.2.32" log = "0.4" chrono = { version = "0.4.42", default-features = false, features = ["clock", "std"] } -flate2 = { version = "1.1.10", default-features = false, features = ["rust_backend"] } +flate2 = { version = "1.1.10", default-features = false, features = ["zlib-rs", "runtime_detection"] } horizon-theme = { path = "../horizon-theme" } # Opt-in data collection: the game keeps, the launcher sends (docs/telemetry.md). horizon-telemetry = { path = "../horizon-telemetry", default-features = false } diff --git a/crates/horizon-protocol/Cargo.toml b/crates/horizon-protocol/Cargo.toml index fad282080..aa1f60f89 100644 --- a/crates/horizon-protocol/Cargo.toml +++ b/crates/horizon-protocol/Cargo.toml @@ -8,7 +8,7 @@ description = "Horizon's Minecraft Java Edition 26.3 network protocol (version 7 [dependencies] horizon-world = { path = "../horizon-world" } -flate2 = { version = "1.1.10", default-features = false, features = ["rust_backend"] } +flate2 = { version = "1.1.10", default-features = false, features = ["zlib-rs", "runtime_detection"] } serde_json = "1.0.151" # The shared secret and RSA padding (OS randomness) and the server hash. getrandom = "0.3" diff --git a/crates/horizon-world/Cargo.toml b/crates/horizon-world/Cargo.toml index 737edd289..3a8621243 100644 --- a/crates/horizon-world/Cargo.toml +++ b/crates/horizon-world/Cargo.toml @@ -13,7 +13,7 @@ serde = { version = "1", features = ["derive"] } sha2 = "0.10" postcard = { version = "=1.1.3", default-features = false, features = ["alloc"] } horizon-core = { path = "../horizon-core" } -flate2 = { version = "1.1.10", default-features = false, features = ["rust_backend"] } +flate2 = { version = "1.1.10", default-features = false, features = ["zlib-rs", "runtime_detection"] } lz4_flex = { version = "0.14", default-features = false, features = ["std", "safe-encode", "safe-decode", "checked-decode"] } xxhash-rust = { version = "0.8.19", features = ["xxh32"] } From c4cc7954cecbee7639f11f7a0b21d383311d948d Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sat, 17 Oct 2026 22:29:59 +0100 Subject: [PATCH 017/163] Portal scans: keep per-chunk section masks across ticks The nether-portal section precheck from #661 answered "does this section's palette hold a portal?" per section, per tick. Keep the answer per resident chunk in `portal_sections`, keyed by a weak handle: an edit or a chunk replacement rebuilds it, and it is dropped when a chunk unloads and cleared when the block facts change, so a portal block always forces the sweep. The entity sweep now finds portal blocks without the per-tick map. This is a scan microbenchmark, not a whole-game claim: steady improves 2.4x to 17x over the fixtures and the run parity-checks the cached and per-tick answers. Rescanning every chunk every tick (cold, reload, edit_all) is slower because a miss reads all 24 sections of a chunk; see docs/portal-scan-benchmark.md. --- .../examples/portal_scan_bench.rs | 263 ++++++++++++++++++ crates/horizon-client/src/game.rs | 1 + .../horizon-client/src/game/nether_portal.rs | 38 +-- crates/horizon-client/src/game/packs.rs | 1 + crates/horizon-client/src/lib.rs | 1 + crates/horizon-client/src/portal_sections.rs | 123 ++++++++ docs/portal-scan-benchmark.md | 81 ++++++ 7 files changed, 490 insertions(+), 18 deletions(-) create mode 100644 crates/horizon-client/examples/portal_scan_bench.rs create mode 100644 crates/horizon-client/src/portal_sections.rs create mode 100644 docs/portal-scan-benchmark.md diff --git a/crates/horizon-client/examples/portal_scan_bench.rs b/crates/horizon-client/examples/portal_scan_bench.rs new file mode 100644 index 000000000..158b6a440 --- /dev/null +++ b/crates/horizon-client/examples/portal_scan_bench.rs @@ -0,0 +1,263 @@ +//! The `entity_portals` section scan only: `may_hold_portal` over synthetic +//! entity reaches, with the per-tick palette map against the resident cache. +//! Run with prepared client resources: +//! cargo run --profile fast -p horizon-client --example portal_scan_bench -- RESOURCES +use horizon_client::{ + blocks::BlockFacts, + chunk::{Chunk, MIN_Y, SECTIONS, Section}, + fast_hash::FxHashMap, + portal_sections::PortalSections, +}; +use horizon_core::{ + geometry::{Aabb, Vec3}, + position::BlockPos, +}; +use horizon_world::{level::Behaviours, registry::BlockStateId}; +use std::{hint::black_box, path::Path, sync::Arc, time::Instant}; + +/// `Game::swept_portal`'s reach (`Entity.checkInsideBlocks`'s swept box). +fn reach(from: Vec3, to: Vec3, width: f32, height: f32) -> Aabb { + let half = f64::from(width) / 2.0; + let bounds = Aabb::new( + Vec3::new(to.x - half, to.y, to.z - half), + Vec3::new(to.x + half, to.y + f64::from(height), to.z + half), + ) + .deflate(Vec3::new(1.0e-5, 1.0e-5, 1.0e-5)); + bounds + .union_bounds(bounds.move_by(from.subtract(to))) + .inflate(Vec3::new(1.0, 1.0, 1.0)) +} + +fn sections(reach: Aabb) -> (i64, i32, i32, i32, i32, i32, i32) { + let (min, max) = (reach.min_position(), reach.max_position()); + let (min, max) = (BlockPos::containing(min), BlockPos::containing(max)); + let top = SECTIONS as i32 - 1; + let (x0, x1) = (min.x >> 4, max.x >> 4); + let (z0, z1) = (min.z >> 4, max.z >> 4); + let (y0, y1) = ( + ((min.y - MIN_Y) >> 4).clamp(0, top), + ((max.y - MIN_Y) >> 4).clamp(0, top), + ); + let count = (i64::from(x1) - i64::from(x0) + 1) + * (i64::from(y1) - i64::from(y0) + 1) + * (i64::from(z1) - i64::from(z0) + 1); + (count, x0, x1, y0, y1, z0, z1) +} + +/// The original `Game::may_hold_portal`: per-tick `seen`, palette per section. +fn may_hold_portal_baseline( + reach: Aabb, + world: &FxHashMap<(i32, i32), Arc>, + seen: &mut FxHashMap<(i32, i32, i32), bool>, + behaviours: &Behaviours, +) -> bool { + let (count, x0, x1, y0, y1, z0, z1) = sections(reach); + if count > 64 { + return true; + } + (x0..=x1).any(|cx| { + (z0..=z1).any(|cz| { + (y0..=y1).any(|sy| { + *seen.entry((cx, sy, cz)).or_insert_with(|| { + world + .get(&(cx, cz)) + .and_then(|c| c.sections.get(sy as usize)) + .is_some_and(|s| { + s.blocks + .maybe_has(|v| behaviours.portal_axis(BlockStateId(v)).is_some()) + }) + }) + }) + }) + }) +} + +/// The cached `Game::may_hold_portal`: one mask per resident chunk. +fn may_hold_portal_cached( + reach: Aabb, + world: &FxHashMap<(i32, i32), Arc>, + cache: &mut PortalSections, + behaviours: &Behaviours, +) -> bool { + let (count, x0, x1, y0, y1, z0, z1) = sections(reach); + if count > 64 { + return true; + } + let mut y_mask = 0u32; + for sy in y0..=y1 { + y_mask |= 1 << sy; + } + (x0..=x1).any(|cx| { + (z0..=z1).any(|cz| { + world.get(&(cx, cz)).is_some_and(|chunk| { + cache.get((cx, cz), chunk, |v| { + behaviours.portal_axis(BlockStateId(v)).is_some() + }) & y_mask + != 0 + }) + }) + }) +} + +fn main() -> horizon_client::Result<()> { + let root = std::env::args() + .nth(1) + .ok_or("expected prepared client resource directory")?; + let start = Instant::now(); + let registry = horizon_world::level::data::load_registry(Path::new(&root))?; + let (facts, behaviours) = BlockFacts::load_pair(Path::new(&root), ®istry)?; + println!( + "resource_load_ms={:.3}", + start.elapsed().as_secs_f64() * 1000.0 + ); + let len = registry.len() as u32; + let portal: Vec = (0..len) + .filter(|&id| behaviours.portal_axis(BlockStateId(id)).is_some()) + .collect(); + let inactive_states: Vec = (0..len) + .filter(|&id| behaviours.portal_axis(BlockStateId(id)).is_none()) + .collect(); + let _ = &facts; + let portal_state = *portal + .first() + .ok_or("no nether portal block state in the registry")?; + println!("portal_states={}", portal.len()); + + // 500 entities spread over a 17x17 chunk world. Their reaches touch 1-4 + // sections, as an item or a mob standing in or stepping into a portal does. + let grid = 17; + let base = -(grid / 2) * 16; + let entities: Vec<(Vec3, Vec3, f32, f32)> = (0..500) + .map(|i| { + let x = base + (i % grid) * 16 + (i % 5); + let z = base + (i / grid % grid) * 16 + (i % 7); + let y = 64 + (i % 3) * 16; + let from = Vec3::new(f64::from(x), f64::from(y), f64::from(z)); + let to = from.add_vector(Vec3::new(0.1, 0.0, 0.07)); + (from, to, 0.25, 0.25) + }) + .collect(); + let reaches: Vec = entities + .iter() + .map(|&(from, to, w, h)| reach(from, to, w, h)) + .collect(); + + for (name, palette, portals_every) in [ + ("sparse", 1usize, 0usize), + ("dense", 128, 0), + ("global", 300, 0), + ("dense_portal", 128, 5), + ] { + let start = Instant::now(); + let mut world: FxHashMap<(i32, i32), Arc> = FxHashMap::default(); + for czi in 0..grid { + for cxi in 0..grid { + let (cx, cz) = (-(grid / 2) + cxi, -(grid / 2) + czi); + let mut chunk = Chunk::empty(cx, cz); + for (i, section) in chunk.sections.iter_mut().enumerate() { + let values: [u32; 4096] = std::array::from_fn(|j| { + if portals_every > 0 && i % portals_every == 0 && j == 0 { + portal_state + } else { + inactive_states[(j * 7 + i) % palette.min(inactive_states.len())] + } + }); + Arc::make_mut(section).blocks = Section::from_blocks(&values); + } + world.insert((cx, cz), Arc::new(chunk)); + } + } + println!( + "{name} fixture_ms={:.3}", + start.elapsed().as_secs_f64() * 1000.0 + ); + let keys: Vec<_> = world.keys().copied().collect(); + let portal_chunks: Vec<(i32, i32)> = keys + .iter() + .copied() + .filter(|&(cx, cz)| { + world[&(cx, cz)] + .sections + .iter() + .any(|s| s.blocks.maybe_has(|v| v == portal_state)) + }) + .collect(); + println!("{name} portal_chunks={}", portal_chunks.len()); + // The global palette's maybe_has walks the whole ID range, so rescanning + // every chunk each tick (cold/reload/edit_all) is intractable; those rows + // are only meaningful for the palettes whose scans are bounded. + let workloads: &[(&str, usize)] = if name == "global" { + &[("steady", 0), ("edit_1pct", 3)] + } else { + &[ + ("steady", 0), + ("cold", 0), + ("reload", 0), + ("edit_1pct", 3), + ("edit_all", 289), + ] + }; + for &(workload, changed) in workloads { + let mut baseline = Vec::new(); + let mut candidate = Vec::new(); + let mut cache = PortalSections::default(); + let (mut base_hits, mut cand_hits) = (0u64, 0u64); + for sample in 0..8 { + for cached in if sample % 2 == 0 { + [false, true] + } else { + [true, false] + } { + let start = Instant::now(); + let mut result = 0u64; + for tick in 0..300 { + if cached && workload == "cold" { + cache = PortalSections::default(); + } + if cached && workload == "reload" { + cache.clear(); + } + for key in keys.iter().take(changed) { + Arc::make_mut(world.get_mut(key).unwrap()).set( + 0, + MIN_Y, + 0, + inactive_states[tick % inactive_states.len()], + ); + } + let mut seen = FxHashMap::default(); + for reach in &reaches { + let hit = if cached { + may_hold_portal_cached(*reach, &world, &mut cache, &behaviours) + } else { + may_hold_portal_baseline(*reach, &world, &mut seen, &behaviours) + }; + result += hit as u64; + } + } + if cached { + cache = PortalSections::default(); + cand_hits += black_box(result); + } else { + base_hits += black_box(result); + } + if sample > 0 { + let us = start.elapsed().as_secs_f64() * 1e6 / 300.0; + if cached { + candidate.push(us); + } else { + baseline.push(us); + } + } + } + } + assert_eq!( + base_hits, cand_hits, + "{name} {workload}: cached may_hold_portal diverged" + ); + println!("{name} {workload} baseline_us={baseline:.3?} candidate_us={candidate:.3?}"); + } + } + println!("chunk_wrapper_bytes={}", std::mem::size_of::()); + Ok(()) +} diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index f13be4c84..26eaf4470 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -1815,6 +1815,7 @@ impl Game<'_> { } for &key in self.tick_chunks.removed() { self.random_tick_sections.remove(&key); + self.portals.sections.remove(&key); self.block_ticks .remove_chunk(horizon_core::position::ChunkPos::new(key.0, key.1)); } diff --git a/crates/horizon-client/src/game/nether_portal.rs b/crates/horizon-client/src/game/nether_portal.rs index 9ff9e8421..abfff5b53 100644 --- a/crates/horizon-client/src/game/nether_portal.rs +++ b/crates/horizon-client/src/game/nether_portal.rs @@ -65,6 +65,8 @@ pub(super) struct Portals { arrivals: Vec, loaded: bool, dirty: bool, + /// Per-chunk portal palette masks, kept across ticks (portal_sections). + pub(super) sections: horizon_client::portal_sections::PortalSections, } fn rotate_y(v: Vec3, degrees: f32) -> Vec3 { @@ -486,13 +488,14 @@ impl Game<'_> { .filter(|m| self.mob_can_use_portal(m)) .map(|m| (m.id, m.position, m.width(), m.height())) .collect(); - let mut portal_sections = horizon_client::fast_hash::FxHashMap::default(); + let mut portal_sections = std::mem::take(&mut self.portals.sections); for (id, to, width, height) in items.into_iter().chain(mobs) { let from = self.portals.before.get(&id).copied().unwrap_or(to); if let Some(pos) = self.swept_portal(from, to, width, height, &mut portal_sections) { inside.push((id, pos)); } } + self.portals.sections = portal_sections; for (id, pos) in inside { self.portals .entities @@ -509,7 +512,7 @@ impl Game<'_> { to: Vec3, width: f32, height: f32, - portal_sections: &mut horizon_client::fast_hash::FxHashMap<(i32, i32, i32), bool>, + portal_sections: &mut horizon_client::portal_sections::PortalSections, ) -> Option { let half = f64::from(width) / 2.0; let bounds = horizon_core::geometry::Aabb::new( @@ -550,12 +553,13 @@ impl Game<'_> { found } /// Whether a section `reach` touches has a nether portal state in its - /// palette: without one, no block there is a portal. Answers are kept - /// per section for the tick; a box over many sections is not checked. + /// palette: without one, no block there is a portal. Palette answers are + /// kept per chunk across ticks (`portal_sections`); a box over many + /// sections is not checked. fn may_hold_portal( &self, reach: horizon_core::geometry::Aabb, - seen: &mut horizon_client::fast_hash::FxHashMap<(i32, i32, i32), bool>, + sections: &mut horizon_client::portal_sections::PortalSections, ) -> bool { use horizon_client::chunk::{MIN_Y, SECTIONS}; let (min, max) = (reach.min_position(), reach.max_position()); @@ -576,23 +580,21 @@ impl Game<'_> { if count > 64 { return true; } + let mut y_mask = 0u32; + for sy in y0..=y1 { + y_mask |= 1 << sy; + } let behaviours = &self.res.behaviours; let chunks = &self.world.chunks; (x0..=x1).any(|cx| { (z0..=z1).any(|cz| { - (y0..=y1).any(|sy| { - *seen.entry((cx, sy, cz)).or_insert_with(|| { - chunks - .get(&(cx, cz)) - .and_then(|c| c.sections.get(sy as usize)) - .is_some_and(|s| { - s.blocks.maybe_has(|v| { - behaviours - .portal_axis(horizon_world::registry::BlockStateId(v)) - .is_some() - }) - }) - }) + chunks.get(&(cx, cz)).is_some_and(|chunk| { + sections.get((cx, cz), chunk, |v| { + behaviours + .portal_axis(horizon_world::registry::BlockStateId(v)) + .is_some() + }) & y_mask + != 0 }) }) }) diff --git a/crates/horizon-client/src/game/packs.rs b/crates/horizon-client/src/game/packs.rs index 0b95dd2ad..febafc932 100644 --- a/crates/horizon-client/src/game/packs.rs +++ b/crates/horizon-client/src/game/packs.rs @@ -154,6 +154,7 @@ impl Game<'_> { }; // Everything loaded: switch over. self.random_tick_sections.clear(); + self.portals.sections.clear(); self.options.resources = root.to_path_buf(); let context = pack.context.clone(); self.pack = pack; diff --git a/crates/horizon-client/src/lib.rs b/crates/horizon-client/src/lib.rs index 45e09a6a3..e652c8598 100644 --- a/crates/horizon-client/src/lib.rs +++ b/crates/horizon-client/src/lib.rs @@ -133,6 +133,7 @@ pub mod patrol; pub mod perf_overlay; pub mod pick_item; pub mod poi_sections; +pub mod portal_sections; pub mod pose; pub mod post; pub mod projectiles; diff --git a/crates/horizon-client/src/portal_sections.rs b/crates/horizon-client/src/portal_sections.rs new file mode 100644 index 000000000..f22cd2b83 --- /dev/null +++ b/crates/horizon-client/src/portal_sections.rs @@ -0,0 +1,123 @@ +//! Memoized nether-portal palette eligibility per resident chunk. +//! +//! `Game::find_entity_portals` asks the same sections every tick whether their +//! palette may hold a portal state. The answer only changes when a chunk's +//! blocks change, so it is kept per chunk until the weak handle stops matching. +use crate::{chunk::Chunk, fast_hash::FxHashMap}; +use std::sync::{Arc, Weak}; + +struct Cached { + chunk: Weak, + /// A bit per section, set when that section's palette may hold a portal. + sections: u32, +} + +/// Resident chunks are immutable behind `Arc`; edits use `Arc::make_mut`. +/// A weak reference detects both edits and replacement, without retaining block +/// data or forcing a deep copy on the next edit. It also prevents address reuse. +/// Clear this cache whenever the gameplay facts change (including resource reload). +#[derive(Default)] +pub struct PortalSections { + chunks: FxHashMap<(i32, i32), Cached>, +} + +impl PortalSections { + pub fn clear(&mut self) { + self.chunks.clear(); + } + pub fn remove(&mut self, key: &(i32, i32)) { + self.chunks.remove(key); + } + /// The sections of `chunk` whose palette may hold a portal, as a bitmask in + /// ascending section order (`MIN_Y` at bit 0). `portal` is only called while + /// (re)building an entry, so an unchanged chunk scans its palette once. + pub fn get( + &mut self, + key: (i32, i32), + chunk: &Arc, + mut portal: impl FnMut(u32) -> bool, + ) -> u32 { + const { + assert!(crate::chunk::SECTIONS <= u32::BITS as usize); + } + let cached = self.chunks.entry(key).or_insert_with(|| Cached { + chunk: Weak::new(), + sections: 0, + }); + if cached.chunk.as_ptr() != Arc::as_ptr(chunk) { + let mut mask = 0; + for (i, section) in chunk.sections.iter().enumerate() { + // Preserve maybe_has, including unused entries and global palettes. + if section.blocks.maybe_has(&mut portal) { + mask |= 1 << i; + } + } + cached.sections = mask; + cached.chunk = Arc::downgrade(chunk); + } + cached.sections + } +} + +#[cfg(test)] +mod tests { + use super::*; + use crate::chunk::{MIN_Y, SECTIONS, Section}; + + #[test] + fn edits_replacements_compaction_and_reload() { + let mut cache = PortalSections::default(); + let mut chunk = Arc::new(Chunk::empty(0, 0)); + assert_eq!(cache.get((0, 0), &chunk, |id| id == 7), 0); + cache.get((0, 0), &chunk, |_| panic!("unchanged chunk rescanned")); + let worker = chunk.clone(); + Arc::make_mut(&mut chunk).set(0, MIN_Y, 0, 7); + assert_eq!(cache.get((0, 0), &chunk, |id| id == 7), 1); + assert_eq!(worker.get(0, MIN_Y, 0), 0); + // Even after the last portal block is removed, its unused palette entry counts. + Arc::make_mut(&mut chunk).set(0, MIN_Y, 0, 0); + assert_eq!(cache.get((0, 0), &chunk, |id| id == 7), 1); + Arc::make_mut(&mut Arc::make_mut(&mut chunk).sections[0]).compact(); + assert_eq!(cache.get((0, 0), &chunk, |id| id == 7), 0); + Arc::make_mut(&mut chunk).sections[SECTIONS - 1] = Arc::new(Section::default()); + cache.clear(); // resource reload, with changed facts for the same state IDs + assert_eq!( + cache.get((0, 0), &chunk, |id| id == 0), + (1 << SECTIONS) - 1, + "a fresh palette is rescanned for every section" + ); + cache.remove(&(0, 0)); + assert!(cache.chunks.is_empty()); + } + + #[test] + fn replacement_at_same_coordinates_and_early_snapshot() { + let mut cache = PortalSections::default(); + let mut chunk = Arc::new(Chunk::empty(-2, 3)); + let before = cache.get((-2, 3), &chunk, |id| id == 1); + Arc::make_mut(&mut chunk).set(0, MIN_Y + 16, 0, 1); + assert_eq!(before, 0); + assert_eq!(cache.get((-2, 3), &chunk, |id| id == 1), 1 << 1); + let weak = Arc::downgrade(&chunk); + drop(chunk); + assert!(weak.upgrade().is_none()); // cache does not retain unloaded block data + let replacement = Arc::new(Chunk::empty(-2, 3)); + assert_eq!(cache.get((-2, 3), &replacement, |id| id == 1), 0); + } + + #[test] + fn global_palette_covers_the_whole_id_range() { + let mut chunk = Chunk::empty(0, 0); + for i in [0, 9, SECTIONS - 1] { + Arc::make_mut(&mut chunk.sections[i]).blocks = + Section::from_blocks(&std::array::from_fn(|j| (j % 300) as u32)); + } + let chunk = Arc::new(chunk); + let mut cache = PortalSections::default(); + // Global maybe_has considers the entire ID range, including absent states. + assert_eq!( + cache.get((0, 0), &chunk, |id| id == 40000), + (1 << 0) | (1 << 9) | (1 << (SECTIONS - 1)) + ); + } +} diff --git a/docs/portal-scan-benchmark.md b/docs/portal-scan-benchmark.md new file mode 100644 index 000000000..b8104ef26 --- /dev/null +++ b/docs/portal-scan-benchmark.md @@ -0,0 +1,81 @@ +# Nether-portal section-scan benchmark + +Run with the pinned prepared client resources: + +```sh +CARGO_BUILD_JOBS=6 cargo run --profile fast -p horizon-client --example portal_scan_bench -- \ + .local/horizon-client/26.3 +``` + +The example keeps the original `Game::may_hold_portal` alongside the resident +cache (`portal_sections`). Both run in the same optimized binary, alternating +measurement order. Each workload has one discarded warmup pair and seven pairs +of 300 ticks. It reports resource loading and fixture construction separately. +This measures the section scan only, not the whole `entity_portals` span, the +sweep that follows a positive answer, or the rest of the tick. + +The fixture is a 17x17 chunk world (289 chunks), each with 24 sections, and 500 +entity reaches spread over it (an item or mob box 0.25 wide and the small move +that produces the swept box). A reach touches 1-4 sections. Four palettes: +sparse (one non-portal state), dense (128 distinct), global (300 distinct, a +global palette whose `maybe_has` walks the whole state range) and dense_portal +(the dense palette with a portal in every fifth section). These are controlled +fixtures, not a claim about typical generated terrain. + +Steady includes the initial cache fill amortized over 300 ticks. Cold recreates +the cache each tick, including allocation and destruction; reload clears it each +tick while retaining capacity. Edit workloads alternate a block value in three +or all 289 chunks before every scan. Timing includes the `Arc::make_mut` move of +the 176-byte chunk wrapper caused by weak cache handles; the baseline holds no +such handles. Both paths keep the original outer reach list. + +The scan is parity-checked in the same run: the cached and per-tick answers must +agree for every reach over every sample, or the example panics. + +Measured on an AMD Ryzen 5 5600X (12 logical CPUs), Linux x86-64, rustc 1.99.0 +(b940084d7), using `fast` (release optimization, LTO off, 16 codegen units). +Resource loading took 705 ms; fixture construction took 66 ms sparse, 360 ms +dense, 392 ms global and 385 ms dense_portal, shared by both implementations. + +Median microseconds per tick (seven paired samples): + +| Palette | Workload | Original | Cached | Speedup | +| --- | --- | ---: | ---: | ---: | +| sparse | steady | 40.058 | 16.836 | 2.38x | +| sparse | cold | 40.203 | 48.619 | 0.83x | +| sparse | reload | 40.828 | 44.552 | 0.92x | +| sparse | edit_1pct | 41.282 | 52.200 | 0.79x | +| sparse | edit_all | 50.119 | 4192.396 | 0.01x | +| dense | steady | 244.610 | 21.869 | 11.19x | +| dense | cold | 292.533 | 1505.691 | 0.19x | +| dense | reload | 250.397 | 1301.608 | 0.19x | +| dense | edit_1pct | 256.522 | 69.132 | 3.71x | +| dense | edit_all | 263.829 | 5904.581 | 0.04x | +| global | steady | 6179.070 | 360.082 | 17.16x | +| global | edit_1pct | 6251.530 | 1565.249 | 3.99x | +| dense_portal | steady | 256.854 | 21.078 | 12.19x | +| dense_portal | cold | 240.498 | 1526.251 | 0.16x | +| dense_portal | reload | 347.879 | 2037.123 | 0.17x | +| dense_portal | edit_1pct | 368.684 | 118.108 | 3.12x | +| dense_portal | edit_all | 282.876 | 7194.112 | 0.04x | + +The global palette's `maybe_has` walks the whole ID range, so rescanning every +chunk each tick (cold, reload, edit_all) is intractable; those rows are not +measured for it. + +Keep: the steady scan improves for every palette (2.4x to 17x), which is the +case that repeats each tick in real play. Under constant edits the cache also +improves the dense and global palettes (edit_1pct 3-4x) because the original +rescans through the per-tick map. Rescanning every chunk every tick (cold, +reload, edit_all) is slower than the original because a miss scans all 24 +sections of a chunk, where the original only touched the sections a reach +overlaps. No whole-game speedup is inferred from this microbenchmark; real +terrain's palette sizes and block-write frequency determine the gain. Lighting +and other chunk changes conservatively invalidate a chunk's mask. + +The cache adds a weak handle and mask per visited resident chunk, retains no +unloaded block data, and is pruned when a chunk unloads (`sync_tick_chunks`) and +cleared on resource reload, like `random_tick_sections`. Editing a cached chunk +can move its 176-byte wrapper (plus Arc bookkeeping) on the first edit after it +is cached; it does not force a deep copy of the block data. The original outer +reach-list allocation remains. From d3673b1509f56cf852e35268843773fc82dd1dc8 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 22:06:18 +0200 Subject: [PATCH 018/163] Carry: write the self-drop loot table a mod registers in code Chipped registers its blocks' loot in code: its jar ships 7 loot tables for about 7,000 blocks, so carried over they dropped nothing, while in the NeoForge oracle every one drops itself. When a declared block has no loot table in the jar and the oracle shows vanilla's dropSelf (one of itself with every tool, nothing only where the state needs a tool it did not get), carry writes that table in 26.3's shape. When only the states with one property value drop it and the rest drop nothing (a door's lower half), the entry gets vanilla's match_block condition on that value, as createDoorTable writes. Chipped: 6,843 tables added. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-port-pack/src/carry.rs | 38 ++++++++ crates/horizon-port-pack/src/oracle.rs | 119 +++++++++++++++++++++++ crates/horizon-port-pack/src/pipeline.rs | 3 +- 3 files changed, 159 insertions(+), 1 deletion(-) diff --git a/crates/horizon-port-pack/src/carry.rs b/crates/horizon-port-pack/src/carry.rs index dfe4d3dbc..75c2d8408 100644 --- a/crates/horizon-port-pack/src/carry.rs +++ b/crates/horizon-port-pack/src/carry.rs @@ -25,6 +25,9 @@ pub struct Report { pub unreadable: BTreeMap, pub recipes_upgraded: usize, pub loot_tables_upgraded: usize, + /// Blocks whose jar has no loot table but drop themselves in the oracle: + /// the mod registers that table in code, and carry-over writes it. + pub loot_tables_added: usize, /// Worldgen and structure files (`data//worldgen/`, `structure/`). pub worldgen: usize, /// Recipes left as they were: custom types, NeoForge conditions. @@ -351,6 +354,7 @@ pub fn carry( let mut blockstates: BTreeMap = BTreeMap::new(); let mut item_models = BTreeSet::new(); let mut convention = BTreeSet::new(); + let mut block_loot = BTreeSet::new(); for i in 0..zip.len() { let mut entry = zip.by_index(i).map_err(|e| e.to_string())?; let name = entry.name().to_owned(); @@ -401,6 +405,12 @@ pub fn carry( } } } else if rel.starts_with("loot_table/") && name.starts_with("data/") { + if let Some(b) = rel + .strip_prefix("loot_table/blocks/") + .and_then(|b| b.strip_suffix(".json")) + { + block_loot.insert(b.to_owned()); + } if let Ok(mut table) = serde_json::from_slice::(&bytes) { let before = table.clone(); upgrade_loot(&mut table); @@ -470,6 +480,34 @@ pub fn carry( .push(format!("its item is {}", block.item)); } else { declared.insert(full.clone()); + let drop = (!block_loot.contains(b)) + .then(|| block.drops_itself(full)) + .flatten(); + if let Some(drop) = drop { + let mut entry = json!({"type": "minecraft:item", "name": full}); + if let crate::oracle::SelfDrop::When(property, value) = drop { + entry["condition"] = json!({ + "type": "minecraft:match_block", + "blocks": full, + "state": {property: value} + }); + } + let table = json!({ + "type": "minecraft:block", + "pools": [{ + "condition": {"type": "minecraft:survives_explosion"}, + "entries": [entry], + "rolls": 1 + }], + "random_sequence": format!("{id}:blocks/{b}") + }); + let file = inside.join(format!("data/{id}/loot_table/blocks/{b}.json")); + write( + &file, + &serde_json::to_vec_pretty(&table).unwrap_or_default(), + )?; + report.loot_tables_added += 1; + } } write_decl("block", b, &v)?; report.blocks.insert(b.to_owned(), choice.template); diff --git a/crates/horizon-port-pack/src/oracle.rs b/crates/horizon-port-pack/src/oracle.rs index 1fa9a717c..7e04aa9ef 100644 --- a/crates/horizon-port-pack/src/oracle.rs +++ b/crates/horizon-port-pack/src/oracle.rs @@ -60,6 +60,10 @@ pub struct State { pub sound: Value, pub outline: Value, pub collision: Value, + /// What breaking the state drops, per tool (`hand`, `diamond_pickaxe`, + /// `shears`, `silk_touch_pickaxe`...): item id → count. + #[serde(default)] + pub drops: BTreeMap>, } #[derive(Debug, Deserialize)] @@ -76,6 +80,23 @@ pub struct Item { const VANILLA_PACKAGE: &str = "net.minecraft."; /// A state key with its properties sorted, so keys compare across blocks. +/// Which states of a block drop the block itself. +#[derive(Debug, Clone, PartialEq, Eq)] +pub enum SelfDrop { + /// Every state: `dropSelf`. + Always, + /// Only the states where this property has this value. + When(String, String), +} + +/// A state key's `property=value` pairs. +fn pairs(key: &str) -> BTreeSet<(String, String)> { + key.split(',') + .filter_map(|p| p.split_once('=')) + .map(|(k, v)| (k.to_owned(), v.to_owned())) + .collect() +} + pub fn state_key(key: &str) -> String { let mut parts: Vec<&str> = key.split(',').filter(|p| !p.is_empty()).collect(); parts.sort_unstable(); @@ -96,6 +117,45 @@ impl Block { .first() .is_some_and(|c| !c.starts_with(VANILLA_PACKAGE)) } + /// Every state drops one `item` (the block's own) with every tool, except + /// where the state needs a tool and gets none: vanilla's `dropSelf`. Or + /// only the states where one property has one value do, and the others + /// drop nothing with any tool: a door's lower half (`createDoorTable`). + /// Mods often register these tables in code, so their jar has no file. + pub fn drops_itself(&self, item: &str) -> Option { + let one = BTreeMap::from([(item.to_owned(), 1)]); + let (mut dropping, mut nothing) = (Vec::new(), Vec::new()); + for (key, state) in &self.states { + if state.drops.is_empty() { + continue; + } + let mut drops = false; + let mut short = false; + for got in state.drops.values() { + if *got == one { + drops = true; + } else if got.is_empty() { + short = true; + } else { + return None; + } + } + match (drops, short) { + (true, true) if !state.requires_tool => return None, + (true, _) => dropping.push(pairs(key)), + (false, _) => nothing.push(pairs(key)), + } + } + let (first, rest) = dropping.split_first()?; + if nothing.is_empty() { + return Some(SelfDrop::Always); + } + first + .iter() + .filter(|pair| rest.iter().all(|s| s.contains(*pair))) + .find(|pair| nothing.iter().all(|s| !s.contains(*pair))) + .map(|(p, v)| SelfDrop::When(p.clone(), v.clone())) + } fn default_state(&self) -> Option<&State> { self.states .get(&self.default) @@ -373,6 +433,65 @@ mod tests { assert_eq!(tile.differences[0], "sounds: no vanilla block has them"); } + #[test] + fn drops_itself_is_vanillas_drop_self() { + let cube = json!([[0, 0, 0, 1, 1, 1]]); + let with = |requires_tool: bool, drops: Value| { + let mut s = state(1.5, "stone", cube.clone()); + s["requires_tool"] = json!(requires_tool); + s["drops"] = drops; + let b: Block = serde_json::from_value(block(&[], json!({}), json!({"": s}))).unwrap(); + b.drops_itself("m:tile") + }; + let me = json!({"m:tile": 1}); + let always = Some(SelfDrop::Always); + assert_eq!(with(false, json!({"hand": me, "shears": me})), always); + // A state that needs a tool drops nothing by hand, as dropSelf does. + assert_eq!( + with(true, json!({"hand": {}, "diamond_pickaxe": me})), + always + ); + assert_eq!( + with(false, json!({"hand": {}, "diamond_pickaxe": me})), + None + ); + // Two of itself (a double slab), or something else, is not dropSelf. + assert_eq!(with(false, json!({"hand": {"m:tile": 2}})), None); + assert_eq!(with(false, json!({"hand": {"m:other": 1}})), None); + assert_eq!(with(false, json!({})), None); + } + + #[test] + fn a_door_drops_from_its_lower_half() { + let cube = json!([[0, 0, 0, 1, 1, 1]]); + let me = json!({"hand": {"m:door": 1}, "shears": {"m:door": 1}}); + let none = json!({"hand": {}, "shears": {}}); + let door = |upper: &Value| { + let mut states = serde_json::Map::new(); + for (key, drops) in [ + ("half=lower,open=false", &me), + ("half=lower,open=true", &me), + ("half=upper,open=false", upper), + ("half=upper,open=true", upper), + ] { + let mut s = state(3.0, "wood", cube.clone()); + s["drops"] = drops.clone(); + states.insert(key.to_owned(), s); + } + let props = json!({"half": ["upper", "lower"], "open": ["true", "false"]}); + let b: Block = + serde_json::from_value(block(&[], props, Value::Object(states))).unwrap(); + b.drops_itself("m:door") + }; + assert_eq!( + door(&none), + Some(SelfDrop::When("half".to_owned(), "lower".to_owned())) + ); + assert_eq!(door(&me), Some(SelfDrop::Always)); + // Something else from the upper half: not a door table. + assert_eq!(door(&json!({"hand": {"m:other": 1}})), None); + } + #[test] fn state_keys_sort() { assert_eq!( diff --git a/crates/horizon-port-pack/src/pipeline.rs b/crates/horizon-port-pack/src/pipeline.rs index 80a88ee18..0fe87d181 100644 --- a/crates/horizon-port-pack/src/pipeline.rs +++ b/crates/horizon-port-pack/src/pipeline.rs @@ -158,12 +158,13 @@ pub fn carry( Ok(report) => { done += 1; log(format!( - "{}: {} files, {} recipes upgraded ({} kept), {} loot tables upgraded, {} item definitions added, {} blocks ({} left out, {} with differences), {} items ({} left out), {} convention tags, {} outside", + "{}: {} files, {} recipes upgraded ({} kept), {} loot tables upgraded ({} added), {} item definitions added, {} blocks ({} left out, {} with differences), {} items ({} left out), {} convention tags, {} outside", r.key, report.copied, report.recipes_upgraded, report.recipes_kept.len(), report.loot_tables_upgraded, + report.loot_tables_added, report.item_definitions_added, report.blocks.len(), report.blocks_unknown.len(), From 9afb6d76de42be1cb68525490d62599ce7910c89 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 22:27:29 +0200 Subject: [PATCH 019/163] Carry: structure mods' worldgen in vanilla's types, with the loader's biome tags Structure mods build on libraries whose structure, placement and pool element types are vanilla's with extra rules: Lithostitched's, Moog's Structure Lib's and Repurposed Structures' jigsaw structures, their advanced random spreads, versioned and ocean-bottom single pool elements. Carry rewrites them as vanilla's types; the extra rules (no start in liquid, a minimum distance from the origin) are lost, so a structure may start where the mod would not. Types with no vanilla counterpart (YUNG's, Formations', the nether variants) are left as they are and counted in the carry report. The structures' biomes name the loader's convention tags (#c:is_plains). fetch now also gets the pack's NeoForge jar from NeoForge's Maven repository, checked against its SHA-1, and carry copies the convention biome tags each mod's structures use, with those they include, into the mod. ATM10's 42 carried mods: 1,061 files rewritten, 103 convention biome tags. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-port-pack/src/carry.rs | 39 +++- crates/horizon-port-pack/src/fetch.rs | 22 ++ crates/horizon-port-pack/src/lib.rs | 1 + crates/horizon-port-pack/src/pipeline.rs | 2 + crates/horizon-port-pack/src/worldgen.rs | 262 +++++++++++++++++++++++ 5 files changed, 325 insertions(+), 1 deletion(-) create mode 100644 crates/horizon-port-pack/src/worldgen.rs diff --git a/crates/horizon-port-pack/src/carry.rs b/crates/horizon-port-pack/src/carry.rs index 75c2d8408..7b9bc8fee 100644 --- a/crates/horizon-port-pack/src/carry.rs +++ b/crates/horizon-port-pack/src/carry.rs @@ -47,6 +47,11 @@ pub struct Report { pub items_unknown: BTreeMap, /// Convention (`c:`) tags the recipes use, filled in from the oracle. pub convention_tags: usize, + /// Structure, placement and pool element types rewritten as vanilla's, + /// and those left as they are. + pub worldgen_types: crate::worldgen::Upgrade, + /// The loader's convention biome tags the structures name, carried. + pub convention_biome_tags: usize, } /// Vanilla blocks by their sorted property names. @@ -333,6 +338,7 @@ pub fn carry( out: &Path, facts: Option<&Facts>, allowed: &dyn Fn(&str) -> bool, + conventions: &BTreeMap, ) -> Result { let id = &info.mod_id; if id.is_empty() @@ -355,6 +361,7 @@ pub fn carry( let mut item_models = BTreeSet::new(); let mut convention = BTreeSet::new(); let mut block_loot = BTreeSet::new(); + let mut biome_conventions = BTreeSet::new(); for i in 0..zip.len() { let mut entry = zip.by_index(i).map_err(|e| e.to_string())?; let name = entry.name().to_owned(); @@ -404,6 +411,24 @@ pub fn carry( report.recipes_kept.push(file.to_owned()); } } + } else if let Some(kind) = rel + .strip_prefix("worldgen/") + .and_then(|r| r.split_once('/')) + .map(|(kind, _)| kind) + .filter(|_| name.starts_with("data/") && name.ends_with(".json")) + { + if let Ok(mut v) = serde_json::from_slice::(&bytes) { + if kind == "structure" { + crate::worldgen::convention_tags(&v["biomes"], &mut biome_conventions); + } + if crate::worldgen::upgrade(kind, &mut v, &mut report.worldgen_types) { + bytes = serde_json::to_vec_pretty(&v).unwrap_or(bytes); + } + } + } else if rel.starts_with("tags/worldgen/biome/") && name.starts_with("data/") { + if let Ok(v) = serde_json::from_slice::(&bytes) { + crate::worldgen::convention_tags(&v, &mut biome_conventions); + } } else if rel.starts_with("loot_table/") && name.starts_with("data/") { if let Some(b) = rel .strip_prefix("loot_table/blocks/") @@ -445,6 +470,18 @@ pub fn carry( report.item_definitions_added += 1; } } + // The loader's convention biome tags the structures and their tags name + // (NeoForge's `c:is_plains`...): the game has no loader, so they come along. + for tag in crate::worldgen::with_included(&biome_conventions, conventions) { + let file = inside.join(format!("data/c/tags/worldgen/biome/{tag}.json")); + if !file.exists() { + write( + &file, + &serde_json::to_vec_pretty(&conventions[&tag]).unwrap_or_default(), + )?; + report.convention_biome_tags += 1; + } + } let decl = inside.join(format!("data/{id}/horizon")); let write_decl = |kind: &str, name: &str, v: &Value| { let text = serde_json::to_vec_pretty(v).unwrap_or_default(); @@ -819,7 +856,7 @@ mod tests { ); assert_eq!(info.census.classes, 1); let out = dir.join("work/mods/gem"); - let report = carry(&jar, &info, &out, None, &|_| true).unwrap(); + let report = carry(&jar, &info, &out, None, &|_| true, &BTreeMap::new()).unwrap(); assert_eq!(report.copied, 13); let unreadable: Vec<&str> = report.unreadable.keys().map(String::as_str).collect(); assert_eq!( diff --git a/crates/horizon-port-pack/src/fetch.rs b/crates/horizon-port-pack/src/fetch.rs index 011e99e1f..f8f7b2dc7 100644 --- a/crates/horizon-port-pack/src/fetch.rs +++ b/crates/horizon-port-pack/src/fetch.rs @@ -139,6 +139,28 @@ pub fn fetch( } fetched.files.push(o); } + // The loader's own data (its convention tags), from its own repository. + if let Some((dest, url)) = crate::worldgen::loader_jar(work, &pack.loader, &pack.loader_version) + .filter(|(dest, _)| !dest.exists()) + { + let sha1 = ureq::get(&format!("{url}.sha1")) + .set("User-Agent", modrinth::AGENT) + .call() + .ok() + .and_then(|r| r.into_string().ok()) + .map(|s| s.trim().to_owned()); + let made = dest.parent().map(fs::create_dir_all); + match made + .unwrap_or(Ok(())) + .map_err(|e| e.to_string()) + .and_then(|()| download(&url, sha1.as_deref(), &dest)) + { + Ok(()) => log(format!("loader: {}", dest.display())), + Err(e) => log(format!( + "loader: {e} (structures keep only vanilla biome tags)" + )), + } + } write_json(&work.join("fetch.json"), &fetched)?; log(format!( "jars: {} downloaded, {} copied, {} already here, {} need a CurseForge key, {} not found, {} failed", diff --git a/crates/horizon-port-pack/src/lib.rs b/crates/horizon-port-pack/src/lib.rs index ecd61956c..0e678fb9a 100644 --- a/crates/horizon-port-pack/src/lib.rs +++ b/crates/horizon-port-pack/src/lib.rs @@ -15,3 +15,4 @@ pub mod modrinth; pub mod oracle; pub mod pipeline; pub mod report; +pub mod worldgen; diff --git a/crates/horizon-port-pack/src/pipeline.rs b/crates/horizon-port-pack/src/pipeline.rs index 0fe87d181..3afe5b3a3 100644 --- a/crates/horizon-port-pack/src/pipeline.rs +++ b/crates/horizon-port-pack/src/pipeline.rs @@ -119,6 +119,7 @@ pub fn carry( .ok() }); let allowed = |b: &str| vanilla.as_ref().is_none_or(|v| v.contains(b)); + let conventions = crate::worldgen::loader_biome_tags(work); let mut done = 0; for r in &records { let chosen = if only.is_empty() { @@ -154,6 +155,7 @@ pub fn carry( &work.join("mods").join(&r.key), facts.as_ref().filter(seen), &allowed, + &conventions, ) { Ok(report) => { done += 1; diff --git a/crates/horizon-port-pack/src/worldgen.rs b/crates/horizon-port-pack/src/worldgen.rs new file mode 100644 index 000000000..c44cc1108 --- /dev/null +++ b/crates/horizon-port-pack/src/worldgen.rs @@ -0,0 +1,262 @@ +//! Structure mods' worldgen, carried over: the structure, placement and pool +//! element types of the common structure libraries rewritten as vanilla's, +//! and the loader's convention biome tags (`c:`) the structures name. +//! +//! The libraries' types add rules on top of vanilla's (a structure that may +//! not start in liquid, a minimum distance from the world origin, a count +//! cap per piece). Mapped to vanilla, those rules are lost: the structure +//! keeps its pieces and its spacing but can start where the mod would not. +//! Each rewrite is counted in the carry report, and every type left as it is +//! is listed, so the coverage report can say what generates and how closely. +use serde_json::Value; +use std::{ + collections::{BTreeMap, BTreeSet}, + io::Read, + path::{Path, PathBuf}, +}; + +/// Structure types that are vanilla's jigsaw with extra start rules. +const JIGSAWS: [&str; 3] = [ + "lithostitched:jigsaw", + "moogs_structures:moogs_structures_generic_jigsaw_structure", + "repurposed_structures:generic_jigsaw_structure", +]; +/// Placements that are vanilla's random spread with extra rules. +const SPREADS: [&str; 2] = [ + "moogs_structures:advanced_random_spread", + "repurposed_structures:advanced_random_spread", +]; +/// Pool elements that are vanilla's with extra fields: (mod type, vanilla type). +const ELEMENTS: [(&str, &str); 3] = [ + ( + "moogs_structures:versioned_single_pool_element", + "minecraft:single_pool_element", + ), + ( + "repurposed_structures:legacy_ocean_bottom_single_pool_element", + "minecraft:legacy_single_pool_element", + ), + ("empty_pool_element", "minecraft:empty_pool_element"), +]; + +/// What carry-over did to a mod's worldgen files. +#[derive(Debug, Default, serde::Serialize)] +pub struct Upgrade { + /// Files rewritten to vanilla types. + pub mapped: usize, + /// Types left as they are (Horizon skips what it cannot run), by type. + pub unsupported: BTreeMap, +} + +/// Rewrites one `data//worldgen//...` file in place; whether it +/// changed. +pub fn upgrade(kind: &str, v: &mut Value, report: &mut Upgrade) -> bool { + let mut unsupported = |t: &str| *report.unsupported.entry(t.to_owned()).or_default() += 1; + let changed = match kind { + "structure" => match v["type"].as_str() { + Some(t) if JIGSAWS.contains(&t) => { + v["type"] = "minecraft:jigsaw".into(); + true + } + Some(t) if !t.starts_with("minecraft:") => { + unsupported(t); + false + } + _ => false, + }, + "structure_set" => match v["placement"]["type"].as_str() { + Some(t) if SPREADS.contains(&t) => { + v["placement"]["type"] = "minecraft:random_spread".into(); + true + } + Some(t) if !t.starts_with("minecraft:") => { + unsupported(t); + false + } + _ => false, + }, + "template_pool" => { + let mut changed = false; + let mut elements: Vec<&mut Value> = Vec::new(); + for e in v["elements"].as_array_mut().into_iter().flatten() { + let element = &mut e["element"]; + // A list element holds elements of its own. + if element.get("elements").is_some_and(Value::is_array) { + elements.extend(element["elements"].as_array_mut().into_iter().flatten()); + } else { + elements.push(element); + } + } + for element in elements { + let Some(t) = element["element_type"].as_str() else { + continue; + }; + if let Some((_, to)) = ELEMENTS.iter().find(|(from, _)| *from == t) { + element["element_type"] = (*to).into(); + changed = true; + } else if !t.starts_with("minecraft:") { + unsupported(t); + } + } + changed + } + _ => false, + }; + report.mapped += usize::from(changed); + changed +} + +/// The `#c:` biome tags `v` names. +pub fn convention_tags(v: &Value, out: &mut BTreeSet) { + match v { + Value::String(s) => { + if let Some(tag) = s.strip_prefix("#c:") { + out.insert(tag.to_owned()); + } + } + Value::Array(a) => a.iter().for_each(|x| convention_tags(x, out)), + Value::Object(o) => o.values().for_each(|x| convention_tags(x, out)), + _ => {} + } +} + +/// The loader's own convention biome tags (`data/c/tags/worldgen/biome/`), +/// by path, read from the loader jar `fetch` keeps in `/loader/`. +pub fn loader_biome_tags(work: &Path) -> BTreeMap { + let mut out = BTreeMap::new(); + let Ok(dir) = std::fs::read_dir(work.join("loader")) else { + return out; + }; + for jar in dir.flatten().map(|e| e.path()) { + let Some(mut zip) = std::fs::File::open(&jar) + .ok() + .and_then(|f| zip::ZipArchive::new(f).ok()) + else { + continue; + }; + for i in 0..zip.len() { + let Ok(mut entry) = zip.by_index(i) else { + continue; + }; + let Some(path) = entry + .name() + .strip_prefix("data/c/tags/worldgen/biome/") + .and_then(|p| p.strip_suffix(".json")) + .map(str::to_owned) + else { + continue; + }; + let mut text = String::new(); + if entry.read_to_string(&mut text).is_ok() { + if let Ok(v) = serde_json::from_str(&text) { + out.insert(path, v); + } + } + } + } + out +} + +/// `tags` and the convention tags they include, in `conventions`. +pub fn with_included( + tags: &BTreeSet, + conventions: &BTreeMap, +) -> BTreeSet { + let mut all = BTreeSet::new(); + let mut todo: Vec = tags.iter().cloned().collect(); + while let Some(tag) = todo.pop() { + if !conventions.contains_key(&tag) || !all.insert(tag.clone()) { + continue; + } + let mut more = BTreeSet::new(); + convention_tags(&conventions[&tag], &mut more); + todo.extend(more); + } + all +} + +/// Where `fetch` keeps the pack's loader jar, and where it comes from: +/// NeoForge's own Maven repository. Only NeoForge packs need it today. +pub fn loader_jar(work: &Path, loader: &str, version: &str) -> Option<(PathBuf, String)> { + (loader == "neoforge" && !version.is_empty()).then(|| { + ( + work.join("loader").join(format!("neoforge-{version}-universal.jar")), + format!( + "https://maven.neoforged.net/releases/net/neoforged/neoforge/{version}/neoforge-{version}-universal.jar" + ), + ) + }) +} + +#[cfg(test)] +mod tests { + use super::*; + use serde_json::json; + + #[test] + fn maps_library_types_to_vanillas() { + let mut report = Upgrade::default(); + let mut s = json!({"type": "lithostitched:jigsaw", "start_pool": "a:b"}); + assert!(upgrade("structure", &mut s, &mut report)); + assert_eq!(s["type"], "minecraft:jigsaw"); + let mut nether = + json!({"type": "moogs_structures:moogs_structures_generic_nether_jigsaw_structure"}); + assert!(!upgrade("structure", &mut nether, &mut report)); + let mut set = json!({"placement": {"type": "moogs_structures:advanced_random_spread", + "spacing": 10, "separation": 5, "min_distance_from_world_origin": 250}}); + assert!(upgrade("structure_set", &mut set, &mut report)); + assert_eq!(set["placement"]["type"], "minecraft:random_spread"); + assert_eq!(set["placement"]["spacing"], 10); + let mut pool = json!({"elements": [ + {"weight": 1, "element": {"element_type": "moogs_structures:versioned_single_pool_element", "location": "m:x"}}, + {"weight": 1, "element": {"element_type": "minecraft:list_pool_element", "elements": [ + {"element_type": "empty_pool_element"}]}}, + {"weight": 1, "element": {"element_type": "yungsapi:yung_single_element"}} + ]}); + assert!(upgrade("template_pool", &mut pool, &mut report)); + assert_eq!( + pool["elements"][0]["element"]["element_type"], + "minecraft:single_pool_element" + ); + assert_eq!( + pool["elements"][1]["element"]["elements"][0]["element_type"], + "minecraft:empty_pool_element" + ); + assert_eq!(report.mapped, 3); + assert_eq!( + report.unsupported, + BTreeMap::from([ + ( + "moogs_structures:moogs_structures_generic_nether_jigsaw_structure".into(), + 1 + ), + ("yungsapi:yung_single_element".into(), 1), + ]) + ); + } + + #[test] + fn convention_tags_include_theirs() { + let conventions = BTreeMap::from([ + ( + "is_hot".to_owned(), + json!({"values": ["#c:is_desert", "#minecraft:is_badlands"]}), + ), + ( + "is_desert".to_owned(), + json!({"values": ["minecraft:desert"]}), + ), + ("is_cold".to_owned(), json!({"values": []})), + ]); + let mut used = BTreeSet::new(); + convention_tags( + &json!({"biomes": ["#c:is_hot", "#c:unknown", "#minecraft:x"]}), + &mut used, + ); + assert_eq!(used, BTreeSet::from(["is_hot".into(), "unknown".into()])); + assert_eq!( + with_included(&used, &conventions), + BTreeSet::from(["is_hot".into(), "is_desert".into()]) + ); + } +} From 56a251eb130f76f6f9638f6b9dd09f1fe19ada80 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sat, 17 Oct 2026 22:38:35 +0100 Subject: [PATCH 020/163] Paletted container access: one palette probe per write, dispatched unpack BlockSection::set resolved the old cell through get and then probed the section palette three times per non-trivial write: keying the old state by id, testing the incoming state and finding it. The slot at the written index already is the old state's id, so read it straight from storage and resolve only the incoming state, with a single map probe. Palette reuse, free slots and growth are unchanged, so palette, counts, free list and NBT are identical. PalettedContainer::unpack and unpack_u16 matched the palette variant inside the per-cell loop; dispatch Single/List/Global once before it. Measured against copies of the pre-optimization code (ignored tests): BlockSection::set 12.73 -> 11.37 ns/write (1.12x), unpack list 1.956 -> 1.860 us/call (1.05x), global 2.255 -> 2.172 (1.04x). See docs/performance/paletted-container-access-results.md. set_matches_baseline_under_random_edits drives both implementations over the same 50k-edit streams for 1/2/16/17/24/64 distinct states, with periodic whole-section collapses, and asserts equal results, bits, palette, counts, free list and NBT. --- crates/horizon-core/src/paletted.rs | 112 ++++++- crates/horizon-world/src/chunk.rs | 301 ++++++++++++++++-- .../paletted-container-access-results.md | 62 ++++ 3 files changed, 433 insertions(+), 42 deletions(-) create mode 100644 docs/performance/paletted-container-access-results.md diff --git a/crates/horizon-core/src/paletted.rs b/crates/horizon-core/src/paletted.rs index f162404f5..5c0ec374c 100644 --- a/crates/horizon-core/src/paletted.rs +++ b/crates/horizon-core/src/paletted.rs @@ -391,17 +391,24 @@ impl PalettedContainer { assert_eq!(out.len(), self.strategy.entries()); match &self.palette { Palette::Single(value) => out.fill(*value), - palette => { + Palette::List(list) => { let bits = usize::from(self.bits); let per = 64 / bits; let m = mask(self.bits); for (chunk, &word) in out.chunks_mut(per).zip(&self.words) { for (slot, cell) in chunk.iter_mut().enumerate() { - let id = ((word >> (slot * bits)) & m) as u32; - *cell = match palette { - Palette::List(list) => list[id as usize], - _ => id, - }; + let id = ((word >> (slot * bits)) & m) as usize; + *cell = list[id]; + } + } + } + Palette::Global => { + let bits = usize::from(self.bits); + let per = 64 / bits; + let m = mask(self.bits); + for (chunk, &word) in out.chunks_mut(per).zip(&self.words) { + for (slot, cell) in chunk.iter_mut().enumerate() { + *cell = ((word >> (slot * bits)) & m) as u32; } } } @@ -412,17 +419,24 @@ impl PalettedContainer { debug_assert_eq!(self.strategy.entries(), 4096); match &self.palette { Palette::Single(value) => out.fill(*value as u16), - palette => { + Palette::List(list) => { let bits = usize::from(self.bits); let per = 64 / bits; let m = mask(self.bits); for (chunk, &word) in out.chunks_mut(per).zip(&self.words) { for (slot, cell) in chunk.iter_mut().enumerate() { let id = ((word >> (slot * bits)) & m) as usize; - *cell = match palette { - Palette::List(list) => list[id] as u16, - _ => id as u16, - }; + *cell = list[id] as u16; + } + } + } + Palette::Global => { + let bits = usize::from(self.bits); + let per = 64 / bits; + let m = mask(self.bits); + for (chunk, &word) in out.chunks_mut(per).zip(&self.words) { + for (slot, cell) in chunk.iter_mut().enumerate() { + *cell = ((word >> (slot * bits)) & m) as u16; } } } @@ -738,4 +752,80 @@ mod tests { } } } + + /// The pre-optimization `unpack`, kept to compare against in the benchmark. + fn baseline_unpack(c: &PalettedContainer, out: &mut [u32]) { + match &c.palette { + Palette::Single(value) => out.fill(*value), + palette => { + let bits = usize::from(c.bits); + let per = 64 / bits; + let m = mask(c.bits); + for (chunk, &word) in out.chunks_mut(per).zip(&c.words) { + for (slot, cell) in chunk.iter_mut().enumerate() { + let id = ((word >> (slot * bits)) & m) as u32; + *cell = match palette { + Palette::List(list) => list[id as usize], + _ => id, + }; + } + } + } + } + } + + /// `unpack` against the pre-optimization implementation, for a list palette + /// and the global palette. The result is checked before timing; 25 measured + /// rounds alternate order and report the median and best microsecond-per-call. + #[test] + #[ignore = "microbenchmark; run with --ignored --nocapture"] + fn benchmark_unpack() { + use std::{hint::black_box, time::Instant}; + let values: Vec = (0..4096).map(|i| (i % 12) as u32).collect(); + let list = PalettedContainer::from_values(BLOCKS, &values); + let global = PalettedContainer::from_values( + BLOCKS, + &(0..4096).map(|i| (i * 3) as u32).collect::>(), + ); + for (name, container) in [("list", &list), ("global", &global)] { + let mut expected = vec![0u32; 4096]; + baseline_unpack(container, &mut expected); + let mut out = vec![0u32; 4096]; + container.unpack(&mut out); + assert_eq!(expected, out, "unpack {name} differs"); + let mut times = [Vec::new(), Vec::new()]; + for round in 0..25 { + for optimized in [round % 2 == 0, round % 2 != 0] { + let started = Instant::now(); + for _ in 0..2000 { + if optimized { + container.unpack(black_box(&mut out)); + } else { + baseline_unpack(black_box(container), black_box(&mut out)); + } + } + if round > 0 { + times[usize::from(optimized)] + .push(started.elapsed().as_secs_f64() * 1e6 / 2000.0); + } + } + } + for values in &mut times { + values.sort_by(f64::total_cmp); + } + let median = |v: &[f64]| v[v.len() / 2]; + println!( + "unpack {name} median: baseline {:.3} us optimized {:.3} us speedup {:.3}x", + median(×[0]), + median(×[1]), + median(×[0]) / median(×[1]) + ); + println!( + "unpack {name} best: baseline {:.3} us optimized {:.3} us speedup {:.3}x", + times[0][0], + times[1][0], + times[0][0] / times[1][0] + ); + } + } } diff --git a/crates/horizon-world/src/chunk.rs b/crates/horizon-world/src/chunk.rs index f4341c92f..b7650a3d3 100644 --- a/crates/horizon-world/src/chunk.rs +++ b/crates/horizon-world/src/chunk.rs @@ -446,44 +446,52 @@ impl<'r> BlockSection<'r> { Ok(self.palette[id as usize]) } pub fn set(&mut self, index: usize, state: BlockStateId) -> io::Result { - let old = self.get(index)?; + if index >= 4096 { + return Err(invalid("section index out of bounds")); + } if state.0 as usize >= self.registry.len() { return Err(invalid("state ID outside registry")); } + // The slot at `index` is the old state's id, so no palette lookup is + // needed for it; only the new state has to be resolved. + let old_id = self.storage.as_ref().map_or(0, |s| s.get(index).unwrap()); + let old = self.palette[old_id as usize]; if old == state { return Ok(old); } - let old_id = self.local_ids[&old]; - if self.counts[old_id as usize] == 1 && !self.local_ids.contains_key(&state) { - // Replacing the last occurrence can reuse its slot without repacking. - self.palette[old_id as usize] = state; - self.local_ids.remove(&old); - self.local_ids.insert(state, old_id); - return Ok(old); - } - let id = if let Some(id) = self.local_ids.get(&state) { - *id - } else if let Some(id) = self.free.pop() { - self.palette[id as usize] = state; - self.local_ids.insert(state, id); - id - } else { - let id = self.palette.len() as u32; - let next_bits = bits_for_palette(self.palette.len() + 1, 4); - if next_bits != self.bits() { - let mut storage = - PackedStorage::new(next_bits, 4096).map_err(|e| invalid(e.to_string()))?; - if let Some(old) = &self.storage { - for i in 0..4096 { - storage.set(i, old.get(i).unwrap()).unwrap(); - } - } - self.storage = Some(storage); + let id = match self.local_ids.get(&state) { + Some(&id) => id, + None if self.counts[old_id as usize] == 1 => { + // Replacing the last occurrence can reuse its slot without repacking. + self.palette[old_id as usize] = state; + self.local_ids.remove(&old); + self.local_ids.insert(state, old_id); + return Ok(old); + } + None => { + if let Some(id) = self.free.pop() { + self.palette[id as usize] = state; + self.local_ids.insert(state, id); + id + } else { + let id = self.palette.len() as u32; + let next_bits = bits_for_palette(self.palette.len() + 1, 4); + if next_bits != self.bits() { + let mut storage = PackedStorage::new(next_bits, 4096) + .map_err(|e| invalid(e.to_string()))?; + if let Some(old) = &self.storage { + for i in 0..4096 { + storage.set(i, old.get(i).unwrap()).unwrap(); + } + } + self.storage = Some(storage); + } + self.palette.push(state); + self.counts.push(0); + self.local_ids.insert(state, id); + id + } } - self.palette.push(state); - self.counts.push(0); - self.local_ids.insert(state, id); - id }; self.storage .as_mut() @@ -585,4 +593,235 @@ mod tests { map.insert(key("data"), Tag::LongArray(vec![-1; 256])); assert!(PalettedContainer::from_nbt(&tag, 4096, 4).is_err()); } + + /// The pre-optimization `get`, kept to compare against in the benchmark. + fn baseline_get(section: &BlockSection<'_>, index: usize) -> io::Result { + if index >= 4096 { + return Err(invalid("section index out of bounds")); + } + let id = section + .storage + .as_ref() + .map_or(0, |s| s.get(index).unwrap()); + Ok(section.palette[id as usize]) + } + /// The pre-optimization `set`, kept to compare against in the benchmark. + fn baseline_set( + section: &mut BlockSection<'_>, + index: usize, + state: BlockStateId, + ) -> io::Result { + let old = baseline_get(section, index)?; + if state.0 as usize >= section.registry.len() { + return Err(invalid("state ID outside registry")); + } + if old == state { + return Ok(old); + } + let old_id = section.local_ids[&old]; + if section.counts[old_id as usize] == 1 && !section.local_ids.contains_key(&state) { + section.palette[old_id as usize] = state; + section.local_ids.remove(&old); + section.local_ids.insert(state, old_id); + return Ok(old); + } + let id = if let Some(id) = section.local_ids.get(&state) { + *id + } else if let Some(id) = section.free.pop() { + section.palette[id as usize] = state; + section.local_ids.insert(state, id); + id + } else { + let id = section.palette.len() as u32; + let next_bits = bits_for_palette(section.palette.len() + 1, 4); + if next_bits != section.bits() { + let mut storage = + PackedStorage::new(next_bits, 4096).map_err(|e| invalid(e.to_string()))?; + if let Some(old) = §ion.storage { + for i in 0..4096 { + storage.set(i, old.get(i).unwrap()).unwrap(); + } + } + section.storage = Some(storage); + } + section.palette.push(state); + section.counts.push(0); + section.local_ids.insert(state, id); + id + }; + section + .storage + .as_mut() + .unwrap() + .set(index, id) + .map_err(|e| invalid(e.to_string()))?; + section.counts[old_id as usize] -= 1; + section.counts[id as usize] += 1; + if section.counts[old_id as usize] == 0 { + section.local_ids.remove(&old); + section.free.push(old_id); + } + if section.counts[id as usize] == 4096 { + section.palette = vec![state]; + section.local_ids = local_ids(state); + section.counts = vec![4096]; + section.free.clear(); + section.storage = None; + } + Ok(old) + } + + fn benchmark_registry(states: usize) -> BlockRegistry { + let list: Vec = (0..states) + .map(|i| { + Tag::compound([("id", Tag::String(format!("minecraft:b{i}").as_str().into()))]) + }) + .collect(); + let defaults: BTreeMap<_, _> = (0..states) + .map(|i| { + ( + JavaString::from(format!("minecraft:b{i}").as_str()), + Tag::Int(i as i32), + ) + }) + .collect(); + let tag = Tag::compound([ + ("DataVersion", Tag::Int(crate::DATA_VERSION)), + ("states", Tag::List(list)), + ("defaults", Tag::Compound(defaults)), + ]); + BlockRegistry::from_nbt(&tag).unwrap() + } + + /// The optimized `set`/`get` must agree with the pre-optimization ones on + /// every field, across growth, collapse and reclaimed palette slots. + #[test] + fn set_matches_baseline_under_random_edits() { + let registry = benchmark_registry(64); + for &(distinct, seed) in &[(1u64, 1u64), (2, 2), (16, 3), (17, 4), (24, 5), (64, 6)] { + let mut base = BlockSection::uniform(BlockStateId(0), ®istry).unwrap(); + let mut fast = BlockSection::uniform(BlockStateId(0), ®istry).unwrap(); + let mut rng = seed.wrapping_mul(0x9e37_79b9_7f4a_7c15) | 1; + let mut next = || { + rng ^= rng << 13; + rng ^= rng >> 7; + rng ^= rng << 17; + rng + }; + for step in 0..50_000u32 { + if step % 5_000 == 4_999 { + let value = (next() % distinct) as u32; + for index in 0..4096 { + assert_eq!( + baseline_set(&mut base, index, BlockStateId(value)).unwrap(), + fast.set(index, BlockStateId(value)).unwrap() + ); + } + } else { + let index = (next() % 4096) as usize; + let value = (next() % distinct) as u32; + assert_eq!( + baseline_set(&mut base, index, BlockStateId(value)).unwrap(), + fast.set(index, BlockStateId(value)).unwrap() + ); + } + assert_eq!(base.bits(), fast.bits()); + } + assert_eq!(base.palette, fast.palette); + assert_eq!(base.counts, fast.counts); + assert_eq!(base.free, fast.free); + assert_eq!(base.local_ids, fast.local_ids); + for index in 0..4096 { + assert_eq!( + baseline_get(&base, index).unwrap(), + fast.get(index).unwrap(), + "distinct {distinct} index {index}" + ); + } + assert_eq!(base.to_nbt().unwrap(), fast.to_nbt().unwrap()); + } + } + + /// `set` and `get` against the pre-optimization implementations, on the same + /// edit stream. The result is checked before timing; 51 measured rounds + /// alternate order and report the median and best nanosecond-per-operation. + #[test] + #[ignore = "microbenchmark; run with --ignored --nocapture"] + fn benchmark_section_get_set() { + use std::{hint::black_box, time::Instant}; + const OPS: usize = 50_000; + const ROUNDS: u32 = 51; + let registry = benchmark_registry(32); + let mut rng = 0x1234_5678_9abc_def1u64; + let mut next = || { + rng ^= rng << 13; + rng ^= rng >> 7; + rng ^= rng << 17; + rng + }; + let ops: Vec<(usize, u32)> = (0..OPS) + .map(|_| ((next() % 4096) as usize, (next() % 24) as u32)) + .collect(); + let make = || BlockSection::uniform(BlockStateId(0), ®istry).unwrap(); + + let mut base = make(); + let mut fast = make(); + for &(index, value) in &ops { + assert_eq!( + baseline_set(&mut base, index, BlockStateId(value)).unwrap(), + fast.set(index, BlockStateId(value)).unwrap() + ); + } + assert_eq!(base.bits(), fast.bits()); + assert_eq!(base.palette, fast.palette); + assert_eq!(base.counts, fast.counts); + assert_eq!(base.free, fast.free); + assert_eq!(base.to_nbt().unwrap(), fast.to_nbt().unwrap()); + for i in 0..4096 { + assert_eq!(baseline_get(&base, i).unwrap(), fast.get(i).unwrap()); + } + + let mut times = [Vec::new(), Vec::new()]; + for round in 0..ROUNDS { + for optimized in [round % 2 == 0, round % 2 != 0] { + let mut section = make(); + let started = Instant::now(); + for &(index, value) in &ops { + if optimized { + section + .set(black_box(index), black_box(BlockStateId(value))) + .unwrap(); + } else { + baseline_set( + &mut section, + black_box(index), + black_box(BlockStateId(value)), + ) + .unwrap(); + } + } + black_box(§ion); + if round > 0 { + times[usize::from(optimized)] + .push(started.elapsed().as_secs_f64() * 1e9 / OPS as f64); + } + } + } + for values in &mut times { + values.sort_by(f64::total_cmp); + } + let median = |v: &[f64]| v[v.len() / 2]; + println!( + "section set median: baseline {:.3} ns/op optimized {:.3} ns/op speedup {:.3}x", + median(×[0]), + median(×[1]), + median(×[0]) / median(×[1]) + ); + println!( + "section set best: baseline {:.3} ns/op optimized {:.3} ns/op speedup {:.3}x", + times[0][0], + times[1][0], + times[0][0] / times[1][0] + ); + } } diff --git a/docs/performance/paletted-container-access-results.md b/docs/performance/paletted-container-access-results.md new file mode 100644 index 000000000..233e320ab --- /dev/null +++ b/docs/performance/paletted-container-access-results.md @@ -0,0 +1,62 @@ +# Paletted container access + +The `unpack`/`get` cell reader and `BlockSection::get`/`set` are hot in the +chunk workers: light and mesh workers unpack a section's 4,096 cells before +propagating or meshing, and world-generation workers write one block at a time +through `BlockSection::set`. + +Two redundant lookups were removed from the write path, and the palette dispatch +was hoisted in the bulk readers. + +## Changes + +`BlockSection::set` (`crates/horizon-world/src/chunk.rs`) previously resolved the +old cell through `get` and then probed the section's palette map three times for +one non-trivial write: once to key the old state by id (`local_ids[&old]`), once +to test the incoming state (`contains_key`), and once to find it (`get`). The +slot at the written index already *is* the old state's id, so the old state is +now read straight from storage, and the incoming state is resolved with a single +map probe. The palette-reuse, free-slot and growth paths are unchanged, so the +encoded palette, counts, free list and NBT output stay identical. + +`PalettedContainer::unpack` and `unpack_u16` +(`crates/horizon-core/src/paletted.rs`) matched on the palette variant inside the +per-cell loop. `Single`, `List` and `Global` are now dispatched once before the +loop, leaving each arm a branch-free indexed loop. + +No allocation, layout or wire format changes. + +## Reproduce + +```sh +cargo test -p horizon-world --lib --profile fast benchmark_section_get_set -- --ignored --nocapture +cargo test -p horizon-core --lib --profile fast benchmark_unpack -- --ignored --nocapture +``` + +The ignored tests compare the new code against copies of the pre-optimization +implementations, kept in the test modules (`baseline_get`/`baseline_set`, +`baseline_unpack`). They check every resulting palette, count, free list, cell +and NBT before timing. Rounds alternate baseline/optimized order with `black_box` +and report the median and best nanosecond- or microsecond-per-operation; the best +round is the estimate of uninterrupted CPU time on a contended machine. + +`benchmark_section_get_set` uses a 32-state registry and 50,000 random writes per +round over a section whose palette grows through the 4- and 5-bit widths (24 +distinct states); 51 rounds. `benchmark_unpack` fills a 4,096-entry list palette +(12 states) and the global palette, 2,000 calls per round, 25 rounds. + +AMD Ryzen 5 5600X, Linux x86_64, rustc 1.99.0, optimized `fast` profile, +nonincremental, no LTO: + +| Operation | Original main | New | Speedup | +| --- | ---: | ---: | ---: | +| `BlockSection::set` | 12.73 ns/write | 11.37 ns/write | 1.12x | +| `unpack`, list palette | 1.956 us/call | 1.860 us/call | 1.05x | +| `unpack`, global palette | 2.255 us/call | 2.172 us/call | 1.04x | + +The distinct-state differential test +`chunk::tests::set_matches_baseline_under_random_edits` drives the optimized +`set` and `get` and the originals over the same 50,000-edit streams for 1, 2, 16, +17, 24 and 64 distinct states, including periodic whole-section collapses that +clear the storage and reclaim palette slots, and asserts equal results, bits, +palette, counts, free list, `local_ids` and NBT throughout. From 90053d15aaceb6eec419a11fb199fac2824bf9d4 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 23:45:23 +0200 Subject: [PATCH 021/163] docs/modpacks.md: memory, NeoForge comparison, worldgen and Chipped status The NBT tables stream, the fluid tables reuse the game's facts and the content root is kept between starts (#753, #754, #756). Horizon with ATM10's 40 data-tier mods against the same mods on NeoForge 21.1.259. Worldgen carry-over and what it does not cover yet (#763, #764). Chipped's harness row with its self-drop tables (#762). The overlay cache line said it was cached; it is now. Co-Authored-By: Claude Opus 5.5 --- docs/modpacks.md | 108 +++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 94 insertions(+), 14 deletions(-) diff --git a/docs/modpacks.md b/docs/modpacks.md index 23b560633..adf9a5318 100644 --- a/docs/modpacks.md +++ b/docs/modpacks.md @@ -236,7 +236,15 @@ How the game loads them, without touching vanilla's path: so the same mod set gives the same ids. Saves store block names, so ids never reach the disk. - Loaders that read only `data/minecraft/` (recipes, loot, tags) read every namespace, as vanilla does. With no mods there is only `minecraft`, so nothing changes. -- The overlay is cached like the resource-pack overlay and rebuilt when a mod file changes. +- 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 + ATM10's 40 data-tier mods the build takes about a minute of the first start on a busy machine. +- **Worldgen.** Mods' structures, structure sets, template pools, processor lists, configured and + placed features join the `worldgen/*.json` bundles. Their structure templates go under + `worldgen/structure//`. Their biome tags are merged into `worldgen/biome_tags.json`, minus + the biomes and tags Horizon does not have. Mod biomes, noise and density functions are not + carried yet. - **Limits.** Chunk sections size their global palette to the registry: 16 bits for vanilla's 35,723 states (the same chunks, saves and packets as before), one more bit each time content mods double it, up to 2^20 states (1,048,576). Past that the content root is refused with the @@ -398,6 +406,40 @@ Mechanical, the same for every mod, and no agent: carries those over. 5. Write `.hmod`. For a data-tier mod, it is now ported. +Two cases the oracle fills in: + +- **Loot registered in code.** Chipped ships 7 loot tables for about 7,000 blocks; the rest + drop themselves through Java code. When a declared block has no table in the jar and the + oracle shows vanilla's drop-self, carry writes that table in 26.3's shape. When only the + states with one property value drop it (a door's lower half), the entry gets vanilla's + `match_block` condition. Chipped: 6,843 tables added. +- **Worldgen carry-over.** Structure libraries give vanilla's types other names. Carry maps + these to vanilla's: + - `lithostitched:jigsaw`, MoogsStructureLib's and Repurposed Structures' generic jigsaws + become `minecraft:jigsaw`; + - their `advanced_random_spread` becomes `minecraft:random_spread`; + - their versioned, legacy and empty pool elements become vanilla's. + + The rules these libraries add on top of vanilla's (no start in liquid, a minimum distance, + caps per piece) are lost, so a mapped structure can start where the mod would not. NeoForge's + convention biome tags (`#c:is_forest`, ...) come from the loader jar + (`/loader/neoforge--universal.jar`, fetched dev-only and SHA-1 checked) and + are written into the carry. Each mod's `carry-report.json` lists what was mapped and the + types left as they are. The game skips the structures it cannot decode. + + On ATM10's 40 data-tier mods: + - 1,061 files were mapped (MVS 413, MNS 210, MSS 157, MES 110, Repurposed Structures 104, + ChoiceTheorem's Overhauled Village 66), and 103 convention biome tags written. + - When Dungeons Arise, Structory and Towns and Towers use vanilla's types already. + - Not generated yet, because their types are Java code: YUNG's API (491 elements and + jigsaws: every "YUNG's Better" mod), Formations (179), the nether jigsaw variants of Moog's + and Repurposed (69), MO Structures (38), and Repurposed's mineshafts, mansions, monuments + and cities. + + In a world with the 40 mods, seed 1234, `/locate structure mvs:azelea_house` finds one 27 + blocks from spawn and it stands there as the template builds it; When Dungeons Arise's + bandit towers and Structory's chapel locate too. + ### 5. Code: one agent per mod For tiers logic, machines and deep, in dependency order, as many agents at once as the AI @@ -473,12 +515,15 @@ user's jars are, and its facts and results stay in the work folder. The first re | Glassential-renewed 3.4.7 | 105/114 | 5177/5177 | 5177/5177 | 4727/5177 | 6447/6447 | 210/210 | 105/105 | 143/143 | 106/115 | | Factory Blocks 1.4.0 | 42/49 | 42/42 | 0/42 | 42/42 | 294/294 | 84/84 | 42/42 | 1/1 | 42/49 | | Cloud Glass 1.1.0 | 16/16 | 16/16 | 16/16 | 0/16 | 112/112 | 32/32 | – | 31/31 | 16/16 | +| Chipped 4.0.2 | 6857/6981 | 46212/46443 | 46443/46443 | 46396/46443 | 149093/149093 | 13548/13714 | 11984/12378 | 6/13 | 6849/6973 | What fails is what API 0.2 cannot express yet: shapes of their own (Japanese doors, hedges, paths a sixteenth high, glass without collision), sound events of the mod's own (`factory_blocks:metal_sound`), and blocks whose vanilla class has no vanilla block with the same states (garage doors, double gates, engraved and facing paths, fans). Every drop, recipe -and tag of the declared blocks matches. +and tag of the declared blocks matches. Chipped's 124 missing blocks are its own classes (workbenches and +`DirectionBlock`), and its workbench recipes need those blocks. Its drops match since carry writes +the self-drop tables it registers in code (step 4). ### 7. Coverage report @@ -520,9 +565,9 @@ files; `inventory`; `carry` and the harness on the eight mods we downloaded; `re By tier, the 367 not yet: data 57 (carry-over and the harness, no agent: their jars were not downloaded), logic 66 (API 0.3), machines 97 (0.4), deep 92 (0.5), client 35, unclassified 20. Ported: Macaw's Trapdoors. Partial: Macaw's Doors, Fences and Walls, Paths and Pavings, -Glassential, Factory Blocks, Cloud Glass (see the harness table) and MVS, whose 784 worldgen -files are carried but not yet read by the game. Of the 8, 7 are MIT and one LGPL; nothing is -published. +Glassential, Factory Blocks, Cloud Glass, Chipped (see the harness table) and MVS, whose +structures now generate (see step 4). Of the 9, 7 are MIT, one LGPL and Chipped is under the +Terrarium License; nothing is published. ## Measuring "10x" @@ -582,8 +627,9 @@ vanilla's 35,723; the per-state tables are the next thing to measure), while the inside its 2 GB heap. Caveats, so none of this is a "10x" claim yet: other sessions and CI runners kept the machine's load average between 30 and 56 on 14 threads, so the confidence intervals are as wide as the means (`perf_bench.py --table`); Horizon's frames are paced near -the display's 144 Hz at 8 chunks; Horizon's title time includes building the content overlay on -a first start (about 5 s, cached afterwards); and the pack runs 1.21.1 against Horizon's 26.3. +the display's 144 Hz at 8 chunks; Horizon's title time includes building the content overlay +(about 5 s for six mods; it was rebuilt on every start then, and is kept for later starts now); +and the pack runs 1.21.1 against Horizon's 26.3. A quiet rerun with more games is the next measurement. **Where the RAM goes (2026-10-17).** RSS overstates it on macOS. `ps` counts pages the allocator @@ -620,8 +666,44 @@ indexes ids by a hash checked against the states: -22 MB live for vanilla, -124 ATM10's, -30 MB and -140 MB of footprint. The startup peaks are what is left. Each step parses its per-state tables whole: as JSON trees, or as NBT trees of 300-600 MB each for ATM10 (`block-properties.nbt`, the collision, support, occlusion and movement tables). The peak -reaches 3.9 GB during worldgen loading, and the footprint stays near the peak. Typed, streaming -readers for those tables are the next cut. +reaches 3.9 GB during worldgen loading, and the footprint stays near the peak. + +The NBT tables now stream: the readers check each state's identity as it is read, and no +`states` tree is built (#753). That tree was about 240 MB for each table. With the carried +ATM10 mods (153,511 states), the peak of each step falls by about 210 MB: + +| step | before MB | after MB | +|---|---:|---:| +| light | 911 | 699 | +| collision | 945 | 733 | +| motion | 1,427 | 1,215 | +| worldgen, uncached | 3,000 | 2,788 | + +The fluid tables no longer decode the 211 MB `gameplay-facts.json` a second time (#754). The +content root is kept between starts (#756). What is left at startup: + +- `facts.json` goes through a JSON tree, then an NBT tree, in both the registry and the assets + step; +- on a first start, the content-root build and `Behaviours`' decode of `gameplay-facts.json` + (cached afterwards in the behaviour snapshot). + +**Against NeoForge, same 40 mods (2026-10-17).** The 40 data-tier mods carried from ATM10 (the +42 without Regions Unexplored and MO Structures, whose libraries are only on CurseForge), +against their jars on NeoForge 21.1.259 with `-Xmx2G`. `perf_bench.py --port-work`, RD 8, one +game each, load average 80-125 on 14 threads; `--warm` measures a later start: + +| game | title / world s | RSS steady / peak MB | footprint steady / peak MB | +|---|---|---|---| +| Horizon before #756 (every start) | 81.1 / 102.8 | 4,008 / 4,164 | 2,368 / 2,554 | +| Horizon, first start | 105.2 / 128.8 | 3,795 / 3,993 | 2,306 / 2,560 | +| **Horizon, later starts** | **21.6 / 33.7** | **2,629 / 2,935** | **2,445 / 2,731** | +| NeoForge + 40 mods | 53.2 / 119.9 | 3,099 / 3,203 | 3,304 / 3,381 | + +On later starts, Horizon uses 15 % less RSS and 26 % less footprint than NeoForge with the +same mods. It reaches the title 2.5x sooner and the world 3.6x sooner, and its flights ran at +93-233 FPS against NeoForge's 27-62. The first start is slower than NeoForge's to the title, +because it builds the content root once. One game per row on a loaded machine is not a +benchmark; a quiet rerun with repeats is still to do. ## The working version for 2026-10-23 @@ -648,11 +730,9 @@ In scope (each is a PR or a small stack): 6. **Measured:** load time, RAM and FPS of that pack on NeoForge 1.21.1 against Horizon, with the full ATM10 on NeoForge as the reference row. -Out of scope for that date, and next in order: worldgen carry-over (the 30 or so structure and biome mods; -the first one looked at, Moog's Voyager Structures, declares all 130 structures and 116 structure -sets with MoogsStructureLib's own `generic_jigsaw_structure` and `advanced_random_spread` types and -NeoForge's `c:` biome tags, so its carry needs a mapping to vanilla's jigsaw and random spread -types plus the oracle's biome tags, not only bundle merging), +Out of scope for that date, and next in order: the rest of worldgen carry-over (mods' +structures, sets, pools and features generate now, see step 4; mod biomes, noise and density +functions, and the structure types written in Java such as YUNG's and Formations', do not yet), behaviour callbacks and server events (0.3), block entities, menus, capabilities and net (0.4), the first agent-ported logic-tier mod as the pilot of step 5, then machines. Porting all of ATM10 is a campaign. Each step publishes its coverage number; we make no claim beyond what From ff9449099220d4039f93312652ba55d0d79a27c2 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 00:08:44 +0200 Subject: [PATCH 022/163] Block entities: tick only those with a ticker, in vanilla's order World::block_entities keeps vanilla's Level.blockEntityTickers beside the map: a slot when a block entity whose state has a ticker is added, kept when it is replaced, freed when it is removed, unloaded or its state loses the ticker; a loaded chunk's in its block entity map's order. The tick visits that list once, in block-ticking chunks within the world border, instead of scanning the whole map once per kind. New harness block_entity_tickers: real LevelChunks of a server level against BlockEntities. Co-Authored-By: Claude Opus 5.5 --- .../examples/block_entity_tickers_fixture.rs | 99 +++++ crates/horizon-client/src/block_entities.rs | 374 ++++++++++++++++++ crates/horizon-client/src/game.rs | 37 +- crates/horizon-client/src/game/beacon.rs | 25 +- crates/horizon-client/src/game/beehives.rs | 79 ++-- .../src/game/block_entity_ticks.rs | 140 +++++++ .../horizon-client/src/game/command_blocks.rs | 4 +- crates/horizon-client/src/game/creaking.rs | 73 ++-- .../src/game/dispense_fixture.rs | 12 +- crates/horizon-client/src/game/jukebox.rs | 94 ++--- crates/horizon-client/src/game/machines.rs | 61 ++- .../src/game/machines/crafter.rs | 59 ++- .../horizon-client/src/game/render_control.rs | 2 +- crates/horizon-client/src/game/spawner.rs | 48 +-- .../horizon-client/src/game/trial_spawner.rs | 41 +- .../horizon-client/src/game/trial_visuals.rs | 2 +- crates/horizon-client/src/game/vault.rs | 31 +- crates/horizon-client/src/lib.rs | 1 + crates/horizon-client/src/streaming.rs | 2 +- crates/horizon-client/src/world.rs | 17 +- .../VanillaBlockEntityTickerOracle.java | 217 ++++++++++ tools/test_block_entity_tickers_parity.py | 132 +++++++ 22 files changed, 1209 insertions(+), 341 deletions(-) create mode 100644 crates/horizon-client/examples/block_entity_tickers_fixture.rs create mode 100644 crates/horizon-client/src/block_entities.rs create mode 100644 crates/horizon-client/src/game/block_entity_ticks.rs create mode 100644 mods/horizon/src/test/java/dev/horizonlab/parity/VanillaBlockEntityTickerOracle.java create mode 100644 tools/test_block_entity_tickers_parity.py diff --git a/crates/horizon-client/examples/block_entity_tickers_fixture.rs b/crates/horizon-client/examples/block_entity_tickers_fixture.rs new file mode 100644 index 000000000..f08c333f6 --- /dev/null +++ b/crates/horizon-client/examples/block_entity_tickers_fixture.rs @@ -0,0 +1,99 @@ +//! The Rust side of tools/test_block_entity_tickers_parity.py: the ops of +//! `VanillaBlockEntityTickerOracle` on `BlockEntities`, as `World` drives it +//! (a state write calls `state_changed`), printing the tick order. +use horizon_client::{ + block_entities::{BlockEntities, Pos, Ticking}, + containers::BlockEntity, +}; +use std::collections::HashMap; + +/// State ids of the fixture: 0 air, 1 a block whose block entity ticks, 2 a +/// jukebox without a record, 3 a block entity that never ticks (a chest). +fn state(name: &str) -> u32 { + match name { + "chest" | "barrel" => 3, + "jukebox" => 2, + _ => 1, + } +} + +fn entity(name: &str) -> BlockEntity { + if name.starts_with("jukebox") { + // The game makes a jukebox's block entity when a record goes in. + return BlockEntity::Jukebox(Default::default()); + } + BlockEntity::for_block(&format!("minecraft:{name}")) + .unwrap_or_else(|| panic!("no block entity for {name}")) +} + +fn main() { + let args: Vec = std::env::args().collect(); + let input = std::fs::read_to_string(&args[1]).expect("input"); + let mut out = String::new(); + let mut entities = BlockEntities::default(); + let mut states: HashMap = HashMap::new(); + let mut kinds: HashMap = HashMap::new(); + let table = vec![Ticking::No, Ticking::Yes, Ticking::Idle, Ticking::No]; + for line in input.lines() { + let w: Vec<&str> = line.split_whitespace().collect(); + let pos = |i: usize| -> Pos { + let n = |j: usize| w[i + j].parse::().expect("coordinate"); + (n(0), n(1), n(2)) + }; + match w[0] { + "reset" => { + entities = BlockEntities::default(); + entities.set_states(table.clone()); + states.clear(); + kinds.clear(); + } + "load" => { + let mut chunk = Vec::new(); + for i in (3..w.len()).step_by(4) { + let p = pos(i + 1); + states.insert(p, state(w[i])); + kinds.insert(p, w[i].to_owned()); + chunk.push((p, entity(w[i]))); + } + entities.load_chunk(chunk); + } + "place" => { + let p = pos(2); + // World::set, then the game adds the block entity. + let old = states.insert(p, state(w[1])).unwrap_or(0); + kinds.insert(p, w[1].to_owned()); + entities.state_changed(p, old, state(w[1])); + entities.insert(p, entity(w[1])); + } + "replace" => { + let p = pos(1); + entities.insert(p, entity(&kinds[&p])); + } + "remove" => { + let p = pos(1); + entities.remove(&p); + let old = states.insert(p, 0).unwrap_or(0); + entities.state_changed(p, old, 0); + } + "record" => { + let p = pos(1); + let s = if w[4] == "1" { 1 } else { 2 }; + let old = states.insert(p, s).unwrap_or(0); + entities.state_changed(p, old, s); + } + "unload" => { + let c = (w[1].parse::().unwrap(), w[2].parse::().unwrap()); + entities.retain(|p, _| (p.0 >> 4, p.2 >> 4) != c); + } + "tick" => { + out.push_str("tick"); + for (p, _) in entities.tickers(|p| states.get(&p).copied().unwrap_or(0)) { + out.push_str(&format!(" {},{},{}", p.0, p.1, p.2)); + } + out.push('\n'); + } + other => panic!("unknown op {other}"), + } + } + std::fs::write(&args[2], out).expect("output"); +} diff --git a/crates/horizon-client/src/block_entities.rs b/crates/horizon-client/src/block_entities.rs new file mode 100644 index 000000000..f4b0c411d --- /dev/null +++ b/crates/horizon-client/src/block_entities.rs @@ -0,0 +1,374 @@ +//! The world's block entities and the order they tick in: vanilla's +//! `Level.blockEntityTickers`, kept beside the block entity map so a tick +//! visits only the block entities that tick, in vanilla's order, instead of +//! scanning the whole map once per kind. +//! +//! The list follows `LevelChunk.updateBlockEntityTicker` and +//! `Level.tickBlockEntities`: +//! - a block entity whose block state has a ticker gets a slot at the end of +//! the list (through `pendingBlockEntityTickers`, so a slot made during a +//! tick first ticks on the next one); +//! - replacing the block entity at a position (`setBlockEntity`), or changing +//! its block state to another state with a ticker, keeps its slot +//! (`RebindableTickingBlockEntityWrapper.rebind`); +//! - removing it (`removeBlockEntity`), unloading its chunk +//! (`clearAllBlockEntities`) or changing its state to one without a ticker +//! (a jukebox losing its record) frees the slot; a later ticker there is +//! appended again; +//! - a loaded chunk's block entities are added in the iteration order of its +//! `Object2ObjectOpenHashMap` +//! (`registerAllBlockEntitiesAfterLevelLoad`), filled in the order the chunk +//! listed them. +//! +//! Which states tick is a table by state id, built by the game from the block +//! registry; whether a slot is made is decided when the slot is promoted at +//! the start of the next tick, from the block state then. +use crate::containers::BlockEntity; +use crate::fast_hash::FxHashMap; +use std::collections::HashMap; + +pub type Pos = (i32, i32, i32); + +/// What a block state's block entity does each tick (`BlockState.getTicker`). +#[derive(Clone, Copy, Debug, Default, PartialEq, Eq)] +pub enum Ticking { + /// No ticker, and the block has no block entity that could have one. + #[default] + No, + /// A ticker. + Yes, + /// The block's block entity, but this state has no ticker (a jukebox + /// without a record): a state change to it frees the slot. + Idle, +} + +#[derive(Default)] +pub struct BlockEntities { + map: HashMap, + /// `Level.blockEntityTickers`: positions and the slot each was given. + tickers: Vec<(Pos, u32)>, + /// `LevelChunk.tickersInLevel`: the live slot of each ticking position. + live: FxHashMap, + /// Positions that may need a slot, in the order vanilla would have made + /// it (`pendingBlockEntityTickers`), each with a token; decided at the + /// next promotion from the block state then. + added: Vec<(Pos, u32)>, + /// The token of each position's pending entry: an entry whose token is + /// not here any more was cancelled. + pending: FxHashMap, + next_slot: u32, + /// `Ticking` by block state id; empty until the game builds it. + states: Vec, +} + +impl std::ops::Deref for BlockEntities { + type Target = HashMap; + fn deref(&self) -> &Self::Target { + &self.map + } +} + +impl<'a> IntoIterator for &'a BlockEntities { + type Item = (&'a Pos, &'a BlockEntity); + type IntoIter = std::collections::hash_map::Iter<'a, Pos, BlockEntity>; + fn into_iter(self) -> Self::IntoIter { + self.map.iter() + } +} + +/// `Vec3i.hashCode`. +fn java_hash((x, y, z): Pos) -> i32 { + y.wrapping_add(z.wrapping_mul(31)) + .wrapping_mul(31) + .wrapping_add(x) +} +/// `HashCommon.mix`. +fn mix(x: i32) -> usize { + let h = (x as u32).wrapping_mul(0x9E37_79B9); + (h ^ (h >> 16)) as usize +} + +/// The order `values().forEach` visits a `new Object2ObjectOpenHashMap<>()` +/// keyed by these positions, put in this order (repeats keep their first +/// slot): open addressing with linear probing, a rehash to twice the size +/// past three quarters full, and iteration from the last slot down. +pub fn chunk_map_order(positions: impl IntoIterator) -> Vec { + // HashCommon.arraySize(16, .75f), and maxFill of each size. + let mut slots: Vec> = vec![None; 32]; + let max_fill = |n: usize| (n * 3).div_ceil(4).min(n - 1); + let mut size = 0; + for p in positions { + let mask = slots.len() - 1; + let mut at = mix(java_hash(p)) & mask; + let mut known = false; + while let Some(k) = slots[at] { + if k == p { + known = true; + break; + } + at = (at + 1) & mask; + } + if known { + continue; + } + slots[at] = Some(p); + // `if (size++ >= maxFill) rehash(arraySize(size + 1, f))`, which + // puts the keys back from the last slot down. + size += 1; + if size > max_fill(slots.len()) { + let n = ((size + 1) * 4).div_ceil(3).next_power_of_two(); + let old = std::mem::replace(&mut slots, vec![None; n]); + for k in old.into_iter().rev().flatten() { + let mut at = mix(java_hash(k)) & (n - 1); + while slots[at].is_some() { + at = (at + 1) & (n - 1); + } + slots[at] = Some(k); + } + } + } + slots.into_iter().rev().flatten().collect() +} + +impl BlockEntities { + /// Whether the ticking table has been built. + pub fn has_states(&self) -> bool { + !self.states.is_empty() + } + pub fn set_states(&mut self, states: Vec) { + self.states = states; + } + pub fn take_states(&mut self) -> Vec { + std::mem::take(&mut self.states) + } + pub fn ticking(&self, state: u32) -> Ticking { + self.states.get(state as usize).copied().unwrap_or_default() + } + + fn next(&mut self) -> u32 { + let n = self.next_slot; + self.next_slot = n.wrapping_add(1); + n + } + /// A ticker may be made for `pos` now (`updateBlockEntityTicker`). + fn add(&mut self, pos: Pos) { + let token = self.next(); + self.pending.insert(pos, token); + self.added.push((pos, token)); + } + /// `removeBlockEntityTicker`: no slot, made or pending. + fn cancel(&mut self, pos: &Pos) { + self.live.remove(pos); + self.pending.remove(pos); + } + + pub fn get_mut(&mut self, pos: &Pos) -> Option<&mut BlockEntity> { + self.map.get_mut(pos) + } + pub fn iter_mut(&mut self) -> impl Iterator { + self.map.iter_mut() + } + pub fn values_mut(&mut self) -> impl Iterator { + self.map.values_mut() + } + /// `LevelChunk.setBlockEntity` (+ `addAndRegisterBlockEntity`): a new + /// block entity may get a slot; one replacing another keeps its slot. + pub fn insert(&mut self, pos: Pos, entity: BlockEntity) -> Option { + let old = self.map.insert(pos, entity); + if old.is_none() { + self.add(pos); + } + old + } + /// The block entity at `pos`, made by `make` when there is none. + pub fn get_or_insert_with( + &mut self, + pos: Pos, + make: impl FnOnce() -> BlockEntity, + ) -> &mut BlockEntity { + if !self.map.contains_key(&pos) { + self.add(pos); + } + self.map.entry(pos).or_insert_with(make) + } + /// `LevelChunk.removeBlockEntity`: the block entity and its slot. + pub fn remove(&mut self, pos: &Pos) -> Option { + self.cancel(pos); + self.map.remove(pos) + } + /// The block entity at `pos`, out of the map for a while: its slot stays + /// for `put` to bring it back (a tick working on it). + pub fn take(&mut self, pos: &Pos) -> Option { + self.map.remove(pos) + } + /// Brings back what `take` took, in its slot. + pub fn put(&mut self, pos: Pos, entity: BlockEntity) { + if self.map.insert(pos, entity).is_none() + && !self.live.contains_key(&pos) + && !self.pending.contains_key(&pos) + { + self.add(pos); + } + } + /// Removes the block entities `keep` refuses, and their slots + /// (`clearAllBlockEntities` of unloaded chunks). + pub fn retain(&mut self, mut keep: impl FnMut(&Pos, &mut BlockEntity) -> bool) { + let (live, pending) = (&mut self.live, &mut self.pending); + self.map.retain(|p, e| { + let kept = keep(p, e); + if !kept { + live.remove(p); + pending.remove(p); + } + kept + }); + } + pub fn clear(&mut self) { + self.map.clear(); + self.tickers.clear(); + self.live.clear(); + self.added.clear(); + self.pending.clear(); + } + /// A loaded or generated chunk's block entities, in the order the chunk + /// lists them; they tick in its block entity map's order + /// (`registerAllBlockEntitiesAfterLevelLoad`). + pub fn load_chunk(&mut self, entities: Vec<(Pos, BlockEntity)>) { + let order = chunk_map_order(entities.iter().map(|(p, _)| *p)); + for (p, e) in entities { + self.map.insert(p, e); + } + for p in order { + self.add(p); + } + } + /// `LevelChunk.setBlockState` on a block entity's position, from state + /// `old` to `new`: a ticker made, kept or dropped. + pub fn state_changed(&mut self, pos: Pos, old: u32, new: u32) { + if self.states.is_empty() || !self.map.contains_key(&pos) { + return; + } + match self.ticking(new) { + // A new ticker, unless one was made or is pending (rebound). + Ticking::Yes => { + if self.ticking(old) != Ticking::Yes && !self.live.contains_key(&pos) { + self.add(pos); + } + } + Ticking::Idle => self.cancel(&pos), + // Another block: the game removes or replaces the block entity. + Ticking::No => {} + } + } + /// The start of `Level.tickBlockEntities`: pending slots join the list + /// and freed ones leave it. `state` reads the block state at a position. + /// Returns the slots to tick, in order; check each with `is_live` before + /// ticking it, as the ticks before it can free it. + pub fn tickers(&mut self, state: impl Fn(Pos) -> u32) -> Vec<(Pos, u32)> { + for (pos, token) in std::mem::take(&mut self.added) { + if self.pending.get(&pos) != Some(&token) { + continue; + } + self.pending.remove(&pos); + if self.live.contains_key(&pos) + || !self.map.contains_key(&pos) + || self.ticking(state(pos)) != Ticking::Yes + { + continue; + } + let slot = self.next(); + self.live.insert(pos, slot); + self.tickers.push((pos, slot)); + } + let (live, map) = (&mut self.live, &self.map); + self.tickers.retain(|(p, slot)| { + let mine = live.get(p) == Some(slot); + if mine && !map.contains_key(p) { + live.remove(p); + } + mine && map.contains_key(p) + }); + self.tickers.clone() + } + /// Whether a slot from `tickers` still ticks. + pub fn is_live(&self, (pos, slot): (Pos, u32)) -> bool { + self.live.get(&pos) == Some(&slot) && self.map.contains_key(&pos) + } + /// Frees the slot at `pos` (the block entity stays). + pub fn forget(&mut self, pos: &Pos) { + self.cancel(pos); + } +} + +#[cfg(test)] +mod tests { + use super::*; + + fn hopper() -> BlockEntity { + BlockEntity::Chest(vec![None; 5]) + } + /// States: 0 air, 1 ticks, 2 idle. + fn level() -> BlockEntities { + let mut b = BlockEntities::default(); + b.set_states(vec![Ticking::No, Ticking::Yes, Ticking::Idle]); + b + } + fn order(b: &mut BlockEntities, states: &HashMap) -> Vec { + b.tickers(|p| states.get(&p).copied().unwrap_or(0)) + .into_iter() + .map(|(p, _)| p) + .collect() + } + + #[test] + fn slots_follow_vanilla_lifecycle() { + let mut b = level(); + let mut s = HashMap::new(); + for p in [(0, 0, 0), (1, 0, 0), (2, 0, 0)] { + s.insert(p, 1); + b.insert(p, hopper()); + } + assert_eq!(order(&mut b, &s), [(0, 0, 0), (1, 0, 0), (2, 0, 0)]); + // Replacing keeps the slot; removing and placing again appends. + b.insert((0, 0, 0), hopper()); + b.remove(&(1, 0, 0)); + b.insert((1, 0, 0), hopper()); + assert_eq!(order(&mut b, &s), [(0, 0, 0), (2, 0, 0), (1, 0, 0)]); + // Take and put keep it; an idle state frees it, ticking again appends. + let e = b.take(&(0, 0, 0)).unwrap(); + b.put((0, 0, 0), e); + assert_eq!(order(&mut b, &s), [(0, 0, 0), (2, 0, 0), (1, 0, 0)]); + s.insert((2, 0, 0), 2); + b.state_changed((2, 0, 0), 1, 2); + assert_eq!(order(&mut b, &s), [(0, 0, 0), (1, 0, 0)]); + s.insert((2, 0, 0), 1); + b.state_changed((2, 0, 0), 2, 1); + assert_eq!(order(&mut b, &s), [(0, 0, 0), (1, 0, 0), (2, 0, 0)]); + // A slot freed during a tick is not live any more. + let slots = b.tickers(|p| s.get(&p).copied().unwrap_or(0)); + b.retain(|p, _| *p != (1, 0, 0)); + assert!(b.is_live(slots[0]) && !b.is_live(slots[1])); + } + + #[test] + fn chunk_loads_in_open_hash_map_order() { + // A few keys: their mixed hashes over 32 slots, read from the top. + let positions = [ + (0, 64, 0), + (1, 64, 0), + (0, 64, 1), + (15, -64, 15), + (3, 70, 9), + ]; + let slot = |p: &Pos| mix(java_hash(*p)) & 31; + let mut expected = positions.to_vec(); + expected.sort_by_key(|p| std::cmp::Reverse(slot(p))); + let distinct: std::collections::HashSet = positions.iter().map(slot).collect(); + assert_eq!(distinct.len(), positions.len()); + assert_eq!(chunk_map_order(positions), expected); + // Past 24 keys the table doubles; every key stays, once. + let many: Vec = (0..100).map(|i| (i % 16, i / 16, 3)).collect(); + let order = chunk_map_order(many.iter().copied().chain(many.iter().copied())); + assert_eq!(order.len(), 100); + } +} diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 117f7a194..ae63ec36f 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -10,6 +10,7 @@ mod banners; mod beacon; mod beehives; mod block_entity_anims; +mod block_entity_ticks; mod block_items; mod blockctl; mod boats; @@ -2196,13 +2197,13 @@ impl Game<'_> { self.audio .play("minecraft:block.ender_chest.open", Some(at), 0.5, pitch); } else if &*name == "minecraft:beacon" && self.open_station(pos, &name) { - self.world.block_entities.entry(key).or_insert_with(|| { + self.world.block_entities.get_or_insert_with(key, || { BlockEntity::for_block(&name).unwrap_or(BlockEntity::Chest(Vec::new())) }); } else if storage::is_shulker_box(&name) && !self.shulker_can_open(pos) { // ShulkerBoxBlock.canOpen: the lid has no room; nothing opens. } else if let Some(entity) = BlockEntity::for_block(&name) { - self.world.block_entities.entry(key).or_insert(entity); + self.world.block_entities.get_or_insert_with(key, || entity); let centre = [ f64::from(key.0) + 0.5, f64::from(key.1) + 0.5, @@ -6087,38 +6088,6 @@ impl Game<'_> { false, ) } - fn tick_block_entities(&mut self) -> Result<()> { - self.tick_hoppers()?; - self.tick_crafters(); - self.tick_mount_menu(); - self.tick_jukeboxes(); - self.tick_beacons(); - self.tick_creaking_hearts()?; - self.tick_spawners()?; - self.tick_trial_spawners()?; - self.tick_vaults()?; - self.tick_beehives(); - let mut lit_changes = Vec::new(); - for (pos, entity) in self.world.block_entities.iter_mut() { - if let BlockEntity::Furnace(f) = entity - && let Some(lit) = f.tick(&self.res.recipes, &self.res.items, &self.res.providers) - { - lit_changes.push((*pos, lit)); - } - } - for ((x, y, z), lit) in lit_changes { - let state = self.world.block(x, y, z); - if let Some(mut s) = self.pack.assets.registry.state(state).cloned() - && s.properties.contains_key("lit") - { - s.properties.insert("lit".into(), lit.to_string()); - if let Ok(id) = self.pack.assets.registry.resolve(&s) { - self.world.set(x, y, z, id)?; - } - } - } - Ok(()) - } /// Copies of a save batch carrying its live block entities and save data. fn with_entities<'a>( &self, diff --git a/crates/horizon-client/src/game/beacon.rs b/crates/horizon-client/src/game/beacon.rs index c8c437965..73cdd15a4 100644 --- a/crates/horizon-client/src/game/beacon.rs +++ b/crates/horizon-client/src/game/beacon.rs @@ -105,24 +105,13 @@ impl Game<'_> { .find(|&y| !self.res.facts.is_air(self.world.block(x, y, z))) .map_or(min, |y| y + 1) } - /// `BeaconBlockEntity.tick` for every beacon. - pub(super) fn tick_beacons(&mut self) { - let keys: Vec<(i32, i32, i32)> = self - .world - .block_entities - .iter() - .filter(|(_, e)| matches!(e, BlockEntity::Beacon(_))) - .map(|(k, _)| *k) - .collect(); - for key in keys { - let Some(BlockEntity::Beacon(mut b)) = self.world.block_entities.remove(&key) else { - continue; - }; - self.tick_beacon(key, &mut b); - self.world - .block_entities - .insert(key, BlockEntity::Beacon(b)); - } + /// `BeaconBlockEntity.tick` of the beacon at `key`. + pub(super) fn tick_beacon_at(&mut self, key: (i32, i32, i32)) { + let Some(BlockEntity::Beacon(mut b)) = self.world.block_entities.take(&key) else { + return; + }; + self.tick_beacon(key, &mut b); + self.world.block_entities.put(key, BlockEntity::Beacon(b)); } fn tick_beacon(&mut self, (x, y, z): (i32, i32, i32), b: &mut Beacon) { let mut check = if b.last_check_y < y { diff --git a/crates/horizon-client/src/game/beehives.rs b/crates/horizon-client/src/game/beehives.rs index 0520e4367..52fed3f3b 100644 --- a/crates/horizon-client/src/game/beehives.rs +++ b/crates/horizon-client/src/game/beehives.rs @@ -87,48 +87,37 @@ impl Game<'_> { let facing = beehive::facing_step(props.get("facing").map(String::as_str)); Some((honey, facing)) } - /// `BeehiveBlockEntity.serverTick` for every hive, after an emergency - /// exit for those with fire beside them (`BeehiveBlock.updateShape`). - pub(super) fn tick_beehives(&mut self) { - let mut keys: Vec<(i32, i32, i32)> = self - .world - .block_entities - .iter() - .filter(|(_, e)| matches!(e, BlockEntity::Beehive(_))) - .map(|(k, _)| *k) - .collect(); - keys.sort_unstable(); - for key in keys { - let at = [key.0, key.1, key.2]; - let Some((honey, facing)) = self.hive_state(at) else { - continue; - }; - let Some(BlockEntity::Beehive(mut hive)) = self.world.block_entities.remove(&key) - else { - continue; - }; - let fire = [ - [1, 0, 0], - [-1, 0, 0], - [0, 1, 0], - [0, -1, 0], - [0, 0, 1], - [0, 0, -1], - ] - .iter() - .any(|d| { - let state = self.world.block(at[0] + d[0], at[1] + d[1], at[2] + d[2]); - &*self.res.facts.get(state).name == "minecraft:fire" - }); - let mut host = GameHive { game: self }; - if fire && !hive.bees.is_empty() { - hive.release_all(at, facing, honey, Release::Emergency, &mut host); - } - hive.server_tick(at, facing, honey, &mut host); - self.world - .block_entities - .insert(key, BlockEntity::Beehive(hive)); + /// `BeehiveBlockEntity.serverTick` of the hive at `key`, after an + /// emergency exit if fire is beside it (`BeehiveBlock.updateShape`). + pub(super) fn tick_beehive(&mut self, key: (i32, i32, i32)) { + let at = [key.0, key.1, key.2]; + let Some((honey, facing)) = self.hive_state(at) else { + return; + }; + let Some(BlockEntity::Beehive(mut hive)) = self.world.block_entities.take(&key) else { + return; + }; + let fire = [ + [1, 0, 0], + [-1, 0, 0], + [0, 1, 0], + [0, -1, 0], + [0, 0, 1], + [0, 0, -1], + ] + .iter() + .any(|d| { + let state = self.world.block(at[0] + d[0], at[1] + d[1], at[2] + d[2]); + &*self.res.facts.get(state).name == "minecraft:fire" + }); + let mut host = GameHive { game: self }; + if fire && !hive.bees.is_empty() { + hive.release_all(at, facing, honey, Release::Emergency, &mut host); } + hive.server_tick(at, facing, honey, &mut host); + self.world + .block_entities + .put(key, BlockEntity::Beehive(hive)); } /// `BeehiveBlockEntity.addOccupant` for a bee its `BeeEnterHiveGoal` /// sent in: off its lead, its tag stored, the bee gone. @@ -152,13 +141,13 @@ impl Game<'_> { self.mobs[i].extra.mount = None; let tag = self.mob_tree_nbt(i); let flower = bee::get(&self.mobs[i]).and_then(|b| b.flower); - let Some(BlockEntity::Beehive(mut hive)) = self.world.block_entities.remove(&key) else { + let Some(BlockEntity::Beehive(mut hive)) = self.world.block_entities.take(&key) else { return; }; let stored = hive.add_occupant(at, tag, flower, &mut GameHive { game: self }); self.world .block_entities - .insert(key, BlockEntity::Beehive(hive)); + .put(key, BlockEntity::Beehive(hive)); if stored && let Some(m) = self.mobs.iter_mut().find(|m| m.id == mob) { m.removed = true; } @@ -166,13 +155,13 @@ impl Game<'_> { /// `BeehiveBlockEntity.emptyAllLivingFromHive` with no player about. pub(super) fn empty_hive(&mut self, at: [i32; 3], facing: [i32; 2], status: Release) { let key = (at[0], at[1], at[2]); - let Some(BlockEntity::Beehive(mut hive)) = self.world.block_entities.remove(&key) else { + let Some(BlockEntity::Beehive(mut hive)) = self.world.block_entities.take(&key) else { return; }; hive.release_all(at, facing, None, status, &mut GameHive { game: self }); self.world .block_entities - .insert(key, BlockEntity::Beehive(hive)); + .put(key, BlockEntity::Beehive(hive)); } /// `BeehiveBlock.playerDestroy` without silk touch: the bees come out /// angry at the player unless smoke calms them, then diff --git a/crates/horizon-client/src/game/block_entity_ticks.rs b/crates/horizon-client/src/game/block_entity_ticks.rs new file mode 100644 index 000000000..7de960716 --- /dev/null +++ b/crates/horizon-client/src/game/block_entity_ticks.rs @@ -0,0 +1,140 @@ +//! `Level.tickBlockEntities` for the block entities ticked together here +//! (hoppers, crafters, jukeboxes, beacons, creaking hearts, spawners, trial +//! spawners, vaults, beehives and furnaces): only those whose state has a +//! ticker, in vanilla's list order (`horizon_client::block_entities`), in +//! chunks that tick blocks. Sculk, brewing stands and pistons tick in their +//! own passes. +use super::Game; +use horizon_client::{ + Result, + block_entities::{Pos, Ticking}, + containers::{BlockEntity, FurnaceKind, HOPPER_SLOTS}, +}; +use horizon_world::registry::BlockStateId; + +impl Game<'_> { + pub(super) fn tick_block_entities(&mut self) -> Result<()> { + self.tick_mount_menu(); + self.load_entity_types(); + if !self.world.block_entities.has_states() { + let states = self.ticking_states(); + self.world.block_entities.set_states(states); + } + self.forget_gone_hoppers(); + let ticking = self.block_ticking_area(); + let mut spawners = Vec::new(); + let mut trial_spawners = Vec::new(); + for slot in self.world.block_entity_tickers() { + let pos = slot.0; + // Ticks before this one can remove it (`TickingBlockEntity.isRemoved`). + if !self.world.block_entities.is_live(slot) + || !ticking(pos.0, pos.2) + || !self.border.contains(f64::from(pos.0), f64::from(pos.2)) + { + continue; + } + match self.world.block_entities.get(&pos) { + Some(BlockEntity::Chest(items)) if items.len() == HOPPER_SLOTS => { + self.tick_hopper(pos) + } + Some(BlockEntity::Crafter(_)) => self.tick_crafter(pos), + Some(BlockEntity::Jukebox(_)) => self.tick_jukebox(pos), + Some(BlockEntity::Beacon(_)) => self.tick_beacon_at(pos), + Some(BlockEntity::CreakingHeart(_)) => self.tick_creaking_heart(pos)?, + Some(BlockEntity::Spawner(_)) => { + self.tick_spawner(pos)?; + spawners.push(pos); + } + Some(BlockEntity::TrialSpawner(_)) => { + self.tick_trial_spawner(pos)?; + trial_spawners.push(pos); + } + Some(BlockEntity::Vault(_)) => self.tick_vault(pos)?, + Some(BlockEntity::Beehive(_)) => self.tick_beehive(pos), + Some(BlockEntity::Furnace(_)) => self.tick_furnace(pos)?, + _ => {} + } + } + self.update_song_volumes(); + self.scan_for_hearts(); + self.client_tick_spawners(&spawners); + for key in trial_spawners { + self.client_tick_trial_spawner(key); + } + Ok(()) + } + /// `BlockState.getTicker` of every state, for the block entities ticked + /// here. A creaking heart keeps its slot while uprooted (see + /// `tick_creaking_heart`). + fn ticking_states(&self) -> Vec { + let registry = self.pack.assets.registry; + (0..registry.len()) + .map(|i| { + let state = BlockStateId(i as u32); + let name: &str = &self.res.facts.get(state).name; + match name { + "minecraft:hopper" + | "minecraft:crafter" + | "minecraft:beacon" + | "minecraft:creaking_heart" + | "minecraft:spawner" + | "minecraft:trial_spawner" + | "minecraft:vault" + | "minecraft:beehive" + | "minecraft:bee_nest" => Ticking::Yes, + "minecraft:jukebox" => { + let record = registry + .state(state) + .and_then(|s| s.properties.get("has_record")) + .is_some_and(|v| v == "true"); + if record { Ticking::Yes } else { Ticking::Idle } + } + n if FurnaceKind::from_block(n).is_some() => Ticking::Yes, + _ => Ticking::No, + } + }) + .collect() + } + /// `ServerLevel.shouldTickBlocksAt`: chunks within the simulation + /// distance plus one (`DistanceManager.inBlockTickingRange`, Chebyshev + /// in chunks) of the player or a guest. With nobody there, a dedicated + /// server ticks none; the game alone (no player yet, headless fixtures) + /// ticks every chunk. + fn block_ticking_area(&self) -> impl Fn(i32, i32) -> bool + use<> { + let d = self.settings.simulation_distance.max(2) + 1; + let mut centres: Vec<(i32, i32)> = self.streaming.extra.iter().map(|&(c, _)| c).collect(); + if let Some(p) = &self.player { + centres.push(( + (p.position.x.floor() as i32) >> 4, + (p.position.z.floor() as i32) >> 4, + )); + } + let everywhere = centres.is_empty() && self.options.dedicated.is_none(); + move |x, z| { + everywhere + || centres + .iter() + .any(|&(cx, cz)| ((x >> 4) - cx).abs().max(((z >> 4) - cz).abs()) <= d) + } + } + /// `AbstractFurnaceBlockEntity.serverTick` of the furnace at `pos`, and + /// its block's `lit` following it. + fn tick_furnace(&mut self, pos: Pos) -> Result<()> { + let Some(BlockEntity::Furnace(f)) = self.world.block_entities.get_mut(&pos) else { + return Ok(()); + }; + let Some(lit) = f.tick(&self.res.recipes, &self.res.items, &self.res.providers) else { + return Ok(()); + }; + let state = self.world.block(pos.0, pos.1, pos.2); + if let Some(mut s) = self.pack.assets.registry.state(state).cloned() + && s.properties.contains_key("lit") + { + s.properties.insert("lit".into(), lit.to_string()); + if let Ok(id) = self.pack.assets.registry.resolve(&s) { + self.world.set(pos.0, pos.1, pos.2, id)?; + } + } + Ok(()) + } +} diff --git a/crates/horizon-client/src/game/command_blocks.rs b/crates/horizon-client/src/game/command_blocks.rs index 5a5fa11c8..92e7d9979 100644 --- a/crates/horizon-client/src/game/command_blocks.rs +++ b/crates/horizon-client/src/game/command_blocks.rs @@ -598,13 +598,13 @@ impl Game<'_> { if let Ok(id) = registry.resolve(&wanted) && wanted != *current { - let entity = self.world.block_entities.remove(&pos); + let entity = self.world.block_entities.take(&pos); let at = BlockPos::new(pos.0, pos.1, pos.2); self.with_level(|b, level, ticks| { b.set_block(level, ticks, at, id, flags::UPDATE_CLIENTS) }); if let Some(entity) = entity { - self.world.block_entities.insert(pos, entity); + self.world.block_entities.put(pos, entity); } let _ = self.process_level_events(); } diff --git a/crates/horizon-client/src/game/creaking.rs b/crates/horizon-client/src/game/creaking.rs index 099f3d7d8..e9d04b6fd 100644 --- a/crates/horizon-client/src/game/creaking.rs +++ b/crates/horizon-client/src/game/creaking.rs @@ -164,7 +164,7 @@ impl Game<'_> { return; } let key = (home[0], home[1], home[2]); - let Some(BlockEntity::CreakingHeart(mut heart)) = self.world.block_entities.remove(&key) + let Some(BlockEntity::CreakingHeart(mut heart)) = self.world.block_entities.take(&key) else { return; }; @@ -173,7 +173,7 @@ impl Game<'_> { }); self.world .block_entities - .insert(key, BlockEntity::CreakingHeart(heart)); + .put(key, BlockEntity::CreakingHeart(heart)); } /// `Creaking.tearDown`: the crumble particles. pub(super) fn creaking_tear_down(&mut self, center: [f64; 3], spread: [f64; 3]) { @@ -220,7 +220,7 @@ impl Game<'_> { /// death and a natural heart drops experience. pub(super) fn creaking_heart_broken(&mut self, pos: [i32; 3]) { let key = (pos[0], pos[1], pos[2]); - let Some(BlockEntity::CreakingHeart(mut heart)) = self.world.block_entities.remove(&key) + let Some(BlockEntity::CreakingHeart(mut heart)) = self.world.block_entities.take(&key) else { return; }; @@ -248,43 +248,35 @@ impl Game<'_> { } self.world .block_entities - .insert(key, BlockEntity::CreakingHeart(heart)); + .put(key, BlockEntity::CreakingHeart(heart)); } - /// `CreakingHeartBlockEntity.serverTick` for every heart. - pub(super) fn tick_creaking_hearts(&mut self) -> Result<()> { - let keys: Vec = self - .world - .block_entities - .iter() - .filter(|(_, e)| matches!(e, BlockEntity::CreakingHeart(_))) - .map(|(k, _)| *k) - .collect(); - for key in keys { - let Some(BlockEntity::CreakingHeart(mut heart)) = - self.world.block_entities.remove(&key) - else { - continue; - }; - let state = self.world.block(key.0, key.1, key.2); - if &*self.res.facts.get(state).name != "minecraft:creaking_heart" { - // The block is gone: preRemoveSideEffects. - self.with_heart(key, &mut heart, |h, _, _, host, out| { - creaking_heart::remove_protector(h, host, false, out); - })?; - continue; - } - // getTicker: none once uprooted. - if self.heart_state_name(state) != "uprooted" { - let pos = [key.0, key.1, key.2]; - self.with_heart(key, &mut heart, |h, w, lr, host, out| { - creaking_heart::server_tick(h, pos, w, lr, host, out); - })?; - } - self.world - .block_entities - .insert(key, BlockEntity::CreakingHeart(heart)); + /// `CreakingHeartBlockEntity.serverTick` of the heart at `key`. Its slot + /// stays while uprooted, so that a heart whose block went away is still + /// found here and lets go of its protector. + pub(super) fn tick_creaking_heart(&mut self, key: Pos) -> Result<()> { + let Some(BlockEntity::CreakingHeart(mut heart)) = self.world.block_entities.take(&key) + else { + return Ok(()); + }; + let state = self.world.block(key.0, key.1, key.2); + if &*self.res.facts.get(state).name != "minecraft:creaking_heart" { + // The block is gone: preRemoveSideEffects. + self.world.block_entities.forget(&key); + self.with_heart(key, &mut heart, |h, _, _, host, out| { + creaking_heart::remove_protector(h, host, false, out); + })?; + return Ok(()); } - self.scan_for_hearts(); + // getTicker: none once uprooted. + if self.heart_state_name(state) != "uprooted" { + let pos = [key.0, key.1, key.2]; + self.with_heart(key, &mut heart, |h, w, lr, host, out| { + creaking_heart::server_tick(h, pos, w, lr, host, out); + })?; + } + self.world + .block_entities + .put(key, BlockEntity::CreakingHeart(heart)); Ok(()) } /// `ServerLevel.isSpawningMonsters`. @@ -295,7 +287,7 @@ impl Game<'_> { } /// Hearts that came with generated or loaded chunks get their block /// entity (`newBlockEntity`) the first time their chunk is seen. - fn scan_for_hearts(&mut self) { + pub(super) fn scan_for_hearts(&mut self) { let Some(heart) = self .pack .assets @@ -344,8 +336,7 @@ impl Game<'_> { ); self.world .block_entities - .entry(pos) - .or_insert_with(|| BlockEntity::CreakingHeart(Box::default())); + .get_or_insert_with(pos, || BlockEntity::CreakingHeart(Box::default())); } } } diff --git a/crates/horizon-client/src/game/dispense_fixture.rs b/crates/horizon-client/src/game/dispense_fixture.rs index ee8170bc5..fbad3cfc7 100644 --- a/crates/horizon-client/src/game/dispense_fixture.rs +++ b/crates/horizon-client/src/game/dispense_fixture.rs @@ -318,8 +318,18 @@ impl Game<'_> { } else { self.dispense_from(origin, state)?; // CrafterBlockEntity.serverTick, the crafting animation running down. + let mut crafters: Vec<(i32, i32, i32)> = self + .world + .block_entities + .iter() + .filter(|(_, e)| matches!(e, BlockEntity::Crafter(_))) + .map(|(p, _)| *p) + .collect(); + crafters.sort_unstable(); for _ in 0..case["ticks"].as_u64().unwrap_or(0) { - self.tick_crafters(); + for &p in &crafters { + self.tick_crafter(p); + } } } diff --git a/crates/horizon-client/src/game/jukebox.rs b/crates/horizon-client/src/game/jukebox.rs index 235ad7c24..ba7d2b786 100644 --- a/crates/horizon-client/src/game/jukebox.rs +++ b/crates/horizon-client/src/game/jukebox.rs @@ -140,63 +140,53 @@ impl Game<'_> { pub(super) fn jukebox_removed(&mut self, pos: [i32; 3]) { self.stop_song(pos); } - /// `JukeboxSongPlayer.tick` for every playing jukebox. - pub(super) fn tick_jukeboxes(&mut self) { - let playing: Vec<((i32, i32, i32), String, i64)> = self - .world - .block_entities - .iter() - .filter_map(|(k, e)| match e { - BlockEntity::Jukebox(j) if j.playing => { - let song = self - .res - .items - .get(&j.record.as_ref()?.item)? - .jukebox_song - .clone()?; - Some((*k, song, j.ticks)) - } - _ => None, - }) - .collect(); - for (key, song, ticks) in playing { - let pos = [key.0, key.1, key.2]; - let Some(s) = self.res.items.songs.get(&song).cloned() else { - continue; - }; - if s.finished(ticks) { - if let Some(BlockEntity::Jukebox(j)) = self.world.block_entities.get_mut(&key) { - j.playing = false; - j.ticks = 0; - } - self.stop_song(pos); - self.jukebox_changed(pos); - continue; - } - if !self.jukebox_sounds.contains_key(&key) && ticks == 0 { - self.start_song(pos, &song); - } - if ticks % 20 == 0 { - let color = f64::from(self.world.random.next_int_bound(4).unwrap_or(0)) / 24.0; - let at = [ - f64::from(pos[0]) + 0.5, - f64::from(pos[1]) + 1.2, - f64::from(pos[2]) + 0.5, - ]; - self.particles.add( - &ParticleOptions::simple(ParticleType::Note), - at, - [color, 0.0, 0.0], - ); - } + /// `JukeboxSongPlayer.tick` of the jukebox at `key`, while it plays. + pub(super) fn tick_jukebox(&mut self, key: (i32, i32, i32)) { + let playing = match self.world.block_entities.get(&key) { + Some(BlockEntity::Jukebox(j)) if j.playing => j.record.as_ref().and_then(|r| { + let song = self.res.items.get(&r.item)?.jukebox_song.clone()?; + Some((song, j.ticks)) + }), + _ => None, + }; + let Some((song, ticks)) = playing else { + return; + }; + let pos = [key.0, key.1, key.2]; + let Some(s) = self.res.items.songs.get(&song).cloned() else { + return; + }; + if s.finished(ticks) { if let Some(BlockEntity::Jukebox(j)) = self.world.block_entities.get_mut(&key) { - j.ticks += 1; + j.playing = false; + j.ticks = 0; } + self.stop_song(pos); + self.jukebox_changed(pos); + return; + } + if !self.jukebox_sounds.contains_key(&key) && ticks == 0 { + self.start_song(pos, &song); + } + if ticks % 20 == 0 { + let color = f64::from(self.world.random.next_int_bound(4).unwrap_or(0)) / 24.0; + let at = [ + f64::from(pos[0]) + 0.5, + f64::from(pos[1]) + 1.2, + f64::from(pos[2]) + 0.5, + ]; + self.particles.add( + &ParticleOptions::simple(ParticleType::Note), + at, + [color, 0.0, 0.0], + ); + } + if let Some(BlockEntity::Jukebox(j)) = self.world.block_entities.get_mut(&key) { + j.ticks += 1; } - self.update_song_volumes(); } /// Let go of songs that ended or whose jukebox stopped. - fn update_song_volumes(&mut self) { + pub(super) fn update_song_volumes(&mut self) { let sounds: Vec<_> = self .jukebox_sounds .iter() diff --git a/crates/horizon-client/src/game/machines.rs b/crates/horizon-client/src/game/machines.rs index a736be2db..d46928060 100644 --- a/crates/horizon-client/src/game/machines.rs +++ b/crates/horizon-client/src/game/machines.rs @@ -497,42 +497,35 @@ impl Game<'_> { } } } - /// Every hopper's `pushItemsTick`, in a stable position order. - pub(super) fn tick_hoppers(&mut self) -> Result<()> { + /// `HopperBlockEntity.pushItemsTick` of the hopper at `pos`, if its block + /// is still a hopper (`BlockEntityType.isValid`). + pub(super) fn tick_hopper(&mut self, pos: Pos) { let hopper = self - .pack - .assets - .registry - .default_state("minecraft:hopper") - .map(|s| self.res.facts.get(s).name.clone()); - let Some(hopper) = hopper else { return Ok(()) }; - // A hopper's block entity is the plain container with five slots - // (`BlockEntity::for_block`; `BlockEntity::id` names it the hopper): - // only those need their block looked up (the ticker runs for a - // HopperBlockEntity whose block is still a hopper, - // `BlockEntityType.isValid`). - let mut positions: Vec = self - .world - .block_entities - .iter() - .filter(|(_, e)| matches!(e, BlockEntity::Chest(items) if items.len() == HOPPER_SLOTS)) - .map(|(p, _)| *p) - .filter(|p| self.res.facts.get(self.world.block(p.0, p.1, p.2)).name == hopper) - .collect(); - positions.sort_unstable(); - self.hoppers - .retain(|p, _| positions.binary_search(p).is_ok()); - let time = self.world.game_time; - for pos in positions { - let state = self.hoppers.entry(pos).or_default(); - state.cooldown -= 1; - state.ticked = time; - if state.cooldown <= 0 { - state.cooldown = 0; - self.hopper_try_move_items(pos); - } + .res + .facts + .get(self.world.block(pos.0, pos.1, pos.2)) + .name + .as_ref() + == "minecraft:hopper"; + if !hopper { + self.hoppers.remove(&pos); + return; } - Ok(()) + let time = self.world.game_time; + let state = self.hoppers.entry(pos).or_default(); + state.cooldown -= 1; + state.ticked = time; + if state.cooldown <= 0 { + state.cooldown = 0; + self.hopper_try_move_items(pos); + } + } + /// Drops the cooldowns of hoppers whose block entity is gone. + pub(super) fn forget_gone_hoppers(&mut self) { + let entities = &self.world.block_entities; + self.hoppers.retain(|p, _| { + matches!(entities.get(p), Some(BlockEntity::Chest(items)) if items.len() == HOPPER_SLOTS) + }); } /// `HopperBlockEntity.tryMoveItems` with `suckInItems`. pub(super) fn hopper_try_move_items(&mut self, pos: Pos) { diff --git a/crates/horizon-client/src/game/machines/crafter.rs b/crates/horizon-client/src/game/machines/crafter.rs index 11ca70d5d..5642e5c2a 100644 --- a/crates/horizon-client/src/game/machines/crafter.rs +++ b/crates/horizon-client/src/game/machines/crafter.rs @@ -56,44 +56,33 @@ impl Game<'_> { _ => None, } } - /// `CrafterBlockEntity.serverTick` for every crafter, and the powered - /// flag following the block state. - pub(in crate::game) fn tick_crafters(&mut self) { - let positions: Vec = self - .world - .block_entities - .iter() - .filter(|(_, e)| matches!(e, BlockEntity::Crafter(_))) - .map(|(p, _)| *p) - .collect(); - let mut positions = positions; - positions.sort_unstable(); - for pos in positions { - let state = self.world.block(pos.0, pos.1, pos.2); - let triggered = self.containers().prop(state, "triggered") == Some("true"); - let mut finished = false; - if let Some(BlockEntity::Crafter(c)) = self.world.block_entities.get_mut(&pos) { - // CrafterBlock.neighborChanged sets the flag with the state; a - // loaded crafter keeps its saved flag until then. - if c.state_triggered.is_some_and(|t| t != triggered) { - c.triggered = triggered; - } - c.state_triggered = Some(triggered); - let remaining = c.crafting_ticks - 1; - if remaining >= 0 { - c.crafting_ticks = remaining; - finished = remaining == 0; - } + /// `CrafterBlockEntity.serverTick` of the crafter at `pos`, and the + /// powered flag following the block state. + pub(in crate::game) fn tick_crafter(&mut self, pos: Pos) { + let state = self.world.block(pos.0, pos.1, pos.2); + let triggered = self.containers().prop(state, "triggered") == Some("true"); + let mut finished = false; + if let Some(BlockEntity::Crafter(c)) = self.world.block_entities.get_mut(&pos) { + // CrafterBlock.neighborChanged sets the flag with the state; a + // loaded crafter keeps its saved flag until then. + if c.state_triggered.is_some_and(|t| t != triggered) { + c.triggered = triggered; } - if finished { - self.set_bool_prop( - pos, - "crafting", - false, - horizon_world::level::flags::UPDATE_ALL, - ); + c.state_triggered = Some(triggered); + let remaining = c.crafting_ticks - 1; + if remaining >= 0 { + c.crafting_ticks = remaining; + finished = remaining == 0; } } + if finished { + self.set_bool_prop( + pos, + "crafting", + false, + horizon_world::level::flags::UPDATE_ALL, + ); + } } /// `CrafterBlock.dispenseFrom` (the scheduled tick after a redstone pulse). pub(super) fn crafter_dispense(&mut self, pos: BlockPos, state: BlockStateId) -> Result<()> { diff --git a/crates/horizon-client/src/game/render_control.rs b/crates/horizon-client/src/game/render_control.rs index e9a08c6a2..21a5aee46 100644 --- a/crates/horizon-client/src/game/render_control.rs +++ b/crates/horizon-client/src/game/render_control.rs @@ -127,7 +127,7 @@ impl Game<'_> { let entity = horizon_client::containers::BlockEntity::for_block(&name) .filter(|e| matches!(e, horizon_client::containers::BlockEntity::Sign(_))) .ok_or("no sign there")?; - self.world.block_entities.entry(key).or_insert(entity); + self.world.block_entities.get_or_insert_with(key, || entity); self.open_sign_editor(key, words.get(4) != Some(&"back")); Ok(Some(json!({ "ok": true }))) } diff --git a/crates/horizon-client/src/game/spawner.rs b/crates/horizon-client/src/game/spawner.rs index c42299c86..a2131f9b0 100644 --- a/crates/horizon-client/src/game/spawner.rs +++ b/crates/horizon-client/src/game/spawner.rs @@ -45,7 +45,7 @@ impl Game<'_> { .as_ref() .is_some_and(|t| t.contains(id)) } - fn load_entity_types(&mut self) { + pub(super) fn load_entity_types(&mut self) { if self.spawners.entity_types.is_some() { return; } @@ -63,32 +63,27 @@ impl Game<'_> { .unwrap_or_default(); self.spawners.entity_types = Some(types); } - /// Every spawner's server tick, then its client tick. - pub(super) fn tick_spawners(&mut self) -> Result<()> { - self.load_entity_types(); - let keys: Vec = self - .world - .block_entities - .iter() - .filter(|(_, e)| matches!(e, BlockEntity::Spawner(_))) - .map(|(k, _)| *k) - .collect(); - for key in &keys { - let state = self.world.block(key.0, key.1, key.2); - if &*self.res.facts.get(state).name != "minecraft:spawner" { - continue; - } - let Some(BlockEntity::Spawner(mut spawner)) = self.world.block_entities.remove(key) - else { - continue; - }; - let result = self.server_tick_spawner(*key, &mut spawner); - self.world - .block_entities - .insert(*key, BlockEntity::Spawner(spawner)); - result?; + /// The server tick of the spawner at `key`, if its block is still a + /// spawner. Its client tick comes after every block entity's + /// (`client_tick_spawners`). + pub(super) fn tick_spawner(&mut self, key: Pos) -> Result<()> { + let state = self.world.block(key.0, key.1, key.2); + if &*self.res.facts.get(state).name != "minecraft:spawner" { + return Ok(()); } - for key in keys { + let Some(BlockEntity::Spawner(mut spawner)) = self.world.block_entities.take(&key) else { + return Ok(()); + }; + let result = self.server_tick_spawner(key, &mut spawner); + self.world + .block_entities + .put(key, BlockEntity::Spawner(spawner)); + result + } + /// The client ticks of these spawners, then the shown mobs of spawners + /// that are gone go. + pub(super) fn client_tick_spawners(&mut self, keys: &[Pos]) { + for &key in keys { self.client_tick_spawner(key); } let entities = &self.world.block_entities; @@ -98,7 +93,6 @@ impl Game<'_> { Some(BlockEntity::Spawner(_) | BlockEntity::TrialSpawner(_)) ) }); - Ok(()) } fn server_tick_spawner(&mut self, key: Pos, spawner: &mut Spawner) -> Result<()> { let pos = [key.0, key.1, key.2]; diff --git a/crates/horizon-client/src/game/trial_spawner.rs b/crates/horizon-client/src/game/trial_spawner.rs index 4107e0859..42a26c6e4 100644 --- a/crates/horizon-client/src/game/trial_spawner.rs +++ b/crates/horizon-client/src/game/trial_spawner.rs @@ -106,34 +106,21 @@ impl TrialSpawnerLevel for GameLevel<'_, '_> { } impl Game<'_> { - /// Every trial spawner's server tick. - pub(super) fn tick_trial_spawners(&mut self) -> Result<()> { - let keys: Vec = self - .world + /// The server tick of the trial spawner at `key`. Its client tick comes + /// after every block entity's. + pub(super) fn tick_trial_spawner(&mut self, key: Pos) -> Result<()> { + let Some((current, ominous)) = self.trial_spawner_block(key) else { + return Ok(()); + }; + let Some(BlockEntity::TrialSpawner(mut spawner)) = self.world.block_entities.take(&key) + else { + return Ok(()); + }; + let result = self.server_tick_trial_spawner(key, &mut spawner, current, ominous); + self.world .block_entities - .iter() - .filter(|(_, e)| matches!(e, BlockEntity::TrialSpawner(_))) - .map(|(k, _)| *k) - .collect(); - for &key in &keys { - let Some((current, ominous)) = self.trial_spawner_block(key) else { - continue; - }; - let Some(BlockEntity::TrialSpawner(mut spawner)) = - self.world.block_entities.remove(&key) - else { - continue; - }; - let result = self.server_tick_trial_spawner(key, &mut spawner, current, ominous); - self.world - .block_entities - .insert(key, BlockEntity::TrialSpawner(spawner)); - result?; - } - for key in keys { - self.client_tick_trial_spawner(key); - } - Ok(()) + .put(key, BlockEntity::TrialSpawner(spawner)); + result } /// The trial spawner block at `key`: its state and ominous flag. pub(super) fn trial_spawner_block(&self, key: Pos) -> Option<(TrialState, bool)> { diff --git a/crates/horizon-client/src/game/trial_visuals.rs b/crates/horizon-client/src/game/trial_visuals.rs index d32957fe1..cac28b5cc 100644 --- a/crates/horizon-client/src/game/trial_visuals.rs +++ b/crates/horizon-client/src/game/trial_visuals.rs @@ -237,7 +237,7 @@ impl Game<'_> { let shows = vault.display_item.is_some(); self.world .block_entities - .insert(key, BlockEntity::Vault(vault)); + .put(key, BlockEntity::Vault(vault)); let pos = [key.0, key.1, key.2]; if self.world.game_time % 20 == 0 { self.vault_connection_particles(pos); diff --git a/crates/horizon-client/src/game/vault.rs b/crates/horizon-client/src/game/vault.rs index 31d7d3ea3..8cf67804d 100644 --- a/crates/horizon-client/src/game/vault.rs +++ b/crates/horizon-client/src/game/vault.rs @@ -61,7 +61,7 @@ impl Game<'_> { .and_then(|s| VaultState::from_name(s)) .unwrap_or_default(); let ominous = block.properties.get("ominous").is_some_and(|v| v == "true"); - let Some(BlockEntity::Vault(vault)) = self.world.block_entities.remove(&key) else { + let Some(BlockEntity::Vault(vault)) = self.world.block_entities.take(&key) else { return None; }; Some((vault, current, ominous)) @@ -118,28 +118,19 @@ impl Game<'_> { self.rand_sequences = sequences; self.world .block_entities - .insert(key, BlockEntity::Vault(vault)); + .put(key, BlockEntity::Vault(vault)); Some(self.vault_events(key, events).map(|()| out)) } - /// Every vault's server tick, then its client tick. - pub(super) fn tick_vaults(&mut self) -> Result<()> { - let keys: Vec = self - .world - .block_entities - .iter() - .filter(|(_, e)| matches!(e, BlockEntity::Vault(_))) - .map(|(k, _)| *k) - .collect(); - for key in keys { - let pos = [key.0, key.1, key.2]; - let ticked = self.with_vault(key, |v, l, random, state, ominous, roll, events| { - v.server_tick(l, random, pos, state, ominous, roll, events); - }); - if let Some(result) = ticked { - result?; - } - self.client_tick_vault(key); + /// The server tick of the vault at `key`, then its client tick. + pub(super) fn tick_vault(&mut self, key: Pos) -> Result<()> { + let pos = [key.0, key.1, key.2]; + let ticked = self.with_vault(key, |v, l, random, state, ominous, roll, events| { + v.server_tick(l, random, pos, state, ominous, roll, events); + }); + if let Some(result) = ticked { + result?; } + self.client_tick_vault(key); Ok(()) } /// `VaultBlock.useItemOn` with `held` in the hand that acts: true when the diff --git a/crates/horizon-client/src/lib.rs b/crates/horizon-client/src/lib.rs index 45e09a6a3..c51aa09ce 100644 --- a/crates/horizon-client/src/lib.rs +++ b/crates/horizon-client/src/lib.rs @@ -16,6 +16,7 @@ pub mod banner; pub mod beehive; pub mod benchmark; pub mod biome; +pub mod block_entities; pub mod block_entity_anim; pub mod block_entity_item; pub mod block_entity_nbt; diff --git a/crates/horizon-client/src/streaming.rs b/crates/horizon-client/src/streaming.rs index 38fa33c7d..7b3f3dd50 100644 --- a/crates/horizon-client/src/streaming.rs +++ b/crates/horizon-client/src/streaming.rs @@ -589,7 +589,7 @@ impl Streaming { } world .block_entities - .extend(std::mem::take(&mut chunk.block_entities)); + .load_chunk(std::mem::take(&mut chunk.block_entities)); world .block_names .extend(std::mem::take(&mut chunk.block_names)); diff --git a/crates/horizon-client/src/world.rs b/crates/horizon-client/src/world.rs index 05b89234c..f6fbcd04d 100644 --- a/crates/horizon-client/src/world.rs +++ b/crates/horizon-client/src/world.rs @@ -26,7 +26,8 @@ pub struct World { pub loaded_entities: Vec<((i32, i32), Vec)>, /// Chunks changed since the last save. pub modified: HashSet<(i32, i32)>, - pub block_entities: HashMap<(i32, i32, i32), crate::containers::BlockEntity>, + /// Block entities, and the order they tick in. + pub block_entities: crate::block_entities::BlockEntities, /// Each chest's `ContainerOpenersCounter`: opener count and largest /// interaction range. pub chest_openers: HashMap<(i32, i32, i32), (i32, f64)>, @@ -122,7 +123,7 @@ impl World { light_edits: Vec::new(), loaded_entities: Vec::new(), modified: HashSet::new(), - block_entities: HashMap::new(), + block_entities: Default::default(), chest_openers: HashMap::new(), block_names: HashMap::new(), watched: Vec::new(), @@ -200,6 +201,8 @@ impl World { } let previous = Arc::make_mut(chunk).set(x & 15, y, z & 15, state.0); if previous != state.0 { + self.block_entities + .state_changed((x, y, z), previous, state.0); let watches = |id: u32| self.watched.get(id as usize).copied().unwrap_or(false); if watches(previous) || watches(state.0) { self.watched_writes.push(((x, y, z), previous, state.0)); @@ -240,6 +243,16 @@ impl World { .get(&(x >> 4, z >> 4)) .map_or(self.air, |chunk| chunk.block(x & 15, y, z & 15)) } + /// The block entities to tick this tick, in order (`BlockEntities::tickers`). + pub fn block_entity_tickers(&mut self) -> Vec<(crate::block_entities::Pos, u32)> { + let (chunks, air) = (&self.chunks, self.air); + self.block_entities.tickers(|(x, y, z)| { + chunks + .get(&(x >> 4, z >> 4)) + .map_or(air, |chunk| chunk.block(x & 15, y, z & 15)) + .0 + }) + } pub fn light(&self, x: i32, y: i32, z: i32) -> u8 { self.chunks .get(&(x >> 4, z >> 4)) diff --git a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaBlockEntityTickerOracle.java b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaBlockEntityTickerOracle.java new file mode 100644 index 000000000..75330c4fe --- /dev/null +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaBlockEntityTickerOracle.java @@ -0,0 +1,217 @@ +package dev.horizonlab.parity; + +import java.lang.reflect.Field; +import java.lang.reflect.Method; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import net.minecraft.core.BlockPos; +import net.minecraft.core.registries.BuiltInRegistries; +import net.minecraft.resources.Identifier; +import net.minecraft.util.debug.LevelDebugSynchronizers; +import net.minecraft.world.TickRateManager; +import net.minecraft.world.level.ChunkPos; +import net.minecraft.world.level.Level; +import net.minecraft.world.level.block.Block; +import net.minecraft.world.level.block.Blocks; +import net.minecraft.world.level.block.EntityBlock; +import net.minecraft.world.level.block.JukeboxBlock; +import net.minecraft.world.level.block.entity.BlockEntity; +import net.minecraft.world.level.block.entity.TickingBlockEntity; +import net.minecraft.world.level.block.state.BlockState; +import net.minecraft.world.level.chunk.ChunkAccess; +import net.minecraft.world.level.chunk.LevelChunk; + +/** + * The order of vanilla's `Level.blockEntityTickers`: real `LevelChunk`s of a + * server level register, rebind and drop the tickers of real block entities + * (`addAndRegisterBlockEntity`, `setBlockEntity`, `removeBlockEntity`, + * `updateBlockEntityTicker` after a state change, `registerAllBlockEntitiesAfterLevelLoad` + * after a chunk load, `clearAllBlockEntities` when it unloads), and + * `Level.tickBlockEntities` runs with the tick rate frozen, so it only + * promotes pending tickers and drops removed ones. After each `tick` the + * positions of the live tickers are printed in list order. + * + * Input lines: `reset`, `load CX CZ BLOCK X Y Z ...` (a chunk's block entities in + * its save order), `place BLOCK X Y Z`, `replace X Y Z`, `remove X Y Z`, + * `record X Y Z 0|1` (a jukebox's has_record), `unload CX CZ`, `tick`. + */ +public final class VanillaBlockEntityTickerOracle { + static Object unsafe; + static Method allocate; + + static T alloc(Class c) throws Exception { + return c.cast(allocate.invoke(unsafe, c)); + } + + static void set(Class owner, Object target, String name, Object value) throws Exception { + Field f = owner.getDeclaredField(name); + f.setAccessible(true); + f.set(target, value); + } + + static Object get(Class owner, Object target, String name) throws Exception { + Field f = owner.getDeclaredField(name); + f.setAccessible(true); + return f.get(target); + } + + static Map cells = new HashMap<>(); + static Map chunks = new HashMap<>(); + static World world; + + static final class World extends net.minecraft.server.level.ServerLevel { + TickRateManager rate; + LevelDebugSynchronizers debug; + World() { + super(null, null, null, null, null, null, false, 0L, List.of(), false); + } + @Override public boolean isClientSide() { return false; } + @Override public TickRateManager tickRateManager() { return rate; } + @Override public LevelDebugSynchronizers debugSynchronizers() { return debug; } + @Override public void onBlockEntityAdded(BlockEntity blockEntity) { } + @Override public void levelEvent(net.minecraft.world.entity.Entity source, int type, BlockPos at, int data) { } + @Override public void gameEvent(net.minecraft.core.Holder event, + net.minecraft.world.phys.Vec3 at, net.minecraft.world.level.gameevent.GameEvent.Context context) { } + @Override public BlockState getBlockState(BlockPos p) { return cells.getOrDefault(p, Blocks.AIR.defaultBlockState()); } + @Override public void playSeededSound(net.minecraft.world.entity.Entity except, double x, double y, double z, + net.minecraft.core.Holder sound, net.minecraft.sounds.SoundSource source, + float volume, float pitch, long seed) { } + @Override public int getMinY() { return -64; } + @Override public int getHeight() { return 384; } + } + + static final class Chunk extends LevelChunk { + Chunk() { + super(null, null); + } + @Override public BlockState getBlockState(BlockPos p) { return cells.getOrDefault(p, Blocks.AIR.defaultBlockState()); } + @Override public void markUnsaved() { } + } + + static void reset() throws Exception { + cells = new HashMap<>(); + chunks = new HashMap<>(); + world = alloc(World.class); + set(Level.class, world, "blockEntityTickers", new ArrayList()); + set(Level.class, world, "pendingBlockEntityTickers", new ArrayList()); + set(Level.class, world, "soundSeedGenerator", net.minecraft.util.RandomSource.create(0)); + TickRateManager rate = new TickRateManager(); + set(TickRateManager.class, rate, "runGameElements", false); + world.rate = rate; + LevelDebugSynchronizers debug = alloc(LevelDebugSynchronizers.class); + set(LevelDebugSynchronizers.class, debug, "sleeping", true); + world.debug = debug; + } + + static Chunk chunk(int cx, int cz) throws Exception { + Chunk c = chunks.get(ChunkPos.pack(cx, cz)); + if (c != null) return c; + c = alloc(Chunk.class); + set(ChunkAccess.class, c, "blockEntities", new it.unimi.dsi.fastutil.objects.Object2ObjectOpenHashMap()); + set(ChunkAccess.class, c, "pendingBlockEntities", new HashMap()); + set(ChunkAccess.class, c, "chunkPos", new ChunkPos(cx, cz)); + set(LevelChunk.class, c, "level", world); + set(LevelChunk.class, c, "tickersInLevel", new HashMap<>()); + chunks.put(ChunkPos.pack(cx, cz), c); + return c; + } + + /** The chunk at `p`, in the level (a chunk first seen here was already loaded). */ + static Chunk at(BlockPos p) throws Exception { + Chunk c = chunk(p.getX() >> 4, p.getZ() >> 4); + c.setLoaded(true); + return c; + } + + /** The block's state: a jukebox's has_record from the name (`jukebox_record`). */ + static BlockState state(String name) { + boolean record = name.equals("jukebox_record"); + Block block = BuiltInRegistries.BLOCK.getValue(Identifier.withDefaultNamespace(record ? "jukebox" : name)); + BlockState s = block.defaultBlockState(); + return block instanceof JukeboxBlock ? s.setValue(JukeboxBlock.HAS_RECORD, record) : s; + } + + static BlockEntity make(BlockPos p) { + BlockState s = cells.get(p); + return ((EntityBlock) s.getBlock()).newBlockEntity(p, s); + } + + static BlockPos pos(String[] w, int i) { + return new BlockPos(Integer.parseInt(w[i]), Integer.parseInt(w[i + 1]), Integer.parseInt(w[i + 2])); + } + + public static void main(String[] args) throws Exception { + // Registries with item components bound (vaults hold item stacks). + ParityData.init(); + var allocator = Class.forName("sun.misc.Unsafe"); + var field = allocator.getDeclaredField("theUnsafe"); + field.setAccessible(true); + unsafe = field.get(null); + allocate = allocator.getMethod("allocateInstance", Class.class); + Method update = LevelChunk.class.getDeclaredMethod("updateBlockEntityTicker", BlockEntity.class); + update.setAccessible(true); + StringBuilder out = new StringBuilder(); + for (String line : Files.readAllLines(Path.of(args[0]))) { + String[] w = line.trim().split(" "); + switch (w[0]) { + case "reset" -> reset(); + case "load" -> { + // SerializableChunkData.postLoadChunk, then ChunkStatusTasks.full. + Chunk c = chunk(Integer.parseInt(w[1]), Integer.parseInt(w[2])); + for (int i = 3; i + 3 < w.length; i += 4) { + BlockPos p = pos(w, i + 1); + cells.put(p, state(w[i])); + c.setBlockEntity(make(p)); + } + c.setLoaded(true); + c.registerAllBlockEntitiesAfterLevelLoad(); + } + case "place" -> { + // LevelChunk.setBlockState: a new block entity block. + BlockPos p = pos(w, 2); + cells.put(p, state(w[1])); + at(p).addAndRegisterBlockEntity(make(p)); + } + case "replace" -> { + BlockPos p = pos(w, 1); + at(p).addAndRegisterBlockEntity(make(p)); + } + case "remove" -> { + BlockPos p = pos(w, 1); + at(p).removeBlockEntity(p); + cells.remove(p); + } + case "record" -> { + // LevelChunk.setBlockState: the same block, another state. + BlockPos p = pos(w, 1); + BlockState s = state(w[4].equals("1") ? "jukebox_record" : "jukebox"); + cells.put(p, s); + BlockEntity be = at(p).getBlockEntity(p); + be.setBlockState(s); + update.invoke(at(p), be); + } + case "unload" -> { + Chunk c = chunks.remove(ChunkPos.pack(Integer.parseInt(w[1]), Integer.parseInt(w[2]))); + if (c != null) c.clearAllBlockEntities(); + } + case "tick" -> { + world.tickBlockEntities(); + @SuppressWarnings("unchecked") + List list = (List) get(Level.class, world, "blockEntityTickers"); + out.append("tick"); + for (TickingBlockEntity t : list) { + BlockPos p = t.getPos(); + out.append(' ').append(p.getX()).append(',').append(p.getY()).append(',').append(p.getZ()); + } + out.append('\n'); + } + default -> throw new IllegalArgumentException(line); + } + } + Files.writeString(Path.of(args[1]), out); + } +} diff --git a/tools/test_block_entity_tickers_parity.py b/tools/test_block_entity_tickers_parity.py new file mode 100644 index 000000000..58604b269 --- /dev/null +++ b/tools/test_block_entity_tickers_parity.py @@ -0,0 +1,132 @@ +#!/usr/bin/env python3 +"""Compare the order block entities tick in with vanilla's `Level.blockEntityTickers`. + +Random scenarios load chunks with block entities in a save order (enough in +one chunk to make its block entity map grow), place, replace and remove block +entities, give jukeboxes a record and take it, and unload chunks, with ticks +in between. `VanillaBlockEntityTickerOracle` runs them on real `LevelChunk`s +of a server level and prints, after each tick, the positions of the live +tickers in list order; `examples/block_entity_tickers_fixture` runs the same +on `horizon_client::block_entities::BlockEntities`. The block entities are +the kinds the game ticks in that list (hoppers, furnaces, beacons, spawners, +trial spawners, vaults, hives, crafters, jukebox), with chests and barrels, +which have no ticker, among them. +""" +import argparse +import os +import random +import subprocess +import sys +try: + from . import lab, test_rust_parity as base +except ImportError: + import lab + import test_rust_parity as base + +PARITY = lab.ROOT / 'mods/horizon/src/test/java/dev/horizonlab/parity' +TICKING = ['hopper', 'furnace', 'blast_furnace', 'smoker', 'beacon', 'spawner', 'trial_spawner', 'vault', + 'beehive', 'bee_nest', 'crafter', 'jukebox_record'] +KINDS = TICKING + ['jukebox', 'chest', 'barrel'] + + +def scenario(rng): + """One scenario's lines: a few chunks near the origin and the ops on them.""" + lines = ['reset'] + loaded, blocks = set(), {} + + def free(cx, cz): + while True: + p = (cx * 16 + rng.randrange(16), rng.randrange(-64, 320), cz * 16 + rng.randrange(16)) + if p not in blocks: + return p + + def load(): + options = [(x, z) for x in range(-2, 3) for z in range(-2, 3) if (x, z) not in loaded] + if not options: + return + cx, cz = rng.choice(options) + loaded.add((cx, cz)) + words = ['load', str(cx), str(cz)] + for _ in range(rng.choice([0, 1, 3, 8, 20, 30, 60])): + p, kind = free(cx, cz), rng.choice(KINDS) + blocks[p] = kind + words += [kind, *map(str, p)] + lines.append(' '.join(words)) + for _ in range(rng.randrange(1, 4)): + load() + lines.append('tick') + for _ in range(rng.randrange(10, 60)): + op = rng.random() + mine = sorted(blocks) + if op < 0.25 and loaded: + cx, cz = rng.choice(sorted(loaded)) + p, kind = free(cx, cz), rng.choice(KINDS) + blocks[p] = kind + lines.append(f'place {kind} {p[0]} {p[1]} {p[2]}') + elif op < 0.4 and mine: + p = rng.choice(mine) + lines.append(f'replace {p[0]} {p[1]} {p[2]}') + elif op < 0.6 and mine: + p = rng.choice(mine) + del blocks[p] + lines.append(f'remove {p[0]} {p[1]} {p[2]}') + elif op < 0.72: + jukeboxes = [p for p in mine if blocks[p].startswith('jukebox')] + if jukeboxes: + p = rng.choice(jukeboxes) + record = blocks[p] == 'jukebox' + blocks[p] = 'jukebox_record' if record else 'jukebox' + lines.append(f'record {p[0]} {p[1]} {p[2]} {int(record)}') + elif op < 0.78 and loaded: + cx, cz = rng.choice(sorted(loaded)) + loaded.discard((cx, cz)) + for p in [p for p in blocks if (p[0] >> 4, p[2] >> 4) == (cx, cz)]: + del blocks[p] + lines.append(f'unload {cx} {cz}') + elif op < 0.85: + load() + else: + lines.append('tick') + lines.append('tick') + return lines + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument('--scenarios', type=int, default=3000) + parser.add_argument('--seed', type=int, default=0x7469636b) + args = parser.parse_args() + lock, jars, libraries = base.verify_artifacts() + build = lab.LOCAL / 'rust-block-entity-tickers-parity' + build.mkdir(parents=True, exist_ok=True) + rng = random.Random(args.seed) + lines = [line for _ in range(args.scenarios) for line in scenario(rng)] + inputs = build / 'inputs.txt' + inputs.write_text('\n'.join(lines) + '\n') + classes = build / 'classes' + classes.mkdir(exist_ok=True) + dependencies = os.pathsep.join(map(str, [jars['server'], *libraries])) + + def run(command, name): + with (build / (name + '.log')).open('w') as log: + result = subprocess.run(list(map(str, command)), cwd=lab.ROOT, timeout=3600, stdout=log, + stderr=subprocess.STDOUT) + if result.returncode: + print((build / (name + '.log')).read_text()[-4000:]) + sys.exit(f'{name} failed') + run(['javac', '--release', lock['minecraft']['java_major'], '-proc:none', '-nowarn', '-cp', dependencies, + '-d', classes, *(PARITY / f'{n}.java' for n in ('ParityData', 'VanillaBlockEntityTickerOracle'))], + 'compile-java') + run(['java', '-Xmx1G', '-cp', str(classes) + os.pathsep + dependencies, + 'dev.horizonlab.parity.VanillaBlockEntityTickerOracle', inputs, build / 'vanilla.txt'], 'vanilla') + run(['cargo', 'run', '--quiet', '--profile', 'fast', '-p', 'horizon-client', '--example', + 'block_entity_tickers_fixture', '--', inputs, build / 'rust.txt'], 'rust') + matched = base.compare(build / 'vanilla.txt', build / 'rust.txt') + ticks = sum(1 for line in lines if line == 'tick') + listed = sum(len(line.split()) - 1 for line in (build / 'vanilla.txt').read_text().splitlines()) + print(f'block entity tickers: {args.scenarios} scenarios, {matched} of {ticks} ticks match vanilla ' + f'({listed} tickers listed)') + + +if __name__ == '__main__': + main() From 5c55e7d855dc999d19ebd9f1e85e3c06c8a59606 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sat, 17 Oct 2026 23:23:15 +0100 Subject: [PATCH 023/163] Paletted container access: skip the storage revalidation a section already did BlockSection::get and set check the section index and the state id once, then read and write through new PackedStorage::read/write, which skip the storage-level bounds and value checks and the Result that get/set keep for external callers. A section index is below 4,096 and a palette id always fits the width bits_for_palette chose; both methods debug_assert that contract. Used for the hot read, the hot write and the growth re-encode. Benchmark (ignored tests, best of alternating-order rounds, fast profile): BlockSection::set 13.15 -> 9.12 ns/write (1.44x), get 2.33 -> 1.45 ns/read (1.61x). See docs/performance/paletted-container-access-results.md. --- crates/horizon-core/src/storage.rs | 22 +++++++++ crates/horizon-world/src/chunk.rs | 48 +++++++++++++++---- .../paletted-container-access-results.md | 29 +++++++---- 3 files changed, 82 insertions(+), 17 deletions(-) diff --git a/crates/horizon-core/src/storage.rs b/crates/horizon-core/src/storage.rs index 61f8c505f..6b8a8ec38 100644 --- a/crates/horizon-core/src/storage.rs +++ b/crates/horizon-core/src/storage.rs @@ -88,6 +88,28 @@ impl PackedStorage { Ok(((self.words[word] >> shift) & self.mask) as u32) } + /// Reads `index` without a bounds check. Callers use this once they hold a + /// slice length or a section index they have already validated. + /// `index` must be less than `len`. + pub fn read(&self, index: usize) -> u32 { + debug_assert!(index < self.len); + let word = index / self.per_word; + let shift = (index % self.per_word) * usize::from(self.bits); + ((self.words[word] >> shift) & self.mask) as u32 + } + + /// Writes `value` at `index` without revalidating either. `index` must be + /// less than `len` and `value` must fit `bits`, which holds for a section + /// palette index from the same container. Returns the previous value. + pub fn write(&mut self, index: usize, value: u32) -> u32 { + debug_assert!(index < self.len && u64::from(value) <= self.mask); + let word = index / self.per_word; + let shift = (index % self.per_word) * usize::from(self.bits); + let old = ((self.words[word] >> shift) & self.mask) as u32; + self.words[word] = (self.words[word] & !(self.mask << shift)) | (u64::from(value) << shift); + old + } + /// Validation fails before mutation. Writes accept nonnegative Java ints; /// imported 32-bit words may still decode to any u32 bit pattern. pub fn set(&mut self, index: usize, value: u32) -> Result { diff --git a/crates/horizon-world/src/chunk.rs b/crates/horizon-world/src/chunk.rs index b7650a3d3..fdbefe259 100644 --- a/crates/horizon-world/src/chunk.rs +++ b/crates/horizon-world/src/chunk.rs @@ -442,7 +442,7 @@ impl<'r> BlockSection<'r> { if index >= 4096 { return Err(invalid("section index out of bounds")); } - let id = self.storage.as_ref().map_or(0, |s| s.get(index).unwrap()); + let id = self.storage.as_ref().map_or(0, |s| s.read(index)); Ok(self.palette[id as usize]) } pub fn set(&mut self, index: usize, state: BlockStateId) -> io::Result { @@ -454,7 +454,7 @@ impl<'r> BlockSection<'r> { } // The slot at `index` is the old state's id, so no palette lookup is // needed for it; only the new state has to be resolved. - let old_id = self.storage.as_ref().map_or(0, |s| s.get(index).unwrap()); + let old_id = self.storage.as_ref().map_or(0, |s| s.read(index)); let old = self.palette[old_id as usize]; if old == state { return Ok(old); @@ -481,7 +481,7 @@ impl<'r> BlockSection<'r> { .map_err(|e| invalid(e.to_string()))?; if let Some(old) = &self.storage { for i in 0..4096 { - storage.set(i, old.get(i).unwrap()).unwrap(); + storage.write(i, old.read(i)); } } self.storage = Some(storage); @@ -493,11 +493,7 @@ impl<'r> BlockSection<'r> { } } }; - self.storage - .as_mut() - .unwrap() - .set(index, id) - .map_err(|e| invalid(e.to_string()))?; + self.storage.as_mut().unwrap().write(index, id); self.counts[old_id as usize] -= 1; self.counts[id as usize] += 1; if self.counts[old_id as usize] == 0 { @@ -823,5 +819,41 @@ mod tests { times[1][0], times[0][0] / times[1][0] ); + + let mut get_times = [Vec::new(), Vec::new()]; + for round in 0..ROUNDS { + for optimized in [round % 2 == 0, round % 2 != 0] { + let started = Instant::now(); + let mut acc = 0u32; + for &(index, _) in &ops { + let state = if optimized { + fast.get(black_box(index)).unwrap() + } else { + baseline_get(&base, black_box(index)).unwrap() + }; + acc ^= state.0; + } + black_box(acc); + if round > 0 { + get_times[usize::from(optimized)] + .push(started.elapsed().as_secs_f64() * 1e9 / OPS as f64); + } + } + } + for values in &mut get_times { + values.sort_by(f64::total_cmp); + } + println!( + "section get median: baseline {:.3} ns/op optimized {:.3} ns/op speedup {:.3}x", + median(&get_times[0]), + median(&get_times[1]), + median(&get_times[0]) / median(&get_times[1]) + ); + println!( + "section get best: baseline {:.3} ns/op optimized {:.3} ns/op speedup {:.3}x", + get_times[0][0], + get_times[1][0], + get_times[0][0] / get_times[1][0] + ); } } diff --git a/docs/performance/paletted-container-access-results.md b/docs/performance/paletted-container-access-results.md index 233e320ab..08783d290 100644 --- a/docs/performance/paletted-container-access-results.md +++ b/docs/performance/paletted-container-access-results.md @@ -5,8 +5,9 @@ chunk workers: light and mesh workers unpack a section's 4,096 cells before propagating or meshing, and world-generation workers write one block at a time through `BlockSection::set`. -Two redundant lookups were removed from the write path, and the palette dispatch -was hoisted in the bulk readers. +The write path resolved the old cell and probed the palette three times; the +bulk readers dispatched the palette per cell; and the storage layer revalidated +indices and values a section had already checked. All three are addressed. ## Changes @@ -19,6 +20,14 @@ now read straight from storage, and the incoming state is resolved with a single map probe. The palette-reuse, free-slot and growth paths are unchanged, so the encoded palette, counts, free list and NBT output stay identical. +`BlockSection::get` and `set` validate the section index and the state id once, +then read and write through `PackedStorage::read`/`write` +(`crates/horizon-core/src/storage.rs`). These skip the storage-level bounds and +value checks and the `Result` that `PackedStorage::get`/`set` keep for external +callers: a section index is below 4,096 and a palette id always fits the width +`bits_for_palette` chose. Both new methods `debug_assert` their contract and are +used for the hot read, the hot write and the palette-growth re-encode. + `PalettedContainer::unpack` and `unpack_u16` (`crates/horizon-core/src/paletted.rs`) matched on the palette variant inside the per-cell loop. `Single`, `List` and `Global` are now dispatched once before the @@ -40,19 +49,21 @@ and NBT before timing. Rounds alternate baseline/optimized order with `black_box and report the median and best nanosecond- or microsecond-per-operation; the best round is the estimate of uninterrupted CPU time on a contended machine. -`benchmark_section_get_set` uses a 32-state registry and 50,000 random writes per -round over a section whose palette grows through the 4- and 5-bit widths (24 -distinct states); 51 rounds. `benchmark_unpack` fills a 4,096-entry list palette -(12 states) and the global palette, 2,000 calls per round, 25 rounds. +`benchmark_section_get_set` uses a 32-state registry and 50,000 random writes and +reads per round over a section whose palette grows through the 4- and 5-bit +widths (24 distinct states); 51 rounds. `benchmark_unpack` fills a 4,096-entry +list palette (12 states) and the global palette, 2,000 calls per round, 25 +rounds. AMD Ryzen 5 5600X, Linux x86_64, rustc 1.99.0, optimized `fast` profile, nonincremental, no LTO: | Operation | Original main | New | Speedup | | --- | ---: | ---: | ---: | -| `BlockSection::set` | 12.73 ns/write | 11.37 ns/write | 1.12x | -| `unpack`, list palette | 1.956 us/call | 1.860 us/call | 1.05x | -| `unpack`, global palette | 2.255 us/call | 2.172 us/call | 1.04x | +| `BlockSection::set` | 13.15 ns/write | 9.12 ns/write | 1.44x | +| `BlockSection::get` | 2.33 ns/read | 1.45 ns/read | 1.61x | +| `unpack`, list palette | 1.910 us/call | 1.834 us/call | 1.04x | +| `unpack`, global palette | 2.270 us/call | 2.179 us/call | 1.04x | The distinct-state differential test `chunk::tests::set_matches_baseline_under_random_edits` drives the optimized From 05ecd873d4949a504c5ad3f1ad9545dd7b3f02e8 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sat, 17 Oct 2026 23:24:05 +0100 Subject: [PATCH 024/163] Startup: show the title before the world bundle finishes loading (#712) --- crates/horizon-client/src/game.rs | 206 +++++++++++++++++++------ crates/horizon-client/src/telemetry.rs | 19 ++- 2 files changed, 181 insertions(+), 44 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index b3ca99d99..8c04860cc 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -10331,18 +10331,27 @@ struct Loaded { pack_error: Option, resources: Resources, pack: PackResources, - gui: UiResources, + /// The menu bundle, for the synchronous launch; the loading screen receives + /// it earlier through its own channel. + gui: Option, +} + +/// What the background loader publishes: the menu bundle as soon as it is +/// ready, then the world bundle. +enum LoaderMsg { + Ui(UiResources), + Done(std::result::Result), } /// The loader's checkpoints, in order; the loading screen reports them. const STAGES: u32 = 9; const STAGE_LINES: [&str; 9] = [ + "Loading menu", "Loading assets", "Loading block facts", "Loading items", "Loading biomes", "Loading pack tables", - "Loading atlas", "Loading collision", "Loading resources", "Starting audio", @@ -10390,8 +10399,31 @@ fn load_resources( vanilla_root: &std::path::Path, settings: &Settings, started: Instant, + menu: bool, on_stage: &(dyn Fn(u32) + Sync), + publish: &mut dyn FnMut(UiResources), ) -> Result { + let requested_root = root.clone(); + let threads = settings.horizon.worker_threads(); + // Stage A: the menu bundle (atlas and panorama). With a loading screen it is + // published at once so the title backdrop can appear while the world bundle + // loads; the synchronous launch instead carries it in `Loaded`. + let mut loaded_gui = None; + let mut ui_ready = false; + if let Ok(ui) = UiResources::load(&root) { + if menu { + horizon_client::telemetry::mark_ui_ready(); + log::info!( + "Horizon: UI bundle ready after {} ms", + started.elapsed().as_millis() + ); + publish(ui); + } else { + loaded_gui = Some(ui); + } + ui_ready = true; + } + on_stage(0); let mut pack_error = None; let (assets, render) = match Assets::load(&root).and_then(|assets| { let render = assets.reload(&root)?; @@ -10417,38 +10449,72 @@ fn load_resources( }; let assets = Arc::new(assets); let render = Arc::new(render); + // The menu bundle must come from the same root as the world bundle. + if !ui_ready || root != requested_root { + let ui = UiResources::load(&root)?; + if menu { + horizon_client::telemetry::mark_ui_ready(); + log::info!( + "Horizon: UI bundle ready after {} ms", + started.elapsed().as_millis() + ); + publish(ui); + } else { + loaded_gui = Some(ui); + } + } log::info!("load assets: {:.2}s", started.elapsed().as_secs_f32()); - on_stage(0); + on_stage(1); let behaviour_json: serde_json::Value = serde_json::from_reader(std::io::BufReader::new( std::fs::File::open(root.join("block-behaviours.json"))?, ))?; + // The block facts, the biomes and the environment are independent reads: + // run them together, within the worker budget the settings allow. + let registry = assets.registry; + let load_facts = || { + BlockFacts::load_with_projection(&root, registry, &behaviour_json) + .map_err(|e| e.to_string()) + }; + let load_biomes = || Biomes::load(&root).map_err(|e| e.to_string()); + let load_environment = || Environment::load(&root).map_err(|e| e.to_string()); + let (facts, biomes, environment) = if threads > 1 { + std::thread::scope(|scope| { + let facts = scope.spawn(load_facts); + let biomes = scope.spawn(load_biomes); + let environment = scope.spawn(load_environment); + ( + facts.join().unwrap(), + biomes.join().unwrap(), + environment.join().unwrap(), + ) + }) + } else { + (load_facts(), load_biomes(), load_environment()) + }; let (facts, gameplay_projection) = - BlockFacts::load_with_projection(&root, assets.registry, &behaviour_json)?; + facts.map_err(|e| -> Box { e.into() })?; + let biomes = Arc::new(biomes.map_err(|e| -> Box { e.into() })?); + let environment = environment.map_err(|e| -> Box { e.into() })?; let mob_data = horizon_client::mobs::MobData::load(&root, &facts); horizon_client::mobs::trial_spawner::load_registry(&root); log::info!("load facts: {:.2}s", started.elapsed().as_secs_f32()); - on_stage(1); + on_stage(2); let items = Items::load(&root, assets.registry, &facts)?; log::info!("load items: {:.2}s", started.elapsed().as_secs_f32()); - on_stage(2); + on_stage(3); let recipes = Recipes::load(&root, &items)?; let transformers = horizon_client::block_transform::Transformers::load(&root, assets.registry)?; - let biomes = Arc::new(Biomes::load(&root)?); - let environment = Environment::load(&root)?; log::info!("load biomes+env: {:.2}s", started.elapsed().as_secs_f32()); - on_stage(3); + on_stage(4); let light = Arc::new(LightTables::load(&root, assets.registry, &facts)?); let pack = PackResources::load(&root, assets.clone(), render, &facts, biomes.clone(), light)?; log::info!("load pack tables: {:.2}s", started.elapsed().as_secs_f32()); - on_stage(4); - let gui = UiResources::load(&root)?; + on_stage(5); horizon_client::ui::load_metadata(&root); horizon_client::lang::set(horizon_client::lang::Language::load( &[&root], &settings.language, )); - log::info!("load atlas: {:.2}s", started.elapsed().as_secs_f32()); - on_stage(5); let registry_owner = assets.clone(); let collision = collisions::load(&root, registry_owner.registry)?; let motion = MotionResources::load(&root, ®istry_owner)?; @@ -10457,7 +10523,12 @@ fn load_resources( started.elapsed().as_secs_f32() ); on_stage(6); - let threads = settings.horizon.worker_threads(); + if menu { + log::info!( + "Horizon: world bundle ready after {} ms", + started.elapsed().as_millis() + ); + } log::info!( "Horizon: resources loaded in {:.1}s; {} block states, {} items, {} biomes; {} worker threads", started.elapsed().as_secs_f32(), @@ -10518,7 +10589,7 @@ fn load_resources( pack_error, resources, pack, - gui, + gui: loaded_gui, }) } @@ -10556,18 +10627,22 @@ fn build_renderer( } /// The loading screen's renderer: the real HUD atlas and font over one opaque -/// white block-sprite layer, an empty border texture and an empty panorama. +/// white block-sprite layer, an empty border texture and the title panorama +/// once the menu bundle is ready. fn loading_renderer( window: Arc, offscreen: bool, - atlas: Option<&HudAtlas>, + gui: Option<&UiResources>, + previous: Option<&Renderer>, ) -> Result { static FORCEFIELD: [u8; 4] = [0; 4]; static EMPTY_HUD: [u8; 4] = [0, 0, 0, 255]; - let panorama = horizon_client::gfx::panorama::Faces { + let empty_panorama = horizon_client::gfx::panorama::Faces { size: 1, pixels: [0u8; 4].repeat(6), }; + let panorama = gui.map_or(&empty_panorama, |gui| gui.panorama.as_ref()); + let atlas = gui.map(|gui| &gui.atlas); let (pixels, width, height) = match atlas { Some(atlas) => (atlas.pixels.as_slice(), atlas.width, atlas.height), None => (EMPTY_HUD.as_slice(), 1, 1), @@ -10583,8 +10658,8 @@ fn loading_renderer( &[], (pixels, width, height), (&FORCEFIELD[..], 1), - &panorama, - None, + panorama, + previous, ))?; if let Some(atlas) = atlas { renderer.hud.fire_animations = atlas @@ -10804,7 +10879,7 @@ fn run_event_loop(mut game: Game<'_>) -> Result<()> { struct Loading { window: Option>, renderer: Option, - atlas: Option, + gui: Option, settings: Settings, fullscreen: horizon_client::window::FullscreenState, options: Option, @@ -10812,7 +10887,7 @@ struct Loading { pack_error: Option, started: Instant, progress: Progress, - receiver: Receiver>, + receiver: Receiver, loaded: Option>, handle: Option>, shown: bool, @@ -10847,7 +10922,7 @@ impl Loading { } }; let offscreen = self.options.as_ref().is_some_and(|o| o.offscreen); - match loading_renderer(window.clone(), offscreen, self.atlas.as_ref()) { + match loading_renderer(window.clone(), offscreen, self.gui.as_ref(), None) { Ok(r) => self.renderer = Some(r), Err(e) => { self.error = Some(e); @@ -10877,19 +10952,53 @@ impl Loading { _ => {} } } + /// The menu bundle arrived: rebuild the loading screen with the real atlas + /// and title panorama. + fn set_ui(&mut self, gui: UiResources) { + log::info!( + "Horizon: loading the title artwork after {} ms", + self.started.elapsed().as_millis() + ); + self.gui = Some(gui); + let Some(window) = self.window.clone() else { + return; + }; + let offscreen = self.options.as_ref().is_some_and(|o| o.offscreen); + if let Some(renderer) = &mut self.renderer { + renderer.release_surface(); + } + match loading_renderer(window, offscreen, self.gui.as_ref(), self.renderer.as_ref()) { + Ok(r) => { + self.settings + .clamp_gui_scale([r.config.width as i32, r.config.height as i32]); + horizon_client::hud::GUI_SCALE.store(self.settings.gui_scale, Ordering::Relaxed); + self.renderer = Some(r); + } + Err(e) => self.error = Some(e), + } + } fn about_to_wait(&mut self, event_loop: &ActiveEventLoop) { if self.loaded.is_none() { - match self.receiver.try_recv() { - Ok(result) => self.loaded = Some(result), - Err(TryRecvError::Disconnected) => { - if let Some(handle) = self.handle.take() { - let _ = handle.join(); + loop { + match self.receiver.try_recv() { + Ok(LoaderMsg::Ui(gui)) => self.set_ui(gui), + Ok(LoaderMsg::Done(result)) => { + self.loaded = Some(result); + break; + } + Err(TryRecvError::Empty) => break, + Err(TryRecvError::Disconnected) => { + if self.loaded.is_none() { + if let Some(handle) = self.handle.take() { + let _ = handle.join(); + } + self.error = Some("resource loader stopped before finishing".into()); + event_loop.exit(); + return; + } + break; } - self.error = Some("resource loader stopped before finishing".into()); - event_loop.exit(); - return; } - Err(TryRecvError::Empty) => {} } } if let Some(w) = &self.window { @@ -10907,10 +11016,10 @@ impl Loading { }; let size = [renderer.config.width, renderer.config.height]; let mut batch = HudBatch::new(size); - if let Some(atlas) = &self.atlas { + if let Some(gui) = &self.gui { horizon_client::level_loading::draw_progress( &mut batch, - atlas, + &gui.atlas, self.progress.line(), self.progress.fraction(), ); @@ -10930,6 +11039,7 @@ impl Loading { fn finish(&mut self, loaded: Loaded) -> Result>> { let mut options = self.options.take().ok_or("loading already finished")?; options.resources = loaded.root.clone(); + let gui = self.gui.take().ok_or("missing menu bundle")?; self.progress.set(STAGES - 1); // Audio is created on the main thread, after the join. let audio = if options.dedicated.is_some() { @@ -10946,7 +11056,7 @@ impl Loading { window.clone(), options.offscreen, &loaded.pack, - &loaded.gui, + &gui, self.renderer.as_ref(), )?; let pack_error = loaded.pack_error.or_else(|| self.pack_error.take()); @@ -10956,7 +11066,7 @@ impl Loading { let Some(mut game) = start_game( res, loaded.pack, - loaded.gui, + gui, options, pack_error, audio, @@ -11066,18 +11176,25 @@ fn run_loading( std::thread::Builder::new() .name("resource-loader".into()) .spawn(move || { - let result = load_resources(root, &vanilla_root, &settings, started, &|stage| { - progress.set(stage) - }) + let result = load_resources( + root, + &vanilla_root, + &settings, + started, + true, + &|stage| progress.set(stage), + &mut |gui| { + let _ = sender.send(LoaderMsg::Ui(gui)); + }, + ) .map_err(|e| e.to_string()); - let _ = sender.send(result); + let _ = sender.send(LoaderMsg::Done(result)); })? }; - let atlas = HudAtlas::build(&options.resources).ok(); let loading = Loading { window: None, renderer: None, - atlas, + gui: None, settings, fullscreen: horizon_client::window::FullscreenState::new(false), options: Some(options), @@ -11145,8 +11262,11 @@ pub fn run() -> Result<()> { &vanilla_root, &early_settings, started, + false, &|_| {}, + &mut |_| {}, )?; + let gui = loaded.gui.ok_or("missing menu bundle")?; options.resources = loaded.root.clone(); let audio = if options.dedicated.is_some() { Audio::silent(&options.resources) @@ -11157,7 +11277,7 @@ pub fn run() -> Result<()> { let game = start_game( &resources, loaded.pack, - loaded.gui, + gui, options, loaded.pack_error.or(pack_error), audio, diff --git a/crates/horizon-client/src/telemetry.rs b/crates/horizon-client/src/telemetry.rs index 9e83655fa..547a2bcde 100644 --- a/crates/horizon-client/src/telemetry.rs +++ b/crates/horizon-client/src/telemetry.rs @@ -3,6 +3,7 @@ //! summary, in the outbox. It never sends anything itself: the launcher does, at its next start. //! Without the player's yes for that kind nothing is kept, and crash-reports/ stays local. use std::path::Path; +use std::sync::atomic::{AtomicU32, Ordering}; use std::sync::{Mutex, OnceLock}; use std::time::Instant; @@ -18,6 +19,9 @@ const MIN_SECONDS: f32 = 60.0; const CRASH_DETAILS: [&str; 3] = ["Horizon Version", "Graphics Adapter", "Render Settings"]; static STARTED: OnceLock = OnceLock::new(); +/// When the menu bundle became ready, so the time to the title screen measures +/// the menu and not the world bundle loaded behind it. +static UI_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); @@ -26,6 +30,14 @@ pub fn mark_start() { STARTED.get_or_init(Instant::now); } +/// The menu bundle is ready: the title backdrop can draw. The first writer wins. +pub fn mark_ui_ready() { + if let Some(started) = STARTED.get() { + let ms = started.elapsed().as_millis() as u32; + let _ = UI_READY_MS.compare_exchange(u32::MAX, ms, Ordering::Relaxed, Ordering::Relaxed); + } +} + 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)); } @@ -138,7 +150,12 @@ impl Session { pub fn title_shown(&mut self) { if !self.title_measured { self.title_measured = true; - self.to_title_ms = STARTED.get().map(|s| s.elapsed().as_millis() as u32); + let ui_ms = UI_READY_MS.load(Ordering::Relaxed); + self.to_title_ms = if ui_ms != u32::MAX { + Some(ui_ms) + } else { + STARTED.get().map(|s| s.elapsed().as_millis() as u32) + }; } } From 7de8c51f4eeb02d8194348edecdd99c4e7ee04e6 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 00:29:46 +0200 Subject: [PATCH 025/163] Block entity tickers: sweep the list only after a slot is freed The list kept its slots for the whole tick; sweeping it every tick cost two hash lookups per ticker. Now it is swept only when a slot was freed or a block entity was taken out and not brought back. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/block_entities.rs | 31 +++++++++++++++++---- 1 file changed, 26 insertions(+), 5 deletions(-) diff --git a/crates/horizon-client/src/block_entities.rs b/crates/horizon-client/src/block_entities.rs index f4b0c411d..93abb3711 100644 --- a/crates/horizon-client/src/block_entities.rs +++ b/crates/horizon-client/src/block_entities.rs @@ -24,7 +24,7 @@ //! registry; whether a slot is made is decided when the slot is promoted at //! the start of the next tick, from the block state then. use crate::containers::BlockEntity; -use crate::fast_hash::FxHashMap; +use crate::fast_hash::{FxHashMap, FxHashSet}; use std::collections::HashMap; pub type Pos = (i32, i32, i32); @@ -57,6 +57,12 @@ pub struct BlockEntities { /// not here any more was cancelled. pending: FxHashMap, next_slot: u32, + /// Whether a slot was freed since the list was last swept: otherwise + /// every slot in it is still live, unless its block entity is `out`. + freed: bool, + /// Positions whose block entity `take` took and `put` has not brought + /// back. + out: FxHashSet, /// `Ticking` by block state id; empty until the game builds it. states: Vec, } @@ -158,7 +164,7 @@ impl BlockEntities { } /// `removeBlockEntityTicker`: no slot, made or pending. fn cancel(&mut self, pos: &Pos) { - self.live.remove(pos); + self.freed |= self.live.remove(pos).is_some(); self.pending.remove(pos); } @@ -199,10 +205,15 @@ impl BlockEntities { /// The block entity at `pos`, out of the map for a while: its slot stays /// for `put` to bring it back (a tick working on it). pub fn take(&mut self, pos: &Pos) -> Option { - self.map.remove(pos) + let taken = self.map.remove(pos); + if taken.is_some() { + self.out.insert(*pos); + } + taken } /// Brings back what `take` took, in its slot. pub fn put(&mut self, pos: Pos, entity: BlockEntity) { + self.out.remove(&pos); if self.map.insert(pos, entity).is_none() && !self.live.contains_key(&pos) && !self.pending.contains_key(&pos) @@ -213,11 +224,11 @@ impl BlockEntities { /// Removes the block entities `keep` refuses, and their slots /// (`clearAllBlockEntities` of unloaded chunks). pub fn retain(&mut self, mut keep: impl FnMut(&Pos, &mut BlockEntity) -> bool) { - let (live, pending) = (&mut self.live, &mut self.pending); + let (live, pending, freed) = (&mut self.live, &mut self.pending, &mut self.freed); self.map.retain(|p, e| { let kept = keep(p, e); if !kept { - live.remove(p); + *freed |= live.remove(p).is_some(); pending.remove(p); } kept @@ -229,6 +240,8 @@ impl BlockEntities { self.live.clear(); self.added.clear(); self.pending.clear(); + self.out.clear(); + self.freed = false; } /// A loaded or generated chunk's block entities, in the order the chunk /// lists them; they tick in its block entity map's order @@ -280,6 +293,10 @@ impl BlockEntities { self.live.insert(pos, slot); self.tickers.push((pos, slot)); } + if !std::mem::take(&mut self.freed) && self.out.is_empty() { + return self.tickers.clone(); + } + self.out.clear(); let (live, map) = (&mut self.live, &self.map); self.tickers.retain(|(p, slot)| { let mine = live.get(p) == Some(slot); @@ -348,6 +365,10 @@ mod tests { let slots = b.tickers(|p| s.get(&p).copied().unwrap_or(0)); b.retain(|p, _| *p != (1, 0, 0)); assert!(b.is_live(slots[0]) && !b.is_live(slots[1])); + // A block entity taken and never brought back loses its slot. + b.take(&(0, 0, 0)); + assert_eq!(order(&mut b, &s), [(2, 0, 0)]); + assert_eq!(order(&mut b, &s), [(2, 0, 0)]); } #[test] From 5253e94262755c809473cb956617fe52b45679ba Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 00:29:46 +0200 Subject: [PATCH 026/163] Dedicated server: skip the client ticks of spawners, trial spawners and vaults Their particles, ambient sounds and the turning display mob are for a window. A dedicated or integrated server has none, yet made a display mob for every spawner it ticked. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game/block_entity_ticks.rs | 10 +++++++--- crates/horizon-client/src/game/vault.rs | 7 +++++-- 2 files changed, 12 insertions(+), 5 deletions(-) diff --git a/crates/horizon-client/src/game/block_entity_ticks.rs b/crates/horizon-client/src/game/block_entity_ticks.rs index 7de960716..afe1224fb 100644 --- a/crates/horizon-client/src/game/block_entity_ticks.rs +++ b/crates/horizon-client/src/game/block_entity_ticks.rs @@ -57,9 +57,13 @@ impl Game<'_> { } self.update_song_volumes(); self.scan_for_hearts(); - self.client_tick_spawners(&spawners); - for key in trial_spawners { - self.client_tick_trial_spawner(key); + // The client ticks (particles, sounds, the turning mob) are for a + // window; a dedicated or integrated server has none. + if self.options.dedicated.is_none() { + self.client_tick_spawners(&spawners); + for key in trial_spawners { + self.client_tick_trial_spawner(key); + } } Ok(()) } diff --git a/crates/horizon-client/src/game/vault.rs b/crates/horizon-client/src/game/vault.rs index 8cf67804d..f3edfddb3 100644 --- a/crates/horizon-client/src/game/vault.rs +++ b/crates/horizon-client/src/game/vault.rs @@ -121,7 +121,8 @@ impl Game<'_> { .put(key, BlockEntity::Vault(vault)); Some(self.vault_events(key, events).map(|()| out)) } - /// The server tick of the vault at `key`, then its client tick. + /// The server tick of the vault at `key`, then its client tick when there + /// is a window. pub(super) fn tick_vault(&mut self, key: Pos) -> Result<()> { let pos = [key.0, key.1, key.2]; let ticked = self.with_vault(key, |v, l, random, state, ominous, roll, events| { @@ -130,7 +131,9 @@ impl Game<'_> { if let Some(result) = ticked { result?; } - self.client_tick_vault(key); + if self.options.dedicated.is_none() { + self.client_tick_vault(key); + } Ok(()) } /// `VaultBlock.useItemOn` with `held` in the hand that acts: true when the From 42d65465a4e18b0f99a6814b4ce33b17d75f34da Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sat, 17 Oct 2026 23:39:11 +0100 Subject: [PATCH 027/163] Startup stage 3a: split shared resources into core and rest (#712) --- crates/horizon-client/src/game.rs | 426 +++++++++++------- .../horizon-client/src/game/advancements.rs | 24 +- crates/horizon-client/src/game/agent.rs | 47 +- crates/horizon-client/src/game/allays.rs | 6 +- .../horizon-client/src/game/armor_stands.rs | 19 +- crates/horizon-client/src/game/backdrop.rs | 12 +- crates/horizon-client/src/game/banners.rs | 2 +- crates/horizon-client/src/game/beacon.rs | 8 +- crates/horizon-client/src/game/beehives.rs | 8 +- .../src/game/block_entity_anims.rs | 8 +- crates/horizon-client/src/game/block_items.rs | 4 +- crates/horizon-client/src/game/blockctl.rs | 2 +- crates/horizon-client/src/game/boats.rs | 10 +- crates/horizon-client/src/game/books.rs | 2 +- crates/horizon-client/src/game/breezes.rs | 2 +- crates/horizon-client/src/game/chat.rs | 14 +- crates/horizon-client/src/game/combat.rs | 4 +- crates/horizon-client/src/game/commands.rs | 18 +- .../src/game/commands/compute.rs | 2 +- .../horizon-client/src/game/commands/data.rs | 2 +- .../src/game/commands/effects.rs | 8 +- .../src/game/commands/execute.rs | 6 +- .../horizon-client/src/game/commands/extra.rs | 2 +- .../horizon-client/src/game/commands/items.rs | 14 +- .../src/game/commands/terrain_cmds.rs | 32 +- .../src/game/commands/world_cmds.rs | 12 +- crates/horizon-client/src/game/composter.rs | 2 +- crates/horizon-client/src/game/control.rs | 4 +- .../horizon-client/src/game/copper_golems.rs | 4 +- crates/horizon-client/src/game/creaking.rs | 6 +- crates/horizon-client/src/game/creatures.rs | 50 +- .../horizon-client/src/game/decorated_pot.rs | 2 +- .../src/game/dispense_fixture.rs | 14 +- crates/horizon-client/src/game/dispenser.rs | 44 +- crates/horizon-client/src/game/dragon.rs | 32 +- .../src/game/enchant_effects.rs | 52 +-- crates/horizon-client/src/game/end.rs | 16 +- .../horizon-client/src/game/entity_culling.rs | 4 +- crates/horizon-client/src/game/explosion.rs | 16 +- crates/horizon-client/src/game/extras.rs | 2 +- .../horizon-client/src/game/falling_damage.rs | 4 +- crates/horizon-client/src/game/fishing.rs | 14 +- crates/horizon-client/src/game/fov.rs | 2 +- crates/horizon-client/src/game/frames.rs | 2 +- crates/horizon-client/src/game/golems.rs | 14 +- crates/horizon-client/src/game/growth.rs | 4 +- crates/horizon-client/src/game/hand.rs | 14 +- .../horizon-client/src/game/initial_spawn.rs | 2 +- crates/horizon-client/src/game/item_draw.rs | 2 +- crates/horizon-client/src/game/jukebox.rs | 10 +- crates/horizon-client/src/game/lan.rs | 8 +- crates/horizon-client/src/game/lan_actions.rs | 12 +- .../horizon-client/src/game/lan_crafting.rs | 10 +- crates/horizon-client/src/game/lan_trading.rs | 14 +- crates/horizon-client/src/game/leads.rs | 4 +- crates/horizon-client/src/game/lightning.rs | 8 +- crates/horizon-client/src/game/loom.rs | 6 +- crates/horizon-client/src/game/mace.rs | 10 +- crates/horizon-client/src/game/machines.rs | 20 +- .../src/game/machines/crafter.rs | 6 +- crates/horizon-client/src/game/maps.rs | 7 +- crates/horizon-client/src/game/minecarts.rs | 19 +- crates/horizon-client/src/game/mob_blocks.rs | 6 +- crates/horizon-client/src/game/mob_gear.rs | 4 +- crates/horizon-client/src/game/mount_menu.rs | 2 +- crates/horizon-client/src/game/mounts.rs | 8 +- crates/horizon-client/src/game/music.rs | 12 +- .../src/game/natural_spawning.rs | 8 +- crates/horizon-client/src/game/nautili.rs | 4 +- .../horizon-client/src/game/nether_portal.rs | 14 +- crates/horizon-client/src/game/packs.rs | 4 +- crates/horizon-client/src/game/pad.rs | 2 +- crates/horizon-client/src/game/paintings.rs | 2 +- crates/horizon-client/src/game/passengers.rs | 4 +- crates/horizon-client/src/game/persist.rs | 8 +- crates/horizon-client/src/game/perspective.rs | 10 +- crates/horizon-client/src/game/piglins.rs | 14 +- crates/horizon-client/src/game/potions.rs | 10 +- crates/horizon-client/src/game/powder_snow.rs | 2 +- crates/horizon-client/src/game/raids.rs | 16 +- crates/horizon-client/src/game/recipe_book.rs | 16 +- crates/horizon-client/src/game/remote.rs | 45 +- .../horizon-client/src/game/render_control.rs | 2 +- crates/horizon-client/src/game/render_tick.rs | 28 +- .../horizon-client/src/game/respawn_anchor.rs | 20 +- crates/horizon-client/src/game/sculk.rs | 27 +- .../horizon-client/src/game/sculk_fixture.rs | 6 +- crates/horizon-client/src/game/shield.rs | 12 +- crates/horizon-client/src/game/sign_edit.rs | 2 +- crates/horizon-client/src/game/sniffers.rs | 2 +- crates/horizon-client/src/game/spawner.rs | 12 +- .../src/game/station_control.rs | 2 +- crates/horizon-client/src/game/stations.rs | 55 ++- crates/horizon-client/src/game/stats.rs | 12 +- .../horizon-client/src/game/stats_screen.rs | 8 +- crates/horizon-client/src/game/storage.rs | 4 +- .../horizon-client/src/game/sulfur_cubes.rs | 4 +- crates/horizon-client/src/game/tnt.rs | 4 +- crates/horizon-client/src/game/trading.rs | 18 +- crates/horizon-client/src/game/trident.rs | 4 +- crates/horizon-client/src/game/villagers.rs | 20 +- .../src/game/wandering_trader.rs | 8 +- crates/horizon-client/src/game/wind.rs | 6 +- crates/horizon-client/src/game/wither.rs | 14 +- 104 files changed, 894 insertions(+), 701 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 8c04860cc..bc6123778 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -668,12 +668,23 @@ struct FallingBlock { /// recipes, biomes, mobs, collision and motion. Read-only and `Send + Sync`, /// so the client and an integrated server thread can share one copy. pub struct Resources { + core: WorldCore, + rest: std::sync::OnceLock, +} + +struct WorldCore { facts: BlockFacts, + biomes: Arc, + environment: Environment, + collision: BlockCollisionRegistry<'static>, + motion: MotionResources, + threads: usize, +} + +struct WorldRest { items: Items, recipes: Recipes, transformers: horizon_client::block_transform::Transformers, - biomes: Arc, - environment: Environment, mob_types: HashMap>, mob_data: horizon_client::mobs::MobData, providers: Providers, @@ -685,14 +696,88 @@ pub struct Resources { nether_environment: Environment, end_environment: Environment, behaviours: Behaviours, - collision: BlockCollisionRegistry<'static>, - motion: MotionResources, - threads: usize, player_arm: Option, player_type: Option>, - /// Enchantments, workstation recipes and brewing (game/stations.rs). stations: horizon_client::stations::StationData, } + +impl Resources { + fn rest(&self) -> &WorldRest { + self.rest + .get() + .expect("world resources joined before entry") + } + fn facts(&self) -> &BlockFacts { + &self.core.facts + } + fn items(&self) -> &Items { + &self.rest().items + } + fn recipes(&self) -> &Recipes { + &self.rest().recipes + } + fn transformers(&self) -> &horizon_client::block_transform::Transformers { + &self.rest().transformers + } + fn biomes(&self) -> &Arc { + &self.core.biomes + } + fn environment(&self) -> &Environment { + &self.core.environment + } + fn mob_types(&self) -> &HashMap> { + &self.rest().mob_types + } + fn mob_data(&self) -> &horizon_client::mobs::MobData { + &self.rest().mob_data + } + fn providers(&self) -> &Providers { + &self.rest().providers + } + fn block_entity_render(&self) -> &horizon_client::block_entity_render::BlockEntityRenderer { + &self.rest().block_entity_render + } + fn animate(&self) -> &horizon_client::animate_tick::AnimateTables { + &self.rest().animate + } + fn fog(&self) -> &horizon_client::fog::FogTables { + &self.rest().fog + } + fn music(&self) -> &horizon_client::music::MusicTables { + &self.rest().music + } + fn ambient(&self) -> &horizon_client::ambience::AmbientTables { + &self.rest().ambient + } + fn nether_environment(&self) -> &Environment { + &self.rest().nether_environment + } + fn end_environment(&self) -> &Environment { + &self.rest().end_environment + } + fn behaviours(&self) -> &Behaviours { + &self.rest().behaviours + } + fn collision(&self) -> &BlockCollisionRegistry<'static> { + &self.core.collision + } + fn motion(&self) -> &MotionResources { + &self.core.motion + } + fn threads(&self) -> usize { + self.core.threads + } + fn player_arm(&self) -> &Option { + &self.rest().player_arm + } + fn player_type(&self) -> &Option> { + &self.rest().player_type + } + fn stations(&self) -> &horizon_client::stations::StationData { + &self.rest().stations + } +} + /// Everything the title and menus draw: the GUI atlas with its font and the /// title panorama. Kept apart from the world bundle so the title can appear /// before the block sprites, models and gameplay tables are ready. @@ -1270,7 +1355,7 @@ impl Game<'_> { /// A block's outline boxes in world space (`getShape` plus the random offset). fn outline_boxes(&self, pos: [i32; 3]) -> Vec<[f64; 6]> { let state = self.world.block(pos[0], pos[1], pos[2]); - let f = self.res.facts.get(state); + let f = self.res.facts().get(state); let o = if f.outline_offset { self.pack .context @@ -1332,8 +1417,8 @@ impl Game<'_> { let mut t = 0.0; while t <= reach { let state = self.world.block(pos[0], pos[1], pos[2]); - let f = self.res.facts.get(state); - if !self.res.facts.is_air(state) + let f = self.res.facts().get(state); + if !self.res.facts().is_air(state) && !(f.fluid != Fluid::None && !f.waterlogged && &*f.name != "minecraft:kelp" @@ -1435,7 +1520,11 @@ impl Game<'_> { } /// Inventory.add: returns the stack that did not fit. fn give(&mut self, mut stack: ItemStack) -> Option { - let max = self.res.items.get(&stack.item).map_or(64, |i| i.max_stack); + let max = self + .res + .items() + .get(&stack.item) + .map_or(64, |i| i.max_stack); // Prefer the selected slot, then the hotbar, then the main inventory. let order: Vec = std::iter::once(self.selected) .chain((0..36).filter(|&i| i != self.selected)) @@ -1486,7 +1575,7 @@ impl Game<'_> { .or_else(|| models.iter().find_map(|(_, model)| model.particle))?; let name = self.pack.layer_names.get(&layer)?.clone(); let tint = if face.is_some_and(|face| face.quad.tint_index >= 0) { - let n = &self.res.facts.get(state).name; + let n = &self.res.facts().get(state).name; if n.contains("leaves") || n.contains("vine") { 0x48B518 } else { @@ -1498,7 +1587,7 @@ impl Game<'_> { Some((name, tint)) } fn particle_shape(&self, pos: [i32; 3], state: BlockStateId) -> Vec<[f64; 6]> { - let f = self.res.facts.get(state); + let f = self.res.facts().get(state); let offset = if f.outline_offset { self.pack .context @@ -1576,14 +1665,14 @@ impl Game<'_> { ) -> Vec { let registry = self.pack.assets.registry; let dynamic = self.pending.dynamic(pos); - match self.res.items.block_loot_sequence(registry, state) { + match self.res.items().block_loot_sequence(registry, state) { Some(sequence) => { let random = self.rand_sequences.get(&sequence, self.level.seed); self.res - .items + .items() .block_drops_with(registry, state, held, &dynamic, random) } - None => self.res.items.block_drops_with( + None => self.res.items().block_drops_with( registry, state, held, @@ -1653,14 +1742,14 @@ impl Game<'_> { ) { return true; } - if !item.tick(&self.world, &self.res.facts, self.collision) { + if !item.tick(&self.world, self.res.facts(), self.collision) { return false; } let environment = item.environment_tick( &self.world, - &self.res.facts, + self.res.facts(), self.pack.assets.registry, - &self.res.items, + self.res.items(), ); // shortcut: age is the fresh-drop clock; use entity ticks for saved/frozen-age phase parity. if environment.should_play_lava_hurt_sound(item.age) { @@ -1783,17 +1872,17 @@ impl Game<'_> { let mut level = GameLevel { cart_boxes, world: &mut self.world, - facts: &self.res.facts, + facts: self.res.facts(), events: &mut self.level_events, dimension, darken, raining: rain > 0.2, thundering: thunder > 0.9, player_box, - biomes: &self.res.biomes, + biomes: self.res.biomes(), seed: self.level.seed, - behaviours: &self.res.behaviours, - items: &self.res.items, + behaviours: self.res.behaviours(), + items: self.res.items(), loot: horizon_client::structure_blocks::loot_data(&self.options.resources), registry: self.pack.assets.registry, rules, @@ -1801,7 +1890,7 @@ impl Game<'_> { pending: &mut self.pending, spill: &mut self.spill, }; - let result = f(&self.res.behaviours, &mut level, &mut self.block_ticks); + let result = f(self.res.behaviours(), &mut level, &mut self.block_ticks); self.flush_spill(); result } @@ -1854,7 +1943,7 @@ impl Game<'_> { ); let simulation = self.settings.render_distance.min(8); let mut ticking = Vec::new(); - let facts = &self.res.facts; + let facts = self.res.facts(); for (&(x, z), chunk) in &self.world.chunks { if (x - pcx).abs() > simulation || (z - pcz).abs() > simulation || !chunk.lit { continue; @@ -1956,10 +2045,10 @@ impl Game<'_> { let state = BlockStateId(data as u32); let p = [pos.x, pos.y, pos.z]; self.destroy_particles(p, state); - if self.res.facts.is_air(state) { + if self.res.facts().is_air(state) { continue; } - let sounds = self.res.facts.get(state).sounds.clone(); + let sounds = self.res.facts().get(state).sounds.clone(); let c = [ f64::from(pos.x) + 0.5, f64::from(pos.y) + 0.5, @@ -2070,7 +2159,7 @@ impl Game<'_> { no_gravity: false, drop_item: true, fall_distance: 0.0, - damage: if self.res.facts.get(state).name.ends_with("anvil") { + damage: if self.res.facts().get(state).name.ends_with("anvil") { horizon_client::falling_block::Damage::anvil() } else { Default::default() @@ -2183,7 +2272,7 @@ impl Game<'_> { fn open_menu(&mut self, pos: [i32; 3]) { let name = self .res - .facts + .facts() .get(self.world.block(pos[0], pos[1], pos[2])) .name .clone(); @@ -2307,7 +2396,7 @@ impl Game<'_> { next.y.floor() as i32, next.z.floor() as i32, ); - let below_facts = self.res.facts.get(below); + let below_facts = self.res.facts().get(below); // PowderSnowBlock.getCollisionShape for a FallingBlockEntity: the // whole block, or 0.9 high after a fall of more than 2.5 blocks, // where the block it rests in is the snow itself. @@ -2359,7 +2448,7 @@ impl Game<'_> { self.falling = falling; for (state, at) in dropped { // Entity.spawnAtLocation: an item entity where the block was. - let item = self.res.facts.get(state).item.clone(); + let item = self.res.facts().get(state).item.clone(); if &*item != "minecraft:air" { let r = &mut self.world.random; let v = [ @@ -2388,7 +2477,7 @@ impl Game<'_> { self.pad_rumble(horizon_client::gamepad::Rumble::BlockBroken); // ServerPlayerGameMode.destroyBlock. let state = self.world.block(pos[0], pos[1], pos[2]); - let facts = self.res.facts.get(state).clone(); + let facts = self.res.facts().get(state).clone(); // Block.playerWillDestroy: mining their gold angers all nearby piglins. if self.guarded_by_piglins(&facts.name) { self.anger_piglins(false); @@ -2425,7 +2514,7 @@ impl Game<'_> { && let Some(stack) = self.inventory[self.selected].clone() && let Some(max) = self .res - .items + .items() .get(&stack.item) .filter(|i| i.max_damage > 0 && !i.tool.is_empty()) .map(|i| i.max_damage) @@ -2439,7 +2528,10 @@ impl Game<'_> { } } let harvest = !facts.requires_tool - || self.res.items.correct_for_drops(held.as_ref(), &facts.name); + || self + .res + .items() + .correct_for_drops(held.as_ref(), &facts.name); if harvest { // Block.playerDestroy: the mined statistic, the exhaustion and the drops. self.stats.add("mined", &facts.name, 1); @@ -2610,7 +2702,7 @@ impl Game<'_> { let Some(stack) = self.held().cloned() else { return Ok(false); }; - let Some(info) = self.res.items.get(&stack.item).cloned() else { + let Some(info) = self.res.items().get(&stack.item).cloned() else { return Ok(false); }; if block_hit.is_some() && (self.use_bone_meal(&stack)? || self.ignite_tnt(&stack)?) { @@ -2721,7 +2813,7 @@ impl Game<'_> { return Ok(true); }; let target = [pos.x, pos.y, pos.z]; - if let Some(entity) = BlockEntity::for_block(&self.res.facts.get(state).name) { + if let Some(entity) = BlockEntity::for_block(&self.res.facts().get(state).name) { let key = (target[0], target[1], target[2]); self.world.block_entities.insert(key, entity); let game_master = self.can_use_game_master_blocks(); @@ -2826,7 +2918,7 @@ impl Game<'_> { self.using = None; return; } - let Some(info) = self.res.items.get(&stack.item).cloned() else { + let Some(info) = self.res.items().get(&stack.item).cloned() else { self.using = None; return; }; @@ -2940,13 +3032,13 @@ impl Game<'_> { }); } let state = self.world.block(hit.pos[0], hit.pos[1], hit.pos[2]); - let facts = self.res.facts.get(state); + let facts = self.res.facts().get(state); if facts.hardness < 0.0 { return Ok(()); } // Player.getDestroySpeed / BlockBehaviour.getDestroyProgress. let held = self.held(); - let mut speed = self.res.items.mining_speed(held, &facts.name); + let mut speed = self.res.items().mining_speed(held, &facts.name); speed = self.modify_destroy_speed(speed); let player = self.player.as_ref().ok_or("no player")?; if !player.ground.on_ground { @@ -2955,7 +3047,7 @@ impl Game<'_> { let eye = self.eye_position().unwrap_or_default(); if self .res - .facts + .facts() .get(self.world.block( eye[0].floor() as i32, eye[1].floor() as i32, @@ -2966,7 +3058,7 @@ impl Game<'_> { { speed *= self.submerged_mining_speed(); } - let harvest = !facts.requires_tool || self.res.items.correct_for_drops(held, &facts.name); + let harvest = !facts.requires_tool || self.res.items().correct_for_drops(held, &facts.name); let progress = if facts.hardness == 0.0 { 1.0 } else { @@ -3006,11 +3098,11 @@ impl Game<'_> { if self.dim == Dim::Nether { // Below the bedrock ceiling: a solid floor with two air blocks above. for y in (32..120).rev() { - let floor = self.res.facts.get(self.world.block(x, y - 1, z)); + let floor = self.res.facts().get(self.world.block(x, y - 1, z)); if floor.full_collision && floor.fluid == Fluid::None - && self.res.facts.is_air(self.world.block(x, y, z)) - && self.res.facts.is_air(self.world.block(x, y + 1, z)) + && self.res.facts().is_air(self.world.block(x, y, z)) + && self.res.facts().is_air(self.world.block(x, y + 1, z)) { return Some(y); } @@ -3020,8 +3112,8 @@ impl Game<'_> { let mut y = MIN_Y + HEIGHT - 1; while y > MIN_Y { let s = self.world.block(x, y, z); - if !self.res.facts.is_air(s) { - let f = self.res.facts.get(s); + if !self.res.facts().is_air(s) { + let f = self.res.facts().get(s); let ok = f.full_collision && f.fluid == Fluid::None && !f.name.contains("leaves") @@ -3122,7 +3214,7 @@ impl Game<'_> { // LivingEntity.canGlideUsing: a glider in its slot that will not break next. player.glider = self.armor[1].as_ref().is_some_and(|s| { self.res - .items + .items() .get(&s.item) .is_some_and(|i| i.glider && (i.max_damage == 0 || s.damage + 1 < i.max_damage)) }); @@ -3244,7 +3336,7 @@ impl Game<'_> { // LivingEntity.canGlideUsing: a glider in its slot that will not break next. player.glider = self.armor[1].as_ref().is_some_and(|s| { self.res - .items + .items() .get(&s.item) .is_some_and(|i| i.glider && (i.max_damage == 0 || s.damage + 1 < i.max_damage)) }); @@ -3258,7 +3350,7 @@ impl Game<'_> { self.inventory.get(slot)?.as_ref() } }) - .and_then(|s| self.res.items.get(&s.item)) + .and_then(|s| self.res.items().get(&s.item)) .map(|i| i.use_speed); // PowderSnowBlock.canEntityWalkOnPowderSnow and LivingEntity.canFreeze. player.leather_boots = self.armor[3] @@ -3266,7 +3358,7 @@ impl Game<'_> { .is_some_and(|s| &*s.item == "minecraft:leather_boots"); let immune = self .res - .items + .items() .item_tags .get("minecraft:freeze_immune_wearables"); player.freeze_immune = self @@ -3323,7 +3415,7 @@ impl Game<'_> { MotionEvent::Emission { state, in_water, .. } if !crouching => { - let sounds = self.res.facts.get(state).sounds.clone(); + let sounds = self.res.facts().get(state).sounds.clone(); // Entity.playStepSound: the block's step sound at 0.15 volume, // muffled under the swim sound in water. let (volume, pitch) = if in_water { @@ -3840,7 +3932,7 @@ impl Game<'_> { // moved to (x, y). Horizon tracks no item cooldowns to shade yet. let max_damage = self .res - .items + .items() .get(&stack.item) .map_or(0, |info| info.max_damage as i32); let decorations = hud_overlays::ItemDecorations { @@ -3998,7 +4090,7 @@ impl Game<'_> { let eye = p.position.y + f64::from(p.dimensions.eye_height); let under_water = self .res - .facts + .facts() .get(self.world.block( p.position.x.floor() as i32, eye.floor() as i32, @@ -4261,7 +4353,7 @@ impl Game<'_> { /// `RecipeCraftingHolder.awardUsedRecipes`: a crafted recipe becomes known /// (special ones never do). fn award_crafted(&mut self, recipes: &[String]) { - let index = &self.res.stations.recipe_index; + let index = &self.res.stations().recipe_index; let (_, unlocked) = self.level.recipe_book.add_recipes(index, recipes); self.recipe_unlocked(&unlocked); } @@ -4270,7 +4362,7 @@ impl Game<'_> { let grid: Vec> = (0..n * n).map(|i| self.craft_grid[i].clone()).collect(); let scale = |id: i32| self.maps.data.get(&id).map(|m| m.scale); self.res - .recipes + .recipes() .find_with(&grid, n, &scale) .map(|(name, result)| (name.to_owned(), result)) } @@ -4470,7 +4562,7 @@ impl Game<'_> { ); let name = self .res - .facts + .facts() .get(self.world.block(key.0, key.1, key.2)) .name .clone(); @@ -4543,7 +4635,7 @@ impl Game<'_> { let items = self.creative_screen.items(&self.pack.names); let first = self.creative_screen.first_row(&self.pack.names); let shown = items.get(first * 9 + slot - Creative::DISPLAY); - let catalog = &self.res.items; + let catalog = self.res.items(); let max = |s: &ItemStack| catalog.get(&s.item).map_or(64, |i| i.max_stack); match click_display(&mut self.carried, shown, max, button, input) { DisplayClick::Hotbar(i, stack) => self.inventory[i] = Some(stack), @@ -4699,7 +4791,7 @@ impl Game<'_> { Some(BlockEntity::Chest(_)) => { let shulker = self.container.is_some_and(|k| { let id = self.world.block(k.0, k.1, k.2); - storage::is_shulker_box(&self.res.facts.get(id).name) + storage::is_shulker_box(&self.res.facts().get(id).name) }); let kind = match size { 5 => Kind::Hopper, @@ -4792,15 +4884,15 @@ impl Game<'_> { next_id: std::cell::Cell::new(next_map), }; let trade_env = horizon_client::merchant::TradeEnv { - trades: &self.res.stations.trades, - enchantments: &self.res.stations.enchantments, + trades: &self.res.stations().trades, + enchantments: &self.res.stations().enchantments, maps: Some(&maps), }; let env = Env { - items: &self.res.items, - recipes: &self.res.recipes, - brewing: &self.res.stations.brewing, - banners: &self.res.stations.banners, + items: self.res.items(), + recipes: self.res.recipes(), + brewing: &self.res.stations().brewing, + banners: &self.res.stations().banners, trade: Some(&trade_env), }; menu.creative = creative; @@ -4888,7 +4980,7 @@ impl Game<'_> { .and_then(|k| self.world.block_entities.get_mut(&k)) { // AbstractFurnaceBlockEntity.setItem: only a new input restarts cooking. - f.input_clicked(&self.res.recipes, before[0].clone()); + f.input_clicked(self.res.recipes(), before[0].clone()); } self.apply_equipment(); true @@ -5287,7 +5379,7 @@ impl Game<'_> { None => self.carried = Some(result), Some(c) if c.item == result.item - && c.count + result.count <= max(&self.res.items, c) => + && c.count + result.count <= max(self.res.items(), c) => { c.count += result.count } @@ -5303,7 +5395,7 @@ impl Game<'_> { while let Some((recipe, result)) = self.craft_recipe() { let made = (result.item.clone(), result.count); let cells = self.craft_size * self.craft_size; - let remainders = self.res.recipes.remainders( + let remainders = self.res.recipes().remainders( &recipe, &self.craft_grid[..cells], self.craft_size, @@ -5317,7 +5409,7 @@ impl Game<'_> { None => self.carried = Some(result), Some(c) if c.item == result.item - && c.count + result.count <= max(&self.res.items, c) => + && c.count + result.count <= max(self.res.items(), c) => { c.count += result.count } @@ -5359,7 +5451,7 @@ impl Game<'_> { let wanted = ["head", "chest", "legs", "feet"][slot - 500]; let fits = self.carried.as_ref().is_none_or(|c| { self.res - .items + .items() .get(&c.item) .and_then(|i| i.equip_slot.as_deref()) == Some(wanted) @@ -5373,7 +5465,7 @@ impl Game<'_> { } let carried = self.carried.take(); let current = self.slot_mut(slot).take(); - let items = &self.res.items; + let items = self.res.items(); let (new_slot, new_carried) = match (carried, current) { (None, Some(mut s)) if right => { let half = s.count.div_ceil(2); @@ -5414,7 +5506,7 @@ impl Game<'_> { .container .and_then(|k| self.world.block_entities.get_mut(&k)) { - f.input_clicked(&self.res.recipes, before); + f.input_clicked(self.res.recipes(), before); } } /// `Camera.setRotation`: the camera's orientation, turned round in @@ -5490,7 +5582,7 @@ impl Game<'_> { if item.fire_ticks > 0 && !self .res - .items + .items() .resists_fire(&item.stack, "minecraft:in_fire") { let at = item.previous.lerp(item.position, alpha); @@ -5574,7 +5666,7 @@ impl Game<'_> { let (radius, strength) = horizon_client::shadows::shadow_params(id); horizon_client::shadows::shadow( &self.world, - &self.res.facts, + self.res.facts(), sprite, camera, pos, @@ -5615,7 +5707,7 @@ impl Game<'_> { // Beams and structure outlines reach far outside their block // (BlockEntityRenderer.shouldRenderOffScreen): never culled. let off_screen = |state: u32| { - let name = &*self.res.facts.get(BlockStateId(state)).name; + let name = &*self.res.facts().get(BlockStateId(state)).name; matches!( name, "minecraft:beacon" @@ -5638,7 +5730,7 @@ impl Game<'_> { for block in visible { let start = out.len(); self.res - .block_entity_render + .block_entity_render() .render(&scene, std::iter::once(block), &mut out); if !off_screen(block.1) { self.cull_entity_vertices(&mut out, start); @@ -5646,7 +5738,7 @@ impl Game<'_> { } } else { self.res - .block_entity_render + .block_entity_render() .render(&scene, visible, &mut out); } if let Some(mining) = &self.mining @@ -5660,7 +5752,7 @@ impl Game<'_> { .world .block(mining.pos[0], mining.pos[1], mining.pos[2]); self.res - .block_entity_render + .block_entity_render() .render_breaking(&scene, mining.pos, state.0, &mut out); } } @@ -5796,7 +5888,7 @@ impl Game<'_> { ) - camera) .as_vec3(); let state = self.world.block(m.pos[0], m.pos[1], m.pos[2]); - if self.res.facts.get(state).render_shape + if self.res.facts().get(state).render_shape == horizon_client::blocks::RenderShape::Model && let Ok(models) = self .pack @@ -5830,7 +5922,7 @@ impl Game<'_> { if self.dim == Dim::End { let sky = self .res - .end_environment + .end_environment() .sample(self.world.day_time, None, None); return (15.0 - 15.0 * sky.sky_light_level).round() as i32; } @@ -5842,7 +5934,10 @@ impl Game<'_> { { return darken; } - let mut sky = self.res.environment.sample(self.world.day_time, None, None); + let mut sky = self + .res + .environment() + .sample(self.world.day_time, None, None); horizon_client::environment::apply_weather(&mut sky, rain, thunder); // Level.updateSkyBrightness: darkening from the sky light level. let darken = (15.0 - 15.0 * sky.sky_light_level).round() as i32; @@ -5874,7 +5969,7 @@ impl Game<'_> { let hand_damage = 1.0 + self .held() - .and_then(|h| self.res.items.get(&h.item)) + .and_then(|h| self.res.items().get(&h.item)) .map_or(0.0, |i| i.attack_damage); let damage = hand_damage + self.effect_attack_bonus(); let scale = self.attack_strength_scale(); @@ -5897,7 +5992,7 @@ impl Game<'_> { fn attack_strength_scale(&self) -> f32 { let speed = self .held() - .and_then(|h| self.res.items.get(&h.item)) + .and_then(|h| self.res.items().get(&h.item)) .map_or(0.0, |i| i.attack_speed); let delay = 20.0 / (4.0 + speed).max(0.1); ((self.attack_ticks as f32 + 0.5) / delay).clamp(0.0, 1.0) @@ -5907,7 +6002,7 @@ impl Game<'_> { let p = self.player.as_ref()?; let sword = self.held().is_some_and(|s| { self.res - .items + .items() .item_tags .get("minecraft:swords") .is_some_and(|tag| tag.contains(&*s.item)) @@ -5979,7 +6074,7 @@ impl Game<'_> { let hand_damage = 1.0 + self .held() - .and_then(|h| self.res.items.get(&h.item)) + .and_then(|h| self.res.items().get(&h.item)) .map_or(0.0, |i| i.attack_damage); if self.attack_frame() || self.attack_armor_stand() @@ -6112,7 +6207,8 @@ impl Game<'_> { let mut lit_changes = Vec::new(); for (pos, entity) in self.world.block_entities.iter_mut() { if let BlockEntity::Furnace(f) = entity - && let Some(lit) = f.tick(&self.res.recipes, &self.res.items, &self.res.providers) + && let Some(lit) = + f.tick(self.res.recipes(), self.res.items(), self.res.providers()) { lit_changes.push((*pos, lit)); } @@ -6322,7 +6418,7 @@ impl Game<'_> { let dim = Dim::from_id(&level.dimension); let (mut streaming, save) = self.make_streaming(&save_root, dim, level.seed)?; streaming.radius = self.settings.render_distance; - let mut world = World::new(self.res.facts.air, level.seed); + let mut world = World::new(self.res.facts().air, level.seed); world.fast_lava = dim == Dim::Nether; world.game_time = level.time; world.day_time = self.options.time.unwrap_or(level.day_time); @@ -6400,7 +6496,7 @@ impl Game<'_> { self.save = save; self.level = level; // ServerRecipeBook.loadUntrusted: recipes the manager does not have are dropped. - let index = &self.res.stations.recipe_index; + let index = &self.res.stations().recipe_index; let book = &mut self.level.recipe_book; book.recipes.retain(|r| index.contains(r)); book.to_be_displayed.retain(|r| index.contains(r)); @@ -6480,7 +6576,7 @@ impl Game<'_> { horizon_client::flatgen::FlatTerrain::from_settings( &s, pack.assets.registry, - &res.biomes, + res.biomes(), ) }); let mut streaming = if let Some(inner) = flat { @@ -6489,25 +6585,25 @@ impl Game<'_> { inner: Arc::new(inner), save: save.clone(), registry: pack.assets.clone(), - biomes: res.biomes.clone(), + biomes: res.biomes().clone(), }), pack.context.clone(), - res.threads, + res.threads(), ) } else if self.options.test_terrain && dim == Dim::Overworld { - let inner = Arc::new(TestTerrain::new(pack.assets.registry, &res.biomes)?); + let inner = Arc::new(TestTerrain::new(pack.assets.registry, res.biomes())?); Streaming::new( Arc::new(Persistent { inner, save: save.clone(), registry: pack.assets.clone(), - biomes: res.biomes.clone(), + biomes: res.biomes().clone(), }), pack.context.clone(), - res.threads, + res.threads(), ) } else { - let inner = Arc::new(VanillaTerrain::for_dimension(&self.options.resources.join("worldgen"), pack.assets.registry, &res.biomes, seed, dim.id()).map_err(|e| { + let inner = Arc::new(VanillaTerrain::for_dimension(&self.options.resources.join("worldgen"), pack.assets.registry, res.biomes(), seed, dim.id()).map_err(|e| { format!("{e}\nPrepare the worldgen bundle with the launcher, or: horizon-prepare --prepare") })?); self.end.set_locator(Some(inner.clone())); @@ -6516,10 +6612,10 @@ impl Game<'_> { inner, save: save.clone(), registry: pack.assets.clone(), - biomes: res.biomes.clone(), + biomes: res.biomes().clone(), }), pack.context.clone(), - res.threads, + res.threads(), ) }; streaming.radius = self.settings.render_distance; @@ -6556,7 +6652,7 @@ impl Game<'_> { let keys: Vec<_> = self.world.modified.drain().collect(); let chunks = self.with_entities(keys.iter().filter_map(|k| self.world.chunks.get(k))); self.save - .save(&chunks, self.pack.assets.registry, &self.res.biomes)?; + .save(&chunks, self.pack.assets.registry, self.res.biomes())?; self.save_dimension_entities()?; // Coordinates scale by 8 between the Overworld and the Nether. let scale = match (self.dim, target) { @@ -6572,7 +6668,7 @@ impl Game<'_> { )); let (streaming, save) = self.make_streaming(&self.world_root.clone(), target, self.level.seed)?; - let mut world = World::new(self.res.facts.air, self.level.seed); + let mut world = World::new(self.res.facts().air, self.level.seed); world.fast_lava = target == Dim::Nether; world.game_time = self.world.game_time; world.day_time = self.world.day_time; @@ -6607,7 +6703,7 @@ impl Game<'_> { fn portal_shape(&self, start: [i32; 3], x_axis: bool) -> Option<([i32; 3], i32, i32)> { let name = |p: [i32; 3]| { self.res - .facts + .facts() .get(self.world.block(p[0], p[1], p[2])) .name .clone() @@ -6769,7 +6865,7 @@ impl Game<'_> { horizon_client::crash::clear_detail("World"); self.debug_charts.reset(); self.streaming.paused = true; - self.world = World::new(self.res.facts.air, 0); + self.world = World::new(self.res.facts().air, 0); self.player = None; self.sleeping = None; self.sleep_timer = 0; @@ -6832,7 +6928,7 @@ impl Game<'_> { .collect(); equipped.push((self.inventory[self.selected].as_ref(), "mainhand")); for (stack, slot) in equipped { - let Some(info) = stack.and_then(|s| self.res.items.get(&s.item)) else { + let Some(info) = stack.and_then(|s| self.res.items().get(&s.item)) else { continue; }; for (attribute, id, amount, op, group) in &info.modifiers { @@ -6867,7 +6963,7 @@ impl Game<'_> { .collect(); for (slot, amount) in self.armor.iter_mut().zip(losses) { if let Some(stack) = slot.as_mut() - && let Some(info) = self.res.items.get(&stack.item) + && let Some(info) = self.res.items().get(&stack.item) && info.max_damage > 0 { stack.damage += amount; @@ -6904,7 +7000,7 @@ impl Game<'_> { let b = p.map(|v| v.floor() as i32); if b != last { let state = self.world.block(b[0], b[1], b[2]); - let f = self.res.facts.get(state); + let f = self.res.facts().get(state); let face = [last[0] - b[0], last[1] - b[1], last[2] - b[2]]; if f.fluid != Fluid::None && f.fluid_level == 8 @@ -6918,7 +7014,7 @@ impl Game<'_> { point: p, }); } - if !self.res.facts.is_air(state) && f.fluid == Fluid::None { + if !self.res.facts().is_air(state) && f.fluid == Fluid::None { return Some(Hit { pos: b, face, @@ -6975,7 +7071,7 @@ impl Game<'_> { let Some(held) = self.held() else { return Ok(false); }; - let removes_dye = cauldron::removes_dye(&self.res.items, &held.item); + let removes_dye = cauldron::removes_dye(self.res.items(), &held.item); let above = self.world.block(pos[0], pos[1] + 1, pos[2]); let under_water = registry .state(above) @@ -7031,7 +7127,7 @@ impl Game<'_> { } let Some(id) = self .res - .items + .items() .get(&stack.item) .and_then(|i| i.block_transformer.clone()) else { @@ -7042,7 +7138,7 @@ impl Game<'_> { let shield = self .offhand .as_ref() - .and_then(|s| self.res.items.get(&s.item)) + .and_then(|s| self.res.items().get(&s.item)) .is_some_and(|i| i.blocks_attacks.is_some()); if shield && !self.keys.contains(&KeyCode::ShiftLeft) { return Ok(false); @@ -7064,8 +7160,8 @@ impl Game<'_> { }; let Some((_, t, state)) = self.res - .transformers - .apply(&self.res.items, registry, &id, face_name, &around) + .transformers() + .apply(self.res.items(), registry, &id, face_name, &around) else { return Ok(false); }; @@ -7136,7 +7232,7 @@ impl Game<'_> { }; let max = self .held() - .and_then(|s| self.res.items.get(&s.item)) + .and_then(|s| self.res.items().get(&s.item)) .map_or(0, |i| i.max_damage); let cell = self.held_mut(); if let Some(stack) = cell.as_mut() @@ -7201,7 +7297,7 @@ impl Game<'_> { return Ok(UseResult::Pass); }; let state = self.world.block(hit.pos[0], hit.pos[1], hit.pos[2]); - let f = self.res.facts.get(state).clone(); + let f = self.res.facts().get(state).clone(); if f.fluid == Fluid::None || f.fluid_level != 8 || f.fluid_falling { return Ok(UseResult::Pass); } @@ -7249,7 +7345,7 @@ impl Game<'_> { if !self.may_build() { return Ok(UseResult::Fail); } - let target = if self.res.facts.get(clicked).replaceable { + let target = if self.res.facts().get(clicked).replaceable { hit.pos } else { [ @@ -7291,7 +7387,7 @@ impl Game<'_> { if item == "honeycomb" { let registry = self.pack.assets.registry; let old = registry.state(clicked).cloned(); - if let Some(waxed) = old.and_then(|old| self.res.transformers.waxed(registry, &old)) + if let Some(waxed) = old.and_then(|old| self.res.transformers().waxed(registry, &old)) && let Ok(state) = registry.resolve(&waxed) { self.level_set(hit.pos, state)?; @@ -7312,7 +7408,7 @@ impl Game<'_> { if !self.may_build() { return Ok(UseResult::Fail); } - let name = self.res.facts.get(clicked).name.clone(); + let name = self.res.facts().get(clicked).name.clone(); if self.can_light(clicked, &name) { let registry = self.pack.assets.registry; let mut state = registry @@ -7467,7 +7563,7 @@ impl Game<'_> { ) }); let mut orbs = std::mem::take(&mut self.orbs); - orbs.retain_mut(|o| o.tick(&self.world, &self.res.facts, self.collision, target)); + orbs.retain_mut(|o| o.tick(&self.world, self.res.facts(), self.collision, target)); let mut gained = 0; let mut taken = Vec::new(); if let Some((min, max)) = bounds { @@ -7661,7 +7757,7 @@ impl Game<'_> { if hand == Hand::Off { continue; } - let Some(arm) = self.res.player_arm.clone() else { + let Some(arm) = self.res.player_arm().clone() else { continue; }; let Some(r) = self @@ -7859,7 +7955,7 @@ impl Game<'_> { /// base temperature lowered above y 80) or none (no precipitation). fn precipitation(&self, x: i32, y: i32, z: i32) -> Option { let chunk = self.world.chunks.get(&(x >> 4, z >> 4))?; - let b = self.res.biomes.get(chunk.biome(x, y, z)); + let b = self.res.biomes().get(chunk.biome(x, y, z)); if !b.precipitation { return None; } @@ -7875,7 +7971,7 @@ impl Game<'_> { let mut y = from; while y > MIN_Y { let s = self.world.block(x, y, z); - let f = self.res.facts.get(s); + let f = self.res.facts().get(s); if f.full_collision || f.fluid != Fluid::None || f.name.contains("leaves") { return y + 1; } @@ -8476,7 +8572,7 @@ impl Game<'_> { let keys: Vec<_> = self.world.modified.drain().collect(); let chunks = self.with_entities(keys.iter().filter_map(|k| self.world.chunks.get(k))); self.save - .save_later(&chunks, self.pack.assets.registry, &self.res.biomes)?; + .save_later(&chunks, self.pack.assets.registry, self.res.biomes())?; if wait { self.save.flush(); } @@ -8521,7 +8617,7 @@ impl Game<'_> { let s = self.world .block(c.x.floor() as i32, c.y.floor() as i32, c.z.floor() as i32); - (c, self.res.facts.get(s).fluid == Fluid::Water, yaw, pitch) + (c, self.res.facts().get(s).fluid == Fluid::Water, yaw, pitch) } None => ( glam::DVec3::new(0.5, 100.0, 0.5), @@ -8543,7 +8639,7 @@ impl Game<'_> { .get(&(block[0] >> 4, block[2] >> 4)) .map(|c| c.biome(block[0], block[1], block[2])) .unwrap_or(0); - let info = self.res.biomes.get(biome).clone(); + let info = self.res.biomes().get(biome).clone(); let environment = self.dim_environment(); let mut sky = environment.sample(self.world.day_time, info.sky, info.fog); let (rain, thunder) = if self.dim == Dim::Overworld { @@ -8584,7 +8680,7 @@ impl Game<'_> { self.pick() .map(|h| { let state = self.world.block(h.pos[0], h.pos[1], h.pos[2]); - let f = self.res.facts.get(state); + let f = self.res.facts().get(state); outline_after_terrain = self .pack .render @@ -8729,7 +8825,7 @@ impl Game<'_> { cave_culling: self.settings.horizon.cave_culling && !self .res - .facts + .facts() .get(self.world.block(block[0], block[1], block[2])) .solid_render, water_fog, @@ -9143,7 +9239,7 @@ impl Game<'_> { if !modified.is_empty() && let Err(e) = horizon_client::spans::time("save_chunks", || { self.save - .save_later(&modified, self.pack.assets.registry, &self.res.biomes) + .save_later(&modified, self.pack.assets.registry, self.res.biomes()) }) { log::warn!("Horizon: failed to save unloaded chunks: {e}"); @@ -10019,7 +10115,7 @@ impl<'a> Game<'a> { let registry = pack.assets.registry; // Until a world is opened the streamer is idle. let mut streaming = Streaming::new( - Arc::new(TestTerrain::new(registry, &res.biomes)?), + Arc::new(TestTerrain::new(registry, res.biomes())?), pack.context.clone(), 1, ); @@ -10039,7 +10135,7 @@ impl<'a> Game<'a> { minecarts::CartModels::load(document.as_ref()), ) }; - let world = World::new(res.facts.air, 0); + let world = World::new(res.facts().air, 0); let creative = options.creative; let inventory = vec![None; 36]; let now = Instant::now(); @@ -10047,8 +10143,8 @@ impl<'a> Game<'a> { let particles = horizon_client::particles::ParticleEngine::new(&root, &gui.atlas.sprites); Ok(Game { res: res.clone(), - collision: &res.collision, - motion: &res.motion, + collision: res.collision(), + motion: res.motion(), pack, gui, fog: Default::default(), @@ -10542,42 +10638,46 @@ fn load_resources( horizon_client::animate_tick::AnimateTables::load(&root, registry_owner.registry, &biomes)?; let fog = horizon_client::fog::FogTables::load(&root, &biomes); let resources = Resources { - stations, - facts, - items, - recipes, - transformers, - biomes, - environment, - collision, - motion, - providers: Providers::load(&root), - block_entity_render: horizon_client::block_entity_render::BlockEntityRenderer::load( - &root, - registry_owner.registry, - )?, - animate, - fog, - music: horizon_client::music::MusicTables::load(&root), - ambient: horizon_client::ambience::AmbientTables::load(&root), - nether_environment: Environment::load_dimension(&root, "the_nether", false)?, - end_environment: Environment::load_dimension(&root, "the_end", false)?, - behaviours: Behaviours::load_with_gameplay( - registry_owner.registry, - &root, - &behaviour_json, - &gameplay_projection, - )?, - mob_types: MobTypes::load(&root)? - .types - .into_iter() - .map(|(k, v)| (k, Arc::new(v))) - .collect(), - mob_data, - threads, - player_type: perspective::player_type(&root), - player_arm: horizon_client::mobs::load_model(&root, "minecraft:player#main") - .and_then(|m| m.children.into_iter().find(|c| c.name == "right_arm")), + core: WorldCore { + facts, + biomes, + environment, + collision, + motion, + threads, + }, + rest: std::sync::OnceLock::from(WorldRest { + stations, + items, + recipes, + transformers, + providers: Providers::load(&root), + block_entity_render: horizon_client::block_entity_render::BlockEntityRenderer::load( + &root, + registry_owner.registry, + )?, + animate, + fog, + music: horizon_client::music::MusicTables::load(&root), + ambient: horizon_client::ambience::AmbientTables::load(&root), + nether_environment: Environment::load_dimension(&root, "the_nether", false)?, + end_environment: Environment::load_dimension(&root, "the_end", false)?, + behaviours: Behaviours::load_with_gameplay( + registry_owner.registry, + &root, + &behaviour_json, + &gameplay_projection, + )?, + mob_types: MobTypes::load(&root)? + .types + .into_iter() + .map(|(k, v)| (k, Arc::new(v))) + .collect(), + mob_data, + player_type: perspective::player_type(&root), + player_arm: horizon_client::mobs::load_model(&root, "minecraft:player#main") + .and_then(|m| m.children.into_iter().find(|c| c.name == "right_arm")), + }), }; // Both inputs are needed only while constructing the behaviour tables. // Release their owned JSON/Arc buffers before entering the long-lived game loop. diff --git a/crates/horizon-client/src/game/advancements.rs b/crates/horizon-client/src/game/advancements.rs index 992969907..da2db2592 100644 --- a/crates/horizon-client/src/game/advancements.rs +++ b/crates/horizon-client/src/game/advancements.rs @@ -106,7 +106,7 @@ impl adv::World for View<'_, '_> { .map(|c| { self.0 .res - .biomes + .biomes() .get(c.biome(p[0], p[1], p[2])) .name .clone() @@ -118,7 +118,7 @@ impl adv::World for View<'_, '_> { } fn block(&self, p: [i32; 3]) -> (String, BTreeMap) { let state = self.0.world.block(p[0], p[1], p[2]); - let name = self.0.res.facts.get(state).name.to_string(); + let name = self.0.res.facts().get(state).name.to_string(); let props = self .0 .pack @@ -138,7 +138,7 @@ impl adv::World for View<'_, '_> { match self .0 .res - .facts + .facts() .get(self.0.world.block(p[0], p[1], p[2])) .fluid { @@ -152,7 +152,7 @@ impl adv::World for View<'_, '_> { !self .0 .res - .facts + .facts() .get(self.0.world.block(p[0], y, p[2])) .full_collision }) @@ -165,19 +165,19 @@ impl adv::World for View<'_, '_> { (1..=5).any(|d| { self.0 .res - .facts + .facts() .get(self.0.world.block(p[0], p[1] - d, p[2])) .name .ends_with("campfire") }) } fn in_tag(&self, registry: &str, tag: &str, id: &str) -> bool { - let items = &self.0.res.items; + let items = &self.0.res.items(); match registry { "item" => items.item_tags.get(tag).is_some_and(|t| t.contains(id)), "block" => items.block_tags.get(tag).is_some_and(|t| t.contains(id)), - "entity_type" => self.0.res.mob_data.entity_has(tag, id), - "worldgen/biome" => self.0.res.mob_data.biome_has(tag, id), + "entity_type" => self.0.res.mob_data().entity_has(tag, id), + "worldgen/biome" => self.0.res.mob_data().biome_has(tag, id), _ => false, } } @@ -454,17 +454,17 @@ impl Game<'_> { .rewards .recipes .iter() - .filter(|r| self.res.stations.recipe_index.contains(r)) + .filter(|r| self.res.stations().recipe_index.contains(r)) .cloned() .collect(); let (_, unlocked) = self .level .recipe_book - .add_recipes(&self.res.stations.recipe_index, &rewards); + .add_recipes(&self.res.stations().recipe_index, &rewards); for table in &a.rewards.loot { let items = self .res - .items + .items() .loot_table(table, false, None, &mut self.world.random); for s in items { if let Some(rest) = self.give(s) @@ -549,7 +549,7 @@ impl Game<'_> { .filter_map(|s| s.as_ref()) .filter(|s| { self.res - .items + .items() .get(&s.item) .is_some_and(|i| s.count >= i.max_stack) }) diff --git a/crates/horizon-client/src/game/agent.rs b/crates/horizon-client/src/game/agent.rs index 48b24bbb3..b163d923e 100644 --- a/crates/horizon-client/src/game/agent.rs +++ b/crates/horizon-client/src/game/agent.rs @@ -318,7 +318,7 @@ impl Game<'_> { let state = self.world.block(pos[0], pos[1], pos[2]); let mut v = json!({ "pos": pos, - "block": &*self.res.facts.get(state).name, + "block": &*self.res.facts().get(state).name, "state": self.state_string(state), "loaded": self.world.chunks.contains_key(&(pos[0] >> 4, pos[2] >> 4)), }); @@ -651,17 +651,25 @@ impl Game<'_> { /// Whether a block stops movement, for the path finder. fn blocks_motion(&self, pos: [i32; 3]) -> bool { - let f = self.res.facts.get(self.world.block(pos[0], pos[1], pos[2])); + let f = self + .res + .facts() + .get(self.world.block(pos[0], pos[1], pos[2])); f.full_collision || f.legacy_solid } fn walkable(&self, n: Node) -> bool { let below = self.world.block(n[0], n[1] - 1, n[2]); let lava = |p: [i32; 3]| { - &*self.res.facts.get(self.world.block(p[0], p[1], p[2])).name == "minecraft:lava" + &*self + .res + .facts() + .get(self.world.block(p[0], p[1], p[2])) + .name + == "minecraft:lava" }; self.world.chunks.contains_key(&(n[0] >> 4, n[2] >> 4)) && (self.blocks_motion([n[0], n[1] - 1, n[2]]) - || self.res.facts.get(below).fluid != horizon_client::blocks::Fluid::None) + || self.res.facts().get(below).fluid != horizon_client::blocks::Fluid::None) && !self.blocks_motion(n) && !self.blocks_motion([n[0], n[1] + 1, n[2]]) && !lava(n) @@ -722,7 +730,11 @@ impl Game<'_> { if !clear || !self.walkable(m) { continue; } - let water = self.res.facts.get(self.world.block(m[0], m[1], m[2])).fluid + let water = self + .res + .facts() + .get(self.world.block(m[0], m[1], m[2])) + .fluid != horizon_client::blocks::Fluid::None; let step = 10 + if dy != 0 { 5 } else { 0 } + if water { 30 } else { 0 }; let c = base + step; @@ -932,10 +944,10 @@ impl Game<'_> { for z in lo[2]..=hi[2] { for x in lo[0]..=hi[0] { let state = self.world.block(x, y, z); - if self.res.facts.is_air(state) { + if self.res.facts().is_air(state) { continue; } - let name = self.res.facts.get(state).name.to_string(); + let name = self.res.facts().get(state).name.to_string(); *census.entry(name).or_insert(0) += 1; list.push(json!([x, y, z, self.state_string(state)])); } @@ -958,7 +970,7 @@ impl Game<'_> { for z in c[2] - radius..=c[2] + radius { for x in c[0] - radius..=c[0] + radius { let state = self.world.block(x, y, z); - if *self.res.facts.get(state).name == *want { + if *self.res.facts().get(state).name == *want { let d = dist(eye, [x, y, z].map(|v| f64::from(v) + 0.5)); found.push((d, [x, y, z])); } @@ -1166,7 +1178,7 @@ impl Game<'_> { self.playing()?; let pos = a.block_pos(0)?; let before = self.world.block(pos[0], pos[1], pos[2]); - if self.res.facts.is_air(before) { + if self.res.facts().is_air(before) { return Err(format!("there is no block at {pos:?}").into()); } self.aim_block(pos, None)?; @@ -1195,24 +1207,24 @@ impl Game<'_> { .ok_or("nothing in hand to place; select an item")?; let held = held.item.clone(); let before = self.world.block(pos[0], pos[1], pos[2]); - if !self.res.facts.get(before).replaceable && !self.res.facts.is_air(before) { + if !self.res.facts().get(before).replaceable && !self.res.facts().is_air(before) { return Err(format!( "{pos:?} holds {}; break it first", - self.res.facts.get(before).name + self.res.facts().get(before).name ) .into()); } // A replaceable block there (grass, snow) is clicked itself, as // a player would; otherwise the face of a neighbour touching it. - let mut aimed = !self.res.facts.is_air(before) - && !self.res.facts.get(before).outline.is_empty() + let mut aimed = !self.res.facts().is_air(before) + && !self.res.facts().get(before).outline.is_empty() && self.aim_block(pos, None).is_ok(); for (_, d) in FACES.iter().filter(|_| !aimed) { let d = *d; let support = add(pos, d); let state = self.world.block(support[0], support[1], support[2]); - let f = self.res.facts.get(state); - if self.res.facts.is_air(state) + let f = self.res.facts().get(state); + if self.res.facts().is_air(state) || f.replaceable || f.fluid != horizon_client::blocks::Fluid::None && !f.waterlogged { @@ -1878,7 +1890,10 @@ impl Game<'_> { // Step up onto the next block, or out of water. let in_water = { let b = p.map(|v| v.floor() as i32); - self.res.facts.get(self.world.block(b[0], b[1], b[2])).fluid + self.res + .facts() + .get(self.world.block(b[0], b[1], b[2])) + .fluid != horizon_client::blocks::Fluid::None }; if aim[1] > p[1] + 0.5 && horizontal(p, aim) < 1.6 && on_ground { diff --git a/crates/horizon-client/src/game/allays.rs b/crates/horizon-client/src/game/allays.rs index a2a5842b5..52dfa7e1c 100644 --- a/crates/horizon-client/src/game/allays.rs +++ b/crates/horizon-client/src/game/allays.rs @@ -29,7 +29,11 @@ impl Game<'_> { continue; }; let carried = self.mobs[i].extra.ints[1]; - let max = self.res.items.get(&held).map_or(64, |i| i.max_stack as i32); + let max = self + .res + .items() + .get(&held) + .map_or(64, |i| i.max_stack as i32); // GoToWantedItem / wantsToPickUp: the same item within 32. let wanted = if griefing && carried < max && self.mobs[i].extra.ints[3] <= 0 { self.dropped diff --git a/crates/horizon-client/src/game/armor_stands.rs b/crates/horizon-client/src/game/armor_stands.rs index 0a00e433c..eacd4a43f 100644 --- a/crates/horizon-client/src/game/armor_stands.rs +++ b/crates/horizon-client/src/game/armor_stands.rs @@ -111,7 +111,12 @@ impl Game<'_> { let Some(item) = item else { continue; }; - let Some(asset) = self.res.items.get(item).and_then(|i| i.equip_asset.clone()) else { + let Some(asset) = self + .res + .items() + .get(item) + .and_then(|i| i.equip_asset.clone()) + else { continue; }; let kind = if layer == "leggings" { @@ -144,7 +149,7 @@ impl Game<'_> { // BlockPlaceContext: a replaceable clicked block is replaced. let clicked = self .res - .facts + .facts() .get(self.world.block(hit.pos[0], hit.pos[1], hit.pos[2])); let pos = if clicked.replaceable { hit.pos @@ -230,7 +235,7 @@ impl Game<'_> { fn equipment_slot(&self, stack: &ItemStack) -> usize { match self .res - .items + .items() .get(&stack.item) .and_then(|i| i.equip_slot.as_deref()) { @@ -379,7 +384,7 @@ impl Game<'_> { let mut dead = Vec::new(); for (i, a) in self.armor_stands.iter_mut().enumerate() { a.tick(&mut scene); - if !a.environment_tick(&self.world, &self.res.facts, self.pack.assets.registry) { + if !a.environment_tick(&self.world, self.res.facts(), self.pack.assets.registry) { dead.push(i); } } @@ -490,7 +495,7 @@ impl Game<'_> { }; let Some(asset) = self .res - .items + .items() .get(&stack.item) .and_then(|i| i.equip_asset.clone()) else { @@ -542,7 +547,7 @@ impl Game<'_> { /// `Equippable.swapWithEquipmentSlot`: right-clicking armor swaps it into /// its slot (the worn piece comes back to the hand). pub(super) fn equip_from_hand(&mut self, stack: &ItemStack) -> bool { - let Some(info) = self.res.items.get(&stack.item) else { + let Some(info) = self.res.items().get(&stack.item) else { return false; }; let index = match info.equip_slot.as_deref() { @@ -683,7 +688,7 @@ impl Game<'_> { if let Some(stack) = &a.equipment[5] && self .res - .items + .items() .get(&stack.item) .is_none_or(|i| i.equip_asset.is_none()) && let Some(head) = part_matrix(model, base, poses, "head", 0.0) diff --git a/crates/horizon-client/src/game/backdrop.rs b/crates/horizon-client/src/game/backdrop.rs index 149cddefa..7e1a4dbc1 100644 --- a/crates/horizon-client/src/game/backdrop.rs +++ b/crates/horizon-client/src/game/backdrop.rs @@ -139,7 +139,7 @@ impl Game<'_> { } } fn surface_y(&self, x: i32, z: i32) -> Option { - let air = self.res.facts.air; + let air = self.res.facts().air; (-60..320).rev().find(|&y| self.world.block(x, y, z) != air) } fn start_backdrop(&mut self) -> Result<()> { @@ -155,7 +155,7 @@ impl Game<'_> { VanillaTerrain::new( &self.options.resources.join("worldgen"), pack.assets.registry, - &res.biomes, + res.biomes(), seed, ) .map_err(|e| format!("title backdrop: {e}"))?, @@ -165,10 +165,10 @@ impl Game<'_> { inner: inner.clone(), save: save.clone(), registry: pack.assets.clone(), - biomes: res.biomes.clone(), + biomes: res.biomes().clone(), }), pack.context.clone(), - res.threads.min(6), + res.threads().min(6), ); streaming.radius = self.settings.render_distance.clamp(4, 10); streaming.biome_blend = self.settings.biome_blend; @@ -179,7 +179,7 @@ impl Game<'_> { streaming.paused = true; self.streaming = streaming; self.save = save; - let mut world = World::new(self.res.facts.air, seed); + let mut world = World::new(self.res.facts().air, seed); world.day_time = DAY_TIME; world.game_time = 6000; // Light snow: the weather renders as snow in frozen biomes. @@ -237,7 +237,7 @@ impl Game<'_> { } fn stop_backdrop(&mut self) { self.streaming.paused = true; - self.world = World::new(self.res.facts.air, 0); + self.world = World::new(self.res.facts().air, 0); if let Some(r) = self.renderer.as_mut() { r.clear_sections(); } diff --git a/crates/horizon-client/src/game/banners.rs b/crates/horizon-client/src/game/banners.rs index 6875fcb7f..05beda3f8 100644 --- a/crates/horizon-client/src/game/banners.rs +++ b/crates/horizon-client/src/game/banners.rs @@ -14,7 +14,7 @@ impl Game<'_> { else { return Vec::new(); }; - layer_textures(&self.res.stations.banners, &b.layers) + layer_textures(&self.res.stations().banners, &b.layers) } } diff --git a/crates/horizon-client/src/game/beacon.rs b/crates/horizon-client/src/game/beacon.rs index 322edea3b..4d519c5d6 100644 --- a/crates/horizon-client/src/game/beacon.rs +++ b/crates/horizon-client/src/game/beacon.rs @@ -102,7 +102,7 @@ impl Game<'_> { let (min, max) = (super::MIN_Y, super::MIN_Y + super::HEIGHT); (min..max) .rev() - .find(|&y| !self.res.facts.is_air(self.world.block(x, y, z))) + .find(|&y| !self.res.facts().is_air(self.world.block(x, y, z))) .map_or(min, |y| y + 1) } /// `BeaconBlockEntity.tick` for every beacon. @@ -136,7 +136,7 @@ impl Game<'_> { let mut i = 0; while i < 10 && check <= surface { let state = self.world.block(x, check, z); - let f = self.res.facts.get(state); + let f = self.res.facts().get(state); if let Some(color) = self.beam_color(&f.name) { if b.checking.len() <= 1 { b.checking.push((color, 1)); @@ -197,7 +197,7 @@ impl Game<'_> { fn beacon_base(&self, x: i32, y: i32, z: i32) -> i32 { let base = self .res - .items + .items() .block_tags .get("minecraft:beacon_base_blocks"); let mut levels = 0; @@ -208,7 +208,7 @@ impl Game<'_> { } let ok = (x - step..=x + step).all(|lx| { (z - step..=z + step).all(|lz| { - let name = &self.res.facts.get(self.world.block(lx, ly, lz)).name; + let name = &self.res.facts().get(self.world.block(lx, ly, lz)).name; base.is_some_and(|t| t.contains(&**name)) }) }); diff --git a/crates/horizon-client/src/game/beehives.rs b/crates/horizon-client/src/game/beehives.rs index 0520e4367..e8f258a4d 100644 --- a/crates/horizon-client/src/game/beehives.rs +++ b/crates/horizon-client/src/game/beehives.rs @@ -41,7 +41,7 @@ impl HiveHost for GameHive<'_, '_> { if !self .game .res - .mob_data + .mob_data() .entity_has("minecraft:beehive_inhabitors", &kind) { return None; @@ -72,10 +72,10 @@ impl Game<'_> { /// The hive's honey level and front, from its block state. pub(super) fn hive_state(&self, at: [i32; 3]) -> Option<(Option, [i32; 2])> { let state = self.world.block(at[0], at[1], at[2]); - let name = &self.res.facts.get(state).name; + let name = &self.res.facts().get(state).name; if !self .res - .items + .items() .block_tags .get("minecraft:beehives") .is_some_and(|t| t.contains(&**name)) @@ -118,7 +118,7 @@ impl Game<'_> { .iter() .any(|d| { let state = self.world.block(at[0] + d[0], at[1] + d[1], at[2] + d[2]); - &*self.res.facts.get(state).name == "minecraft:fire" + &*self.res.facts().get(state).name == "minecraft:fire" }); let mut host = GameHive { game: self }; if fire && !hive.bees.is_empty() { diff --git a/crates/horizon-client/src/game/block_entity_anims.rs b/crates/horizon-client/src/game/block_entity_anims.rs index d377aeb45..7de800e96 100644 --- a/crates/horizon-client/src/game/block_entity_anims.rs +++ b/crates/horizon-client/src/game/block_entity_anims.rs @@ -185,7 +185,7 @@ impl Game<'_> { }; let raiders = self .res - .stations + .stations() .enchantments .entity_tags .get("minecraft:raiders") @@ -193,7 +193,7 @@ impl Game<'_> { .unwrap_or_default(); let frames = self .res - .items + .items() .block_tags .get("minecraft:conduit_effect_block") .cloned() @@ -279,7 +279,7 @@ impl Game<'_> { } Ticker::Conduit => { let world = &self.world; - let facts = &self.res.facts; + let facts = self.res.facts(); let registry = self.pack.assets.registry; let is_water = |p: [i32; 3]| { facts.get(world.block(p[0], p[1], p[2])).fluid @@ -365,7 +365,7 @@ impl Game<'_> { /// pot's saved `sherds` (back, left, right, front). pub(super) fn block_anim(&self, pos: [i32; 3], partial: f32) -> BlockAnim { let state = self.world.block(pos[0], pos[1], pos[2]); - let sherds = if &*self.res.facts.get(state).name == "minecraft:decorated_pot" { + let sherds = if &*self.res.facts().get(state).name == "minecraft:decorated_pot" { let sherds = self.saved_tag(pos).and_then(|t| t.get("sherds")); ["back", "left", "right", "front"].map(|side| match sherds.and_then(|s| s.get(side)) { // An item id, or the item stack the processed templates hold. diff --git a/crates/horizon-client/src/game/block_items.rs b/crates/horizon-client/src/game/block_items.rs index b8012cce1..199c39a78 100644 --- a/crates/horizon-client/src/game/block_items.rs +++ b/crates/horizon-client/src/game/block_items.rs @@ -22,7 +22,7 @@ impl Game<'_> { let entity = self.world.block_entities.get(&key)?; let block = &self .res - .facts + .facts() .get(self.world.block(key.0, key.1, key.2)) .name; let mut tag = save::encode_block_entity(key, entity, block); @@ -37,7 +37,7 @@ impl Game<'_> { pub(super) fn picked_stack(&self, pos: [i32; 3], include_data: bool) -> Option { let key = (pos[0], pos[1], pos[2]); let state = self.world.block(pos[0], pos[1], pos[2]); - let facts = self.res.facts.get(state); + let facts = self.res.facts().get(state); if &*facts.item == "minecraft:air" { return None; } diff --git a/crates/horizon-client/src/game/blockctl.rs b/crates/horizon-client/src/game/blockctl.rs index 993e0789e..719ce8dd2 100644 --- a/crates/horizon-client/src/game/blockctl.rs +++ b/crates/horizon-client/src/game/blockctl.rs @@ -47,7 +47,7 @@ impl Game<'_> { format!("{}[{}]", s.name, props.join(",")) } fn put_block(&mut self, pos: [i32; 3], state: BlockStateId) -> Result<()> { - let name = self.res.facts.get(state).name.clone(); + let name = self.res.facts().get(state).name.clone(); self.world.block_entities.remove(&(pos[0], pos[1], pos[2])); self.level_set(pos, state)?; if let Some(entity) = BlockEntity::for_block(&name) { diff --git a/crates/horizon-client/src/game/boats.rs b/crates/horizon-client/src/game/boats.rs index bb351d4bf..d9eafd4e0 100644 --- a/crates/horizon-client/src/game/boats.rs +++ b/crates/horizon-client/src/game/boats.rs @@ -180,11 +180,11 @@ impl BoatModels { } impl Game<'_> { fn fluid_height(&self, x: i32, y: i32, z: i32) -> Option<(f32, bool)> { - let f = self.res.facts.get(self.world.block(x, y, z)); + let f = self.res.facts().get(self.world.block(x, y, z)); if f.fluid != Fluid::Water { return None; } - let above = self.res.facts.get(self.world.block(x, y + 1, z)); + let above = self.res.facts().get(self.world.block(x, y + 1, z)); // FluidState.getHeight: 1 under the same fluid, else amount / 9. let height = if above.fluid == Fluid::Water { 1.0 @@ -277,7 +277,7 @@ impl Game<'_> { && f64::from(x + 1) > lo.x && f64::from(z) < hi.z && f64::from(z + 1) > lo.z; - let f = self.res.facts.get(self.world.block(x, y0, z)); + let f = self.res.facts().get(self.world.block(x, y0, z)); if inside && (f.full_collision || f.legacy_solid) && !f.has_class("LilyPadBlock") { friction += f.friction; count += 1; @@ -495,8 +495,8 @@ impl Game<'_> { ); let top = b.bounds().max_position().y; let (bx, by, bz) = (x.floor() as i32, top.floor() as i32, z.floor() as i32); - let below = self.res.facts.get(self.world.block(bx, by - 1, bz)); - let here = self.res.facts.get(self.world.block(bx, by, bz)); + let below = self.res.facts().get(self.world.block(bx, by - 1, bz)); + let here = self.res.facts().get(self.world.block(bx, by, bz)); let target = if below.fluid != Fluid::Water && !here.full_collision && (below.full_collision || below.legacy_solid) diff --git a/crates/horizon-client/src/game/books.rs b/crates/horizon-client/src/game/books.rs index b07a521ec..8745c6f35 100644 --- a/crates/horizon-client/src/game/books.rs +++ b/crates/horizon-client/src/game/books.rs @@ -397,7 +397,7 @@ impl Game<'_> { let key = (pos[0], pos[1], pos[2]); if &*self .res - .facts + .facts() .get(self.world.block(pos[0], pos[1], pos[2])) .name != "minecraft:lectern" diff --git a/crates/horizon-client/src/game/breezes.rs b/crates/horizon-client/src/game/breezes.rs index 52e3b36a9..466469110 100644 --- a/crates/horizon-client/src/game/breezes.rs +++ b/crates/horizon-client/src/game/breezes.rs @@ -40,7 +40,7 @@ impl Game<'_> { m.position.z.floor() as i32, ); let mut state = self.world.block(x, y, z); - if self.res.facts.is_air(state) { + if self.res.facts().is_air(state) { state = self.world.block(x, (m.position.y - 0.2).floor() as i32, z); } let Some((sprite, tint)) = self.particle_sprite(state) else { diff --git a/crates/horizon-client/src/game/chat.rs b/crates/horizon-client/src/game/chat.rs index bd80c06b5..817c1c3a3 100644 --- a/crates/horizon-client/src/game/chat.rs +++ b/crates/horizon-client/src/game/chat.rs @@ -207,12 +207,18 @@ impl Game<'_> { .map(|a| format!("minecraft:{a}")) .collect(); let reg = &mut self.ui.registries; - let mut items: Vec = self.res.items.order.iter().map(|s| s.to_string()).collect(); + let mut items: Vec = self + .res + .items() + .order + .iter() + .map(|s| s.to_string()) + .collect(); items.sort(); reg.items = items; reg.item_tags = self .res - .items + .items() .item_tags .keys() .map(|k| horizon_client::command::args::normalize(k)) @@ -220,7 +226,7 @@ impl Game<'_> { reg.item_tags.sort(); reg.block_tags = self .res - .items + .items() .block_tags .keys() .map(|k| horizon_client::command::args::normalize(k)) @@ -247,7 +253,7 @@ impl Game<'_> { .collect(); let mut summonable: Vec = self .res - .mob_types + .mob_types() .keys() .map(|k| horizon_client::command::args::normalize(k)) .collect(); diff --git a/crates/horizon-client/src/game/combat.rs b/crates/horizon-client/src/game/combat.rs index abe67c6c6..da3851d9a 100644 --- a/crates/horizon-client/src/game/combat.rs +++ b/crates/horizon-client/src/game/combat.rs @@ -114,7 +114,7 @@ impl Game<'_> { let location = if let Some(c) = p.last_climbable { let name = self .res - .facts + .facts() .get(self.world.block(c.x, c.y, c.z)) .name .clone(); @@ -127,7 +127,7 @@ impl Game<'_> { _ => "other_climbable", }) } else { - let f = self.res.facts.get(self.world.block( + let f = self.res.facts().get(self.world.block( p.position.x.floor() as i32, (p.position.y + 0.1).floor() as i32, p.position.z.floor() as i32, diff --git a/crates/horizon-client/src/game/commands.rs b/crates/horizon-client/src/game/commands.rs index deee0e967..c1b43a76f 100644 --- a/crates/horizon-client/src/game/commands.rs +++ b/crates/horizon-client/src/game/commands.rs @@ -874,7 +874,7 @@ impl Game<'_> { }; let count = Self::int(ctx, "count").unwrap_or(1); let targets = self.entities(ctx, "targets", true)?; - let max_stack = self.res.items.get(&id).map_or(64, |i| i.max_stack) as i32; + let max_stack = self.res.items().get(&id).map_or(64, |i| i.max_stack) as i32; if count > max_stack * 100 { return Err(CommandError::new(Text::translate( "commands.give.failed.toomanyitems", @@ -1385,7 +1385,7 @@ impl Game<'_> { if self.ui.difficulty == 0 && self .res - .mob_types + .mob_types() .get(&format!("minecraft:{short}")) .is_some_and(|t| t.category == "monster") { @@ -1402,7 +1402,7 @@ impl Game<'_> { let name; if let Some(t) = self .res - .mob_types + .mob_types() .get(&format!("minecraft:{short}")) .cloned() { @@ -1470,10 +1470,10 @@ impl Game<'_> { let name_ok = if b.tag { let tag = b.id.trim_start_matches("minecraft:"); self.res - .items + .items() .block_tags .get(tag) - .or_else(|| self.res.items.block_tags.get(&b.id)) + .or_else(|| self.res.items().block_tags.get(&b.id)) .is_some_and(|set| { set.contains(&s.name) || set.contains(s.name.trim_start_matches("minecraft:")) }) @@ -1498,8 +1498,8 @@ impl Game<'_> { } // A different block replaces the block entity (Level.setBlock). let (old, new) = ( - self.res.facts.get(previous).name.clone(), - self.res.facts.get(state).name.clone(), + self.res.facts().get(previous).name.clone(), + self.res.facts().get(state).name.clone(), ); // The command clears the old block entity without its side effects // (UPDATE_SKIP_BLOCK_ENTITY_SIDEEFFECTS); the new block gets a fresh one. @@ -2090,10 +2090,10 @@ impl Game<'_> { let tag = predicate.id.trim_start_matches("minecraft:"); return self .res - .items + .items() .item_tags .get(tag) - .or_else(|| self.res.items.item_tags.get(&predicate.id)) + .or_else(|| self.res.items().item_tags.get(&predicate.id)) .is_some_and(|s| { s.contains(item) || s.contains(item.trim_start_matches("minecraft:")) }); diff --git a/crates/horizon-client/src/game/commands/compute.rs b/crates/horizon-client/src/game/commands/compute.rs index 24552011d..c7b2355e3 100644 --- a/crates/horizon-client/src/game/commands/compute.rs +++ b/crates/horizon-client/src/game/commands/compute.rs @@ -502,7 +502,7 @@ impl Game<'_> { Some(Value::String(b)) => match b.strip_prefix('#') { Some(tag) => self .res - .items + .items() .block_tags .get(tag.trim_start_matches("minecraft:")) .is_some_and(|set| { diff --git a/crates/horizon-client/src/game/commands/data.rs b/crates/horizon-client/src/game/commands/data.rs index 1d2321a1a..5cf52cd1e 100644 --- a/crates/horizon-client/src/game/commands/data.rs +++ b/crates/horizon-client/src/game/commands/data.rs @@ -142,7 +142,7 @@ impl Game<'_> { set_key(&mut tag, "id", Tag::String(k.as_str().into())); } let new = - entity_nbt::mob_from_nbt(&tag, &self.res.mob_types, id).ok_or_else(stale)?; + entity_nbt::mob_from_nbt(&tag, self.res.mob_types(), id).ok_or_else(stale)?; if let Some(slot) = self.mobs.iter_mut().find(|m| m.id == id) { // Runtime-only state (AI, animation) carries over. let old = std::mem::replace(slot, new); diff --git a/crates/horizon-client/src/game/commands/effects.rs b/crates/horizon-client/src/game/commands/effects.rs index 3e04f7179..e78ff0f09 100644 --- a/crates/horizon-client/src/game/commands/effects.rs +++ b/crates/horizon-client/src/game/commands/effects.rs @@ -185,7 +185,7 @@ impl Game<'_> { return Ok(0); }; let level = Self::int(ctx, "level").unwrap_or(1); - let enchantments = &self.res.stations.enchantments; + let enchantments = &self.res.stations().enchantments; let Some(def) = enchantments.get(&id) else { return Err(err( "argument.resource.not_found", @@ -211,8 +211,8 @@ impl Game<'_> { } continue; }; - let e = &self.res.stations.enchantments; - let compatible = e.can_enchant(&self.res.items, &id, &stack.item) + let e = &self.res.stations().enchantments; + let compatible = e.can_enchant(self.res.items(), &id, &stack.item) && stack .crafting_enchantments() .iter() @@ -263,7 +263,7 @@ impl Game<'_> { } let (name, curse) = self .res - .stations + .stations() .enchantments .full_name(&id, level.max(0) as u32); let style = Style { diff --git a/crates/horizon-client/src/game/commands/execute.rs b/crates/horizon-client/src/game/commands/execute.rs index 1fa67c8b6..9ea910bd3 100644 --- a/crates/horizon-client/src/game/commands/execute.rs +++ b/crates/horizon-client/src/game/commands/execute.rs @@ -649,7 +649,7 @@ impl Game<'_> { if state == self.world.air { continue; } - let facts = self.res.facts.get(state); + let facts = self.res.facts().get(state); let blocks = facts.legacy_solid || facts.fluid != horizon_client::blocks::Fluid::None; let leaves = self .pack @@ -941,7 +941,7 @@ impl Game<'_> { let chunk = self.world.chunks.get(&(p[0] >> 4, p[2] >> 4))?; Some( self.res - .biomes + .biomes() .get(chunk.biome(p[0], p[1], p[2])) .name .clone(), @@ -964,7 +964,7 @@ impl Game<'_> { .resources .join(format!("data/{ns}/tags/worldgen/biome/{path}.json")); let Ok(bytes) = std::fs::read(file) else { - return self.res.mob_data.biome_has(tag, biome); + return self.res.mob_data().biome_has(tag, biome); }; let v: serde_json::Value = serde_json::from_slice(&bytes).unwrap_or_default(); v["values"].as_array().is_some_and(|a| { diff --git a/crates/horizon-client/src/game/commands/extra.rs b/crates/horizon-client/src/game/commands/extra.rs index a90648043..7a4accb0d 100644 --- a/crates/horizon-client/src/game/commands/extra.rs +++ b/crates/horizon-client/src/game/commands/extra.rs @@ -586,7 +586,7 @@ impl Game<'_> { ); let hit = traverse_blocks(eye, end, 256, |b: BlockPos| { let state = self.world.block(b.x, b.y, b.z); - (!self.res.facts.is_air(state)).then_some([b.x, b.y, b.z]) + (!self.res.facts().is_air(state)).then_some([b.x, b.y, b.z]) }); hit.ok().flatten().unwrap_or([ end.x.floor() as i32, diff --git a/crates/horizon-client/src/game/commands/items.rs b/crates/horizon-client/src/game/commands/items.rs index c71eebc68..fde97764d 100644 --- a/crates/horizon-client/src/game/commands/items.rs +++ b/crates/horizon-client/src/game/commands/items.rs @@ -375,7 +375,11 @@ impl Game<'_> { } else { 0 }; - let max = self.res.items.get(&stack.item).map_or(64, |i| i.max_stack); + let max = self + .res + .items() + .get(&stack.item) + .map_or(64, |i| i.max_stack); stack.count = (base + n).clamp(0, max as i32) as u32; } "minecraft:limit_count" => { @@ -389,7 +393,11 @@ impl Game<'_> { } } "minecraft:set_damage" => { - let max = self.res.items.get(&stack.item).map_or(0, |i| i.max_damage); + let max = self + .res + .items() + .get(&stack.item) + .map_or(0, |i| i.max_damage); if max > 0 { let f = match m["damage"].as_f64() { Some(f) => f as f32, @@ -587,7 +595,7 @@ impl Game<'_> { if let Some(Tag::Int(n)) = s.data().and_then(|d| d.other("minecraft:max_stack_size")) { return (*n).clamp(1, 99) as u32; } - self.res.items.get(&s.item).map_or(64, |i| i.max_stack) + self.res.items().get(&s.item).map_or(64, |i| i.max_stack) } /// `ResourceOrIdArgument.getItemModifier`: an inline modifier (SNBT) or /// a registered one. diff --git a/crates/horizon-client/src/game/commands/terrain_cmds.rs b/crates/horizon-client/src/game/commands/terrain_cmds.rs index cee7a1d72..46df0ce7d 100644 --- a/crates/horizon-client/src/game/commands/terrain_cmds.rs +++ b/crates/horizon-client/src/game/commands/terrain_cmds.rs @@ -174,7 +174,7 @@ impl Game<'_> { if volume > i64::from(limit) { return Err(err("commands.fillbiome.toobig", &[&limit, &volume])); } - let Some(target) = self.res.biomes.list.iter().position(|b| b.name == biome) else { + let Some(target) = self.res.biomes().list.iter().position(|b| b.name == biome) else { return Err(err( "argument.resource.not_found", &[&biome, &"minecraft:worldgen/biome"], @@ -201,7 +201,7 @@ impl Game<'_> { continue; }; let current = chunk.biome(x, y, z); - let current_name = &self.res.biomes.list[usize::from(current)].name; + let current_name = &self.res.biomes().list[usize::from(current)].name; if let Some(f) = &filter && !self.biome_matches(f, current_name) { @@ -474,11 +474,11 @@ impl Game<'_> { let json = horizon_client::scoreboard::tag_to_json(&tag); let drops = self .res - .items + .items() .inline_loot_table(&json, &mut self.world.random); (drops, None) } else { - if !self.res.items.has_loot_table(&table) { + if !self.res.items().has_loot_table(&table) { return Err(err("argument.resource_or_id.failed_to_parse", &[&table])); } let held = if id == "loot.fish" { @@ -486,14 +486,14 @@ impl Game<'_> { } else { None }; - let drops = match self.res.items.loot_sequence(&table) { + let drops = match self.res.items().loot_sequence(&table) { Some(seq) => { let random = self.rand_sequences.get(&seq, self.level.seed); self.res - .items + .items() .loot_table(&table, false, held.as_ref(), random) } - None => self.res.items.loot_table( + None => self.res.items().loot_table( &table, false, held.as_ref(), @@ -510,7 +510,7 @@ impl Game<'_> { }; let ty = self.target_type(t); let table = format!("minecraft:entities/{}", ty.trim_start_matches("minecraft:")); - if t == Target::Player || !self.res.items.has_loot_table(&table) { + if t == Target::Player || !self.res.items().has_loot_table(&table) { return Err(err( "commands.drop.no_loot_table.entity", &[&self.target_name(t).plain()], @@ -521,14 +521,14 @@ impl Game<'_> { None | Some(Some(Target::Player)) ); let held = self.slot_get(&super::items::Slot::Inv(self.selected)); - let drops = match self.res.items.loot_sequence(&table) { + let drops = match self.res.items().loot_sequence(&table) { Some(seq) => { let random = self.rand_sequences.get(&seq, self.level.seed); self.res - .items + .items() .entity_drops(&ty, by_player, held.as_ref(), random) } - None => self.res.items.entity_drops( + None => self.res.items().entity_drops( &ty, by_player, held.as_ref(), @@ -543,21 +543,21 @@ impl Game<'_> { let state = self.world.block(p[0], p[1], p[2]); let name = self.data_block_name(p); let table = format!("minecraft:blocks/{}", name.trim_start_matches("minecraft:")); - if !self.res.items.has_loot_table(&table) { + if !self.res.items().has_loot_table(&table) { return Err(err("commands.drop.no_loot_table.block", &[&name])); } let tool = self.tool_stack(ctx)?; - let drops = match self.res.items.loot_sequence(&table) { + let drops = match self.res.items().loot_sequence(&table) { Some(seq) => { let random = self.rand_sequences.get(&seq, self.level.seed); - self.res.items.block_drops( + self.res.items().block_drops( self.pack.assets.registry, state, tool.as_ref(), random, ) } - None => self.res.items.block_drops( + None => self.res.items().block_drops( self.pack.assets.registry, state, tool.as_ref(), @@ -624,7 +624,7 @@ impl Game<'_> { && cur.damage == left.damage && cur.extra == left.extra => { - let max = self.res.items.get(&cur.item).map_or(64, |i| i.max_stack); + let max = self.res.items().get(&cur.item).map_or(64, |i| i.max_stack); let take = left.count.min(max.saturating_sub(cur.count)); if take > 0 { cur.count += take; diff --git a/crates/horizon-client/src/game/commands/world_cmds.rs b/crates/horizon-client/src/game/commands/world_cmds.rs index 578153247..85945b68a 100644 --- a/crates/horizon-client/src/game/commands/world_cmds.rs +++ b/crates/horizon-client/src/game/commands/world_cmds.rs @@ -32,7 +32,7 @@ impl Game<'_> { /// Every recipe id of the recipe manager (what `/recipe` resolves and suggests). pub(super) fn learnable_recipes(&self) -> Vec { - self.res.stations.recipe_index.ids().cloned().collect() + self.res.stations().recipe_index.ids().cloned().collect() } pub(super) fn cmd_recipe(&mut self, id: &str, ctx: &Context) -> R { let targets = self.entities(ctx, "targets", true)?; @@ -53,7 +53,7 @@ impl Game<'_> { // displays (a transmute recipe has one per material count). let mut n = 0; // ServerPlayer.awardRecipes / resetRecipes: the displays changed. - let index = &self.res.stations.recipe_index; + let index = &self.res.stations().recipe_index; n += if give { let (count, unlocked) = self.level.recipe_book.add_recipes(index, &recipes); self.recipe_unlocked(&unlocked); @@ -1268,7 +1268,7 @@ impl Game<'_> { fn spread_spawn_y(&self, p: [f64; 2], max_y: i32) -> i32 { let (x, z) = (p[0].floor() as i32, p[1].floor() as i32); let air = |y: i32| { - let name: &str = &self.res.facts.get(self.world.block(x, y, z)).name; + let name: &str = &self.res.facts().get(self.world.block(x, y, z)).name; matches!( name, "minecraft:air" | "minecraft:cave_air" | "minecraft:void_air" @@ -1293,16 +1293,16 @@ impl Game<'_> { fn spread_safe(&self, p: [f64; 2], max_y: i32) -> bool { let y = self.spread_spawn_y(p, max_y) - 1; let (x, z) = (p[0].floor() as i32, p[1].floor() as i32); - let name = self.res.facts.get(self.world.block(x, y, z)).name.clone(); + let name = self.res.facts().get(self.world.block(x, y, z)).name.clone(); let liquid = matches!(&*name, "minecraft:water" | "minecraft:lava"); let teleportable = self .res - .items + .items() .block_tags .get("entities_can_teleport_to") .or_else(|| { self.res - .items + .items() .block_tags .get("minecraft:entities_can_teleport_to") }) diff --git a/crates/horizon-client/src/game/composter.rs b/crates/horizon-client/src/game/composter.rs index 3e4cb7169..3f57229ad 100644 --- a/crates/horizon-client/src/game/composter.rs +++ b/crates/horizon-client/src/game/composter.rs @@ -21,7 +21,7 @@ impl Game<'_> { } /// The item's `compostable` layers provider. fn compostable(&self, stack: &ItemStack) -> Option { - self.res.items.get(&stack.item)?.compostable.clone() + self.res.items().get(&stack.item)?.compostable.clone() } /// `ComposterBlock.addLayer` and level event 1500: the provider is /// evaluated in the composter's block-interaction loot context (its diff --git a/crates/horizon-client/src/game/control.rs b/crates/horizon-client/src/game/control.rs index 56d738542..fad6343e6 100644 --- a/crates/horizon-client/src/game/control.rs +++ b/crates/horizon-client/src/game/control.rs @@ -335,7 +335,7 @@ impl Game<'_> { }; let info = self .res - .items + .items() .get(&item) .ok_or_else(|| format!("unknown item {item}"))?; let count: u32 = words.get(2).map_or(Ok(1), |c| c.parse())?; @@ -663,7 +663,7 @@ impl Game<'_> { }); let target = self.pick().map(|hit| { let state = self.world.block(hit.pos[0], hit.pos[1], hit.pos[2]); - json!({ "pos": hit.pos, "block": &*self.res.facts.get(state).name }) + json!({ "pos": hit.pos, "block": &*self.res.facts().get(state).name }) }); let renderer = self.renderer.as_ref().map(|r| { let [arena_bytes, section_vertex_bytes] = r.section_vertex_bytes(); diff --git a/crates/horizon-client/src/game/copper_golems.rs b/crates/horizon-client/src/game/copper_golems.rs index a12fbd416..2f98e1c7e 100644 --- a/crates/horizon-client/src/game/copper_golems.rs +++ b/crates/horizon-client/src/game/copper_golems.rs @@ -106,7 +106,7 @@ impl Game<'_> { fn golem_chest_sound(&mut self, p: [i32; 3], open: bool) { let name = self .res - .facts + .facts() .get(self.world.block(p[0], p[1], p[2])) .name .clone(); @@ -292,7 +292,7 @@ impl Game<'_> { pub(super) fn golem_shearable(&self, index: usize) -> bool { self.mobs[index].saddle_item().is_some_and(|a| { self.res - .items + .items() .item_tags .get("minecraft:shearable_from_copper_golem") .is_some_and(|t| t.contains(&*a.item)) diff --git a/crates/horizon-client/src/game/creaking.rs b/crates/horizon-client/src/game/creaking.rs index b079545e6..8e774b7e5 100644 --- a/crates/horizon-client/src/game/creaking.rs +++ b/crates/horizon-client/src/game/creaking.rs @@ -110,7 +110,7 @@ impl Game<'_> { let mut next_entity = self.next_entity; let mut random = self.world.random.clone(); let spawning = self.spawning_monsters(); - let creaking = self.res.mob_types.get("minecraft:creaking").cloned(); + let creaking = self.res.mob_types().get("minecraft:creaking").cloned(); let player_uuid = self.level.player_uuid; let snapshot: Vec<_> = mobs.iter().map(|m| seen(m, player_uuid)).collect(); let mut events = Vec::new(); @@ -266,7 +266,7 @@ impl Game<'_> { continue; }; let state = self.world.block(key.0, key.1, key.2); - if &*self.res.facts.get(state).name != "minecraft:creaking_heart" { + if &*self.res.facts().get(state).name != "minecraft:creaking_heart" { // The block is gone: preRemoveSideEffects. self.with_heart(key, &mut heart, |h, _, _, host, out| { creaking_heart::remove_protector(h, host, false, out); @@ -319,7 +319,7 @@ impl Game<'_> { if self.creaking.hearts.is_empty() { self.creaking.hearts = self .res - .facts + .facts() .states .iter() .map(|f| &*f.name == "minecraft:creaking_heart") diff --git a/crates/horizon-client/src/game/creatures.rs b/crates/horizon-client/src/game/creatures.rs index bcb86343a..1edd2b07e 100644 --- a/crates/horizon-client/src/game/creatures.rs +++ b/crates/horizon-client/src/game/creatures.rs @@ -203,8 +203,8 @@ impl Game<'_> { let Some(chunk) = self.world.chunks.get(&(x >> 4, z >> 4)) else { return BiomeFacts::default(); }; - let b = self.res.biomes.get(chunk.biome(x, y, z)); - let tags = &self.res.mob_data; + let b = self.res.biomes().get(chunk.biome(x, y, z)); + let tags = self.res.mob_data(); let has = |t: &str| tags.biome_has(t, &b.name); let climate = if has("minecraft:spawns_warm_variant_farm_animals") { Climate::Warm @@ -254,7 +254,7 @@ impl Game<'_> { } else { format!("minecraft:{kind}") }; - let t = self.res.mob_types.get(&kind).cloned()?; + let t = self.res.mob_types().get(&kind).cloned()?; self.next_entity += 1; let yaw = self.world.random.next_float() * 360.0; let mut mob = Mob::new(self.next_entity, t, Vec3::new(at[0], at[1], at[2]), yaw); @@ -367,7 +367,7 @@ impl Game<'_> { pub(super) fn motion_top(&self, x: i32, z: i32) -> i32 { let top = if self.dim == Dim::Nether { 127 } else { 319 }; for y in (horizon_client::chunk::MIN_Y..=top).rev() { - let f = self.res.facts.get(self.world.block(x, y, z)); + let f = self.res.facts().get(self.world.block(x, y, z)); if (f.full_collision || f.fluid != Fluid::None) && !f.name.ends_with("leaves") { return y + 1; } @@ -379,10 +379,10 @@ impl Game<'_> { MobWorld { world: &self.world, registry: self.pack.assets.registry, - facts: &self.res.facts, + facts: self.res.facts(), movement: &self.motion.blocks, collision: self.collision, - data: &self.res.mob_data, + data: self.res.mob_data(), player: self.player_view(), others, others_grid: None, @@ -392,14 +392,14 @@ impl Game<'_> { raining: rain > 0.2, thundering: thunder > 0.9, nether: self.dim == Dim::Nether, - block_tags: &self.res.items.block_tags, - biomes: &self.res.biomes, + block_tags: &self.res.items().block_tags, + biomes: self.res.biomes(), mob_griefing: self.ui.rules.bool("mob_griefing"), end: self.dim == Dim::End, world_seed: self.level.seed, sea_level: if self.dim == Dim::Nether { 32 } else { 63 }, teams: self.mob_teams(), - items: Some(&self.res.items), + items: Some(self.res.items()), difficulty: self.local_difficulty( self.player .as_ref() @@ -983,7 +983,7 @@ impl Game<'_> { if effect { let old = self.world.block(pos[0], pos[1], pos[2]); self.destroy_particles(pos, old); - let s = self.res.facts.get(old).sounds.break_sound.clone(); + let s = self.res.facts().get(old).sounds.break_sound.clone(); self.audio.play( &s, Some([ @@ -1003,7 +1003,7 @@ impl Game<'_> { let old = self.world.block(pos[0], pos[1], pos[2]); self.destroy_particles(pos, old); if drop { - let drops = self.res.items.block_drops_in( + let drops = self.res.items().block_drops_in( self.pack.assets.registry, old, None, @@ -1157,7 +1157,7 @@ impl Game<'_> { MobEvent::GiftLoot { table, at } => { let drops = self.res - .items + .items() .loot_table(table, false, None, &mut self.world.random); for d in drops { self.spawn_item(d, at, [0.0, 0.2, 0.0], 10); @@ -1393,7 +1393,7 @@ impl Game<'_> { } let projectile = self .res - .stations + .stations() .enchantments .damage_tags .get("minecraft:is_projectile") @@ -1753,7 +1753,7 @@ impl Game<'_> { horizon_client::arrows::ArrowScene { world: &self.world, registry: self.pack.assets.registry, - facts: &self.res.facts, + facts: self.res.facts(), collision: self.collision, fluids: &self.motion.fluids, raining: rain, @@ -2005,7 +2005,7 @@ impl Game<'_> { let fire = [pos[0] + face[0], pos[1] + face[1], pos[2] + face[2]]; if self .res - .facts + .facts() .is_air(self.world.block(fire[0], fire[1], fire[2])) && let Some(state) = self.pack.assets.registry.default_state("minecraft:fire") @@ -2331,7 +2331,7 @@ impl Game<'_> { Species::Sheep if item == "minecraft:shears" && !m.extra.sheared && !m.is_baby() => { m.extra.sheared = true; let color = horizon_client::mobs::render::DYE_NAMES[m.extra.color as usize & 15]; - let stacks = self.res.items.loot_table( + let stacks = self.res.items().loot_table( &format!("minecraft:shearing/sheep/{color}"), false, None, @@ -2363,7 +2363,7 @@ impl Game<'_> { Species::Wolf if m.extra.tame && is_food && m.health < m.attrs.max_health => { let heal = self .res - .items + .items() .get(&item) .and_then(|i| i.food.as_ref()) .map_or(2.0, |f| f.0 as f32); @@ -2467,7 +2467,7 @@ impl Game<'_> { Species::Cat if m.extra.tame && is_food && m.health < m.attrs.max_health => { let heal = self .res - .items + .items() .get(&item) .and_then(|i| i.food.as_ref()) .map_or(1.0, |f| f.0 as f32); @@ -2634,7 +2634,7 @@ impl Game<'_> { return; } if let Some(stack) = self.inventory[self.selected].as_mut() - && let Some(info) = self.res.items.get(&stack.item) + && let Some(info) = self.res.items().get(&stack.item) && info.max_damage > 0 { stack.damage += 1; @@ -2707,7 +2707,7 @@ impl Game<'_> { // EntityType.canSpawn: no monsters in peaceful (FAIL ends the click). let id = format!("minecraft:{}", kind.trim_start_matches("minecraft:")); if self.ui.difficulty == 0 - && let Some(t) = self.res.mob_types.get(&id) + && let Some(t) = self.res.mob_types().get(&id) && !horizon_client::mobs::spawn_rules::allowed_in_peaceful(t.species) { return Ok(true); @@ -2829,7 +2829,7 @@ impl Game<'_> { camera, &lookup, packed, - &self.res.mob_data, + self.res.mob_data(), &armor, out, ); @@ -3073,13 +3073,17 @@ impl Game<'_> { return; } let mut y = pos[1]; - while &*self.res.facts.get(self.world.block(pos[0], y, pos[2])).name + while &*self + .res + .facts() + .get(self.world.block(pos[0], y, pos[2])) + .name == "minecraft:nether_portal" { y -= 1; } // isValidSpawn: a sturdy top face (portal frames emit no light). - let below = self.res.facts.get(self.world.block(pos[0], y, pos[2])); + let below = self.res.facts().get(self.world.block(pos[0], y, pos[2])); if below.sturdy_full & (1 << 1) == 0 { return; } diff --git a/crates/horizon-client/src/game/decorated_pot.rs b/crates/horizon-client/src/game/decorated_pot.rs index 3ac43566a..af2eaacb2 100644 --- a/crates/horizon-client/src/game/decorated_pot.rs +++ b/crates/horizon-client/src/game/decorated_pot.rs @@ -63,7 +63,7 @@ impl Game<'_> { /// pot without), or None when no pot is there. fn pot_tag(&mut self, pos: [i32; 3]) -> Option { let state = self.world.block(pos[0], pos[1], pos[2]); - if &*self.res.facts.get(state).name != "minecraft:decorated_pot" { + if &*self.res.facts().get(state).name != "minecraft:decorated_pot" { return None; } let mut tag = spill::saved_entity(&self.world, pos).unwrap_or_else(|| { diff --git a/crates/horizon-client/src/game/dispense_fixture.rs b/crates/horizon-client/src/game/dispense_fixture.rs index ee8170bc5..4ff3c8097 100644 --- a/crates/horizon-client/src/game/dispense_fixture.rs +++ b/crates/horizon-client/src/game/dispense_fixture.rs @@ -114,9 +114,9 @@ impl Game<'_> { } fn fixture_reset(&mut self, seed: i64) { - self.world = World::new(self.res.facts.air, seed); + self.world = World::new(self.res.facts().air, seed); // The oracle level is plains everywhere (bone meal's flowers, freezing). - let plains = u32::from(self.res.biomes.id("minecraft:plains")); + let plains = u32::from(self.res.biomes().id("minecraft:plains")); for cx in -2..=2 { for cz in -2..=2 { let mut chunk = Chunk::empty(cx, cz); @@ -198,7 +198,7 @@ impl Game<'_> { let state = BlockStateId(cell[3].as_u64().unwrap_or(0) as u32); self.world.set(p.0, p.1, p.2, state)?; before.insert(p, state.0); - if let Some(entity) = BlockEntity::for_block(&self.res.facts.get(state).name) { + if let Some(entity) = BlockEntity::for_block(&self.res.facts().get(state).name) { self.world.block_entities.insert(p, entity); } } @@ -329,7 +329,7 @@ impl Game<'_> { changed.dedup(); for p in changed { let now = self.world.block(p.0, p.1, p.2).0; - if before.get(&p).copied().unwrap_or(self.res.facts.air.0) != now { + if before.get(&p).copied().unwrap_or(self.res.facts().air.0) != now { out.push(format!("set {},{},{} {now}", p.0, p.1, p.2)); } } @@ -696,7 +696,7 @@ impl Game<'_> { /// lectern's book, or the items of a block entity Horizon keeps as saved. fn fixture_fill(&mut self, p: (i32, i32, i32), slot: usize, stack: Option) { let jukebox = - &*self.res.facts.get(self.world.block(p.0, p.1, p.2)).name == "minecraft:jukebox"; + &*self.res.facts().get(self.world.block(p.0, p.1, p.2)).name == "minecraft:jukebox"; match self.world.block_entities.get_mut(&p) { Some(BlockEntity::Jukebox(j)) => j.record = stack, Some(BlockEntity::Lectern(l)) => l.book = stack, @@ -725,7 +725,7 @@ impl Game<'_> { use horizon_world::nbt::Tag; let name = self .res - .facts + .facts() .get(self.world.block(p.0, p.1, p.2)) .name .clone(); @@ -819,7 +819,7 @@ impl Game<'_> { } let t = self .res - .mob_types + .mob_types() .get(kind) .cloned() .ok_or_else(|| format!("no mob type {kind}"))?; diff --git a/crates/horizon-client/src/game/dispenser.rs b/crates/horizon-client/src/game/dispenser.rs index cb28aa1cc..0f59e5300 100644 --- a/crates/horizon-client/src/game/dispenser.rs +++ b/crates/horizon-client/src/game/dispenser.rs @@ -328,18 +328,18 @@ impl Game<'_> { self.world.block(p.0, p.1, p.2) } fn dispenser_block_name(&self, p: Pos) -> std::sync::Arc { - self.res.facts.get(self.block_at(p)).name.clone() + self.res.facts().get(self.block_at(p)).name.clone() } fn in_block_tag(&self, tag: &str, block: &str) -> bool { self.res - .items + .items() .block_tags .get(tag) .is_some_and(|s| s.contains(block)) } fn water_at(&self, p: Pos) -> bool { matches!( - self.res.behaviours.fluid_kind(self.block_at(p)), + self.res.behaviours().fluid_kind(self.block_at(p)), FluidKind::Water | FluidKind::FlowingWater ) } @@ -520,7 +520,7 @@ impl Game<'_> { if let Some(entity) = self.world.block_entities.get_mut(&pos) { let max = self .res - .items + .items() .get(&rest.item) .map_or(64, |i| i.max_stack) .max(1); @@ -555,7 +555,11 @@ impl Game<'_> { } /// `ItemStack.hurtAndBreak(amount)` without an entity. fn hurt_and_break(&mut self, mut stack: ItemStack, amount: u32) -> Option { - let max = self.res.items.get(&stack.item).map_or(0, |i| i.max_damage); + let max = self + .res + .items() + .get(&stack.item) + .map_or(0, |i| i.max_damage); if max == 0 { return Some(stack); } @@ -637,7 +641,7 @@ impl Game<'_> { ) -> Result { let equippable = self .res - .items + .items() .get(&stack.item) .is_some_and(|i| i.equip_slot.is_some()); if equippable { @@ -649,7 +653,7 @@ impl Game<'_> { } let swallowable = self .res - .items + .items() .item_tags .get("minecraft:sulfur_cube_swallowable") .is_some_and(|t| t.contains(&*stack.item)); @@ -748,7 +752,7 @@ impl Game<'_> { } else { format!("minecraft:{kind}") }; - let t = self.res.mob_types.get(&name)?.clone(); + let t = self.res.mob_types().get(&name)?.clone(); let y_off = if try_move_down { self.drop_offset(t.width, t.height, p) } else { @@ -768,7 +772,7 @@ impl Game<'_> { /// `EquipmentDispenseItemBehavior.dispenseEquipment`: the first living /// entity in front that `canEquipWithDispenser` gets one of the item. fn dispense_equipment(&mut self, pos: Pos, facing: Direction, stack: &mut ItemStack) -> bool { - let Some(info) = self.res.items.get(&stack.item) else { + let Some(info) = self.res.items().get(&stack.item) else { return false; }; let (Some(slot), true) = ( @@ -1078,7 +1082,7 @@ impl Game<'_> { let below = (front.0, front.1 - 1, front.2); let y_offset = if self.water_at(front) { 1.0 - } else if self.res.facts.is_air(self.block_at(front)) && self.water_at(below) { + } else if self.res.facts().is_air(self.block_at(front)) && self.water_at(below) { 0.0 } else { return (self.dispense_default(pos, facing, stack), CLICK); @@ -1116,7 +1120,7 @@ impl Game<'_> { let y_offset = if let Some(rail) = self.rail(front.0, front.1, front.2) { if rail.shape.is_slope() { 0.6 } else { 0.1 } } else { - if !self.res.facts.is_air(self.block_at(front)) { + if !self.res.facts().is_air(self.block_at(front)) { return (self.dispense_default(pos, facing, stack), CLICK); } let below = (front.0, front.1 - 1, front.2); @@ -1389,7 +1393,7 @@ impl Game<'_> { stack: ItemStack, ) -> Result { let target = offset(pos, facing); - let free = self.res.facts.is_air(self.block_at(target)) + let free = self.res.facts().is_air(self.block_at(target)) && target.1 >= horizon_client::chunk::MIN_Y + 2 && self.ui.difficulty != 0 && self.can_build_wither(target); @@ -1443,7 +1447,7 @@ impl Game<'_> { "minecraft:soul_sand" | "minecraft:soul_soil" ) }; - let air = |p: Pos| self.res.facts.is_air(self.block_at(p)); + let air = |p: Pos| self.res.facts().is_air(self.block_at(p)); for (ax, az) in [(1, 0), (0, 1)] { for col in 0..3 { let left = (head.0 - ax * col, head.1, head.2 - az * col); @@ -1466,7 +1470,7 @@ impl Game<'_> { stack: ItemStack, ) -> Result { let target = offset(pos, facing); - if self.res.facts.is_air(self.block_at(target)) + if self.res.facts().is_air(self.block_at(target)) && self.can_spawn_golem([target.0, target.1, target.2]) { if let Some(pumpkin) = self @@ -1511,7 +1515,7 @@ impl Game<'_> { let front = offset(pos, facing); let below_empty = self .res - .facts + .facts() .is_air(self.block_at((front.0, front.1 - 1, front.2))); let clicked_face = if below_empty { facing } else { Direction::Up }; let ctx = PlaceContext { @@ -1539,7 +1543,7 @@ impl Game<'_> { return Ok((Some(stack), FAIL)); }; let target = (placed.x, placed.y, placed.z); - if let Some(entity) = BlockEntity::for_block(&self.res.facts.get(state).name) { + if let Some(entity) = BlockEntity::for_block(&self.res.facts().get(state).name) { self.world.block_entities.insert(target, entity); self.apply_placed_item([target.0, target.1, target.2], &stack, false); } @@ -1689,14 +1693,14 @@ impl Game<'_> { table: &str, held: Option<&ItemStack>, ) -> Vec { - match self.res.items.loot_sequence(parent) { + match self.res.items().loot_sequence(parent) { Some(sequence) => { let random = self.rand_sequences.get(&sequence, self.level.seed); - self.res.items.loot_table_from(table, false, held, random) + self.res.items().loot_table_from(table, false, held, random) } None => self .res - .items + .items() .loot_table(table, false, held, &mut self.world.random), } } @@ -1717,7 +1721,7 @@ impl Game<'_> { /// random draws) keeps the name, flags, persistence and age; the old one /// is discarded. pub(super) fn convert_mob(&mut self, index: usize, kind: &str) -> Option { - let t = self.res.mob_types.get(kind).cloned()?; + let t = self.res.mob_types().get(kind).cloned()?; let old = &self.mobs[index]; self.next_entity += 1; let mut mob = Mob::new(self.next_entity, t, old.position, old.yaw); diff --git a/crates/horizon-client/src/game/dragon.rs b/crates/horizon-client/src/game/dragon.rs index e8e1fe57e..464e4c60a 100644 --- a/crates/horizon-client/src/game/dragon.rs +++ b/crates/horizon-client/src/game/dragon.rs @@ -445,9 +445,9 @@ impl Game<'_> { } fn end_portal_active(&self) -> bool { (0..256).any(|y| { - &*self.res.facts.get(self.world.block(0, y, 0)).name == "minecraft:bedrock" + &*self.res.facts().get(self.world.block(0, y, 0)).name == "minecraft:bedrock" && (-3..=3).any(|d| { - &*self.res.facts.get(self.world.block(d, y, 0)).name == "minecraft:end_portal" + &*self.res.facts().get(self.world.block(d, y, 0)).name == "minecraft:end_portal" }) }) } @@ -588,7 +588,7 @@ impl Game<'_> { let p = self.crystals[i].position; let b = [p.x.floor() as i32, p.y.floor() as i32, p.z.floor() as i32]; if let Some(fire) = fire - && self.res.facts.is_air(self.world.block(b[0], b[1], b[2])) + && self.res.facts().is_air(self.world.block(b[0], b[1], b[2])) && self.world.loaded(b[0], b[2]) { let _ = self.level_set(b, fire); @@ -761,7 +761,7 @@ impl Game<'_> { let held = self.held().cloned(); let modifiers = held .as_ref() - .and_then(|h| self.res.items.get(&h.item)) + .and_then(|h| self.res.items().get(&h.item)) .map(|i| (i.attack_damage, i.attack_speed)) .unwrap_or((0.0, 0.0)); let speed = (4.0 + modifiers.1).max(0.1); @@ -810,7 +810,7 @@ impl Game<'_> { (0..256) .rev() .find(|&y| { - let f = self.res.facts.get(self.world.block(x, y, z)); + let f = self.res.facts().get(self.world.block(x, y, z)); (f.full_collision || f.legacy_solid || f.fluid != horizon_client::blocks::Fluid::None) @@ -1254,7 +1254,7 @@ impl Game<'_> { let (x, z) = (head.x + look.x * 2.5, head.z + look.y * 2.5); let mut y = head.y + 0.5; while y > 0.0 - && self.res.facts.is_air(self.world.block( + && self.res.facts().is_air(self.world.block( x.floor() as i32, y.floor() as i32, z.floor() as i32, @@ -1591,7 +1591,7 @@ impl Game<'_> { return; }; let boxes = [d.part_box(0), d.part_box(1), d.part_box(2)]; - let tags = &self.res.items.block_tags; + let tags = &self.res.items().block_tags; let transparent = tags .get("minecraft:dragon_transparent") .cloned() @@ -1607,8 +1607,8 @@ impl Game<'_> { for y in lo.y.floor() as i32..=hi.y.floor() as i32 { for z in lo.z.floor() as i32..=hi.z.floor() as i32 { let state = self.world.block(x, y, z); - let name = &self.res.facts.get(state).name; - if self.res.facts.is_air(state) || transparent.contains(&**name) { + let name = &self.res.facts().get(state).name; + if self.res.facts().is_air(state) || transparent.contains(&**name) { continue; } if griefing && !immune.contains(&**name) { @@ -1710,7 +1710,7 @@ impl Game<'_> { let y = (0..256) .rev() .find(|&y| { - let f = self.res.facts.get(self.world.block(0, y, 0)); + let f = self.res.facts().get(self.world.block(0, y, 0)); f.full_collision || f.legacy_solid }) .map_or(64, |y| y + 1); @@ -1764,7 +1764,7 @@ impl Game<'_> { next.y.floor() as i32, next.z.floor() as i32, ]; - let f = self.res.facts.get(self.world.block(p[0], p[1], p[2])); + let f = self.res.facts().get(self.world.block(p[0], p[1], p[2])); f.full_collision || f.legacy_solid }; let hit_player = player.is_some_and(|pb| { @@ -2385,7 +2385,7 @@ impl Game<'_> { } let name = self .res - .facts + .facts() .get(self.world.block(hit.pos[0], hit.pos[1], hit.pos[2])) .name .clone(); @@ -2395,7 +2395,7 @@ impl Game<'_> { let above = [hit.pos[0], hit.pos[1] + 1, hit.pos[2]]; if !self .res - .facts + .facts() .is_air(self.world.block(above[0], above[1], above[2])) { return false; @@ -2515,7 +2515,7 @@ impl Game<'_> { } fn block_name_at(&self, p: [i32; 3]) -> std::sync::Arc { self.res - .facts + .facts() .get(self.world.block(p[0], p[1], p[2])) .name .clone() @@ -2617,7 +2617,7 @@ impl Game<'_> { for y in h - 10..=h + 10 { for z in cz - 10..=cz + 10 { for x in cx - 10..=cx + 10 { - if !self.res.facts.is_air(self.world.block(x, y, z)) { + if !self.res.facts().is_air(self.world.block(x, y, z)) { let _ = self.level_set([x, y, z], air); } } @@ -2639,7 +2639,7 @@ impl Game<'_> { if &*self.block_name_at([x, y, z]) != "minecraft:obsidian" { let _ = self.set_state_named([x, y, z], "minecraft:obsidian", &[]); } - } else if y > 65 && !self.res.facts.is_air(self.world.block(x, y, z)) { + } else if y > 65 && !self.res.facts().is_air(self.world.block(x, y, z)) { let _ = self.level_set([x, y, z], air); } } diff --git a/crates/horizon-client/src/game/enchant_effects.rs b/crates/horizon-client/src/game/enchant_effects.rs index 1e36b00f0..0aa3138f6 100644 --- a/crates/horizon-client/src/game/enchant_effects.rs +++ b/crates/horizon-client/src/game/enchant_effects.rs @@ -16,7 +16,7 @@ impl Game<'_> { let held = self.inventory[self.selected].as_ref(); speed += self .res - .stations + .stations() .enchantments .attribute_add(held, "minecraft:mining_efficiency") as f32; } @@ -26,7 +26,7 @@ impl Game<'_> { pub(super) fn submerged_mining_speed(&self) -> f32 { let mut total = 0.0; for stack in self.armor.iter().flatten() { - for (attr, _, amount, op) in self.res.stations.enchantments.attributes(stack) { + for (attr, _, amount, op) in self.res.stations().enchantments.attributes(stack) { if attr == "minecraft:submerged_mining_speed" && op == "add_multiplied_total" { total += amount; } @@ -36,13 +36,13 @@ impl Game<'_> { } /// `EnchantmentHelper.processDurabilityChange` (unbreaking) for `amount` points. pub(super) fn durability_loss(&mut self, stack: &ItemStack, amount: u32) -> u32 { - let e = &self.res.stations.enchantments; + let e = &self.res.stations().enchantments; if !e.has_component(stack, "minecraft:item_damage") { return amount; } let ctx = EffectContext { tool: Some(&stack.item), - items: Some(&self.res.items), + items: Some(self.res.items()), ..Default::default() }; e.modify_value( @@ -65,10 +65,10 @@ impl Game<'_> { direct_attacker: Some("minecraft:player"), is_direct: true, damage_type: Some("minecraft:player_attack"), - items: Some(&self.res.items), + items: Some(self.res.items()), ..Default::default() }; - self.res.stations.enchantments.modify_value( + self.res.stations().enchantments.modify_value( Some(&held), "minecraft:damage", &ctx, @@ -96,10 +96,10 @@ impl Game<'_> { attacker: Some("minecraft:player"), direct_attacker: Some("minecraft:player"), is_direct: true, - items: Some(&self.res.items), + items: Some(self.res.items()), ..Default::default() }; - let knockback = self.res.stations.enchantments.modify_value( + let knockback = self.res.stations().enchantments.modify_value( Some(&held), "minecraft:knockback", &ctx, @@ -130,7 +130,7 @@ impl Game<'_> { // minecraft:post_attack ignite effects of the attacker's weapon (fire aspect). let mut ignite = 0.0f32; for (id, level) in held.enchantments() { - let Some(def) = self.res.stations.enchantments.get(id) else { + let Some(def) = self.res.stations().enchantments.get(id) else { continue; }; for effect in def.effects["minecraft:post_attack"] @@ -145,7 +145,7 @@ impl Game<'_> { let mut random = self.world.random.clone(); let ok = effect.get("requirements").is_none_or(|r| { self.res - .stations + .stations() .enchantments .condition(r, *level, &ctx, &mut random) }); @@ -182,13 +182,13 @@ impl Game<'_> { attacker: Some("minecraft:player"), direct_attacker: Some("minecraft:player"), is_direct: true, - items: Some(&self.res.items), + items: Some(self.res.items()), direct_motion: Some(motion), ..Default::default() }; let mut bursts = Vec::new(); for (id, level) in held.enchantments() { - let Some(def) = self.res.stations.enchantments.get(id) else { + let Some(def) = self.res.stations().enchantments.get(id) else { continue; }; for effect in def.effects["minecraft:post_attack"] @@ -205,7 +205,7 @@ impl Game<'_> { continue; } let ok = effect.get("requirements").is_none_or(|r| { - self.res.stations.enchantments.condition( + self.res.stations().enchantments.condition( r, *level, &ctx, @@ -254,16 +254,16 @@ impl Game<'_> { if level == 0 { continue; } - let Some(def) = self.res.stations.enchantments.get("minecraft:thorns") else { + let Some(def) = self.res.stations().enchantments.get("minecraft:thorns") else { continue; }; let effect = def.effects["minecraft:post_attack"][0].clone(); let ctx = EffectContext { - items: Some(&self.res.items), + items: Some(self.res.items()), ..Default::default() }; let mut random = self.world.random.clone(); - let ok = self.res.stations.enchantments.condition( + let ok = self.res.stations().enchantments.condition( &effect["requirements"], level, &ctx, @@ -286,7 +286,7 @@ impl Game<'_> { s.damage += 2; if self .res - .items + .items() .get(&s.item) .is_some_and(|i| s.damage >= i.max_damage) { @@ -330,10 +330,10 @@ impl Game<'_> { }; let Some(stack) = stack else { return amount }; let ctx = EffectContext { - items: Some(&self.res.items), + items: Some(self.res.items()), ..Default::default() }; - let to_repair_xp = self.res.stations.enchantments.modify_value( + let to_repair_xp = self.res.stations().enchantments.modify_value( Some(&stack), "minecraft:repair_with_xp", &ctx, @@ -364,11 +364,11 @@ impl Game<'_> { let Some(bow) = self.inventory[self.selected].clone() else { return (0.0, false); }; - let e = &self.res.stations.enchantments; + let e = &self.res.stations().enchantments; let ctx = EffectContext { direct_attacker: Some("minecraft:arrow"), attacker: Some("minecraft:player"), - items: Some(&self.res.items), + items: Some(self.res.items()), ..Default::default() }; let power = e.modify_value( @@ -380,7 +380,7 @@ impl Game<'_> { ); let ammo_ctx = EffectContext { tool: Some("minecraft:arrow"), - items: Some(&self.res.items), + items: Some(self.res.items()), ..Default::default() }; let infinity = e.has_component(&bow, "minecraft:ammo_use") @@ -399,12 +399,12 @@ impl Game<'_> { let bow = self.inventory[self.selected].clone()?; let ctx = EffectContext { this: Some("minecraft:arrow"), - items: Some(&self.res.items), + items: Some(self.res.items()), ..Default::default() }; let mut ignite: Option = None; for (id, level) in bow.enchantments() { - let Some(def) = self.res.stations.enchantments.get(id) else { + let Some(def) = self.res.stations().enchantments.get(id) else { continue; }; for effect in def.effects["minecraft:projectile_spawned"] @@ -416,7 +416,7 @@ impl Game<'_> { continue; } let ok = effect.get("requirements").is_none_or(|r| { - self.res.stations.enchantments.condition( + self.res.stations().enchantments.condition( r, *level, &ctx, @@ -436,7 +436,7 @@ impl Game<'_> { pub(super) fn apply_enchantment_attributes(&mut self) { let mut wanted: Vec<(String, String, f64, String)> = Vec::new(); for stack in self.armor.iter().flatten() { - wanted.extend(self.res.stations.enchantments.attributes(stack)); + wanted.extend(self.res.stations().enchantments.attributes(stack)); } let Some(p) = self.player.as_mut() else { return; diff --git a/crates/horizon-client/src/game/end.rs b/crates/horizon-client/src/game/end.rs index 907be60f9..34026bb07 100644 --- a/crates/horizon-client/src/game/end.rs +++ b/crates/horizon-client/src/game/end.rs @@ -132,9 +132,9 @@ impl Game<'_> { /// The environment attributes of the current dimension. pub(super) fn dim_environment(&self) -> &Environment { match self.dim { - Dim::Overworld => &self.res.environment, - Dim::Nether => &self.res.nether_environment, - Dim::End => &self.res.end_environment, + Dim::Overworld => self.res.environment(), + Dim::Nether => self.res.nether_environment(), + Dim::End => self.res.end_environment(), } } @@ -225,7 +225,7 @@ impl Game<'_> { pub(super) fn block_name(&self, p: [i32; 3]) -> std::sync::Arc { self.res - .facts + .facts() .get(self.world.block(p[0], p[1], p[2])) .name .clone() @@ -562,7 +562,7 @@ impl Game<'_> { let mut y = (0..256) .rev() .find(|&y| { - let f = self.res.facts.get(self.world.block(0, y, 0)); + let f = self.res.facts().get(self.world.block(0, y, 0)); (f.full_collision || f.fluid != horizon_client::blocks::Fluid::None) && !f.name.ends_with("_leaves") }) @@ -784,7 +784,7 @@ impl Game<'_> { let mut y = 255; while y > floor { let p = [around[0] + xd, y, around[2] + zd]; - let f = self.res.facts.get(self.world.block(p[0], p[1], p[2])); + let f = self.res.facts().get(self.world.block(p[0], p[1], p[2])); if f.full_collision && (allow_bedrock || &*f.name != "minecraft:bedrock") { tallest = Some(p); break; @@ -840,12 +840,12 @@ impl Game<'_> { if &*self.block_name([x, y, z]) != "minecraft:end_stone" || self .res - .facts + .facts() .get(self.world.block(x, y + 1, z)) .full_collision || self .res - .facts + .facts() .get(self.world.block(x, y + 2, z)) .full_collision { diff --git a/crates/horizon-client/src/game/entity_culling.rs b/crates/horizon-client/src/game/entity_culling.rs index 71ab13378..0f9d6b06e 100644 --- a/crates/horizon-client/src/game/entity_culling.rs +++ b/crates/horizon-client/src/game/entity_culling.rs @@ -21,7 +21,7 @@ impl Game<'_> { && self.settings.resource_packs.iter().all(|id| id == "vanilla") && self.player.is_some() && !self.spectator() - && !opaque(self.res.facts.get(self.world.block(at[0], at[1], at[2])))) + && !opaque(self.res.facts().get(self.world.block(at[0], at[1], at[2])))) .then(|| Culler::new(camera.to_array(), 8_192)); } @@ -31,7 +31,7 @@ impl Game<'_> { if let Some(culler) = &self.entity_culler { culler.cull_vertices(vertices, start, |pos| { let state = self.world.block(pos[0], pos[1], pos[2]); - if !opaque(self.res.facts.get(state)) { + if !opaque(self.res.facts().get(state)) { return false; } let Some(y) = pos[1].checked_sub(MIN_Y) else { diff --git a/crates/horizon-client/src/game/explosion.rs b/crates/horizon-client/src/game/explosion.rs index 4ed2772c7..c6df8d9e2 100644 --- a/crates/horizon-client/src/game/explosion.rs +++ b/crates/horizon-client/src/game/explosion.rs @@ -196,7 +196,7 @@ impl Game<'_> { break; } let state = self.world.block(pos[0], pos[1], pos[2]); - let f = self.res.facts.get(state); + let f = self.res.facts().get(state); let fluid = if f.fluid != Fluid::None { 100.0f32 } else { @@ -206,7 +206,7 @@ impl Game<'_> { Some((at, resistance)) if at == pos => { power -= (resistance + 0.3) * 0.3; } - _ if !self.res.facts.is_air(state) || f.fluid != Fluid::None => { + _ if !self.res.facts().is_air(state) || f.fluid != Fluid::None => { power -= (f.explosion_resistance.max(fluid) + 0.3) * 0.3; } _ => {} @@ -450,11 +450,11 @@ impl Game<'_> { if self.world.random.next_int_bound(3).unwrap_or(1) == 0 && self .res - .facts + .facts() .is_air(self.world.block(pos[0], pos[1], pos[2])) && self .res - .facts + .facts() .get(self.world.block(pos[0], pos[1] - 1, pos[2])) .solid_render { @@ -475,7 +475,7 @@ impl Game<'_> { } else { targets.len() }; - let (world, facts) = (&self.world, &self.res.facts); + let (world, facts) = (&self.world, self.res.facts()); self.particles.explosion(center, radius, block_count, &|b| { facts.is_air(world.block(b[0], b[1], b[2])) }); @@ -490,10 +490,10 @@ impl Game<'_> { stacks: &mut Vec<([i32; 3], ItemStack)>, ) -> Result<()> { let state = self.world.block(pos[0], pos[1], pos[2]); - if self.res.facts.is_air(state) { + if self.res.facts().is_air(state) { return Ok(()); } - let name = self.res.facts.get(state).name.clone(); + let name = self.res.facts().get(state).name.clone(); let is_tnt = &*name == "minecraft:tnt"; // Block.onExplosionHit: the drops copy from the block entity, which // then spills its contents as the block turns to air. @@ -510,7 +510,7 @@ impl Game<'_> { // tables' survives_explosion and explosion_decay draw from their // random sequence. let decay = (interaction == BlockInteraction::DestroyWithDecay).then_some(radius); - let drops = self.res.items.block_drops_exploded( + let drops = self.res.items().block_drops_exploded( self.pack.assets.registry, state, None, diff --git a/crates/horizon-client/src/game/extras.rs b/crates/horizon-client/src/game/extras.rs index 55454f817..c16c54447 100644 --- a/crates/horizon-client/src/game/extras.rs +++ b/crates/horizon-client/src/game/extras.rs @@ -188,7 +188,7 @@ impl Game<'_> { let radius = ((reach / 16.0).ceil() as i32 + 1).min(self.settings.render_distance.max(2)); self.extras.minimap.update( &self.world, - &self.res.facts, + self.res.facts(), (bx >> 4, bz >> 4), radius, layer, diff --git a/crates/horizon-client/src/game/falling_damage.rs b/crates/horizon-client/src/game/falling_damage.rs index 16a003c04..ad7e71226 100644 --- a/crates/horizon-client/src/game/falling_damage.rs +++ b/crates/horizon-client/src/game/falling_damage.rs @@ -6,7 +6,7 @@ use horizon_world::level::LevelEvent; impl Game<'_> { pub(super) fn finish_falling_block(&mut self, mut block: FallingBlock, pos: [i32; 3]) { - let anvil = self.res.facts.get(block.state).name.ends_with("anvil"); + let anvil = self.res.facts().get(block.state).name.ends_with("anvil"); if let Some(impact) = block.damage.impact(block.fall_distance) { if impact.amount > 0.0 { falling_block::hurt_mobs(&mut self.mobs, block.position, impact.amount); @@ -80,7 +80,7 @@ impl Game<'_> { && block.drop_item && self.ui.rules.bool("entity_drops") { - let item = self.res.facts.get(block.state).item.clone(); + let item = self.res.facts().get(block.state).item.clone(); if &*item != "minecraft:air" { self.pop_resource( pos, diff --git a/crates/horizon-client/src/game/fishing.rs b/crates/horizon-client/src/game/fishing.rs index 75a67ef58..94067e7f9 100644 --- a/crates/horizon-client/src/game/fishing.rs +++ b/crates/horizon-client/src/game/fishing.rs @@ -226,14 +226,18 @@ impl Game<'_> { fn biome_name_at(&self, p: Vec3) -> Option { let (x, y, z) = (p.x.floor() as i32, p.y.floor() as i32, p.z.floor() as i32); let c = self.world.chunks.get(&(x >> 4, z >> 4))?; - Some(self.res.biomes.list[c.biome(x, y, z) as usize].name.clone()) + Some( + self.res.biomes().list[c.biome(x, y, z) as usize] + .name + .clone(), + ) } fn water_height(&self, x: i32, y: i32, z: i32) -> Option<(f32, bool)> { - let f = self.res.facts.get(self.world.block(x, y, z)); + let f = self.res.facts().get(self.world.block(x, y, z)); if f.fluid != Fluid::Water { return None; } - let above = self.res.facts.get(self.world.block(x, y + 1, z)); + let above = self.res.facts().get(self.world.block(x, y + 1, z)); let h = if above.fluid == Fluid::Water { 1.0 } else { @@ -243,7 +247,7 @@ impl Game<'_> { } /// getOpenWaterTypeForBlock: 0 above water, 1 inside water, 2 invalid. fn open_water_type(&self, x: i32, y: i32, z: i32) -> u8 { - let f = self.res.facts.get(self.world.block(x, y, z)); + let f = self.res.facts().get(self.world.block(x, y, z)); if self.world.is_air(self.world.block(x, y, z)) || &*f.name == "minecraft:lily_pad" { return 0; } @@ -390,7 +394,7 @@ impl Game<'_> { (fish[1] - 1.0).floor() as i32, fish[2].floor() as i32, ); - &*self.res.facts.get(state).name == "minecraft:water" + &*self.res.facts().get(state).name == "minecraft:water" } /// `ServerLevel.sendParticles` of a simple particle. fn send_particles( diff --git a/crates/horizon-client/src/game/fov.rs b/crates/horizon-client/src/game/fov.rs index 6a636152e..728def0ad 100644 --- a/crates/horizon-client/src/game/fov.rs +++ b/crates/horizon-client/src/game/fov.rs @@ -75,7 +75,7 @@ impl Game<'_> { } /// The fluid at the camera, as `Camera.getFluidInCamera` reports it. fn camera_fluid(&self, camera: [f64; 3]) -> CameraFluid { - match fog_type(&self.world, &self.res.facts, camera, self.forward()) { + match fog_type(&self.world, self.res.facts(), camera, self.forward()) { FogType::Water => CameraFluid::Water, FogType::Lava => CameraFluid::Lava, FogType::PowderSnow => CameraFluid::PowderSnow, diff --git a/crates/horizon-client/src/game/frames.rs b/crates/horizon-client/src/game/frames.rs index 2271feeb8..003115c91 100644 --- a/crates/horizon-client/src/game/frames.rs +++ b/crates/horizon-client/src/game/frames.rs @@ -110,7 +110,7 @@ impl Game<'_> { return false; } let s = f.step(); - let behind = self.res.facts.get(self.world.block( + let behind = self.res.facts().get(self.world.block( f.pos[0] - s[0], f.pos[1] - s[1], f.pos[2] - s[2], diff --git a/crates/horizon-client/src/game/golems.rs b/crates/horizon-client/src/game/golems.rs index 2bfeda70d..da204eee6 100644 --- a/crates/horizon-client/src/game/golems.rs +++ b/crates/horizon-client/src/game/golems.rs @@ -8,7 +8,7 @@ use horizon_client::Result; impl Game<'_> { fn golem_block(&self, p: [i32; 3]) -> &str { let state = self.world.block(p[0], p[1], p[2]); - &self.res.facts.get(state).name + &self.res.facts().get(state).name } fn is_golem_head(&self, p: [i32; 3]) -> bool { matches!( @@ -33,7 +33,7 @@ impl Game<'_> { for (ax, az) in [(1, 0), (0, 1)] { let side = |s: i32, row: i32| [head[0] + ax * s, head[1] - row, head[2] + az * s]; let arms = (-1..=1).all(|s| self.golem_block(side(s, 1)) == "minecraft:iron_block"); - let air = |p: [i32; 3]| self.res.facts.is_air(self.world.block(p[0], p[1], p[2])); + let air = |p: [i32; 3]| self.res.facts().is_air(self.world.block(p[0], p[1], p[2])); if arms && self.golem_block(side(0, 2)) == "minecraft:iron_block" && [-1, 1].iter().all(|&s| air(side(s, 0)) && air(side(s, 2))) @@ -58,7 +58,7 @@ impl Game<'_> { let below = [head[0], head[1] - 1, head[2]]; let name = self.golem_block(below); self.res - .items + .items() .block_tags .get("minecraft:copper") .is_some_and(|t| t.contains(name)) @@ -88,7 +88,7 @@ impl Game<'_> { /// `EntityType.create(level, TRIGGERED)` and `snapTo`: a built golem or /// wither has no spawn finalization and draws nothing from the level. pub(super) fn create_triggered(&mut self, kind: &str, at: [f64; 3], yaw: f32) -> Option { - let t = self.res.mob_types.get(kind).cloned()?; + let t = self.res.mob_types().get(kind).cloned()?; self.next_entity += 1; let mut mob = horizon_client::mobs::Mob::new( self.next_entity, @@ -181,9 +181,9 @@ impl Game<'_> { }); if let Some(chest) = chest { self.with_level(|b, level, ticks| b.set_block(level, ticks, pos, chest, 2)); - if let Some(entity) = - horizon_client::containers::BlockEntity::for_block(&self.res.facts.get(chest).name) - { + if let Some(entity) = horizon_client::containers::BlockEntity::for_block( + &self.res.facts().get(chest).name, + ) { self.world .block_entities .insert((below[0], below[1], below[2]), entity); diff --git a/crates/horizon-client/src/game/growth.rs b/crates/horizon-client/src/game/growth.rs index 18591b0fe..a6e062e24 100644 --- a/crates/horizon-client/src/game/growth.rs +++ b/crates/horizon-client/src/game/growth.rs @@ -10,7 +10,7 @@ impl Game<'_> { /// Load the configured/placed feature registry used by saplings, fungi /// and bone meal (once per process; shares the generator's bundle). pub(super) fn install_live_features(&self) { - if self.res.behaviours.live_features().is_some() { + if self.res.behaviours().live_features().is_some() { return; } let dir = self.options.resources.join("worldgen"); @@ -20,7 +20,7 @@ impl Game<'_> { .and_then(|data| LiveFeatures::new(&data).map_err(|e| e.to_string())); match features { Ok(Some(features)) => { - self.res.behaviours.set_live_features(Arc::new(features)); + self.res.behaviours().set_live_features(Arc::new(features)); log::info!("Horizon: live features ready in {:?}", started.elapsed()); } Ok(None) => { diff --git a/crates/horizon-client/src/game/hand.rs b/crates/horizon-client/src/game/hand.rs index 19e66174b..13309af87 100644 --- a/crates/horizon-client/src/game/hand.rs +++ b/crates/horizon-client/src/game/hand.rs @@ -90,7 +90,7 @@ impl Game<'_> { let (pos, first) = (d.pos, (d.ticks as u32 - 1).is_multiple_of(4)); let state = self.world.block(pos[0], pos[1], pos[2]); if first { - let sounds = self.res.facts.get(state).sounds.clone(); + let sounds = self.res.facts().get(state).sounds.clone(); self.audio.play( &sounds.hit, Some(pos.map(|v| f64::from(v) + 0.5)), @@ -117,17 +117,17 @@ impl Game<'_> { /// `BlockBehaviour.getDestroyProgress` with `Player.getDestroySpeed`. pub(super) fn destroy_progress(&self, pos: [i32; 3]) -> f32 { let state = self.world.block(pos[0], pos[1], pos[2]); - let facts = self.res.facts.get(state); + let facts = self.res.facts().get(state); if facts.hardness == -1.0 { return 0.0; } let held = self.held(); - let mut speed = self.res.items.mining_speed(held, &facts.name); + let mut speed = self.res.items().mining_speed(held, &facts.name); speed = self.modify_destroy_speed(speed); if let Some(eye) = self.eye_position() && self .res - .facts + .facts() .get(self.world.block( eye[0].floor() as i32, eye[1].floor() as i32, @@ -141,7 +141,7 @@ impl Game<'_> { if self.player.as_ref().is_some_and(|p| !p.ground.on_ground) { speed /= 5.0; } - let harvest = !facts.requires_tool || self.res.items.correct_for_drops(held, &facts.name); + let harvest = !facts.requires_tool || self.res.items().correct_for_drops(held, &facts.name); speed / facts.hardness / if harvest { 30.0 } else { 100.0 } } /// Whether an attack would hit an entity rather than the block behind @@ -287,7 +287,7 @@ impl Game<'_> { horizon_client::attack_strength::BASE_ATTACK_SPEED + self .held() - .and_then(|h| self.res.items.get(&h.item)) + .and_then(|h| self.res.items().get(&h.item)) .map_or(0.0, |i| f64::from(i.attack_speed)) } /// `evaluateWhichHandsToRender`: which of the main and off hand show. @@ -351,7 +351,7 @@ impl HandWorld for GameHands<'_, '_> { } fn is_air(&mut self, pos: [i32; 3]) -> bool { let state = self.game.world.block(pos[0], pos[1], pos[2]); - self.game.res.facts.get(state).name.ends_with("air") + self.game.res.facts().get(state).name.ends_with("air") } fn creative(&self) -> bool { self.game.creative diff --git a/crates/horizon-client/src/game/initial_spawn.rs b/crates/horizon-client/src/game/initial_spawn.rs index 5fcd90517..3f7a071bb 100644 --- a/crates/horizon-client/src/game/initial_spawn.rs +++ b/crates/horizon-client/src/game/initial_spawn.rs @@ -83,7 +83,7 @@ impl Game<'_> { horizon_client::flatgen::FlatTerrain::from_settings( &s, self.pack.assets.registry, - &self.res.biomes, + self.res.biomes(), ) }) { diff --git a/crates/horizon-client/src/game/item_draw.rs b/crates/horizon-client/src/game/item_draw.rs index ce571f436..817c84871 100644 --- a/crates/horizon-client/src/game/item_draw.rs +++ b/crates/horizon-client/src/game/item_draw.rs @@ -176,7 +176,7 @@ impl Game<'_> { } pub(super) fn item_host(&self) -> Host<'_> { Host { - banners: &self.res.stations.banners, + banners: &self.res.stations().banners, } } /// The client level as item models read it. diff --git a/crates/horizon-client/src/game/jukebox.rs b/crates/horizon-client/src/game/jukebox.rs index 235ad7c24..3d0a7fb6d 100644 --- a/crates/horizon-client/src/game/jukebox.rs +++ b/crates/horizon-client/src/game/jukebox.rs @@ -51,7 +51,7 @@ impl Game<'_> { pub(super) fn use_jukebox(&mut self, pos: [i32; 3], held: Option<&ItemStack>) -> bool { if &*self .res - .facts + .facts() .get(self.world.block(pos[0], pos[1], pos[2])) .name != "minecraft:jukebox" @@ -65,7 +65,7 @@ impl Game<'_> { let Some(stack) = held else { return false }; let Some(song) = self .res - .items + .items() .get(&stack.item) .and_then(|i| i.jukebox_song.clone()) else { @@ -95,7 +95,7 @@ impl Game<'_> { /// Level event 1010: the song from the jukebox, and the "Now Playing" overlay. fn start_song(&mut self, pos: [i32; 3], song: &str) { self.stop_song(pos); - let Some(s) = self.res.items.songs.get(song).cloned() else { + let Some(s) = self.res.items().songs.get(song).cloned() else { return; }; // LevelRenderer.playJukeboxSong: SimpleSoundInstance.forJukeboxSong. @@ -150,7 +150,7 @@ impl Game<'_> { BlockEntity::Jukebox(j) if j.playing => { let song = self .res - .items + .items() .get(&j.record.as_ref()?.item)? .jukebox_song .clone()?; @@ -161,7 +161,7 @@ impl Game<'_> { .collect(); for (key, song, ticks) in playing { let pos = [key.0, key.1, key.2]; - let Some(s) = self.res.items.songs.get(&song).cloned() else { + let Some(s) = self.res.items().songs.get(&song).cloned() else { continue; }; if s.finished(ticks) { diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index 79ceffa93..c79a79d6c 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -456,7 +456,7 @@ impl Game<'_> { .clone()?; let biome_names: Vec = self .res - .biomes + .biomes() .list .iter() .map(|b| b.name.clone()) @@ -469,7 +469,7 @@ impl Game<'_> { .unwrap_or_default(); let mut encoder = ChunkEncoder::new( self.res - .facts + .facts() .states .iter() .map(|s| (s.name.clone(), s.fluid_level > 0 || s.waterlogged)), @@ -1012,7 +1012,7 @@ impl Game<'_> { /// The guests' models, for the host to see them. fn lan_update_models(&mut self, host: &mut LanHost) { - let Some(kind) = self.res.player_type.clone() else { + let Some(kind) = self.res.player_type().clone() else { return; }; host.models @@ -1099,7 +1099,7 @@ impl Game<'_> { camera, &lookup, packed, - &self.res.mob_data, + self.res.mob_data(), &self.worn_armor_layers(m), out, ); diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index 7cd4b0474..f98c77971 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -299,7 +299,7 @@ impl Game<'_> { fn lan_open_container(&mut self, host: &mut LanHost, conn: u32, pos: (i32, i32, i32)) -> bool { let name = &self .res - .facts + .facts() .get(self.world.block(pos.0, pos.1, pos.2)) .name; let (menu, title, slots) = if &**name == "minecraft:ender_chest" { @@ -543,7 +543,7 @@ impl Game<'_> { } } S::ContainerClick(p) => { - let rules = ItemRules(&self.res.items); + let rules = ItemRules(self.res.items()); let drops = host.hub.container_click(conn, &p, &mut self.world, &rules); self.drop_guest_items(host, gi, drops); } @@ -675,7 +675,7 @@ impl Game<'_> { } S::PickItemFromBlock(p) => { let state = self.world.block(p.pos[0], p.pos[1], p.pos[2]); - let item = self.res.facts.get(state).item.clone(); + let item = self.res.facts().get(state).item.clone(); let g = &mut host.hub.guests[gi]; if g.creative() && &*item != "minecraft:air" { let slot = g.selected; @@ -1148,7 +1148,7 @@ impl Game<'_> { let range = |v: f64| (v - half).floor() as i32..=(v + half).floor() as i32; range(at[0]).any(|x| { range(at[2]).any(|z| { - let f = self.res.facts.get(self.world.block(x, y, z)); + let f = self.res.facts().get(self.world.block(x, y, z)); f.full_collision && f.solid_render }) }) @@ -1166,7 +1166,7 @@ impl Game<'_> { play.mining = None; let start = play.dig_start; let state = self.world.block(pos[0], pos[1], pos[2]); - if !dug || self.res.facts.is_air(state) { + if !dug || self.res.facts().is_air(state) { return; } let progress = self @@ -1190,7 +1190,7 @@ impl Game<'_> { }; let ticks = host.hub.ticks; let state = self.world.block(pos[0], pos[1], pos[2]); - let progress = if self.res.facts.is_air(state) { + let progress = if self.res.facts().is_air(state) { None } else { self.as_guest(host, conn, |g| g.destroy_progress(pos)) diff --git a/crates/horizon-client/src/game/lan_crafting.rs b/crates/horizon-client/src/game/lan_crafting.rs index 9841fa879..b0a6ae517 100644 --- a/crates/horizon-client/src/game/lan_crafting.rs +++ b/crates/horizon-client/src/game/lan_crafting.rs @@ -84,10 +84,10 @@ fn place_back(menu: &mut Menu, env: &Env, stacks: Vec) { impl Game<'_> { fn menu_env(&self) -> Env<'_> { Env { - items: &self.res.items, - recipes: &self.res.recipes, - brewing: &self.res.stations.brewing, - banners: &self.res.stations.banners, + items: self.res.items(), + recipes: self.res.recipes(), + brewing: &self.res.stations().brewing, + banners: &self.res.stations().banners, trade: None, } } @@ -218,7 +218,7 @@ impl Game<'_> { f.items[k] = menu.slot(k).cloned(); } // AbstractFurnaceBlockEntity.setItem: only a new input restarts cooking. - f.input_clicked(&self.res.recipes, items[0].clone()); + f.input_clicked(self.res.recipes(), items[0].clone()); } host.play.entry(conn).or_default().crafting.furnace = Some((p.container, menu)); host.hub.inventory_clicked(conn, p, &self.world, &changed); diff --git a/crates/horizon-client/src/game/lan_trading.rs b/crates/horizon-client/src/game/lan_trading.rs index d6bfc4141..708a0a6a8 100644 --- a/crates/horizon-client/src/game/lan_trading.rs +++ b/crates/horizon-client/src/game/lan_trading.rs @@ -133,7 +133,7 @@ impl Game<'_> { if let Some(name) = &state.name { return name.clone(); } - let e = &self.res.stations.enchantments; + let e = &self.res.stations().enchantments; let profession = state.session.profession.trim_start_matches("minecraft:"); if state.session.villager { e.translate(&format!("entity.minecraft.villager.{profession}")) @@ -245,15 +245,15 @@ impl Game<'_> { next_id: std::cell::Cell::new(next_map), }; let trade_env = merchant::TradeEnv { - trades: &self.res.stations.trades, - enchantments: &self.res.stations.enchantments, + trades: &self.res.stations().trades, + enchantments: &self.res.stations().enchantments, maps: Some(&maps), }; let env = Env { - items: &self.res.items, - recipes: &self.res.recipes, - brewing: &self.res.stations.brewing, - banners: &self.res.stations.banners, + items: self.res.items(), + recipes: self.res.recipes(), + brewing: &self.res.stations().brewing, + banners: &self.res.stations().banners, trade: Some(&trade_env), }; let mut menu = Menu::new(Kind::Merchant); diff --git a/crates/horizon-client/src/game/leads.rs b/crates/horizon-client/src/game/leads.rs index 38e0226f1..ae5d87fff 100644 --- a/crates/horizon-client/src/game/leads.rs +++ b/crates/horizon-client/src/game/leads.rs @@ -220,11 +220,11 @@ impl Game<'_> { }; let name = self .res - .facts + .facts() .get(self.world.block(hit.pos[0], hit.pos[1], hit.pos[2])); if !self .res - .items + .items() .block_tags .get("minecraft:fences") .is_some_and(|s| s.contains(&*name.name)) diff --git a/crates/horizon-client/src/game/lightning.rs b/crates/horizon-client/src/game/lightning.rs index 4b7851edc..7b480a8e6 100644 --- a/crates/horizon-client/src/game/lightning.rs +++ b/crates/horizon-client/src/game/lightning.rs @@ -50,7 +50,7 @@ impl Game<'_> { let difficulty = f64::from(self.ui.difficulty) * 0.75; let below = &self .res - .facts + .facts() .get(self.world.block(pos[0], pos[1] - 1, pos[2])) .name; let trap = self.ui.rules.bool("spawn_mobs") @@ -160,11 +160,11 @@ impl Game<'_> { } for p in spots { let state = self.world.block(p[0], p[1], p[2]); - if !self.res.facts.is_air(state) { + if !self.res.facts().is_air(state) { continue; } // BaseFireBlock.getState: soul fire on soul soil and sand. - let below = self.res.facts.get(self.world.block(p[0], p[1] - 1, p[2])); + let below = self.res.facts().get(self.world.block(p[0], p[1] - 1, p[2])); let name = if matches!(&*below.name, "minecraft:soul_soil" | "minecraft:soul_sand") { "minecraft:soul_fire" } else { @@ -236,7 +236,7 @@ impl Game<'_> { at[2].floor() as i32, ]; let state = self.world.block(p[0], p[1], p[2]); - if !self.res.facts.get(state).name.ends_with("lightning_rod") { + if !self.res.facts().get(state).name.ends_with("lightning_rod") { return; } let registry = self.pack.assets.registry; diff --git a/crates/horizon-client/src/game/loom.rs b/crates/horizon-client/src/game/loom.rs index 795ee918c..f1ff1a300 100644 --- a/crates/horizon-client/src/game/loom.rs +++ b/crates/horizon-client/src/game/loom.rs @@ -192,7 +192,7 @@ impl Game<'_> { base: &str, layers: &[BannerLayer], ) { - let banners = &self.res.stations.banners; + let banners = &self.res.stations().banners; let layers: Vec<(String, String)> = layers .iter() .map(|l| (banners.banner_texture(&l.pattern), l.color.to_string())) @@ -317,7 +317,7 @@ impl Game<'_> { let l = &s.loom; let dye = s.inputs[1] .as_ref() - .and_then(|d| self.res.items.get(&d.item)) + .and_then(|d| self.res.items().get(&d.item)) .and_then(|i| i.dye.clone()) .unwrap_or_else(|| "white".to_owned()); let result = s @@ -342,7 +342,7 @@ impl Game<'_> { dye: &dye, mouse: local, }; - let draws = screen_layout::loom(&view, &self.res.stations.banners); + let draws = screen_layout::loom(&view, &self.res.stations().banners); self.paint_screen(batch, ox, oy, &draws, false) } } diff --git a/crates/horizon-client/src/game/mace.rs b/crates/horizon-client/src/game/mace.rs index 062d04525..46091a773 100644 --- a/crates/horizon-client/src/game/mace.rs +++ b/crates/horizon-client/src/game/mace.rs @@ -84,11 +84,11 @@ impl Game<'_> { direct_attacker: Some("minecraft:player"), is_direct: true, damage_type: Some("minecraft:mace_smash"), - items: Some(&self.res.items), + items: Some(self.res.items()), ..Default::default() }; // EnchantmentHelper.modifyFallBasedDamage(..., 0) - let per_block = self.res.stations.enchantments.modify_value( + let per_block = self.res.stations().enchantments.modify_value( held.as_ref(), "minecraft:smash_damage_per_fallen_block", &ctx, @@ -111,10 +111,10 @@ impl Game<'_> { horizon_client::mobs::DamageKind::MaceSmash => "minecraft:mace_smash", _ => "minecraft:player_attack", }), - items: Some(&self.res.items), + items: Some(self.res.items()), ..Default::default() }; - let enchantments = &self.res.stations.enchantments; + let enchantments = &self.res.stations().enchantments; let random = &mut self.world.random; // CombatRules.getDamageAfterAbsorb: EnchantmentHelper.modifyArmorEffectiveness. let mut breach = |fraction: f32| { @@ -143,7 +143,7 @@ impl Game<'_> { }; let weapon = self .res - .items + .items() .get(&stack.item) .and_then(|i| i.weapon_damage.map(|d| (d, i.max_damage))); let smash = self.smash_attack(); diff --git a/crates/horizon-client/src/game/machines.rs b/crates/horizon-client/src/game/machines.rs index bc9d98f41..3d421293c 100644 --- a/crates/horizon-client/src/game/machines.rs +++ b/crates/horizon-client/src/game/machines.rs @@ -361,10 +361,10 @@ impl Game<'_> { fn containers(&self) -> Containers<'_> { Containers { world: &self.world, - behaviours: &self.res.behaviours, - items: &self.res.items, + behaviours: self.res.behaviours(), + items: self.res.items(), registry: self.pack.assets.registry, - brewing: Some(&self.res.stations.brewing), + brewing: Some(&self.res.stations().brewing), bone_meal: bone_meal(), } } @@ -504,7 +504,7 @@ impl Game<'_> { .assets .registry .default_state("minecraft:hopper") - .map(|s| self.res.facts.get(s).name.clone()); + .map(|s| self.res.facts().get(s).name.clone()); let Some(hopper) = hopper else { return Ok(()) }; // A hopper's block entity is a plain container (`Chest`): only those // need their block looked up (the ticker runs for a HopperBlockEntity @@ -515,7 +515,7 @@ impl Game<'_> { .iter() .filter(|(_, e)| matches!(e, BlockEntity::Chest(_))) .map(|(p, _)| *p) - .filter(|p| self.res.facts.get(self.world.block(p.0, p.1, p.2)).name == hopper) + .filter(|p| self.res.facts().get(self.world.block(p.0, p.1, p.2)).name == hopper) .collect(); positions.sort_unstable(); self.hoppers @@ -631,12 +631,12 @@ impl Game<'_> { return false; } let above_state = self.world.block(above.0, above.1, above.2); - let blocked = self.res.facts.get(above_state).full_collision + let blocked = self.res.facts().get(above_state).full_collision && !self .res - .behaviours + .behaviours() .tag("minecraft:does_not_block_hoppers") - .is_some_and(|t| t.contains(self.res.behaviours.block(above_state))); + .is_some_and(|t| t.contains(self.res.behaviours().block(above_state))); if blocked { return false; } @@ -683,7 +683,7 @@ impl Game<'_> { /// `DispenserBlock.dispenseFrom` / `DropperBlock.dispenseFrom`. pub(super) fn dispense_from(&mut self, pos: BlockPos, state: BlockStateId) -> Result<()> { let key = (pos.x, pos.y, pos.z); - let name = self.res.facts.get(state).name.clone(); + let name = self.res.facts().get(state).name.clone(); if &*name == "minecraft:crafter" { return self.crafter_dispense(pos, state); } @@ -780,7 +780,7 @@ impl Game<'_> { .then_some(Screen::Hopper); } let state = self.world.block(key.0, key.1, key.2); - match &*self.res.facts.get(state).name { + match &*self.res.facts().get(state).name { "minecraft:hopper" => Some(Screen::Hopper), "minecraft:dispenser" => Some(Screen::Dispenser), "minecraft:dropper" => Some(Screen::Dropper), diff --git a/crates/horizon-client/src/game/machines/crafter.rs b/crates/horizon-client/src/game/machines/crafter.rs index 62630758f..bd2989137 100644 --- a/crates/horizon-client/src/game/machines/crafter.rs +++ b/crates/horizon-client/src/game/machines/crafter.rs @@ -105,7 +105,7 @@ impl Game<'_> { // RecipeCache.get: the first crafting recipe that matches, assembled. let found = self .res - .recipes + .recipes() .find(&grid, 3) .map(|(name, result)| (name.to_owned(), result)) .filter(|(_, result)| result.count > 0); @@ -131,7 +131,7 @@ impl Game<'_> { horizon_world::level::flags::UPDATE_CLIENTS, ); // The remainders come from the grid as it was before anything moved. - let remainders = self.res.recipes.remainders(&recipe, &grid, 3); + let remainders = self.res.recipes().remainders(&recipe, &grid, 3); self.crafter_eject(key, facing, result, &recipe); for rest in remainders.into_iter().flatten() { self.crafter_eject(key, facing, rest, &recipe); @@ -213,7 +213,7 @@ impl Game<'_> { pub(in crate::game) fn crafter_result(&self) -> Option { let key = self.container?; let c = self.crafter_at(key)?; - self.res.recipes.craft(&c.items, 3) + self.res.recipes().craft(&c.items, 3) } fn crafter_open(&self) -> bool { matches!(self.container_kind(), Some(BlockEntity::Crafter(_))) diff --git a/crates/horizon-client/src/game/maps.rs b/crates/horizon-client/src/game/maps.rs index 28d74d56f..855ef941a 100644 --- a/crates/horizon-client/src/game/maps.rs +++ b/crates/horizon-client/src/game/maps.rs @@ -673,17 +673,18 @@ impl Game<'_> { } else { loop { y -= 1; - color = self.res.facts.get(self.world.block(x, y, z)).map_color; + color = + self.res.facts().get(self.world.block(x, y, z)).map_color; if color != 0 || y <= min_y { break; } } - let f = self.res.facts.get(self.world.block(x, y, z)); + let f = self.res.facts().get(self.world.block(x, y, z)); if y > min_y && f.fluid != Fluid::None { let mut solid = y - 1; loop { let below = - self.res.facts.get(self.world.block(x, solid, z)); + self.res.facts().get(self.world.block(x, solid, z)); solid -= 1; water_depth += 1; if solid <= min_y || below.fluid == Fluid::None { diff --git a/crates/horizon-client/src/game/minecarts.rs b/crates/horizon-client/src/game/minecarts.rs index 8d87bb639..423b4a53e 100644 --- a/crates/horizon-client/src/game/minecarts.rs +++ b/crates/horizon-client/src/game/minecarts.rs @@ -210,7 +210,7 @@ impl CartModels { impl Game<'_> { pub(super) fn rail(&self, x: i32, y: i32, z: i32) -> Option { let state = self.world.block(x, y, z); - let name = self.res.facts.get(state).name.clone(); + let name = self.res.facts().get(state).name.clone(); if !matches!( &*name, "minecraft:rail" @@ -239,11 +239,14 @@ impl Game<'_> { } } fn conductor(&self, x: i32, y: i32, z: i32) -> bool { - self.res.facts.get(self.world.block(x, y, z)).full_collision + self.res + .facts() + .get(self.world.block(x, y, z)) + .full_collision } fn cart_in_water(&self, c: &Minecart) -> bool { let p = c.position; - let f = self.res.facts.get(self.world.block( + let f = self.res.facts().get(self.world.block( p.x.floor() as i32, (p.y + 0.1).floor() as i32, p.z.floor() as i32, @@ -653,7 +656,7 @@ impl Game<'_> { stack.count = 0; } Some(s) if s.same_item_same_components(&stack) => { - let max = self.res.items.get(&s.item).map_or(64, |i| i.max_stack); + let max = self.res.items().get(&s.item).map_or(64, |i| i.max_stack); let moved = stack.count.min(max.saturating_sub(s.count)); s.count += moved; stack.count -= moved; @@ -881,9 +884,9 @@ impl Game<'_> { (-1, 1), ] { let (x, y, z) = (bx + dx, by + dy, bz + dz); - let below = self.res.facts.get(self.world.block(x, y - 1, z)); - let here = self.res.facts.get(self.world.block(x, y, z)); - let head = self.res.facts.get(self.world.block(x, y + 1, z)); + let below = self.res.facts().get(self.world.block(x, y - 1, z)); + let here = self.res.facts().get(self.world.block(x, y, z)); + let head = self.res.facts().get(self.world.block(x, y + 1, z)); if (below.full_collision || below.legacy_solid) && !here.full_collision && !head.full_collision @@ -1351,7 +1354,7 @@ impl Game<'_> { glyph: &|c| self.gui.atlas.glyph_cell(c), }; self.res - .block_entity_render + .block_entity_render() .render_state(&scene, state.0, m, light, out); } } diff --git a/crates/horizon-client/src/game/mob_blocks.rs b/crates/horizon-client/src/game/mob_blocks.rs index f42648aa6..466fccb4c 100644 --- a/crates/horizon-client/src/game/mob_blocks.rs +++ b/crates/horizon-client/src/game/mob_blocks.rs @@ -75,7 +75,7 @@ impl Game<'_> { if left <= 0 { return; } - let Some(kind) = self.res.mob_types.get("minecraft:elder_guardian") else { + let Some(kind) = self.res.mob_types().get("minecraft:elder_guardian") else { return; }; let Some(r) = self.gui.atlas.sprites.get("entity/guardian_elder").copied() else { @@ -142,7 +142,7 @@ impl Game<'_> { return; }; let Some(head) = - render::part_transform(mob, alpha as f32, camera, &self.res.mob_data, "head") + render::part_transform(mob, alpha as f32, camera, self.res.mob_data(), "head") else { return; }; @@ -260,7 +260,7 @@ impl Game<'_> { for (item, left) in [(&mob.extra.main_hand, false), (&mob.extra.off_hand, true)] { let Some(item) = item else { continue }; let Some(t) = - render::held_item_transform(mob, alpha as f32, camera, &self.res.mob_data, left) + render::held_item_transform(mob, alpha as f32, camera, self.res.mob_data(), left) else { continue; }; diff --git a/crates/horizon-client/src/game/mob_gear.rs b/crates/horizon-client/src/game/mob_gear.rs index c4a77e38c..809b250dc 100644 --- a/crates/horizon-client/src/game/mob_gear.rs +++ b/crates/horizon-client/src/game/mob_gear.rs @@ -91,9 +91,9 @@ impl Game<'_> { let cost = random .next_int_between_inclusive(MIN_COST, top) .unwrap_or(MIN_COST); - let e = &self.res.stations.enchantments; + let e = &self.res.stations().enchantments; let pool = e.tag("minecraft:on_mob_spawn_equipment"); - let picked = e.select(&self.res.items, random, item, cost, pool); + let picked = e.select(self.res.items(), random, item, cost, pool); if let Some(m) = self.mobs.iter_mut().find(|m| m.id == id) { for (enchantment, level) in picked { gear::upgrade(m, slot, &enchantment, level); diff --git a/crates/horizon-client/src/game/mount_menu.rs b/crates/horizon-client/src/game/mount_menu.rs index 1eec17491..1db2210d3 100644 --- a/crates/horizon-client/src/game/mount_menu.rs +++ b/crates/horizon-client/src/game/mount_menu.rs @@ -385,7 +385,7 @@ impl Game<'_> { camera, &lookup, 240 | 240 << 8, - &self.res.mob_data, + self.res.mob_data(), &[], &mut verts, ); diff --git a/crates/horizon-client/src/game/mounts.rs b/crates/horizon-client/src/game/mounts.rs index 846834615..42eac1e9b 100644 --- a/crates/horizon-client/src/game/mounts.rs +++ b/crates/horizon-client/src/game/mounts.rs @@ -90,7 +90,11 @@ impl Game<'_> { && let Some(stack) = self.inventory[self.selected].as_mut() { stack.damage += wear; - let max = self.res.items.get(&stack.item).map_or(25, |i| i.max_damage); + let max = self + .res + .items() + .get(&stack.item) + .map_or(25, |i| i.max_damage); if stack.damage >= max { self.inventory[self.selected] = Some(ItemStack::new("minecraft:fishing_rod", 1)); } @@ -406,7 +410,7 @@ impl Game<'_> { .find(|c| { let f = |dy: i32| { self.res - .facts + .facts() .get(self.world.block( c.x.floor() as i32, c.y.floor() as i32 + dy, diff --git a/crates/horizon-client/src/game/music.rs b/crates/horizon-client/src/game/music.rs index 381af21cf..9198a78a1 100644 --- a/crates/horizon-client/src/game/music.rs +++ b/crates/horizon-client/src/game/music.rs @@ -50,7 +50,7 @@ impl Game<'_> { let (background, probe_volume) = match eye { Some(eye) => { let (dimension, biome) = (self.dim.id(), self.biome_at(eye)); - let tables = &self.res.music; + let tables = self.res.music(); ( tables.background(dimension, biome), tables.volume(dimension, biome), @@ -81,7 +81,7 @@ impl Game<'_> { .chunks .get(&(x >> 4, z >> 4)) .map_or("minecraft:plains", |c| { - self.res.biomes.list[c.biome(x, y, z) as usize] + self.res.biomes().list[c.biome(x, y, z) as usize] .name .as_str() }) @@ -89,11 +89,11 @@ impl Game<'_> { /// `isEyeInFluid(WATER)`: the eye inside the water of its block column. fn eye_in_water(&self, x: f64, eye_y: f64, z: f64) -> bool { let (bx, by, bz) = (x.floor() as i32, eye_y.floor() as i32, z.floor() as i32); - let f = self.res.facts.get(self.world.block(bx, by, bz)); + let f = self.res.facts().get(self.world.block(bx, by, bz)); if f.fluid != Fluid::Water { return false; } - let above = self.res.facts.get(self.world.block(bx, by + 1, bz)); + let above = self.res.facts().get(self.world.block(bx, by + 1, bz)); let height = if above.fluid == Fluid::Water { 1.0 } else { @@ -111,7 +111,7 @@ impl Game<'_> { }; let feet = [p.position.x, p.position.y, p.position.z]; let eye_y = feet[1] + f64::from(p.dimensions.eye_height); - let sounds = self.res.ambient.get(self.dim.id(), self.biome_at(feet)); + let sounds = self.res.ambient().get(self.dim.id(), self.biome_at(feet)); let underwater = self.eye_in_water(feet[0], eye_y, feet[2]); let world = &self.world; let light = |b: [i32; 3]| { @@ -123,7 +123,7 @@ impl Game<'_> { f64::from(p.dimensions.height), ); let registry = &self.pack.assets.registry; - let facts = &self.res.facts; + let facts = self.res.facts(); let bubble_column = horizon_client::ambience::bubble_column_in( [ feet[0] - half, diff --git a/crates/horizon-client/src/game/natural_spawning.rs b/crates/horizon-client/src/game/natural_spawning.rs index 80d26a823..6f2f5e6af 100644 --- a/crates/horizon-client/src/game/natural_spawning.rs +++ b/crates/horizon-client/src/game/natural_spawning.rs @@ -35,7 +35,7 @@ pub(super) struct GameLevel<'g, 'a> { impl GameLevel<'_, '_> { fn biome(&self, x: i32, y: i32, z: i32) -> Option<&BiomeInfo> { let chunk = self.game.world.chunks.get(&(x >> 4, z >> 4))?; - Some(self.game.res.biomes.get(chunk.biome(x, y, z))) + Some(self.game.res.biomes().get(chunk.biome(x, y, z))) } } impl SpawnLevel for GameLevel<'_, '_> { @@ -106,7 +106,7 @@ impl NaturalLevel for GameLevel<'_, '_> { self.game.dim == Dim::Nether } fn mob_type(&self, entity: &str) -> Option<(Species, f32, f32, Category)> { - let t = self.game.res.mob_types.get(entity)?; + let t = self.game.res.mob_types().get(entity)?; Some(( t.species, t.width as f32, @@ -234,7 +234,7 @@ impl horizon_client::mobs::spawner::SpawnerLevel for GameLevel<'_, '_> { self.game.ui.rules.bool("spawner_blocks_work") } fn entity_exists(&self, id: &str) -> bool { - self.game.res.mob_types.contains_key(id) || self.game.entity_type_exists(id) + self.game.res.mob_types().contains_key(id) || self.game.entity_type_exists(id) } fn count_entities(&self, id: &str, bounds: Aabb) -> usize { let mobs = self @@ -264,7 +264,7 @@ impl<'a> Game<'a> { /// Creates a mob the spawner accepted, finalized the game's way; the /// caller adds it with [`Game::add_spawned`]. fn finalize_spawned(&self, r: &SpawnRequest, pending: &mut Vec) -> Option { - let kind = self.res.mob_types.get(r.entity)?.clone(); + let kind = self.res.mob_types().get(r.entity)?.clone(); let [x, y, z] = r.position; let mut mob = Mob::new(0, kind, Vec3::new(x, y, z), r.yaw); let facts = self.biome_facts(x.floor() as i32, y.floor() as i32, z.floor() as i32); diff --git a/crates/horizon-client/src/game/nautili.rs b/crates/horizon-client/src/game/nautili.rs index c039b7d9a..e7f16ca18 100644 --- a/crates/horizon-client/src/game/nautili.rs +++ b/crates/horizon-client/src/game/nautili.rs @@ -11,7 +11,7 @@ use horizon_core::random::RandomSource; impl Game<'_> { fn item_tagged(&self, tag: &str, item: &str) -> bool { self.res - .items + .items() .item_tags .get(tag) .is_some_and(|t| t.contains(item)) @@ -43,7 +43,7 @@ impl Game<'_> { } let taming: Vec = self .res - .items + .items() .item_tags .get("minecraft:nautilus_taming_items") .map(|t| t.iter().cloned().collect()) diff --git a/crates/horizon-client/src/game/nether_portal.rs b/crates/horizon-client/src/game/nether_portal.rs index 9ff9e8421..dd51a4cd6 100644 --- a/crates/horizon-client/src/game/nether_portal.rs +++ b/crates/horizon-client/src/game/nether_portal.rs @@ -112,7 +112,7 @@ impl Game<'_> { Dim::Nether }; let state = self.world.block(entry.x, entry.y, entry.z); - let b = &self.res.behaviours; + let b = self.res.behaviours(); let (entry_x_axis, offset) = match b.portal_axis(state) { Some(x_axis) => { let area = largest_rectangle_around( @@ -150,7 +150,7 @@ impl Game<'_> { /// (the points of interest `PortalForcer` searches): loaded chunks as /// they are, the others as saved; chunks never generated have none. fn portal_blocks(&self, center: BlockPos, radius: i32) -> Vec { - let b = &self.res.behaviours; + let b = self.res.behaviours(); let chunk_radius = radius.div_euclid(16) + 1; let (cx, cz) = (center.x >> 4, center.z >> 4); let mut out = Vec::new(); @@ -161,7 +161,7 @@ impl Game<'_> { Some(c) => &**c, None => match self .save - .load(x, z, self.pack.assets.registry, &self.res.biomes) + .load(x, z, self.pack.assets.registry, self.res.biomes()) { Some(c) => { saved = c; @@ -211,7 +211,7 @@ impl Game<'_> { ); if let Some(found) = found { let state = self.world.block(found.x, found.y, found.z); - let x_axis = self.res.behaviours.portal_axis(state).unwrap_or(true); + let x_axis = self.res.behaviours().portal_axis(state).unwrap_or(true); return Some(largest_rectangle_around( found, if x_axis { Axis::X } else { Axis::Z }, @@ -232,7 +232,7 @@ impl Game<'_> { /// `NetherPortalBlock.createDimensionTransition`: the arrival position /// and the yaw turned by. pub(super) fn arrival(&self, plan: &Plan, exit: FoundRectangle) -> (Vec3, f32) { - let b = &self.res.behaviours; + let b = self.res.behaviours(); let corner = exit.min_corner; let exit_x_axis = b .portal_axis(self.world.block(corner.x, corner.y, corner.z)) @@ -537,7 +537,7 @@ impl Game<'_> { |p, _| { if self .res - .behaviours + .behaviours() .portal_axis(self.world.block(p.x, p.y, p.z)) .is_some() { @@ -576,7 +576,7 @@ impl Game<'_> { if count > 64 { return true; } - let behaviours = &self.res.behaviours; + let behaviours = self.res.behaviours(); let chunks = &self.world.chunks; (x0..=x1).any(|cx| { (z0..=z1).any(|cz| { diff --git a/crates/horizon-client/src/game/packs.rs b/crates/horizon-client/src/game/packs.rs index ee026d467..76d136b1c 100644 --- a/crates/horizon-client/src/game/packs.rs +++ b/crates/horizon-client/src/game/packs.rs @@ -131,7 +131,7 @@ impl Game<'_> { root, self.pack.assets.clone(), render, - &self.res.facts, + self.res.facts(), self.pack.context.biomes.clone(), self.pack.context.light.clone(), )?; @@ -167,7 +167,7 @@ impl Game<'_> { // Villager hats come from the pack's texture metadata (shared data, swapped in place). *self .res - .mob_data + .mob_data() .villager_hats .write() .unwrap_or_else(std::sync::PoisonError::into_inner) = diff --git a/crates/horizon-client/src/game/pad.rs b/crates/horizon-client/src/game/pad.rs index 62d481b11..519d53598 100644 --- a/crates/horizon-client/src/game/pad.rs +++ b/crates/horizon-client/src/game/pad.rs @@ -484,7 +484,7 @@ impl Game<'_> { let attacking = match &self.mining { Some(m) if !self.creative => { let state = self.world.block(m.pos[0], m.pos[1], m.pos[2]); - TriggerFeel::Texture(self.res.facts.get(state).hardness) + TriggerFeel::Texture(self.res.facts().get(state).hardness) } _ => TriggerFeel::Free, }; diff --git a/crates/horizon-client/src/game/paintings.rs b/crates/horizon-client/src/game/paintings.rs index 7e80f04d2..87297b8a9 100644 --- a/crates/horizon-client/src/game/paintings.rs +++ b/crates/horizon-client/src/game/paintings.rs @@ -94,7 +94,7 @@ impl Game<'_> { for x in slo[0].floor() as i32..=shi[0].floor() as i32 { for y in slo[1].floor() as i32..=shi[1].floor() as i32 { for z in slo[2].floor() as i32..=shi[2].floor() as i32 { - let f = self.res.facts.get(self.world.block(x, y, z)); + let f = self.res.facts().get(self.world.block(x, y, z)); if !(f.legacy_solid || f.has_class("DiodeBlock")) { return false; } diff --git a/crates/horizon-client/src/game/passengers.rs b/crates/horizon-client/src/game/passengers.rs index 27d8a4af6..4e6ba339d 100644 --- a/crates/horizon-client/src/game/passengers.rs +++ b/crates/horizon-client/src/game/passengers.rs @@ -186,9 +186,9 @@ impl Game<'_> { at[2].floor() as i32, ); let frequent = self.world.chunks.get(&(x >> 4, z >> 4)).is_some_and(|c| { - let b = self.res.biomes.get(c.biome(x, y, z)); + let b = self.res.biomes().get(c.biome(x, y, z)); self.res - .mob_data + .mob_data() .biome_has("minecraft:more_frequent_drowned_spawns", &b.name) }); if frequent { diff --git a/crates/horizon-client/src/game/persist.rs b/crates/horizon-client/src/game/persist.rs index 96d879f13..156ee1859 100644 --- a/crates/horizon-client/src/game/persist.rs +++ b/crates/horizon-client/src/game/persist.rs @@ -208,7 +208,7 @@ impl Game<'_> { fall_distance, damage: horizon_client::falling_block::Damage::from_nbt( &tag, - self.res.facts.get(state).name.ends_with("anvil"), + self.res.facts().get(state).name.ends_with("anvil"), ), saved: uuid.map(|u| Box::new((u, tag.clone()))), }); @@ -297,7 +297,7 @@ impl Game<'_> { self.persist.unknown.entry(key).or_default().push(tag); } } - _ if self.res.mob_types.contains_key(&kind) => { + _ if self.res.mob_types().contains_key(&kind) => { self.load_mob(tag, None); } _ if !kind.is_empty() && entity_nbt::position(&tag).is_some() => { @@ -322,7 +322,7 @@ impl Game<'_> { if let Some(Tag::List(list)) = c.remove(&"Passengers".into()) { for p in list { let known = - entity_nbt::kind(&p).is_some_and(|k| self.res.mob_types.contains_key(&k)); + entity_nbt::kind(&p).is_some_and(|k| self.res.mob_types().contains_key(&k)); if known { riders.push(p); } else { @@ -334,7 +334,7 @@ impl Game<'_> { c.insert("Passengers".into(), Tag::List(unknown)); } } - let mut m = entity_nbt::mob_from_nbt(&tag, &self.res.mob_types, self.next_entity)?; + let mut m = entity_nbt::mob_from_nbt(&tag, self.res.mob_types(), self.next_entity)?; m.extra.mount = mount; m.extra.passenger = mount.is_some(); if finalize { diff --git a/crates/horizon-client/src/game/perspective.rs b/crates/horizon-client/src/game/perspective.rs index 9e5ea9edf..61f58d496 100644 --- a/crates/horizon-client/src/game/perspective.rs +++ b/crates/horizon-client/src/game/perspective.rs @@ -266,7 +266,7 @@ impl Game<'_> { binding: self.collision, subject: None, }, - facts: &self.res.facts, + facts: self.res.facts(), context, }; view.align_with_entity(&entity, partial, kind, |from, to| { @@ -296,7 +296,7 @@ impl Game<'_> { return; }; if self.player_model.is_none() { - let Some(kind) = self.res.player_type.clone() else { + let Some(kind) = self.res.player_type().clone() else { return; }; self.player_model = Some(Mob::new(0, kind, p.position, self.yaw)); @@ -429,7 +429,7 @@ impl Game<'_> { camera, &lookup, packed, - &self.res.mob_data, + self.res.mob_data(), &self.player_armor_layers(), out, ); @@ -484,7 +484,7 @@ impl Game<'_> { camera, &lookup, 240 | 240 << 8, - &self.res.mob_data, + self.res.mob_data(), &self.player_armor_layers(), &mut verts, ); @@ -537,7 +537,7 @@ impl Game<'_> { ) { let Some(asset) = self.armor[1] .as_ref() - .and_then(|s| self.res.items.get(&s.item)) + .and_then(|s| self.res.items().get(&s.item)) .and_then(|i| i.equip_asset.as_ref()) else { return; diff --git a/crates/horizon-client/src/game/piglins.rs b/crates/horizon-client/src/game/piglins.rs index 3515b380b..9df5311aa 100644 --- a/crates/horizon-client/src/game/piglins.rs +++ b/crates/horizon-client/src/game/piglins.rs @@ -11,14 +11,18 @@ use horizon_core::random::RandomSource; impl Game<'_> { fn piglin_loved(&self, item: &str) -> bool { self.res - .items + .items() .item_tags .get("minecraft:piglin_loved") .is_some_and(|t| t.contains(item)) } /// `PiglinAi.isWearingSafeArmor`. pub(super) fn wearing_gold(&self) -> bool { - let tag = self.res.items.item_tags.get("minecraft:piglin_safe_armor"); + let tag = self + .res + .items() + .item_tags + .get("minecraft:piglin_safe_armor"); self.armor .iter() .flatten() @@ -119,7 +123,7 @@ impl Game<'_> { let m = &self.mobs[i]; let from = [m.position.x, m.position.y + 1.3, m.position.z]; let items = if &*item == "minecraft:gold_ingot" && !m.is_baby() { - self.res.items.loot_table( + self.res.items().loot_table( "minecraft:gameplay/piglin_bartering", false, None, @@ -191,7 +195,7 @@ impl Game<'_> { ]; !self .res - .facts + .facts() .get(self.world.block( p[0].floor() as i32, p[1].floor() as i32, @@ -203,7 +207,7 @@ impl Game<'_> { /// Whether breaking or opening this block angers piglins. pub(super) fn guarded_by_piglins(&self, name: &str) -> bool { self.res - .items + .items() .block_tags .get("minecraft:guarded_by_piglins") .is_some_and(|t| t.contains(name)) diff --git a/crates/horizon-client/src/game/potions.rs b/crates/horizon-client/src/game/potions.rs index c360df99f..f60c7c311 100644 --- a/crates/horizon-client/src/game/potions.rs +++ b/crates/horizon-client/src/game/potions.rs @@ -169,7 +169,7 @@ impl Game<'_> { return Ok(false); }; let state = self.world.block(hit.pos[0], hit.pos[1], hit.pos[2]); - if self.res.facts.get(state).fluid != horizon_client::blocks::Fluid::Water { + if self.res.facts().get(state).fluid != horizon_client::blocks::Fluid::Water { return Ok(false); } let at = [ @@ -348,11 +348,11 @@ impl Game<'_> { let armor: Vec> = self.armor.to_vec(); if self.potions.protection_for.as_ref() != Some(&armor) { let mut table = Vec::new(); - let e = &self.res.stations.enchantments; + let e = &self.res.stations().enchantments; let mut random = horizon_core::random::LegacyRandom::new(0); for (_, def) in self.motion.health.damage.entries() { let ctx = horizon_client::enchant::EffectContext { - items: Some(&self.res.items), + items: Some(self.res.items()), damage_type: Some(&def.name), this: Some("minecraft:player"), ..Default::default() @@ -408,7 +408,7 @@ impl Game<'_> { let state = self.world .block(p.x.floor() as i32, p.y.floor() as i32, p.z.floor() as i32); - if self.res.facts.get(state).full_collision + if self.res.facts().get(state).full_collision || self.mobs.iter().any(|m| { m.alive() && (m.position.x - p.x).abs() < m.kind.width / 2.0 + 0.125 @@ -556,7 +556,7 @@ impl Game<'_> { } } // Mobs take the instant effects (undead invert healing and harming). - let undead = &self.res.stations.enchantments.entity_tags; + let undead = &self.res.stations().enchantments.entity_tags; let mut hits = Vec::new(); for (i, m) in self.mobs.iter().enumerate() { let d2 = (m.position.x - at.x).powi(2) diff --git a/crates/horizon-client/src/game/powder_snow.rs b/crates/horizon-client/src/game/powder_snow.rs index 7d0a7770d..6a904706f 100644 --- a/crates/horizon-client/src/game/powder_snow.rs +++ b/crates/horizon-client/src/game/powder_snow.rs @@ -68,7 +68,7 @@ impl Game<'_> { pub(super) fn is_powder_snow(&self, pos: [i32; 3]) -> bool { &*self .res - .facts + .facts() .get(self.world.block(pos[0], pos[1], pos[2])) .name == "minecraft:powder_snow" diff --git a/crates/horizon-client/src/game/raids.rs b/crates/horizon-client/src/game/raids.rs index 63f45c1c5..cc1e9c064 100644 --- a/crates/horizon-client/src/game/raids.rs +++ b/crates/horizon-client/src/game/raids.rs @@ -89,7 +89,7 @@ impl RaidLevel for Lvl<'_, '_> { let w = g.mob_world_base(&[]); spawn_rules::is_spawn_position_ok(Species::Ravager, &w, x, y, z) || w.block_name(x, y - 1, z) == "minecraft:snow" - && g.res.facts.is_air(g.world.block(x, y, z)) + && g.res.facts().is_air(g.world.block(x, y, z)) } fn player(&self) -> Option { let p = self.game.player.as_ref()?; @@ -210,7 +210,7 @@ impl Game<'_> { let top = if self.dim == Dim::Nether { 127 } else { 319 }; (horizon_client::chunk::MIN_Y..=top) .rev() - .find(|&y| !self.res.facts.is_air(self.world.block(x, y, z))) + .find(|&y| !self.res.facts().is_air(self.world.block(x, y, z))) .map_or(horizon_client::chunk::MIN_Y, |y| y + 1) } /// Every claimed village point of interest (job sites, beds, bells). @@ -345,7 +345,7 @@ impl Game<'_> { .get(&(at[0] >> 4, at[2] >> 4)) .map(|c| { self.res - .biomes + .biomes() .get(c.biome(at[0], at[1], at[2])) .name .clone() @@ -705,7 +705,7 @@ impl Game<'_> { leader: bool, reason: raider::Reason, ) -> Option { - let t = self.res.mob_types.get(kind).cloned()?; + let t = self.res.mob_types().get(kind).cloned()?; self.next_entity += 1; let mut mob = Mob::new(self.next_entity, t, Vec3::new(at[0], at[1], at[2]), 0.0); if leader { @@ -971,11 +971,11 @@ impl Game<'_> { for z in c[2] - 64..=c[2] + 64 { for x in c[0] - 64..=c[0] + 64 { let state = self.world.block(x, y, z); - if self.res.facts.is_air(state) { + if self.res.facts().is_air(state) { continue; } let bed = *known.entry(state.0).or_insert_with(|| { - self.res.facts.get(state).name.ends_with("_bed") + self.res.facts().get(state).name.ends_with("_bed") && self.pack.assets.registry.state(state).is_some_and(|s| { s.properties.get("part").map(String::as_str) == Some("head") }) @@ -1110,7 +1110,7 @@ impl Game<'_> { pub(super) fn throw_gift(&mut self, table: &str, from: [f64; 3], to: [f64; 3]) { let drops = self .res - .items + .items() .loot_table(table, false, None, &mut self.world.random); let d = Vec3::new(to[0] - from[0], to[1] - from[1], to[2] - from[2]).normalize(); for stack in drops { @@ -1152,7 +1152,7 @@ impl Game<'_> { .get(&(at[0] >> 4, at[2] >> 4)) .map(|c| { game.res - .biomes + .biomes() .get(c.biome(at[0], at[1], at[2])) .name .clone() diff --git a/crates/horizon-client/src/game/recipe_book.rs b/crates/horizon-client/src/game/recipe_book.rs index e21b3e1bb..e1814006a 100644 --- a/crates/horizon-client/src/game/recipe_book.rs +++ b/crates/horizon-client/src/game/recipe_book.rs @@ -205,7 +205,7 @@ impl Game<'_> { return; } self.ensure_book(); - let index = &self.res.stations.recipe_index; + let index = &self.res.stations().recipe_index; let book = self.recipe_ui.book.as_ref(); // SmithingTrimDemoSlotDisplay draws from a random of its own. let mut random = super::dispenser::entity_random(); @@ -224,8 +224,8 @@ impl Game<'_> { }) .or_else(|| index.result(id).map(|r| ItemStack::new(r, 1))) .or_else(|| { - self.res.stations.recipes.trim_demo( - &self.res.stations.enchantments, + self.res.stations().recipes.trim_demo( + &self.res.stations().enchantments, id, &mut |n| { horizon_core::random::RandomSource::next_int_bound( @@ -275,7 +275,7 @@ impl Game<'_> { /// one goes in id order), then each unlock and removal. fn sync_client_book(&mut self) { let known = &self.level.recipe_book.recipes; - let index = &self.res.stations.recipe_index; + let index = &self.res.stations().recipe_index; let ui = &mut self.recipe_ui; match ui.client_known.as_ref() { Some(previous) if previous == known => return, @@ -305,8 +305,8 @@ impl Game<'_> { } fn ensure_book(&mut self) { if self.recipe_ui.book.is_none() { - let mut book = Book::build(&self.res.recipes, &self.res.items); - book.set_display_ids(&self.res.stations.recipe_index); + let mut book = Book::build(self.res.recipes(), self.res.items()); + book.set_display_ids(&self.res.stations().recipe_index); self.recipe_ui.book = Some(book); } if self.recipe_ui.search.is_none() { @@ -466,7 +466,7 @@ impl Game<'_> { && !book.collection_matches(&c.entries, &query, &|stack| { horizon_client::item_tooltip::lines( stack, - self.res.items.get(&stack.item), + self.res.items().get(&stack.item), &|k| self.pack.names.get(k).map(str::to_owned), ) }) @@ -838,7 +838,7 @@ impl Game<'_> { return; }; let ghost = book - .ghost(entry, book_type, grid, fuel_empty, &self.res.items) + .ghost(entry, book_type, grid, fuel_empty, self.res.items()) .into_iter() .map(|g| Ghost { slot: match (g.target, book_type) { diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index c38b61012..04ee2d286 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -221,12 +221,12 @@ impl Game<'_> { let mut streaming = Streaming::new( Arc::new(NoTerrain), self.pack.context.clone(), - self.res.threads, + self.res.threads(), ); streaming.remote = true; streaming.radius = self.settings.render_distance; self.streaming = streaming; - self.world = World::new(self.res.facts.air, 0); + self.world = World::new(self.res.facts().air, 0); self.save = Arc::new(SaveDir::new( std::env::temp_dir().join("horizon-remote-unused"), )); @@ -351,7 +351,7 @@ impl Game<'_> { self.score.board = Default::default(); self.streaming = Streaming::new(Arc::new(NoTerrain), self.pack.context.clone(), 1); self.streaming.paused = true; - self.world = World::new(self.res.facts.air, 0); + self.world = World::new(self.res.facts().air, 0); self.player = None; self.mobs.clear(); self.dropped.clear(); @@ -543,7 +543,7 @@ impl Game<'_> { .get("minecraft:worldgen/biome") .map(|list| { list.iter() - .map(|(name, _)| self.res.biomes.id(name)) + .map(|(name, _)| self.res.biomes().id(name)) .collect() }) .unwrap_or_default(); @@ -570,7 +570,7 @@ impl Game<'_> { let mut streaming = Streaming::new( Arc::new(NoTerrain), self.pack.context.clone(), - self.res.threads, + self.res.threads(), ); streaming.remote = true; streaming.radius = self.streaming.radius; @@ -580,7 +580,7 @@ impl Game<'_> { self.world.day_time, self.world.weather, ); - self.world = World::new(self.res.facts.air, spawn.seed); + self.world = World::new(self.res.facts().air, spawn.seed); self.world.game_time = time; self.world.day_time = day; self.world.weather = weather; @@ -814,7 +814,7 @@ impl Game<'_> { } /// Keep the renderable block entities (chests, furnaces) in step with blocks. fn sync_block_entity(&mut self, pos: (i32, i32, i32), state: BlockStateId) { - let name = self.res.facts.get(state).name.clone(); + let name = self.res.facts().get(state).name.clone(); match BlockEntity::for_block(&name) { Some(entity) => { let same = self @@ -877,9 +877,9 @@ impl Game<'_> { // A block we just placed: play its place sound (the server skips the placer). if let Some((target, _)) = self.remote.as_ref().and_then(|r| r.placing) && target == pos - && !self.res.facts.is_air(state) + && !self.res.facts().is_air(state) { - let s = self.res.facts.get(state).sounds.clone(); + let s = self.res.facts().get(state).sounds.clone(); let at = [ f64::from(pos[0]) + 0.5, f64::from(pos[1]) + 0.5, @@ -897,7 +897,7 @@ impl Game<'_> { let mob_type = if kind == "minecraft:player" { self.remote.as_ref().and_then(|r| r.player_type.clone()) } else { - self.res.mob_types.get(kind).cloned() + self.res.mob_types().get(kind).cloned() }; if let Some(t) = mob_type { let mut mob = Mob::new(id as u32, t, at, head); @@ -1144,7 +1144,7 @@ impl Game<'_> { // shulker boxes, bells) when the block is still the one it names. C::BlockEvent(p) => { let state = self.world.block(p.pos[0], p.pos[1], p.pos[2]); - let block = &self.res.facts.get(state).name; + let block = &self.res.facts().get(state).name; let named = self.remote.as_ref().and_then(|r| { r.builtin .get("minecraft:block")? @@ -1161,7 +1161,7 @@ impl Game<'_> { C::LevelEvent(p) if p.kind == 2001 => { // LevelEvent.PARTICLES_DESTROY_BLOCK: someone else broke a block. let state = BlockStateId(p.data.max(0) as u32); - let s = self.res.facts.get(state).sounds.clone(); + let s = self.res.facts().get(state).sounds.clone(); let at = [ f64::from(p.pos[0]) + 0.5, f64::from(p.pos[1]) + 0.5, @@ -2223,7 +2223,7 @@ impl Game<'_> { horizon_client::motion::MotionEvent::Emission { state, in_water, .. } if !crouching => { - let sounds = self.res.facts.get(state).sounds.clone(); + let sounds = self.res.facts().get(state).sounds.clone(); // Player.playStepSound: muffled under the swim sound in water. let (volume, pitch) = if in_water { (sounds.volume * 0.05, sounds.pitch * 0.8) @@ -2456,7 +2456,7 @@ impl Game<'_> { }; let face = face_direction(hit.face); let state = self.world.block(hit.pos[0], hit.pos[1], hit.pos[2]); - if self.res.facts.is_air(state) { + if self.res.facts().is_air(state) { return; } if self.remote.as_ref().is_some_and(|r| r.destroy_delay > 0) { @@ -2478,14 +2478,17 @@ impl Game<'_> { } return; } - let facts = self.res.facts.get(state).clone(); + let facts = self.res.facts().get(state).clone(); let held = self.held().cloned(); - let mut speed = self.res.items.mining_speed(held.as_ref(), &facts.name); + let mut speed = self.res.items().mining_speed(held.as_ref(), &facts.name); if self.player.as_ref().is_some_and(|p| !p.ground.on_ground) { speed /= 5.0; } - let harvest = - !facts.requires_tool || self.res.items.correct_for_drops(held.as_ref(), &facts.name); + let harvest = !facts.requires_tool + || self + .res + .items() + .correct_for_drops(held.as_ref(), &facts.name); let progress = if facts.hardness < 0.0 { 0.0 } else if facts.hardness == 0.0 { @@ -2592,7 +2595,7 @@ impl Game<'_> { .and_modify(|p| p.0 = sequence) .or_insert((sequence, state.0 as i32)); } - let s = self.res.facts.get(state).sounds.clone(); + let s = self.res.facts().get(state).sounds.clone(); let at = [ f64::from(pos[0]) + 0.5, f64::from(pos[1]) + 0.5, @@ -2616,7 +2619,7 @@ impl Game<'_> { fn remote_use(&mut self) { let held_block = self .held() - .and_then(|h| self.res.items.get(&h.item)) + .and_then(|h| self.res.items().get(&h.item)) .is_some_and(|i| i.block.is_some()); let sneaking = self.keys.contains(&KeyCode::ShiftLeft); // Entities first (interact), like the hit result order. @@ -3136,7 +3139,7 @@ impl Game<'_> { // an ender chest's or a double chest's slots are no one block's, // so they go under a key no block has. let holds = |k: &(i32, i32, i32)| { - let name = &self.res.facts.get(self.world.block(k.0, k.1, k.2)).name; + let name = &self.res.facts().get(self.world.block(k.0, k.1, k.2)).name; BlockEntity::for_block(name).is_some_and(|e| { e.id() == entity.id() && e.slots().len() == entity.slots().len() }) diff --git a/crates/horizon-client/src/game/render_control.rs b/crates/horizon-client/src/game/render_control.rs index 10add4668..dd9dadd30 100644 --- a/crates/horizon-client/src/game/render_control.rs +++ b/crates/horizon-client/src/game/render_control.rs @@ -119,7 +119,7 @@ impl Game<'_> { let key = (int(1)?, int(2)?, int(3)?); let name = self .res - .facts + .facts() .get(self.world.block(key.0, key.1, key.2)) .name .clone(); diff --git a/crates/horizon-client/src/game/render_tick.rs b/crates/horizon-client/src/game/render_tick.rs index 2024657b0..103cb26c9 100644 --- a/crates/horizon-client/src/game/render_tick.rs +++ b/crates/horizon-client/src/game/render_tick.rs @@ -66,15 +66,15 @@ impl Game<'_> { ) -> FogData { let forward = self.forward(); let at = [camera.x, camera.y, camera.z]; - let fog_type = fog_type(&self.world, &self.res.facts, at, forward); - let water = self.res.biomes.get(biome).water_fog; + let fog_type = fog_type(&self.world, self.res.facts(), at, forward); + let water = self.res.biomes().get(biome).water_fog; let (rain, thunder) = if self.dim == Dim::Overworld { self.world.weather.levels(self.clock.fraction() as f32) } else { (0.0, 0.0) }; horizon_client::fog::setup_fog( - &self.res.fog, + self.res.fog(), &self.fog, &FogInputs { fog_type, @@ -117,7 +117,7 @@ impl Game<'_> { horizon_client::gfx::ShaderInputs { rain, thunder, - submerged: match fog_type(&self.world, &self.res.facts, at, self.forward()) { + submerged: match fog_type(&self.world, self.res.facts(), at, self.forward()) { FogType::Atmospheric => 0, FogType::Water => 1, FogType::Lava => 2, @@ -139,7 +139,7 @@ impl Game<'_> { camera.y < 63.0 && fog_type( &self.world, - &self.res.facts, + self.res.facts(), [camera.x, camera.y, camera.z], self.forward(), ) != FogType::Water @@ -170,7 +170,7 @@ impl Game<'_> { t[1].floor() as i32, t[2].floor() as i32, ); - let f = self.res.facts.get(state); + let f = self.res.facts().get(state); if f.render_shape != horizon_client::blocks::RenderShape::Invisible && f.solid_render && f.full_collision @@ -180,7 +180,7 @@ impl Game<'_> { } } let in_water = - fog_type(&self.world, &self.res.facts, eye, self.forward()) == FogType::Water; + fog_type(&self.world, self.res.facts(), eye, self.forward()) == FogType::Water; let water = (in_water && !spectator).then(|| (self.eye_brightness(eye), self.yaw, self.pitch)); // Hud.extractCameraOverlays; the spyglass scope (and its easing) is @@ -243,7 +243,7 @@ impl Game<'_> { self.screen_fx.tick(brightness, inside_portal); // LocalPlayer water vision and AtmosphericFogEnvironment rain fog. let in_water = - fog_type(&self.world, &self.res.facts, e, self.forward()) == FogType::Water; + fog_type(&self.world, self.res.facts(), e, self.forward()) == FogType::Water; self.fog.tick(in_water); let b = [ e[0].floor() as i32, @@ -260,7 +260,7 @@ impl Game<'_> { .chunks .get(&(b[0] >> 4, b[2] >> 4)) .map_or(0, |c| c.biome(b[0], b[1], b[2])); - let rains = self.res.biomes.get(biome).precipitation; + let rains = self.res.biomes().get(biome).precipitation; update_rain_fog( &mut self.fog, rain, @@ -278,8 +278,8 @@ impl Game<'_> { (0.0, 0.0) }; let world = &self.world; - let facts = &self.res.facts; - let biomes = &self.res.biomes; + let facts = self.res.facts(); + let biomes = self.res.biomes(); let raining = rain > 0.2; let raining_at = |p: [i32; 3]| { raining @@ -300,7 +300,7 @@ impl Game<'_> { e[1].floor() as i32, e[2].floor() as i32, ]; - animate_tick(&self.res.animate, &mut self.particles, &ctx, block); + animate_tick(self.res.animate(), &mut self.particles, &ctx, block); if rain > 0.0 { // ClientLevel.tickWeatherEffects: rain splashes (weather radius 10). let mut random = LegacyRandom::new(self.world.game_time.wrapping_mul(312_987_231)); @@ -336,7 +336,7 @@ impl Game<'_> { let smoke = f.fluid == Fluid::Lava || &*f.name == "minecraft:magma_block" || (f.name.ends_with("campfire") - && self.res.animate.is_lit_campfire(state.0)); + && self.res.animate().is_lit_campfire(state.0)); let ty = if smoke { ParticleType::Smoke } else { @@ -354,7 +354,7 @@ impl Game<'_> { } if let Some(r) = &self.renderer { campfire_particles( - &self.res.animate, + self.res.animate(), &mut self.particles, &ctx, r.block_entities(), diff --git a/crates/horizon-client/src/game/respawn_anchor.rs b/crates/horizon-client/src/game/respawn_anchor.rs index 5a31dfd5c..58a8d7aac 100644 --- a/crates/horizon-client/src/game/respawn_anchor.rs +++ b/crates/horizon-client/src/game/respawn_anchor.rs @@ -63,7 +63,7 @@ pub(super) enum AnchorUse { impl Game<'_> { fn is_anchor(&self, state: BlockStateId) -> bool { - &*self.res.facts.get(state).name == "minecraft:respawn_anchor" + &*self.res.facts().get(state).name == "minecraft:respawn_anchor" } fn anchor_charges(&self, state: BlockStateId) -> i32 { self.pack @@ -177,7 +177,7 @@ impl Game<'_> { } /// `RespawnAnchorBlock.isWaterThatWouldFlow`. fn water_would_flow(&self, p: [i32; 3]) -> bool { - let f = self.res.facts.get(self.world.block(p[0], p[1], p[2])); + let f = self.res.facts().get(self.world.block(p[0], p[1], p[2])); if f.fluid != Fluid::Water { return false; } @@ -188,7 +188,7 @@ impl Game<'_> { return false; } self.res - .facts + .facts() .get(self.world.block(p[0], p[1] - 1, p[2])) .fluid != Fluid::Water @@ -203,7 +203,7 @@ impl Game<'_> { .any(|d| self.water_would_flow([pos[0] + d[0], pos[1], pos[2] + d[2]])); let above = self .res - .facts + .facts() .get(self.world.block(pos[0], pos[1] + 1, pos[2])) .fluid == Fluid::Water; @@ -225,7 +225,7 @@ impl Game<'_> { /// halves and explodes; `StrawBedBlock` just falls apart. pub(super) fn destroy_bed_on_use(&mut self, head: [i32; 3]) -> Result<()> { let state = self.world.block(head[0], head[1], head[2]); - let name = self.res.facts.get(state).name.clone(); + let name = self.res.facts().get(state).name.clone(); let center = [ f64::from(head[0]) + 0.5, f64::from(head[1]) + 0.5, @@ -259,7 +259,7 @@ impl Game<'_> { let foot = [head[0] + back[0], head[1], head[2] + back[2]]; if self .res - .facts + .facts() .get(self.world.block(foot[0], foot[1], foot[2])) .name == name @@ -297,7 +297,7 @@ impl Game<'_> { /// climbable blocks and open trapdoors. fn non_climbable_shape(&self, p: [i32; 3]) -> VoxelShape { let state = self.world.block(p[0], p[1], p[2]); - let name = &self.res.facts.get(state).name; + let name = &self.res.facts().get(state).name; let open_trapdoor = name.ends_with("_trapdoor") && self .pack @@ -326,7 +326,7 @@ impl Game<'_> { } fn block_in_tag(&self, tag: &str, block: &str) -> bool { self.res - .items + .items() .block_tags .get(tag) .is_some_and(|s| s.contains(block)) @@ -334,7 +334,7 @@ impl Game<'_> { /// `EntityType.isBlockDangerous` for the player. fn dangerous_for_player(&self, p: [i32; 3]) -> bool { let state = self.world.block(p[0], p[1], p[2]); - let name = &*self.res.facts.get(state).name; + let name = &*self.res.facts().get(state).name; let lit_campfire = (name == "minecraft:campfire" || name == "minecraft:soul_campfire") && self .pack @@ -397,7 +397,7 @@ impl Game<'_> { } let name = |q: [i32; 3]| { self.res - .facts + .facts() .get(self.world.block(q[0], q[1], q[2])) .name .clone() diff --git a/crates/horizon-client/src/game/sculk.rs b/crates/horizon-client/src/game/sculk.rs index 567ac29a1..c502315c1 100644 --- a/crates/horizon-client/src/game/sculk.rs +++ b/crates/horizon-client/src/game/sculk.rs @@ -266,7 +266,7 @@ impl Game<'_> { let n = registry.len(); let tag = |name: &str| { self.res - .items + .items() .block_tags .get(name) .cloned() @@ -285,7 +285,7 @@ impl Game<'_> { resonator: vec![false; n], }; for i in 0..n { - let facts = self.res.facts.get(BlockStateId(i as u32)); + let facts = self.res.facts().get(BlockStateId(i as u32)); let name: &str = &facts.name; t.kinds[i] = match name { "minecraft:sculk_sensor" => KIND_SENSOR, @@ -603,7 +603,7 @@ impl Game<'_> { }; !own && !calibrated_out && frequency != 0 - && self.res.behaviours.sculk_sensor_can_activate(state) + && self.res.behaviours().sculk_sensor_can_activate(state) } SculkKind::Shrieker => !self.shrieker_shrieking(state) && ctx.player, SculkKind::Catalyst => false, @@ -764,7 +764,7 @@ impl Game<'_> { match kind { SculkKind::Sensor | SculkKind::Calibrated => { let state = self.world.block(key.0, key.1, key.2); - if self.res.behaviours.sculk_sensor_can_activate(state) { + if self.res.behaviours().sculk_sensor_can_activate(state) { let frequency = sculk::frequency(info.event); if let Some(e) = self.sculk_entity(key) { e.last_frequency = frequency; @@ -854,7 +854,7 @@ impl Game<'_> { if self.mobs.iter().any(|m| m.id == id && m.species() == Species::Warden)); match self.kind_of_state(state.0) { KIND_SENSOR | KIND_CALIBRATED => { - if is_warden || !self.res.behaviours.sculk_sensor_can_activate(state) { + if is_warden || !self.res.behaviours().sculk_sensor_can_activate(state) { continue; } let calibrated = self.kind_of_state(state.0) == KIND_CALIBRATED; @@ -997,7 +997,7 @@ impl Game<'_> { if warning < 4 { return false; } - let Some(kind) = self.res.mob_types.get("minecraft:warden").cloned() else { + let Some(kind) = self.res.mob_types().get("minecraft:warden").cloned() else { return false; }; for _ in 0..20 { @@ -1040,7 +1040,7 @@ impl Game<'_> { /// `SpawnUtil.moveToPossibleSpawnPosition` with `ON_TOP_OF_COLLIDER`. fn spawn_position(&self, x: i32, y: i32, z: i32, range: i32) -> Option<(i32, i32, i32)> { use horizon_client::mobs::data; - let flags = |b: BlockStateId| self.res.mob_data.state(b); + let flags = |b: BlockStateId| self.res.mob_data().state(b); let mut search = y; let mut above = self.world.block(x, search, z); for _ in (-range..=range).rev() { @@ -1159,7 +1159,7 @@ impl Game<'_> { && let Some(eye) = self.eye_position() { let in_water = - horizon_client::fog::fog_type(&self.world, &self.res.facts, eye, self.forward()) + horizon_client::fog::fog_type(&self.world, self.res.facts(), eye, self.forward()) == FogType::Water; return self.fog.water_vision(in_water); } @@ -1321,7 +1321,7 @@ impl Game<'_> { .play("minecraft:block.sculk.charge", Some(c), 1.0, 1.0); let solid = self .res - .facts + .facts() .get(self.world.block(pos.x, pos.y, pos.z)) .full_collision; let (particles, spread) = if solid { (40, 0.45f32) } else { (20, 0.25f32) }; @@ -1529,7 +1529,8 @@ impl Game<'_> { at[1].floor() as i32, at[2].floor() as i32, ); - self.res.facts.get(self.world.block(x, y, z)).fluid == horizon_client::blocks::Fluid::Water + self.res.facts().get(self.world.block(x, y, z)).fluid + == horizon_client::blocks::Fluid::Water } /// `Entity.move`'s emission: footsteps, swimming, landing and splashes. fn entity_motion_events( @@ -1576,13 +1577,13 @@ impl Game<'_> { at[2].floor() as i32, ); let state = self.world.block(block.0, block.1, block.2); - let air = self.res.facts.is_air(state); + let air = self.res.facts().is_air(state); let climbable = self .res - .items + .items() .block_tags .get("minecraft:climbable") - .is_some_and(|t| t.contains(&*self.res.facts.get(state).name)); + .is_some_and(|t| t.contains(&*self.res.facts().get(state).name)); let travelled = if climbable { ((dx * dx + dy * dy + dz * dz).sqrt() * f64::from(0.6f32)) as f32 } else { diff --git a/crates/horizon-client/src/game/sculk_fixture.rs b/crates/horizon-client/src/game/sculk_fixture.rs index 2ebdbcb2b..b57f559b6 100644 --- a/crates/horizon-client/src/game/sculk_fixture.rs +++ b/crates/horizon-client/src/game/sculk_fixture.rs @@ -303,8 +303,8 @@ impl Game<'_> { } fn sculk_fixture_reset(&mut self, s: &Scenario) -> Result<()> { - self.world = World::new(self.res.facts.air, 0); - let plains = u32::from(self.res.biomes.id("minecraft:plains")); + self.world = World::new(self.res.facts().air, 0); + let plains = u32::from(self.res.biomes().id("minecraft:plains")); let layers = [ self.fixture_state("minecraft:bedrock")?, self.fixture_state("minecraft:dirt")?, @@ -439,7 +439,7 @@ impl Game<'_> { for spec in &s.mobs { let kind = self .res - .mob_types + .mob_types() .get(&spec.kind) .cloned() .ok_or_else(|| format!("unknown mob {}", spec.kind))?; diff --git a/crates/horizon-client/src/game/shield.rs b/crates/horizon-client/src/game/shield.rs index 849c62958..c4f7f98d1 100644 --- a/crates/horizon-client/src/game/shield.rs +++ b/crates/horizon-client/src/game/shield.rs @@ -34,7 +34,7 @@ impl Game<'_> { &self, stack: &ItemStack, ) -> Option<&horizon_client::items::BlocksAttacks> { - self.res.items.get(&stack.item)?.blocks_attacks.as_ref() + self.res.items().get(&stack.item)?.blocks_attacks.as_ref() } /// `ShieldItem.use` (ItemUtils.startUsingInstantly) for the hand at `slot`; /// false when that hand holds no blocking item or it is on cooldown. @@ -64,7 +64,7 @@ impl Game<'_> { if (ticks as i32) < (component.delay_seconds * 20.0).round() as i32 { return None; } - let tags = &self.res.stations.enchantments.damage_tags; + let tags = &self.res.stations().enchantments.damage_tags; let matches = |spec: &str| match spec.strip_prefix('#') { Some(tag) => tags.get(tag).is_some_and(|t| t.contains(damage_type)), None => spec == damage_type, @@ -150,7 +150,11 @@ impl Game<'_> { }; if item_damage > 0 && !self.creative { let loss = self.durability_loss(&stack, item_damage as u32); - let max = self.res.items.get(&stack.item).map_or(0, |i| i.max_damage); + let max = self + .res + .items() + .get(&stack.item) + .map_or(0, |i| i.max_damage); let cell = self.stack_in_mut(slot); if let Some(s) = cell.as_mut() && max > 0 @@ -182,7 +186,7 @@ impl Game<'_> { .extra .main_hand .as_deref() - .and_then(|item| self.res.items.get(item)) + .and_then(|item| self.res.items().get(item)) .map_or(0.0, |i| i.disable_blocking_seconds); // Ravager.blockedByItem: stunned half the time (the defender pushed // apart), else the defender flung away; no roar in progress. diff --git a/crates/horizon-client/src/game/sign_edit.rs b/crates/horizon-client/src/game/sign_edit.rs index 0804de6be..c679bad69 100644 --- a/crates/horizon-client/src/game/sign_edit.rs +++ b/crates/horizon-client/src/game/sign_edit.rs @@ -175,7 +175,7 @@ impl Game<'_> { batch.text(atlas, title, (w - tw) / 2.0, 40.0, u32::MAX, true); let name = self .res - .facts + .facts() .get(self.world.block(edit.pos.0, edit.pos.1, edit.pos.2)) .name .clone(); diff --git a/crates/horizon-client/src/game/sniffers.rs b/crates/horizon-client/src/game/sniffers.rs index 61325ede6..a30c0ba5c 100644 --- a/crates/horizon-client/src/game/sniffers.rs +++ b/crates/horizon-client/src/game/sniffers.rs @@ -93,7 +93,7 @@ impl Game<'_> { self.particles.push(particle); } if self.mobs[i].age.is_multiple_of(10) { - let hit = self.res.facts.get(below).sounds.hit.clone(); + let hit = self.res.facts().get(below).sounds.hit.clone(); self.audio.play(&hit, Some(at), 0.5, 0.5); } } diff --git a/crates/horizon-client/src/game/spawner.rs b/crates/horizon-client/src/game/spawner.rs index 66a365835..f7c4b9c54 100644 --- a/crates/horizon-client/src/game/spawner.rs +++ b/crates/horizon-client/src/game/spawner.rs @@ -75,7 +75,7 @@ impl Game<'_> { .collect(); for key in &keys { let state = self.world.block(key.0, key.1, key.2); - if &*self.res.facts.get(state).name != "minecraft:spawner" { + if &*self.res.facts().get(state).name != "minecraft:spawner" { continue; } let Some(BlockEntity::Spawner(mut spawner)) = self.world.block_entities.remove(key) @@ -151,7 +151,7 @@ impl Game<'_> { r: &SpawnerSpawn, planned: &mut Vec, ) -> Option { - let kind = self.res.mob_types.get(r.id)?.clone(); + let kind = self.res.mob_types().get(r.id)?.clone(); let [x, y, z] = r.position; let at = Vec3::new(x, y, z); let bounds = if r.finalize { @@ -201,7 +201,7 @@ impl Game<'_> { tag.insert("PersistenceRequired".into(), Tag::Byte(1)); } let tag = Tag::Compound(tag); - let mob = horizon_client::entity_nbt::mob_from_nbt(&tag, &self.res.mob_types, 0)?; + let mob = horizon_client::entity_nbt::mob_from_nbt(&tag, self.res.mob_types(), 0)?; let bounds = mob.bounds(); planned.push(Planned::Loaded(tag)); bounds @@ -337,7 +337,7 @@ impl Game<'_> { .get(&key) .is_none_or(|(k, _)| *k != kind) { - let Some(t) = self.res.mob_types.get(&kind).cloned() else { + let Some(t) = self.res.mob_types().get(&kind).cloned() else { return false; }; let mob = Mob::new(u32::MAX, t, Vec3::ZERO, 0.0); @@ -357,7 +357,7 @@ impl Game<'_> { } _ => return None, }; - self.res.mob_types.contains_key(&id).then_some(id) + self.res.mob_types().contains_key(&id).then_some(id) } /// `SpawnEggItem.useOn` on a spawner: the egg sets its mob. None when the /// clicked block has no spawner. @@ -442,7 +442,7 @@ impl Game<'_> { origin, &lookup, packed, - &self.res.mob_data, + self.res.mob_data(), out, ); } diff --git a/crates/horizon-client/src/game/station_control.rs b/crates/horizon-client/src/game/station_control.rs index 680939a4f..75ad9225e 100644 --- a/crates/horizon-client/src/game/station_control.rs +++ b/crates/horizon-client/src/game/station_control.rs @@ -126,7 +126,7 @@ impl Game<'_> { "enchant" => { let e = id(arg(1)?); let level: u32 = arg(2)?.parse()?; - if self.res.stations.enchantments.get(&e).is_none() { + if self.res.stations().enchantments.get(&e).is_none() { return Err(format!("unknown enchantment {e}").into()); } let held = self.inventory[self.selected] diff --git a/crates/horizon-client/src/game/stations.rs b/crates/horizon-client/src/game/stations.rs index 161c8c556..33b2c6804 100644 --- a/crates/horizon-client/src/game/stations.rs +++ b/crates/horizon-client/src/game/stations.rs @@ -263,7 +263,7 @@ fn argb(c: i32) -> u32 { impl Game<'_> { fn data(&self) -> &stations::StationData { - &self.res.stations + self.res.stations() } pub(super) fn translate(&self, key: &str, fallback: &str) -> String { self.data() @@ -376,9 +376,13 @@ impl Game<'_> { } } fn count_bookshelves(&self, pos: [i32; 3]) -> i32 { - let tags = &self.res.items.block_tags; + let tags = &self.res.items().block_tags; let is = |p: [i32; 3], tag: &str| { - let name = &self.res.facts.get(self.world.block(p[0], p[1], p[2])).name; + let name = &self + .res + .facts() + .get(self.world.block(p[0], p[1], p[2])) + .name; tags.get(tag).is_some_and(|t| t.contains(&**name)) }; stations::bookshelf_offsets() @@ -412,8 +416,8 @@ impl Game<'_> { return; }; let creative = self.creative; - let data = &self.res.stations; - let items = &self.res.items; + let data = self.res.stations(); + let items = self.res.items(); match s.kind { Kind::Enchanting => { s.bookcases = self.count_bookshelves(s.pos); @@ -494,7 +498,10 @@ impl Game<'_> { self.station = Some(s); } pub(super) fn max_stack(&self, stack: &ItemStack) -> u32 { - self.res.items.get(&stack.item).map_or(64, |i| i.max_stack) + self.res + .items() + .get(&stack.item) + .map_or(64, |i| i.max_stack) } /// `Slot.mayPlace` and `getMaxStackSize` for station and brewing slots. fn slot_rules(&self, slot: usize, stack: &ItemStack) -> (bool, u32) { @@ -518,7 +525,7 @@ impl Game<'_> { 3 => (data.brewing.is_reagent(stack), 64), _ => ( self.res - .items + .items() .get(&stack.item) .is_some_and(|i| i.brewing_fuel.is_some()), 64, @@ -548,7 +555,7 @@ impl Game<'_> { 64, ), Kind::Enchanting => (&*stack.item == "minecraft:lapis_lazuli", 64), - Kind::Grindstone => (stations::grindstone_accepts(&self.res.items, stack), 64), + Kind::Grindstone => (stations::grindstone_accepts(self.res.items(), stack), 64), Kind::Smithing => (data.recipes.smithing_accepts(i, stack), 64), _ => (true, 64), } @@ -667,7 +674,7 @@ impl Game<'_> { let data = self.data(); let fuel = self .res - .items + .items() .get(&stack.item) .is_some_and(|i| i.brewing_fuel.is_some()); let (reagent, bottle) = ( @@ -818,7 +825,7 @@ impl Game<'_> { if !self.creative && self.world.random.next_float() < 0.12 { // AnvilBlock.damage let state = self.world.block(pos[0], pos[1], pos[2]); - let name = self.res.facts.get(state).name.clone(); + let name = self.res.facts().get(state).name.clone(); let next = match &*name { "minecraft:anvil" => Some("minecraft:chipped_anvil"), "minecraft:chipped_anvil" => Some("minecraft:damaged_anvil"), @@ -848,7 +855,7 @@ impl Game<'_> { let (a, b) = (s.inputs[0].take(), s.inputs[1].take()); let mut random = LegacyRandom::new(self.world.random.next_long()); let xp = stations::grindstone_experience( - &self.res.stations.enchantments, + &self.res.stations().enchantments, &mut random, a.as_ref(), b.as_ref(), @@ -945,7 +952,7 @@ impl Game<'_> { Some(c) if c.same_item_same_components(&result) && c.count + result.count - <= self.res.items.get(&c.item).map_or(64, |i| i.max_stack) => + <= self.res.items().get(&c.item).map_or(64, |i| i.max_stack) => { c.count += result.count } @@ -988,8 +995,8 @@ impl Game<'_> { return; } let Some(enchanted) = stations::apply_enchantment( - &self.res.stations.enchantments, - &self.res.items, + &self.res.stations().enchantments, + self.res.items(), self.level.xp_seed, button, cost, @@ -1566,7 +1573,7 @@ impl Game<'_> { if inside(local, bx, by, bw, 17.0) && let Some((id, l)) = &offers.clues[i] { - let e = &self.res.stations.enchantments; + let e = &self.res.stations().enchantments; let (name, _) = e.full_name(id, *l); let clue = self .translate("container.enchant.clue", "%s . . . ?") @@ -1766,7 +1773,7 @@ impl Game<'_> { i, ItemStack { count: 1, - ..self.res.stations.recipes.stonecutting[s.recipes[i]] + ..self.res.stations().recipes.stonecutting[s.recipes[i]] .result .clone() }, @@ -1858,7 +1865,7 @@ impl Game<'_> { /// `ItemStack.getTooltipLines` subset: name in rarity colour, potion /// effects, enchantments (gray, curses red), stored enchantments, trims. pub(super) fn stack_tooltip(&self, stack: &ItemStack) -> Vec<(String, u32)> { - let e: &Enchantments = &self.res.stations.enchantments; + let e: &Enchantments = &self.res.stations().enchantments; let props = e.props(&stack.item); let rarity = horizon_client::item_tooltip::rarity( stack, @@ -1945,7 +1952,7 @@ impl Game<'_> { } // BannerPatternLayers.addToTooltip: up to six layer names. for layer in horizon_client::banner::tooltip_layers(stack).iter().take(6) { - let key = self.res.stations.banners.layer_key(layer); + let key = self.res.stations().banners.layer_key(layer); lines.push((self.translate(&key, &key), rgba(170, 170, 170, 255))); } // Spawner.appendHoverText: what a spawner or trial spawner item spawns. @@ -1969,7 +1976,7 @@ impl Game<'_> { } } } - if let Some(info) = self.res.items.get(&stack.item) { + if let Some(info) = self.res.items().get(&stack.item) { let base = |name: &str, default| { self.player .as_ref() @@ -1997,7 +2004,7 @@ impl Game<'_> { &translate, )); } - if let Some(info) = self.res.items.get(&stack.item) + if let Some(info) = self.res.items().get(&stack.item) && info.max_damage > 0 && stack.damage > 0 && self.options_advanced_tooltips() @@ -2039,7 +2046,7 @@ impl Game<'_> { _ => serde_json::Value::Null, }; }; - let recipes = &self.res.stations.recipes.stonecutting; + let recipes = &self.res.stations().recipes.stonecutting; serde_json::json!({ "costs": s.offers.costs, "clues": s.offers.clues.iter().map(|c| c.as_ref().map(|(e, l)| format!("{e} {l}"))).collect::>(), @@ -2150,9 +2157,9 @@ impl Game<'_> { for (pos, entity) in self.world.block_entities.iter_mut() { if let BlockEntity::Brewing(b) = entity { let out = b.tick( - &self.res.stations.brewing, - &self.res.items, - &self.res.providers, + &self.res.stations().brewing, + self.res.items(), + self.res.providers(), ); if out != brewing::BrewTick::default() { changes.push((*pos, out)); diff --git a/crates/horizon-client/src/game/stats.rs b/crates/horizon-client/src/game/stats.rs index c36b99eaa..8f642d97a 100644 --- a/crates/horizon-client/src/game/stats.rs +++ b/crates/horizon-client/src/game/stats.rs @@ -216,14 +216,14 @@ impl Game<'_> { p.position.y.floor() as i32, p.position.z.floor() as i32, ]; - let eye_in_water = self.res.facts.get(self.world.block( + let eye_in_water = self.res.facts().get(self.world.block( feet[0], (p.position.y + f64::from(p.dimensions.eye_height)).floor() as i32, feet[2], )); let in_water = self .res - .facts + .facts() .get(self.world.block(feet[0], feet[1], feet[2])) .fluid == horizon_client::blocks::Fluid::Water; @@ -317,7 +317,11 @@ impl Game<'_> { pos[1] + 20 + r.next_int_bound(15).unwrap_or(0), pos[2] - 10 + r.next_int_bound(21).unwrap_or(10), ]; - if !self.res.facts.is_air(self.world.block(at[0], at[1], at[2])) { + if !self + .res + .facts() + .is_air(self.world.block(at[0], at[1], at[2])) + { return; } let group = 1 + self.world.random.next_int_bound(3).unwrap_or(0); @@ -335,7 +339,7 @@ impl Game<'_> { } fn can_see_sky(&self, pos: [i32; 3]) -> bool { (pos[1] + 1..pos[1] + 256).all(|y| { - let f = self.res.facts.get(self.world.block(pos[0], y, pos[2])); + let f = self.res.facts().get(self.world.block(pos[0], y, pos[2])); !f.full_collision && f.fluid == horizon_client::blocks::Fluid::None }) } diff --git a/crates/horizon-client/src/game/stats_screen.rs b/crates/horizon-client/src/game/stats_screen.rs index 1221cd175..5505d423d 100644 --- a/crates/horizon-client/src/game/stats_screen.rs +++ b/crates/horizon-client/src/game/stats_screen.rs @@ -347,8 +347,12 @@ impl Game<'_> { }; for (c, (ty, _)) in COLUMNS.iter().enumerate() { let x = left + 75.0 + 40.0 * c as f32; - let block = - c == 0 && self.res.items.get(item).is_some_and(|i| i.block.is_some()); + let block = c == 0 + && self + .res + .items() + .get(item) + .is_some_and(|i| i.block.is_some()); let text = if c == 0 && !block { Text::translate("stats.none", &[]).plain() } else { diff --git a/crates/horizon-client/src/game/storage.rs b/crates/horizon-client/src/game/storage.rs index f6c38f2cd..9b28ce26b 100644 --- a/crates/horizon-client/src/game/storage.rs +++ b/crates/horizon-client/src/game/storage.rs @@ -22,7 +22,7 @@ impl Game<'_> { (300..400).contains(&slot) && is_shulker_box(&stack.item) && self.container.is_some_and(|k| { - is_shulker_box(&self.res.facts.get(self.world.block(k.0, k.1, k.2)).name) + is_shulker_box(&self.res.facts().get(self.world.block(k.0, k.1, k.2)).name) }) } /// Opening an ender chest shows the player's ender inventory in its place. @@ -160,7 +160,7 @@ impl Game<'_> { let k = self.container?; Some( self.res - .facts + .facts() .get(self.world.block(k.0, k.1, k.2)) .name .clone(), diff --git a/crates/horizon-client/src/game/sulfur_cubes.rs b/crates/horizon-client/src/game/sulfur_cubes.rs index c4cee6319..d1bf9def9 100644 --- a/crates/horizon-client/src/game/sulfur_cubes.rs +++ b/crates/horizon-client/src/game/sulfur_cubes.rs @@ -52,7 +52,7 @@ impl Game<'_> { } // shortcut: the body slot retains only an item id; preserve the stack // before supporting its block-state components here. - let Some(state) = self.res.items.get(item).and_then(|item| item.block) else { + let Some(state) = self.res.items().get(item).and_then(|item| item.block) else { return; }; let start = out.len(); @@ -60,7 +60,7 @@ impl Game<'_> { state, 42, block_transform(base, mob.is_baby()), - block_light(light, self.res.facts.get(state).emission), + block_light(light, self.res.facts().get(state).emission), true, out, ); diff --git a/crates/horizon-client/src/game/tnt.rs b/crates/horizon-client/src/game/tnt.rs index f488d7a8b..97b29ad1c 100644 --- a/crates/horizon-client/src/game/tnt.rs +++ b/crates/horizon-client/src/game/tnt.rs @@ -159,7 +159,7 @@ impl Game<'_> { &self.world, self.collision, &self.pack.assets, - &self.res.facts, + self.res.facts(), )?; if t.fuse <= 0 { let center = [ @@ -186,7 +186,7 @@ impl Game<'_> { return Ok(false); }; let state = self.world.block(hit.pos[0], hit.pos[1], hit.pos[2]); - if &*self.res.facts.get(state).name != "minecraft:tnt" { + if &*self.res.facts().get(state).name != "minecraft:tnt" { return Ok(false); } let pos = BlockPos::new(hit.pos[0], hit.pos[1], hit.pos[2]); diff --git a/crates/horizon-client/src/game/trading.rs b/crates/horizon-client/src/game/trading.rs index 660738d69..87e0c18c6 100644 --- a/crates/horizon-client/src/game/trading.rs +++ b/crates/horizon-client/src/game/trading.rs @@ -147,7 +147,7 @@ impl Game<'_> { variant: &str, origin: [f64; 3], ) -> Vec { - let Some(sequence) = self.res.stations.trades.sequence(set) else { + let Some(sequence) = self.res.stations().trades.sequence(set) else { return Vec::new(); }; let mut random = self.rand_sequences.lend(&sequence, self.level.seed); @@ -160,15 +160,15 @@ impl Game<'_> { next_id: std::cell::Cell::new(next_map), }; let ctx = TradeContext { - items: &self.res.items, - enchantments: &self.res.stations.enchantments, + items: self.res.items(), + enchantments: &self.res.stations().enchantments, variant, origin, maps: Some(&maps), }; let offers = self .res - .stations + .stations() .trades .offers_from_set(&ctx, set, &mut random); let made = maps.made.into_inner(); @@ -205,7 +205,7 @@ impl Game<'_> { let profession = PROFESSIONS[m.extra.variant2 as usize % PROFESSIONS.len()]; let level = i32::from(m.extra.variant3.max(1)); let set = merchant::Trades::set_for(profession, level); - if self.res.stations.trades.sets.contains_key(&set) { + if self.res.stations().trades.sets.contains_key(&set) { self.offers_from_set(&set, &variant, origin) } else { Vec::new() @@ -284,7 +284,7 @@ impl Game<'_> { session.reputation = self.villager_reputation(id); session.hero = self.hero_amplifier(); for seq in merchant::Session::sequences_needed( - &self.res.stations.trades, + &self.res.stations().trades, &session.profession, level, ) { @@ -547,7 +547,7 @@ impl Game<'_> { m.focused, ); let offers = m.session.offers.clone(); - let costs: Vec = offers.iter().map(|o| o.cost_a(&self.res.items)).collect(); + let costs: Vec = offers.iter().map(|o| o.cost_a(self.res.items())).collect(); let atlas = &self.gui.atlas; batch.fill( atlas, @@ -563,7 +563,7 @@ impl Game<'_> { r.v1 = r.v0 + 166.0 * dv; batch.rect_uv(ox + SHIFT, oy, 276.0, 166.0, r, u32::MAX); } - let e = &self.res.stations.enchantments; + let e = &self.res.stations().enchantments; let tr = |k: &str, f: &str| e.translate(k).unwrap_or(f).to_owned(); let name = custom.unwrap_or_else(|| { if progress { @@ -794,7 +794,7 @@ impl Game<'_> { } else if deprecated { let text = self .res - .stations + .stations() .enchantments .translate("merchant.deprecated") .unwrap_or("Villagers restock up to two times per day.") diff --git a/crates/horizon-client/src/game/trident.rs b/crates/horizon-client/src/game/trident.rs index fc3de7fd7..69f4b4e38 100644 --- a/crates/horizon-client/src/game/trident.rs +++ b/crates/horizon-client/src/game/trident.rs @@ -70,7 +70,7 @@ impl Game<'_> { } let max = self .res - .items + .items() .get(&stack.item) .map_or(250, |i| i.max_damage); let riptide = stack.enchantment_level("minecraft:riptide") > 0; @@ -89,7 +89,7 @@ impl Game<'_> { p.position.y.floor() as i32, p.position.z.floor() as i32, ); - let water = self.res.facts.get(self.world.block(x, y, z)).fluid + let water = self.res.facts().get(self.world.block(x, y, z)).fluid == horizon_client::blocks::Fluid::Water; let sky = self.world.light(x, y + 1, z) >> 4 == 15; water || (self.world.weather.raining && sky) diff --git a/crates/horizon-client/src/game/villagers.rs b/crates/horizon-client/src/game/villagers.rs index 72fa2839a..5c6bed394 100644 --- a/crates/horizon-client/src/game/villagers.rs +++ b/crates/horizon-client/src/game/villagers.rs @@ -40,7 +40,7 @@ impl Game<'_> { .position(|m| m.id == id && m.species() == Species::Villager) } fn item_max_stack(&self, item: &str) -> u32 { - self.res.items.get(item).map_or(64, |i| i.max_stack) + self.res.items().get(item).map_or(64, |i| i.max_stack) } /// `BehaviorUtils.throwItem`: toss a stack from a villager's hand toward /// a point. @@ -57,7 +57,7 @@ impl Game<'_> { return; }; let now = self.world.game_time; - let items = &self.res.items; + let items = self.res.items(); let meeting = villager::meet(&mut self.mobs, ia, ib, now, |item| { items.get(item).map_or(64, |i| i.max_stack) }); @@ -121,13 +121,13 @@ impl Game<'_> { for _ in 0..=12 { y -= 1; let here = self.world.block(x, y, z); - let f = self.res.facts.get(here); - let above_f = self.res.facts.get(above); - let air_or_liquid = self.res.facts.is_air(above) + let f = self.res.facts().get(here); + let above_f = self.res.facts().get(above); + let air_or_liquid = self.res.facts().is_air(above) || above_f.fluid != horizon_client::blocks::Fluid::None; - let solid = self.res.mob_data.state(here).flags & horizon_client::mobs::data::SOLID - != 0 - || f.name.as_ref() == "minecraft:powder_snow"; + let solid = + self.res.mob_data().state(here).flags & horizon_client::mobs::data::SOLID != 0 + || f.name.as_ref() == "minecraft:powder_snow"; if golem_floor_ok(&f.name) && air_or_liquid && solid { found = Some(y + 1); break; @@ -137,7 +137,7 @@ impl Game<'_> { let Some(y) = found else { continue }; // IronGolem.checkSpawnRules: a floor and three free blocks. let free = |g: &Self, yy: i32| { - g.res.mob_data.state(g.world.block(x, yy, z)).flags + g.res.mob_data().state(g.world.block(x, yy, z)).flags & horizon_client::mobs::data::VALID_EMPTY_SPAWN != 0 }; @@ -260,7 +260,7 @@ impl Game<'_> { } let picks_up = self .res - .items + .items() .item_tags .get("minecraft:villager_picks_up") .cloned(); diff --git a/crates/horizon-client/src/game/wandering_trader.rs b/crates/horizon-client/src/game/wandering_trader.rs index b336cdf0b..d42ac662f 100644 --- a/crates/horizon-client/src/game/wandering_trader.rs +++ b/crates/horizon-client/src/game/wandering_trader.rs @@ -126,14 +126,14 @@ impl Game<'_> { } let biome = self.world.chunks.get(&(pos[0] >> 4, pos[2] >> 4)).map(|c| { self.res - .biomes + .biomes() .get(c.biome(pos[0], pos[1], pos[2])) .name .clone() }); if biome.is_some_and(|b| { self.res - .mob_data + .mob_data() .biome_has("minecraft:without_wandering_trader_spawns", &b) }) { return false; @@ -214,7 +214,7 @@ impl Game<'_> { (0..=1).all(|dz| { !self .res - .facts + .facts() .get(self.world.block(pos[0] + dx, pos[1] + dy, pos[2] + dz)) .full_collision }) @@ -230,7 +230,7 @@ impl Game<'_> { continue; } for y in (from[1] - range).max(horizon_client::chunk::MIN_Y)..=from[1] + range { - if &*self.res.facts.get(self.world.block(x, y, z)).name != "minecraft:bell" { + if &*self.res.facts().get(self.world.block(x, y, z)).name != "minecraft:bell" { continue; } let d = (x - from[0]).pow(2) + (y - from[1]).pow(2) + (z - from[2]).pow(2); diff --git a/crates/horizon-client/src/game/wind.rs b/crates/horizon-client/src/game/wind.rs index 46a1feed6..355b5b877 100644 --- a/crates/horizon-client/src/game/wind.rs +++ b/crates/horizon-client/src/game/wind.rs @@ -141,7 +141,7 @@ impl Game<'_> { fn wind_positions(&mut self, center: [f64; 3], radius: f32) -> Vec<[i32; 3]> { let stops = self .res - .items + .items() .block_tags .get("minecraft:blocks_wind_charge_explosions") .cloned() @@ -176,7 +176,7 @@ impl Game<'_> { } let name = &self .res - .facts + .facts() .get(self.world.block(pos[0], pos[1], pos[2])) .name; if stops.contains(&**name) { @@ -402,7 +402,7 @@ impl Game<'_> { /// buttons, levers and bells react as if used; candles go out. fn wind_trigger_block(&mut self, pos: [i32; 3]) -> Result<()> { let state = self.world.block(pos[0], pos[1], pos[2]); - let name = self.res.facts.get(state).name.clone(); + let name = self.res.facts().get(state).name.clone(); let prop = |game: &Self, key: &str| { game.pack .assets diff --git a/crates/horizon-client/src/game/wither.rs b/crates/horizon-client/src/game/wither.rs index dfd215814..7b86dc527 100644 --- a/crates/horizon-client/src/game/wither.rs +++ b/crates/horizon-client/src/game/wither.rs @@ -10,14 +10,22 @@ use horizon_client::{ impl Game<'_> { fn is_wither_skull(&self, p: [i32; 3]) -> bool { - let name = &*self.res.facts.get(self.world.block(p[0], p[1], p[2])).name; + let name = &*self + .res + .facts() + .get(self.world.block(p[0], p[1], p[2])) + .name; matches!( name, "minecraft:wither_skeleton_skull" | "minecraft:wither_skeleton_wall_skull" ) } fn is_soul_base(&self, p: [i32; 3]) -> bool { - let name = &*self.res.facts.get(self.world.block(p[0], p[1], p[2])).name; + let name = &*self + .res + .facts() + .get(self.world.block(p[0], p[1], p[2])) + .name; matches!(name, "minecraft:soul_sand" | "minecraft:soul_soil") } /// After a wither skeleton skull is placed: the T of soul sand (or soul @@ -36,7 +44,7 @@ impl Game<'_> { && self.is_soul_base(at(1, 2)) && [0, 2].iter().all(|&c| { let p = at(c, 2); - self.res.facts.is_air(self.world.block(p[0], p[1], p[2])) + self.res.facts().is_air(self.world.block(p[0], p[1], p[2])) }); if !ok { continue; From 0eec25d14b6210e74915c7950f75750a6c319d7b Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 00:45:49 +0200 Subject: [PATCH 028/163] Sculk: Fx hashing for the per-mob step and damage maps entity_motion_events looked up each moving mob in a SipHash map every tick. The keys are mob ids the server gives out, so the fast hasher is safe there. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game/sculk.rs | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/crates/horizon-client/src/game/sculk.rs b/crates/horizon-client/src/game/sculk.rs index 04e02d360..72a91d7da 100644 --- a/crates/horizon-client/src/game/sculk.rs +++ b/crates/horizon-client/src/game/sculk.rs @@ -6,13 +6,14 @@ use super::{Game, Result}; use horizon_client::{ containers::BlockEntity, + fast_hash::{FxHashMap, FxHashSet}, mobs::{Mob, Species, Who, warden}, particles::{ParticleOptions, ParticleType}, sculk::{self, Context, Info, SculkEntity, SculkKind, WardenSpawnTracker}, }; use horizon_core::{geometry::Direction, position::BlockPos, random::RandomSource}; use horizon_world::registry::BlockStateId; -use std::collections::{HashMap, HashSet}; +use std::collections::HashSet; use winit::keyboard::KeyCode; pub const HELP: &[&str] = &[ @@ -70,8 +71,9 @@ pub(super) struct SculkState { /// The sculk block entities in the order they were added. index: Index, pub known: HashSet<(i32, i32)>, - steps: HashMap, - damaged: HashMap, + // Keyed by mob ids the server gives out: the fast hasher is safe. + steps: FxHashMap, + damaged: FxHashMap, last_health: Option, /// The darkness effect's blend factor, previous and current tick. darkness: (f32, f32), @@ -1528,7 +1530,7 @@ impl Game<'_> { } } } - let alive: HashSet = self.mobs.iter().map(|m| m.id).collect(); + let alive: FxHashSet = self.mobs.iter().map(|m| m.id).collect(); self.sculk.damaged.retain(|id, _| alive.contains(id)); self.sculk.steps.retain(|who, _| match who { Who::Player => true, From d9686faf3596eb160b188fc0322e6d5a50b629ac Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sat, 17 Oct 2026 23:47:53 +0100 Subject: [PATCH 029/163] Startup stage 3b: publish world core before the simulation tail (#712) --- crates/horizon-client/src/fog.rs | 1 + crates/horizon-client/src/game.rs | 343 +++++++++++++----- crates/horizon-client/src/game/backdrop.rs | 5 + crates/horizon-client/src/game/dedicated.rs | 1 + crates/horizon-client/src/game/integrated.rs | 1 + crates/horizon-client/src/game/remote.rs | 1 + crates/horizon-client/src/game/render_tick.rs | 8 +- crates/horizon-client/src/telemetry.rs | 24 ++ crates/horizon-telemetry/src/payload.rs | 4 + docs/performance/startup-stage-3.md | 17 + 10 files changed, 316 insertions(+), 89 deletions(-) create mode 100644 docs/performance/startup-stage-3.md diff --git a/crates/horizon-client/src/fog.rs b/crates/horizon-client/src/fog.rs index 83f1a8bf5..4e29aeae9 100644 --- a/crates/horizon-client/src/fog.rs +++ b/crates/horizon-client/src/fog.rs @@ -32,6 +32,7 @@ pub struct FogData { } /// Per-biome water fog end multipliers (`visual/water_fog_end_distance`). +#[derive(Default)] pub struct FogTables { water_fog_end: Vec, } diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index bc6123778..8fd378187 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -879,6 +879,8 @@ fn select_creative_tab( struct Game<'a> { /// Shared with an integrated server; `collision` and `motion` borrow from it. res: Arc, + rest_loader: Option, + world_renderer_ready: bool, collision: &'a BlockCollisionRegistry<'a>, motion: &'a MotionResources, /// This game's resource packs (`reload_packs` replaces them). @@ -6357,6 +6359,7 @@ impl Game<'_> { creative: bool, create: Option<&horizon_client::title::WorldOptions>, ) -> Result<()> { + self.join_world_rest()?; let save_root = std::env::current_dir()?.join("saves").join(folder); if integrated::wanted(&self.options, &save_root) { return self.open_integrated(folder, name, seed, creative, create); @@ -9326,7 +9329,10 @@ impl ApplicationHandler for Game<'_> { } }; match self.new_renderer(window.clone()) { - Ok(r) => self.renderer = Some(r), + Ok(r) => { + self.renderer = Some(r); + self.world_renderer_ready = true; + } Err(e) => { self.error = Some(e); event_loop.exit(); @@ -10051,6 +10057,11 @@ impl ApplicationHandler for Game<'_> { } } fn about_to_wait(&mut self, event_loop: &ActiveEventLoop) { + if let Err(error) = self.poll_world_rest() { + self.error = Some(error); + event_loop.exit(); + return; + } self.poll_control(event_loop); self.poll_pads(event_loop); if self.options.frames.is_some() && self.started.elapsed() > self.options.timeout { @@ -10143,6 +10154,8 @@ impl<'a> Game<'a> { let particles = horizon_client::particles::ParticleEngine::new(&root, &gui.atlas.sprites); Ok(Game { res: res.clone(), + rest_loader: None, + world_renderer_ready: false, collision: res.collision(), motion: res.motion(), pack, @@ -10425,7 +10438,8 @@ impl<'a> Game<'a> { struct Loaded { root: PathBuf, pack_error: Option, - resources: Resources, + resources: Arc, + rest_loader: Option, pack: PackResources, /// The menu bundle, for the synchronous launch; the loading screen receives /// it earlier through its own channel. @@ -10433,23 +10447,80 @@ struct Loaded { } /// What the background loader publishes: the menu bundle as soon as it is -/// ready, then the world bundle. +/// ready, then the core bundle with a handle to the rest worker. enum LoaderMsg { Ui(UiResources), Done(std::result::Result), } -/// The loader's checkpoints, in order; the loading screen reports them. -const STAGES: u32 = 9; -const STAGE_LINES: [&str; 9] = [ +struct WorldRestLoader { + handle: JoinHandle>, + started: Instant, +} + +impl WorldRestLoader { + fn finish(self) -> Result<()> { + self.handle + .join() + .map_err(|_| "world resource loader panicked")? + .map_err(Into::into) + } +} + +impl Game<'_> { + fn poll_world_rest(&mut self) -> Result<()> { + if self + .rest_loader + .as_ref() + .is_some_and(|loader| loader.handle.is_finished()) + { + self.rest_loader + .take() + .ok_or("missing world loader")? + .finish()?; + } else if self + .rest_loader + .as_ref() + .is_some_and(|loader| loader.started.elapsed() > Duration::from_secs(120)) + { + return Err("world resource loading timed out after 120 seconds".into()); + } + Ok(()) + } + + fn join_world_rest(&mut self) -> Result<()> { + if self.rest_loader.is_some() { + let waited = Instant::now(); + log::info!("Horizon: waiting for world resources"); + while self.rest_loader.is_some() { + self.poll_world_rest()?; + if self.rest_loader.is_some() { + std::thread::sleep(Duration::from_millis(10)); + } + } + log::info!( + "Horizon: world resources joined after {} ms", + waited.elapsed().as_millis() + ); + } + if self.res.rest.get().is_none() { + return Err("world resources are unavailable".into()); + } + Ok(()) + } +} + +const STAGES: u32 = 10; +const STAGE_LINES: [&str; 10] = [ "Loading menu", "Loading assets", "Loading block facts", - "Loading items", "Loading biomes", "Loading pack tables", "Loading collision", - "Loading resources", + "Loading items", + "Loading recipes", + "Loading world resources", "Starting audio", ]; @@ -10487,16 +10558,15 @@ fn synchronous_startup(options: &Options) -> bool { || std::env::var_os("HORIZON_NET_REPORT").is_some() } -/// The current loading sequence, unchanged, as a function so the synchronous -/// launch can run it on the main thread and an ordinary launch on a worker. -/// `on_stage` reports [`STAGES`] checkpoints to the loading screen. +/// The synchronous launch loads both phases; an ordinary launch returns the +/// core bundle while the rest worker keeps loading. fn load_resources( mut root: PathBuf, vanilla_root: &std::path::Path, settings: &Settings, started: Instant, menu: bool, - on_stage: &(dyn Fn(u32) + Sync), + progress: &Progress, publish: &mut dyn FnMut(UiResources), ) -> Result { let requested_root = root.clone(); @@ -10519,7 +10589,7 @@ fn load_resources( } ui_ready = true; } - on_stage(0); + progress.set(0); let mut pack_error = None; let (assets, render) = match Assets::load(&root).and_then(|assets| { let render = assets.reload(&root)?; @@ -10560,7 +10630,7 @@ fn load_resources( } } log::info!("load assets: {:.2}s", started.elapsed().as_secs_f32()); - on_stage(1); + progress.set(1); let behaviour_json: serde_json::Value = serde_json::from_reader(std::io::BufReader::new( std::fs::File::open(root.join("block-behaviours.json"))?, ))?; @@ -10591,21 +10661,14 @@ fn load_resources( facts.map_err(|e| -> Box { e.into() })?; let biomes = Arc::new(biomes.map_err(|e| -> Box { e.into() })?); let environment = environment.map_err(|e| -> Box { e.into() })?; - let mob_data = horizon_client::mobs::MobData::load(&root, &facts); - horizon_client::mobs::trial_spawner::load_registry(&root); log::info!("load facts: {:.2}s", started.elapsed().as_secs_f32()); - on_stage(2); - let items = Items::load(&root, assets.registry, &facts)?; - log::info!("load items: {:.2}s", started.elapsed().as_secs_f32()); - on_stage(3); - let recipes = Recipes::load(&root, &items)?; - let transformers = horizon_client::block_transform::Transformers::load(&root, assets.registry)?; + progress.set(2); log::info!("load biomes+env: {:.2}s", started.elapsed().as_secs_f32()); - on_stage(4); + progress.set(3); let light = Arc::new(LightTables::load(&root, assets.registry, &facts)?); let pack = PackResources::load(&root, assets.clone(), render, &facts, biomes.clone(), light)?; log::info!("load pack tables: {:.2}s", started.elapsed().as_secs_f32()); - on_stage(5); + progress.set(4); horizon_client::ui::load_metadata(&root); horizon_client::lang::set(horizon_client::lang::Language::load( &[&root], @@ -10618,13 +10681,106 @@ fn load_resources( "load collision+motion: {:.2}s", started.elapsed().as_secs_f32() ); - on_stage(6); + progress.set(5); + let resources = Resources { + core: WorldCore { + facts, + biomes: biomes.clone(), + environment, + collision, + motion, + threads, + }, + rest: std::sync::OnceLock::new(), + }; + let resources = Arc::new(resources); if menu { + horizon_client::telemetry::mark_core_ready(); log::info!( - "Horizon: world bundle ready after {} ms", + "Horizon: core-ready after {} ms", started.elapsed().as_millis() ); } + let rest_loader = if menu { + let resources = resources.clone(); + let root = root.clone(); + let progress = progress.clone(); + let handle = std::thread::Builder::new() + .name("world-rest-loader".into()) + .spawn(move || { + let rest = load_world_rest( + &root, + &resources, + &assets, + &behaviour_json, + &gameplay_projection, + &progress, + started, + ) + .map_err(|error| error.to_string())?; + resources + .rest + .set(rest) + .map_err(|_| "world resources already loaded".to_owned())?; + horizon_client::telemetry::mark_rest_ready(); + log::info!( + "Horizon: rest-ready after {} ms", + started.elapsed().as_millis() + ); + Ok(()) + })?; + Some(WorldRestLoader { + handle, + started: Instant::now(), + }) + } else { + let rest = load_world_rest( + &root, + &resources, + &assets, + &behaviour_json, + &gameplay_projection, + progress, + started, + )?; + resources + .rest + .set(rest) + .map_err(|_| "world resources already loaded")?; + None + }; + Ok(Loaded { + root, + pack_error, + resources, + rest_loader, + pack, + gui: loaded_gui, + }) +} + +fn load_world_rest( + root: &std::path::Path, + resources: &Resources, + assets: &Assets, + behaviour_json: &serde_json::Value, + gameplay_projection: &[horizon_client::blocks::GameplayProjection], + progress: &Progress, + started: Instant, +) -> Result { + let facts = resources.facts(); + let biomes = resources.biomes(); + let threads = resources.threads(); + let registry_owner = assets; + let mob_data = horizon_client::mobs::MobData::load(root, facts); + horizon_client::mobs::trial_spawner::load_registry(root); + + let items = Items::load(root, assets.registry, facts)?; + log::info!("load items: {:.2}s", started.elapsed().as_secs_f32()); + progress.set(6); + let recipes = Recipes::load(root, &items)?; + progress.set(7); + let transformers = horizon_client::block_transform::Transformers::load(root, assets.registry)?; log::info!( "Horizon: resources loaded in {:.1}s; {} block states, {} items, {} biomes; {} worker threads", started.elapsed().as_secs_f32(), @@ -10633,63 +10789,42 @@ fn load_resources( biomes.list.len(), threads ); - let stations = horizon_client::stations::StationData::load(&root, &items); + progress.set(8); + let stations = horizon_client::stations::StationData::load(root, &items); let animate = - horizon_client::animate_tick::AnimateTables::load(&root, registry_owner.registry, &biomes)?; - let fog = horizon_client::fog::FogTables::load(&root, &biomes); - let resources = Resources { - core: WorldCore { - facts, - biomes, - environment, - collision, - motion, - threads, - }, - rest: std::sync::OnceLock::from(WorldRest { - stations, - items, - recipes, - transformers, - providers: Providers::load(&root), - block_entity_render: horizon_client::block_entity_render::BlockEntityRenderer::load( - &root, - registry_owner.registry, - )?, - animate, - fog, - music: horizon_client::music::MusicTables::load(&root), - ambient: horizon_client::ambience::AmbientTables::load(&root), - nether_environment: Environment::load_dimension(&root, "the_nether", false)?, - end_environment: Environment::load_dimension(&root, "the_end", false)?, - behaviours: Behaviours::load_with_gameplay( - registry_owner.registry, - &root, - &behaviour_json, - &gameplay_projection, - )?, - mob_types: MobTypes::load(&root)? - .types - .into_iter() - .map(|(k, v)| (k, Arc::new(v))) - .collect(), - mob_data, - player_type: perspective::player_type(&root), - player_arm: horizon_client::mobs::load_model(&root, "minecraft:player#main") - .and_then(|m| m.children.into_iter().find(|c| c.name == "right_arm")), - }), - }; - // Both inputs are needed only while constructing the behaviour tables. - // Release their owned JSON/Arc buffers before entering the long-lived game loop. - drop(gameplay_projection); - drop(behaviour_json); - on_stage(7); - Ok(Loaded { - root, - pack_error, - resources, - pack, - gui: loaded_gui, + horizon_client::animate_tick::AnimateTables::load(root, registry_owner.registry, biomes)?; + let fog = horizon_client::fog::FogTables::load(root, biomes); + Ok(WorldRest { + stations, + items, + recipes, + transformers, + providers: Providers::load(root), + block_entity_render: horizon_client::block_entity_render::BlockEntityRenderer::load( + root, + registry_owner.registry, + )?, + animate, + fog, + music: horizon_client::music::MusicTables::load(root), + ambient: horizon_client::ambience::AmbientTables::load(root), + nether_environment: Environment::load_dimension(root, "the_nether", false)?, + end_environment: Environment::load_dimension(root, "the_end", false)?, + behaviours: Behaviours::load_with_gameplay( + registry_owner.registry, + root, + behaviour_json, + gameplay_projection, + )?, + mob_types: MobTypes::load(root)? + .types + .into_iter() + .map(|(k, v)| (k, Arc::new(v))) + .collect(), + mob_data, + player_type: perspective::player_type(root), + player_arm: horizon_client::mobs::load_model(root, "minecraft:player#main") + .and_then(|m| m.children.into_iter().find(|c| c.name == "right_arm")), }) } @@ -10835,6 +10970,7 @@ fn start_game<'a>( audio: Audio, vanilla_root: PathBuf, started: Instant, + rest_loader: Option, ) -> Result>> { let mut settings = Settings::load(&std::env::current_dir()?.join("options.txt")); horizon_client::ui_theme::load_preferences(&std::env::current_dir()?); @@ -10849,6 +10985,7 @@ fn start_game<'a>( settings.render_distance = d; } let mut game = Game::new(res, pack, gui, options, settings, audio)?; + game.rest_loader = rest_loader; game.ui.vanilla_root = vanilla_root; if let Some(error) = pack_error { game.open_options_at(true, horizon_client::options_ui::Page::Packs); @@ -11140,8 +11277,7 @@ impl Loading { let mut options = self.options.take().ok_or("loading already finished")?; options.resources = loaded.root.clone(); let gui = self.gui.take().ok_or("missing menu bundle")?; - self.progress.set(STAGES - 1); - // Audio is created on the main thread, after the join. + // Audio is created on the main thread, after the core is ready. let audio = if options.dedicated.is_some() { Audio::silent(&options.resources) } else { @@ -11159,10 +11295,14 @@ impl Loading { &gui, self.renderer.as_ref(), )?; + log::info!( + "Horizon: world renderer ready after {} ms", + self.started.elapsed().as_millis() + ); let pack_error = loaded.pack_error.or_else(|| self.pack_error.take()); // The game borrows its shared resources for the process's lifetime, // like the single copy an integrated server would share. - let res: &'static Arc = Box::leak(Box::new(Arc::new(loaded.resources))); + let res: &'static Arc = Box::leak(Box::new(loaded.resources)); let Some(mut game) = start_game( res, loaded.pack, @@ -11172,12 +11312,14 @@ impl Loading { audio, self.vanilla_root.clone(), self.started, + loaded.rest_loader, )? else { return Ok(None); }; game.window = Some(window); game.renderer = Some(renderer); + game.world_renderer_ready = true; game.fullscreen = self.fullscreen; game.apply_settings(); game.previous = Instant::now(); @@ -11282,7 +11424,7 @@ fn run_loading( &settings, started, true, - &|stage| progress.set(stage), + &progress, &mut |gui| { let _ = sender.send(LoaderMsg::Ui(gui)); }, @@ -11363,7 +11505,7 @@ pub fn run() -> Result<()> { &early_settings, started, false, - &|_| {}, + &Progress::new(), &mut |_| {}, )?; let gui = loaded.gui.ok_or("missing menu bundle")?; @@ -11373,7 +11515,7 @@ pub fn run() -> Result<()> { } else { Audio::new(&options.resources) }; - let resources = Arc::new(loaded.resources); + let resources = loaded.resources; let game = start_game( &resources, loaded.pack, @@ -11383,6 +11525,7 @@ pub fn run() -> Result<()> { audio, vanilla_root, started, + loaded.rest_loader, )?; if let Some(game) = game { run_event_loop(game)?; @@ -11464,6 +11607,30 @@ mod tests { assert!(hud_overlays::sleep_overlay(320, 240, timer as i32).is_empty()); } + #[test] + fn world_rest_worker_failure_reaches_the_client() { + let loader = WorldRestLoader { + handle: std::thread::spawn(|| Err("missing world table".to_owned())), + started: Instant::now(), + }; + assert_eq!( + loader.finish().unwrap_err().to_string(), + "missing world table" + ); + } + + #[test] + fn world_rest_worker_panic_reaches_the_client() { + let loader = WorldRestLoader { + handle: std::thread::spawn(|| panic!("broken loader")), + started: Instant::now(), + }; + assert_eq!( + loader.finish().unwrap_err().to_string(), + "world resource loader panicked" + ); + } + /// An integrated server thread shares the loaded resources with the client. #[test] fn shared_resources_can_cross_threads() { diff --git a/crates/horizon-client/src/game/backdrop.rs b/crates/horizon-client/src/game/backdrop.rs index 7e1a4dbc1..40ede0db5 100644 --- a/crates/horizon-client/src/game/backdrop.rs +++ b/crates/horizon-client/src/game/backdrop.rs @@ -73,6 +73,7 @@ impl Game<'_> { pub(super) fn update_backdrop(&mut self) -> Result<()> { let wanted = self.title.is_some() && horizon_client::ui_theme::horizon() + && self.world_renderer_ready && self.renderer.is_some() && self.options.frames.is_none(); if !wanted { @@ -143,6 +144,10 @@ impl Game<'_> { (-60..320).rev().find(|&y| self.world.block(x, y, z) != air) } fn start_backdrop(&mut self) -> Result<()> { + log::info!( + "Horizon: starting title backdrop after {} ms", + self.started.elapsed().as_millis() + ); let seed = seed(); let root = std::env::current_dir()? .join("saves") diff --git a/crates/horizon-client/src/game/dedicated.rs b/crates/horizon-client/src/game/dedicated.rs index 33bedf696..35afba133 100644 --- a/crates/horizon-client/src/game/dedicated.rs +++ b/crates/horizon-client/src/game/dedicated.rs @@ -335,6 +335,7 @@ struct ServerState { impl Game<'_> { /// DedicatedServer.initServer and MinecraftServer.runServer. pub(super) fn run_dedicated(&mut self) -> Result<()> { + self.join_world_rest()?; let Setup { props, universe, diff --git a/crates/horizon-client/src/game/integrated.rs b/crates/horizon-client/src/game/integrated.rs index f3d758c47..b7fcd186d 100644 --- a/crates/horizon-client/src/game/integrated.rs +++ b/crates/horizon-client/src/game/integrated.rs @@ -190,6 +190,7 @@ impl Game<'_> { options.server = None; options.world = None; options.dev_mods.clear(); + self.join_world_rest()?; let (res, pack, settings) = (self.res.clone(), self.pack.clone(), self.settings.clone()); let flags = Arc::new(Flags::default()); let (ready_tx, ready) = channel(); diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 04ee2d286..d4a2ba6b2 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -165,6 +165,7 @@ fn number_format(f: &play::NumberFormat) -> horizon_client::scoreboard::NumberFo impl Game<'_> { /// Leave the title for a server (ConnectScreen): an empty world fed by the connection. pub(super) fn connect_server(&mut self, address: &str, name: &str) -> Result<()> { + self.join_world_rest()?; if let Err(error) = self.join_server(address, name, None) { log::warn!("Horizon: could not join server: {error}"); if self.title.is_none() { diff --git a/crates/horizon-client/src/game/render_tick.rs b/crates/horizon-client/src/game/render_tick.rs index 103cb26c9..b990869a5 100644 --- a/crates/horizon-client/src/game/render_tick.rs +++ b/crates/horizon-client/src/game/render_tick.rs @@ -73,8 +73,14 @@ impl Game<'_> { } else { (0.0, 0.0) }; + let title_fog = horizon_client::fog::FogTables::default(); + let tables = if self.title.is_some() { + &title_fog + } else { + self.res.fog() + }; horizon_client::fog::setup_fog( - self.res.fog(), + tables, &self.fog, &FogInputs { fog_type, diff --git a/crates/horizon-client/src/telemetry.rs b/crates/horizon-client/src/telemetry.rs index 547a2bcde..85f54df72 100644 --- a/crates/horizon-client/src/telemetry.rs +++ b/crates/horizon-client/src/telemetry.rs @@ -21,6 +21,8 @@ const CRASH_DETAILS: [&str; 3] = ["Horizon Version", "Graphics Adapter", "Render static STARTED: OnceLock = OnceLock::new(); /// When the menu bundle became ready, so the time to the title screen measures /// the menu and not the world bundle loaded behind it. +static CORE_READY_MS: AtomicU32 = AtomicU32::new(u32::MAX); +static REST_READY_MS: AtomicU32 = AtomicU32::new(u32::MAX); static UI_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); @@ -38,6 +40,26 @@ pub fn mark_ui_ready() { } } +pub fn mark_core_ready() { + mark_ready(&CORE_READY_MS); +} + +pub fn mark_rest_ready() { + mark_ready(&REST_READY_MS); +} + +fn mark_ready(mark: &AtomicU32) { + if let Some(started) = STARTED.get() { + let ms = started.elapsed().as_millis().min(u128::from(u32::MAX - 1)) as u32; + let _ = mark.compare_exchange(u32::MAX, ms, Ordering::Relaxed, Ordering::Relaxed); + } +} + +fn readiness_ms(mark: &AtomicU32) -> Option { + let ms = mark.load(Ordering::Relaxed); + (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)); } @@ -192,6 +214,8 @@ impl Session { peak_ram_mb: peak_ram_mb(), to_title_ms: self.to_title_ms, to_world_ms: self.to_world_ms, + to_core_ms: self.to_title_ms.and_then(|_| readiness_ms(&CORE_READY_MS)), + to_rest_ms: self.to_title_ms.and_then(|_| readiness_ms(&REST_READY_MS)), }) } diff --git a/crates/horizon-telemetry/src/payload.rs b/crates/horizon-telemetry/src/payload.rs index 1429a7116..2ed0ba88d 100644 --- a/crates/horizon-telemetry/src/payload.rs +++ b/crates/horizon-telemetry/src/payload.rs @@ -179,6 +179,10 @@ pub struct Perf { /// From start to the title screen. #[serde(skip_serializing_if = "Option::is_none")] pub to_title_ms: Option, + #[serde(skip_serializing_if = "Option::is_none")] + pub to_core_ms: Option, + #[serde(skip_serializing_if = "Option::is_none")] + pub to_rest_ms: Option, /// From choosing a world to playing in it, the first time this session. #[serde(skip_serializing_if = "Option::is_none")] pub to_world_ms: Option, diff --git a/docs/performance/startup-stage-3.md b/docs/performance/startup-stage-3.md new file mode 100644 index 000000000..57ab0a54c --- /dev/null +++ b/docs/performance/startup-stage-3.md @@ -0,0 +1,17 @@ +# Progressive world resources (#712) + +Stage 3a changes shared resource storage and accessors. Pack resources keep their existing per-game ownership for pack reloads. Stage 3b publishes core before the simulation tail, builds the real renderer using the previous device after releasing its surface, and gates backdrop streaming on that renderer. World entry joins the tail before sharing resources with an integrated server. The synchronous harness and dedicated path returns only fully loaded resources. + +Startup logs distinguish `core-ready`, `world renderer ready`, `starting title backdrop`, and `rest-ready`. Opt-in performance summaries carry `to_core_ms` and `to_rest_ms` separately from the existing UI-driven `to_title_ms`. Loader failures and panics propagate to the client; a tail taking more than 120 seconds fails rather than waiting indefinitely. + +## Render facts assessment + +`MeshTables::new` reads names, registry properties, class membership, collision shape flags, fluid and render properties from `BlockFacts`. `LightTables::new/load` reads emission, dampening, occlusion and shape-occlusion flags; geometry comes from `occlusion.nbt`. Neither table needs recipes, item data, AI or the other tail tables. + +A render subset is possible, but the current facts decoder also validates registry order and builds the gameplay projection from the same document. Meshing additionally depends on class chains from `block-behaviours.json`. Avoiding the 54 MB read requires an exported render-facts artifact (and its prepare/cache/version checks), or another decoder plus a second full read at world entry. This is beyond a cheap startup ownership change. Stage 4 can add that artifact and compare the resulting mesh/light tables against the full loader before moving facts out of core. + +## Measurement + +Measurements on this machine are warm runs with `HORIZON_NO_AUDIO=1`. Other compilation and parity jobs were running, so elapsed times are diagnostic rather than a controlled benchmark. + +Before phasing (3a, `42d65465`), `--offscreen --frames 3 --smoke-report` completed successfully with peak RSS 762,536 KiB. The report contained 3 frames, no chunks, no generated or meshed sections, no player, and no error. This is the synchronous harness path; the progressive path is measured separately after 3c. From a3cf97f2fafd31c69bf16cdbb5f5fa19ccac5324 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sat, 17 Oct 2026 23:50:46 +0100 Subject: [PATCH 030/163] Build the core renderer before starting audio --- crates/horizon-client/src/game.rs | 12 ++++++------ crates/horizon-client/src/telemetry.rs | 2 +- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 8fd378187..33b371824 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -11277,12 +11277,6 @@ impl Loading { let mut options = self.options.take().ok_or("loading already finished")?; options.resources = loaded.root.clone(); let gui = self.gui.take().ok_or("missing menu bundle")?; - // Audio is created on the main thread, after the core is ready. - let audio = if options.dedicated.is_some() { - Audio::silent(&options.resources) - } else { - Audio::new(&options.resources) - }; let window = self.window.clone().ok_or("window closed")?; // Keep the loader's device and swap in the real textures in one step. if let Some(renderer) = &mut self.renderer { @@ -11299,6 +11293,12 @@ impl Loading { "Horizon: world renderer ready after {} ms", self.started.elapsed().as_millis() ); + // Audio is created on the main thread, after the core is ready. + let audio = if options.dedicated.is_some() { + Audio::silent(&options.resources) + } else { + Audio::new(&options.resources) + }; let pack_error = loaded.pack_error.or_else(|| self.pack_error.take()); // The game borrows its shared resources for the process's lifetime, // like the single copy an integrated server would share. diff --git a/crates/horizon-client/src/telemetry.rs b/crates/horizon-client/src/telemetry.rs index 85f54df72..c63d82915 100644 --- a/crates/horizon-client/src/telemetry.rs +++ b/crates/horizon-client/src/telemetry.rs @@ -21,9 +21,9 @@ const CRASH_DETAILS: [&str; 3] = ["Horizon Version", "Graphics Adapter", "Render static STARTED: OnceLock = OnceLock::new(); /// When the menu bundle became ready, so the time to the title screen measures /// the menu and not the world bundle loaded behind it. +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); -static UI_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); From 4e854f8ee380457c03ae67511f05cd97b952bc9a Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sun, 18 Oct 2026 00:10:59 +0100 Subject: [PATCH 031/163] Format launcher assertions for the shared telemetry checks --- launcher/src/modpacks.rs | 10 ++++++++-- launcher/src/sources_tests.rs | 5 ++++- 2 files changed, 12 insertions(+), 3 deletions(-) diff --git a/launcher/src/modpacks.rs b/launcher/src/modpacks.rs index 6ff53e4be..b69ff0976 100644 --- a/launcher/src/modpacks.rs +++ b/launcher/src/modpacks.rs @@ -241,8 +241,14 @@ mod tests { .map(|a| a.to_string_lossy().into_owned()) .collect(); assert_eq!(args.len(), 4); - assert_eq!(Path::new(&args[1]), work.join("mods").join("a").join("carry")); - assert_eq!(Path::new(&args[3]), work.join("mods").join("b").join("carry")); + assert_eq!( + Path::new(&args[1]), + work.join("mods").join("a").join("carry") + ); + assert_eq!( + Path::new(&args[3]), + work.join("mods").join("b").join("carry") + ); assert_eq!(cmd.get_current_dir(), Some(profile_home(&work).as_path())); assert!(profile_home(&work).is_dir()); fs::remove_dir_all(&root).unwrap(); diff --git a/launcher/src/sources_tests.rs b/launcher/src/sources_tests.rs index b273fa4ba..8fae7a533 100644 --- a/launcher/src/sources_tests.rs +++ b/launcher/src/sources_tests.rs @@ -388,7 +388,10 @@ fn relinking_follows_the_launcher_the_files_now_come_from() { s.write("ModrinthApp/meta/versions/26.3/26.3.jar", CLIENT); resolve_with(&modrinth, &[], &linked, &mojang).unwrap(); let jar = linked.join("versions/26.3/26.3.jar"); - assert!(same_file(&jar, &modrinth.join("meta/versions/26.3/26.3.jar"))); + assert!(same_file( + &jar, + &modrinth.join("meta/versions/26.3/26.3.jar") + )); assert!(!same_file(&jar, &prism.join(prism_jar))); // The Modrinth App folder has no libraries or assets: the old links are gone, and the // folders they pointed at are untouched. From 90040198007acf74aa60581004c1fb4536485a38 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sat, 17 Oct 2026 23:29:30 +0100 Subject: [PATCH 032/163] light: pack the flood fill and precompute neighbour blocking light_chunk's sky and block spreads read LightTables::cells for every neighbour, and the fill and both spreads dominated lighting. Pack each cell into two bytes (occlusion type and dampening) with a per-type blocking mask, step neighbours by linear offset with an axis bounds check, and precompute the per-column present table. 1156-column probe: 1.81 -> 1.31 ms/col (~28%). Vanilla light parity is unchanged (1,179,648 sky/block values, 0 differences). --- crates/horizon-client/src/light.rs | 178 +++++++++++++++++++++++------ 1 file changed, 143 insertions(+), 35 deletions(-) diff --git a/crates/horizon-client/src/light.rs b/crates/horizon-client/src/light.rs index 595efd9b2..b2234be8b 100644 --- a/crates/horizon-client/src/light.rs +++ b/crates/horizon-client/src/light.rs @@ -44,11 +44,19 @@ pub struct LightTables { /// `faceShapeOccludes(a, b)` for every pair of distinct face shapes. occludes: Vec, faces: usize, + /// Number of distinct `(shaped, faces)` configurations. + types: usize, + /// Per state: `emission << 16 | type << 4 | dampening`. The low 16 bits are + /// what `light_chunk` stores per cell, so a cell costs 2 bytes and the + /// flood fill never reads the (large) `cells` table. + info: Vec, + /// `blocked(type_a, type_b, direction)` as a bit per direction. + block_masks: Vec, } impl LightTables { /// Dampening and emission only: every occlusion face is empty. pub fn new(facts: &BlockFacts) -> Self { - Self { + let mut tables = Self { cells: facts .states .iter() @@ -61,7 +69,58 @@ impl LightTables { .collect(), occludes: vec![false, true, true, true], faces: 2, + types: 1, + info: Vec::new(), + block_masks: Vec::new(), + }; + tables.rebuild_cache(); + tables + } + /// Build the packed per-cell info and the per-configuration blocking masks + /// used by `light_chunk`'s flood fill. + fn rebuild_cache(&mut self) { + let empty: (bool, [u16; 6]) = (false, [EMPTY; 6]); + let mut by_config: HashMap<(bool, [u16; 6]), u16> = HashMap::new(); + by_config.insert(empty, 0); + let mut configs: Vec<(bool, [u16; 6])> = vec![empty]; + let mut info = vec![0u32; self.cells.len()]; + for (id, cell) in self.cells.iter().enumerate() { + let ty = *by_config + .entry((cell.shaped, cell.faces)) + .or_insert_with(|| { + configs.push((cell.shaped, cell.faces)); + (configs.len() - 1) as u16 + }); + let packed = u32::from(ty) << 4 | u32::from(cell.dampening.min(15)); + info[id] = u32::from(cell.emission.min(15)) << 16 | packed; } + let types = configs.len(); + debug_assert!( + types <= 4096, + "light tables: {types} cell configurations exceed the 12-bit type field" + ); + let mut block_masks = vec![0u8; types * types]; + for a in 0..types { + for b in 0..types { + let (shaped_a, faces_a) = configs[a]; + let (shaped_b, faces_b) = configs[b]; + // `blocked`: an unshaped pair covers no face; otherwise the two + // face shapes are compared through the `occludes` table. + if !shaped_a && !shaped_b { + continue; + } + let mut mask = 0u8; + for d in 0..6 { + if self.occludes[faces_a[d] as usize * self.faces + faces_b[d ^ 1] as usize] { + mask |= 1 << d; + } + } + block_masks[a * types + b] = mask; + } + } + self.types = types; + self.info = info; + self.block_masks = block_masks; } /// Full tables with the vanilla occlusion shapes from `occlusion.nbt`. pub fn load(root: &Path, registry: &BlockRegistry, facts: &BlockFacts) -> crate::Result { @@ -147,8 +206,23 @@ impl LightTables { } tables.occludes = occludes; tables.faces = n; + tables.rebuild_cache(); Ok(tables) } + /// Assembled tables (tests and benchmarks): derives the packed light cache. + #[allow(dead_code)] + fn from_parts(cells: Vec, occludes: Vec, faces: usize) -> Self { + let mut tables = Self { + cells, + occludes, + faces, + types: 0, + info: Vec::new(), + block_masks: Vec::new(), + }; + tables.rebuild_cache(); + tables + } /// `LightEngine.shapeOccludes(from, to, direction)`. #[inline] fn blocked(&self, from: usize, to: usize, direction: usize) -> bool { @@ -160,11 +234,21 @@ impl LightTables { let fb = b.faces[direction ^ 1] as usize; self.occludes[fa * self.faces + fb] } + /// `blocked` for two packed cells (`type << 4 | dampening`). + #[inline] + fn packed_blocked(&self, a: u16, b: u16, direction: usize) -> bool { + self.block_masks[(a >> 4) as usize * self.types + (b >> 4) as usize] & (1 << direction) != 0 + } /// `ChunkSkyLightSources.isEdgeOccluded(top, bottom)`. #[inline] fn edge_occluded(&self, top: usize, bottom: usize) -> bool { self.cells[bottom].dampening != 0 || self.blocked(top, bottom, Direction::Down as usize) } + /// `edge_occluded` for two packed cells. + #[inline] + fn packed_edge_occluded(&self, top: u16, bottom: u16) -> bool { + bottom & 0xF != 0 || self.packed_blocked(top, bottom, Direction::Down as usize) + } pub fn emission(&self, state: u32) -> u8 { self.cells[state as usize].emission } @@ -211,7 +295,9 @@ pub fn light_chunk( // up to 14 blocks into it (sky light there is always 15). let h = ((top_section + 1) * 16).min(HEIGHT as usize); let at = |x: usize, y: usize, z: usize| (y * W + z) * W + x; - let mut states = vec![0u32; W * W * h]; + // Packed cells (`type << 4 | dampening`), not state ids: the flood fill + // then never touches the large `LightTables::cells` table. + let mut states = vec![0u16; W * W * h]; let mut sky = vec![0u8; W * W * h]; let mut block = vec![0u8; W * W * h]; let mut queue = VecDeque::new(); @@ -228,10 +314,11 @@ pub fn light_chunk( for (i, &id) in ids.iter().enumerate() { let (lx, lz, ly) = (i & 15, (i >> 4) & 15, i >> 8); let p = at(dx * 16 + lx, si * 16 + ly, dz * 16 + lz); - states[p] = id; - let emission = tables.cells[id as usize].emission; + let info = tables.info[id as usize]; + states[p] = info as u16; + let emission = info >> 16; if emission > 0 { - block[p] = emission; + block[p] = emission as u8; queue.push_back(p as u32); } } @@ -239,20 +326,25 @@ pub fn light_chunk( } } // Columns of missing neighbour chunks neither hold nor pass light. - let present = |x: usize, z: usize| region[z / 16][x / 16].is_some(); + let mut present = vec![false; W * W]; + for z in 0..W { + for x in 0..W { + present[z * W + x] = region[z / 16][x / 16].is_some(); + } + } let mut lowest = vec![h as i32; W * W]; for z in 0..W { for x in 0..W { - if !present(x, z) || !sky_light { + if !present[z * W + x] || !sky_light { continue; } // The top layer (above the occupied range) is always open sky. let mut y = h as i32 - 1; sky[at(x, y as usize, z)] = 15; while y > 0 - && !tables.edge_occluded( - states[at(x, y as usize, z)] as usize, - states[at(x, y as usize - 1, z)] as usize, + && !tables.packed_edge_occluded( + states[at(x, y as usize, z)], + states[at(x, y as usize - 1, z)], ) { y -= 1; @@ -263,7 +355,7 @@ pub fn light_chunk( } for z in 0..W { for x in 0..W { - if !present(x, z) || !sky_light { + if !present[z * W + x] || !sky_light { continue; } let own = lowest[z * W + x]; @@ -274,7 +366,7 @@ pub fn light_chunk( (x, z.wrapping_sub(1)), (x, z + 1), ] { - if nx < W && nz < W && present(nx, nz) { + if nx < W && nz < W && present[nz * W + nx] { deepest = deepest.max(lowest[nz * W + nx]); } } @@ -298,24 +390,40 @@ pub fn light_chunk( let x = p % W; let z = (p / W) % W; let y = p / (W * W); - let from = states[p] as usize; - for (d, (ox, oy, oz)) in OFFSETS.iter().enumerate() { - let (nx, ny, nz) = (x as i32 + ox, y as i32 + oy, z as i32 + oz); - if nx < 0 || nz < 0 || ny < 0 || nx >= W as i32 || nz >= W as i32 || ny >= h as i32 - { - continue; - } - let (nx, ny, nz) = (nx as usize, ny as usize, nz as usize); - if !present(nx, nz) { - continue; - } - let q = at(nx, ny, nz); - let to = states[q] as usize; - let next = level.saturating_sub(tables.cells[to].dampening.max(1)); - if next > light[q] && !tables.blocked(from, to, d) { - light[q] = next; - queue.push_back(q as u32); - } + let from = states[p]; + let col = z * W + x; + // Neighbours by linear offset; `present` only depends on the + // column, and the axis bounds rule out wrapping. + macro_rules! neighbour { + ($d:expr, $q:expr, $ncol:expr) => {{ + if present[$ncol] { + let q = $q; + let to = states[q]; + let next = level.saturating_sub((to & 0xF).max(1) as u8); + if next > light[q] && !tables.packed_blocked(from, to, $d) { + light[q] = next; + queue.push_back(q as u32); + } + } + }}; + } + if y > 0 { + neighbour!(0, p - W * W, col); + } + if y + 1 < h { + neighbour!(1, p + W * W, col); + } + if z > 0 { + neighbour!(2, p - W, col - W); + } + if z + 1 < W { + neighbour!(3, p + W, col + W); + } + if x > 0 { + neighbour!(4, p - 1, col - 1); + } + if x + 1 < W { + neighbour!(5, p + 1, col + 1); } } }; @@ -624,17 +732,17 @@ mod tests { shaped: faces.iter().any(|f| *f != EMPTY), faces, }; - LightTables { - cells: vec![ + LightTables::from_parts( + vec![ cell(0, 0, [EMPTY; 6]), cell(15, 0, [FULL; 6]), cell(0, 14, [EMPTY; 6]), cell(0, 0, [FULL, EMPTY, 2, 2, 2, 2]), ], // empty, full, half: only pairs with a full face cover the square. - occludes: vec![false, true, false, true, true, true, false, true, false], - faces: 3, - } + vec![false, true, false, true, true, true, false, true, false], + 3, + ) } fn world(edit: impl Fn(&mut Chunk)) -> HashMap<(i32, i32), Arc> { let mut chunks = HashMap::new(); From a5edc14b973a266c1b9b5b2ef5760e54ecf8d980 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sat, 17 Oct 2026 23:52:47 +0100 Subject: [PATCH 033/163] Startup stage 3c: keep world entry responsive while joining resources (#712) --- crates/horizon-client/src/game.rs | 150 +++++++++++++++++++-- crates/horizon-client/src/game/backdrop.rs | 3 +- crates/horizon-client/src/game/remote.rs | 6 + docs/performance/startup-stage-3.md | 2 +- 4 files changed, 148 insertions(+), 13 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 33b371824..ef91dbff1 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -880,6 +880,7 @@ struct Game<'a> { /// Shared with an integrated server; `collision` and `motion` borrow from it. res: Arc, rest_loader: Option, + pending_entry: Option, world_renderer_ready: bool, collision: &'a BlockCollisionRegistry<'a>, motion: &'a MotionResources, @@ -6359,6 +6360,15 @@ impl Game<'_> { creative: bool, create: Option<&horizon_client::title::WorldOptions>, ) -> Result<()> { + if self.defer_world_entry(PendingWorldEntry::Local { + folder: folder.to_owned(), + name: name.map(str::to_owned), + seed, + creative, + create: create.cloned().map(Box::new), + })? { + return Ok(()); + } self.join_world_rest()?; let save_root = std::env::current_dir()?.join("saves").join(folder); if integrated::wanted(&self.options, &save_root) { @@ -8600,6 +8610,19 @@ impl Game<'_> { Ok(()) } fn render(&mut self) -> Result { + if self.pending_entry.is_some() { + if let (Some(renderer), Some(loader)) = (&mut self.renderer, &self.rest_loader) { + let mut hud = HudBatch::new([renderer.config.width, renderer.config.height]); + horizon_client::level_loading::draw_progress( + &mut hud, + &self.gui.atlas, + loader.progress.line(), + loader.progress.fraction(), + ); + return renderer.render(&loading_frame(&hud)); + } + return Ok(false); + } self.poll_shader_pack(); let Some(size) = self .renderer @@ -9411,6 +9434,16 @@ impl ApplicationHandler for Game<'_> { // The press state of Horizon-style buttons. horizon_client::ui_theme::set_pressed(*state == ElementState::Pressed); } + if self.pending_entry.is_some() + && !matches!( + &event, + WindowEvent::CloseRequested + | WindowEvent::Resized(_) + | WindowEvent::RedrawRequested + ) + { + return; + } let result: Result<()> = (|| { match event { WindowEvent::CloseRequested => { @@ -10057,7 +10090,7 @@ impl ApplicationHandler for Game<'_> { } } fn about_to_wait(&mut self, event_loop: &ActiveEventLoop) { - if let Err(error) = self.poll_world_rest() { + if let Err(error) = self.resume_world_entry() { self.error = Some(error); event_loop.exit(); return; @@ -10155,6 +10188,7 @@ impl<'a> Game<'a> { Ok(Game { res: res.clone(), rest_loader: None, + pending_entry: None, world_renderer_ready: false, collision: res.collision(), motion: res.motion(), @@ -10453,12 +10487,37 @@ enum LoaderMsg { Done(std::result::Result), } +enum PendingWorldEntry { + Local { + folder: String, + name: Option, + seed: Option, + creative: bool, + create: Option>, + }, + Server { + address: String, + name: String, + }, +} + struct WorldRestLoader { + progress: Progress, handle: JoinHandle>, started: Instant, } impl WorldRestLoader { + fn ready(&self) -> Result { + if self.handle.is_finished() { + return Ok(true); + } + if self.started.elapsed() > Duration::from_secs(120) { + return Err("world resource loading timed out after 120 seconds".into()); + } + Ok(false) + } + fn finish(self) -> Result<()> { self.handle .join() @@ -10468,22 +10527,54 @@ impl WorldRestLoader { } impl Game<'_> { + fn defer_world_entry(&mut self, entry: PendingWorldEntry) -> Result { + self.poll_world_rest()?; + if self.rest_loader.is_none() { + return Ok(false); + } + self.perf.world_opening(); + if self.title.is_none() { + self.title = Some(Title::new( + std::env::current_dir()?.join("saves"), + &self.options.resources, + )); + } + self.pending_entry = Some(entry); + log::info!("Horizon: world entry waiting for world resources"); + Ok(true) + } + + fn resume_world_entry(&mut self) -> Result<()> { + self.poll_world_rest()?; + if self.rest_loader.is_some() { + return Ok(()); + } + match self.pending_entry.take() { + Some(PendingWorldEntry::Local { + folder, + name, + seed, + creative, + create, + }) => { + self.open_world(&folder, name.as_deref(), seed, creative, create.as_deref())?; + } + Some(PendingWorldEntry::Server { address, name }) => { + self.connect_server(&address, &name)?; + } + None => {} + } + Ok(()) + } + fn poll_world_rest(&mut self) -> Result<()> { - if self - .rest_loader - .as_ref() - .is_some_and(|loader| loader.handle.is_finished()) + if let Some(loader) = &self.rest_loader + && loader.ready()? { self.rest_loader .take() .ok_or("missing world loader")? .finish()?; - } else if self - .rest_loader - .as_ref() - .is_some_and(|loader| loader.started.elapsed() > Duration::from_secs(120)) - { - return Err("world resource loading timed out after 120 seconds".into()); } Ok(()) } @@ -10704,6 +10795,7 @@ fn load_resources( let rest_loader = if menu { let resources = resources.clone(); let root = root.clone(); + let rest_progress = progress.clone(); let progress = progress.clone(); let handle = std::thread::Builder::new() .name("world-rest-loader".into()) @@ -10730,6 +10822,7 @@ fn load_resources( Ok(()) })?; Some(WorldRestLoader { + progress: rest_progress, handle, started: Instant::now(), }) @@ -11607,9 +11700,43 @@ mod tests { assert!(hud_overlays::sleep_overlay(320, 240, timer as i32).is_empty()); } + #[test] + fn world_rest_poll_does_not_wait_for_a_blocked_worker() { + let (release, wait) = std::sync::mpsc::channel(); + let loader = WorldRestLoader { + progress: Progress::new(), + handle: std::thread::spawn(move || { + wait.recv().unwrap(); + Ok(()) + }), + started: Instant::now(), + }; + assert!(!loader.ready().unwrap()); + release.send(()).unwrap(); + loader.finish().unwrap(); + } + + #[test] + fn world_rest_poll_reports_a_stalled_worker() { + let (release, wait) = std::sync::mpsc::channel(); + let loader = WorldRestLoader { + progress: Progress::new(), + handle: std::thread::spawn(move || { + wait.recv().unwrap(); + Ok(()) + }), + started: Instant::now() - Duration::from_secs(121), + }; + let error = loader.ready().unwrap_err().to_string(); + release.send(()).unwrap(); + loader.finish().unwrap(); + assert_eq!(error, "world resource loading timed out after 120 seconds"); + } + #[test] fn world_rest_worker_failure_reaches_the_client() { let loader = WorldRestLoader { + progress: Progress::new(), handle: std::thread::spawn(|| Err("missing world table".to_owned())), started: Instant::now(), }; @@ -11622,6 +11749,7 @@ mod tests { #[test] fn world_rest_worker_panic_reaches_the_client() { let loader = WorldRestLoader { + progress: Progress::new(), handle: std::thread::spawn(|| panic!("broken loader")), started: Instant::now(), }; diff --git a/crates/horizon-client/src/game/backdrop.rs b/crates/horizon-client/src/game/backdrop.rs index 40ede0db5..d9795c629 100644 --- a/crates/horizon-client/src/game/backdrop.rs +++ b/crates/horizon-client/src/game/backdrop.rs @@ -71,7 +71,8 @@ impl Game<'_> { } /// Called every frame while the title is up. pub(super) fn update_backdrop(&mut self) -> Result<()> { - let wanted = self.title.is_some() + let wanted = self.pending_entry.is_none() + && self.title.is_some() && horizon_client::ui_theme::horizon() && self.world_renderer_ready && self.renderer.is_some() diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index d4a2ba6b2..5afa035f0 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -165,6 +165,12 @@ fn number_format(f: &play::NumberFormat) -> horizon_client::scoreboard::NumberFo impl Game<'_> { /// Leave the title for a server (ConnectScreen): an empty world fed by the connection. pub(super) fn connect_server(&mut self, address: &str, name: &str) -> Result<()> { + if self.defer_world_entry(super::PendingWorldEntry::Server { + address: address.to_owned(), + name: name.to_owned(), + })? { + return Ok(()); + } self.join_world_rest()?; if let Err(error) = self.join_server(address, name, None) { log::warn!("Horizon: could not join server: {error}"); diff --git a/docs/performance/startup-stage-3.md b/docs/performance/startup-stage-3.md index 57ab0a54c..3c05cf067 100644 --- a/docs/performance/startup-stage-3.md +++ b/docs/performance/startup-stage-3.md @@ -1,6 +1,6 @@ # Progressive world resources (#712) -Stage 3a changes shared resource storage and accessors. Pack resources keep their existing per-game ownership for pack reloads. Stage 3b publishes core before the simulation tail, builds the real renderer using the previous device after releasing its surface, and gates backdrop streaming on that renderer. World entry joins the tail before sharing resources with an integrated server. The synchronous harness and dedicated path returns only fully loaded resources. +Stage 3a changes shared resource storage and accessors. Pack resources keep their existing per-game ownership for pack reloads. Stage 3b publishes core before the simulation tail, builds the real renderer using the previous device after releasing its surface, and gates backdrop streaming on that renderer. Stage 3c queues an early Play or Connect action and draws the existing level-loading progress screen while polling the worker each event-loop turn. Close and resize events continue to work. After the worker completes, the queued local/server action resumes; integrated servers receive the resource handle only after that join. The synchronous harness and dedicated path returns only fully loaded resources. Startup logs distinguish `core-ready`, `world renderer ready`, `starting title backdrop`, and `rest-ready`. Opt-in performance summaries carry `to_core_ms` and `to_rest_ms` separately from the existing UI-driven `to_title_ms`. Loader failures and panics propagate to the client; a tail taking more than 120 seconds fails rather than waiting indefinitely. From 08532d6b1fee64057d14f9f5d121f3c70c7a0022 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sun, 18 Oct 2026 00:02:25 +0100 Subject: [PATCH 034/163] Report the active tail phase while world entry waits --- crates/horizon-client/src/game.rs | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index ef91dbff1..0a36ef43b 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -10865,14 +10865,14 @@ fn load_world_rest( let biomes = resources.biomes(); let threads = resources.threads(); let registry_owner = assets; + progress.set(6); let mob_data = horizon_client::mobs::MobData::load(root, facts); horizon_client::mobs::trial_spawner::load_registry(root); let items = Items::load(root, assets.registry, facts)?; log::info!("load items: {:.2}s", started.elapsed().as_secs_f32()); - progress.set(6); - let recipes = Recipes::load(root, &items)?; progress.set(7); + let recipes = Recipes::load(root, &items)?; let transformers = horizon_client::block_transform::Transformers::load(root, assets.registry)?; log::info!( "Horizon: resources loaded in {:.1}s; {} block states, {} items, {} biomes; {} worker threads", From 33c6578f5a6d44a1f15043093779e8d6adf099bc Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sun, 18 Oct 2026 00:04:51 +0100 Subject: [PATCH 035/163] Log whether the tail is ready when the live backdrop fades in --- crates/horizon-client/src/game/backdrop.rs | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/crates/horizon-client/src/game/backdrop.rs b/crates/horizon-client/src/game/backdrop.rs index d9795c629..3a5ec81d6 100644 --- a/crates/horizon-client/src/game/backdrop.rs +++ b/crates/horizon-client/src/game/backdrop.rs @@ -129,6 +129,10 @@ impl Game<'_> { .is_some_and(|r| r.section_count() > 40) { self.backdrop.ready = Some(Instant::now()); + log::info!( + "Horizon: title backdrop ready; world rest ready: {}", + self.res.rest.get().is_some() + ); } Ok(()) } From 68475af653649d5ad8529592c610dcc7f908c1e1 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sun, 18 Oct 2026 00:35:17 +0100 Subject: [PATCH 036/163] Startup stage 3d: make the menu interactive before world core loads (#712) --- crates/horizon-client/src/game.rs | 158 ++-- crates/horizon-client/src/game/packs.rs | 19 +- .../horizon-client/src/game/startup_menu.rs | 777 ++++++++++++++++++ crates/horizon-client/src/telemetry.rs | 19 + docs/performance/startup-stage-3.md | 12 + 5 files changed, 897 insertions(+), 88 deletions(-) create mode 100644 crates/horizon-client/src/game/startup_menu.rs diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 0a36ef43b..10e55f276 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -120,6 +120,7 @@ mod sign_edit; mod sniffers; mod spawner; mod spill; +mod startup_menu; mod station_control; mod stations; mod stats; @@ -881,6 +882,7 @@ struct Game<'a> { res: Arc, rest_loader: Option, pending_entry: Option, + pending_pack_reload: bool, world_renderer_ready: bool, collision: &'a BlockCollisionRegistry<'a>, motion: &'a MotionResources, @@ -9434,6 +9436,15 @@ impl ApplicationHandler for Game<'_> { // The press state of Horizon-style buttons. horizon_client::ui_theme::set_pressed(*state == ElementState::Pressed); } + if self.pending_entry.is_some() + && matches!(&event, WindowEvent::KeyboardInput { event, .. } + if event.state == ElementState::Pressed + && event.physical_key == PhysicalKey::Code(KeyCode::Escape)) + { + self.pending_entry = None; + self.perf.cancel_world_opening(); + return; + } if self.pending_entry.is_some() && !matches!( &event, @@ -10189,6 +10200,7 @@ impl<'a> Game<'a> { res: res.clone(), rest_loader: None, pending_entry: None, + pending_pack_reload: false, world_renderer_ready: false, collision: res.collision(), motion: res.motion(), @@ -10483,7 +10495,7 @@ struct Loaded { /// What the background loader publishes: the menu bundle as soon as it is /// ready, then the core bundle with a handle to the rest worker. enum LoaderMsg { - Ui(UiResources), + Ui(UiResources, PathBuf), Done(std::result::Result), } @@ -10549,6 +10561,9 @@ impl Game<'_> { if self.rest_loader.is_some() { return Ok(()); } + if std::mem::take(&mut self.pending_pack_reload) { + self.reload_packs(); + } match self.pending_entry.take() { Some(PendingWorldEntry::Local { folder, @@ -10612,7 +10627,7 @@ const STAGE_LINES: [&str; 10] = [ "Loading items", "Loading recipes", "Loading world resources", - "Starting audio", + "World resources ready", ]; /// The background loader's checkpoint, read by the loading screen each frame. @@ -10658,7 +10673,7 @@ fn load_resources( started: Instant, menu: bool, progress: &Progress, - publish: &mut dyn FnMut(UiResources), + publish: &mut dyn FnMut(UiResources, &std::path::Path), ) -> Result { let requested_root = root.clone(); let threads = settings.horizon.worker_threads(); @@ -10674,7 +10689,7 @@ fn load_resources( "Horizon: UI bundle ready after {} ms", started.elapsed().as_millis() ); - publish(ui); + publish(ui, &root); } else { loaded_gui = Some(ui); } @@ -10715,7 +10730,7 @@ fn load_resources( "Horizon: UI bundle ready after {} ms", started.elapsed().as_millis() ); - publish(ui); + publish(ui, &root); } else { loaded_gui = Some(ui); } @@ -10760,11 +10775,13 @@ fn load_resources( let pack = PackResources::load(&root, assets.clone(), render, &facts, biomes.clone(), light)?; log::info!("load pack tables: {:.2}s", started.elapsed().as_secs_f32()); progress.set(4); - horizon_client::ui::load_metadata(&root); - horizon_client::lang::set(horizon_client::lang::Language::load( - &[&root], - &settings.language, - )); + if !menu { + horizon_client::ui::load_metadata(&root); + horizon_client::lang::set(horizon_client::lang::Language::load( + &[&root], + &settings.language, + )); + } let registry_owner = assets.clone(); let collision = collisions::load(&root, registry_owner.registry)?; let motion = MotionResources::load(&root, ®istry_owner)?; @@ -10814,6 +10831,7 @@ fn load_resources( .rest .set(rest) .map_err(|_| "world resources already loaded".to_owned())?; + progress.set(9); horizon_client::telemetry::mark_rest_ready(); log::info!( "Horizon: rest-ready after {} ms", @@ -11221,6 +11239,7 @@ struct Loading { loaded: Option>, handle: Option>, shown: bool, + menu: startup_menu::StartupMenu, error: Option>, } impl Loading { @@ -11271,25 +11290,22 @@ impl Loading { if self.window.as_ref().is_none_or(|w| w.id() != id) { return; } - match event { - WindowEvent::CloseRequested => event_loop.exit(), - WindowEvent::Resized(size) => { - if let Some(r) = &mut self.renderer { - r.resize(size.width, size.height); - } - } - WindowEvent::RedrawRequested => self.draw(), - _ => {} + if let Err(error) = self.menu_event(event_loop, event) { + self.error = Some(error); + event_loop.exit(); } } /// The menu bundle arrived: rebuild the loading screen with the real atlas /// and title panorama. - fn set_ui(&mut self, gui: UiResources) { + fn set_ui(&mut self, gui: UiResources, root: PathBuf) { log::info!( "Horizon: loading the title artwork after {} ms", self.started.elapsed().as_millis() ); + self.menu.set_root(root, &self.settings); self.gui = Some(gui); + horizon_client::ui_theme::reset_atlas(); + self.apply_menu_settings(); let Some(window) = self.window.clone() else { return; }; @@ -11308,28 +11324,10 @@ impl Loading { } } fn about_to_wait(&mut self, event_loop: &ActiveEventLoop) { - if self.loaded.is_none() { - loop { - match self.receiver.try_recv() { - Ok(LoaderMsg::Ui(gui)) => self.set_ui(gui), - Ok(LoaderMsg::Done(result)) => { - self.loaded = Some(result); - break; - } - Err(TryRecvError::Empty) => break, - Err(TryRecvError::Disconnected) => { - if self.loaded.is_none() { - if let Some(handle) = self.handle.take() { - let _ = handle.join(); - } - self.error = Some("resource loader stopped before finishing".into()); - event_loop.exit(); - return; - } - break; - } - } - } + if let Err(error) = self.poll_menu_resources() { + self.error = Some(error); + event_loop.exit(); + return; } if let Some(w) = &self.window { if self.options.as_ref().is_some_and(|o| o.offscreen) { @@ -11341,22 +11339,24 @@ impl Loading { event_loop.set_control_flow(ControlFlow::Poll); } fn draw(&mut self) { - let Some(renderer) = self.renderer.as_mut() else { + let Some(size) = self + .renderer + .as_ref() + .map(|r| [r.config.width, r.config.height]) + else { return; }; - let size = [renderer.config.width, renderer.config.height]; let mut batch = HudBatch::new(size); - if let Some(gui) = &self.gui { - horizon_client::level_loading::draw_progress( - &mut batch, - &gui.atlas, - self.progress.line(), - self.progress.fraction(), - ); - } + self.draw_menu(&mut batch); let frame = loading_frame(&batch); - if let Err(e) = renderer.render(&frame) { - log::warn!("Horizon: loading screen frame failed: {e}"); + if let Some(renderer) = &mut self.renderer { + match renderer.render(&frame) { + Ok(true) if self.gui.is_some() && self.menu.pending.is_none() => { + self.menu.perf.title_shown() + } + Ok(_) => {} + Err(e) => log::warn!("Horizon: loading screen frame failed: {e}"), + } } if !self.shown { self.shown = true; @@ -11369,6 +11369,9 @@ impl Loading { fn finish(&mut self, loaded: Loaded) -> Result>> { let mut options = self.options.take().ok_or("loading already finished")?; options.resources = loaded.root.clone(); + // StartupMenu owns world selection until it can hand it to Game. + options.world = None; + options.server = None; let gui = self.gui.take().ok_or("missing menu bundle")?; let window = self.window.clone().ok_or("window closed")?; // Keep the loader's device and swap in the real textures in one step. @@ -11414,6 +11417,8 @@ impl Loading { game.renderer = Some(renderer); game.world_renderer_ready = true; game.fullscreen = self.fullscreen; + self.menu.handoff(&mut game); + game.settings = self.settings.clone(); game.apply_settings(); game.previous = Instant::now(); Ok(Some(game)) @@ -11462,7 +11467,11 @@ impl ApplicationHandler for App { event_loop.exit(); return; } - match loading.loaded.take() { + match if loading.menu.reload_packs { + None + } else { + loading.loaded.take() + } { None => Step::Waiting, Some(Err(e)) => Step::Failed(e.into()), Some(Ok(loaded)) => match loading.finish(loaded) { @@ -11501,31 +11510,11 @@ fn run_loading( pack_error: Option, started: Instant, ) -> Result<()> { + horizon_client::ui_theme::load_preferences(&std::env::current_dir()?); let progress = Progress::new(); - let (sender, receiver) = std::sync::mpsc::channel(); - let loader = { - let progress = progress.clone(); - let settings = settings.clone(); - let vanilla_root = vanilla_root.clone(); - let root = options.resources.clone(); - std::thread::Builder::new() - .name("resource-loader".into()) - .spawn(move || { - let result = load_resources( - root, - &vanilla_root, - &settings, - started, - true, - &progress, - &mut |gui| { - let _ = sender.send(LoaderMsg::Ui(gui)); - }, - ) - .map_err(|e| e.to_string()); - let _ = sender.send(LoaderMsg::Done(result)); - })? - }; + let (receiver, loader) = + startup_menu::spawn_loader(&options, &settings, &vanilla_root, started, &progress)?; + let menu = startup_menu::StartupMenu::new(&options, pack_error.as_deref())?; let loading = Loading { window: None, renderer: None, @@ -11541,6 +11530,7 @@ fn run_loading( loaded: None, handle: Some(loader), shown: false, + menu, error: None, }; let mut app = App::Loading(Box::new(loading)); @@ -11575,6 +11565,9 @@ pub fn run() -> Result<()> { // Snapshots of derived tables live in the game folder, never beside the // shared resources. Behaviours::set_cache_dir(std::env::current_dir()?.join(".horizon-cache")); + if !synchronous_startup(&options) { + return run_loading(options, early_settings, vanilla_root, None, started); + } let mut pack_error = None; options.resources = packs::startup_root(&vanilla_root, &early_settings.resource_packs) .unwrap_or_else(|e| { @@ -11587,11 +11580,6 @@ pub fn run() -> Result<()> { &early_settings.mods.enabled, &options.dev_mods, ); - // Harnesses and dedicated runs stay synchronous; a normal launch enters - // the event loop at once and loads the resources on a worker. - if !synchronous_startup(&options) { - return run_loading(options, early_settings, vanilla_root, pack_error, started); - } let loaded = load_resources( options.resources.clone(), &vanilla_root, @@ -11599,7 +11587,7 @@ pub fn run() -> Result<()> { started, false, &Progress::new(), - &mut |_| {}, + &mut |_, _| {}, )?; let gui = loaded.gui.ok_or("missing menu bundle")?; options.resources = loaded.root.clone(); diff --git a/crates/horizon-client/src/game/packs.rs b/crates/horizon-client/src/game/packs.rs index 76d136b1c..08990d30b 100644 --- a/crates/horizon-client/src/game/packs.rs +++ b/crates/horizon-client/src/game/packs.rs @@ -74,6 +74,15 @@ fn vanilla_info() -> PackInfo { fixed: false, } } +/// Shared by the startup menu, which has no world resources yet. +pub(super) fn pack_infos(vanilla: &Path) -> Vec { + let mut infos: Vec = packs::discover(vanilla, &packs_dir()) + .iter() + .map(info) + .collect(); + infos.push(vanilla_info()); + infos +} impl Game<'_> { fn vanilla_root(&self) -> PathBuf { if self.ui.vanilla_root.as_os_str().is_empty() { @@ -85,9 +94,7 @@ impl Game<'_> { /// The packs the pack screen offers and the current selection /// (`PackSelectionScreen` makes its `PackSelectionModel` from them). pub(super) fn refresh_pack_lists(&mut self) { - let all = packs::discover(&self.vanilla_root(), &packs_dir()); - let mut infos: Vec = all.iter().map(info).collect(); - infos.push(vanilla_info()); + let infos = pack_infos(&self.vanilla_root()); let o = &mut self.ui.options; o.pack_infos = infos; o.pack_selection = self.settings.resource_packs.clone(); @@ -100,6 +107,12 @@ impl Game<'_> { /// particle and font textures), item models, sounds, languages, GUI /// metadata and the cloud and world border textures. pub(super) fn reload_packs(&mut self) { + // Pack reload updates tail-owned mob metadata. Keep menus responsive + // until those resources exist, then apply the latest selection once. + if self.rest_loader.is_some() { + self.pending_pack_reload = true; + return; + } let vanilla = self.vanilla_root(); if self.ui.vanilla_root.as_os_str().is_empty() { self.ui.vanilla_root = vanilla.clone(); diff --git a/crates/horizon-client/src/game/startup_menu.rs b/crates/horizon-client/src/game/startup_menu.rs new file mode 100644 index 000000000..425169023 --- /dev/null +++ b/crates/horizon-client/src/game/startup_menu.rs @@ -0,0 +1,777 @@ +//! The interactive title before world resources exist. Uses only the menu +//! atlas/panorama; transfers the actual screen and queued entry to Game. +use super::*; +use horizon_client::{ + clipboard::{self, AppendSelection, SystemClipboard}, + options_ui::{Event, OptionsUi, Page}, +}; +use winit::{event::KeyEvent, keyboard::ModifiersState}; + +#[derive(Default)] +pub(super) struct StartupMenu { + title: Option, + options: OptionsUi, + options_open: bool, + root: PathBuf, + cursor: (f32, f32), + pointer: (f64, f64), + modifiers: ModifiersState, + physical_keys: HashSet<KeyCode>, + dragging: bool, + clipboard: SystemClipboard, + selection: AppendSelection, + pub pending: Option<PendingWorldEntry>, + pub reload_packs: bool, + pub perf: horizon_client::telemetry::Session, +} + +impl StartupMenu { + pub fn new(options: &Options, pack_error: Option<&str>) -> Result<Self> { + let pending = if let Some(address) = &options.server { + Some(PendingWorldEntry::Server { + address: address.clone(), + name: options.player_name(), + }) + } else { + options + .world + .as_ref() + .map(|folder| PendingWorldEntry::Local { + folder: folder.clone(), + name: None, + seed: Some(options.seed), + creative: options.creative, + create: None, + }) + }; + let mut menu = Self { + pending, + ..Default::default() + }; + menu.root = options.resources.clone(); + if let Some(error) = pack_error { + menu.options.open_at(false, Page::Packs); + menu.options.resource_error = Some(error.to_owned()); + menu.options_open = true; + } + if menu.pending.is_some() { + menu.perf.world_opening(); + } + Ok(menu) + } + + pub(super) fn set_root(&mut self, root: PathBuf, settings: &Settings) { + horizon_client::ui::load_metadata(&root); + horizon_client::lang::set(horizon_client::lang::Language::load( + &[&root], + &settings.language, + )); + self.root = root; + if self.title.is_none() { + let mut title = Title::new( + std::env::current_dir().unwrap_or_default().join("saves"), + &self.root, + ); + title.last_server = settings.file.string("lastServer"); + if horizon_client::ui_theme::horizon() { + title + .opening + .set(Some(horizon_client::front::Opening::new())); + } + self.title = Some(title); + } + } + + pub(super) fn handoff(&mut self, game: &mut Game<'_>) { + game.title = self.title.take(); + game.pending_entry = self.pending.take(); + game.cursor = self.cursor; + game.modifiers = self.modifiers; + game.physical_keys = std::mem::take(&mut self.physical_keys); + game.clipboard = std::mem::take(&mut self.clipboard); + game.text_selection = std::mem::take(&mut self.selection); + game.perf = std::mem::take(&mut self.perf); + // Preserve an existing resource-error screen opened by start_game. + if self.options_open { + let resource_error = game.ui.options.resource_error.take(); + game.ui.options = std::mem::take(&mut self.options); + game.ui.options.resource_error = + game.ui.options.resource_error.take().or(resource_error); + game.screen = Screen::Options; + game.options_from_title = true; + game.dragging = self.dragging; + } + } + + fn queue_entry(&mut self, action: Action, player_name: String) { + let entry = match action { + Action::Play { folder } => PendingWorldEntry::Local { + folder, + name: None, + seed: None, + creative: false, + create: None, + }, + Action::Create { + folder, + name, + seed, + creative, + options, + } => PendingWorldEntry::Local { + folder, + name: Some(name), + seed, + creative, + create: Some(Box::new(options)), + }, + Action::Connect { address } => PendingWorldEntry::Server { + address, + name: player_name, + }, + _ => return, + }; + self.pending = Some(entry); + self.perf.world_opening(); + } + + fn shortcut(&mut self, event: &KeyEvent) -> Option<clipboard::EditShortcut> { + let edit = if cfg!(target_os = "macos") { + self.modifiers.super_key() + } else { + self.modifiers.control_key() + }; + clipboard::edit_shortcut( + clipboard::shortcut_letter(&event.logical_key, event.physical_key), + edit, + self.modifiers.shift_key(), + self.modifiers.alt_key(), + ) + } + + fn title_key(&mut self, event: &KeyEvent) { + let shortcut = self.shortcut(event); + let Some(title) = &mut self.title else { return }; + if title.skip_opening() { + return; + } + if let Some(shortcut) = shortcut { + if title.has_caret_field() { + title.field_shortcut(shortcut, &mut self.clipboard); + } else if let Some((id, value, max)) = title.focused_field() + && self + .selection + .apply(id, value, shortcut, &mut self.clipboard, |v, t| { + clipboard::append_limited(v, t, max) + }) + { + title.search_changed(); + } + return; + } + match event.physical_key { + PhysicalKey::Code(KeyCode::Escape) => title.escape(), + PhysicalKey::Code(KeyCode::Tab) => title.tab(), + PhysicalKey::Code(KeyCode::Enter | KeyCode::NumpadEnter) => title.confirm_edit(), + PhysicalKey::Code( + key @ (KeyCode::Backspace + | KeyCode::Delete + | KeyCode::ArrowLeft + | KeyCode::ArrowRight + | KeyCode::Home + | KeyCode::End), + ) if title.has_caret_field() => { + title.field_key( + key, + self.modifiers.control_key(), + self.modifiers.shift_key(), + ); + } + _ => { + let cleared = !title.has_caret_field() + && title + .focused_field() + .is_some_and(|(id, value, _)| self.selection.take(id, value)); + if cleared { + title.search_changed(); + } + if event.physical_key == PhysicalKey::Code(KeyCode::Backspace) { + if !cleared { + title.backspace(); + } + } else if let Some(text) = &event.text { + title.type_text(text); + } + } + } + } +} + +/// Each generation has its own channel and progress. Pack changes wait for the +/// old tail before starting another generation, including cache/global writes. +pub(super) fn spawn_loader( + options: &Options, + settings: &Settings, + vanilla_root: &std::path::Path, + started: Instant, + progress: &Progress, +) -> Result<(Receiver<LoaderMsg>, JoinHandle<()>)> { + let (sender, receiver) = std::sync::mpsc::channel(); + let settings = settings.clone(); + let vanilla_root = vanilla_root.to_path_buf(); + let dev_mods = options.dev_mods.clone(); + let progress = progress.clone(); + let handle = std::thread::Builder::new() + .name("resource-loader".into()) + .spawn(move || { + let mut pack_error = None; + let root = packs::startup_root(&vanilla_root, &settings.resource_packs).unwrap_or_else( + |error| { + pack_error = Some(error.to_string()); + vanilla_root.clone() + }, + ); + let root = mods::content_root(&root, &settings.mods.enabled, &dev_mods); + let result = load_resources( + root, + &vanilla_root, + &settings, + started, + true, + &progress, + &mut |gui, root| { + let _ = sender.send(LoaderMsg::Ui(gui, root.to_path_buf())); + }, + ) + .map(|mut loaded| { + loaded.pack_error = loaded.pack_error.or(pack_error); + loaded + }) + .map_err(|error| error.to_string()); + let _ = sender.send(LoaderMsg::Done(result)); + })?; + Ok((receiver, handle)) +} + +impl Loading { + pub(super) fn poll_menu_resources(&mut self) -> Result<()> { + if self.loaded.is_none() { + loop { + match self.receiver.try_recv() { + Ok(LoaderMsg::Ui(gui, root)) => self.set_ui(gui, root), + Ok(LoaderMsg::Done(result)) => { + self.loaded = Some(result); + break; + } + Err(TryRecvError::Empty) => break, + Err(TryRecvError::Disconnected) => { + if let Some(handle) = self.handle.take() { + let _ = handle.join(); + } + return Err("resource loader stopped before finishing".into()); + } + } + } + } + self.restart_menu_resources() + } + pub(super) fn apply_menu_settings(&mut self) { + if let Some(renderer) = &mut self.renderer { + self.settings + .clamp_gui_scale([renderer.config.width as i32, renderer.config.height as i32]); + renderer.gamma = self.settings.gamma; + renderer.set_present_mode(self.settings.vsync, self.settings.horizon.present_mode); + } + horizon_client::hud::GUI_SCALE.store(self.settings.gui_scale, Ordering::Relaxed); + if let Some(gui) = &mut self.gui { + gui.atlas.font.uniform = self.settings.force_unicode; + gui.atlas.font.japanese = self.settings.japanese_glyphs; + } + if let Some(window) = &self.window + && let Some(want) = self.fullscreen.request(self.settings.fullscreen) + { + window.set_fullscreen(want.then_some(winit::window::Fullscreen::Borderless(None))); + } + self.update_menu_cursor(); + } + + fn update_menu_cursor(&mut self) { + let batch = HudBatch::new(self.menu_size()); + self.menu.cursor = ( + self.menu.pointer.0 as f32 / batch.scale, + self.menu.pointer.1 as f32 / batch.scale, + ); + } + + fn menu_size(&self) -> [u32; 2] { + self.renderer + .as_ref() + .map_or([1280, 720], |r| [r.config.width, r.config.height]) + } + + fn save_menu_address(&mut self) { + if self + .menu + .title + .as_ref() + .is_some_and(|title| title.last_server != self.settings.file.string("lastServer")) + { + self.save_menu_settings(); + } + } + + fn save_menu_settings(&mut self) { + if let Some(title) = &self.menu.title { + self.settings.file.set( + "lastServer", + horizon_client::options_file::V::Str(title.last_server.clone()), + ); + } + self.settings.save(&Game::options_path()); + } + + fn open_menu_options(&mut self, page: Page) { + self.menu.options.open_at(false, page); + self.menu.options.languages = horizon_client::lang::available(&[&self.menu.root]); + self.menu.options.pack_infos = packs::pack_infos(&self.vanilla_root); + self.menu.options.pack_selection = self.settings.resource_packs.clone(); + self.menu.options.pack_screen = None; + self.menu.options_open = true; + } + + fn menu_option_events(&mut self, events: Vec<Event>) { + for event in events { + match event { + Event::Changed => { + self.save_menu_settings(); + self.apply_menu_settings(); + } + Event::Close if self.menu.options.resource_error.is_some() => {} + Event::Close => { + self.menu.options_open = false; + self.menu.dragging = false; + self.save_menu_settings(); + } + Event::Language(code) => { + horizon_client::lang::set(horizon_client::lang::Language::load( + &[&self.menu.root], + &code, + )); + self.save_menu_settings(); + } + Event::Packs(_) => { + self.save_menu_settings(); + self.menu.reload_packs = true; + } + Event::OpenPackFolder => { + let dir = packs::packs_dir(); + let _ = std::fs::create_dir_all(&dir); + packs::open_folder(&dir); + } + Event::ButtonClick => {} + } + } + } + + fn menu_options_click(&mut self, drag: bool, right: bool) { + let size = self.menu_size(); + let batch = HudBatch::new(size); + let Some(gui) = &self.gui else { return }; + let events = self.menu.options.click( + &mut self.settings, + &gui.atlas, + self.menu.cursor.0, + self.menu.cursor.1, + (batch.width, batch.height), + [size[0] as i32, size[1] as i32], + drag, + right, + ); + self.menu_option_events(events); + } + + fn menu_action(&mut self, event_loop: &ActiveEventLoop, action: Action) { + match action { + Action::Quit => event_loop.exit(), + Action::Options => self.open_menu_options(Page::Main), + Action::Accessibility => self.open_menu_options(Page::Accessibility), + Action::Language => self.open_menu_options(Page::Language), + action => { + let name = self + .options + .as_ref() + .map_or_else(|| "Player".into(), |o| o.player_name()); + self.menu.queue_entry(action, name); + } + } + self.save_menu_address(); + } + + pub(super) fn menu_event( + &mut self, + event_loop: &ActiveEventLoop, + event: WindowEvent, + ) -> Result<()> { + if let WindowEvent::MouseInput { + state, + button: MouseButton::Left, + .. + } = &event + { + horizon_client::ui_theme::set_pressed(*state == ElementState::Pressed); + } + if let WindowEvent::KeyboardInput { event, .. } = &event + && let PhysicalKey::Code(key) = event.physical_key + { + if event.state == ElementState::Pressed { + self.menu.physical_keys.insert(key); + } else { + self.menu.physical_keys.remove(&key); + } + } + match event { + WindowEvent::CloseRequested => { + self.save_menu_settings(); + event_loop.exit(); + } + WindowEvent::Resized(size) => { + if let Some(r) = &mut self.renderer { + r.resize(size.width, size.height); + } + self.apply_menu_settings(); + } + WindowEvent::RedrawRequested => self.draw(), + WindowEvent::ModifiersChanged(modifiers) => self.menu.modifiers = modifiers.state(), + WindowEvent::Focused(false) => { + self.menu.modifiers = ModifiersState::empty(); + self.menu.physical_keys.clear(); + horizon_client::ui_theme::set_pressed(false); + self.menu.dragging = false; + if let Some(title) = &mut self.menu.title { + title.release(); + title.release_field(); + } + let events = self.menu.options.release(); + self.menu_option_events(events); + } + WindowEvent::KeyboardInput { event, .. } + if event.state == ElementState::Pressed && self.menu.pending.is_some() => + { + if event.physical_key == PhysicalKey::Code(KeyCode::Escape) { + self.menu.pending = None; + self.menu.perf.cancel_world_opening(); + } + } + _ if self.gui.is_none() || self.menu.pending.is_some() => {} + WindowEvent::CursorMoved { position, .. } => { + self.menu.pointer = (position.x, position.y); + self.update_menu_cursor(); + if self.menu.options_open && self.menu.dragging { + self.menu_options_click(true, false); + } else if let Some(title) = &mut self.menu.title { + let size = self + .renderer + .as_ref() + .map_or([1280, 720], |r| [r.config.width, r.config.height]); + let b = HudBatch::new(size); + title.drag(self.menu.cursor, (b.width, b.height)); + title.drag_field(&self.gui.as_ref().unwrap().atlas, self.menu.cursor.0); + } + } + WindowEvent::MouseInput { state, button, .. } if self.menu.options_open => { + if state == ElementState::Pressed && self.menu.options.selected_key.is_some() { + let events = self.menu.options.bind_mouse(&mut self.settings, button); + self.menu_option_events(events); + } else if matches!(button, MouseButton::Left | MouseButton::Right) { + if state == ElementState::Pressed { + self.menu.dragging = button == MouseButton::Left; + self.menu_options_click(false, button == MouseButton::Right); + } else if button == MouseButton::Left { + self.menu.dragging = false; + let events = self.menu.options.release(); + self.menu_option_events(events); + } + } + } + WindowEvent::MouseInput { + state, + button: MouseButton::Left, + .. + } => { + let mut batch = HudBatch::new(self.menu_size()); + if let (Some(title), Some(gui)) = (&mut self.menu.title, &self.gui) { + if state == ElementState::Released { + title.release(); + title.release_field(); + } else { + let action = if horizon_client::ui_theme::horizon() { + let action = title.click_horizon( + &gui.atlas, + &mut batch, + self.menu.cursor.0, + self.menu.cursor.1, + ); + // Horizon's deeper world-management pages use classic fields. + title.press_field( + &gui.atlas, + self.menu.cursor, + (batch.width, batch.height), + self.menu.modifiers.shift_key(), + ); + action + } else { + let (action, _) = title.click( + self.menu.cursor.0, + self.menu.cursor.1, + (batch.width, batch.height), + ); + title.press_field( + &gui.atlas, + self.menu.cursor, + (batch.width, batch.height), + self.menu.modifiers.shift_key(), + ); + action + }; + self.menu_action(event_loop, action); + } + } + } + WindowEvent::MouseWheel { delta, .. } => { + let raw = match delta { + MouseScrollDelta::LineDelta(_, y) => y, + MouseScrollDelta::PixelDelta(p) => (p.y / 30.0) as f32, + }; + let amount = if self.settings.discrete_scroll { + horizon_client::mouse::java_signum(f64::from(raw)) as f32 + } else { + raw + } * self.settings.mouse_wheel_sensitivity; + let batch = HudBatch::new(self.menu_size()); + if self.menu.options_open { + self.menu.options.scroll_at( + &self.settings, + (batch.width, batch.height), + self.menu.cursor, + amount, + ); + } else if let Some(title) = &mut self.menu.title { + title.scroll_worlds(amount, self.menu.cursor, (batch.width, batch.height)); + } + } + WindowEvent::KeyboardInput { event, .. } if event.state == ElementState::Pressed => { + if event.physical_key == PhysicalKey::Code(KeyCode::F11) { + self.settings.fullscreen = !self.settings.fullscreen; + self.apply_menu_settings(); + self.save_menu_settings(); + } else if self.menu.options_open { + let shortcut = self.menu.shortcut(&event); + let atlas = &self.gui.as_ref().unwrap().atlas; + let handled = shortcut.is_some_and(|s| { + self.menu + .options + .shortcut(atlas, s, &mut self.menu.clipboard) + }); + if !handled && let PhysicalKey::Code(key) = event.physical_key { + let events = self.menu.options.key( + &mut self.settings, + atlas, + key, + event.text.as_deref(), + ); + self.menu_option_events(events); + } + } else { + self.menu.title_key(&event); + self.save_menu_address(); + } + } + _ => {} + } + Ok(()) + } + + pub(super) fn draw_menu(&mut self, batch: &mut HudBatch) { + let Some(gui) = &self.gui else { return }; + if self.menu.pending.is_some() { + horizon_client::level_loading::draw_progress( + batch, + &gui.atlas, + self.progress.line(), + self.progress.fraction(), + ); + } else if self.menu.options_open { + self.menu + .options + .draw(&self.settings, batch, &gui.atlas, self.menu.cursor); + } else if let Some(title) = &mut self.menu.title { + title.poll_backup(); + let _ = title.update_toast(self.settings.notification_display_time); + if horizon_client::ui_theme::horizon() { + let mut ui = horizon_client::ui_theme::Ui::new(&gui.atlas, batch, self.menu.cursor); + title.draw_horizon(&mut ui, 0.0); + ui.finish(); + } else { + title.draw( + &gui.atlas, + batch, + self.menu.cursor, + self.settings.file.bool("hideSplashTexts"), + ); + } + } + } + + pub(super) fn restart_menu_resources(&mut self) -> Result<()> { + if !self.menu.reload_packs || self.loaded.is_none() { + return Ok(()); + } + if let Some(Ok(loaded)) = &mut self.loaded { + if let Some(loader) = &loaded.rest_loader + && !loader.ready()? + { + return Ok(()); + } + if let Some(loader) = loaded.rest_loader.take() + && let Err(error) = loader.finish() + { + log::warn!("Horizon: replaced resource generation failed: {error}"); + } + } + self.loaded = None; + if let Some(handle) = self.handle.take() { + handle.join().map_err(|_| "resource loader panicked")?; + } + self.progress = Progress::new(); + let options = self.options.as_ref().ok_or("loading already finished")?; + let (receiver, handle) = spawn_loader( + options, + &self.settings, + &self.vanilla_root, + self.started, + &self.progress, + )?; + self.receiver = receiver; + self.handle = Some(handle); + self.menu.reload_packs = false; + Ok(()) + } +} + +#[cfg(test)] +mod tests { + use super::*; + + fn gui(root: &std::path::Path) -> UiResources { + UiResources { + atlas: HudAtlas::fonts(root).unwrap(), + panorama: Arc::new(horizon_client::gfx::panorama::Faces { + size: 1, + pixels: [96, 110, 111, 255].repeat(6), + }), + } + } + + fn loading(receiver: Receiver<LoaderMsg>) -> Loading { + Loading { + window: None, + renderer: None, + gui: None, + settings: Settings::default(), + fullscreen: horizon_client::window::FullscreenState::new(false), + options: None, + vanilla_root: PathBuf::new(), + pack_error: None, + started: Instant::now(), + progress: Progress::new(), + receiver, + loaded: None, + handle: None, + shown: false, + menu: StartupMenu::default(), + error: None, + } + } + + #[test] + fn menu_is_usable_while_the_core_worker_is_blocked() { + let root = std::env::temp_dir().join("horizon-startup-menu-no-world-resources"); + let (sender, receiver) = std::sync::mpsc::channel(); + let (release, wait) = std::sync::mpsc::channel(); + let (published, published_rx) = std::sync::mpsc::channel(); + let worker_root = root.clone(); + let worker = std::thread::spawn(move || { + sender + .send(LoaderMsg::Ui(gui(&worker_root), worker_root)) + .unwrap(); + published.send(()).unwrap(); + wait.recv().unwrap(); + sender + .send(LoaderMsg::Done(Err("core failure".into()))) + .unwrap(); + }); + published_rx.recv().unwrap(); + let mut loading = loading(receiver); + loading.poll_menu_resources().unwrap(); + assert!(loading.gui.is_some()); + assert!(loading.loaded.is_none()); + assert!(!worker.is_finished()); + // Navigate and enter a world name without a registry, biomes, pack + // tables or a Game. Replacing fallback artwork preserves this state. + let title = loading.menu.title.as_mut().unwrap(); + title.opening.set(None); + title.mode = horizon_client::title::Mode::Create { + name: String::new(), + seed: "42".into(), + creative: true, + focus: 0, + options: Default::default(), + }; + title.type_text("My world"); + loading.set_ui(gui(&root), root); + let action = loading.menu.title.as_ref().unwrap().create_action(); + loading.menu.queue_entry(action, "Player".into()); + assert!( + matches!(&loading.menu.pending, Some(PendingWorldEntry::Local { + name: Some(name), seed: Some(42), creative: true, create: Some(_), .. + }) if name == "My world") + ); + let mut batch = HudBatch::new([1280, 720]); + loading.draw_menu(&mut batch); + assert!( + !batch.vertices.is_empty(), + "queued entry draws loading progress" + ); + release.send(()).unwrap(); + worker.join().unwrap(); + loading.poll_menu_resources().unwrap(); + assert!(matches!(loading.loaded, Some(Err(ref error)) if error == "core failure")); + } + + #[test] + fn queued_server_keeps_address_and_player_identity() { + let mut menu = StartupMenu::default(); + menu.queue_entry( + Action::Connect { + address: "localhost:25565".into(), + }, + "Guest".into(), + ); + assert!( + matches!(menu.pending.take(), Some(PendingWorldEntry::Server { address, name }) + if address == "localhost:25565" && name == "Guest") + ); + assert!(menu.pending.take().is_none(), "an entry is consumed once"); + } + + #[test] + fn disconnected_core_worker_is_reported_instead_of_waiting_forever() { + let (sender, receiver) = std::sync::mpsc::channel(); + drop(sender); + let mut loading = loading(receiver); + assert_eq!( + loading.poll_menu_resources().unwrap_err().to_string(), + "resource loader stopped before finishing" + ); + } +} diff --git a/crates/horizon-client/src/telemetry.rs b/crates/horizon-client/src/telemetry.rs index c63d82915..d0140f941 100644 --- a/crates/horizon-client/src/telemetry.rs +++ b/crates/horizon-client/src/telemetry.rs @@ -186,6 +186,11 @@ impl Session { self.opening.get_or_insert_with(Instant::now); } + /// An entry queued during startup was cancelled before opening a world. + pub fn cancel_world_opening(&mut self) { + self.opening = None; + } + /// A frame drawn while playing (not in menus or loading). pub fn frame(&mut self, ms: f32) { if let Some(opening) = self.opening.take() @@ -418,6 +423,20 @@ mod tests { assert_eq!(pending[0].1.kind(), Kind::Crash); } + #[test] + fn cancelled_startup_entry_does_not_time_menu_browsing() { + let mut session = Session::default(); + session.world_opening(); + assert!(session.opening.is_some()); + session.cancel_world_opening(); + assert!(session.opening.is_none()); + session.frame(16.0); + assert!(session.to_world_ms.is_none()); + session.world_opening(); + session.frame(16.0); + assert!(session.to_world_ms.is_some()); + } + #[test] fn a_session_is_kept_only_with_consent_and_once_long_enough() { let home = home("session"); diff --git a/docs/performance/startup-stage-3.md b/docs/performance/startup-stage-3.md index 3c05cf067..b6422c191 100644 --- a/docs/performance/startup-stage-3.md +++ b/docs/performance/startup-stage-3.md @@ -4,6 +4,18 @@ Stage 3a changes shared resource storage and accessors. Pack resources keep thei Startup logs distinguish `core-ready`, `world renderer ready`, `starting title backdrop`, and `rest-ready`. Opt-in performance summaries carry `to_core_ms` and `to_rest_ms` separately from the existing UI-driven `to_title_ms`. Loader failures and panics propagate to the client; a tail taking more than 120 seconds fails rather than waiting indefinitely. +## Stage 3d: interactive menu before core + +An ordinary launch now owns a `StartupMenu` inside `Loading`. The first menu atlas and panorama message makes the existing title screens interactive; assets, facts, biomes, pack tables, collision and motion continue on the resource worker. Pack-overlay and mod-content preparation also run on that worker. The live landscape still starts only after the core renderer exists. + +World browsing, world creation, server address entry and options use the existing title/options widgets. Play and Connect queue a `PendingWorldEntry`; the progress screen covers both the core and tail waits. Escape cancels the queued entry in either phase. Close and resize continue to work. The handoff transfers the title object, options screen, settings, cursor, clipboard selection, timing session and pending action instead of rebuilding the user's screen. + +Pack changes during core loading request another loader generation. The old core and tail finish before replacement begins so cache writes and tail registry initialization cannot overlap. Each generation has its own message channel and progress counter. Language/GUI metadata publication stays on the event-loop thread, using the current language selection rather than the worker's stale settings snapshot. Pack changes after the core handoff also wait for the tail before touching mob metadata. + +The menu still needs its own artwork and renderer before interaction. The core handoff still builds the full renderer and starts audio on the main thread; menu click sounds and controller navigation start with `Game`. This stage does not change synchronous harness/dedicated startup or introduce a render-facts export. + +Regression coverage publishes menu artwork while a fake core worker is blocked, edits a world draft, replaces fallback artwork without losing it, queues entry and draws progress, and checks that loader failure reaches the app. Additional checks cover server identity and cancelled-entry timing. + ## Render facts assessment `MeshTables::new` reads names, registry properties, class membership, collision shape flags, fluid and render properties from `BlockFacts`. `LightTables::new/load` reads emission, dampening, occlusion and shape-occlusion flags; geometry comes from `occlusion.nbt`. Neither table needs recipes, item data, AI or the other tail tables. From 1ffdb5f3f5aeb9660bc3a2d5b644a905233cf257 Mon Sep 17 00:00:00 2001 From: LookImEcho-Rick <62575172+LookImEcho-Rick@users.noreply.github.com> Date: Sat, 17 Oct 2026 18:46:50 -0500 Subject: [PATCH 037/163] Add open mod folder buttons Expose the Horizon mods directory from both the Classic and Horizon mods screens, creating it if needed before opening it. Closes #780 --- crates/horizon-client/src/game/options.rs | 5 ++ crates/horizon-client/src/options_horizon.rs | 76 +++++++++++++++++++- crates/horizon-client/src/options_ui.rs | 41 ++++++++++- 3 files changed, 118 insertions(+), 4 deletions(-) diff --git a/crates/horizon-client/src/game/options.rs b/crates/horizon-client/src/game/options.rs index ed0dccb06..d625f938b 100644 --- a/crates/horizon-client/src/game/options.rs +++ b/crates/horizon-client/src/game/options.rs @@ -225,6 +225,11 @@ impl Game<'_> { let _ = std::fs::create_dir_all(&dir); super::packs::open_folder(&dir); } + Event::OpenModFolder => { + let dir = Self::options_path().with_file_name(horizon_client::mod_list::DIR); + let _ = std::fs::create_dir_all(&dir); + super::packs::open_folder(&dir); + } } } Ok(()) diff --git a/crates/horizon-client/src/options_horizon.rs b/crates/horizon-client/src/options_horizon.rs index d3ecab639..11bf3183f 100644 --- a/crates/horizon-client/src/options_horizon.rs +++ b/crates/horizon-client/src/options_horizon.rs @@ -36,6 +36,8 @@ pub enum HRow { Extra(extras::Item), /// Installed mod `i` (`settings.mods.installed`) and its switch. Mod(usize), + /// Opens the directory where Horizon mods are installed. + OpenModFolder, } /// A sidebar section: name, description, rows. pub struct Section { @@ -192,12 +194,15 @@ pub const SECTIONS: &[Section] = &[ name: "Mods", blurb: "Mods made for Horizon, from the horizon-mods folder. Each runs in a sandbox and stays off until you turn it on; check what it may do first.", rows: |s| { + let mut rows = vec![HRow::OpenModFolder]; if s.mods.installed.is_empty() { - return vec![HRow::Header( + rows.push(HRow::Header( "No mods: put .hmod files in the horizon-mods folder", - )]; + )); + } else { + rows.extend((0..s.mods.installed.len()).map(HRow::Mod)); } - (0..s.mods.installed.len()).map(HRow::Mod).collect() + rows }, }, ]; @@ -450,6 +455,18 @@ impl OptionsUi { ui.described_row(x, y, &installed.title, "", 0.0, cost, text, cw - 60.0); ui.switch(ROW + i as u64, control_x, y + ROW_H / 2.0, s.mods.is_on(m)); } + HRow::OpenModFolder => { + ui.row(x, y, "Mod folder", "", 0.0); + let label = "Open Folder"; + let bw = ui.button_width(label, false).max(96.0); + ui.button( + ROW + i as u64, + [control_x - bw, y + 12.0, bw, CONTROL], + label, + Button::Secondary, + true, + ); + } HRow::Extra(item) => { let cy = y + ROW_H / 2.0; let id = ROW + i as u64; @@ -730,6 +747,10 @@ impl OptionsUi { s.mods.toggle(*m); events.push(Event::Changed); } + Some(HRow::OpenModFolder) if !right => { + events.push(Event::ButtonClick); + events.push(Event::OpenModFolder); + } _ => {} } } @@ -908,4 +929,53 @@ mod tests { ui.click_horizon(&mut settings, &atlas, x, drag_y, framebuffer, true, false); assert_eq!(ui.hscroll, 0.0); } + + #[test] + fn mods_section_opens_folder_from_its_button() { + let atlas = atlas(); + let framebuffer = [2560, 1440]; + let mut options = section_ui("Mods"); + let mut settings = Settings::default(); + let mut batch = horizon_batch(framebuffer); + let mut ui = Ui::dry(&atlas, &mut batch, (0.0, 0.0)); + options.horizon_layout(&settings, &mut ui, 1.0); + let rect = ui + .hits + .iter() + .find(|hit| hit.id == ROW) + .expect("Mods section has an Open Folder button") + .rect; + let scale = ui.density / ui.batch.scale; + let cursor = ( + (rect[0] + rect[2]) * 0.5 * scale, + (rect[1] + rect[3]) * 0.5 * scale, + ); + drop(ui); + + assert_eq!( + options.click_horizon( + &mut settings, + &atlas, + cursor.0, + cursor.1, + framebuffer, + false, + false + ), + vec![Event::ButtonClick, Event::OpenModFolder] + ); + assert!( + options + .click_horizon( + &mut settings, + &atlas, + cursor.0, + cursor.1, + framebuffer, + false, + true + ) + .is_empty() + ); + } } diff --git a/crates/horizon-client/src/options_ui.rs b/crates/horizon-client/src/options_ui.rs index fc80530d9..0b166241e 100644 --- a/crates/horizon-client/src/options_ui.rs +++ b/crates/horizon-client/src/options_ui.rs @@ -734,6 +734,7 @@ enum Act { /// Back to Horizon's own menus (Horizon only, see `list_rows`). HorizonMenus, ToggleMod(usize), + OpenModFolder, } enum WKind { Button { @@ -780,6 +781,7 @@ pub enum Event { /// The pack selection changed (reload resources). Packs(Vec<String>), OpenPackFolder, + OpenModFolder, } /// `SliderableValueSet.applyValueImmediately`: these apply 600 ms after /// the last change (`OptionInstanceSliderButton.delayedApplyAt`). @@ -1626,7 +1628,18 @@ impl OptionsUi { } content = y + self.scroll - top + 2.0; out[list_start..].iter_mut().for_each(|w| w.list = true); - out.push(done(h - 27.0)); + if page == Page::Mods { + out.push(button( + cx - 154.0, + h - 27.0, + 150.0, + Text::literal("Open Mod Folder"), + Act::OpenModFolder, + )); + out.push(button(cx + 4.0, h - 27.0, 150.0, tr("gui.done"), Act::Done)); + } else { + out.push(done(h - 27.0)); + } } } // Layout may change the offset (language centering), or the list may @@ -2078,6 +2091,7 @@ impl OptionsUi { s.mods.toggle(i); events.push(Event::Changed); } + Act::OpenModFolder => events.push(Event::OpenModFolder), Act::None => {} } } @@ -2450,6 +2464,31 @@ mod tests { assert!(empty.iter().any(|w| { matches!(&w.kind, WKind::Text { text, .. } if text.plain().contains(".hmod")) })); + let open_folder = empty + .iter() + .find(|w| { + matches!( + &w.kind, + WKind::Button { + act: Act::OpenModFolder, + .. + } + ) + }) + .expect("Mods page has an Open Mod Folder button"); + assert_eq!( + ui.click( + &mut s, + &atlas, + open_folder.x + 1.0, + open_folder.y + 1.0, + size, + [480, 240], + false, + false, + ), + vec![Event::ButtonClick, Event::OpenModFolder] + ); for (id, dev) in [("normal", false), ("dev", true), ("", false)] { s.mods.installed.push(crate::mod_list::Installed { id: id.into(), From 3bb973efae05a899decbbb4644dcca83bd2ee5e3 Mon Sep 17 00:00:00 2001 From: lazy-importer <lazy-importer@users.noreply.github.com> Date: Sun, 18 Oct 2026 01:57:22 +0200 Subject: [PATCH 038/163] fix(game): persist creative flight status across world save and reload (#777) --- crates/horizon-client/src/game.rs | 6 +++ crates/horizon-client/src/lan/playerdata.rs | 2 + crates/horizon-client/src/motion.rs | 4 ++ crates/horizon-client/src/save.rs | 41 ++++++++++++++++++++- 4 files changed, 52 insertions(+), 1 deletion(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 26709516f..b1bb31a34 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -3156,6 +3156,11 @@ impl Game<'_> { player.may_fly = self.creative || spectator; player.invulnerable = self.creative || spectator; player.spectator = spectator; + if spectator { + player.flying = true; + } else if !player.may_fly { + player.flying = false; + } player.respiration = self.armor[0] .as_ref() .map_or(0, |s| s.enchantment_level("minecraft:respiration") as i32); @@ -8458,6 +8463,7 @@ impl Game<'_> { level.food = p.health.food.food; level.saturation = p.health.food.saturation; + level.flying = p.flying; } level.inventory = self .inventory diff --git a/crates/horizon-client/src/lan/playerdata.rs b/crates/horizon-client/src/lan/playerdata.rs index 44b269a8f..452218972 100644 --- a/crates/horizon-client/src/lan/playerdata.rs +++ b/crates/horizon-client/src/lan/playerdata.rs @@ -68,6 +68,7 @@ pub fn apply(guest: &mut Guest, level: &Level) { guest.xp_total = level.xp_total; guest.effects = crate::effects::PlayerEffects::from_saved(&level.active_effects); guest.game_mode = level.mode(); + guest.flying = level.flying; guest.selected = (level.selected_slot.max(0) as usize).min(8); guest.saved = level.player_extra.clone(); guest.recipe_book = level.recipe_book.clone(); @@ -128,6 +129,7 @@ pub fn store(guest: &Guest, level: &mut Level) { level.active_effects = guest.effects.saved(); level.game_mode = guest.game_mode; level.creative = guest.game_mode == 1; + level.flying = guest.flying; level.selected_slot = guest.selected as i32; level.on_ground = guest.on_ground; level.player_extra = guest.saved.clone(); diff --git a/crates/horizon-client/src/motion.rs b/crates/horizon-client/src/motion.rs index 7dab3a5aa..153793a2a 100644 --- a/crates/horizon-client/src/motion.rs +++ b/crates/horizon-client/src/motion.rs @@ -309,6 +309,7 @@ impl PlayerMotion { self.set_health(level.health, false)?; self.health.food.food = level.food; self.health.food.saturation = level.saturation; + self.flying = level.flying; } Ok(()) } @@ -2610,6 +2611,7 @@ mod tests { food: 11, saturation: 2.25, player_extra: Some(extra), + flying: true, ..Default::default() }; let mut pending = true; @@ -2617,6 +2619,7 @@ mod tests { .load_saved_state_once(&mut pending, &level) .unwrap(); assert_eq!((w.player.fire_ticks, w.player.air), (160, 8)); + assert!(w.player.flying); assert_eq!( ( w.player.health.health(), @@ -2628,6 +2631,7 @@ mod tests { let mut respawn = PlayerMotion::new(&resources, Vec3::new(20.5, 4.0, 20.5)).unwrap(); respawn.load_saved_state_once(&mut pending, &level).unwrap(); assert_eq!((respawn.fire_ticks, respawn.air), (-20, 300)); + assert!(!respawn.flying); assert_eq!( (respawn.health.health(), respawn.health.food.food), (20.0, 20) diff --git a/crates/horizon-client/src/save.rs b/crates/horizon-client/src/save.rs index 29038849f..c60da2caa 100644 --- a/crates/horizon-client/src/save.rs +++ b/crates/horizon-client/src/save.rs @@ -2146,6 +2146,8 @@ pub struct Level { pub on_ground: bool, pub food_exhaustion: f32, pub food_tick_timer: i32, + /// Abilities.flying: whether creative/spectator flight is active. + pub flying: bool, /// The player compound as loaded, for fields Horizon does not model /// (ender chest, effects, abilities, recipe book, attributes, ...). pub player_extra: Option<Tag>, @@ -2309,6 +2311,10 @@ impl Level { self.creative = mode == 1; self.game_mode = mode as i32; } + self.flying = p + .get("abilities") + .and_then(|a| number(a.get("flying"))) + .is_some_and(|v| v != 0); if let Some(d) = text(p.get("Dimension")) { self.dimension = d; } @@ -2440,7 +2446,9 @@ impl Level { } if spectator { put(&mut abilities, "flying", Tag::Byte(1)); - } else if !creative { + } else if creative { + put(&mut abilities, "flying", Tag::Byte(i8::from(self.flying))); + } else { put(&mut abilities, "flying", Tag::Byte(0)); } if let Tag::Compound(map) = &mut abilities { @@ -3153,6 +3161,7 @@ mod tests { world_spawn: Some([8, 64, 8]), spawn: Some([20.0, 70.0, 20.0]), difficulty_locked: true, + flying: true, ..Level::default() }; level.weather.raining = true; @@ -3164,6 +3173,7 @@ mod tests { assert_eq!(back.seed, -42); assert_eq!((back.time, back.day_time), (1234, 25000)); assert!(back.creative); + assert!(back.flying); assert_eq!(back.position, Some([1.5, 70.0, -3.25])); assert_eq!(back.rotation, [90.0, 10.0]); assert_eq!((back.health, back.food, back.saturation), (17.0, 15, 2.5)); @@ -3246,4 +3256,33 @@ mod tests { level.active_effects.clear(); assert!(level.player_tag().get("active_effects").is_none()); } + + #[test] + fn creative_flight_status_persists_in_save_and_resets_for_survival() { + let mut level = Level { + creative: true, + flying: true, + ..Level::default() + }; + let tag = level.player_tag(); + let flying_byte = tag + .get("abilities") + .and_then(|a| number(a.get("flying"))) + .unwrap_or(0); + assert_eq!(flying_byte, 1); + + let mut loaded = Level::default(); + loaded.read_player(&tag); + assert!(loaded.flying); + + // Survival mode resets flying ability to 0 in save. + level.creative = false; + level.game_mode = 0; + let tag_survival = level.player_tag(); + let flying_survival = tag_survival + .get("abilities") + .and_then(|a| number(a.get("flying"))) + .unwrap_or(0); + assert_eq!(flying_survival, 0); + } } From c78bf747446a1027732eed77530fc1a389153f2e Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 23:36:29 +0200 Subject: [PATCH 039/163] Cave culling: search on a worker thread, frames never wait for it The section occlusion search (SectionOcclusionGraph) ran on the render thread whenever a section was meshed or the camera entered another section: at render distance 32 that is a breadth-first walk over about 124,000 cells, and while exploring it ran nearly every frame. As in vanilla 26.3, the full search now runs off the render thread. A worker keeps its own copy of every section's face connectivity, fed the changes with each job, and searches over dense arrays around the camera. Frames use the last finished graph and never wait for the next. The search starts at the top of the frame, as soon as the camera is known, so it usually lands before the frame builds its visible list. A section meshed in between propagates into the graph the frame has (vanilla's runPartialUpdate), so a wall that opens shows what is behind it at once; a section that closes goes at the next full search. A graph that never reached the camera's section (after a teleport, say) is not used: until the next one lands every section in the frustum is drawn. The search itself is unchanged: the same box, steps and first-entry rule, checked cell for cell against the previous code in a test. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game.rs | 24 +- crates/horizon-client/src/gfx.rs | 27 +- crates/horizon-client/src/gfx/occlusion.rs | 614 +++++++++++++++++---- 3 files changed, 549 insertions(+), 116 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 26709516f..994da0fe7 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -8584,6 +8584,22 @@ impl Game<'_> { camera.y.floor() as i32, camera.z.floor() as i32, ]; + // The camera inside an opaque block sees nothing through it: disable. + let cave_culling = self.settings.horizon.cave_culling + && !self + .res + .facts + .get(self.world.block(block[0], block[1], block[2])) + .solid_render; + // The cave culling search runs on its worker while the frame is prepared. + if cave_culling + && self.title.is_none() + && let Some(renderer) = self.renderer.as_mut() + { + horizon_client::spans::time("occlusion", || { + renderer.start_occlusion(camera, (self.streaming.radius * 16) as f32) + }); + } let biome = self .world .chunks @@ -8772,13 +8788,7 @@ impl Game<'_> { skybox: self.dim == Dim::Overworld && self.settings.horizon.sky, end_sky: self.dim == Dim::End && self.settings.horizon.sky, environment_fog: (self.dim == Dim::Nether).then_some((sky.fog_start, sky.fog_end)), - // The camera inside an opaque block sees nothing through it: disable. - cave_culling: self.settings.horizon.cave_culling - && !self - .res - .facts - .get(self.world.block(block[0], block[1], block[2])) - .solid_render, + cave_culling, water_fog, fog: Some({ let mut fog = self.frame_fog(camera, &sky, biome); diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 3c232c755..be842c3c6 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -1978,6 +1978,13 @@ impl Renderer { pub fn has_section(&self, key: SectionKey) -> bool { self.sections.contains(key) } + /// Bring the cave culling graph up to date for `camera` without waiting: + /// a search this starts runs on its worker while the frame is prepared, + /// and `render` takes it if it has finished. + pub fn start_occlusion(&mut self, camera: DVec3, distance: f32) { + self.occlusion + .update(camera_section(camera), (distance / 16.0) as i32 + 2); + } pub fn upload(&mut self, key: SectionKey, mesh: &SectionMesh) { self.occlusion.set(key, mesh.visibility); if mesh.block_entities.is_empty() { @@ -2466,17 +2473,10 @@ impl Renderer { planes: frustum(view_proj), }; let camera = frame.camera; - let camera_section = ( - (camera.x.floor() as i32) >> 4, - (camera.y.floor() as i32 - crate::chunk::MIN_Y) >> 4, - (camera.z.floor() as i32) >> 4, - ); + let camera_section = camera_section(camera); let culling = !frame.title && frame.cave_culling; if culling { - let radius = (frame.distance / 16.0) as i32 + 2; - crate::spans::time("occlusion", || { - self.occlusion.update(camera_section, radius) - }); + crate::spans::time("occlusion", || self.start_occlusion(camera, frame.distance)); } let reachable = &self.occlusion; let mut visible = std::mem::take(&mut self.visible); @@ -3363,6 +3363,15 @@ enum Pack { Java(java_stages::JavaStages), } +/// The section the camera is in. +fn camera_section(camera: DVec3) -> SectionKey { + ( + (camera.x.floor() as i32) >> 4, + (camera.y.floor() as i32 - crate::chunk::MIN_Y) >> 4, + (camera.z.floor() as i32) >> 4, + ) +} + fn world_projection(fov_degrees: f32, aspect: f32, far: f32) -> Mat4 { Mat4::perspective_rh(fov_degrees.to_radians(), aspect, far, 0.05) } diff --git a/crates/horizon-client/src/gfx/occlusion.rs b/crates/horizon-client/src/gfx/occlusion.rs index e871c50c0..b63e7eae5 100644 --- a/crates/horizon-client/src/gfx/occlusion.rs +++ b/crates/horizon-client/src/gfx/occlusion.rs @@ -2,11 +2,18 @@ //! faces. Breadth-first from the camera section through the faces each //! section's VisGraph connects, never stepping back towards the camera. //! -//! The search runs over dense arrays around the camera rather than hash sets, -//! so it stays cheap enough to redo whenever a section is meshed. +//! As in vanilla, the full search runs off the render thread: a worker keeps +//! its own copy of every section's connectivity and searches over dense +//! arrays around the camera. Frames use the last finished graph and never wait +//! for the next one. A section meshed in between propagates into the graph the +//! frame has (vanilla's partial update), so what it opens shows at once; what +//! it closes goes at the next full search. use super::SectionKey; +use crate::mesher::ALL_VISIBLE; use std::collections::{HashMap, VecDeque}; +use std::sync::mpsc::{self, Receiver, Sender, TryRecvError}; +/// Vanilla's `Direction` order: down, up, north, south, west, east. const STEPS: [(i32, i32, i32); 6] = [ (0, -1, 0), (0, 1, 0), @@ -15,74 +22,92 @@ const STEPS: [(i32, i32, i32); 6] = [ (-1, 0, 0), (1, 0, 0), ]; +/// In `Graph::directions`: the cell has a node. +const REACHED: u8 = 1 << 7; +/// In `Graph::entered`: the camera's own section, entered through no face. const NONE: u8 = 6; -pub struct Occlusion { - /// VisGraph connectivity per column, one entry per section (bottom first). - columns: HashMap<(i32, i32), Box<[u64]>>, +/// VisGraph connectivity per column, one entry per section (bottom first). +/// A missing column or section connects every face. +struct Columns { sections: i32, - dirty: bool, - from: Option<SectionKey>, + map: HashMap<(i32, i32), Box<[u64]>>, +} + +impl Columns { + fn new(sections: i32) -> Self { + Self { + sections, + map: HashMap::new(), + } + } + /// Whether the section's connectivity changed. + fn set(&mut self, key: SectionKey, vis: u64) -> bool { + if !(0..self.sections).contains(&key.1) { + return false; + } + let column = match self.map.get_mut(&(key.0, key.2)) { + Some(column) => column, + None if vis == ALL_VISIBLE => return false, + None => self + .map + .entry((key.0, key.2)) + .or_insert_with(|| vec![ALL_VISIBLE; self.sections as usize].into()), + }; + let slot = &mut column[key.1 as usize]; + if *slot == vis { + return false; + } + *slot = vis; + if vis == ALL_VISIBLE && column.iter().all(|&v| v == ALL_VISIBLE) { + self.map.remove(&(key.0, key.2)); + } + true + } + fn get(&self, key: SectionKey) -> u64 { + self.map + .get(&(key.0, key.2)) + .and_then(|column| column.get(usize::try_from(key.1).ok()?)) + .copied() + .unwrap_or(ALL_VISIBLE) + } + fn apply(&mut self, edit: Edit) { + match edit { + Edit::Set(key, vis) => { + self.set(key, vis); + } + Edit::Clear => self.map.clear(), + } + } +} + +#[derive(Clone, Copy)] +enum Edit { + Set(SectionKey, u64), + Clear, +} + +/// One search's result over the box around the camera: vanilla's +/// `GraphStorage.sectionToNodeMap`, as dense arrays. +#[derive(Default)] +struct Graph { + from: SectionKey, radius: i32, /// The searched box: lowest section y and its height in sections. y0: i32, height: i32, - reached: Vec<bool>, - vis: Vec<u64>, - queue: VecDeque<(u32, u8, u8)>, + /// Per cell: `REACHED`, and the directions travelled from the camera to + /// it (`Node.directions`). + directions: Vec<u8>, + /// Per cell: the face it was first entered through (`NONE` for the + /// camera's). Vanilla's `Node.sourceDirections` also keeps the faces it is + /// reached through later; Horizon keeps the first only. + entered: Vec<u8>, } -impl Occlusion { - pub fn new(sections: i32) -> Self { - Self { - columns: HashMap::new(), - sections, - dirty: true, - from: None, - radius: 0, - y0: 0, - height: 0, - reached: Vec::new(), - vis: Vec::new(), - queue: VecDeque::new(), - } - } - pub fn set(&mut self, key: SectionKey, vis: u64) { - if !(0..self.sections).contains(&key.1) { - return; - } - let sections = self.sections as usize; - let column = self - .columns - .entry((key.0, key.2)) - .or_insert_with(|| vec![crate::mesher::ALL_VISIBLE; sections].into()); - let slot = &mut column[key.1 as usize]; - if *slot != vis { - *slot = vis; - self.dirty = true; - } - } - pub fn remove(&mut self, key: SectionKey) { - let Some(column) = self.columns.get_mut(&(key.0, key.2)) else { - return; - }; - if let Some(slot) = column.get_mut(key.1 as usize) - && *slot != crate::mesher::ALL_VISIBLE - { - *slot = crate::mesher::ALL_VISIBLE; - self.dirty = true; - } - if column.iter().all(|&v| v == crate::mesher::ALL_VISIBLE) { - self.columns.remove(&(key.0, key.2)); - } - } - pub fn clear(&mut self) { - self.columns.clear(); - self.dirty = true; - } +impl Graph { fn index(&self, key: SectionKey) -> Option<usize> { - let from = self.from?; - let (dx, dz, dy) = (key.0 - from.0, key.2 - from.2, key.1 - self.y0); + let (dx, dz, dy) = (key.0 - self.from.0, key.2 - self.from.2, key.1 - self.y0); let side = 2 * self.radius + 1; if dx.abs() > self.radius || dz.abs() > self.radius || !(0..self.height).contains(&dy) { return None; @@ -90,86 +115,331 @@ impl Occlusion { Some((((dz + self.radius) * side + dx + self.radius) * self.height + dy) as usize) } fn key(&self, index: usize) -> SectionKey { - let from = self.from.expect("searched"); let side = 2 * self.radius + 1; let i = index as i32; - let dy = i % self.height; let column = i / self.height; ( - from.0 + column % side - self.radius, - self.y0 + dy, - from.2 + column / side - self.radius, + self.from.0 + column % side - self.radius, + self.y0 + i % self.height, + self.from.2 + column / side - self.radius, ) } - pub fn contains(&self, key: SectionKey) -> bool { - self.index(key).is_some_and(|i| self.reached[i]) + fn contains(&self, key: SectionKey) -> bool { + self.index(key) + .is_some_and(|i| self.directions[i] & REACHED != 0) } - /// Search again when sections changed or the camera moved to another section. - pub fn update(&mut self, from: SectionKey, radius: i32) { - if !self.dirty && self.from == Some(from) && self.radius == radius { - return; - } - self.from = Some(from); + /// The full search from `from` (vanilla's `scheduleFullUpdate`). + fn search( + &mut self, + columns: &Columns, + from: SectionKey, + radius: i32, + vis: &mut Vec<u64>, + queue: &mut VecDeque<u32>, + ) { + self.from = from; self.radius = radius; self.y0 = from.1.min(-1); - self.height = from.1.max(self.sections) - self.y0 + 1; + self.height = from.1.max(columns.sections) - self.y0 + 1; let side = (2 * radius + 1) as usize; let size = side * side * self.height as usize; - self.reached.clear(); - self.reached.resize(size, false); - self.vis.clear(); - self.vis.resize(size, crate::mesher::ALL_VISIBLE); + self.directions.clear(); + self.directions.resize(size, 0); + self.entered.clear(); + self.entered.resize(size, NONE); + vis.clear(); + vis.resize(size, ALL_VISIBLE); for dz in -radius..=radius { for dx in -radius..=radius { - let Some(column) = self.columns.get(&(from.0 + dx, from.2 + dz)) else { + let Some(column) = columns.map.get(&(from.0 + dx, from.2 + dz)) else { continue; }; let base = self .index((from.0 + dx, 0, from.2 + dz)) .expect("column inside the searched box"); - self.vis[base..base + column.len()].copy_from_slice(column); + vis[base..base + column.len()].copy_from_slice(column); } } let start = self.index(from).expect("camera inside the searched box"); - self.reached[start] = true; - self.queue.clear(); - self.queue.push_back((start as u32, NONE, 0)); - while let Some((index, entered, travelled)) = self.queue.pop_front() { - let vis = self.vis[index as usize]; - let key = self.key(index as usize); + self.directions[start] = REACHED; + queue.clear(); + queue.push_back(start as u32); + self.propagate(queue, columns.sections, |i, _| vis[i]); + } + /// Vanilla's `runUpdates`: take nodes from the queue and step through + /// every face their entry face connects to, away from the camera. + fn propagate( + &mut self, + queue: &mut VecDeque<u32>, + sections: i32, + vis: impl Fn(usize, SectionKey) -> u64, + ) { + while let Some(index) = queue.pop_front() { + let i = index as usize; + let key = self.key(i); + let directions = self.directions[i]; + let entered = self.entered[i]; + let exits = if entered == NONE { + 0x3f + } else { + (vis(i, key) >> (u32::from(entered) * 6)) as u8 & 0x3f + }; for (d, step) in STEPS.iter().enumerate() { - let opposite = d ^ 1; - if travelled & (1 << opposite) != 0 { - continue; - } - if entered != NONE && vis & (1 << (usize::from(entered) * 6 + d)) == 0 { + if exits & (1 << d) == 0 || directions & (1 << (d ^ 1)) != 0 { continue; } let next = (key.0 + step.0, key.1 + step.1, key.2 + step.2); - if next.1 < -1 || next.1 > self.sections { + if next.1 < -1 || next.1 > sections { continue; } let Some(n) = self.index(next) else { continue }; - if !self.reached[n] { - self.reached[n] = true; - self.queue - .push_back((n as u32, opposite as u8, travelled | (1 << d))); + if self.directions[n] & REACHED == 0 { + self.directions[n] = directions | 1 << d; + self.entered[n] = (d ^ 1) as u8; + queue.push_back(n as u32); } } } + } +} + +struct Job { + edits: Vec<Edit>, + from: SectionKey, + radius: i32, + /// Buffers to reuse. + graph: Graph, +} + +/// The thread that runs full searches over its own copy of the columns. +struct Worker { + jobs: Sender<Job>, + done: Receiver<(Graph, Vec<Edit>)>, +} + +impl Worker { + fn spawn(sections: i32) -> Option<Self> { + let (jobs, job_rx) = mpsc::channel::<Job>(); + let (done_tx, done) = mpsc::channel(); + std::thread::Builder::new() + .name("occlusion".into()) + .spawn(move || { + let mut columns = Columns::new(sections); + let (mut vis, mut queue) = (Vec::new(), VecDeque::new()); + while let Ok(mut job) = job_rx.recv() { + for edit in job.edits.drain(..) { + columns.apply(edit); + } + job.graph + .search(&columns, job.from, job.radius, &mut vis, &mut queue); + if done_tx.send((job.graph, job.edits)).is_err() { + break; + } + } + }) + .ok()?; + Some(Self { jobs, done }) + } +} + +pub struct Occlusion { + /// The render thread's copy, for partial updates (and searches when the + /// worker is gone). + columns: Columns, + /// Edits the worker has not been sent yet. + edits: Vec<Edit>, + /// A full search is due: sections changed since the last one started. + dirty: bool, + /// The last finished search; `None` until one finishes, or after the + /// columns were cleared. + graph: Option<Graph>, + spare: Graph, + worker: Option<Worker>, + /// The camera section and radius of the running search. + running: Option<(SectionKey, i32)>, + /// The running search started before the columns were cleared: drop it. + discard: bool, + /// The camera section and radius `graph`'s search started from (or is + /// starting from). + searched: Option<(SectionKey, i32)>, + /// Sections changed since `graph`'s search started, to propagate from. + changed: Vec<SectionKey>, + /// Sections changed since the running search started: they propagate into + /// its graph when it lands. + changed_late: Vec<SectionKey>, + vis: Vec<u64>, + queue: VecDeque<u32>, +} + +impl Occlusion { + pub fn new(sections: i32) -> Self { + Self { + columns: Columns::new(sections), + edits: Vec::new(), + dirty: true, + graph: None, + spare: Graph::default(), + worker: Worker::spawn(sections), + running: None, + discard: false, + searched: None, + changed: Vec::new(), + changed_late: Vec::new(), + vis: Vec::new(), + queue: VecDeque::new(), + } + } + pub fn set(&mut self, key: SectionKey, vis: u64) { + if self.columns.set(key, vis) { + self.edits.push(Edit::Set(key, vis)); + self.dirty = true; + self.changed.push(key); + if self.running.is_some() { + self.changed_late.push(key); + } + } + } + pub fn remove(&mut self, key: SectionKey) { + self.set(key, ALL_VISIBLE); + } + pub fn clear(&mut self) { + self.columns.map.clear(); + self.edits.clear(); + self.edits.push(Edit::Clear); + self.dirty = true; + // Another world: the old graph says nothing about it. + if let Some(graph) = self.graph.take() { + self.spare = graph; + } + self.searched = None; + self.discard = self.running.is_some(); + self.changed.clear(); + self.changed_late.clear(); + } + /// Whether `key` is visible from the camera. Without a usable graph + /// (before the first search lands, or with the camera somewhere the graph + /// never reached) every section is. + pub fn contains(&self, key: SectionKey) -> bool { + self.graph.as_ref().is_none_or(|g| g.contains(key)) + } + /// Take a finished search, propagate changed sections into the graph, + /// and start a search when sections changed or the camera moved to + /// another section. Never waits for the worker. + pub fn update(&mut self, from: SectionKey, radius: i32) { + self.collect(false); + self.propagate_changes(); + if self.running.is_none() && (self.dirty || self.searched != Some((from, radius))) { + self.start(from, radius); + } + // A graph that never reached the camera's section hides everything + // around it: until the new one lands, cull by the frustum alone. + if self + .graph + .as_ref() + .is_some_and(|g| g.from != from && !g.contains(from)) + && let Some(graph) = self.graph.take() + { + self.spare = graph; + } + } + fn start(&mut self, from: SectionKey, radius: i32) { self.dirty = false; + self.searched = Some((from, radius)); + let graph = std::mem::take(&mut self.spare); + if let Some(worker) = &self.worker { + let job = Job { + edits: std::mem::take(&mut self.edits), + from, + radius, + graph, + }; + if worker.jobs.send(job).is_ok() { + self.running = Some((from, radius)); + self.changed_late.clear(); + return; + } + log::warn!("Horizon: the occlusion worker stopped; culling on the render thread"); + self.worker = None; + } + self.edits.clear(); + let mut graph = Graph::default(); + graph.search(&self.columns, from, radius, &mut self.vis, &mut self.queue); + self.land(graph); + } + fn collect(&mut self, wait: bool) { + let Some(worker) = &self.worker else { return }; + if self.running.is_none() { + return; + } + let result = if wait { + worker.done.recv().map_err(|_| TryRecvError::Disconnected) + } else { + worker.done.try_recv() + }; + match result { + Ok((graph, edits)) => { + self.running = None; + if self.edits.is_empty() { + self.edits = edits; + } + if std::mem::take(&mut self.discard) { + self.spare = graph; + return; + } + self.land(graph); + self.changed.clear(); + self.changed.append(&mut self.changed_late); + } + Err(TryRecvError::Empty) => {} + Err(TryRecvError::Disconnected) => { + // The edits it held are lost with it: search here from now on. + self.worker = None; + self.running = None; + self.discard = false; + self.dirty = true; + } + } + } + fn land(&mut self, graph: Graph) { + if let Some(old) = self.graph.replace(graph) { + self.spare = old; + } + } + /// Vanilla's `runPartialUpdate`: what changed sections now connect to. + fn propagate_changes(&mut self) { + let Some(graph) = &mut self.graph else { + self.changed.clear(); + return; + }; + self.queue.clear(); + for key in self.changed.drain(..) { + if let Some(i) = graph.index(key) + && graph.directions[i] & REACHED != 0 + { + self.queue.push_back(i as u32); + } + } + let columns = &self.columns; + graph.propagate(&mut self.queue, columns.sections, |_, key| columns.get(key)); + } + /// Wait for the running search: tests, and A/B timing of the old + /// blocking search. + #[cfg(test)] + fn settle(&mut self, from: SectionKey, radius: i32) { + self.update(from, radius); + self.collect(true); + self.propagate_changes(); } } #[cfg(test)] mod tests { use super::*; - use crate::mesher::ALL_VISIBLE; #[test] fn open_space_reaches_the_whole_box() { let mut o = Occlusion::new(4); - o.update((0, 1, 0), 2); + o.settle((0, 1, 0), 2); for x in -2..=2 { for z in -2..=2 { for y in -1..=4 { @@ -186,11 +456,155 @@ mod tests { for (dx, dy, dz) in STEPS { o.set((dx, 1 + dy, dz), 0); } - o.update((0, 1, 0), 3); + o.settle((0, 1, 0), 3); assert!(o.contains((1, 1, 0)), "a neighbour is seen"); assert!(!o.contains((2, 1, 0)), "nothing shows through it"); o.set((1, 1, 0), ALL_VISIBLE); - o.update((0, 1, 0), 3); + o.settle((0, 1, 0), 3); assert!(o.contains((2, 1, 0))); } + + #[test] + fn frames_never_wait_and_partial_updates_open_at_once() { + let mut o = Occlusion::new(4); + for (dx, dy, dz) in STEPS { + o.set((dx, 1 + dy, dz), 0); + } + o.settle((0, 1, 0), 3); + assert!(!o.contains((2, 1, 0))); + // Opening the wall shows what is behind it in the same frame, from the + // graph the frame has, whether or not the full search has finished. + o.set((1, 1, 0), ALL_VISIBLE); + o.update((0, 1, 0), 3); + assert!(o.contains((2, 1, 0))); + assert!(o.contains((3, 1, 0))); + // Closing it again lasts until the next full search lands. + o.set((1, 1, 0), 0); + o.settle((0, 1, 0), 3); + o.settle((0, 1, 0), 3); + assert!(!o.contains((2, 1, 0))); + } + + #[test] + fn a_graph_that_lost_the_camera_culls_nothing() { + let mut o = Occlusion::new(4); + for (dx, dy, dz) in STEPS { + o.set((dx, 1 + dy, dz), 0); + } + o.settle((0, 1, 0), 3); + assert!(!o.contains((3, 1, 0))); + // The camera jumped past the wall; the next search is still running. + let o = &mut o; + o.update((3, 1, 0), 3); + if o.running.is_some() { + assert!(o.contains((3, 1, 0))); + } + o.settle((3, 1, 0), 3); + assert!(o.contains((3, 1, 0))); + assert!( + !o.contains((0, 1, 0)), + "the old camera section is walled in" + ); + } + + /// The search before it moved to the worker (main at ce38c8d7), over the + /// same box: whether each cell is reached. + fn reference(columns: &Columns, from: SectionKey, radius: i32) -> Vec<bool> { + let y0 = from.1.min(-1); + let height = from.1.max(columns.sections) - y0 + 1; + let side = 2 * radius + 1; + let index = |k: SectionKey| { + let (dx, dz, dy) = (k.0 - from.0, k.2 - from.2, k.1 - y0); + (dx.abs() <= radius && dz.abs() <= radius && (0..height).contains(&dy)) + .then(|| (((dz + radius) * side + dx + radius) * height + dy) as usize) + }; + let size = (side * side * height) as usize; + let mut reached = vec![false; size]; + let start = index(from).unwrap(); + reached[start] = true; + let mut queue = VecDeque::from([(from, NONE, 0u8)]); + while let Some((key, entered, travelled)) = queue.pop_front() { + let vis = columns.get(key); + for (d, step) in STEPS.iter().enumerate() { + let opposite = d ^ 1; + if travelled & (1 << opposite) != 0 { + continue; + } + if entered != NONE && vis & (1 << (usize::from(entered) * 6 + d)) == 0 { + continue; + } + let next = (key.0 + step.0, key.1 + step.1, key.2 + step.2); + if next.1 < -1 || next.1 > columns.sections { + continue; + } + let Some(n) = index(next) else { continue }; + if !reached[n] { + reached[n] = true; + queue.push_back((next, opposite as u8, travelled | (1 << d))); + } + } + } + reached + } + + fn random_world(o: &mut Occlusion, seed: u64, count: usize) { + let mut seed = seed; + let mut next = || { + seed ^= seed << 13; + seed ^= seed >> 7; + seed ^= seed << 17; + seed + }; + for _ in 0..count { + let r = next(); + let key = ( + (r % 13) as i32 - 6, + ((r >> 8) % 6) as i32, + ((r >> 16) % 13) as i32 - 6, + ); + // Open, half open or nearly closed sections. + let vis = match r >> 40 & 3 { + 0 => next() & next() & next(), + 1 => next(), + _ => next() | next(), + }; + o.set(key, vis & ALL_VISIBLE); + } + } + + /// The graph is the search the render thread did before, cell for cell. + #[test] + fn same_sections_as_before() { + let mut hidden = 0; + for seed in [0x9e37_79b9, 7, 0xdead_beef] { + let mut o = Occlusion::new(6); + random_world(&mut o, seed, 900); + for from in [(0, 2, 0), (3, 0, -2), (-5, 5, 4), (1, -1, 1), (0, 7, 0)] { + o.settle(from, 6); + o.settle(from, 6); + let graph = o.graph.as_ref().expect("searched"); + let reached: Vec<bool> = + graph.directions.iter().map(|&d| d & REACHED != 0).collect(); + assert_eq!(reached, reference(&o.columns, from, 6), "{seed} {from:?}"); + hidden += reached.iter().filter(|&&r| !r).count(); + } + } + assert!(hidden > 1000, "the worlds hide sections ({hidden})"); + } + + /// The worker's graph is the one the render thread would compute. + #[test] + fn the_worker_matches_a_search_on_the_render_thread() { + let mut o = Occlusion::new(6); + random_world(&mut o, 0x9e37_79b9, 800); + for from in [(0, 2, 0), (3, 0, -2), (-5, 5, 4)] { + o.settle(from, 6); + o.settle(from, 6); + let mut local = Graph::default(); + local.search(&o.columns, from, 6, &mut Vec::new(), &mut VecDeque::new()); + let graph = o.graph.as_ref().expect("searched"); + assert_eq!(graph.directions, local.directions); + assert_eq!(graph.entered, local.entered); + } + } } From 01f4c56dc10baa1ddaf442b4542c29207a193d65 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 00:21:10 +0200 Subject: [PATCH 040/163] Cull boats, paintings, item frames, armor stands, TNT and tridents like vanilla These entities were drawn every frame wherever they were in the loaded world: every armor stand, item frame and painting of every loaded village or base went through its model, item and per-vertex occlusion test even far behind the camera. EntityRenderer.shouldRender now decides, as for mobs and minecarts: - Entity.shouldRenderAtSqrDistance from the current position: 64 times the bounding box's mean edge times the entity distance option (boats about 71 blocks, primed TNT 63, paintings by size); item frames 1024 blocks; armor stands 256 times the box's mean edge whatever the option (4 for a marker's empty box); tridents ten times the default (AbstractArrow); firework rockets 64 blocks. - the interpolated culling box grown by 0.5 in the view; tridents grow it by 1.5 more (ThrownTridentRenderer), armor stands with a dragon head by 0.5 (LivingEntityRenderer), item frames holding a map use the block-wide box. The fishing bobber is unchanged: vanilla never frustum-culls it (FishingHookRenderer.affectedByCulling) and Horizon only draws the player's own, always within its 64 blocks. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../horizon-client/src/game/armor_stands.rs | 26 ++++++++ crates/horizon-client/src/game/boats.rs | 13 +++- .../horizon-client/src/game/entity_culling.rs | 61 +++++++++++++++++++ crates/horizon-client/src/game/fireworks.rs | 14 +++++ crates/horizon-client/src/game/frames.rs | 18 ++++++ crates/horizon-client/src/game/paintings.rs | 9 +++ crates/horizon-client/src/game/tnt.rs | 17 ++++++ crates/horizon-client/src/game/trident.rs | 19 ++++++ 8 files changed, 176 insertions(+), 1 deletion(-) diff --git a/crates/horizon-client/src/game/armor_stands.rs b/crates/horizon-client/src/game/armor_stands.rs index 80e42169d..4ea8df359 100644 --- a/crates/horizon-client/src/game/armor_stands.rs +++ b/crates/horizon-client/src/game/armor_stands.rs @@ -413,6 +413,32 @@ impl Game<'_> { if a.invisible { continue; } + // ArmorStand.shouldRenderAtSqrDistance: 256 times the box's mean + // edge (4 for a marker's empty box), whatever the entity distance. + // LivingEntityRenderer grows the culling box by 0.5 for a dragon head. + let (width, height) = match (a.marker, a.small) { + (true, _) => (0.0, 0.0), + (false, true) => (0.25, 0.9875), + (false, false) => (0.5, 1.975), + }; + let edge = (width + height + width) / 3.0 * 4.0; + let range = if edge == 0.0 { 4.0 } else { edge } * 64.0; + let dragon = a.equipment[5] + .as_ref() + .is_some_and(|i| &*i.item == "minecraft:dragon_head"); + let position = super::entity_culling::at(a.position); + if !self.standing_entity_in_view( + camera, + position, + position, + alpha, + width, + height, + range, + if dragon { 0.5 } else { 0.0 }, + ) { + continue; + } let Some(model) = (if a.small { &assets.small } else { &assets.main }) else { continue; }; diff --git a/crates/horizon-client/src/game/boats.rs b/crates/horizon-client/src/game/boats.rs index a5a609cac..8f2cad5f5 100644 --- a/crates/horizon-client/src/game/boats.rs +++ b/crates/horizon-client/src/game/boats.rs @@ -2,7 +2,7 @@ //! paddling controls, collisions, riding (`positionRider`, `clampRotation`, //! dismounting), `BoatItem` placement, `VehicleEntity.hurtServer` breaking, //! saving and `AbstractBoatRenderer` with animated paddles. -use super::{Game, Keys, view_vector}; +use super::{Game, Keys, entity_culling::at, view_vector}; use horizon_client::{ blocks::Fluid, collisions::SceneCollisions, @@ -700,8 +700,19 @@ impl Game<'_> { /// AbstractBoatRenderer. pub(super) fn boat_geometry(&self, camera: glam::DVec3, alpha: f64, out: &mut Vec<Vertex>) { let a = alpha as f32; + let range = super::entity_culling::default_range( + glam::DVec3::new(WIDTH, HEIGHT, WIDTH), + self.settings.entity_distance, + ); for b in &self.boats { let entity_start = out.len(); + // EntityRenderer.shouldRender. + let (previous, position) = (at(b.previous), at(b.position)); + if !self.standing_entity_in_view( + camera, previous, position, alpha, WIDTH, HEIGHT, range, 0.0, + ) { + continue; + } let models = if b.chest { &self.boat_models.chest_models } else { diff --git a/crates/horizon-client/src/game/entity_culling.rs b/crates/horizon-client/src/game/entity_culling.rs index 71ab13378..b710f4e73 100644 --- a/crates/horizon-client/src/game/entity_culling.rs +++ b/crates/horizon-client/src/game/entity_culling.rs @@ -49,3 +49,64 @@ impl Game<'_> { } } } + +/// Entity.shouldRenderAtSqrDistance's default range: 64 times the bounding +/// box's mean edge, scaled by the entity distance option. +pub(super) fn default_range(size: glam::DVec3, view_scale: f32) -> f64 { + let edge = (size.x + size.y + size.z) / 3.0; + let edge = if edge.is_nan() { 1.0 } else { edge }; + edge * 64.0 * f64::from(view_scale) +} + +impl Game<'_> { + /// EntityRenderer.shouldRender: the entity within `range` blocks of the + /// camera, measured from its current `position`, and its culling box + /// (`lo`..`hi`, interpolated, in world space) grown by 0.5 in the view. + pub(super) fn entity_in_view( + &self, + camera: glam::DVec3, + position: glam::DVec3, + range: f64, + lo: glam::DVec3, + hi: glam::DVec3, + ) -> bool { + if (position - camera).length_squared() >= range * range { + return false; + } + self.view_frustum.as_ref().is_none_or(|view| { + view.intersects( + (lo - camera - glam::DVec3::splat(0.5)).as_vec3(), + (hi - camera + glam::DVec3::splat(0.5)).as_vec3(), + ) + }) + } +} + +/// An entity's position as a `DVec3`. +pub(super) fn at(p: horizon_core::geometry::Vec3) -> glam::DVec3 { + glam::DVec3::new(p.x, p.y, p.z) +} + +impl Game<'_> { + /// `entity_in_view` for an entity whose box stands on its position, + /// `width` wide and `height` tall, interpolated by `alpha` and grown by + /// `grow` (a renderer's getBoundingBoxForCulling). + #[allow(clippy::too_many_arguments)] + pub(super) fn standing_entity_in_view( + &self, + camera: glam::DVec3, + previous: glam::DVec3, + position: glam::DVec3, + alpha: f64, + width: f64, + height: f64, + range: f64, + grow: f64, + ) -> bool { + let p = previous.lerp(position, alpha); + let half = glam::DVec3::new(width / 2.0 + grow, grow, width / 2.0 + grow); + let lo = p - half; + let hi = p + glam::DVec3::new(half.x, height + grow, half.z); + self.entity_in_view(camera, position, range, lo, hi) + } +} diff --git a/crates/horizon-client/src/game/fireworks.rs b/crates/horizon-client/src/game/fireworks.rs index 0e074025f..0d8dd0b12 100644 --- a/crates/horizon-client/src/game/fireworks.rs +++ b/crates/horizon-client/src/game/fireworks.rs @@ -253,6 +253,20 @@ impl Game<'_> { pub(super) fn rocket_geometry(&self, camera: glam::DVec3, alpha: f64, out: &mut Vec<Vertex>) { let orientation = glam::Mat4::from_quat(self.camera_orientation()); for r in self.rockets.iter().filter(|r| !r.attached) { + // FireworkRocketEntity.shouldRenderAtSqrDistance: within 64 blocks; + // EntityRenderer.shouldRender: its 0.25 box in the view. + if !self.standing_entity_in_view( + camera, + super::entity_culling::at(r.previous), + super::entity_culling::at(r.position), + alpha, + 0.25, + 0.25, + 64.0, + 0.0, + ) { + continue; + } let p = glam::DVec3::new( r.previous.x + (r.position.x - r.previous.x) * alpha, r.previous.y + (r.position.y - r.previous.y) * alpha, diff --git a/crates/horizon-client/src/game/frames.rs b/crates/horizon-client/src/game/frames.rs index 3ffa0e67e..2977ad483 100644 --- a/crates/horizon-client/src/game/frames.rs +++ b/crates/horizon-client/src/game/frames.rs @@ -304,9 +304,27 @@ impl Game<'_> { let sprites = &self.atlas.sprites; let mut maps: Vec<(i32, glam::Mat4, u32)> = Vec::new(); let mut items: Vec<(ItemStack, u32, glam::Mat4, u8)> = Vec::new(); + // ItemFrame.shouldRenderAtSqrDistance: 1024 blocks at 100%. + let range = 16.0 * 64.0 * f64::from(self.settings.entity_distance); for f in &self.item_frames { let entity_start = out.len(); let map = f.item.as_ref().and_then(super::maps::map_id); + // EntityRenderer.shouldRender: its box (a block wide with a map), + // measured from the box's centre. + let (lo, hi) = f.bounds(); + let (mut lo, mut hi) = (glam::DVec3::from(lo), glam::DVec3::from(hi)); + if map.is_some() { + let s = f.step(); + for i in 0..3 { + if s[i] == 0 { + let c = (lo[i] + hi[i]) / 2.0; + (lo[i], hi[i]) = (c - 0.5, c + 0.5); + } + } + } + if !self.entity_in_view(camera, (lo + hi) / 2.0, range, lo, hi) { + continue; + } let s = f.step(); // Pose: to the block centre, then X/Y rotation by facing. let (x_rot, y_rot) = if s[1] == 0 { diff --git a/crates/horizon-client/src/game/paintings.rs b/crates/horizon-client/src/game/paintings.rs index 2e5542ccc..c65dbbb89 100644 --- a/crates/horizon-client/src/game/paintings.rs +++ b/crates/horizon-client/src/game/paintings.rs @@ -255,6 +255,15 @@ impl Game<'_> { }; for p in &self.paintings { let entity_start = out.len(); + // EntityRenderer.shouldRender: the default range and its box, + // measured from the box's centre (HangingEntity's position). + let (lo, hi) = p.bounds(); + let (lo, hi) = (glam::DVec3::from(lo), glam::DVec3::from(hi)); + let range = + super::entity_culling::default_range(hi - lo, self.settings.entity_distance); + if !self.entity_in_view(camera, (lo + hi) / 2.0, range, lo, hi) { + continue; + } let Some(v) = self.painting_variants.get(&p.variant) else { continue; }; diff --git a/crates/horizon-client/src/game/tnt.rs b/crates/horizon-client/src/game/tnt.rs index 78f107599..ad77f67c1 100644 --- a/crates/horizon-client/src/game/tnt.rs +++ b/crates/horizon-client/src/game/tnt.rs @@ -241,7 +241,24 @@ impl Game<'_> { .and_then(|name| self.atlas.sprites.get(name).copied()); } } + let range = super::entity_culling::default_range( + glam::DVec3::splat(PrimedTnt::SIZE), + self.settings.entity_distance, + ); for t in &self.tnts { + // EntityRenderer.shouldRender. + if !self.standing_entity_in_view( + camera, + super::entity_culling::at(t.previous), + super::entity_culling::at(t.position), + alpha, + PrimedTnt::SIZE, + PrimedTnt::SIZE, + range, + 0.0, + ) { + continue; + } let fuse = t.fuse as f32 - alpha as f32 + 1.0; let scale = if fuse < 10.0 { let g = (1.0 - fuse / 10.0).clamp(0.0, 1.0); diff --git a/crates/horizon-client/src/game/trident.rs b/crates/horizon-client/src/game/trident.rs index 8c372fa46..2a5a89e1a 100644 --- a/crates/horizon-client/src/game/trident.rs +++ b/crates/horizon-client/src/game/trident.rs @@ -350,7 +350,26 @@ impl Game<'_> { else { return; }; + // AbstractArrow.shouldRenderAtSqrDistance: ten times the default. + let range = 10.0 + * super::entity_culling::default_range( + glam::DVec3::splat(2.0 * HALF), + self.settings.entity_distance, + ); for t in &self.tridents { + // EntityRenderer.shouldRender; ThrownTridentRenderer grows the box by 1.5. + if !self.standing_entity_in_view( + camera, + super::entity_culling::at(t.previous), + super::entity_culling::at(t.position), + alpha, + 2.0 * HALF, + 2.0 * HALF, + range, + 1.5, + ) { + continue; + } let p = glam::DVec3::new( t.previous.x + (t.position.x - t.previous.x) * alpha, t.previous.y + (t.position.y - t.previous.y) * alpha, From 2faa99e5f1632f9efbe5a15300a7a0e901708142 Mon Sep 17 00:00:00 2001 From: LookImEcho-Rick <62575172+LookImEcho-Rick@users.noreply.github.com> Date: Sat, 17 Oct 2026 19:30:23 -0500 Subject: [PATCH 041/163] Fix item tooltip display parity --- .../examples/tooltip_display_fixture.rs | 40 +++++++ crates/horizon-client/src/game/stations.rs | 83 +++++++++----- crates/horizon-client/src/item_data.rs | 40 ++++--- crates/horizon-client/src/item_tooltip.rs | 101 ++++++++++++++++++ .../parity/VanillaTooltipDisplayOracle.java | 36 +++++++ tools/test_tooltip_display_parity.py | 31 ++++++ 6 files changed, 292 insertions(+), 39 deletions(-) create mode 100644 crates/horizon-client/examples/tooltip_display_fixture.rs create mode 100644 mods/horizon/src/test/java/dev/horizonlab/parity/VanillaTooltipDisplayOracle.java create mode 100644 tools/test_tooltip_display_parity.py diff --git a/crates/horizon-client/examples/tooltip_display_fixture.rs b/crates/horizon-client/examples/tooltip_display_fixture.rs new file mode 100644 index 000000000..ec61159cd --- /dev/null +++ b/crates/horizon-client/examples/tooltip_display_fixture.rs @@ -0,0 +1,40 @@ +//! Tooltip display visibility oracle companion for tools/test_tooltip_display_parity.py. +use horizon_client::{item_tooltip::TooltipDisplay, items::ItemStack}; +use horizon_world::nbt::Tag; +use std::{error::Error, fmt::Write}; + +fn main() -> Result<(), Box<dyn Error>> { + let args: Vec<String> = std::env::args().collect(); + let mut output = String::new(); + for line in std::fs::read_to_string(&args[1])?.lines() { + let fields: Vec<&str> = line.split('\t').collect(); + let hide_tooltip: bool = fields[0].parse()?; + let creative: bool = fields[1].parse()?; + let hide_attributes: bool = fields[2].parse()?; + let mut component = Vec::new(); + if hide_tooltip { + component.push(("hide_tooltip", Tag::Byte(1))); + } + if hide_attributes { + component.push(( + "hidden_components", + Tag::List(vec![Tag::String("minecraft:attribute_modifiers".into())]), + )); + } + let mut stack = ItemStack::new("minecraft:diamond_sword", 1); + if !component.is_empty() { + stack + .data_mut() + .set_other("minecraft:tooltip_display", Some(Tag::compound(component))); + } + let display = TooltipDisplay::for_stack(&stack); + writeln!( + output, + "{}\t{}", + display.name_visible(creative), + display.shows("minecraft:attribute_modifiers") + )?; + } + std::fs::write(&args[2], output)?; + Ok(()) +} diff --git a/crates/horizon-client/src/game/stations.rs b/crates/horizon-client/src/game/stations.rs index 8cd751548..332f06b23 100644 --- a/crates/horizon-client/src/game/stations.rs +++ b/crates/horizon-client/src/game/stations.rs @@ -1885,17 +1885,27 @@ impl Game<'_> { } else { self.pack.names.item(&stack.item) }; - let mut lines = vec![(name, color)]; + let display = horizon_client::item_tooltip::TooltipDisplay::for_stack(stack); + let mut lines = Vec::new(); + if display.name_visible(self.screen == Screen::Creative) { + lines.push((name, color)); + } let translate = |k: &str| e.translate(k).map(str::to_owned); // ItemContainerContents.addToTooltip. let hover_name = |s: &ItemStack| { s.custom_name() .map_or_else(|| self.pack.names.item(&s.item), str::to_owned) }; - for line in horizon_client::item_tooltip::container_lines(stack, &hover_name, &translate) { - lines.push((line, u32::MAX)); + if display.shows("minecraft:container") { + for line in + horizon_client::item_tooltip::container_lines(stack, &hover_name, &translate) + { + lines.push((line, u32::MAX)); + } } - if stack.item.ends_with("potion") || &*stack.item == "minecraft:tipped_arrow" { + if display.shows("minecraft:potion_contents") + && (stack.item.ends_with("potion") || &*stack.item == "minecraft:tipped_arrow") + { let scale = match &*stack.item { "minecraft:lingering_potion" => 0.25, "minecraft:tipped_arrow" => 0.125, @@ -1912,7 +1922,9 @@ impl Game<'_> { lines.push((line, c)); } } - if let Some((material, pattern)) = stack.data().and_then(|d| d.trim.clone()) { + if display.shows("minecraft:trim") + && let Some((material, pattern)) = stack.data().and_then(|d| d.trim.clone()) + { lines.push(( e.translate("item.minecraft.smithing_template.upgrade") .unwrap_or("Upgrade:") @@ -1929,30 +1941,44 @@ impl Game<'_> { lines.push((format!(" {p}"), rgba(170, 170, 170, 255))); lines.push((format!(" {m}"), rgba(170, 170, 170, 255))); } - for (text, curse) in e - .tooltip(stack.stored_enchantments()) - .into_iter() - .chain(e.tooltip(stack.enchantments())) - { - lines.push(( - text, - if curse { - rgba(255, 85, 85, 255) - } else { - rgba(170, 170, 170, 255) - }, - )); + if display.shows("minecraft:stored_enchantments") { + for (text, curse) in e.tooltip(stack.stored_enchantments()) { + lines.push(( + text, + if curse { + rgba(255, 85, 85, 255) + } else { + rgba(170, 170, 170, 255) + }, + )); + } + } + if display.shows("minecraft:enchantments") { + for (text, curse) in e.tooltip(stack.enchantments()) { + lines.push(( + text, + if curse { + rgba(255, 85, 85, 255) + } else { + rgba(170, 170, 170, 255) + }, + )); + } } // BannerPatternLayers.addToTooltip: up to six layer names. - for layer in horizon_client::banner::tooltip_layers(stack).iter().take(6) { - let key = self.res.stations.banners.layer_key(layer); - lines.push((self.translate(&key, &key), rgba(170, 170, 170, 255))); + if display.shows("minecraft:banner_patterns") { + for layer in horizon_client::banner::tooltip_layers(stack).iter().take(6) { + let key = self.res.stations.banners.layer_key(layer); + lines.push((self.translate(&key, &key), rgba(170, 170, 170, 255))); + } } // Spawner.appendHoverText: what a spawner or trial spawner item spawns. - if matches!( - &*stack.item, - "minecraft:spawner" | "minecraft:trial_spawner" - ) { + if display.shows("minecraft:block_entity_data") + && matches!( + &*stack.item, + "minecraft:spawner" | "minecraft:trial_spawner" + ) + { let gray = rgba(170, 170, 170, 255); match block_entity_item::spawner_entity(stack) { Some(id) => { @@ -1969,7 +1995,9 @@ impl Game<'_> { } } } - if let Some(info) = self.res.items.get(&stack.item) { + if display.shows("minecraft:attribute_modifiers") + && let Some(info) = self.res.items.get(&stack.item) + { let base = |name: &str, default| { self.player .as_ref() @@ -1997,7 +2025,8 @@ impl Game<'_> { &translate, )); } - if let Some(info) = self.res.items.get(&stack.item) + if display.shows("minecraft:damage") + && let Some(info) = self.res.items.get(&stack.item) && info.max_damage > 0 && stack.damage > 0 && self.options_advanced_tooltips() diff --git a/crates/horizon-client/src/item_data.rs b/crates/horizon-client/src/item_data.rs index d54564b7a..adc4e0f18 100644 --- a/crates/horizon-client/src/item_data.rs +++ b/crates/horizon-client/src/item_data.rs @@ -110,6 +110,16 @@ pub const OMINOUS_LAYERS: [(&str, &str); 8] = [ ("circle", "light_gray"), ("border", "black"), ]; + +/// The raid captain banner's default tooltip setting, stored by vanilla as a +/// component but represented by `StackData::ominous_banner` in Horizon. +fn ominous_tooltip_display() -> Tag { + Tag::compound([( + "hidden_components", + Tag::List(vec![Tag::String("minecraft:banner_patterns".into())]), + )]) +} + /// `WrittenBookContent` with the pages as plain text. #[derive(Clone, Debug, Default, PartialEq)] pub struct WrittenBook { @@ -610,13 +620,9 @@ pub fn components_tag(damage: u32, data: Option<&StackData>) -> Option<Tag> { "minecraft:banner_patterns", Tag::List(OMINOUS_LAYERS.iter().map(|(p, c)| layer(p, c)).collect()), )); - entries.push(( - "minecraft:tooltip_display", - Tag::compound([( - "hidden_components", - Tag::List(vec![Tag::String("minecraft:banner_patterns".into())]), - )]), - )); + if d.other("minecraft:tooltip_display").is_none() { + entries.push(("minecraft:tooltip_display", ominous_tooltip_display())); + } entries.push(( "minecraft:item_name", Tag::compound([( @@ -793,10 +799,8 @@ pub fn decode_components(components: Option<&Tag>) -> (u32, Option<Box<StackData for (k, v) in map { let key = k.to_string_lossy(); let ominous_part = data.ominous_banner - && matches!( - key.as_str(), - "minecraft:item_name" | "minecraft:rarity" | "minecraft:tooltip_display" - ); + && (matches!(key.as_str(), "minecraft:item_name" | "minecraft:rarity") + || (key == "minecraft:tooltip_display" && v == &ominous_tooltip_display())); if !MODELLED.contains(&key.as_str()) && !ominous_part { data.other.push((key, v.clone())); } @@ -882,7 +886,19 @@ mod tests { let tag = encode_components(&banner).unwrap(); assert!(tag.get("minecraft:banner_patterns").is_some()); let (_, back) = decode_components(Some(&tag)); - assert!(back.unwrap().ominous_banner); + let back = back.unwrap(); + assert!(back.ominous_banner); + assert!(back.other("minecraft:tooltip_display").is_none()); + + banner.data_mut().set_other( + "minecraft:tooltip_display", + Some(Tag::Compound(Default::default())), + ); + let (_, custom_display) = decode_components(encode_components(&banner).as_ref()); + assert_eq!( + custom_display.unwrap().other("minecraft:tooltip_display"), + Some(&Tag::Compound(Default::default())) + ); let mut bottle = ItemStack::new("minecraft:ominous_bottle", 1); bottle.data_mut().ominous_amplifier = Some(3); let (_, back) = decode_components(encode_components(&bottle).as_ref()); diff --git a/crates/horizon-client/src/item_tooltip.rs b/crates/horizon-client/src/item_tooltip.rs index 77abbf8cf..114a57ad0 100644 --- a/crates/horizon-client/src/item_tooltip.rs +++ b/crates/horizon-client/src/item_tooltip.rs @@ -4,6 +4,64 @@ use crate::{ hud::rgba, items::{ItemInfo, ItemStack}, }; +use horizon_world::nbt::Tag; + +/// The `minecraft:tooltip_display` component applied by `ItemStack` while it +/// builds a hover tooltip. +pub struct TooltipDisplay<'a> { + component: Option<&'a Tag>, + ominous_banner: bool, +} + +impl<'a> TooltipDisplay<'a> { + pub fn for_stack(stack: &'a ItemStack) -> Self { + Self { + component: stack + .data() + .and_then(|data| data.other("minecraft:tooltip_display")), + ominous_banner: stack.data().is_some_and(|data| data.ominous_banner), + } + } + + fn hides_tooltip(&self) -> bool { + matches!( + self.component.and_then(|display| display.get("hide_tooltip")), + Some(Tag::Byte(value)) if *value != 0 + ) + } + + /// `ItemStack.getTooltipLines`: `hide_tooltip` suppresses the name unless + /// the tooltip flag is creative. + pub fn name_visible(&self, creative: bool) -> bool { + creative || !self.hides_tooltip() + } + + /// `TooltipDisplay.shows`: whether details for a data component are shown. + pub fn shows(&self, component: &str) -> bool { + if self.hides_tooltip() { + return false; + } + // `item_data::decode_components` models the raid captain banner's + // default hidden pattern tooltip as `ominous_banner` instead of + // retaining its redundant `tooltip_display` component. + if self.ominous_banner + && self.component.is_none() + && component == "minecraft:banner_patterns" + { + return false; + } + let Some(Tag::List(hidden)) = self + .component + .and_then(|display| display.get("hidden_components")) + else { + return true; + }; + let component = horizon_world::nbt::JavaString::from(component); + !hidden + .iter() + .any(|tag| matches!(tag, Tag::String(id) if id == &component)) + } +} /// `EquipmentSlotGroup` in declaration order, the order tooltips list them in. const SLOT_GROUPS: [&str; 11] = [ @@ -348,6 +406,49 @@ pub fn lines( mod tests { use super::*; + #[test] + fn tooltip_display_controls_name_and_component_visibility() { + let mut stack = ItemStack::new("minecraft:diamond_sword", 1); + let display = TooltipDisplay::for_stack(&stack); + assert!(display.name_visible(false)); + assert!(display.shows("minecraft:attribute_modifiers")); + + stack.data_mut().set_other( + "minecraft:tooltip_display", + Some(Tag::compound([( + "hidden_components", + Tag::List(vec![Tag::String("minecraft:attribute_modifiers".into())]), + )])), + ); + let display = TooltipDisplay::for_stack(&stack); + assert!(display.name_visible(false)); + assert!(!display.shows("minecraft:attribute_modifiers")); + assert!(display.shows("minecraft:enchantments")); + + stack.data_mut().set_other( + "minecraft:tooltip_display", + Some(Tag::compound([("hide_tooltip", Tag::Byte(1))])), + ); + let display = TooltipDisplay::for_stack(&stack); + assert!(!display.name_visible(false)); + assert!(display.name_visible(true)); + assert!(!display.shows("minecraft:attribute_modifiers")); + } + + #[test] + fn ominous_banner_keeps_its_default_hidden_pattern_tooltip() { + let mut banner = crate::mobs::raider::ominous_banner(); + let display = TooltipDisplay::for_stack(&banner); + assert!(!display.shows("minecraft:banner_patterns")); + + banner.data_mut().set_other( + "minecraft:tooltip_display", + Some(Tag::Compound(Default::default())), + ); + let display = TooltipDisplay::for_stack(&banner); + assert!(display.shows("minecraft:banner_patterns")); + } + #[test] fn ominous_banner_name_and_rarity_use_the_stack() { let translate = |key: &str| match key { diff --git a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaTooltipDisplayOracle.java b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaTooltipDisplayOracle.java new file mode 100644 index 000000000..c31dce98c --- /dev/null +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaTooltipDisplayOracle.java @@ -0,0 +1,36 @@ +package dev.horizonlab.parity; + +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.ArrayList; +import java.util.LinkedHashSet; +import net.minecraft.core.component.DataComponentType; +import net.minecraft.core.component.DataComponents; +import net.minecraft.world.item.Item; +import net.minecraft.world.item.ItemStack; +import net.minecraft.world.item.Items; +import net.minecraft.world.item.TooltipFlag; +import net.minecraft.world.item.component.TooltipDisplay; + +/** The name and attribute lines returned for a diamond sword's tooltip. */ +public final class VanillaTooltipDisplayOracle { + public static void main(String[] args) throws Exception { + ParityData.init(); + var context = Item.TooltipContext.of(ParityData.lookup); + var output = new ArrayList<String>(); + for (String line : Files.readAllLines(Path.of(args[0]))) { + String[] fields = line.split("\t"); + boolean hideTooltip = Boolean.parseBoolean(fields[0]); + boolean creative = Boolean.parseBoolean(fields[1]); + boolean hideAttributes = Boolean.parseBoolean(fields[2]); + var hidden = new LinkedHashSet<DataComponentType<?>>(); + if (hideAttributes) hidden.add(DataComponents.ATTRIBUTE_MODIFIERS); + var stack = new ItemStack(Items.DIAMOND_SWORD, 1); + stack.set(DataComponents.TOOLTIP_DISPLAY, new TooltipDisplay(hideTooltip, hidden)); + TooltipFlag flag = creative ? TooltipFlag.Default.NORMAL.asCreative() : TooltipFlag.Default.NORMAL; + var tooltip = stack.getTooltipLines(context, null, flag); + output.add((!tooltip.isEmpty()) + "\t" + (tooltip.size() > 1)); + } + Files.write(Path.of(args[1]), output); + } +} diff --git a/tools/test_tooltip_display_parity.py b/tools/test_tooltip_display_parity.py new file mode 100644 index 000000000..e98807d1b --- /dev/null +++ b/tools/test_tooltip_display_parity.py @@ -0,0 +1,31 @@ +#!/usr/bin/env python3 +"""Compare item tooltip display visibility with the pinned vanilla client.""" +try: + from . import lab, oracle_harness as harness +except ImportError: + import lab, oracle_harness as harness + + +def cases(build): + values = [ + (False, False, False), + (False, False, True), + (False, True, True), + (True, False, False), + (True, True, False), + (True, True, True), + ] + path = build / 'cases.txt' + path.write_text('\n'.join('\t'.join(map(str, row)) for row in values) + '\n') + return path, len(values) + + +if __name__ == '__main__': + harness.differential( + 'tooltip-display-parity', 'VanillaTooltipDisplayOracle', 'tooltip_display_fixture', cases, + 'Diamond sword name and attribute tooltip visibility for hide_tooltip, hidden_components, and creative flags', + sources=[ + lab.ROOT / 'crates/horizon-client/src/game/stations.rs', + lab.ROOT / 'crates/horizon-client/src/item_tooltip.rs', + ], + expected_lines=6) From 2c244f188824aedc48212955ac87333863c67a30 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 00:04:14 +0200 Subject: [PATCH 042/163] Creaking hearts: scan only sections whose palette holds a heart scan_for_hearts read all 4,096 blocks of every non-air section of each new chunk on the server thread to find creaking hearts. A section whose palette holds no heart state (PalettedContainer.maybeHas) cannot have one, so it is skipped. Same block entities, same order. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game/creaking.rs | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/crates/horizon-client/src/game/creaking.rs b/crates/horizon-client/src/game/creaking.rs index 099f3d7d8..4a8a5239b 100644 --- a/crates/horizon-client/src/game/creaking.rs +++ b/crates/horizon-client/src/game/creaking.rs @@ -327,13 +327,16 @@ impl Game<'_> { } let hearts = &self.creaking.hearts; let _ = heart; + let is_heart = |id: u32| hearts.get(id as usize).copied().unwrap_or(false); for (si, section) in chunk.sections.iter().enumerate() { - if section.is_uniform(0) { + // Only a section whose palette holds a heart state can have + // one: the others are skipped without reading their 4,096 blocks. + if !section.blocks.maybe_has(is_heart) { continue; } for i in 0..4096 { let id = section.get(i); - if !hearts.get(id as usize).copied().unwrap_or(false) { + if !is_heart(id) { continue; } let (lx, lz, ly) = ((i & 15) as i32, ((i >> 4) & 15) as i32, (i >> 8) as i32); From 43e8b54918739c858df6a14cd7a9e6c4baf2c6bb Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 21:57:33 +0200 Subject: [PATCH 043/163] Server: track boats, minecarts, armor stands, frames and paintings to clients A server sent its clients only mobs and dropped items. Boats, every kind of minecart, armor stands, item frames, paintings and the entities Horizon keeps without simulating are now tracked as ServerEntity does: the AddEntity data (hanging entities at their block, with their direction), the synched data that differs from the defaults, equipment, passengers (ClientboundSetPassengersPacket at pairing and on change; a passenger syncs only its rotation and resyncs its position when it dismounts), and the type's update interval and range. Also vanilla-exact on the way, as the new harness found: - mobs pair with their health (always non-default) and Mob flags (no AI, left-handed); - /summon without NBT summons any type from an empty compound; - armor stands move before gravity (LivingEntity.travelInAir), so a stand at rest keeps vanilla's -0.0784 vertical motion. tools/test_server_entities_parity.py compares, from a vanilla-codec client, what vanilla's dedicated server and Horizon's track for a scene of 20 entities. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/entities.rs | 17 +- crates/horizon-client/src/game.rs | 1 + crates/horizon-client/src/game/commands.rs | 8 +- crates/horizon-client/src/game/lan.rs | 18 +- .../horizon-client/src/game/lan_entities.rs | 259 ++++++++++++++++++ crates/horizon-client/src/game/minecarts.rs | 4 + crates/horizon-client/src/lan/entity.rs | 183 +++++++++---- crates/horizon-client/src/lan/hub.rs | 7 +- crates/horizon-protocol/src/packets/play.rs | 9 + .../horizonlab/parity/EntityTranscript.java | 160 +++++++++++ .../parity/VanillaProtocolClient.java | 36 ++- tools/test_server_entities_parity.py | 174 ++++++++++++ 12 files changed, 811 insertions(+), 65 deletions(-) create mode 100644 crates/horizon-client/src/game/lan_entities.rs create mode 100644 mods/horizon/src/test/java/dev/horizonlab/parity/EntityTranscript.java create mode 100644 tools/test_server_entities_parity.py diff --git a/crates/horizon-client/src/entities.rs b/crates/horizon-client/src/entities.rs index 4ceafb3d0..5c905ac54 100644 --- a/crates/horizon-client/src/entities.rs +++ b/crates/horizon-client/src/entities.rs @@ -535,15 +535,16 @@ impl ArmorStand { Vec3::new(p.x + w, p.y + h, p.z + w), ) } - /// LivingEntity.travel with gravity 0.08 and 0.98 drag, falling until it - /// lands (armor stands have no other movement). + /// LivingEntity.travelInAir (armor stands have no other movement): move + /// by the velocity (a landing stops the fall, + /// `Block.updateEntityMovementAfterFallOn`), then gravity 0.08 and the + /// 0.98 drag, so a stand at rest on the ground keeps -0.0784 as vanilla's. pub fn tick(&mut self, scene: &mut crate::collisions::SceneCollisions) { if self.marker { return; } - let mut v = self.velocity; - v.y -= 0.08; - let wanted = v; + let wanted = self.velocity; + let mut y = wanted.y; if let Ok(moved) = scene.resolve(self.bounds(), wanted, 0.0, self.on_ground) { self.position = Vec3::new( self.position.x + moved.x, @@ -551,9 +552,11 @@ impl ArmorStand { self.position.z + moved.z, ); self.on_ground = wanted.y < 0.0 && moved.y > wanted.y; - v = Vec3::new(0.0, if moved.y != wanted.y { 0.0 } else { v.y * 0.98 }, 0.0); + if moved.y != wanted.y { + y = 0.0; + } } - self.velocity = v; + self.velocity = Vec3::new(0.0, (y - 0.08) * f64::from(0.98f32), 0.0); } } diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index e126c533a..436802be2 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -64,6 +64,7 @@ mod jukebox; mod lan; mod lan_actions; mod lan_crafting; +mod lan_entities; mod lan_mobs; mod lan_pvp; mod lan_screen; diff --git a/crates/horizon-client/src/game/commands.rs b/crates/horizon-client/src/game/commands.rs index 3ca938d6a..27f89b243 100644 --- a/crates/horizon-client/src/game/commands.rs +++ b/crates/horizon-client/src/game/commands.rs @@ -1481,7 +1481,13 @@ impl Game<'_> { self.carts.push(cart); name = Text::translate(&format!("entity.minecraft.{k}"), &[]); } - _ => return Err(err("commands.summon.failed", &[])), + // SummonCommand.createEntity: any other type from an empty compound. + _ => { + let Some(target) = self.summon_with_nbt(&kind, pos, "{}")? else { + return Err(err("commands.summon.failed", &[])); + }; + name = self.target_name(target); + } } } self.feedback(Text::translate("commands.summon.success", &[name])); diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index 57c7b9ee0..209c34286 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -73,7 +73,7 @@ pub(super) struct Owner { } /// A stable UUID for an entity that has none. -fn entity_uuid(id: u32) -> u128 { +pub(super) fn entity_uuid(id: u32) -> u128 { 0x4856_5a4e_0000_0000_0000_0000_0000_0000u128 | u128::from(id) } @@ -144,11 +144,15 @@ fn mob_meta(m: &Mob, hub: &Hub) -> Vec<(u8, i32, Value)> { meta.push((3, serializer::BOOLEAN, Value::Bool(true))); } } - if m.health < m.kind.max_health { - meta.push((9, serializer::FLOAT, Value::Float(m.health.max(0.0)))); + // LivingEntity.DATA_HEALTH_ID: defined as 1, then set to the max health. + let health = m.health.max(0.0); + if health != 1.0 { + meta.push((9, serializer::FLOAT, Value::Float(health))); } - if kind == "minecraft:rabbit" && m.no_ai { - meta.push((15, serializer::BYTE, Value::Byte(1))); + // Mob.DATA_MOB_FLAGS_ID: no AI 1, left-handed 2. + let flags = i8::from(m.no_ai) | i8::from(m.extra.left_handed) << 1; + if flags != 0 { + meta.push((15, serializer::BYTE, Value::Byte(flags))); } if m.is_baby() && let Some(index) = baby_index(kind) @@ -713,7 +717,7 @@ impl Game<'_> { }) } - /// Mobs and items as the entities guests track. + /// The entities guests track: mobs, items and the rest (game/lan_entities.rs). fn lan_entities(&self, hub: &mut Hub) -> Vec<EntityState> { let mut out = Vec::with_capacity(self.mobs.len() + self.dropped.len() + self.orbs.len()); for m in self.mobs.iter().filter(|m| !m.removed) { @@ -770,6 +774,7 @@ impl Game<'_> { equipment: Vec::new(), }); } + self.lan_object_states(hub, &mut out); out } @@ -785,6 +790,7 @@ impl Game<'_> { if state.is_some() || host.hub.config.dedicated { let has_guests = !host.hub.guests.is_empty(); let entities = if has_guests { + self.lan_riding(state.as_ref().map(|s| s.entity_id), &mut host.hub.riding); self.lan_entities(&mut host.hub) } else { Vec::new() diff --git a/crates/horizon-client/src/game/lan_entities.rs b/crates/horizon-client/src/game/lan_entities.rs new file mode 100644 index 000000000..9064447aa --- /dev/null +++ b/crates/horizon-client/src/game/lan_entities.rs @@ -0,0 +1,259 @@ +//! The entities beyond mobs and items that a server tracks to its clients +//! (`ChunkMap.TrackedEntity`, `ServerEntity`): boats, minecarts, armor +//! stands, item frames, paintings and the entities Horizon keeps without +//! simulating them, each as vanilla pairs it (`getAddEntityPacket` and the +//! synched data that differs from the defaults), and who rides what. +use super::Game; +use horizon_client::lan::{ + entity::{EntityState, Riding}, + hub::Hub, +}; +use horizon_protocol::entity_data::{Value, serializer}; +use horizon_world::nbt::Tag; + +/// `ArmorStand`'s default poses (head, body, left arm, right arm, left leg, +/// right leg), DATA_HEAD_POSE to DATA_RIGHT_LEG_POSE (entries 16 to 21), +/// under their `Pose` keys. +const STAND_POSES: [(&str, [f32; 3]); 6] = [ + ("Head", [0.0, 0.0, 0.0]), + ("Body", [0.0, 0.0, 0.0]), + ("LeftArm", [-10.0, 0.0, -10.0]), + ("RightArm", [-15.0, 0.0, 10.0]), + ("LeftLeg", [-1.0, 0.0, -1.0]), + ("RightLeg", [1.0, 0.0, 1.0]), +]; + +fn state(id: u32, kind: &str, position: [f64; 3], yaw: f32, on_ground: bool) -> EntityState { + EntityState { + id: id as i32, + uuid: super::lan::entity_uuid(id), + kind: kind.to_owned(), + position, + yaw, + pitch: 0.0, + head_yaw: 0.0, + on_ground, + velocity: [0.0; 3], + data: 0, + meta: Vec::new(), + equipment: Vec::new(), + } +} + +/// `VehicleEntity`'s DATA_ID_HURT, DATA_ID_HURTDIR and DATA_ID_DAMAGE +/// (entries 8 to 10) when they differ from their defaults (0, 1, 0). +fn vehicle_meta(hurt_time: i32, hurt_dir: i32, damage: f32) -> Vec<(u8, i32, Value)> { + let mut meta = Vec::new(); + if hurt_time != 0 { + meta.push((8, serializer::INT, Value::Int(hurt_time))); + } + if hurt_dir != 1 { + meta.push((9, serializer::INT, Value::Int(hurt_dir))); + } + if damage != 0.0 { + meta.push((10, serializer::FLOAT, Value::Float(damage))); + } + meta +} + +/// An armor stand's pose from its compound (`ArmorStandPose`), each part +/// that differs from the default. +fn stand_poses(raw: Option<&Tag>) -> Vec<(u8, i32, Value)> { + let Some(pose) = raw.and_then(|t| t.get("Pose")) else { + return Vec::new(); + }; + let mut meta = Vec::new(); + for (i, (key, default)) in STAND_POSES.iter().enumerate() { + let Some(Tag::List(values)) = pose.get(key) else { + continue; + }; + let mut r = *default; + for (k, v) in values.iter().take(3).enumerate() { + if let Tag::Float(bits) = v { + r[k] = f32::from_bits(*bits); + } + } + if r != *default { + meta.push(( + 16 + i as u8, + serializer::ROTATIONS, + Value::Floats(r.to_vec()), + )); + } + } + meta +} + +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<i32>, riding: &mut Riding) { + riding.clear(); + 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); + } + } + if let (Some(host), Some(vehicle)) = (host_entity, self.riding) { + riding.add(vehicle as i32, host); + } + } + + /// Boats, minecarts, armor stands, item frames, paintings and the + /// entities kept unsimulated, as guests track them. + pub(super) fn lan_object_states(&self, hub: &mut Hub, out: &mut Vec<EntityState>) { + for b in &self.boats { + let p = b.position; + let mut e = state(b.id, &b.entity_type(), [p.x, p.y, p.z], b.yaw, b.on_ground); + e.velocity = [b.velocity.x, b.velocity.y, b.velocity.z]; + e.meta = vehicle_meta(b.hurt_time, b.hurt_dir, b.damage); + // AbstractBoat.DATA_ID_PADDLE_LEFT and DATA_ID_PADDLE_RIGHT. + for (k, paddling) in b.paddling.iter().enumerate() { + if *paddling { + e.meta + .push((11 + k as u8, serializer::BOOLEAN, Value::Bool(true))); + } + } + out.push(e); + } + for c in &self.carts { + let p = c.position; + let mut e = state(c.id, c.kind.id(), [p.x, p.y, p.z], c.yaw, c.on_ground()); + e.velocity = [c.velocity.x, c.velocity.y, c.velocity.z]; + e.meta = vehicle_meta(c.hurt_time, c.hurt_dir, c.damage); + match c.kind { + // MinecartFurnace.DATA_ID_FUEL. + super::minecarts::CartKind::Furnace if c.fuel > 0 => { + e.meta.push((13, serializer::BOOLEAN, Value::Bool(true))); + } + // MinecartCommandBlock.DATA_ID_COMMAND_NAME. + super::minecarts::CartKind::CommandBlock => { + if let Some(Tag::String(command)) = + self.persist.raw.get(&c.id).and_then(|t| t.get("Command")) + { + let command = command.to_string_lossy(); + if !command.is_empty() { + e.meta + .push((13, serializer::STRING, Value::String(command))); + } + } + } + _ => {} + } + out.push(e); + } + for a in &self.armor_stands { + let p = a.position; + let mut e = state( + a.id, + "minecraft:armor_stand", + [p.x, p.y, p.z], + a.yaw, + a.on_ground, + ); + e.head_yaw = a.yaw; + e.velocity = [a.velocity.x, a.velocity.y, a.velocity.z]; + if a.fire_ticks > 0 { + e.meta.push((0, serializer::BYTE, Value::Byte(1))); + } + // LivingEntity.DATA_HEALTH_ID: 1 until the stand's max health is set. + e.meta.push((9, serializer::FLOAT, Value::Float(a.health))); + // ArmorStand.DATA_CLIENT_FLAGS: small 1, arms 4, no base plate 8, marker 16. + let flags = i8::from(a.small) + | i8::from(a.show_arms) << 2 + | i8::from(a.no_base_plate) << 3 + | i8::from(a.marker) << 4; + if flags != 0 { + e.meta.push((15, serializer::BYTE, Value::Byte(flags))); + } + e.meta.extend(stand_poses(self.persist.raw.get(&a.id))); + // Stored main hand, off hand, feet, legs, chest, head: the wire's slots 0 to 5. + for (slot, item) in a.equipment.iter().enumerate() { + if item.is_some() { + e.equipment.push((slot as u8, hub.stack(item))); + } + } + out.push(e); + } + for f in &self.item_frames { + // ItemFrame.getAddEntityPacket: the block it hangs in and its direction. + let mut e = state(f.id, f.kind(), f.pos.map(f64::from), 0.0, false); + e.pitch = match f.facing { + 0 => 90.0, + 1 => -90.0, + _ => 0.0, + }; + e.yaw = match f.facing { + 2 => 180.0, + 4 => 90.0, + 5 => 270.0, + _ => 0.0, + }; + e.data = i32::from(f.facing); + // HangingEntity.DATA_DIRECTION, south by default. + if f.facing != 3 { + e.meta + .push((8, serializer::DIRECTION, Value::Id(i32::from(f.facing)))); + } + if f.item.is_some() { + e.meta + .push((9, serializer::ITEM_STACK, Value::Item(hub.stack(&f.item)))); + } + if f.rotation != 0 { + e.meta + .push((10, serializer::INT, Value::Int(i32::from(f.rotation)))); + } + out.push(e); + } + for p in &self.paintings { + let mut e = state(p.id, "minecraft:painting", p.pos.map(f64::from), 0.0, false); + // Direction.get2DDataValue (south 0, west 1, north 2, east 3) to its + // 3D data value and yaw. + let facing = [3, 4, 2, 5][usize::from(p.facing & 3)]; + e.yaw = f32::from(p.facing & 3) * 90.0; + e.data = facing; + if facing != 3 { + e.meta.push((8, serializer::DIRECTION, Value::Id(facing))); + } + // Painting.DATA_PAINTING_VARIANT_ID, a registry holder (id + 1), + // set unless it is the registry's first variant (VariantUtils.getAny). + if let Some(id) = hub.registry_id("minecraft:painting_variant", &p.variant) + && id != 0 + { + e.meta + .push((9, serializer::PAINTING_VARIANT, Value::Id(id + 1))); + } + out.push(e); + } + for o in &self.others { + let p = o.position; + let mut e = state(o.id, &o.kind, [p.x, p.y, p.z], o.yaw, false); + e.pitch = o.pitch; + e.head_yaw = o.yaw; + out.push(e); + } + } +} + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn armor_stand_poses_send_only_what_differs() { + let tag = + horizon_world::nbt::parse_snbt("{Pose:{Head:[10f,20f,0f],LeftArm:[-10f,0f,-10f]}}") + .unwrap() + .0; + let meta = stand_poses(Some(&tag)); + assert_eq!( + meta, + vec![( + 16, + serializer::ROTATIONS, + Value::Floats(vec![10.0, 20.0, 0.0]) + )] + ); + assert!(stand_poses(None).is_empty()); + } +} diff --git a/crates/horizon-client/src/game/minecarts.rs b/crates/horizon-client/src/game/minecarts.rs index de440433d..1e0b42b50 100644 --- a/crates/horizon-client/src/game/minecarts.rs +++ b/crates/horizon-client/src/game/minecarts.rs @@ -157,6 +157,10 @@ pub(super) struct Rail { powered: bool, } impl Minecart { + /// `Entity.onGround`. + pub(super) fn on_ground(&self) -> bool { + self.on_ground + } pub fn new(id: u32, kind: CartKind, position: Vec3) -> Self { Self { id, diff --git a/crates/horizon-client/src/lan/entity.rs b/crates/horizon-client/src/lan/entity.rs index a37010d79..178f9bd44 100644 --- a/crates/horizon-client/src/lan/entity.rs +++ b/crates/horizon-client/src/lan/entity.rs @@ -11,7 +11,7 @@ use horizon_protocol::{ packets::play::{ self, AddEntity, EntityPositionSync, MoveEntity, MoveEntityPos, MoveEntityPosRot, MoveEntityRot, PositionPath, RotateHead, SetEntityData, SetEntityMotion, SetEquipment, - VecDelta, + SetPassengers, VecDelta, }, }; @@ -54,6 +54,40 @@ struct Sent { /// The type's update interval (0: never) and whether velocity is tracked. interval: u32, track_deltas: bool, + /// lastPassengers, and wasRiding: a passenger's position isn't synced, + /// and the first update after it dismounts is a full position sync. + passengers: Vec<i32>, + was_riding: bool, +} + +/// Who rides what this tick (`Entity.getPassengers`, `isPassenger`). +#[derive(Default)] +pub struct Riding { + /// Each vehicle's passengers, in order. + pub passengers: crate::fast_hash::FxHashMap<i32, Vec<i32>>, + /// Each passenger's vehicle. + pub vehicle: crate::fast_hash::FxHashMap<i32, i32>, +} + +impl Riding { + pub fn clear(&mut self) { + self.passengers.clear(); + self.vehicle.clear(); + } + /// `passenger` rides `vehicle`, after the ones already riding it. + pub fn add(&mut self, vehicle: i32, passenger: i32) { + self.passengers.entry(vehicle).or_default().push(passenger); + self.vehicle.insert(passenger, vehicle); + } + pub fn passengers(&self, id: i32) -> &[i32] { + self.passengers.get(&id).map_or(&[], Vec::as_slice) + } + fn set_passengers(&self, vehicle: i32) -> play::Clientbound { + play::Clientbound::SetPassengers(SetPassengers { + vehicle, + passengers: self.passengers(vehicle).to_vec(), + }) + } } #[derive(Default)] @@ -94,7 +128,12 @@ impl Tracker { } /// The packets that introduce an entity (ServerEntity.sendPairingData). - pub fn spawn(&mut self, e: &EntityState, entity_type: i32) -> Vec<play::Clientbound> { + pub fn spawn( + &mut self, + e: &EntityState, + entity_type: i32, + riding: &Riding, + ) -> Vec<play::Clientbound> { let rotation = (pack_degrees(e.pitch), pack_degrees(e.yaw)); let head = pack_degrees(e.head_yaw); let (_, interval, track_deltas) = tracking::settings(&e.kind); @@ -121,6 +160,13 @@ impl Tracker { slots: e.equipment.clone(), })); } + let passengers = riding.passengers(e.id).to_vec(); + if !passengers.is_empty() { + out.push(riding.set_passengers(e.id)); + } + if let Some(&vehicle) = riding.vehicle.get(&e.id) { + out.push(riding.set_passengers(vehicle)); + } self.sent.insert( e.id, Sent { @@ -135,6 +181,8 @@ impl Tracker { teleport_delay: 0, interval, track_deltas, + passengers, + was_riding: false, }, ); out @@ -144,17 +192,43 @@ impl Tracker { /// rotation every update interval (positions at least every 60 ticks, a /// full position sync every 400 or when the entity lands or leaves the /// ground), velocity for types that track it, changed data at once. - pub fn update(&mut self, e: &EntityState) -> Vec<play::Clientbound> { + pub fn update(&mut self, e: &EntityState, riding: &Riding) -> Vec<play::Clientbound> { let Some(s) = self.sent.get_mut(&e.id) else { return Vec::new(); }; let mut out = Vec::new(); + let passengers = riding.passengers(e.id); + if passengers != s.passengers.as_slice() { + out.push(riding.set_passengers(e.id)); + s.passengers = passengers.to_vec(); + } let dirty = e.meta != s.meta; let due = s.interval != 0 && s.tick.is_multiple_of(s.interval); if due || dirty { let rotation = (pack_degrees(e.pitch), pack_degrees(e.yaw)); let turned = |a: i8, b: i8| (i32::from(a) - i32::from(b)).abs() >= 1; let rotate = turned(rotation.1, s.rotation.1) || turned(rotation.0, s.rotation.0); + if riding.vehicle.contains_key(&e.id) { + // A passenger: its rotation alone (its vehicle places it). + if rotate { + out.push(play::Clientbound::MoveEntityRot(MoveEntityRot( + MoveEntity { + id: e.id, + delta: None, + rotation: Some((rotation.1, rotation.0)), + on_ground: e.on_ground, + }, + ))); + s.rotation = rotation; + } + s.base = e.position; + s.was_riding = true; + Self::send_dirty(e, s, dirty, &mut out); + Self::send_head(e, s, &mut out); + s.tick += 1; + Self::send_equipment(e, s, &mut out); + return out; + } s.teleport_delay += 1; let d: f64 = (0..3).map(|k| (e.position[k] - s.base[k]).powi(2)).sum(); let send_position = d >= 7.629_394_5e-6 || s.tick.is_multiple_of(60); @@ -166,9 +240,11 @@ impl Tracker { on_ground: e.on_ground, }; // ServerEntity.createMovePacket. - let packet = if s.teleport_delay > 400 || s.was_on_ground != e.on_ground { + let packet = if s.teleport_delay > 400 || s.was_riding || s.was_on_ground != e.on_ground + { s.was_on_ground = e.on_ground; s.teleport_delay = 0; + s.was_riding = false; Some(play::Clientbound::EntityPositionSync(sync)) } else if send_position { let delta = [0, 1, 2].map(|k| encode(e.position[k]) - encode(s.base[k])); @@ -227,33 +303,47 @@ impl Tracker { s.rotation = rotation; } } - // ServerEntity.sendDirtyEntityData. - if dirty { - let changed: Vec<_> = e - .meta - .iter() - .filter(|m| !s.meta.contains(m)) - .cloned() - .collect(); - if !changed.is_empty() { - out.push(play::Clientbound::SetEntityData(SetEntityData { - id: e.id, - values: changed, - })); - } - s.meta = e.meta.clone(); - } - let head = pack_degrees(e.head_yaw); - if turned(head, s.head) { - out.push(play::Clientbound::RotateHead(RotateHead { - id: e.id, - head_yaw: head, - })); - s.head = head; - } + Self::send_dirty(e, s, dirty, &mut out); + Self::send_head(e, s, &mut out); } s.tick += 1; - // LivingEntity.detectEquipmentUpdates: changed slots every tick. + Self::send_equipment(e, s, &mut out); + out + } + + /// ServerEntity.sendDirtyEntityData. + fn send_dirty(e: &EntityState, s: &mut Sent, dirty: bool, out: &mut Vec<play::Clientbound>) { + if !dirty { + return; + } + let changed: Vec<_> = e + .meta + .iter() + .filter(|m| !s.meta.contains(m)) + .cloned() + .collect(); + if !changed.is_empty() { + out.push(play::Clientbound::SetEntityData(SetEntityData { + id: e.id, + values: changed, + })); + } + s.meta = e.meta.clone(); + } + + fn send_head(e: &EntityState, s: &mut Sent, out: &mut Vec<play::Clientbound>) { + let head = pack_degrees(e.head_yaw); + if (i32::from(head) - i32::from(s.head)).abs() >= 1 { + out.push(play::Clientbound::RotateHead(RotateHead { + id: e.id, + head_yaw: head, + })); + s.head = head; + } + } + + /// LivingEntity.detectEquipmentUpdates: changed slots every tick. + fn send_equipment(e: &EntityState, s: &mut Sent, out: &mut Vec<play::Clientbound>) { if e.equipment != s.equipment { // Cleared slots are sent as empty stacks. let mut slots: Vec<(u8, Option<Stack>)> = e @@ -275,7 +365,6 @@ impl Tracker { } s.equipment = e.equipment.clone(); } - out } } @@ -303,24 +392,24 @@ mod tests { #[test] fn moves_go_out_every_update_interval() { let mut t = Tracker::default(); - let spawn = t.spawn(&state(0.0), 100); + let spawn = t.spawn(&state(0.0), 100, &Riding::default()); assert!(matches!(spawn[0], play::Clientbound::AddEntity(_))); // Tick 0 is due and a multiple of 60: the position goes out unchanged. assert!(matches!( - t.update(&state(0.0))[..], + t.update(&state(0.0), &Riding::default())[..], [play::Clientbound::MoveEntityPos(_)] )); // A zombie updates every third tick. - assert!(t.update(&state(0.5)).is_empty()); - assert!(t.update(&state(0.5)).is_empty()); + assert!(t.update(&state(0.5), &Riding::default()).is_empty()); + assert!(t.update(&state(0.5), &Riding::default()).is_empty()); assert!(matches!( - t.update(&state(0.5))[..], + t.update(&state(0.5), &Riding::default())[..], [play::Clientbound::MoveEntityPos(_)] )); for _ in 0..2 { - t.update(&state(40.0)); + t.update(&state(40.0), &Riding::default()); } - let jump = t.update(&state(40.0)); + let jump = t.update(&state(40.0), &Riding::default()); assert!(matches!(jump[0], play::Clientbound::EntityPositionSync(_))); } @@ -328,13 +417,13 @@ mod tests { fn landing_sends_a_position_sync() { let mut t = Tracker::default(); let mut e = state(0.0); - t.spawn(&e, 100); - t.update(&e); + t.spawn(&e, 100, &Riding::default()); + t.update(&e, &Riding::default()); e.on_ground = false; - t.update(&e); - t.update(&e); + t.update(&e, &Riding::default()); + t.update(&e, &Riding::default()); assert!(matches!( - t.update(&e)[..], + t.update(&e, &Riding::default())[..], [play::Clientbound::EntityPositionSync(_)] )); } @@ -343,11 +432,11 @@ mod tests { fn metadata_and_equipment_send_only_the_changes() { let mut t = Tracker::default(); let mut e = state(0.0); - t.spawn(&e, 100); - t.update(&e); + t.spawn(&e, 100, &Riding::default()); + t.update(&e, &Riding::default()); e.meta.push((0, 0, Value::Byte(1))); e.equipment.push((0, Some(Stack::new(5, 1)))); - let out = t.update(&e); + let out = t.update(&e, &Riding::default()); assert!( out.iter() .any(|p| matches!(p, play::Clientbound::SetEntityData(_))) @@ -356,9 +445,9 @@ mod tests { out.iter() .any(|p| matches!(p, play::Clientbound::SetEquipment(_))) ); - assert!(t.update(&e).is_empty()); + assert!(t.update(&e, &Riding::default()).is_empty()); e.equipment.clear(); - let out = t.update(&e); + let out = t.update(&e, &Riding::default()); let Some(play::Clientbound::SetEquipment(eq)) = out.first() else { panic!("expected equipment"); }; diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index b18187835..d710c239e 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -124,6 +124,8 @@ pub struct Hub { /// The `player_movement_check` and `elytra_movement_check` game rules, /// set by the game before each tick. pub movement_checks: (bool, bool), + /// Who rides what, set by the game before each tick. + pub riding: super::entity::Riding, last_clock: i64, last_rate: f32, ticking: (f32, bool), @@ -237,6 +239,7 @@ impl Hub { sync, ticks: 0, movement_checks: (true, true), + riding: Default::default(), last_clock: i64::MIN, last_rate: 0.0, ticking: (20.0, false), @@ -1501,14 +1504,14 @@ impl Hub { continue; } if self.guests[gi].tracker.is_tracking(e.id) { - let packets = self.guests[gi].tracker.update(e); + let packets = self.guests[gi].tracker.update(e, &self.riding); self.guests[gi].send_all(&packets); } else if visible(&self.guests[gi], ei) { let Some(kind) = self.entity_type(&e.kind) else { continue; }; // Players need their list entry first; guests got it at join. - let packets = self.guests[gi].tracker.spawn(e, kind); + let packets = self.guests[gi].tracker.spawn(e, kind, &self.riding); self.guests[gi].send_all(&packets); } } diff --git a/crates/horizon-protocol/src/packets/play.rs b/crates/horizon-protocol/src/packets/play.rs index 95ce869a4..40b70624a 100644 --- a/crates/horizon-protocol/src/packets/play.rs +++ b/crates/horizon-protocol/src/packets/play.rs @@ -590,6 +590,10 @@ packet!(SetCursorItem { item: Option<Stack> => Slot }); packet!(SetDefaultSpawnPosition { pos: GlobalPos => GlobalPos, yaw: f32 => Float, pitch: f32 => Float }); packet!(SetEntityData { id: i32 => VarInt, values: Vec<(u8, i32, Value)> => EntityData }); packet!(SetEntityMotion { id: i32 => VarInt, velocity: [f64; 3] => LpVec3 }); +packet!( + /// ClientboundSetPassengersPacket: a vehicle and every entity riding it. + SetPassengers { vehicle: i32 => VarInt, passengers: Vec<i32> => List<VarInt> } +); /// ClientboundSetEquipmentPacket: (EquipmentSlot ordinal, stack) pairs. pub struct Equipment; impl Codec<Vec<(u8, Option<Stack>)>> for Equipment { @@ -1426,6 +1430,7 @@ packet_enum!(Clientbound, crate::ids::play::clientbound { SetHealth(SetHealth) = SET_HEALTH, SetHeldSlot(SetHeldSlot) = SET_HELD_SLOT, SetObjective(SetObjective) = SET_OBJECTIVE, + SetPassengers(SetPassengers) = SET_PASSENGERS, SetPlayerInventory(SetPlayerInventory) = SET_PLAYER_INVENTORY, SetPlayerTeam(SetPlayerTeam) = SET_PLAYER_TEAM, SetScore(SetScore) = SET_SCORE, @@ -2052,6 +2057,10 @@ mod tests { id: 2, velocity: [0.0; 3], }), + Clientbound::SetPassengers(SetPassengers { + vehicle: 2, + passengers: vec![3, 300], + }), Clientbound::SetEquipment(SetEquipment { id: 2, slots: vec![(0, None), (5, Some(Stack::new(1, 1)))], diff --git a/mods/horizon/src/test/java/dev/horizonlab/parity/EntityTranscript.java b/mods/horizon/src/test/java/dev/horizonlab/parity/EntityTranscript.java new file mode 100644 index 000000000..4d7cc9f2c --- /dev/null +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/EntityTranscript.java @@ -0,0 +1,160 @@ +package dev.horizonlab.parity; + +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.TreeMap; +import net.minecraft.core.registries.BuiltInRegistries; +import net.minecraft.network.protocol.Packet; +import net.minecraft.network.protocol.game.ClientboundAddEntityPacket; +import net.minecraft.network.protocol.game.ClientboundEntityPositionSyncPacket; +import net.minecraft.network.protocol.game.ClientboundMoveEntityPacket; +import net.minecraft.network.protocol.game.ClientboundRemoveEntitiesPacket; +import net.minecraft.network.protocol.game.ClientboundRotateHeadPacket; +import net.minecraft.network.protocol.game.ClientboundSetEntityDataPacket; +import net.minecraft.network.protocol.game.ClientboundSetEntityMotionPacket; +import net.minecraft.network.protocol.game.ClientboundSetEquipmentPacket; +import net.minecraft.network.protocol.game.ClientboundSetPassengersPacket; +import net.minecraft.network.protocol.game.ClientboundTeleportEntityPacket; +import net.minecraft.network.protocol.game.ClientboundUpdateAttributesPacket; +import net.minecraft.network.protocol.game.VecDeltaCodec; +import net.minecraft.world.entity.EntityTypes; +import net.minecraft.world.phys.Vec3; + +/** + * What a vanilla client knows about the entities a server tracks to it, as + * ClientPacketListener would apply the packets: each entity's spawn packet, + * the entity data it was paired with and all it was sent since, its + * equipment, attributes and passengers, and where the position syncs leave + * it (VecDeltaCodec, as handleMoveEntity and handleEntityPositionSync). + * Entity ids differ between servers: an entity is named by its type and the + * block it was added in, passengers by those names. Players are left out. + */ +final class EntityTranscript { + private static final class Tracked { + final String type; + final String add; + final VecDeltaCodec codec = new VecDeltaCodec(); + String name; + String pairing; + final Map<Integer, String> data = new TreeMap<>(); + final Map<String, String> equipment = new TreeMap<>(); + final Map<String, String> attributes = new TreeMap<>(); + int[] passengers = new int[0]; + float yRot; + float xRot; + float headRot; + boolean onGround; + String motion; + boolean removed; + + Tracked(ClientboundAddEntityPacket p) { + type = BuiltInRegistries.ENTITY_TYPE.getKey(p.getType()).toString(); + Vec3 at = new Vec3(p.getX(), p.getY(), p.getZ()); + codec.setBase(at); + name = type + " " + (int) Math.floor(at.x) + "," + (int) Math.floor(at.y) + "," + (int) Math.floor(at.z); + add = "at " + at + " rot " + p.getXRot() + "," + p.getYRot() + " head " + p.getYHeadRot() + " data " + p.getData() + + " motion " + p.getMovement(); + yRot = p.getYRot(); + xRot = p.getXRot(); + headRot = p.getYHeadRot(); + motion = String.valueOf(p.getMovement()); + } + } + + private final Map<Integer, Tracked> byId = new HashMap<>(); + private final List<Tracked> all = new ArrayList<>(); + private int unknown; + + /** Applies one packet; false when it isn't about a tracked entity. */ + boolean accept(Packet<?> packet) { + if (packet instanceof ClientboundAddEntityPacket p) { + if (p.getType() == EntityTypes.PLAYER) return true; + Tracked t = new Tracked(p); + byId.put(p.getId(), t); + all.add(t); + return true; + } + if (packet instanceof ClientboundRemoveEntitiesPacket p) { + p.entityIds().forEach(id -> { + Tracked t = byId.remove(id); + if (t != null) t.removed = true; + }); + return true; + } + Tracked t = switch (packet) { + case ClientboundSetEntityDataPacket p -> byId.get(p.id()); + case ClientboundSetEquipmentPacket p -> byId.get(p.getEntity()); + case ClientboundUpdateAttributesPacket p -> byId.get(p.getEntityId()); + case ClientboundSetPassengersPacket p -> byId.get(p.getVehicle()); + case ClientboundEntityPositionSyncPacket p -> byId.get(p.id()); + case ClientboundSetEntityMotionPacket p -> byId.get(p.id()); + case ClientboundTeleportEntityPacket p -> byId.get(p.id()); + case ClientboundMoveEntityPacket p -> byId.get(VanillaProtocolClient.moveEntityId(p)); + case ClientboundRotateHeadPacket p -> byId.get(VanillaProtocolClient.rotateHeadId(p)); + default -> null; + }; + if (t == null) { + return false; + } + switch (packet) { + case ClientboundSetEntityDataPacket p -> { + for (var v : p.packedItems()) t.data.put(v.id(), net.minecraft.network.syncher.EntityDataSerializers.getSerializedId(v.serializer()) + " " + v.value()); + if (t.pairing == null) { + StringBuilder b = new StringBuilder(); + for (var v : p.packedItems()) b.append(v.id()).append('=').append(v.value()).append(' '); + t.pairing = b.toString().trim(); + } + } + case ClientboundSetEquipmentPacket p -> p.getSlots().forEach(s -> t.equipment.put(s.getFirst().getName(), String.valueOf(s.getSecond()))); + case ClientboundUpdateAttributesPacket p -> p.getValues().forEach(a -> t.attributes.put(a.attribute().getRegisteredName(), + a.base() + " " + a.modifiers())); + case ClientboundSetPassengersPacket p -> t.passengers = p.getPassengers(); + case ClientboundEntityPositionSyncPacket p -> { + t.codec.setBase(p.position().endPosition()); + t.yRot = p.yRot(); + t.xRot = p.xRot(); + t.onGround = p.onGround(); + } + case ClientboundMoveEntityPacket p -> { + if (p.hasPosition()) t.codec.setBase(p.getPositionDelta().decode(t.codec).endPosition()); + if (p.hasRotation()) { + t.yRot = p.getYRot(); + t.xRot = p.getXRot(); + } + t.onGround = p.isOnGround(); + } + case ClientboundSetEntityMotionPacket p -> t.motion = String.valueOf(p.movement()); + case ClientboundTeleportEntityPacket p -> { + t.codec.setBase(p.change().position()); + t.onGround = p.onGround(); + } + case ClientboundRotateHeadPacket p -> t.headRot = p.getYHeadRot(); + default -> { + } + } + return true; + } + + /** One line per entity, sorted, each field named. */ + List<String> lines() { + Map<String, Integer> seen = new HashMap<>(); + for (Tracked t : all) { + int n = seen.merge(t.name, 1, Integer::sum); + if (n > 1) t.name += " #" + n; + } + Map<Integer, String> names = new HashMap<>(); + byId.forEach((id, t) -> names.put(id, t.name)); + List<String> out = new ArrayList<>(); + for (Tracked t : all) { + List<String> riders = new ArrayList<>(); + for (int id : t.passengers) riders.add(names.getOrDefault(id, "player or unknown")); + out.add("entity " + t.name + " | add " + t.add + " | pairing " + t.pairing + " | data " + t.data + " | equipment " + t.equipment + + " | attributes " + t.attributes + " | passengers " + riders + " | now " + t.codec.getBase() + " rot " + t.xRot + "," + + t.yRot + " head " + t.headRot + " ground " + t.onGround + " motion " + t.motion + (t.removed ? " | removed" : "")); + } + out.sort(null); + return out; + } +} diff --git a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaProtocolClient.java b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaProtocolClient.java index f87e9cf0f..ca366705b 100644 --- a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaProtocolClient.java +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaProtocolClient.java @@ -113,6 +113,8 @@ public final class VanillaProtocolClient { private ProtocolInfo<?> inbound; private ProtocolInfo<?> outbound; private String state; + /** With a fifth argument {@code entities}: the entity transcript mode (EntityTranscript). */ + private EntityTranscript entities; public static void main(String[] args) throws Exception { ParityData.init(); @@ -121,6 +123,7 @@ public final class VanillaProtocolClient { String name = args[2]; Path output = Path.of(args[3]); VanillaProtocolClient client = new VanillaProtocolClient(); + if (args.length > 4 && args[4].equals("entities")) client.entities = new EntityTranscript(); try { client.status(host, port); client.join(host, port, name); @@ -405,6 +408,18 @@ public final class VanillaProtocolClient { play(); } + /** The entity mode's step, and how long it records the entities for (ms). */ + private static final int ENTITIES = 1000; + private static final long ENTITY_WAIT = 20_000; + + static int moveEntityId(net.minecraft.network.protocol.game.ClientboundMoveEntityPacket p) { + return (int) field(p, net.minecraft.network.protocol.game.ClientboundMoveEntityPacket.class, "entityId"); + } + + static int rotateHeadId(net.minecraft.network.protocol.game.ClientboundRotateHeadPacket p) { + return (int) field(p, p.getClass(), "entityId"); + } + private static final String[] REPLIES = {"random value 7..7", "random value x", "trigger nope"}; private void play() throws Exception { @@ -461,6 +476,7 @@ public final class VanillaProtocolClient { if (r != null) { Packet<?> packet = r.packet; counts.merge(r.type, 1, Integer::sum); + if (entities != null && step >= ENTITIES) entities.accept(packet); if (r.type.equals("minecraft:chunk_batch_start")) ordered = false; if (respawning && !respawned) { String line = respawnLine(r); @@ -581,8 +597,20 @@ public final class VanillaProtocolClient { commandTree(p); } } + if (entities != null && loaded && lastChunk > 0 && now - lastChunk > 3000 && step == 0) { + // Entity mode: the harness's console summons the scene once it reads this + // line; everything tracked from then on is recorded until the client leaves. + record("play-chunks", String.valueOf(chunks.size())); + send(new ServerboundChatPacket("summon the entities", Instant.now(), 0L, Optional.empty(), + new LastSeenMessages.Update(0, new BitSet(), (byte) 0))); + step = ENTITIES; + stepAt = now; + } else if (step == ENTITIES && now - stepAt > ENTITY_WAIT) { + for (String line : entities.lines()) record("play-entities", line); + return; + } // Once the chunks stop coming: chat, then /list, then leave. - if (loaded && lastChunk > 0 && now - lastChunk > 3000 && step == 0) { + if (entities == null && loaded && lastChunk > 0 && now - lastChunk > 3000 && step == 0) { record("play-chunks", chunks.size() + " " + chunks); BLOCK_ENTITIES.forEach((k, v) -> record("play-block-entities", k + " " + v)); // Which light layers exist depends on the neighbouring @@ -910,8 +938,12 @@ public final class VanillaProtocolClient { } private static Object field(Object owner, String name) { + return field(owner, owner.getClass(), name); + } + + private static Object field(Object owner, Class<?> declaring, String name) { try { - var f = owner.getClass().getDeclaredField(name); + var f = declaring.getDeclaredField(name); f.setAccessible(true); return f.get(owner); } catch (ReflectiveOperationException e) { diff --git a/tools/test_server_entities_parity.py b/tools/test_server_entities_parity.py new file mode 100644 index 000000000..f97e3f15a --- /dev/null +++ b/tools/test_server_entities_parity.py @@ -0,0 +1,174 @@ +#!/usr/bin/env python3 +"""Entities other than mobs and items, tracked to a vanilla client, against vanilla's dedicated server. + +A vanilla dedicated server and Horizon's (`horizon-client --dedicated --nogui`) each serve a copy of one flat +world vanilla generated first, with the same server.properties (offline, view distance 4). A vanilla-codec +client (VanillaProtocolClient in its entity mode) joins, and once its chunks are in it asks for the scene: the +console freezes the ticks, builds a wall and a rail and summons, around the spawn, every kind of minecart (one +set rolling along the rail), boats and a raft (one falling onto the ground), armor stands (posed, small, with +arms, wearing a helmet, one falling), a chicken jockey, item frames (one holding a turned diamond) and paintings. The client records +for 20 seconds, the ticks running again after 3, what ClientPacketListener would make of the packets (EntityTranscript): each entity's spawn +packet (position, rotations, data, motion), the entity data it was paired with and all it was sent since, its +equipment and passengers, and where its position syncs leave it. Both transcripts must match exactly, +entity by entity (named by type and the block it was added in). Attributes are recorded but not compared yet: +Horizon sends no ClientboundUpdateAttributesPacket, for mobs either. +""" +import os +from pathlib import Path +import platform +import re +import shutil +import subprocess +import sys +import time + +try: + from . import lab, test_rust_parity as base + from .test_dedicated_server_parity import Server + from .test_locator_bar_parity import generate_world, server_dir +except ImportError: + import lab + import test_rust_parity as base + from test_dedicated_server_parity import Server + from test_locator_bar_parity import generate_world, server_dir + +NAME = 'server-entities-parity' +PLAYER = 'Tester' + +# Around the spawn at 0 -60 0 on the flat world's grass: a wall to the north for the frames and paintings, +# a rail to the south. +SCENE = [ + 'fill -7 -60 -6 7 -57 -6 minecraft:stone', + 'fill -7 -60 9 7 -60 9 minecraft:rail', + # Minecarts. + 'summon minecraft:minecart -5.5 -60 3.5', + 'summon minecraft:chest_minecart -3.5 -60 3.5', + 'summon minecraft:furnace_minecart -1.5 -60 3.5', + 'summon minecraft:hopper_minecart 1.5 -60 3.5', + 'summon minecraft:tnt_minecart 3.5 -60 3.5', + 'summon minecraft:command_block_minecart 5.5 -60 1.5 {Command:"say hi"}', + 'summon minecraft:minecart -6.5 -60 9.5 {Motion:[0.5d,0d,0d]}', + # Boats. + 'summon minecraft:oak_boat -5.5 -60 6.5 {Rotation:[45f,0f]}', + 'summon minecraft:birch_chest_boat -2.5 -60 6.5', + 'summon minecraft:bamboo_raft 0.5 -60 6.5', + 'summon minecraft:oak_boat 4.5 -56 6.5', + # Armor stands. + 'summon minecraft:armor_stand -2.5 -60 -2.5 {Rotation:[90f,0f]}', + 'summon minecraft:armor_stand 6.5 -57 -2.5', + 'summon minecraft:armor_stand -4.5 -60 -2.5 {ShowArms:1b,Small:1b,NoBasePlate:1b,' + 'Pose:{Head:[10f,20f,0f],RightArm:[-30f,0f,15f]},equipment:{head:{id:"minecraft:diamond_helmet",count:1}}}', + # A chicken jockey (passengers). + 'summon minecraft:chicken -6.5 -60 -2.5 {NoAI:1b,Passengers:[{id:"minecraft:husk",IsBaby:1b,NoAI:1b}]}', + # Frames and paintings on the wall's south face. + 'summon minecraft:item_frame -3.5 -59 -4.97 {block_pos:[I;-4,-59,-5],Facing:3b,' + 'Item:{id:"minecraft:diamond",count:1},ItemRotation:3b}', + 'summon minecraft:glow_item_frame -1.5 -59 -4.97 {block_pos:[I;-2,-59,-5],Facing:3b}', + 'summon minecraft:painting 1.5 -59 -4.97 {block_pos:[I;1,-59,-5],facing:0b,variant:"minecraft:kebab"}', + 'summon minecraft:painting 4 -59 -4.97 {block_pos:[I;4,-59,-5],facing:0b,variant:"minecraft:courbet"}', +] + + +def scene_lines(lines): + """The transcript's entities in the scene's area (the world's own animals and slimes wander elsewhere), + without their attributes: ClientboundUpdateAttributesPacket isn't sent by Horizon yet, for mobs either.""" + out = [] + for line in lines: + m = re.match(r'play-entities entity \S+ (-?\d+),-?\d+,(-?\d+)', line) + if m and -8 <= int(m.group(1)) <= 8 and -7 <= int(m.group(2)) <= 10: + out.append(re.sub(r' \| attributes \{[^|]*\}', '', line)) + return out + + +def run_side(label, server_command, client_command, build, world): + directory = build / label + port = server_dir(directory, world) + out = build / f'{label}-client.txt' + out.unlink(missing_ok=True) + server = Server(server_command, directory, label) + try: + server.wait_for(r'Done \(') + with (build / f'{label}-client.log').open('w') as log: + client = subprocess.Popen([*map(str, client_command), '127.0.0.1', str(port), PLAYER, str(out), 'entities'], + cwd=lab.ROOT, stdout=log, stderr=subprocess.STDOUT, text=True) + try: + server.wait_for(rf'<{PLAYER}> summon the entities', timeout=180) + # Frozen, so that every entity is paired as it was summoned whenever each server tracks it in + # its tick; then they fall and roll. + server.console('tick freeze') + for command in SCENE: + server.console(command) + time.sleep(3) + server.console('tick unfreeze') + client.wait(timeout=120) + finally: + if client.poll() is None: + client.kill() + finally: + server.stop() + if not out.exists(): + raise AssertionError(f'{label}: the client wrote no transcript (see {build}/{label}-client.log)') + lines = out.read_text(encoding='utf-8').splitlines() + (build / f'{label}.txt').write_text('\n'.join(lines) + '\n', encoding='utf-8') + return lines + + +def main(): + lock, jars, libraries = base.verify_artifacts() + build = lab.LOCAL / NAME + build.mkdir(parents=True, exist_ok=True) + report = build / 'report.json' + report.unlink(missing_ok=True) + oracle = lab.ROOT / 'mods/horizon/src/test/java/dev/horizonlab/parity/VanillaProtocolClient.java' + classes = build / 'classes' + shutil.rmtree(classes, ignore_errors=True) + classes.mkdir() + dependencies = os.pathsep.join(map(str, [jars['server'], *libraries])) + subprocess.run(['javac', '--release', str(lock['minecraft']['java_major']), '-proc:none', '-nowarn', '-sourcepath', + lab.ROOT / 'mods/horizon/src/test/java', '-cp', dependencies, '-d', classes, oracle], + cwd=lab.ROOT, check=True, capture_output=True) + # SERVER_ENTITIES_SIDES=vanilla (or horizon) runs one side and reads the other's last transcript. + sides = [s for s in os.environ.get('SERVER_ENTITIES_SIDES', 'vanilla,horizon').split(',') if s] + if 'horizon' in sides: + subprocess.run(['cargo', 'build', '--release', '-p', 'horizon-client', '--bin', 'horizon-client'], cwd=lab.ROOT, + check=True, capture_output=True) + import json + metadata = json.loads(subprocess.check_output(['cargo', 'metadata', '--no-deps', '--format-version', '1'], + cwd=lab.ROOT, text=True)) + binary = Path(metadata['target_directory']) / 'release' / ('horizon-client.exe' if os.name == 'nt' else 'horizon-client') + vanilla_server = ['java', '-Xmx2g', '-Duser.timezone=UTC', '-cp', dependencies, 'net.minecraft.server.Main', 'nogui'] + horizon_server = [binary, '--resources', lab.LOCAL / 'horizon-client/26.3', '--dedicated', '--nogui'] + client = ['java', '-Xmx1g', '-Duser.timezone=UTC', '-cp', str(classes) + os.pathsep + dependencies, + 'dev.horizonlab.parity.VanillaProtocolClient'] + + world = generate_world(vanilla_server, build) + results = {} + for label, command in [('vanilla', vanilla_server), ('horizon', horizon_server)]: + if label in sides: + results[label] = run_side(label, command, client, build, world) + else: + results[label] = (build / f'{label}.txt').read_text(encoding='utf-8').splitlines() + vanilla, horizon = scene_lines(results['vanilla']), scene_lines(results['horizon']) + errors = [l for l in results['vanilla'] + results['horizon'] if l.startswith('error')] + if errors or vanilla != horizon: + import difflib + diff = '\n'.join(difflib.unified_diff(vanilla, horizon, 'vanilla', 'horizon', n=0, lineterm='')) + raise AssertionError(f'{len(errors)} errors, transcripts differ (see {build}/vanilla.txt and horizon.txt):\n' + + '\n'.join(errors[:10]) + '\n' + diff[:8000]) + if len(vanilla) < len(SCENE) - 2: + raise AssertionError(f'only {len(vanilla)} entities tracked: the scene did not run (see {build})') + lab.write_json(report, dict( + schema=1, minecraft=lock['minecraft']['version'], platform=platform.platform(), + java=subprocess.check_output(['java', '--version'], text=True).splitlines()[0], + entities=len(vanilla), output_sha256=lab.digest(build / 'horizon.txt', 'sha256'), + scope='Minecarts (one rolling), boats (one falling), armor stands, a chicken jockey, item frames and paintings tracked to a ' + 'vanilla-codec client by a dedicated server: spawn packets, entity data, equipment, passengers and the ' + 'positions the syncs leave them at.')) + print(f'server entities: {len(vanilla)} entities identical') + + +if __name__ == '__main__': + try: + main() + except AssertionError as error: + sys.exit(f'{NAME}: {error}') From 583502f0f4022c7ff18c5a594457b4c7d749d5e4 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 22:25:30 +0200 Subject: [PATCH 044/163] Clients of a server show its boats, minecarts, armor stands, frames and paintings ClientPacketListener.handleAddEntity for the objects a server tracks: a Horizon client of a server (a LAN host, a dedicated server, single player's server thread) now places the boats, minecarts, armor stands, item frames and paintings it is sent, where the server says. - Spawn: carts by kind, boats and rafts by wood (with a chest), armor stands, frames and paintings at their block with the direction from the spawn data. - Entity data: frame items and rotation, painting variants (a registry holder), armor stand flags and health, boat paddles, vehicle hurt. - Equipment: what an armor stand wears and holds. - Moves interpolate like mobs'; rotation and ground state follow. - They are cleared with the connection, a respawn or a dimension change. `status` lists them (`objects`), and lan_e2e has an `objects` check: the host summons them, the guest sees each as the host has it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game.rs | 1 + crates/horizon-client/src/game/control.rs | 2 + crates/horizon-client/src/game/remote.rs | 29 +- .../horizon-client/src/game/remote_objects.rs | 270 ++++++++++++++++++ tools/lan_e2e.py | 60 +++- 5 files changed, 357 insertions(+), 5 deletions(-) create mode 100644 crates/horizon-client/src/game/remote_objects.rs diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 436802be2..4def60790 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -108,6 +108,7 @@ mod powder_snow; mod raids; mod recipe_book; mod remote; +mod remote_objects; mod render_control; mod render_tick; mod respawn_anchor; diff --git a/crates/horizon-client/src/game/control.rs b/crates/horizon-client/src/game/control.rs index fa72c7a40..58733bf45 100644 --- a/crates/horizon-client/src/game/control.rs +++ b/crates/horizon-client/src/game/control.rs @@ -758,6 +758,8 @@ impl Game<'_> { .map(|e| self.shown_name_tags(glam::DVec3::from_array(e))), }); status["physical_keys"] = json!(physical_keys); + // Boats, minecarts, armor stands, item frames and paintings. + status["objects"] = json!(self.objects_status()); status } } diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 991bc42b2..0edf4ade7 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -80,7 +80,7 @@ pub(super) struct Remote { pub brand: String, builtin: Arc<Builtin>, lang: Arc<Language>, - registries: Arc<Dynamic>, + pub(super) registries: Arc<Dynamic>, joined: bool, status: String, entity_id: i32, @@ -245,6 +245,7 @@ impl Game<'_> { self.player = None; self.spawn = None; self.mobs.clear(); + self.clear_remote_objects(); self.creatures.projectiles.clear(); self.dropped.clear(); self.particles.clear(); @@ -363,6 +364,7 @@ impl Game<'_> { self.world = World::new(self.res.facts.air, 0); self.player = None; self.mobs.clear(); + self.clear_remote_objects(); self.dropped.clear(); self.particles.clear(); self.pickups.clear(); @@ -445,7 +447,7 @@ impl Game<'_> { .and_then(|i| i.id(name)) .unwrap_or(0) } - fn to_stack(&self, s: &Option<Stack>) -> Option<ItemStack> { + pub(super) fn to_stack(&self, s: &Option<Stack>) -> Option<ItemStack> { let s = s.as_ref()?; let mut out = ItemStack { item: self.item_name(s.item), @@ -608,6 +610,7 @@ impl Game<'_> { self.world.day_time = day; self.world.weather = weather; self.mobs.clear(); + self.clear_remote_objects(); self.dropped.clear(); self.particles.clear(); self.pickups.clear(); @@ -993,11 +996,13 @@ impl Game<'_> { if let Some(m) = mob { m.on_ground = on_ground; } + self.turn_remote_object(id, rotation.map(|(yaw, _)| yaw), on_ground); } fn remove_entity(&mut self, id: i32) { 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); + self.remove_remote_object(id as u32); if let Some(r) = self.remote.as_mut() { r.entities.remove(&id); r.lerps.remove(&id); @@ -1261,6 +1266,7 @@ impl Game<'_> { } } self.spawn_entity(p.id, &kind, p.position, rotation); + self.spawn_remote_object(p.id, &kind, p.position, rotation[0], p.data); } C::RemoveEntities(p) => { for id in p.ids { @@ -1369,10 +1375,12 @@ impl Game<'_> { o.value = (*v).max(0) as u32; } } + self.remote_object_data(p.id, &p.values); } // ClientPacketListener.handleSetEquipment: what a mob or another // player holds and wears (EquipmentSlot ordinals). C::SetEquipment(p) => { + self.remote_object_equipment(p.id, &p.slots); let items: Vec<(u8, Option<Arc<str>>)> = p .slots .iter() @@ -2535,8 +2543,23 @@ impl Game<'_> { l.steps -= 1; } } - lerps.retain(|_, l| l.steps > 0); head_lerps.retain(|_, (_, steps)| *steps > 0); + if running { + // Boats, minecarts and armor stands interpolate like mobs. + self.tick_remote_objects(|id, at| match lerps.get_mut(&(id as i32)) { + Some(l) if l.steps > 0 => { + let n = f64::from(l.steps); + l.steps -= 1; + Vec3::new( + at.x + (l.target[0] - at.x) / n, + at.y + (l.target[1] - at.y) / n, + at.z + (l.target[2] - at.z) / n, + ) + } + _ => at, + }); + } + lerps.retain(|_, l| l.steps > 0); if let Some(r) = self.remote.as_mut() { for (id, l) in lerps { r.lerps.entry(id).or_insert(l); diff --git a/crates/horizon-client/src/game/remote_objects.rs b/crates/horizon-client/src/game/remote_objects.rs new file mode 100644 index 000000000..12a15bc34 --- /dev/null +++ b/crates/horizon-client/src/game/remote_objects.rs @@ -0,0 +1,270 @@ +//! Boats, minecarts, armor stands, item frames and paintings on a server's +//! client (`ClientPacketListener.handleAddEntity`, `handleSetEntityData`, +//! `handleSetEquipment`): the server simulates them, the client places them +//! where it says and interpolates their moves like a mob's. +use super::Game; +use horizon_client::entities::{ArmorStand, ItemFrame, Painting}; +use horizon_core::geometry::Vec3; +use horizon_protocol::entity_data::Value; +use std::sync::Arc; + +impl Game<'_> { + /// `handleAddEntity` for an object type; false when `kind` isn't one. + /// Hanging entities come at their block, with their direction as the + /// spawn data (`Direction.from3DDataValue`). + pub(super) fn spawn_remote_object( + &mut self, + id: i32, + kind: &str, + position: [f64; 3], + yaw: f32, + data: i32, + ) -> bool { + let id = id as u32; + let at = Vec3::new(position[0], position[1], position[2]); + let block = position.map(|v| v.floor() as i32); + self.remove_remote_object(id); + if let Some(cart) = super::minecarts::CartKind::from_id(kind) { + let mut c = super::minecarts::Minecart::new(id, cart, at); + c.yaw = yaw; + c.previous_yaw = yaw; + self.carts.push(c); + } else if let Some((wood, chest)) = super::boats::any_boat_wood(kind) + && self.boat_models.has(wood, chest) + { + let mut b = super::boats::Boat::new(id, Arc::from(wood), at, yaw); + if chest { + b = b.with_chest(); + } + self.boats.push(b); + } else if kind == "minecraft:armor_stand" { + self.armor_stands.push(ArmorStand::new(id, at, yaw)); + } else if kind == "minecraft:item_frame" || kind == "minecraft:glow_item_frame" { + self.item_frames.push(ItemFrame { + id, + pos: block, + facing: data.clamp(0, 5) as u8, + glow: kind == "minecraft:glow_item_frame", + item: None, + rotation: 0, + drop_chance: 1.0, + fixed: false, + invisible: false, + check_interval: 0, + }); + } else if kind == "minecraft:painting" { + // The variant comes with the entity data; until then the + // registry's first one (VariantUtils.getAny). + let (variant, width, height) = self + .remote_painting_variant(0) + .map_or((Arc::from("minecraft:kebab"), 1, 1), |v| { + (v.id, v.width, v.height) + }); + // Direction 3D data value (north 2, south 3, west 4, east 5) to 2D. + let facing = match data { + 2 => 2, + 4 => 1, + 5 => 3, + _ => 0, + }; + self.paintings.push(Painting { + id, + pos: block, + facing, + variant, + width, + height, + check_interval: 0, + }); + } else { + return false; + } + true + } + + /// A `painting_variant` by its network id, from the server's registry. + fn remote_painting_variant(&self, id: i32) -> Option<super::paintings::Variant> { + let r = self.remote.as_ref()?; + let name = r.registries.name("minecraft:painting_variant", id)?; + self.painting_variants.get(name).cloned() + } + + /// `handleSetEntityData` for an object: what changes how it looks. + pub(super) fn remote_object_data(&mut self, id: i32, values: &[(u8, i32, Value)]) { + let id = id as u32; + for (index, _, value) in values { + if self.item_frames.iter().any(|f| f.id == id) { + // HangingEntity.DATA_DIRECTION, ItemFrame.DATA_ITEM and DATA_ROTATION. + let item = match (index, value) { + (9, Value::Item(stack)) => Some(self.to_stack(stack)), + _ => None, + }; + let Some(f) = self.item_frames.iter_mut().find(|f| f.id == id) else { + continue; + }; + match (index, value) { + (8, Value::Id(d)) => f.facing = (*d).clamp(0, 5) as u8, + (10, Value::Int(r)) => f.rotation = r.rem_euclid(8) as u8, + _ => {} + } + if let Some(item) = item { + f.item = item; + } + } else if self.paintings.iter().any(|p| p.id == id) { + // Painting.DATA_PAINTING_VARIANT_ID: a registry holder (id + 1). + if let (9, Value::Id(holder)) = (index, value) + && let Some(v) = self.remote_painting_variant(holder - 1) + && let Some(p) = self.paintings.iter_mut().find(|p| p.id == id) + { + p.variant = v.id; + p.width = v.width; + p.height = v.height; + } + } else if let Some(a) = self.armor_stands.iter_mut().find(|a| a.id == id) { + match (index, value) { + (0, Value::Byte(flags)) => a.invisible = flags & 0x20 != 0, + (9, Value::Float(health)) => a.health = *health, + // ArmorStand.DATA_CLIENT_FLAGS. + (15, Value::Byte(flags)) => { + a.small = flags & 1 != 0; + a.show_arms = flags & 4 != 0; + a.no_base_plate = flags & 8 != 0; + a.marker = flags & 16 != 0; + } + _ => {} + } + } else if let Some(b) = self.boats.iter_mut().find(|b| b.id == id) { + // VehicleEntity's hurt, direction and damage; the paddles. + match (index, value) { + (8, Value::Int(v)) => b.hurt_time = *v, + (9, Value::Int(v)) => b.hurt_dir = *v, + (10, Value::Float(v)) => b.damage = *v, + (11, Value::Bool(v)) => b.paddling[0] = *v, + (12, Value::Bool(v)) => b.paddling[1] = *v, + _ => {} + } + } else if let Some(c) = self.carts.iter_mut().find(|c| c.id == id) { + match (index, value) { + (8, Value::Int(v)) => c.hurt_time = *v, + (9, Value::Int(v)) => c.hurt_dir = *v, + (10, Value::Float(v)) => c.damage = *v, + _ => {} + } + } + } + } + + /// `handleSetEquipment` for an armor stand (EquipmentSlot ordinals 0 to + /// 5: main hand, off hand, feet, legs, chest, head, its storage order). + pub(super) fn remote_object_equipment( + &mut self, + id: i32, + slots: &[(u8, Option<horizon_protocol::item::Stack>)], + ) { + if !self.armor_stands.iter().any(|a| a.id == id as u32) { + return; + } + let items: Vec<_> = slots + .iter() + .map(|(slot, stack)| (usize::from(*slot), self.to_stack(stack))) + .collect(); + if let Some(a) = self.armor_stands.iter_mut().find(|a| a.id == id as u32) { + for (slot, item) in items { + if let Some(s) = a.equipment.get_mut(slot) { + *s = item; + } + } + } + } + + /// A move's rotation and ground state for an object. + pub(super) fn turn_remote_object(&mut self, id: i32, yaw: Option<f32>, on_ground: bool) { + let id = id as u32; + if let Some(b) = self.boats.iter_mut().find(|b| b.id == id) { + if let Some(yaw) = yaw { + b.yaw = yaw; + } + b.on_ground = on_ground; + } else if let Some(c) = self.carts.iter_mut().find(|c| c.id == id) { + if let Some(yaw) = yaw { + c.yaw = yaw; + } + } else if let Some(a) = self.armor_stands.iter_mut().find(|a| a.id == id) { + if let Some(yaw) = yaw { + a.yaw = yaw; + } + a.on_ground = on_ground; + } + } + + /// One tick of interpolation: `step` moves a position a step toward + /// the entity's last sent one, if it has a move in progress. + pub(super) fn tick_remote_objects(&mut self, mut step: impl FnMut(u32, Vec3) -> Vec3) { + for c in &mut self.carts { + c.previous = c.position; + c.previous_yaw = c.yaw; + c.position = step(c.id, c.position); + } + for b in &mut self.boats { + b.previous = b.position; + b.previous_yaw = b.yaw; + b.position = step(b.id, b.position); + } + for a in &mut self.armor_stands { + a.position = step(a.id, a.position); + } + } + + /// The boats, minecarts, armor stands, item frames and paintings in the + /// level (a server's client: the ones it was sent), for `status`. + pub(super) fn objects_status(&self) -> Vec<serde_json::Value> { + use serde_json::json; + let at = |p: Vec3| [p.x, p.y, p.z]; + let mut out = Vec::new(); + for b in &self.boats { + out.push(json!({"id": b.id, "kind": b.entity_type(), "position": at(b.position), "yaw": b.yaw})); + } + for c in &self.carts { + out.push( + json!({"id": c.id, "kind": c.kind.id(), "position": at(c.position), "yaw": c.yaw}), + ); + } + for a in &self.armor_stands { + let items: Vec<_> = a + .equipment + .iter() + .map(|i| i.as_ref().map(|i| &*i.item)) + .collect(); + out.push(json!({"id": a.id, "kind": "minecraft:armor_stand", "position": at(a.position), "yaw": a.yaw, + "small": a.small, "arms": a.show_arms, "no_base_plate": a.no_base_plate, "equipment": items})); + } + for f in &self.item_frames { + out.push( + json!({"id": f.id, "kind": f.kind(), "position": f.pos, "facing": f.facing, + "item": f.item.as_ref().map(|i| &*i.item), "rotation": f.rotation}), + ); + } + for p in &self.paintings { + out.push(json!({"id": p.id, "kind": "minecraft:painting", "position": p.pos, "facing": p.facing, + "variant": &*p.variant})); + } + out + } + + /// Every object a server sent (a new connection, level or dimension). + pub(super) fn clear_remote_objects(&mut self) { + self.carts.clear(); + self.boats.clear(); + self.armor_stands.clear(); + self.item_frames.clear(); + self.paintings.clear(); + } + + pub(super) fn remove_remote_object(&mut self, id: u32) { + self.carts.retain(|c| c.id != id); + self.boats.retain(|b| b.id != id); + self.armor_stands.retain(|a| a.id != id); + self.item_frames.retain(|f| f.id != id); + self.paintings.retain(|p| p.id != id); + } +} diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index b1e7ec098..01375c79a 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -42,6 +42,8 @@ address. The script then checks, from both sides, what a guest's game used to ge counts up) and the server eats one loaf and feeds the guest. - xp: experience orbs 4 blocks away fly to the guest, show on the guest's screen and give the guest their points (not the host). +- objects: boats, minecarts, armor stands, item frames and paintings the host summons reach the + guest as the host has them (kind, place, rotation, what they hold or wear, the variant). Each check is reported on its own (a failing one doesn't stop the others) and the screenshots of both sides go to --out (host-*.png, guest-*.png). @@ -74,7 +76,8 @@ 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', 'containers', 'feedback', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'effects', 'portals'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'containers', 'feedback', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'effects', 'portals', + 'objects'] class Game: @@ -1044,6 +1047,59 @@ def check_xp(host, guest, out): return {'seen': seen, 'guest': xp, 'host': host_xp} +def objects_near(game, centre): + """`status`'s objects within 8 blocks of centre, without their ids (each side numbers its own).""" + out = [] + for o in game('status')['objects']: + if all(abs(o['position'][i] - centre[i]) <= 8 for i in (0, 2)): + o = dict(o) + o.pop('id') + o['position'] = [round(v, 2) for v in o['position']] + if 'yaw' in o: # as the packets carry it, in 256ths of a turn + o['yaw'] = round(o['yaw'] * 256 / 360) % 256 + out.append(o) + return sorted(out, key=json.dumps) + + +def check_objects(host, guest, out): + x, y, z = (int(v // 1) for v in pos_of(host)) + commands = [ + f'fill {x - 6} {y} {z - 6} {x + 6} {y + 3} {z - 6} minecraft:stone', + f'summon minecraft:minecart {x - 4.5} {y} {z + 3.5}', + f'summon minecraft:chest_minecart {x - 2.5} {y} {z + 3.5}', + f'summon minecraft:furnace_minecart {x + 1.5} {y} {z + 3.5}', + f'summon minecraft:tnt_minecart {x + 4.5} {y} {z + 3.5}', + f'summon minecraft:oak_boat {x - 4.5} {y} {z + 6.5} {{Rotation:[45f,0f]}}', + f'summon minecraft:birch_chest_boat {x - 1.5} {y} {z + 6.5}', + f'summon minecraft:bamboo_raft {x + 2.5} {y} {z + 6.5}', + f'summon minecraft:armor_stand {x - 2.5} {y} {z - 2.5} {{Rotation:[90f,0f]}}', + f'summon minecraft:armor_stand {x - 4.5} {y} {z - 2.5} {{ShowArms:1b,Small:1b,NoBasePlate:1b,' + 'equipment:{head:{id:"minecraft:diamond_helmet",count:1}}}', + f'summon minecraft:item_frame {x - 3.5} {y + 1} {z - 4.97} {{block_pos:[I;{x - 4},{y + 1},{z - 5}],Facing:3b,' + 'Item:{id:"minecraft:diamond",count:1},ItemRotation:3b}', + f'summon minecraft:glow_item_frame {x - 1.5} {y + 1} {z - 4.97} {{block_pos:[I;{x - 2},{y + 1},{z - 5}],Facing:3b}}', + f'summon minecraft:painting {x + 1.5} {y + 1} {z - 4.97} {{block_pos:[I;{x + 1},{y + 1},{z - 5}],facing:0b,' + 'variant:"minecraft:kebab"}', + f'summon minecraft:painting {x + 4} {y + 1} {z - 4.97} {{block_pos:[I;{x + 4},{y + 1},{z - 5}],facing:0b,' + 'variant:"minecraft:courbet"}', + ] + try: + for command in commands: + host('command', command=command) + host.wait(60) + guest.raw('look-at', x, y, z - 5) + guest.wait(10) + guest.shot(out, 'objects') + host.shot(out, 'objects') + mine, theirs = objects_near(host, (x, y, z)), objects_near(guest, (x, y, z)) + finally: + host('command', command=f'kill @e[type=!minecraft:player,x={x - 8},y={y - 2},z={z - 8},dx=16,dy=8,dz=16]') + host('command', command=f'fill {x - 6} {y} {z - 6} {x + 6} {y + 3} {z - 6} minecraft:air') + assert len(mine) == len(commands) - 1, f'the host has {len(mine)} objects: {mine}' + assert theirs == mine, f'the guest sees {theirs}\nthe host has {mine}' + return f'{len(theirs)} objects identical' + + CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'nametags': check_nametags, 'chest': check_chest, 'crafting': check_crafting, 'sign': check_sign, 'damage': check_damage, 'mobs': check_mobs, 'hazards': check_hazards, 'pvp': check_pvp, @@ -1051,7 +1107,7 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'recipes': check_recipes, 'trials': check_trials, 'walls': check_walls, 'effects': check_effects, 'portals': check_portals, 'clicks': check_clicks, 'sleep': check_sleep, 'push': check_push, 'eat': check_eat, - 'xp': check_xp} + 'xp': check_xp, 'objects': check_objects} def run(ctl, out, resources, checks): From 866e772227f1440bfaa72dff5ff9834d0bb1db2e Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 22:39:00 +0200 Subject: [PATCH 045/163] Server: track primed TNT, falling blocks, projectiles, tridents, fireworks and crystals These entities had no id in Horizon, so a server could not send them to its clients. Each now has one, given from the entity counter before it is first tracked, and goes to guests as vanilla's ServerEntity sends it: - primed TNT with its fuse (sent each tick it changes) and falling blocks with their block state and start position; both sync their exact position while they touch a block (requiresPrecisePosition); - arrows and tridents send their position and rotation every update (AbstractArrow), with their flags, pierce level, in-ground state, loyalty and foil; their owner is the spawn data; - fireballs, wither skulls and wind charges bundle their velocity with ClientboundProjectilePowerPacket (new in horizon-protocol); - snowballs, eggs, pearls, llama spit, shulker bullets and splash potions; - firework rockets with their item, the player they boost and whether they were shot at an angle; end crystals with their beam and base. The entity harness's scene gains primed TNT, a falling block, an arrow, a snowball and a trident that land, a fireball, a firework and a crystal. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game.rs | 3 + crates/horizon-client/src/game/dragon.rs | 6 + crates/horizon-client/src/game/fireworks.rs | 13 +- crates/horizon-client/src/game/lan.rs | 16 +- .../horizon-client/src/game/lan_entities.rs | 192 +++++++++++++++++- crates/horizon-client/src/game/persist.rs | 1 + crates/horizon-client/src/game/tnt.rs | 4 + crates/horizon-client/src/game/trident.rs | 19 +- crates/horizon-client/src/lan/entity.rs | 53 ++++- crates/horizon-client/src/lan/hub.rs | 1 + crates/horizon-client/src/projectiles.rs | 3 + crates/horizon-client/tests/lan_bot.rs | 1 + crates/horizon-protocol/src/packets/play.rs | 6 + .../horizonlab/parity/EntityTranscript.java | 6 +- tools/test_server_entities_parity.py | 16 +- 15 files changed, 313 insertions(+), 27 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 4def60790..64120b353 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -649,6 +649,8 @@ impl LevelAccess for GameLevel<'_> { /// FallingBlockEntity carrying a block state. #[derive(Clone, Debug)] struct FallingBlock { + /// The entity id a server tracks it by (0 until it is tracked). + id: u32, state: BlockStateId, /// `DATA_START_POS`: spawn position used to select weighted block models. start_pos: BlockPos, @@ -2054,6 +2056,7 @@ impl Game<'_> { f64::from(pos.z) + 0.5, ); self.falling.push(FallingBlock { + id: 0, state, start_pos: pos, position: p, diff --git a/crates/horizon-client/src/game/dragon.rs b/crates/horizon-client/src/game/dragon.rs index ff91df583..e76eb16fb 100644 --- a/crates/horizon-client/src/game/dragon.rs +++ b/crates/horizon-client/src/game/dragon.rs @@ -74,6 +74,8 @@ impl Respawn { } #[derive(Clone, Debug)] pub(super) struct Crystal { + /// The entity id a server tracks it by (0 until it is tracked). + pub id: u32, pub position: Vec3, pub show_bottom: bool, /// EndCrystal.time (the bob and spin), starting random. @@ -553,6 +555,7 @@ impl Game<'_> { } let time = self.world.random.next_int_bound(100_000).unwrap_or(0); self.crystals.push(Crystal { + id: 0, position: at, show_bottom: true, time, @@ -2301,6 +2304,7 @@ impl Crystal { pub(super) fn from_nbt(tag: &Tag, time: i32) -> Option<Self> { let (position, _, _) = horizon_client::entity_nbt::boat_from_nbt(tag)?; Some(Self { + id: 0, position, show_bottom: !matches!(tag.get("ShowBottom"), Some(Tag::Byte(0))), time, @@ -2403,6 +2407,7 @@ impl Game<'_> { } let time = self.world.random.next_int_bound(100_000).unwrap_or(0); self.crystals.push(Crystal { + id: 0, position: Vec3::new(x + 0.5, y, z + 0.5), show_bottom: false, time, @@ -2665,6 +2670,7 @@ impl Game<'_> { .retain(|c| c.position.distance_squared(at) > 0.01); let time = self.world.random.next_int_bound(100_000).unwrap_or(0); self.crystals.push(Crystal { + id: 0, position: at, show_bottom: true, time, diff --git a/crates/horizon-client/src/game/fireworks.rs b/crates/horizon-client/src/game/fireworks.rs index 0e074025f..a7e071c52 100644 --- a/crates/horizon-client/src/game/fireworks.rs +++ b/crates/horizon-client/src/game/fireworks.rs @@ -18,19 +18,21 @@ use horizon_core::{ }; pub(super) struct Rocket { - position: Vec3, + /// The entity id a server tracks it by (0 until it is tracked). + pub id: u32, + pub(super) position: Vec3, previous: Vec3, - velocity: Vec3, + pub(super) velocity: Vec3, life: i32, lifetime: i32, explosions: Vec<FireworkExplosion>, /// Boosting the player (attachedToEntity). - attached: bool, + pub(super) attached: bool, /// `DATA_SHOT_AT_ANGLE` (dispensers): constant velocity, exploding on /// the first block it hits. - angled: bool, + pub(super) angled: bool, /// `DATA_ID_FIREWORKS_ITEM`: the stack it was launched from. - item: ItemStack, + pub(super) item: ItemStack, } impl Rocket { /// Position and motion (the dispenser parity fixture). @@ -56,6 +58,7 @@ impl Game<'_> { + r.next_int_bound(6).unwrap_or(0) + r.next_int_bound(7).unwrap_or(0); Rocket { + id: 0, position: at, previous: at, velocity, diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index 209c34286..aba46fe03 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -718,7 +718,7 @@ impl Game<'_> { } /// The entities guests track: mobs, items and the rest (game/lan_entities.rs). - fn lan_entities(&self, hub: &mut Hub) -> Vec<EntityState> { + fn lan_entities(&self, host_entity: Option<i32>, hub: &mut Hub) -> Vec<EntityState> { let mut out = Vec::with_capacity(self.mobs.len() + self.dropped.len() + self.orbs.len()); for m in self.mobs.iter().filter(|m| !m.removed) { let kind = m.kind.id.as_str(); @@ -738,6 +738,7 @@ impl Game<'_> { data: 0, meta, equipment, + precise: false, }); } for d in &self.dropped { @@ -755,6 +756,7 @@ impl Game<'_> { data: 0, meta: vec![(8, serializer::ITEM_STACK, Value::Item(stack))], equipment: Vec::new(), + precise: false, }); } for o in &self.orbs { @@ -772,9 +774,10 @@ impl Game<'_> { // ExperienceOrb.DATA_VALUE. meta: vec![(8, serializer::INT, Value::Int(o.value as i32))], equipment: Vec::new(), + precise: false, }); } - self.lan_object_states(hub, &mut out); + self.lan_object_states(host_entity, hub, &mut out); out } @@ -790,8 +793,10 @@ impl Game<'_> { if state.is_some() || host.hub.config.dedicated { let has_guests = !host.hub.guests.is_empty(); let entities = if has_guests { - self.lan_riding(state.as_ref().map(|s| s.entity_id), &mut host.hub.riding); - self.lan_entities(&mut host.hub) + let host_entity = state.as_ref().map(|s| s.entity_id); + self.lan_assign_ids(); + self.lan_riding(host_entity, &mut host.hub.riding); + self.lan_entities(host_entity, &mut host.hub) } else { Vec::new() }; @@ -974,7 +979,8 @@ impl Game<'_> { log::error!("could not open {}: {e}", level.id()); return; } - theirs = self.lan_entities(&mut host.hub); + // A dedicated server has no host player. + theirs = self.lan_entities(None, &mut host.hub); &theirs[..] } else { entities diff --git a/crates/horizon-client/src/game/lan_entities.rs b/crates/horizon-client/src/game/lan_entities.rs index 9064447aa..3ea172482 100644 --- a/crates/horizon-client/src/game/lan_entities.rs +++ b/crates/horizon-client/src/game/lan_entities.rs @@ -37,6 +37,7 @@ fn state(id: u32, kind: &str, position: [f64; 3], yaw: f32, on_ground: bool) -> data: 0, meta: Vec::new(), equipment: Vec::new(), + precise: false, } } @@ -101,7 +102,12 @@ impl Game<'_> { /// Boats, minecarts, armor stands, item frames, paintings and the /// entities kept unsimulated, as guests track them. - pub(super) fn lan_object_states(&self, hub: &mut Hub, out: &mut Vec<EntityState>) { + pub(super) fn lan_object_states( + &self, + host_entity: Option<i32>, + hub: &mut Hub, + out: &mut Vec<EntityState>, + ) { for b in &self.boats { let p = b.position; let mut e = state(b.id, &b.entity_type(), [p.x, p.y, p.z], b.yaw, b.on_ground); @@ -225,6 +231,7 @@ impl Game<'_> { } out.push(e); } + self.lan_projectile_states(host_entity, hub, out); for o in &self.others { let p = o.position; let mut e = state(o.id, &o.kind, [p.x, p.y, p.z], o.yaw, false); @@ -235,6 +242,189 @@ impl Game<'_> { } } +impl Game<'_> { + /// Gives the entities Horizon keeps without an id one (`Entity.id`, from + /// the same counter as the rest) before they are first tracked. + pub(super) fn lan_assign_ids(&mut self) { + let next = &mut self.next_entity; + let mut give = |id: &mut u32| { + if *id == 0 { + *next += 1; + *id = *next; + } + }; + self.tnts.iter_mut().for_each(|t| give(&mut t.id)); + self.falling.iter_mut().for_each(|f| give(&mut f.id)); + self.creatures + .projectiles + .iter_mut() + .for_each(|p| give(&mut p.id)); + 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)); + } + + /// Primed TNT, falling blocks, projectiles, tridents, firework rockets and + /// end crystals, as guests track them. + fn lan_projectile_states( + &self, + host_entity: Option<i32>, + hub: &mut Hub, + out: &mut Vec<EntityState>, + ) { + let owner = |who: Option<horizon_client::mobs::Who>| match who { + Some(horizon_client::mobs::Who::Mob(id)) => id as i32, + Some(horizon_client::mobs::Who::Player) => host_entity.unwrap_or(0), + None => 0, + }; + let at = |p: horizon_core::geometry::Vec3| [p.x, p.y, p.z]; + 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); + // PrimedTnt.DATA_FUSE_ID, 80 by default; requiresPrecisePosition + // while it touches a block. + if t.fuse != 80 { + e.meta.push((8, serializer::INT, Value::Int(t.fuse))); + } + e.precise = t.on_ground; + out.push(e); + } + for f in self.falling.iter().filter(|f| f.id != 0) { + let mut e = state(f.id, "minecraft:falling_block", at(f.position), 0.0, false); + e.velocity = at(f.velocity); + // getAddEntityPacket: the block state; DATA_START_POS. + e.data = f.state.0 as i32; + if f.no_gravity { + e.meta.push((5, serializer::BOOLEAN, Value::Bool(true))); + } + let start = [f.start_pos.x, f.start_pos.y, f.start_pos.z]; + if start != [0; 3] { + e.meta.push((8, serializer::BLOCK_POS, Value::Pos(start))); + } + out.push(e); + } + for p in self.creatures.projectiles.iter().filter(|p| p.id != 0) { + use horizon_client::projectiles::ProjectileKind as K; + let kind = match &p.kind { + K::Arrow { .. } => "minecraft:arrow", + K::Snowball => "minecraft:snowball", + K::Egg => "minecraft:egg", + K::EnderPearl => "minecraft:ender_pearl", + K::SmallFireball => "minecraft:small_fireball", + K::LargeFireball { .. } => "minecraft:fireball", + K::LlamaSpit => "minecraft:llama_spit", + K::WindCharge => "minecraft:wind_charge", + K::BreezeWindCharge => "minecraft:breeze_wind_charge", + K::ShulkerBullet { .. } => "minecraft:shulker_bullet", + K::WitherSkull { .. } => "minecraft:wither_skull", + K::Potion { .. } => "minecraft:splash_potion", + }; + let mut e = state(p.id, kind, at(p.position), p.yaw, false); + e.pitch = p.pitch; + e.velocity = at(p.velocity); + e.data = owner(p.owner); + match &p.kind { + K::Arrow { critical, .. } => { + let a = p.arrow.as_deref(); + e.meta.extend(arrow_meta( + *critical, + a.is_some_and(|a| a.no_physics), + a.map_or(0, |a| a.pierce), + a.is_some_and(|a| a.in_ground) || p.stuck, + )); + } + // WitherSkull.DATA_DANGEROUS. + K::WitherSkull { dangerous: true } => { + e.meta.push((8, serializer::BOOLEAN, Value::Bool(true))); + } + _ => {} + } + out.push(e); + } + for t in self.tridents.iter().filter(|t| t.id != 0) { + let mut e = state(t.id, "minecraft:trident", at(t.position), t.yaw, false); + e.pitch = t.pitch; + e.velocity = at(t.velocity); + e.meta = arrow_meta(false, t.no_physics, 0, t.in_ground); + // ThrownTrident.ID_LOYALTY and ID_FOIL. + if t.loyalty != 0 { + e.meta + .push((11, serializer::BYTE, Value::Byte(t.loyalty as i8))); + } + if t.stack.has_any_enchantments() { + e.meta.push((12, serializer::BOOLEAN, Value::Bool(true))); + } + out.push(e); + } + for r in self.rockets.iter().filter(|r| r.id != 0) { + let mut e = state( + r.id, + "minecraft:firework_rocket", + at(r.position), + 0.0, + false, + ); + e.velocity = at(r.velocity); + // DATA_ID_FIREWORKS_ITEM once set from a stack, DATA_ATTACHED_TO_TARGET, + // DATA_SHOT_AT_ANGLE. + let plain = &*r.item.item == "minecraft:firework_rocket" + && r.item.count == 1 + && r.item.extra.is_none(); + if !plain { + e.meta.push(( + 8, + serializer::ITEM_STACK, + Value::Item(hub.stack(&Some(r.item.clone()))), + )); + } + if r.attached + && let Some(host) = host_entity + { + e.meta + .push((9, serializer::OPTIONAL_UNSIGNED_INT, Value::Id(host + 1))); + } + if r.angled { + e.meta.push((10, serializer::BOOLEAN, Value::Bool(true))); + } + out.push(e); + } + for c in self.crystals.iter().filter(|c| c.id != 0) { + let mut e = state(c.id, "minecraft:end_crystal", at(c.position), 0.0, false); + // EndCrystal.DATA_BEAM_TARGET and DATA_SHOW_BOTTOM (true by default). + if c.beam.is_some() { + e.meta + .push((8, serializer::OPTIONAL_BLOCK_POS, Value::OptPos(c.beam))); + } + if !c.show_bottom { + e.meta.push((9, serializer::BOOLEAN, Value::Bool(false))); + } + out.push(e); + } + } +} + +/// `AbstractArrow`'s ID_FLAGS (critical 1, no physics 2), PIERCE_LEVEL and +/// IN_GROUND, when they differ from the defaults. +fn arrow_meta( + critical: bool, + no_physics: bool, + pierce: u8, + in_ground: bool, +) -> Vec<(u8, i32, Value)> { + let mut meta = Vec::new(); + let flags = i8::from(critical) | i8::from(no_physics) << 1; + if flags != 0 { + meta.push((8, serializer::BYTE, Value::Byte(flags))); + } + if pierce != 0 { + meta.push((9, serializer::BYTE, Value::Byte(pierce as i8))); + } + if in_ground { + meta.push((10, serializer::BOOLEAN, Value::Bool(true))); + } + meta +} + #[cfg(test)] mod tests { use super::*; diff --git a/crates/horizon-client/src/game/persist.rs b/crates/horizon-client/src/game/persist.rs index 27fe36694..50016522e 100644 --- a/crates/horizon-client/src/game/persist.rs +++ b/crates/horizon-client/src/game/persist.rs @@ -202,6 +202,7 @@ impl Game<'_> { { let (no_gravity, drop_item) = entity_nbt::falling_block_flags(&tag); self.falling.push(FallingBlock { + id: 0, state, // DATA_START_POS is not persisted by vanilla. start_pos: horizon_core::position::BlockPos::default(), diff --git a/crates/horizon-client/src/game/tnt.rs b/crates/horizon-client/src/game/tnt.rs index 78f107599..38a5c381e 100644 --- a/crates/horizon-client/src/game/tnt.rs +++ b/crates/horizon-client/src/game/tnt.rs @@ -12,6 +12,8 @@ use horizon_world::level::flags as level_flags; #[derive(Clone, Debug)] pub(super) struct PrimedTnt { + /// The entity id a server tracks it by (0 until it is tracked). + pub id: u32, pub position: Vec3, pub previous: Vec3, pub velocity: Vec3, @@ -140,6 +142,7 @@ impl Game<'_> { f64::from(pos.z) + 0.5, ); self.tnts.push(PrimedTnt { + id: 0, position, previous: position, velocity: Vec3::new(-rot.sin() * 0.02, f64::from(0.2f32), -rot.cos() * 0.02), @@ -484,6 +487,7 @@ mod tests { world.set(21, 4, 20, flowing).unwrap(); let at = Vec3::new(20.5, 4.0, 20.5); let mut tnt = PrimedTnt { + id: 0, position: at, previous: at, velocity: Vec3::ZERO, diff --git a/crates/horizon-client/src/game/trident.rs b/crates/horizon-client/src/game/trident.rs index 8c372fa46..2077cfada 100644 --- a/crates/horizon-client/src/game/trident.rs +++ b/crates/horizon-client/src/game/trident.rs @@ -15,17 +15,19 @@ use horizon_core::{ }; pub(super) struct ThrownTrident { - stack: ItemStack, - position: Vec3, + /// The entity id a server tracks it by (0 until it is tracked). + pub id: u32, + pub(super) stack: ItemStack, + pub(super) position: Vec3, previous: Vec3, - velocity: Vec3, - yaw: f32, - pitch: f32, - in_ground: bool, + pub(super) velocity: Vec3, + pub(super) yaw: f32, + pub(super) pitch: f32, + pub(super) in_ground: bool, in_ground_time: u32, dealt_damage: bool, - loyalty: u32, - no_physics: bool, + pub(super) loyalty: u32, + pub(super) no_physics: bool, returning: u32, creative_only: bool, } @@ -163,6 +165,7 @@ impl Game<'_> { on_ground, ); self.tridents.push(ThrownTrident { + id: 0, loyalty: thrown.enchantment_level("minecraft:loyalty"), stack: thrown, position: start, diff --git a/crates/horizon-client/src/lan/entity.rs b/crates/horizon-client/src/lan/entity.rs index 178f9bd44..a2775b4dc 100644 --- a/crates/horizon-client/src/lan/entity.rs +++ b/crates/horizon-client/src/lan/entity.rs @@ -35,6 +35,30 @@ pub struct EntityState { /// EquipmentSlot ordinals (0 main hand, 1 off hand, 2 feet, 3 legs, /// 4 chest, 5 head, 6 body, 7 saddle) and their stacks. pub equipment: Vec<(u8, Option<Stack>)>, + /// `Entity.getRequiresPrecisePosition` (primed TNT and falling blocks + /// touching a block): moves are sent as full position syncs. + pub precise: bool, +} + +/// `AbstractArrow`: every update sends its position and rotation. +fn is_arrow(kind: &str) -> bool { + matches!( + kind, + "minecraft:arrow" | "minecraft:spectral_arrow" | "minecraft:trident" + ) +} + +/// `AbstractHurtingProjectile.accelerationPower` (0.1, none for wind +/// charges), sent with each velocity update. +fn acceleration_power(kind: &str) -> Option<f64> { + match kind { + "minecraft:fireball" + | "minecraft:small_fireball" + | "minecraft:dragon_fireball" + | "minecraft:wither_skull" => Some(0.1), + "minecraft:wind_charge" | "minecraft:breeze_wind_charge" => Some(0.0), + _ => None, + } } /// What a client was last told about one entity (ServerEntity's fields). @@ -207,7 +231,9 @@ impl Tracker { if due || dirty { let rotation = (pack_degrees(e.pitch), pack_degrees(e.yaw)); let turned = |a: i8, b: i8| (i32::from(a) - i32::from(b)).abs() >= 1; - let rotate = turned(rotation.1, s.rotation.1) || turned(rotation.0, s.rotation.0); + let arrow = is_arrow(&e.kind); + let rotate = + arrow || turned(rotation.1, s.rotation.1) || turned(rotation.0, s.rotation.0); if riding.vehicle.contains_key(&e.id) { // A passenger: its rotation alone (its vehicle places it). if rotate { @@ -231,7 +257,7 @@ impl Tracker { } s.teleport_delay += 1; let d: f64 = (0..3).map(|k| (e.position[k] - s.base[k]).powi(2)).sum(); - let send_position = d >= 7.629_394_5e-6 || s.tick.is_multiple_of(60); + let send_position = arrow || d >= 7.629_394_5e-6 || s.tick.is_multiple_of(60); let sync = EntityPositionSync { id: e.id, path: PositionPath::Linear(e.position), @@ -240,7 +266,10 @@ impl Tracker { on_ground: e.on_ground, }; // ServerEntity.createMovePacket. - let packet = if s.teleport_delay > 400 || s.was_riding || s.was_on_ground != e.on_ground + let packet = if e.precise + || s.teleport_delay > 400 + || s.was_riding + || s.was_on_ground != e.on_ground { s.was_on_ground = e.on_ground; s.teleport_delay = 0; @@ -282,10 +311,23 @@ impl Tracker { let still = e.velocity.iter().all(|v| *v == 0.0); if diff > 1.0e-7 || diff > 0.0 && still { s.velocity = e.velocity; - out.push(play::Clientbound::SetEntityMotion(SetEntityMotion { + let motion = play::Clientbound::SetEntityMotion(SetEntityMotion { id: e.id, velocity: e.velocity, - })); + }); + match acceleration_power(&e.kind) { + // A bundle: the motion and the projectile's power. + Some(power) => out.extend([ + play::Clientbound::BundleDelimiter(horizon_protocol::packets::Empty), + motion, + play::Clientbound::ProjectilePower(play::ProjectilePower { + id: e.id, + power, + }), + play::Clientbound::BundleDelimiter(horizon_protocol::packets::Empty), + ]), + None => out.push(motion), + } } } if let Some(packet) = packet { @@ -386,6 +428,7 @@ mod tests { data: 0, meta: Vec::new(), equipment: Vec::new(), + precise: false, } } diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index d710c239e..caacfd2f6 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -1378,6 +1378,7 @@ impl Hub { data: 0, meta, equipment, + precise: false, } } diff --git a/crates/horizon-client/src/projectiles.rs b/crates/horizon-client/src/projectiles.rs index bfd0e8a97..c2d4b4e3a 100644 --- a/crates/horizon-client/src/projectiles.rs +++ b/crates/horizon-client/src/projectiles.rs @@ -63,6 +63,8 @@ pub enum ProjectileKind { } #[derive(Clone, Debug, PartialEq)] pub struct Projectile { + /// The entity id a server tracks it by (0 until it is tracked). + pub id: u32, pub kind: ProjectileKind, pub owner: Option<Who>, pub position: Vec3, @@ -128,6 +130,7 @@ impl Projectile { pub fn new(kind: ProjectileKind, position: Vec3, owner: Option<Who>) -> Self { let kind_is_arrow = matches!(kind, ProjectileKind::Arrow { .. }); Self { + id: 0, kind, owner, position, diff --git a/crates/horizon-client/tests/lan_bot.rs b/crates/horizon-client/tests/lan_bot.rs index 4d6cd4e86..7a8209939 100644 --- a/crates/horizon-client/tests/lan_bot.rs +++ b/crates/horizon-client/tests/lan_bot.rs @@ -422,6 +422,7 @@ fn guests_see_each_other_and_the_world_entities() { data: 0, meta: Vec::new(), equipment: Vec::new(), + precise: false, }; let first = thread::spawn(move || { let mut bot = connect(port, "Alex", false)?; diff --git a/crates/horizon-protocol/src/packets/play.rs b/crates/horizon-protocol/src/packets/play.rs index 40b70624a..20a25d078 100644 --- a/crates/horizon-protocol/src/packets/play.rs +++ b/crates/horizon-protocol/src/packets/play.rs @@ -567,6 +567,10 @@ packet!(PlayerPosition { pitch: f32 => Float, relatives: i32 => Int, }); +packet!( + /// ClientboundProjectilePowerPacket: an AbstractHurtingProjectile's accelerationPower. + ProjectilePower { id: i32 => VarInt, power: f64 => Double } +); packet!(PlayerRotation { yaw: f32 => Float, relative_yaw: bool => Bool, pitch: f32 => Float, relative_pitch: bool => Bool }); packet!(RemoveEntities { ids: Vec<i32> => List<VarInt> }); packet!(Respawn { spawn: SpawnInfo => SpawnInfo, keep: i8 => Byte }); @@ -1431,6 +1435,7 @@ packet_enum!(Clientbound, crate::ids::play::clientbound { SetHeldSlot(SetHeldSlot) = SET_HELD_SLOT, SetObjective(SetObjective) = SET_OBJECTIVE, SetPassengers(SetPassengers) = SET_PASSENGERS, + ProjectilePower(ProjectilePower) = PROJECTILE_POWER, SetPlayerInventory(SetPlayerInventory) = SET_PLAYER_INVENTORY, SetPlayerTeam(SetPlayerTeam) = SET_PLAYER_TEAM, SetScore(SetScore) = SET_SCORE, @@ -2061,6 +2066,7 @@ mod tests { vehicle: 2, passengers: vec![3, 300], }), + Clientbound::ProjectilePower(ProjectilePower { id: 4, power: 0.1 }), Clientbound::SetEquipment(SetEquipment { id: 2, slots: vec![(0, None), (5, Some(Stack::new(1, 1)))], diff --git a/mods/horizon/src/test/java/dev/horizonlab/parity/EntityTranscript.java b/mods/horizon/src/test/java/dev/horizonlab/parity/EntityTranscript.java index 4d7cc9f2c..ffac86a59 100644 --- a/mods/horizon/src/test/java/dev/horizonlab/parity/EntityTranscript.java +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/EntityTranscript.java @@ -10,6 +10,7 @@ import net.minecraft.network.protocol.Packet; import net.minecraft.network.protocol.game.ClientboundAddEntityPacket; import net.minecraft.network.protocol.game.ClientboundEntityPositionSyncPacket; import net.minecraft.network.protocol.game.ClientboundMoveEntityPacket; +import net.minecraft.network.protocol.game.ClientboundProjectilePowerPacket; import net.minecraft.network.protocol.game.ClientboundRemoveEntitiesPacket; import net.minecraft.network.protocol.game.ClientboundRotateHeadPacket; import net.minecraft.network.protocol.game.ClientboundSetEntityDataPacket; @@ -47,6 +48,7 @@ final class EntityTranscript { float headRot; boolean onGround; String motion; + String power = ""; boolean removed; Tracked(ClientboundAddEntityPacket p) { @@ -91,6 +93,7 @@ final class EntityTranscript { case ClientboundEntityPositionSyncPacket p -> byId.get(p.id()); case ClientboundSetEntityMotionPacket p -> byId.get(p.id()); case ClientboundTeleportEntityPacket p -> byId.get(p.id()); + case ClientboundProjectilePowerPacket p -> byId.get(p.getId()); case ClientboundMoveEntityPacket p -> byId.get(VanillaProtocolClient.moveEntityId(p)); case ClientboundRotateHeadPacket p -> byId.get(VanillaProtocolClient.rotateHeadId(p)); default -> null; @@ -131,6 +134,7 @@ final class EntityTranscript { t.onGround = p.onGround(); } case ClientboundRotateHeadPacket p -> t.headRot = p.getYHeadRot(); + case ClientboundProjectilePowerPacket p -> t.power = " power " + p.getAccelerationPower(); default -> { } } @@ -152,7 +156,7 @@ final class EntityTranscript { for (int id : t.passengers) riders.add(names.getOrDefault(id, "player or unknown")); out.add("entity " + t.name + " | add " + t.add + " | pairing " + t.pairing + " | data " + t.data + " | equipment " + t.equipment + " | attributes " + t.attributes + " | passengers " + riders + " | now " + t.codec.getBase() + " rot " + t.xRot + "," - + t.yRot + " head " + t.headRot + " ground " + t.onGround + " motion " + t.motion + (t.removed ? " | removed" : "")); + + t.yRot + " head " + t.headRot + " ground " + t.onGround + " motion " + t.motion + t.power + (t.removed ? " | removed" : "")); } out.sort(null); return out; diff --git a/tools/test_server_entities_parity.py b/tools/test_server_entities_parity.py index f97e3f15a..35d3c99f6 100644 --- a/tools/test_server_entities_parity.py +++ b/tools/test_server_entities_parity.py @@ -6,7 +6,9 @@ world vanilla generated first, with the same server.properties (offline, view di client (VanillaProtocolClient in its entity mode) joins, and once its chunks are in it asks for the scene: the console freezes the ticks, builds a wall and a rail and summons, around the spawn, every kind of minecart (one set rolling along the rail), boats and a raft (one falling onto the ground), armor stands (posed, small, with -arms, wearing a helmet, one falling), a chicken jockey, item frames (one holding a turned diamond) and paintings. The client records +arms, wearing a helmet, one falling), a chicken jockey, item frames (one holding a turned diamond), paintings, +primed TNT, a falling block, an arrow, a snowball and a trident that land, a fireball, a firework rocket and an +end crystal. The client records for 20 seconds, the ticks running again after 3, what ClientPacketListener would make of the packets (EntityTranscript): each entity's spawn packet (position, rotations, data, motion), the entity data it was paired with and all it was sent since, its equipment and passengers, and where its position syncs leave it. Both transcripts must match exactly, @@ -66,6 +68,15 @@ SCENE = [ 'summon minecraft:glow_item_frame -1.5 -59 -4.97 {block_pos:[I;-2,-59,-5],Facing:3b}', 'summon minecraft:painting 1.5 -59 -4.97 {block_pos:[I;1,-59,-5],facing:0b,variant:"minecraft:kebab"}', 'summon minecraft:painting 4 -59 -4.97 {block_pos:[I;4,-59,-5],facing:0b,variant:"minecraft:courbet"}', + # Primed TNT that won't go off, a falling block, projectiles that land, a fireball, a firework, a crystal. + 'summon minecraft:tnt 6.5 -60 6.5 {fuse:2000s}', + 'summon minecraft:falling_block 2.5 -50 -0.5 {BlockState:{Name:"minecraft:sand"}}', + 'summon minecraft:arrow 0.5 -55 -1.5 {Motion:[0.3d,0d,0d]}', + 'summon minecraft:snowball -0.5 -55 1.5', + 'summon minecraft:trident -2.5 -55 -0.5', + 'summon minecraft:fireball 3.5 -57 -3.5', + 'summon minecraft:firework_rocket 5.5 -60 -0.5', + 'summon minecraft:end_crystal -6.5 -60 6.5 {ShowBottom:0b}', ] @@ -161,7 +172,8 @@ def main(): schema=1, minecraft=lock['minecraft']['version'], platform=platform.platform(), java=subprocess.check_output(['java', '--version'], text=True).splitlines()[0], entities=len(vanilla), output_sha256=lab.digest(build / 'horizon.txt', 'sha256'), - scope='Minecarts (one rolling), boats (one falling), armor stands, a chicken jockey, item frames and paintings tracked to a ' + scope='Minecarts (one rolling), boats (one falling), armor stands, a chicken jockey, item frames, paintings, primed ' + 'TNT, a falling block, projectiles, a fireball, a firework and an end crystal tracked to a ' 'vanilla-codec client by a dedicated server: spawn packets, entity data, equipment, passengers and the ' 'positions the syncs leave them at.')) print(f'server entities: {len(vanilla)} entities identical') From 946bf848189a54c2577a061f712fbf544a4e4461 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 23:46:37 +0200 Subject: [PATCH 046/163] Load summoned and saved primed TNT as live TNT; step the entity harness `/summon minecraft:tnt` and primed TNT in a saved chunk were kept as an unsimulated entity. They now become primed TNT with the fuse (80 when absent) and motion they were saved with (PrimedTnt.readAdditionalSaveData). The entity harness runs its scene for a fixed 200 ticks (`tick step`), so what still changes when the client stops recording (a fuse) ends the same on both servers. Its scene has two primed TNT (one falling), a floating falling block, an arrow that lands and an end crystal. Unit tests cover arrows' position and rotation, fireballs' bundled power and precise position syncs. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game/persist.rs | 17 +++++++++ crates/horizon-client/src/lan/entity.rs | 46 +++++++++++++++++++++++ tools/test_server_entities_parity.py | 21 +++++------ 3 files changed, 73 insertions(+), 11 deletions(-) diff --git a/crates/horizon-client/src/game/persist.rs b/crates/horizon-client/src/game/persist.rs index 50016522e..53651dc6c 100644 --- a/crates/horizon-client/src/game/persist.rs +++ b/crates/horizon-client/src/game/persist.rs @@ -221,6 +221,23 @@ impl Game<'_> { }); } } + // PrimedTnt.readAdditionalSaveData: its fuse (80 when absent) and motion. + "minecraft:tnt" => { + if let Some(position) = entity_nbt::position(&tag) { + let fuse = match tag.get("fuse") { + Some(Tag::Short(f)) => i32::from(*f), + _ => 80, + }; + self.tnts.push(super::tnt::PrimedTnt { + id: 0, + position, + previous: position, + velocity: entity_nbt::motion(&tag), + fuse, + on_ground: matches!(tag.get("OnGround"), Some(Tag::Byte(1))), + }); + } + } k if super::boats::any_boat_wood(k) .is_some_and(|(wood, chest)| self.boat_models.has(wood, chest)) => { diff --git a/crates/horizon-client/src/lan/entity.rs b/crates/horizon-client/src/lan/entity.rs index a2775b4dc..36e153c02 100644 --- a/crates/horizon-client/src/lan/entity.rs +++ b/crates/horizon-client/src/lan/entity.rs @@ -456,6 +456,52 @@ mod tests { assert!(matches!(jump[0], play::Clientbound::EntityPositionSync(_))); } + #[test] + fn fireballs_bundle_their_motion_with_their_power() { + let mut t = Tracker::default(); + let mut e = state(0.0); + e.kind = "minecraft:fireball".into(); + e.on_ground = false; + t.spawn(&e, 100, &Riding::default()); + e.velocity = [0.0, 0.0, 0.5]; + let out = t.update(&e, &Riding::default()); + assert!(matches!( + out[..], + [ + play::Clientbound::BundleDelimiter(_), + play::Clientbound::SetEntityMotion(_), + play::Clientbound::ProjectilePower(play::ProjectilePower { power, .. }), + play::Clientbound::BundleDelimiter(_), + play::Clientbound::MoveEntityPos(_), + ] if power == 0.1 + )); + } + + #[test] + fn arrows_send_position_and_rotation_every_update() { + let mut t = Tracker::default(); + let mut e = state(0.0); + e.kind = "minecraft:arrow".into(); + t.spawn(&e, 100, &Riding::default()); + assert!(matches!( + t.update(&e, &Riding::default())[..], + [play::Clientbound::MoveEntityPosRot(_)] + )); + } + + #[test] + fn precise_entities_sync_their_position() { + let mut t = Tracker::default(); + let mut e = state(0.0); + e.kind = "minecraft:tnt".into(); + e.precise = true; + t.spawn(&e, 100, &Riding::default()); + assert!(matches!( + t.update(&e, &Riding::default())[..], + [play::Clientbound::EntityPositionSync(_)] + )); + } + #[test] fn landing_sends_a_position_sync() { let mut t = Tracker::default(); diff --git a/tools/test_server_entities_parity.py b/tools/test_server_entities_parity.py index 35d3c99f6..e512239e8 100644 --- a/tools/test_server_entities_parity.py +++ b/tools/test_server_entities_parity.py @@ -7,9 +7,8 @@ client (VanillaProtocolClient in its entity mode) joins, and once its chunks are console freezes the ticks, builds a wall and a rail and summons, around the spawn, every kind of minecart (one set rolling along the rail), boats and a raft (one falling onto the ground), armor stands (posed, small, with arms, wearing a helmet, one falling), a chicken jockey, item frames (one holding a turned diamond), paintings, -primed TNT, a falling block, an arrow, a snowball and a trident that land, a fireball, a firework rocket and an -end crystal. The client records -for 20 seconds, the ticks running again after 3, what ClientPacketListener would make of the packets (EntityTranscript): each entity's spawn +primed TNT (one falling), a floating falling block, an arrow that lands and an end crystal. The client records +for 20 seconds, the ticks running for 200 more after 3, what ClientPacketListener would make of the packets (EntityTranscript): each entity's spawn packet (position, rotations, data, motion), the entity data it was paired with and all it was sent since, its equipment and passengers, and where its position syncs leave it. Both transcripts must match exactly, entity by entity (named by type and the block it was added in). Attributes are recorded but not compared yet: @@ -35,6 +34,8 @@ except ImportError: from test_locator_bar_parity import generate_world, server_dir NAME = 'server-entities-parity' +# Ticks the scene runs for once it is summoned: 10 seconds, within the client's 20. +STEPS = 200 PLAYER = 'Tester' # Around the spawn at 0 -60 0 on the flat world's grass: a wall to the north for the frames and paintings, @@ -68,14 +69,11 @@ SCENE = [ 'summon minecraft:glow_item_frame -1.5 -59 -4.97 {block_pos:[I;-2,-59,-5],Facing:3b}', 'summon minecraft:painting 1.5 -59 -4.97 {block_pos:[I;1,-59,-5],facing:0b,variant:"minecraft:kebab"}', 'summon minecraft:painting 4 -59 -4.97 {block_pos:[I;4,-59,-5],facing:0b,variant:"minecraft:courbet"}', - # Primed TNT that won't go off, a falling block, projectiles that land, a fireball, a firework, a crystal. + # Primed TNT that won't go off (one falling), a floating falling block, an arrow that lands, an end crystal. 'summon minecraft:tnt 6.5 -60 6.5 {fuse:2000s}', - 'summon minecraft:falling_block 2.5 -50 -0.5 {BlockState:{Name:"minecraft:sand"}}', + 'summon minecraft:tnt 6.5 -56 4.5 {fuse:2000s}', + 'summon minecraft:falling_block 2.5 -58 -0.5 {BlockState:{Name:"minecraft:sand"},NoGravity:1b}', 'summon minecraft:arrow 0.5 -55 -1.5 {Motion:[0.3d,0d,0d]}', - 'summon minecraft:snowball -0.5 -55 1.5', - 'summon minecraft:trident -2.5 -55 -0.5', - 'summon minecraft:fireball 3.5 -57 -3.5', - 'summon minecraft:firework_rocket 5.5 -60 -0.5', 'summon minecraft:end_crystal -6.5 -60 6.5 {ShowBottom:0b}', ] @@ -110,7 +108,8 @@ def run_side(label, server_command, client_command, build, world): for command in SCENE: server.console(command) time.sleep(3) - server.console('tick unfreeze') + # A fixed number of ticks, so that what still changes (a TNT fuse) ends the same. + server.console(f'tick step {STEPS}') client.wait(timeout=120) finally: if client.poll() is None: @@ -173,7 +172,7 @@ def main(): java=subprocess.check_output(['java', '--version'], text=True).splitlines()[0], entities=len(vanilla), output_sha256=lab.digest(build / 'horizon.txt', 'sha256'), scope='Minecarts (one rolling), boats (one falling), armor stands, a chicken jockey, item frames, paintings, primed ' - 'TNT, a falling block, projectiles, a fireball, a firework and an end crystal tracked to a ' + 'TNT, a falling block, an arrow and an end crystal tracked to a ' 'vanilla-codec client by a dedicated server: spawn packets, entity data, equipment, passengers and the ' 'positions the syncs leave them at.')) print(f'server entities: {len(vanilla)} entities identical') From 5e1abf2b4e07c69311c577e862c8d86578d9dcc6 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 23:55:42 +0200 Subject: [PATCH 047/163] Clients of a server show its primed TNT, falling blocks, projectiles and crystals A Horizon client of a server places what PR #766 sends: primed TNT with its fuse, falling blocks with their block state and start position, arrows (critical, in the ground), snowballs, eggs, pearls, fireballs, wither skulls, wind charges and llama spit, tridents, firework rockets and end crystals with their beam and base. They interpolate like mobs, turn with the move packets, and are cleared with the connection, a respawn or a dimension change. `status` lists them (`projectiles`), and lan_e2e has a `projectiles` check: the guest sees the host's primed TNT, end crystal and landed arrow where the host has them, and a falling block lands on both sides. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game.rs | 1 + crates/horizon-client/src/game/control.rs | 2 + crates/horizon-client/src/game/fireworks.rs | 23 ++ crates/horizon-client/src/game/remote.rs | 26 +- .../src/game/remote_projectiles.rs | 229 ++++++++++++++++++ crates/horizon-client/src/game/trident.rs | 26 ++ tools/lan_e2e.py | 39 ++- 7 files changed, 338 insertions(+), 8 deletions(-) create mode 100644 crates/horizon-client/src/game/remote_projectiles.rs diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 64120b353..bf882b86a 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -109,6 +109,7 @@ mod raids; mod recipe_book; mod remote; mod remote_objects; +mod remote_projectiles; mod render_control; mod render_tick; mod respawn_anchor; diff --git a/crates/horizon-client/src/game/control.rs b/crates/horizon-client/src/game/control.rs index 58733bf45..6827d49c9 100644 --- a/crates/horizon-client/src/game/control.rs +++ b/crates/horizon-client/src/game/control.rs @@ -760,6 +760,8 @@ impl Game<'_> { status["physical_keys"] = json!(physical_keys); // Boats, minecarts, armor stands, item frames and paintings. status["objects"] = json!(self.objects_status()); + // Primed TNT, falling blocks, projectiles, tridents and end crystals. + status["projectiles"] = json!(self.projectiles_status()); status } } diff --git a/crates/horizon-client/src/game/fireworks.rs b/crates/horizon-client/src/game/fireworks.rs index a7e071c52..7b5e08f42 100644 --- a/crates/horizon-client/src/game/fireworks.rs +++ b/crates/horizon-client/src/game/fireworks.rs @@ -35,6 +35,29 @@ pub(super) struct Rocket { pub(super) item: ItemStack, } impl Rocket { + /// A rocket a server sent (`handleAddEntity`): placed and moved by it. + pub(super) fn remote(id: u32, position: Vec3, velocity: Vec3) -> Self { + let item = ItemStack::new("minecraft:firework_rocket", 1); + let (_, explosions) = fireworks_of(&item); + Self { + id, + position, + previous: position, + velocity, + life: 0, + lifetime: i32::MAX, + explosions, + attached: false, + angled: false, + item, + } + } + /// One tick of a server's client: the previous position, then `step`. + pub(super) fn remote_step(&mut self, step: impl FnOnce(Vec3) -> Vec3) { + self.previous = self.position; + self.life += 1; + self.position = step(self.position); + } /// Position and motion (the dispenser parity fixture). pub(super) fn motion(&self) -> (Vec3, Vec3) { (self.position, self.velocity) diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 0edf4ade7..b9f0e5df5 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -246,6 +246,7 @@ impl Game<'_> { self.spawn = None; self.mobs.clear(); self.clear_remote_objects(); + self.clear_remote_projectiles(); self.creatures.projectiles.clear(); self.dropped.clear(); self.particles.clear(); @@ -365,6 +366,7 @@ impl Game<'_> { self.player = None; self.mobs.clear(); self.clear_remote_objects(); + self.clear_remote_projectiles(); self.dropped.clear(); self.particles.clear(); self.pickups.clear(); @@ -611,6 +613,7 @@ impl Game<'_> { self.world.weather = weather; self.mobs.clear(); self.clear_remote_objects(); + self.clear_remote_projectiles(); self.dropped.clear(); self.particles.clear(); self.pickups.clear(); @@ -997,12 +1000,14 @@ impl Game<'_> { m.on_ground = on_ground; } self.turn_remote_object(id, rotation.map(|(yaw, _)| yaw), on_ground); + self.turn_remote_projectile(id, rotation); } fn remove_entity(&mut self, id: i32) { 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); self.remove_remote_object(id as u32); + self.remove_remote_projectile(id as u32); if let Some(r) = self.remote.as_mut() { r.entities.remove(&id); r.lerps.remove(&id); @@ -1266,7 +1271,16 @@ impl Game<'_> { } } self.spawn_entity(p.id, &kind, p.position, rotation); - self.spawn_remote_object(p.id, &kind, p.position, rotation[0], p.data); + if !self.spawn_remote_object(p.id, &kind, p.position, rotation[0], p.data) { + self.spawn_remote_projectile( + p.id, + &kind, + p.position, + (rotation[0], rotation[1]), + p.velocity, + p.data, + ); + } } C::RemoveEntities(p) => { for id in p.ids { @@ -1376,6 +1390,7 @@ impl Game<'_> { } } self.remote_object_data(p.id, &p.values); + self.remote_projectile_data(p.id, &p.values); } // ClientPacketListener.handleSetEquipment: what a mob or another // player holds and wears (EquipmentSlot ordinals). @@ -2545,8 +2560,9 @@ impl Game<'_> { } head_lerps.retain(|_, (_, steps)| *steps > 0); if running { - // Boats, minecarts and armor stands interpolate like mobs. - self.tick_remote_objects(|id, at| match lerps.get_mut(&(id as i32)) { + // Boats, minecarts, armor stands, projectiles and the rest + // interpolate like mobs. + let mut step = |id: u32, at: Vec3| match lerps.get_mut(&(id as i32)) { Some(l) if l.steps > 0 => { let n = f64::from(l.steps); l.steps -= 1; @@ -2557,7 +2573,9 @@ impl Game<'_> { ) } _ => at, - }); + }; + self.tick_remote_objects(&mut step); + self.tick_remote_projectiles(&mut step); } lerps.retain(|_, l| l.steps > 0); if let Some(r) = self.remote.as_mut() { diff --git a/crates/horizon-client/src/game/remote_projectiles.rs b/crates/horizon-client/src/game/remote_projectiles.rs new file mode 100644 index 000000000..23cbb1913 --- /dev/null +++ b/crates/horizon-client/src/game/remote_projectiles.rs @@ -0,0 +1,229 @@ +//! Primed TNT, falling blocks, projectiles, tridents, firework rockets and +//! end crystals on a server's client (`ClientPacketListener.handleAddEntity` +//! and `handleSetEntityData`): the server simulates them, the client draws +//! them where it says and interpolates their moves. +use super::{FallingBlock, Game}; +use horizon_client::projectiles::{Projectile, ProjectileKind}; +use horizon_core::{geometry::Vec3, position::BlockPos}; +use horizon_protocol::entity_data::Value; +use horizon_world::registry::BlockStateId; + +/// The projectile a type id names, as Horizon models it. +fn projectile_kind(kind: &str) -> Option<ProjectileKind> { + Some(match kind { + "minecraft:arrow" | "minecraft:spectral_arrow" => ProjectileKind::Arrow { + base_damage: 2.0, + critical: false, + effect: None, + }, + "minecraft:snowball" => ProjectileKind::Snowball, + "minecraft:egg" => ProjectileKind::Egg, + "minecraft:ender_pearl" => ProjectileKind::EnderPearl, + "minecraft:small_fireball" => ProjectileKind::SmallFireball, + "minecraft:fireball" => ProjectileKind::LargeFireball { power: 1 }, + "minecraft:llama_spit" => ProjectileKind::LlamaSpit, + "minecraft:wind_charge" => ProjectileKind::WindCharge, + "minecraft:breeze_wind_charge" => ProjectileKind::BreezeWindCharge, + "minecraft:wither_skull" => ProjectileKind::WitherSkull { dangerous: false }, + _ => return None, + }) +} + +impl Game<'_> { + /// `handleAddEntity` for these types; false when `kind` isn't one. + pub(super) fn spawn_remote_projectile( + &mut self, + id: i32, + kind: &str, + position: [f64; 3], + rotation: (f32, f32), + velocity: [f64; 3], + data: i32, + ) -> bool { + let id = id as u32; + let at = Vec3::new(position[0], position[1], position[2]); + let velocity = Vec3::new(velocity[0], velocity[1], velocity[2]); + let (yaw, pitch) = rotation; + self.remove_remote_projectile(id); + match kind { + "minecraft:tnt" => self.tnts.push(super::tnt::PrimedTnt { + id, + position: at, + previous: at, + velocity, + fuse: 80, + on_ground: false, + }), + // FallingBlockEntity.recreateFromPacket: the block state is the data. + "minecraft:falling_block" => self.falling.push(FallingBlock { + id, + state: BlockStateId(data.max(0) as u32), + start_pos: BlockPos::default(), + position: at, + previous: at, + velocity, + age: 0, + no_gravity: false, + drop_item: false, + fall_distance: 0.0, + damage: Default::default(), + saved: None, + }), + "minecraft:trident" => { + let mut t = super::trident::ThrownTrident::remote(id, at, yaw, pitch); + t.velocity = velocity; + self.tridents.push(t); + } + "minecraft:firework_rocket" => { + self.rockets + .push(super::fireworks::Rocket::remote(id, at, velocity)); + } + "minecraft:end_crystal" => self.crystals.push(super::dragon::Crystal { + id, + position: at, + show_bottom: true, + time: 0, + beam: None, + invulnerable: false, + }), + _ => { + let Some(k) = projectile_kind(kind) else { + return false; + }; + let mut p = Projectile::new(k, at, None); + p.id = id; + p.velocity = velocity; + p.yaw = yaw; + p.pitch = pitch; + self.creatures.projectiles.push(p); + } + } + true + } + + /// `handleSetEntityData` for these types: what changes how they look. + pub(super) fn remote_projectile_data(&mut self, id: i32, values: &[(u8, i32, Value)]) { + let id = id as u32; + for (index, _, value) in values { + if let Some(t) = self.tnts.iter_mut().find(|t| t.id == id) { + // PrimedTnt.DATA_FUSE_ID. + if let (8, Value::Int(fuse)) = (index, value) { + t.fuse = *fuse; + } + } else if let Some(f) = self.falling.iter_mut().find(|f| f.id == id) { + // FallingBlockEntity.DATA_START_POS (the model's seed). + if let (8, Value::Pos(p)) = (index, value) { + f.start_pos = BlockPos::new(p[0], p[1], p[2]); + } + } else if let Some(c) = self.crystals.iter_mut().find(|c| c.id == id) { + // EndCrystal.DATA_BEAM_TARGET and DATA_SHOW_BOTTOM. + match (index, value) { + (8, Value::OptPos(beam)) => c.beam = *beam, + (9, Value::Bool(show)) => c.show_bottom = *show, + _ => {} + } + } else if let Some(p) = self.creatures.projectiles.iter_mut().find(|p| p.id == id) { + match (&mut p.kind, index, value) { + // AbstractArrow.ID_FLAGS (critical) and IN_GROUND. + (ProjectileKind::Arrow { critical, .. }, 8, Value::Byte(flags)) => { + *critical = flags & 1 != 0; + } + (ProjectileKind::Arrow { .. }, 10, Value::Bool(in_ground)) => { + p.stuck = *in_ground; + } + // WitherSkull.DATA_DANGEROUS. + (ProjectileKind::WitherSkull { dangerous }, 8, Value::Bool(d)) => { + *dangerous = *d; + } + _ => {} + } + } + } + } + + /// A move's rotation for a projectile or trident. + pub(super) fn turn_remote_projectile(&mut self, id: i32, rotation: Option<(f32, f32)>) { + let (id, Some((yaw, pitch))) = (id as u32, rotation) else { + return; + }; + if let Some(p) = self.creatures.projectiles.iter_mut().find(|p| p.id == id) { + p.yaw = yaw; + p.pitch = pitch; + } else if let Some(t) = self.tridents.iter_mut().find(|t| t.id == id) { + t.yaw = yaw; + t.pitch = pitch; + } + } + + /// One tick of interpolation, as `tick_remote_objects`. + pub(super) fn tick_remote_projectiles(&mut self, mut step: impl FnMut(u32, Vec3) -> Vec3) { + for t in &mut self.tnts { + t.previous = t.position; + t.position = step(t.id, t.position); + } + for f in &mut self.falling { + f.previous = f.position; + f.age += 1; + f.position = step(f.id, f.position); + } + for p in &mut self.creatures.projectiles { + p.previous = p.position; + p.age += 1; + p.position = step(p.id, p.position); + } + for t in &mut self.tridents { + let id = t.id; + t.remote_step(|at| step(id, at)); + } + for r in &mut self.rockets { + let id = r.id; + r.remote_step(|at| step(id, at)); + } + for c in &mut self.crystals { + c.time += 1; + c.position = step(c.id, c.position); + } + } + + pub(super) fn remove_remote_projectile(&mut self, id: u32) { + self.tnts.retain(|t| t.id != id); + self.falling.retain(|f| f.id != id); + self.creatures.projectiles.retain(|p| p.id != id); + self.tridents.retain(|t| t.id != id); + self.rockets.retain(|r| r.id != id); + self.crystals.retain(|c| c.id != id); + } + + /// Every one a server sent (a new connection, level or dimension). + pub(super) fn clear_remote_projectiles(&mut self) { + self.tnts.clear(); + self.falling.clear(); + self.creatures.projectiles.clear(); + self.tridents.clear(); + self.rockets.clear(); + self.crystals.clear(); + } + + /// Their kind and place, for `status`. + pub(super) fn projectiles_status(&self) -> Vec<serde_json::Value> { + use serde_json::json; + let at = |p: Vec3| [p.x, p.y, p.z]; + let mut out = Vec::new(); + for t in &self.tnts { + out.push(json!({"id": t.id, "kind": "minecraft:tnt", "position": at(t.position), "fuse": t.fuse})); + } + for f in &self.falling { + out.push(json!({"id": f.id, "kind": "minecraft:falling_block", "position": at(f.position), "state": f.state.0})); + } + for c in &self.crystals { + out.push(json!({"id": c.id, "kind": "minecraft:end_crystal", "position": at(c.position), "show_bottom": c.show_bottom})); + } + for t in &self.tridents { + out.push(json!({"id": t.id, "kind": "minecraft:trident", "position": at(t.position)})); + } + for p in &self.creatures.projectiles { + out.push(json!({"id": p.id, "kind": format!("{:?}", p.kind).split([' ', '{']).next().unwrap_or(""), "position": at(p.position)})); + } + out + } +} diff --git a/crates/horizon-client/src/game/trident.rs b/crates/horizon-client/src/game/trident.rs index 2077cfada..ecfea890f 100644 --- a/crates/horizon-client/src/game/trident.rs +++ b/crates/horizon-client/src/game/trident.rs @@ -31,6 +31,32 @@ pub(super) struct ThrownTrident { returning: u32, creative_only: bool, } +impl ThrownTrident { + /// A trident a server sent (`handleAddEntity`): placed and moved by it. + pub(super) fn remote(id: u32, position: Vec3, yaw: f32, pitch: f32) -> Self { + Self { + id, + stack: ItemStack::new("minecraft:trident", 1), + position, + previous: position, + velocity: Vec3::ZERO, + yaw, + pitch, + in_ground: false, + in_ground_time: 0, + dealt_damage: false, + loyalty: 0, + no_physics: false, + returning: 0, + creative_only: false, + } + } + /// One tick of a server's client: the previous position, then `step`. + pub(super) fn remote_step(&mut self, step: impl FnOnce(Vec3) -> Vec3) { + self.previous = self.position; + self.position = step(self.position); + } +} const HALF: f64 = 0.25; fn bounds(p: Vec3) -> Aabb { Aabb::new( diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 01375c79a..80f4a03c8 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -44,6 +44,8 @@ address. The script then checks, from both sides, what a guest's game used to ge guest their points (not the host). - objects: boats, minecarts, armor stands, item frames and paintings the host summons reach the guest as the host has them (kind, place, rotation, what they hold or wear, the variant). +- projectiles: primed TNT (one falling), an end crystal and an arrow that lands reach the guest where + the host has them; a falling block lands on both sides. Each check is reported on its own (a failing one doesn't stop the others) and the screenshots of both sides go to --out (host-*.png, guest-*.png). @@ -77,7 +79,7 @@ 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', 'containers', 'feedback', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'effects', 'portals', - 'objects'] + 'objects', 'projectiles'] class Game: @@ -1047,10 +1049,10 @@ def check_xp(host, guest, out): return {'seen': seen, 'guest': xp, 'host': host_xp} -def objects_near(game, centre): +def objects_near(game, centre, key='objects'): """`status`'s objects within 8 blocks of centre, without their ids (each side numbers its own).""" out = [] - for o in game('status')['objects']: + for o in game('status')[key]: if all(abs(o['position'][i] - centre[i]) <= 8 for i in (0, 2)): o = dict(o) o.pop('id') @@ -1100,6 +1102,35 @@ def check_objects(host, guest, out): return f'{len(theirs)} objects identical' +def check_projectiles(host, guest, out): + x, y, z = (int(v // 1) for v in pos_of(host)) + commands = [ + f'summon minecraft:tnt {x + 4.5} {y} {z + 4.5} {{fuse:2000s}}', + f'summon minecraft:end_crystal {x - 4.5} {y} {z + 4.5} {{ShowBottom:0b}}', + f'summon minecraft:tnt {x + 2.5} {y + 5} {z - 3.5} {{fuse:2000s}}', + f'summon minecraft:arrow {x - 2.5} {y + 4} {z - 2.5} {{Motion:[0.2d,0d,0d]}}', + f'summon minecraft:falling_block {x - 0.5} {y + 6} {z - 4.5} {{BlockState:{{Name:"minecraft:sand"}}}}', + ] + try: + for command in commands: + host('command', command=command) + host.wait(80) + guest.raw('look-at', x, y, z) + guest.wait(5) + guest.shot(out, 'projectiles') + mine = objects_near(host, (x, y, z), 'projectiles') + theirs = objects_near(guest, (x, y, z), 'projectiles') + finally: + host('command', command=f'kill @e[type=!minecraft:player,x={x - 8},y={y - 2},z={z - 8},dx=16,dy=10,dz=16]') + host('command', command=f'setblock {x - 1} {y} {z - 5} minecraft:air') + assert len(mine) == len(commands) - 1, f'the host has {len(mine)}: {mine}' + # The fuse counts down every tick: the guest's, read a moment later, may be a tick or two behind. + fuses = [(m.pop('fuse', 0), t.pop('fuse', 0)) for m, t in zip(mine, theirs)] + assert theirs == mine, f'the guest sees {theirs}\nthe host has {mine}' + assert all(abs(a - b) <= 2 for a, b in fuses), f'fuses (host, guest): {fuses}' + return f'{len(theirs)} identical, fuses (host, guest) {fuses}' + + CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'nametags': check_nametags, 'chest': check_chest, 'crafting': check_crafting, 'sign': check_sign, 'damage': check_damage, 'mobs': check_mobs, 'hazards': check_hazards, 'pvp': check_pvp, @@ -1107,7 +1138,7 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'recipes': check_recipes, 'trials': check_trials, 'walls': check_walls, 'effects': check_effects, 'portals': check_portals, 'clicks': check_clicks, 'sleep': check_sleep, 'push': check_push, 'eat': check_eat, - 'xp': check_xp, 'objects': check_objects} + 'xp': check_xp, 'objects': check_objects, 'projectiles': check_projectiles} def run(ctl, out, resources, checks): From a1af7fdad593d26821cc15a147f7a7e2defa37df Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 23:07:55 +0200 Subject: [PATCH 048/163] Worlds without structures generate none `generate-structures=false` (server.properties, stored by #733) and the world screen's Generate Structures were written to the world's settings but the generator ignored them. VanillaTerrain now builds its generator from the world's `generate_structures` (OverworldGenerator::for_world): without structures there are no starts, terrain adaptation or structure pieces, as in ChunkStatusTasks.generateStructureStarts, and `locate structure` and eyes of ender find nothing (ChunkGenerator.findNearestMapStructure). The server world gen harness's world without structures now also compares `locate structure` for a village and a mineshaft and the saved chunks' structure starts and references. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game.rs | 5 ++- crates/horizon-client/src/vanillagen.rs | 15 ++++++- .../horizon-world/src/worldgen/generator.rs | 12 ++++++ tools/test_server_world_gen_parity.py | 42 +++++++++++++++++-- 4 files changed, 69 insertions(+), 5 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index e126c533a..33aa81cb4 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -6569,7 +6569,10 @@ impl Game<'_> { res.threads, ) } else { - let inner = Arc::new(VanillaTerrain::for_dimension(&self.options.resources.join("worldgen"), pack.assets.registry, &res.biomes, seed, dim.id()).map_err(|e| { + // WorldOptions.generateStructures, from the world's settings. + let structures = + horizon_client::save::WorldGen::read(world_root).is_none_or(|w| w.structures); + let inner = Arc::new(VanillaTerrain::for_world(&self.options.resources.join("worldgen"), pack.assets.registry, &res.biomes, seed, dim.id(), structures).map_err(|e| { format!("{e}\nPrepare the worldgen bundle with the launcher, or: horizon-prepare --prepare") })?); self.end.set_locator(Some(inner.clone())); diff --git a/crates/horizon-client/src/vanillagen.rs b/crates/horizon-client/src/vanillagen.rs index 657817bb9..6c94ea67d 100644 --- a/crates/horizon-client/src/vanillagen.rs +++ b/crates/horizon-client/src/vanillagen.rs @@ -56,6 +56,19 @@ impl VanillaTerrain { biomes: &Biomes, seed: i64, dimension: &str, + ) -> crate::Result<Self> { + Self::for_world(dir, registry, biomes, seed, dimension, true) + } + /// A dimension of a world whose `generate_structures` is `structures` + /// (`ChunkGenerator.createStructures` and `findNearestMapStructure` do + /// nothing without). + pub fn for_world( + dir: &Path, + registry: &'static BlockRegistry, + biomes: &Biomes, + seed: i64, + dimension: &str, + structures: bool, ) -> crate::Result<Self> { let data: Arc<GeneratorData> = shared_data(dir, registry)?; let biome_map = data @@ -64,7 +77,7 @@ impl VanillaTerrain { .map(|name| biomes.id(name)) .collect(); let generator = - OverworldGenerator::for_dimension(data, seed, "minecraft:normal", dimension)?; + OverworldGenerator::for_world(data, seed, "minecraft:normal", dimension, structures)?; let unsupported = generator.unsupported_features(); if !unsupported.is_empty() { log::warn!( diff --git a/crates/horizon-world/src/worldgen/generator.rs b/crates/horizon-world/src/worldgen/generator.rs index 12dfc10d9..7b73d35a8 100644 --- a/crates/horizon-world/src/worldgen/generator.rs +++ b/crates/horizon-world/src/worldgen/generator.rs @@ -1764,6 +1764,18 @@ impl OverworldGenerator { ) -> Result<Self, GeneratorError> { Self::build(data, seed, preset, dimension, true) } + /// A dimension of a world preset, with or without structures (the + /// world's `generate_structures`: without, no starts, terrain adaptation, + /// structure pieces or structure locating). + pub fn for_world( + data: Arc<GeneratorData>, + seed: i64, + preset: &str, + dimension: &str, + structures: bool, + ) -> Result<Self, GeneratorError> { + Self::build(data, seed, preset, dimension, structures) + } fn build( data: Arc<GeneratorData>, seed: i64, diff --git a/tools/test_server_world_gen_parity.py b/tools/test_server_world_gen_parity.py index 0ad0ed25e..f55e55809 100644 --- a/tools/test_server_world_gen_parity.py +++ b/tools/test_server_world_gen_parity.py @@ -10,7 +10,10 @@ to the preset's classic ones) and `generate-structures`. Each case starts vanilla's server and Horizon's (`horizon-client --dedicated --nogui`) in a new folder, waits for `Done` and stops them. Compared exactly: the world's `data/minecraft/world_gen_settings.dat`, tag types included, and the warnings and errors logged while the world's settings are read (the `Worker-Main` lines; -the worker's number is left out). +the worker's number is left out). In a world without structures (`generate-structures=false`), also what +`locate structure` answers on the console for a village and a mineshaft (ChunkGenerator.findNearestMapStructure +finds none) and how many of the saved chunks hold structure starts or references (none: +ChunkStatusTasks.generateStructureStarts does nothing). Horizon generates the normal and flat presets only: `large_biomes`, `amplified`, `single_biome_surface` and `debug_all_block_states` aren't tested. @@ -23,6 +26,7 @@ import re import shutil import subprocess import sys +import time try: from . import anvil_dump, lab, test_rust_parity as base @@ -60,6 +64,32 @@ CASES = { 'unknown': {'level-type': 'Some Type', 'level-seed': '42'}, } WORKER = re.compile(r'\[Worker-Main-\d+/(WARN|ERROR)\]: (.*)') +LOCATE = ['locate structure #minecraft:village', 'locate structure minecraft:mineshaft'] +REPLY = re.compile(r'\]: (?:System chat: )?((?:Could not find|The nearest|Unknown|Incorrect).*)') + + +def console_reply(server, command, timeout=300): + """The first command reply the console logs after `command`.""" + start = len(server.lines) + server.console(command) + deadline = time.time() + timeout + while time.time() < deadline: + for line in server.lines[start:]: + if m := REPLY.search(line): + return m.group(1) + time.sleep(0.2) + raise AssertionError(f'no reply to {command!r} in {timeout} s:\n' + '\n'.join(server.lines[-20:])) + + +def structure_chunks(world): + """How many saved overworld chunks hold structure starts, and how many references.""" + starts = references = 0 + for region in sorted((world / 'region').glob('*.mca')): + for chunk in anvil_dump.region_chunks(region).values(): + structures = anvil_dump.plain(chunk, True).get('structures', {}) + starts += bool(structures.get('starts')) + references += bool(structures.get('References')) + return f'chunks with structure starts: {starts}, with references: {references}' def escape(value): @@ -77,11 +107,16 @@ def run_case(label, command, build, case): encoding='iso-8859-1') (directory / 'eula.txt').write_text('eula=true\n') server = Server(command, directory, f'{label}-{case}') + replies = [] try: server.wait_for(r'Done \(') + if CASES[case].get('generate-structures') == 'false': + replies = [f'{c}: {console_reply(server, c)}' for c in LOCATE] finally: server.stop() - out = [f'# {case}'] + out = [f'# {case}', *replies] + if replies: + out.append(structure_chunks(directory / 'world')) out += [f'{m.group(1)}: {m.group(2)}' for l in server.lines if (m := WORKER.search(l))] settings = anvil_dump.plain(anvil_dump.read_dat(directory / 'world/data/minecraft/world_gen_settings.dat'), True, typed=True) @@ -121,7 +156,8 @@ def main(): java=subprocess.check_output(['java', '--version'], text=True).splitlines()[0], cases=list(CASES), lines=len(vanilla), output_sha256=lab.digest(build / 'horizon.txt', 'sha256'), scope='a new dedicated-server world: level-type (flat, normal, unknown), a flat world\'s ' - 'generator-settings, generate-structures, as world_gen_settings.dat and the lines logged.')) + 'generator-settings, generate-structures, as world_gen_settings.dat and the lines logged; without ' + 'structures, locate structure\'s replies and the saved chunks\' structure starts and references.')) print(f'server world gen: {len(CASES)} cases, {len(vanilla)} lines identical') From 9a2d87ec9708d417d6fa4e19fa99110da8e78e39 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 02:14:03 +0200 Subject: [PATCH 049/163] fix(server): move players to another dimension with execute in ... run tp On a dedicated server, `execute in <dimension> run tp @s ...` from a player moved them inside the level they were in. It now does what vanilla's TeleportCommand does: ServerPlayer.teleport into the other level, with the Respawn packet keeping all data and no portal sound, then the feedback. The players there are tracked to them and they are removed from the ones they left. tools/test_server_dimension_players_parity.py joins two players to a vanilla and a Horizon server and compares, step by step, the players each is sent and loses and the dimensions it respawns into, while they go to the Nether and the End by command and through an End portal. LocatorBarClient gains `players on` and `still NAME` (the position reminder a still client sends). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game.rs | 3 + .../horizon-client/src/game/command_blocks.rs | 1 + crates/horizon-client/src/game/commands.rs | 16 ++ .../src/game/commands/execute.rs | 7 + crates/horizon-client/src/game/lan_actions.rs | 2 + .../horizon-client/src/game/server_travel.rs | 55 ++++++- crates/horizon-client/src/lan/hub.rs | 27 +++- .../horizonlab/parity/LocatorBarClient.java | 38 ++++- tools/test_server_dimension_players_parity.py | 150 ++++++++++++++++++ 9 files changed, 287 insertions(+), 12 deletions(-) create mode 100644 tools/test_server_dimension_players_parity.py diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index e126c533a..7d3e5c56b 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -984,6 +984,8 @@ struct Game<'a> { /// A server's players on their way to another level, each waiting for /// the destination to load around them. server_trips: Vec<server_travel::Trip>, + /// Players a command sends to another level, once it has run. + level_teleports: Vec<server_travel::LevelTeleport>, /// A server's levels other than the one in place (game/levels.rs). levels: levels::Levels, /// Which pass of a server tick runs (`tick_server`): the first one reads @@ -10295,6 +10297,7 @@ impl<'a> Game<'a> { world_root: PathBuf::new(), travelling: None, server_trips: Vec::new(), + level_teleports: Vec::new(), levels: Default::default(), level_pass: Default::default(), portals: Default::default(), diff --git a/crates/horizon-client/src/game/command_blocks.rs b/crates/horizon-client/src/game/command_blocks.rs index 5a5fa11c8..f85be2fd3 100644 --- a/crates/horizon-client/src/game/command_blocks.rs +++ b/crates/horizon-client/src/game/command_blocks.rs @@ -357,6 +357,7 @@ impl Game<'_> { silent: false, store: None, elsewhere: false, + level: None, block: Some(pos), }; // performPrefixedCommand: a leading slash is allowed. diff --git a/crates/horizon-client/src/game/commands.rs b/crates/horizon-client/src/game/commands.rs index 3ca938d6a..e0a0d1204 100644 --- a/crates/horizon-client/src/game/commands.rs +++ b/crates/horizon-client/src/game/commands.rs @@ -1124,7 +1124,23 @@ impl Game<'_> { (-(dy.atan2(horizontal).to_degrees())) as f32, ]); } + // `execute in` another dimension: a server's player moves to that + // level (ServerPlayer.teleport into another level), after the command. + let level = self + .command_source + .and_then(|s| s.level) + .filter(|d| *d != self.dim && self.options.dedicated.is_some()); for &t in &targets { + if let (Some(dim), Target::Player, Some(conn)) = (level, t, self.lan_acting) { + self.level_teleports + .push(super::server_travel::LevelTeleport { + conn, + dim, + at: pos, + rotation, + }); + continue; + } self.teleport_to(t, pos, rotation); } let [x, y, z] = pos.map(|v| Text::literal(format_double(v))); diff --git a/crates/horizon-client/src/game/commands/execute.rs b/crates/horizon-client/src/game/commands/execute.rs index 1fa67c8b6..01488db2c 100644 --- a/crates/horizon-client/src/game/commands/execute.rs +++ b/crates/horizon-client/src/game/commands/execute.rs @@ -26,6 +26,9 @@ pub(in crate::game) struct Source { /// `execute in` another dimension than the one Horizon has loaded: none /// of its chunks are loaded. pub elsewhere: bool, + /// The dimension `execute in` named, if any: a server teleports its + /// players there (`TeleportCommand` into the source's level). + pub level: Option<super::super::Dim>, /// The command block whose output this source is /// (`BaseCommandBlock.CloseableCommandBlockSource`). pub block: Option<(i32, i32, i32)>, @@ -77,6 +80,7 @@ impl Game<'_> { silent: false, store: None, elsewhere: false, + level: None, block: None, } } @@ -90,6 +94,7 @@ impl Game<'_> { silent: true, store: None, elsewhere: false, + level: None, block: None, } } @@ -441,6 +446,7 @@ impl Game<'_> { pos: self.target_position(t)?, rot: self.target_rotation(t), elsewhere: false, + level: None, ..s }) }) @@ -544,6 +550,7 @@ impl Game<'_> { } vec![Source { elsewhere: dim != self.dim.id(), + level: Some(super::super::Dim::from_id(dim)), ..s }] } diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index 68b29a360..eba49f2d0 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -928,6 +928,8 @@ impl Game<'_> { .map(|t| horizon_client::lan::data::component_nbt(&t.component())) .collect::<Vec<_>>() }); + // A teleport into another level happens before its feedback is sent. + self.run_level_teleports(host); for content in lines.unwrap_or_default() { host.hub.send_to( conn, diff --git a/crates/horizon-client/src/game/server_travel.rs b/crates/horizon-client/src/game/server_travel.rs index 6312254c7..6c0ec48e7 100644 --- a/crates/horizon-client/src/game/server_travel.rs +++ b/crates/horizon-client/src/game/server_travel.rs @@ -22,6 +22,17 @@ pub(super) struct Trip { end: bool, /// The Nether portal plan, whose exit is found or built on arrival. plan: Option<Plan>, + /// Sent by a command: the player is already where it goes. + placed: bool, +} + +/// `TeleportCommand` into another level for a server's player: where, and +/// the rotation it sets (none keeps the player's). +pub(super) struct LevelTeleport { + pub conn: u32, + pub dim: Dim, + pub at: [f64; 3], + pub rotation: Option<[f32; 2]>, } /// A player's box: Player's standing dimensions. @@ -177,7 +188,8 @@ impl Game<'_> { }; let at = [destination.x, destination.y, destination.z]; let ctx = self.server_ctx(); - host.hub.change_level(i, at, yaw, &ctx); + // TeleportTransition.PLAY_PORTAL_SOUND. + host.hub.change_level(i, at, yaw, None, true, &ctx); self.as_guest(host, conn, |g| g.trigger_dimension(source, target)); self.server_trips.push(Trip { conn, @@ -185,6 +197,7 @@ impl Game<'_> { target: destination, end, plan, + placed: false, }); if let Err(e) = self.enter_level(Some(host), source) { log::error!("could not reopen {}: {e}", source.id()); @@ -214,6 +227,9 @@ impl Game<'_> { continue; } let trip = self.server_trips.remove(k); + if trip.placed { + continue; + } self.resolve_arrivals(); let yaw = host.hub.guests[i].yaw; let (position, yaw) = if trip.end { @@ -248,6 +264,43 @@ impl Game<'_> { } } + /// The players the command just run sends to another level + /// (`ServerPlayer.teleport` from TeleportCommand): a Respawn packet + /// keeping all data and the teleport, with no portal sound. The server + /// leaves the body alone until the level has loaded around it. + pub(super) fn run_level_teleports(&mut self, host: &mut LanHost) { + for t in std::mem::take(&mut self.level_teleports) { + let Some(i) = host.hub.guests.iter().position(|g| g.conn == t.conn) else { + continue; + }; + let source = self.dim; + if let Err(e) = self.enter_level(Some(host), t.dim) { + log::error!("could not open {}: {e}", t.dim.id()); + continue; + } + let g = &mut host.hub.guests[i]; + let [yaw, pitch] = t.rotation.unwrap_or([g.yaw, g.pitch]); + // A new body there: no fall distance or motion carried over. + g.motion = None; + let ctx = self.server_ctx(); + host.hub + .change_level(i, t.at, yaw, Some(pitch), false, &ctx); + self.as_guest(host, t.conn, |g| g.trigger_dimension(source, t.dim)); + self.server_trips.retain(|trip| !trip.is(t.conn)); + self.server_trips.push(Trip { + conn: t.conn, + dim: t.dim, + target: Vec3::new(t.at[0], t.at[1], t.at[2]), + end: false, + plan: None, + placed: true, + }); + if let Err(e) = self.enter_level(Some(host), source) { + log::error!("could not reopen {}: {e}", source.id()); + } + } + } + /// The hub's view of the server for packets sent outside its own tick. pub(super) fn server_ctx(&mut self) -> TickCtx<'_> { let spawn = self.spawn.map_or([0.5, 80.0, 0.5], |s| [s.x, s.y, s.z]); diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index b18187835..bb4eea345 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -2199,7 +2199,15 @@ impl Hub { /// names (`set_dimension`): ClientboundRespawnPacket keeping all data, /// then vanilla's packet order. Nothing tracked in the old level is /// removed one by one: the client drops its whole level. - pub fn change_level(&mut self, i: usize, at: [f64; 3], yaw: f32, ctx: &TickCtx) { + pub fn change_level( + &mut self, + i: usize, + at: [f64; 3], + yaw: f32, + pitch: Option<f32>, + portal_sound: bool, + ctx: &TickCtx, + ) { let mode = self.guests[i].game_mode; let info = self.spawn_info(mode); self.close_container_for(i); @@ -2210,6 +2218,9 @@ impl Hub { g.chunk_queue.clear(); g.center = None; g.yaw = yaw; + if let Some(pitch) = pitch { + g.pitch = pitch; + } g.position = at; g.previous_position = at; g.send(&C::Respawn(play::Respawn { @@ -2241,12 +2252,14 @@ impl Hub { // ServerPlayer.sendPostEffects. g.send(&raw(ids::POST_EFFECTS, vec![0])); // TeleportTransition.PLAY_PORTAL_SOUND. - g.send(&C::LevelEvent(play::LevelEvent { - kind: 1032, - pos: [0, 0, 0], - data: 0, - global: false, - })); + if portal_sound { + g.send(&C::LevelEvent(play::LevelEvent { + kind: 1032, + pos: [0, 0, 0], + data: 0, + global: false, + })); + } // lastSentExp, lastSentHealth and lastSentFood. g.sent_health = None; g.sent_xp = None; diff --git a/mods/horizon/src/test/java/dev/horizonlab/parity/LocatorBarClient.java b/mods/horizon/src/test/java/dev/horizonlab/parity/LocatorBarClient.java index e41c693ee..a29b95231 100644 --- a/mods/horizon/src/test/java/dev/horizonlab/parity/LocatorBarClient.java +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/LocatorBarClient.java @@ -76,11 +76,16 @@ import net.minecraft.world.phys.Vec3; * line at a time: {@code step LABEL} (the label the next packets are recorded * under), {@code join NAME}, {@code cmd NAME COMMAND...}, {@code shift NAME * on|off} (the shift key, as ServerboundPlayerInputPacket), {@code fly NAME - * on|off} (ServerboundPlayerAbilitiesPacket), {@code quit NAME} and {@code - * end}, which writes each player's lines to OUT. + * on|off} (ServerboundPlayerAbilitiesPacket), {@code still NAME} (the + * position reminder LocalPlayer.sendPosition sends every 20 ticks standing + * still), {@code quit NAME}, {@code + * players on|off} (whether each player also records the other players added + * to and removed from its level, and its own respawns into a dimension) and + * {@code end}, which writes each player's lines to OUT. */ public final class LocatorBarClient { private static volatile String step = "start"; + private static volatile boolean players; private static final Map<UUID, String> NAMES = new LinkedHashMap<>(); public static void main(String[] args) throws Exception { @@ -110,7 +115,9 @@ public final class LocatorBarClient { abilities.flying = w[2].equals("on"); players.get(w[1]).send(new net.minecraft.network.protocol.game.ServerboundPlayerAbilitiesPacket(abilities)); } + case "still" -> players.get(w[1]).still(); case "quit" -> players.get(w[1]).close(); + case "players" -> LocatorBarClient.players = w[1].equals("on"); case "end" -> { try (PrintWriter out = new PrintWriter(Files.newBufferedWriter(output, StandardCharsets.UTF_8))) { for (Player p : players.values()) { @@ -166,8 +173,10 @@ public final class LocatorBarClient { private int threshold = -1; private ProtocolInfo<?> inbound; private ProtocolInfo<?> outbound; - private PositionMoveRotation position = new PositionMoveRotation(Vec3.ZERO, Vec3.ZERO, 0, 0); + private volatile PositionMoveRotation position = new PositionMoveRotation(Vec3.ZERO, Vec3.ZERO, 0, 0); private boolean loaded; + /** The other players this one was sent, by entity id. */ + private final Map<Integer, String> seen = new java.util.HashMap<>(); private final Object replyLock = new Object(); private int replies; @@ -198,6 +207,14 @@ public final class LocatorBarClient { } } + void still() throws Exception { + PositionMoveRotation at = position; + // A tick of its own: the server takes one position per client tick (receivedPositionThisTick). + send(net.minecraft.network.protocol.game.ServerboundClientTickEndPacket.INSTANCE); + send(new ServerboundMovePlayerPacket.PosRot(at.position(), at.yRot(), at.xRot(), false, false)); + send(net.minecraft.network.protocol.game.ServerboundClientTickEndPacket.INSTANCE); + } + void close() throws Exception { if (socket != null) socket.close(); } @@ -266,7 +283,20 @@ public final class LocatorBarClient { while (true) { Received r = read(); Packet<?> p = r.packet; - if (p instanceof ClientboundTrackedWaypointPacket) { + if (p instanceof net.minecraft.network.protocol.game.ClientboundAddEntityPacket a + && a.getType() == net.minecraft.world.entity.EntityTypes.PLAYER) { + String who = NAMES.getOrDefault(a.getUUID(), "uuid?"); + seen.put(a.getId(), who); + if (players) record("add " + who + " at " + a.getX() + "," + a.getY() + "," + a.getZ()); + } else if (p instanceof net.minecraft.network.protocol.game.ClientboundRemoveEntitiesPacket rm) { + rm.entityIds().forEach(id -> { + String who = seen.remove(id); + if (who != null && players) record("remove " + who); + }); + } else if (p instanceof net.minecraft.network.protocol.game.ClientboundRespawnPacket rs) { + if (players) record("respawn " + rs.commonPlayerSpawnInfo().dimension().identifier()); + seen.clear(); + } else if (p instanceof ClientboundTrackedWaypointPacket) { record(waypoint(r.payload)); } else if (p instanceof ClientboundSystemChatPacket) { synchronized (replyLock) { diff --git a/tools/test_server_dimension_players_parity.py b/tools/test_server_dimension_players_parity.py new file mode 100644 index 000000000..77e1428e9 --- /dev/null +++ b/tools/test_server_dimension_players_parity.py @@ -0,0 +1,150 @@ +#!/usr/bin/env python3 +"""Players in different dimensions on a dedicated server, against vanilla's, seen by vanilla clients. + +A vanilla dedicated server and Horizon's (`horizon-client --dedicated --nogui`) each serve a copy of one flat +world vanilla generated first, with Alice and Bob as operators in creative. LocatorBarClient joins them both +(players made of vanilla's protocol code) and records, step by step, the other players each is sent and loses +(ClientboundAddEntityPacket, ClientboundRemoveEntitiesPacket) and the dimensions it respawns into +(ClientboundRespawnPacket), with the locator bar's waypoints, while they change dimensions (ServerPlayer.teleport +through `execute in ... run tp`, and an End portal): Bob goes to the Nether and back, Alice to the End, Bob +follows her there, both come back to the Overworld, then Bob steps into an End portal and comes back. Between +the steps each client sends its position (the reminder a still client sends every second). Each player's lines in each step are compared exactly. +""" +import os +from pathlib import Path +import platform +import shutil +import subprocess +import sys +import time + +try: + from . import lab, test_rust_parity as base + from .test_dedicated_server_parity import Server + from .test_locator_bar_parity import generate_world, server_dir +except ImportError: + import lab + import test_rust_parity as base + from test_dedicated_server_parity import Server + from test_locator_bar_parity import generate_world, server_dir + +NAME = 'server-dimension-players-parity' +NETHER, END, OVERWORLD = 'minecraft:the_nether', 'minecraft:the_end', 'minecraft:overworld' +# (label, what the players do). +SCRIPT = [ + ('bob-nether', [f'cmd Bob execute in {NETHER} run tp @s 0.5 100 0.5']), + ('bob-back', [f'cmd Bob execute in {OVERWORLD} run tp @s 2.5 100 0.5']), + ('alice-end', [f'cmd Alice execute in {END} run tp @s 0.5 100 0.5']), + ('bob-end', [f'cmd Bob execute in {END} run tp @s 2.5 100 0.5']), + ('alice-back', [f'cmd Alice execute in {OVERWORLD} run tp @s 0.5 100 0.5']), + ('bob-back-again', [f'cmd Bob execute in {OVERWORLD} run tp @s 2.5 100 0.5']), + # Through an End portal (Entity.handlePortal), and back by command. + ('bob-portal', ['cmd Bob setblock 2 101 3 minecraft:end_portal', 'cmd Bob tp @s 2.5 101 3.5']), + ('bob-portal-back', [f'cmd Bob execute in {OVERWORLD} run tp @s 2.5 100 0.5']), +] +STEP_SECONDS = 5.0 + + +def run_side(label, server_command, client_command, build, world): + directory = build / label + port = server_dir(directory, world) + out = build / f'{label}.txt' + out.unlink(missing_ok=True) + server = Server(server_command, directory, label) + try: + server.wait_for(r'Done \(') + with (build / f'{label}-client.log').open('w') as log: + client = subprocess.Popen([*map(str, client_command), '127.0.0.1', str(port), str(out)], + cwd=lab.ROOT, stdin=subprocess.PIPE, stdout=log, stderr=subprocess.STDOUT, + text=True) + + def tell(line): + client.stdin.write(line + '\n') + client.stdin.flush() + try: + tell('players on') + tell('step joins') + for name, x in (('Alice', 0.5), ('Bob', 2.5)): + tell(f'join {name}') + server.wait_for(rf'{name} joined the game', timeout=120) + tell(f'fly {name} on') + tell(f'cmd {name} tp @s {x} 100 0.5') + time.sleep(STEP_SECONDS) + for step, actions in SCRIPT: + tell(f'step {step}') + for action in actions: + tell(action) + # Standing still, a client still sends its position every 20 ticks + # (LocalPlayer.sendPosition): the server then tracks to it what it has sent the + # chunks of since (ChunkMap.move). + time.sleep(STEP_SECONDS / 2) + tell('still Alice') + tell('still Bob') + time.sleep(STEP_SECONDS / 2) + tell('end') + client.wait(timeout=60) + finally: + if client.poll() is None: + client.kill() + finally: + server.stop() + if not out.exists(): + raise AssertionError(f'{label}: the client wrote no transcript (see {build}/{label}-client.log)') + return out.read_text(encoding='utf-8').splitlines() + + +def shown(lines): + """Each player's adds, removes and respawns, without the waypoints (the locator bar harness has those).""" + return [l for l in lines if l.split(' ', 2)[2:3] and l.split(' ', 2)[2].split(' ')[0] in ('add', 'remove', 'respawn')] + + +def main(): + lock, jars, libraries = base.verify_artifacts() + build = lab.LOCAL / NAME + build.mkdir(parents=True, exist_ok=True) + report = build / 'report.json' + report.unlink(missing_ok=True) + oracle = lab.ROOT / 'mods/horizon/src/test/java/dev/horizonlab/parity/LocatorBarClient.java' + classes = build / 'classes' + shutil.rmtree(classes, ignore_errors=True) + classes.mkdir() + dependencies = os.pathsep.join(map(str, [jars['server'], *libraries])) + subprocess.run(['javac', '--release', str(lock['minecraft']['java_major']), '-proc:none', '-nowarn', '-sourcepath', + lab.ROOT / 'mods/horizon/src/test/java', '-cp', dependencies, '-d', classes, oracle], + cwd=lab.ROOT, check=True, capture_output=True) + subprocess.run(['cargo', 'build', '--release', '-p', 'horizon-client', '--bin', 'horizon-client'], cwd=lab.ROOT, + check=True, capture_output=True) + import json + metadata = json.loads(subprocess.check_output(['cargo', 'metadata', '--no-deps', '--format-version', '1'], + cwd=lab.ROOT, text=True)) + binary = Path(metadata['target_directory']) / 'release' / ('horizon-client.exe' if os.name == 'nt' else 'horizon-client') + vanilla_server = ['java', '-Xmx2g', '-Duser.timezone=UTC', '-cp', dependencies, 'net.minecraft.server.Main', 'nogui'] + horizon_server = [binary, '--resources', lab.LOCAL / 'horizon-client/26.3', '--dedicated', '--nogui'] + client = ['java', '-Xmx1g', '-cp', str(classes) + os.pathsep + dependencies, 'dev.horizonlab.parity.LocatorBarClient'] + + world = generate_world(vanilla_server, build) + vanilla_all = run_side('vanilla', vanilla_server, client, build, world) + horizon_all = run_side('horizon', horizon_server, client, build, world) + errors = [l for l in vanilla_all + horizon_all if ' error ' in f' {l} ' or 'disconnected' in l] + vanilla, horizon = shown(vanilla_all), shown(horizon_all) + if errors or vanilla != horizon: + import difflib + diff = '\n'.join(difflib.unified_diff(vanilla, horizon, 'vanilla', 'horizon', n=1, lineterm='')) + raise AssertionError(f'{len(errors)} errors, transcripts differ (see {build}/vanilla.txt and horizon.txt):\n' + + '\n'.join(errors[:10]) + '\n' + diff[:6000]) + if sum(' respawn ' in l for l in vanilla) < 6: + raise AssertionError(f'vanilla sent too few respawns: the script did not run (see {build})') + lab.write_json(report, dict( + schema=1, minecraft=lock['minecraft']['version'], platform=platform.platform(), + java=subprocess.check_output(['java', '--version'], text=True).splitlines()[0], + lines=len(vanilla), output_sha256=lab.digest(build / 'horizon.txt', 'sha256'), + scope='Two players on a dedicated server changing dimensions (Nether, End, back): the other players each ' + 'is sent and loses, and the dimensions it respawns into.')) + print(f'server dimension players: {len(vanilla)} lines identical') + + +if __name__ == '__main__': + try: + main() + except AssertionError as error: + sys.exit(f'{NAME}: {error}') From 4ac29bf1c14e7785fa1c33f5e0aceaaef0aa9c4c Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 02:15:47 +0200 Subject: [PATCH 050/163] docs(hosting): players travel between dimensions on their own Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- docs/hosting.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/hosting.md b/docs/hosting.md index f07983484..bb5d6db4d 100644 --- a/docs/hosting.md +++ b/docs/hosting.md @@ -22,8 +22,11 @@ plan are in [docs/server.md](https://github.com/ludovic111/horizon/blob/main/doc (Tailscale, ZeroTier), or share it only with friends you trust. - **No secure chat.** Chat isn't signed, and `enforce-secure-profile` has no effect. Vanilla clients show chat from the server as not secure. -- **Nether and End:** the world follows a player through portals when they are alone on the server - (v2026.10.17.09 and newer). With several players online, portals don't move remote players yet. +- **Nether and End:** each player travels on their own through portals, and operators with `execute in + <dimension> run tp`. The players in the level they leave stop seeing them, and the ones in the level they + arrive in start to, as on vanilla (checked against vanilla with two players, by command and through an End + portal: `tools/test_server_dimension_players_parity.py`). The console can't send another player to a + dimension yet (`execute in ... run tp NAME`). - **Movement checks and chunk pacing** (release v2026.10.17.16 and newer). The server pulls back players who move too fast ("moved too quickly"), as vanilla does, and sends chunks as fast as each client acknowledges them. From 209b898c029a9161f232392c2d9dd775d0cd5069 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 01:05:10 +0200 Subject: [PATCH 051/163] The console's and players' command feedback reaches the operators CommandSourceStack.broadcastToAdmins beyond a guest on a dedicated server: - The dedicated server's console tells every operator what its commands did, as `[Server: ...]`, when `broadcast-console-to-ops` is on (DedicatedServer.shouldInformAdmins). This covers the game's commands and the dedicated-only ones vanilla broadcasts (op, deop, ban, pardon, kick, whitelist, save-all, save-on/off, stop). - In a world open to LAN, the host, an operator when commands are allowed, hears of its guests' commands, and op guests hear of the host's. - A player's name in the line is their display name, with the `/tell` suggestion, the entity hover and the insertion (Player.getDisplayName). New harness test_server_ops_feedback_parity: two vanilla-codec operators' system chat while the console and one of them run commands, deop and op, toggle send_command_feedback and save, with broadcast-console-to-ops on and off. LocatorBarClient can record system chat (`chat on`). lan_e2e's feedback check also asserts the host is told. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game.rs | 5 + crates/horizon-client/src/game/commands.rs | 62 +++++-- crates/horizon-client/src/game/dedicated.rs | 55 +++++- crates/horizon-client/src/game/lan.rs | 4 + crates/horizon-client/src/game/lan_actions.rs | 19 +- crates/horizon-client/src/text.rs | 12 ++ .../horizonlab/parity/LocatorBarClient.java | 14 +- tools/lan_e2e.py | 9 +- tools/test_server_ops_feedback_parity.py | 162 ++++++++++++++++++ 9 files changed, 313 insertions(+), 29 deletions(-) create mode 100644 tools/test_server_ops_feedback_parity.py diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index e126c533a..da46d57b4 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -1155,6 +1155,10 @@ struct Game<'a> { /// returns: the line, whether operators get it and whether the console /// logs it. admin_feedback: Vec<(horizon_client::text::Text, bool, bool)>, + /// The server console is running a command: whether its feedback goes to + /// the operators (`DedicatedServer.shouldInformAdmins`, + /// `broadcast-console-to-ops`). + console_broadcast: Option<bool>, /// State of `/spectate`, `/posteffect`, `/debug`, `/waypoint` and friends. cmds: commands::extra::CommandExtras, ui: chat::UiState, @@ -10403,6 +10407,7 @@ impl<'a> Game<'a> { lan_acting_uuid: None, chat_capture: None, admin_feedback: Vec::new(), + console_broadcast: None, cmds: Default::default(), ui: Default::default(), combat: Default::default(), diff --git a/crates/horizon-client/src/game/commands.rs b/crates/horizon-client/src/game/commands.rs index 3ca938d6a..9126eea7e 100644 --- a/crates/horizon-client/src/game/commands.rs +++ b/crates/horizon-client/src/game/commands.rs @@ -165,14 +165,20 @@ impl Game<'_> { } self.broadcast_to_admins(message); } - /// CommandSourceStack.broadcastToAdmins, for a guest's command on a - /// dedicated server (`sendSuccess` with `broadcast`): `[name: message]`, - /// gray and italic, for the other operators when `send_command_feedback` - /// and the console when `log_admin_commands`. Queued while the guest acts; - /// `send_admin_feedback` sends it. - fn broadcast_to_admins(&mut self, message: Text) { - if self.lan_acting.is_none() - || self.options.dedicated.is_none() + /// CommandSourceStack.broadcastToAdmins (`sendSuccess` with `broadcast`) + /// for a guest's command, the host's in a world open to LAN and the + /// dedicated server console's when `broadcast-console-to-ops` is on: + /// `[name: message]`, gray and italic, for the other operators when + /// `send_command_feedback`, and for a player's command on a dedicated + /// server the console when `log_admin_commands`. Queued while the + /// command runs; `send_admin_feedback` sends it. + pub(super) fn broadcast_to_admins(&mut self, message: Text) { + let informs = match self.console_broadcast { + Some(broadcast) => broadcast, + // While a guest acts the host's LanHost is out of `self.lan`. + None => self.lan_acting.is_some() || self.lan.is_some(), + }; + if !informs || message .translation_key() .is_some_and(|k| admin::QUIET.contains(&k)) @@ -180,20 +186,46 @@ impl Game<'_> { return; } let ops = self.ui.rules.bool("send_command_feedback"); - let console = self.ui.rules.bool("log_admin_commands"); + // MinecraftServer.sendSystemMessage, unless the server is the source. + let console = self.console_broadcast.is_none() + && self.lan_acting.is_some() + && self.options.dedicated.is_some() + && self.ui.rules.bool("log_admin_commands"); if !ops && !console { return; } - // getDisplayName: the entity the command runs as (`execute as`). - let who = self - .command_source - .and_then(|s| s.entity) - .unwrap_or(Target::Player); - let line = Text::translate("chat.type.admin", &[self.target_name(who), message]) + // getDisplayName: the entity the command runs as (`execute as`), or + // the server's own source, "Server". + let who = match self.command_source.and_then(|s| s.entity) { + Some(entity) => self.target_name(entity), + None if self.console_broadcast.is_some() => Text::literal("Server".to_owned()), + None => self.player_display_name(), + }; + let line = Text::translate("chat.type.admin", &[who, message]) .with_color(text::GRAY) .italic(); self.admin_feedback.push((line, ops, console)); } + /// Player.getDisplayName: the name (team-formatted), suggesting a + /// `/tell`, showing the player on hover, inserting the name. + fn player_display_name(&self) -> Text { + let name = self.acting_player_name().to_owned(); + let Some(uuid) = self.lan_acting_uuid else { + return self.target_name(Target::Player); + }; + self.target_name(Target::Player).with_component_fields(vec![ + ( + "click_event".into(), + serde_json::json!({"action": "suggest_command", "command": format!("/tell {name} ")}), + ), + ( + "hover_event".into(), + serde_json::json!({"action": "show_entity", "id": "minecraft:player", + "uuid": horizon_protocol::crypto::uuid_string(uuid), "name": name}), + ), + ("insertion".into(), name.into()), + ]) + } fn source_position(&self) -> [f64; 3] { if let Some(s) = &self.command_source { return s.pos; diff --git a/crates/horizon-client/src/game/dedicated.rs b/crates/horizon-client/src/game/dedicated.rs index 49b77eb13..7348f3f9e 100644 --- a/crates/horizon-client/src/game/dedicated.rs +++ b/crates/horizon-client/src/game/dedicated.rs @@ -402,8 +402,32 @@ struct ServerState { /// When the last passes of the loop ended, for the tick rate horizon-server shows. ticks: std::collections::VecDeque<Instant>, paused: bool, + /// `broadcast-console-to-ops`. + broadcast_console: bool, } +/// The dedicated-only commands' replies vanilla sends with `broadcast` +/// (`sendSuccess(..., true)`): the operators hear of them. +const BROADCAST: &[&str] = &[ + "commands.ban.success", + "commands.banip.info", + "commands.banip.success", + "commands.deop.success", + "commands.kick.success", + "commands.op.success", + "commands.pardon.success", + "commands.pardonip.success", + "commands.save.disabled", + "commands.save.enabled", + "commands.save.success", + "commands.stop.stopping", + "commands.whitelist.add.success", + "commands.whitelist.disabled", + "commands.whitelist.enabled", + "commands.whitelist.reloaded", + "commands.whitelist.remove.success", +]; + impl Game<'_> { /// DedicatedServer.initServer and MinecraftServer.runServer. pub(super) fn run_dedicated(&mut self) -> Result<()> { @@ -612,6 +636,7 @@ impl Game<'_> { empty_ticks: 0, ticks: Default::default(), paused: false, + broadcast_console: props.broadcast_console_to_ops, }; let pause_after = props.pause_when_empty_seconds * 20; let idle_timeout = props.player_idle_timeout; @@ -619,7 +644,7 @@ impl Game<'_> { while !state.stop { let tick_start = Instant::now(); while let Ok(line) = state.console.try_recv() { - self.console_command(&mut state, &line); + self.console_line(&mut state, &line); } self.poll_server_control(&mut state); let players = self.lan.as_ref().map_or(0, |h| h.hub.guests.len()); @@ -767,14 +792,36 @@ impl Game<'_> { }) }); if found.is_none() { - self.console_reply(Text::translate("argument.player.unknown", &[])); + let unknown = Text::translate("argument.player.unknown", &[]); + log("INFO", &format!("System chat: {}", unknown.plain())); } found } - /// MinecraftServer.sendSystemMessage: what the console is told. - fn console_reply(&self, text: Text) { + /// MinecraftServer.sendSystemMessage: what the console is told; while + /// the console runs a command, the replies vanilla broadcasts go to the + /// operators too. + fn console_reply(&mut self, text: Text) { log("INFO", &format!("System chat: {}", text.plain())); + if self.console_broadcast.is_some() + && text + .translation_key() + .is_some_and(|k| BROADCAST.contains(&k)) + { + self.broadcast_to_admins(text); + } + } + + /// One console line, then the operators' share of its feedback. + fn console_line(&mut self, state: &mut ServerState, line: &str) { + self.console_broadcast = Some(state.broadcast_console); + self.console_command(state, line); + self.console_broadcast = None; + if let Some(mut host) = self.lan.take() { + self.send_admin_feedback(&mut host, None); + self.lan = Some(host); + } + self.admin_feedback.clear(); } /// DedicatedServer.handleConsoleInputs: one console line, run as the diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index 57c7b9ee0..2921f41fb 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -780,6 +780,10 @@ impl Game<'_> { }; // What the tick sends a guest goes to its connection at the end. let holding = lan::Holding::start(); + // The host's own commands' broadcastToAdmins lines. + if !self.admin_feedback.is_empty() { + self.send_admin_feedback(&mut host, None); + } let state = self.lan_host_state(&host); // A dedicated server runs the hub without a host player. if state.is_some() || host.hub.config.dedicated { diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index 68b29a360..beec8718b 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -725,7 +725,7 @@ impl Game<'_> { }), ); } - self.send_admin_feedback(host, conn); + self.send_admin_feedback(host, Some(conn)); } } S::Unknown(8, payload) => { @@ -937,13 +937,19 @@ impl Game<'_> { }), ); } - self.send_admin_feedback(host, conn); + self.send_admin_feedback(host, Some(conn)); } - /// The `broadcastToAdmins` lines a guest's command queued: every other + /// The `broadcastToAdmins` lines a command queued (`source`: the guest + /// whose it was; none for the host's or the console's): every other /// operator gets them, and the console logs them as the server's own /// system messages (MinecraftServer.sendSystemMessage). - fn send_admin_feedback(&mut self, host: &mut LanHost, source: u32) { + pub(super) fn send_admin_feedback(&mut self, host: &mut LanHost, source: Option<u32>) { + // PlayerList.isOp for the host of a world open to LAN: the owner when + // the world allows commands, everyone when the LAN does. + let host_op = source.is_some() + && !host.hub.config.dedicated + && (self.allow_commands() || host.hub.config.guest_commands); for (line, ops, console) in std::mem::take(&mut self.admin_feedback) { if ops { let content = horizon_client::lan::data::component_nbt(&line.component()); @@ -951,13 +957,16 @@ impl Game<'_> { .hub .guests .iter() - .filter(|g| g.conn != source && g.permission > 0) + .filter(|g| Some(g.conn) != source && g.permission > 0) { g.send(&C::SystemChat(play::SystemChat { content: content.clone(), overlay: false, })); } + if host_op { + self.system_message(line.clone()); + } } if console { super::dedicated::log("INFO", &format!("System chat: {}", line.plain())); diff --git a/crates/horizon-client/src/text.rs b/crates/horizon-client/src/text.rs index e0b144714..ea11d4163 100644 --- a/crates/horizon-client/src/text.rs +++ b/crates/horizon-client/src/text.rs @@ -267,6 +267,18 @@ impl Text { _ => c, } } + /// Style fields the spans don't model (an entity hover, an insertion), + /// set on the component sent to vanilla only. + pub fn with_component_fields(mut self, fields: Vec<(String, Value)>) -> Self { + let mut c = self.component(); + if let Value::Object(o) = &mut c { + for (k, v) in fields { + o.entry(k).or_insert(v); + } + } + self.source = Some(c.into()); + self + } pub fn with_color(self, color: u32) -> Self { self.with_style(&Style::color(color)) } diff --git a/mods/horizon/src/test/java/dev/horizonlab/parity/LocatorBarClient.java b/mods/horizon/src/test/java/dev/horizonlab/parity/LocatorBarClient.java index e41c693ee..2127657d4 100644 --- a/mods/horizon/src/test/java/dev/horizonlab/parity/LocatorBarClient.java +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/LocatorBarClient.java @@ -76,11 +76,13 @@ import net.minecraft.world.phys.Vec3; * line at a time: {@code step LABEL} (the label the next packets are recorded * under), {@code join NAME}, {@code cmd NAME COMMAND...}, {@code shift NAME * on|off} (the shift key, as ServerboundPlayerInputPacket), {@code fly NAME - * on|off} (ServerboundPlayerAbilitiesPacket), {@code quit NAME} and {@code - * end}, which writes each player's lines to OUT. + * on|off} (ServerboundPlayerAbilitiesPacket), {@code quit NAME}, {@code chat + * on|off} (whether the system chat each player receives is recorded too, as + * component JSON) and {@code end}, which writes each player's lines to OUT. */ public final class LocatorBarClient { private static volatile String step = "start"; + private static volatile boolean chat; private static final Map<UUID, String> NAMES = new LinkedHashMap<>(); public static void main(String[] args) throws Exception { @@ -111,6 +113,7 @@ public final class LocatorBarClient { players.get(w[1]).send(new net.minecraft.network.protocol.game.ServerboundPlayerAbilitiesPacket(abilities)); } case "quit" -> players.get(w[1]).close(); + case "chat" -> chat = w[1].equals("on"); case "end" -> { try (PrintWriter out = new PrintWriter(Files.newBufferedWriter(output, StandardCharsets.UTF_8))) { for (Player p : players.values()) { @@ -268,7 +271,12 @@ public final class LocatorBarClient { Packet<?> p = r.packet; if (p instanceof ClientboundTrackedWaypointPacket) { record(waypoint(r.payload)); - } else if (p instanceof ClientboundSystemChatPacket) { + } else if (p instanceof ClientboundSystemChatPacket c) { + if (chat) { + record("chat " + (c.overlay() ? "overlay " : "") + net.minecraft.network.chat.ComponentSerialization.CODEC + .encodeStart(ParityData.access.createSerializationContext(com.mojang.serialization.JsonOps.INSTANCE), c.content()) + .getOrThrow()); + } synchronized (replyLock) { replies++; replyLock.notifyAll(); diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index b1e7ec098..9ab2ddc3f 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -30,7 +30,8 @@ address. The script then checks, from both sides, what a guest's game used to ge tree (Tab), and runs what it completed; - recipes: the guest's recipe book lists the planks recipe the logs unlock, and clicking it places a log in the inventory's crafting grid (the server places it). -- feedback: the guest's command feedback names the guest and shows the numbers. +- feedback: the guest's command feedback names the guest and shows the numbers, and the host (an + operator) is told of it as `[Guest: ...]`. - clicks: with real mouse presses (not click-slot, which skips the screen's press and drag handling), the guest puts a stack into a chest and a furnace, drags planks across its crafting grid and gathers a stack with a double click; the server has each. @@ -688,6 +689,8 @@ def check_feedback(host, guest, out): guest('command', command=f'tp @s {x:.1f} {y:.1f} {z:.1f}') guest.wait(10) chat = guest.raw('messages', 5)['chat'] + # The host is an operator: broadcastToAdmins tells it, as `[Guest: ...]`. + host_chat = host.raw('messages', 5)['chat'] guest.raw('key', 't', 'tap') guest.wait(5) guest.shot(out, 'feedback') @@ -698,7 +701,9 @@ def check_feedback(host, guest, out): assert any(replaced in line for line in chat), f'no "{replaced}" in {chat}' assert any(line.startswith(f'Teleported {GUEST_NAME} to {x:.6f}') for line in chat), f'teleport feedback: {chat}' assert screen in (None, 'playing'), f'the chat did not close: {screen}' - return chat + told = f'[{GUEST_NAME}: Teleported {GUEST_NAME} to {x:.6f}' + assert any(line.startswith(told) for line in host_chat), f'no "{told}" for the host: {host_chat}' + return chat + host_chat def chat_input(game): diff --git a/tools/test_server_ops_feedback_parity.py b/tools/test_server_ops_feedback_parity.py new file mode 100644 index 000000000..2dd405517 --- /dev/null +++ b/tools/test_server_ops_feedback_parity.py @@ -0,0 +1,162 @@ +#!/usr/bin/env python3 +"""Command feedback the operators get on a dedicated server (`[Server: ...]`), against vanilla's. + +CommandSourceStack.broadcastToAdmins: a command's success that vanilla sends with `broadcast` goes, gray and +italic as `[name: message]`, to every other operator while `send_command_feedback` is on, including the +console's own commands when `broadcast-console-to-ops` is (DedicatedServer.shouldInformAdmins). + +A vanilla dedicated server and Horizon's (`horizon-client --dedicated --nogui`) each serve a copy of one flat +world vanilla generated first, with the same server.properties and Alice and Bob as operators. LocatorBarClient +joins them both (players made of vanilla's protocol code) and records the system chat each receives while, step +by step, the console sets the time, asks for the difficulty (a query, told to nobody), whitelists a player, +deops Bob (who stops hearing of it) and ops him again, turns `send_command_feedback` off and on and saves, and +Alice runs a command herself (Bob hears of it as an operator). Then again with `broadcast-console-to-ops=false`. +Each player's chat in each step is compared exactly. +""" +import os +from pathlib import Path +import platform +import shutil +import subprocess +import sys +import time + +try: + from . import lab, test_rust_parity as base + from .test_dedicated_server_parity import Server + from .test_locator_bar_parity import generate_world, server_dir +except ImportError: + import lab + import test_rust_parity as base + from test_dedicated_server_parity import Server + from test_locator_bar_parity import generate_world, server_dir + +NAME = 'server-ops-feedback-parity' +# (label, what the console does, what the players do). +BROADCAST = [ + ('console-time', ['time set 1000'], []), + ('console-query', ['difficulty'], []), + ('console-whitelist', ['whitelist add Alice'], []), + ('console-deop', ['deop Bob'], []), + ('bob-not-op', ['time set 2000'], []), + ('alice-bob-not-op', [], ['cmd Alice time set 3000']), + ('console-op', ['op Bob'], []), + ('alice-bob-op', [], ['cmd Alice time set 4000']), + ('feedback-off', ['gamerule send_command_feedback false'], []), + ('console-feedback-off', ['time set 5000'], []), + ('feedback-on', ['gamerule send_command_feedback true'], []), + ('console-save', ['save-all'], []), +] +QUIET = [ + ('console-time', ['time set 1000'], []), + ('console-whitelist', ['whitelist add Alice'], []), + ('alice', [], ['cmd Alice time set 3000']), +] +CASES = {'broadcast': ({}, BROADCAST), 'quiet': ({'broadcast-console-to-ops': 'false'}, QUIET)} +STEP_SECONDS = 2.0 + + +def run_side(label, case, server_command, client_command, build, world): + properties, script = CASES[case] + directory = build / label / case + directory.parent.mkdir(parents=True, exist_ok=True) + port = server_dir(directory, world) + with (directory / 'server.properties').open('a', encoding='iso-8859-1') as f: + f.writelines(f'{k}={v}\n' for k, v in properties.items()) + out = build / f'{label}-{case}.txt' + out.unlink(missing_ok=True) + server = Server(server_command, directory, f'{label}-{case}') + try: + server.wait_for(r'Done \(') + with (build / f'{label}-{case}-client.log').open('w') as log: + client = subprocess.Popen([*map(str, client_command), '127.0.0.1', str(port), str(out)], + cwd=lab.ROOT, stdin=subprocess.PIPE, stdout=log, stderr=subprocess.STDOUT, + text=True) + + def tell(line): + client.stdin.write(line + '\n') + client.stdin.flush() + try: + for name in ('Alice', 'Bob'): + tell(f'join {name}') + server.wait_for(rf'{name} joined the game', timeout=120) + time.sleep(STEP_SECONDS) + tell('chat on') + for step, console, actions in script: + tell(f'step {step}') + for command in console: + server.console(command) + for action in actions: + tell(action) + time.sleep(STEP_SECONDS) + tell('end') + client.wait(timeout=60) + finally: + if client.poll() is None: + client.kill() + finally: + server.stop() + if not out.exists(): + raise AssertionError(f'{label} {case}: the client wrote no transcript (see {build}/{label}-{case}-client.log)') + lines = out.read_text(encoding='utf-8').splitlines() + errors = [l for l in lines if ' error ' in f' {l} ' or 'disconnected' in l] + return [f'{case} {l}' for l in lines if l.split(' ', 2)[2:3] and l.split(' ', 2)[2].startswith('chat ')], errors + + +def main(): + lock, jars, libraries = base.verify_artifacts() + build = lab.LOCAL / NAME + build.mkdir(parents=True, exist_ok=True) + report = build / 'report.json' + report.unlink(missing_ok=True) + oracle = lab.ROOT / 'mods/horizon/src/test/java/dev/horizonlab/parity/LocatorBarClient.java' + classes = build / 'classes' + shutil.rmtree(classes, ignore_errors=True) + classes.mkdir() + dependencies = os.pathsep.join(map(str, [jars['server'], *libraries])) + subprocess.run(['javac', '--release', str(lock['minecraft']['java_major']), '-proc:none', '-nowarn', '-sourcepath', + lab.ROOT / 'mods/horizon/src/test/java', '-cp', dependencies, '-d', classes, oracle], + cwd=lab.ROOT, check=True, capture_output=True) + subprocess.run(['cargo', 'build', '--release', '-p', 'horizon-client', '--bin', 'horizon-client'], cwd=lab.ROOT, + check=True, capture_output=True) + import json + metadata = json.loads(subprocess.check_output(['cargo', 'metadata', '--no-deps', '--format-version', '1'], + cwd=lab.ROOT, text=True)) + binary = Path(metadata['target_directory']) / 'release' / ('horizon-client.exe' if os.name == 'nt' else 'horizon-client') + vanilla_server = ['java', '-Xmx2g', '-Duser.timezone=UTC', '-cp', dependencies, 'net.minecraft.server.Main', 'nogui'] + horizon_server = [binary, '--resources', lab.LOCAL / 'horizon-client/26.3', '--dedicated', '--nogui'] + client = ['java', '-Xmx1g', '-cp', str(classes) + os.pathsep + dependencies, 'dev.horizonlab.parity.LocatorBarClient'] + + world = generate_world(vanilla_server, build) + sides = {'vanilla': ([], []), 'horizon': ([], [])} + for case in CASES: + for label, command in [('vanilla', vanilla_server), ('horizon', horizon_server)]: + lines, errors = run_side(label, case, command, client, build, world) + sides[label][0].extend(lines) + sides[label][1].extend(errors) + (vanilla, vanilla_errors), (horizon, horizon_errors) = sides['vanilla'], sides['horizon'] + (build / 'vanilla.txt').write_text('\n'.join(vanilla) + '\n', encoding='utf-8') + (build / 'horizon.txt').write_text('\n'.join(horizon) + '\n', encoding='utf-8') + errors = vanilla_errors + horizon_errors + if errors or vanilla != horizon: + import difflib + diff = '\n'.join(difflib.unified_diff(vanilla, horizon, 'vanilla', 'horizon', n=1, lineterm='')) + raise AssertionError(f'{len(errors)} errors, transcripts differ (see {build}/vanilla.txt and horizon.txt):\n' + + '\n'.join(errors[:10]) + '\n' + diff[:6000]) + if sum('[Server' in l or 'chat.type.admin' in l for l in vanilla) < 5: + raise AssertionError(f'vanilla sent the operators too little: the script did not run (see {build})') + lab.write_json(report, dict( + schema=1, minecraft=lock['minecraft']['version'], platform=platform.platform(), + java=subprocess.check_output(['java', '--version'], text=True).splitlines()[0], + lines=len(vanilla), output_sha256=lab.digest(build / 'horizon.txt', 'sha256'), + scope='The system chat two operators get on a dedicated server while the console and one of them run ' + 'commands: broadcastToAdmins for the console (broadcast-console-to-ops on and off) and a player, ' + 'queries, deop and op, send_command_feedback off and on, and save-all.')) + print(f'server ops feedback: {len(vanilla)} chat lines identical') + + +if __name__ == '__main__': + try: + main() + except AssertionError as error: + sys.exit(f'{NAME}: {error}') From 118bfa2be2a9cf85961fdccfa6d9afca117aedf3 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 02:26:13 +0200 Subject: [PATCH 052/163] fix(game): finish every consumable as vanilla's Consumable.onConsume Follow-up to #773 (consume effects on food): - ApplyStatusEffectsConsumeEffect always draws its float and skips the effects when the draw is >= probability (#773 skipped the draw at 1.0 and applied on <=). - on_consume_effects run for every consumable, not only food: milk can be drunk (clear_all_effects, then the bucket), honey removes poison and leaves its glass bottle, stews their bowl (UseRemainder). - The consumable's own timing, sound, animation and particles (consume_seconds, sound, has_consume_particles) through horizon-world's Consumable.emit, in vanilla's draw order; FoodProperties.onConsume's sound and burp; the used statistic; the eat or drink game event after the effects. - teleport_randomly (chorus fruit) through horizon-world's verified TeleportConsume port, with LivingEntity.randomTeleport for the player (border clamp, entities_can_teleport_to ground, collision and liquid checks), the teleport game event and sound, level event 2017's directional particles and entity event 46's portal particles. - tools/agent_control_e2e.py: a consume scenario (golden apple at full hunger, milk, honey, chorus fruit). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game.rs | 105 +++--- crates/horizon-client/src/game/consume.rs | 330 ++++++++++++++++++ .../src/game/level_particles.rs | 12 +- crates/horizon-client/src/game/remote.rs | 19 +- crates/horizon-client/src/items.rs | 89 ++++- crates/horizon-client/src/motion.rs | 3 +- crates/horizon-client/src/particles.rs | 42 ++- tools/agent_control_e2e.py | 50 ++- 8 files changed, 568 insertions(+), 82 deletions(-) create mode 100644 crates/horizon-client/src/game/consume.rs diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index e126c533a..6c4cfa4ce 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -24,6 +24,7 @@ mod command_blocks; mod command_harness; mod commands; mod composter; +mod consume; mod control; mod copper_golems; mod creaking; @@ -1203,6 +1204,21 @@ impl Dim { _ => Self::Overworld, } } + /// `Level.getMinY`: the dimension type's minimum y. + fn min_y(self) -> i32 { + match self { + Self::Overworld => MIN_Y, + Self::Nether | Self::End => 0, + } + } + /// `DimensionType.logicalHeight`. + fn logical_height(self) -> i32 { + match self { + Self::Overworld => HEIGHT, + Self::Nether => 128, + Self::End => 256, + } + } /// `Level.getMaxY`: the dimension type's minimum y plus height, less one. fn max_y(self) -> i32 { match self { @@ -1977,6 +1993,11 @@ impl Game<'_> { pos, data, } => self.dragon_egg_particles([pos.x, pos.y, pos.z], data), + LevelEvent::LevelEvent { + id: 2017, + pos, + data, + } => self.consume_teleport_particles([pos.x, pos.y, pos.z], data), LevelEvent::LevelEvent { id: 2013, pos, @@ -2756,15 +2777,15 @@ impl Game<'_> { } Ok(true) } - /// `Consumable.startConsuming` for held food the player can eat - /// (`Player.canEat`): the right click is held for `consume_seconds`. + /// `Consumable.startConsuming` for a held consumable: food needs + /// `Player.canEat` (`Consumable.canConsume`), anything else is always + /// consumed. The right click is held for `consume_seconds`. fn start_eating(&mut self, info: &horizon_client::items::ItemInfo) -> bool { - if !info.consumable - || info.food.is_none() - || !self - .player - .as_ref() - .is_some_and(|p| info.can_always_eat || p.health.food.food < 20 || self.creative) + if info.consumable.is_none() + || (info.food.is_some() + && !self.player.as_ref().is_some_and(|p| { + info.can_always_eat || p.health.food.food < 20 || self.creative + })) { return false; } @@ -2773,18 +2794,17 @@ impl Game<'_> { } true } - fn apply_consume_effect( - &mut self, - effect: &horizon_client::items::ConsumeEffect, - eye: [f64; 3], - ) { + fn apply_consume_effect(&mut self, effect: &horizon_client::items::ConsumeEffect) { use horizon_client::items::ConsumeEffect; match effect { ConsumeEffect::ApplyEffects { effects, probability, } => { - if *probability >= 1.0 || self.world.random.next_float() <= *probability { + // ApplyStatusEffectsConsumeEffect.apply: the user's random + // (the level's stands in, as for every player draw) is drawn + // even at probability 1. + if self.world.random.next_float() < *probability { for eff in effects { if let Some(def) = horizon_client::brewing::effect(&eff.id) { if def.instant { @@ -2817,9 +2837,14 @@ impl Game<'_> { } self.apply_effect_status(); } - ConsumeEffect::TeleportRandomly => {} + ConsumeEffect::TeleportRandomly(teleport) => self.teleport_randomly(teleport), ConsumeEffect::PlaySound(sound) => { - self.audio.play(sound, Some(eye), 1.0, 1.0); + // PlaySoundConsumeEffect: at the user's block position. + let at = self.player.as_ref().map(|p| { + let b = horizon_core::position::BlockPos::containing(p.position); + [b.x, b.y, b.z].map(|v| f64::from(v) + 0.5) + }); + self.audio.play(sound, at, 1.0, 1.0); } } } @@ -2901,49 +2926,21 @@ impl Game<'_> { } return; } - let duration = 32; - // Consumable.shouldEmitParticlesAndSounds(useItemRemainingTicks), with - // the remaining ticks before this tick counts down: every 4 ticks once - // more than 21.875% of the time has passed (none on the last tick). + let Some(consumable) = info.consumable.as_ref() else { + self.using = None; + return; + }; + // ItemStack.onUseTick: Consumable.shouldEmitParticlesAndSounds with + // the remaining ticks before this tick counts them down. + let duration = consumable.ticks().max(0) as u32; let remaining = duration - ticks.min(duration); let ticks = ticks + 1; - let eye = self.eye_position().unwrap_or_default(); - if duration - remaining > (duration as f32 * 0.21875) as u32 && remaining % 4 == 0 { - let pitch = - (self.world.random.next_float() - self.world.random.next_float()) * 0.2 + 1.0; - self.audio.play( - "minecraft:entity.generic.eat", - Some(eye), - 0.5 + 0.5 * self.world.random.next_int_bound(2).unwrap_or(0) as f32, - pitch, - ); - self.eat_particles(&stack, 5); + if consumable.should_emit(remaining as i32) { + self.emit_consume(consumable, &stack, 5); } if ticks >= duration { self.using = None; - // Consumable.onConsume: emitParticlesAndSounds(..., 16). - self.eat_particles(&stack, 16); - // Consumable.onConsume. - self.post_entity_event("minecraft:eat", horizon_client::mobs::Who::Player); - if let Some((nutrition, saturation)) = info.food { - if let Some(p) = self.player.as_mut() { - // FoodData.eat(nutrition, saturation) - let food = &mut p.health.food; - food.food = (food.food + nutrition as i32).clamp(0, 20); - food.saturation = (food.saturation + saturation).clamp(0.0, food.food as f32); - } - self.audio.play( - "minecraft:entity.player.burp", - Some(eye), - 0.5, - self.world.random.next_float() * 0.1 + 0.9, - ); - for effect in &info.consume_effects { - self.apply_consume_effect(effect, eye); - } - self.trigger_item("minecraft:consume_item", &stack); - self.consume_held(); - } + self.finish_consuming(&info, consumable, &stack); } else { self.using = Some((slot, ticks)); } diff --git a/crates/horizon-client/src/game/consume.rs b/crates/horizon-client/src/game/consume.rs new file mode 100644 index 000000000..b2fe15c82 --- /dev/null +++ b/crates/horizon-client/src/game/consume.rs @@ -0,0 +1,330 @@ +//! Finishing a consumable (`Consumable.onConsume` and the use remainder), +//! its particles and sounds, and `TeleportRandomlyConsumeEffect` (chorus +//! fruit) for the local player. The level random stands in for the player's +//! own, as for every other player draw. +use super::{Dim, Game}; +use horizon_client::{ + items::{ConsumeEffect, ItemInfo, ItemStack}, + mobs::Who, + particles::{ParticleOptions, ParticleType}, +}; +use horizon_core::{ + geometry::Vec3, position::BlockPos, random::LegacyRandom, random::RandomSource, +}; +use horizon_world::{ + consumable::{Consumable, EmissionWorld, UseAnimation}, + teleport_consume::{TeleportConsume, TeleportConsumeWorld}, +}; +use std::convert::Infallible; + +type ItemConsumable = Consumable<String, ConsumeEffect>; + +impl Game<'_> { + /// `Consumable.emitParticlesAndSounds(user.getRandom(), user, stack, count)`. + pub(super) fn emit_consume( + &mut self, + consumable: &ItemConsumable, + stack: &ItemStack, + count: i32, + ) { + let Ok(()) = consumable.emit(&mut Emitter(self), (), stack.clone(), count); + } + /// `LivingEntity.completeUsingItem` for a consumable: `Consumable.onConsume`, + /// then `ItemStack.applyAfterUseComponentSideEffects`' use remainder. + pub(super) fn finish_consuming( + &mut self, + info: &ItemInfo, + consumable: &ItemConsumable, + stack: &ItemStack, + ) { + self.emit_consume(consumable, stack, 16); + // ServerPlayer: the used statistic and the consume_item trigger. + self.stats.add("used", &stack.item, 1); + self.trigger_item("minecraft:consume_item", stack); + // FoodProperties.onConsume, the player's one ConsumableListener. + if let Some((nutrition, saturation)) = info.food { + let at = self.feet(); + let pitch = self.world.random.triangle_float(1.0, 0.4); + self.audio.play(&consumable.sound, at, 1.0, pitch); + if let Some(p) = self.player.as_mut() { + // FoodData.eat(nutrition, saturation) + let food = &mut p.health.food; + food.food = (food.food + nutrition as i32).clamp(0, 20); + food.saturation = (food.saturation + saturation).clamp(0.0, food.food as f32); + } + // Mth.randomBetween(random, 0.9, 1.0) + let pitch = self.world.random.next_float() * (1.0f32 - 0.9f32) + 0.9; + self.audio + .play("minecraft:entity.player.burp", self.feet(), 0.5, pitch); + } + for effect in &consumable.effects { + self.apply_consume_effect(effect); + } + let event = if consumable.animation == UseAnimation::Drink { + "minecraft:drink" + } else { + "minecraft:eat" + }; + self.post_entity_event(event, Who::Player); + // ItemStack.consume, then UseRemainder.convertIntoRemainder: nothing + // with infinite materials, the hand when emptied, else the inventory + // (ServerPlayer.handleExtraItemsCreatedOnUse) or a drop. + self.consume_held(); + if let Some(remainder) = &info.use_remainder + && !self.creative + { + let remainder = ItemStack::new(remainder, 1); + if self.held().is_none() { + *self.held_mut() = Some(remainder); + } else if let Some(rest) = self.give(remainder) { + self.player_drop(rest); + } + } + } + fn feet(&self) -> Option<[f64; 3]> { + self.player + .as_ref() + .map(|p| [p.position.x, p.position.y, p.position.z]) + } + /// `TeleportRandomlyConsumeEffect.apply` for the local player. + pub(super) fn teleport_randomly(&mut self, teleport: &TeleportConsume) { + if self.player.is_none() { + return; + } + let dim = self.dim; + let Ok(_) = teleport.apply(&mut Teleporter(self), dim); + } + /// `LivingEntity.randomTeleport(x, y, z, true, avoid)`: down to the first + /// block entities can teleport onto, inside the border, in a loaded chunk. + fn random_teleport(&mut self, target: Vec3, avoid: &str) -> bool { + let [min_x, min_z, max_x, max_z] = self.border.bounds(); + // WorldBorder.clampVec3ToBound (Mth.clamp, 1.0E-5F inside the far edge). + let clamp = |v: f64, low: f64, high: f64| if v < low { low } else { v.min(high) }; + let x = clamp(target.x, min_x, max_x - f64::from(1.0e-5_f32)); + let z = clamp(target.z, min_z, max_z - f64::from(1.0e-5_f32)); + let mut y = target.y; + let mut pos = BlockPos::containing(Vec3::new(x, y, z)); + if !self.world.loaded(pos.x, pos.z) { + return false; + } + while pos.y > self.dim.min_y() { + pos.y -= 1; + let state = self.world.block(pos.x, pos.y, pos.z); + if self.state_in_tag("minecraft:entities_can_teleport_to", state) { + return self.check_position_and_teleport(Vec3::new(x, y, z), state, avoid); + } + y -= 1.0; + } + false + } + /// `LivingEntity.checkPositionAndTeleport`, then `ServerPlayer.teleportTo` + /// (the motion and rotation kept) and entity event 46. + fn check_position_and_teleport( + &mut self, + at: Vec3, + ground: horizon_world::registry::BlockStateId, + avoid: &str, + ) -> bool { + if self.state_in_tag(avoid, ground) { + return false; + } + let entities = self.happy_ghast_player_collisions(); + let Some(player) = self.player.as_mut() else { + return false; + }; + let bounds = player.dimensions.bounds(at); + let free = horizon_client::motion::MotionWorld { + entities: &entities, + player, + scene: &mut self.world, + assets: &self.pack.assets, + collision_binding: self.collision, + resources: self.motion, + } + .no_player_collision(bounds) + .unwrap_or(false); + // LevelReader.containsAnyLiquid and findBlocksIn: the blocks from the + // box's minimum corner to the one holding its maximum corner. + let (lo, hi) = ( + BlockPos::containing(bounds.min_position()), + BlockPos::containing(bounds.max_position()), + ); + let blocks = (lo.x..=hi.x) + .flat_map(|x| (lo.y..=hi.y).flat_map(move |y| (lo.z..=hi.z).map(move |z| (x, y, z)))); + let states: Vec<_> = blocks.map(|(x, y, z)| self.world.block(x, y, z)).collect(); + let liquid = states + .iter() + .any(|&s| self.res.facts.get(s).fluid != horizon_client::blocks::Fluid::None); + if !free || liquid || states.iter().any(|&s| self.state_in_tag(avoid, s)) { + return false; + } + if let Some(p) = self.player.as_mut() { + p.position = at; + } + // The position packet moves the old position along (absolute xyz). + self.previous_position = at; + self.portal_particles(); + true + } + fn state_in_tag(&self, tag: &str, state: horizon_world::registry::BlockStateId) -> bool { + let name = &self.res.facts.get(state).name; + self.res + .items + .block_tags + .get(tag) + .is_some_and(|s| s.contains(&**name)) + } + /// `LivingEntity.handleEntityEvent(46)`: 128 portal particles from the old + /// to the new position, from the client player's random (the particle + /// engine's here). + fn portal_particles(&mut self) { + let Some(p) = self.player.as_ref() else { + return; + }; + let (from, to) = (self.previous_position, p.position); + let (width, height) = ( + f64::from(p.dimensions.width), + f64::from(p.dimensions.height), + ); + let options = ParticleOptions::simple(ParticleType::Portal); + for i in 0..128 { + let d = f64::from(i) / 127.0; + let r = self.particles.random(); + let v = [0; 3].map(|_| f64::from((r.next_float() - 0.5) * 0.2)); + let x = from.x + d * (to.x - from.x) + (r.next_double() - 0.5) * width * 2.0; + let y = from.y + d * (to.y - from.y) + r.next_double() * height; + let z = from.z + d * (to.z - from.z) + (r.next_double() - 0.5) * width * 2.0; + self.particles.add(&options, [x, y, z], v); + } + } + /// `LivingEntity.stopRiding`. + pub(super) fn stop_riding(&mut self) { + let Some(id) = self.riding else { + return; + }; + if let Some(i) = self.boats.iter().position(|b| b.id == id) { + self.dismount(i); + } else if let Some(i) = self.carts.iter().position(|c| c.id == id) { + self.dismount_cart(i); + } else { + self.dismount_mount(); + } + } +} + +/// `Consumable.emitParticlesAndSounds` against the local player. +struct Emitter<'a, 'g>(&'a mut Game<'g>); +impl EmissionWorld for Emitter<'_, '_> { + type Error = Infallible; + type Stack = ItemStack; + type Sound = String; + type Random = (); + type Source = LegacyRandom; + fn random_source(&mut self, (): ()) -> &mut LegacyRandom { + &mut self.0.world.random + } + /// `LivingEntity.spawnItemParticles`. + fn spawn_item_particles(&mut self, stack: ItemStack, count: i32) -> Result<(), Infallible> { + self.0.eat_particles(&stack, count.max(0) as u32); + Ok(()) + } + fn overrides_consume_sound(&self) -> bool { + false + } + fn consume_sound(&mut self, _: ItemStack) -> Result<String, Infallible> { + unreachable!("players play the consumable's own sound") + } + /// `Entity.playSound`: at the player's position. + fn play_sound(&mut self, sound: String, volume: f32, pitch: f32) -> Result<(), Infallible> { + let at = self.0.feet(); + self.0.audio.play(&sound, at, volume, pitch); + Ok(()) + } +} + +/// The local player as `TeleportRandomlyConsumeEffect`'s user. +struct Teleporter<'a, 'g>(&'a mut Game<'g>); +impl Teleporter<'_, '_> { + fn at(&self) -> Vec3 { + self.0.player.as_ref().map_or(Vec3::ZERO, |p| p.position) + } +} +impl TeleportConsumeWorld for Teleporter<'_, '_> { + type Error = Infallible; + type Level = Dim; + type Random = (); + type Source = LegacyRandom; + fn position_field(&self) -> Vec3 { + self.at() + } + fn get_random(&mut self) -> Result<(), Infallible> { + Ok(()) + } + fn random_source(&mut self, (): ()) -> &mut LegacyRandom { + &mut self.0.world.random + } + fn min_y(&mut self, level: Dim) -> Result<i32, Infallible> { + Ok(level.min_y()) + } + fn logical_height(&mut self, level: Dim) -> Result<i32, Infallible> { + Ok(level.logical_height()) + } + fn is_passenger(&mut self) -> Result<bool, Infallible> { + Ok(self.0.riding.is_some()) + } + fn stop_riding(&mut self) -> Result<(), Infallible> { + self.0.stop_riding(); + Ok(()) + } + fn position(&mut self) -> Result<Vec3, Infallible> { + Ok(self.at()) + } + fn random_teleport(&mut self, target: Vec3) -> Result<bool, Infallible> { + Ok(self + .0 + .random_teleport(target, "minecraft:consumable_does_not_teleport_to")) + } + fn teleport_event(&mut self, _: Dim, old: Vec3) -> Result<(), Infallible> { + let ctx = self.0.who_context(Some(Who::Player), None); + self.0 + .post_game_event("minecraft:teleport", [old.x, old.y, old.z], ctx); + Ok(()) + } + fn is_fox(&self) -> bool { + false + } + fn teleport_sound(&mut self, _: Dim, at: Vec3, _: bool) -> Result<(), Infallible> { + self.0.audio.play( + "minecraft:item.chorus_fruit.teleport", + Some([at.x, at.y, at.z]), + 1.0, + 1.0, + ); + Ok(()) + } + fn block_position(&mut self) -> Result<BlockPos, Infallible> { + Ok(BlockPos::containing(self.at())) + } + fn directional_particles( + &mut self, + _: Dim, + origin: BlockPos, + offset: i32, + ) -> Result<(), Infallible> { + self.0 + .level_event_at(2017, [origin.x, origin.y, origin.z], offset); + Ok(()) + } + fn reset_fall_distance(&mut self) -> Result<(), Infallible> { + if let Some(p) = self.0.player.as_mut() { + p.fall_distance = 0.0; + } + Ok(()) + } + fn reset_impulse(&mut self) -> Result<(), Infallible> { + if let Some(p) = self.0.player.as_mut() { + p.impulse.reset(); + } + Ok(()) + } +} diff --git a/crates/horizon-client/src/game/level_particles.rs b/crates/horizon-client/src/game/level_particles.rs index 4516ce7dd..47d06254d 100644 --- a/crates/horizon-client/src/game/level_particles.rs +++ b/crates/horizon-client/src/game/level_particles.rs @@ -1,6 +1,7 @@ //! Level events whose client handler (`LevelEventHandler`) spawns particles -//! on a block: dragon egg teleportation (2015), electric sparks (3002), -//! waxing (3003), wax off (3004) and scraping (3005). +//! on a block: dragon egg teleportation (2015), a consumable's teleport +//! (2017), electric sparks (3002), waxing (3003), wax off (3004) and +//! scraping (3005). use super::Game; use horizon_client::particles::{self, ParticleOptions, ParticleType}; use horizon_core::position::BlockPos; @@ -9,7 +10,12 @@ use horizon_world::level::LevelEvent; impl Game<'_> { pub(super) fn dragon_egg_particles(&mut self, pos: [i32; 3], data: i32) { self.particles - .block_teleportation(pos, data, self.settings.particles); + .block_teleportation(pos, data, [16, 8, 16], self.settings.particles); + } + /// Event 2017: `TeleportRandomlyConsumeEffect`'s directional particles. + pub(super) fn consume_teleport_particles(&mut self, pos: [i32; 3], data: i32) { + self.particles + .block_teleportation(pos, data, [127, 127, 127], self.settings.particles); } /// `LevelEventHandler.levelEvent` 3002 to 3005, drawing from the client /// level's random. diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 991bc42b2..afb190ed9 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -1204,6 +1204,9 @@ impl Game<'_> { C::LevelEvent(p) if p.kind == 2015 => { self.dragon_egg_particles(p.pos, p.data); } + C::LevelEvent(p) if p.kind == 2017 => { + self.consume_teleport_particles(p.pos, p.data); + } C::LevelEvent(p) if p.kind == 2001 => { // LevelEvent.PARTICLES_DESTROY_BLOCK: someone else broke a block. let state = BlockStateId(p.data.max(0) as u32); @@ -2901,7 +2904,7 @@ impl Game<'_> { } } } - /// `LivingEntity.updatingUsingItem` for food on a server client: the + /// `LivingEntity.updatingUsingItem` for a consumable on a server client: the /// eating animation and its crumbs. The server eats it and sends the /// stack, the hunger and the sounds. fn remote_tick_using(&mut self) { @@ -2909,11 +2912,11 @@ impl Game<'_> { return; }; let stack = self.stack_in(slot).cloned(); - let food = stack + let consumable = stack .as_ref() .and_then(|s| self.res.items.get(&s.item)) - .is_some_and(|i| i.consumable && i.food.is_some()); - let (Some(stack), true) = (stack, food) else { + .and_then(|i| i.consumable.clone()); + let (Some(stack), Some(consumable)) = (stack, consumable) else { self.using = None; return; }; @@ -2922,14 +2925,16 @@ impl Game<'_> { return; } // Consumable.shouldEmitParticlesAndSounds, as in tick_used_item. - let duration = 32; + let duration = consumable.ticks().max(0) as u32; let remaining = duration - ticks.min(duration); - if duration - remaining > (duration as f32 * 0.21875) as u32 && remaining % 4 == 0 { + if consumable.particles && consumable.should_emit(remaining as i32) { self.eat_particles(&stack, 5); } if ticks + 1 >= duration { self.using = None; - self.eat_particles(&stack, 16); + if consumable.particles { + self.eat_particles(&stack, 16); + } } else { self.using = Some((slot, ticks + 1)); } diff --git a/crates/horizon-client/src/items.rs b/crates/horizon-client/src/items.rs index 2782d254f..d6bd854a8 100644 --- a/crates/horizon-client/src/items.rs +++ b/crates/horizon-client/src/items.rs @@ -54,7 +54,8 @@ pub enum ConsumeEffect { }, ClearAllEffects, RemoveEffects(Vec<String>), - TeleportRandomly, + /// `TeleportRandomlyConsumeEffect`. + TeleportRandomly(horizon_world::teleport_consume::TeleportConsume), PlaySound(String), } @@ -69,8 +70,10 @@ pub struct ItemInfo { pub tool_default_speed: f32, pub food: Option<(u32, f32)>, pub can_always_eat: bool, - pub consumable: bool, - pub consume_effects: Vec<ConsumeEffect>, + /// `consumable`: its timing, sound, particles and `on_consume_effects`. + pub consumable: Option<horizon_world::consumable::Consumable<String, ConsumeEffect>>, + /// `use_remainder`: what a finished use leaves (`UseRemainder`). + pub use_remainder: Option<String>, pub model: String, /// Main-hand `attack_damage` / `attack_speed` modifier amounts. pub attack_damage: f32, @@ -504,7 +507,18 @@ impl Items { consume_effects.push(ConsumeEffect::RemoveEffects(targets)); } Some("minecraft:teleport_randomly") => { - consume_effects.push(ConsumeEffect::TeleportRandomly); + consume_effects.push(ConsumeEffect::TeleportRandomly( + horizon_world::teleport_consume::TeleportConsume { + diameter: effect + .get("diameter") + .and_then(Value::as_f64) + .map_or(16.0, |d| d as f32), + directional_particles: effect + .get("directional_particles") + .and_then(Value::as_bool) + .unwrap_or(true), + }, + )); } Some("minecraft:play_sound") => { if let Some(sound) = effect.get("sound").and_then(|s| s.as_str()) { @@ -530,8 +544,22 @@ impl Items { .unwrap_or(1.0) as f32, food, can_always_eat, - consumable: c.get("minecraft:consumable").is_some(), - consume_effects, + // Consumable.CODEC's defaults. + consumable: c.get("minecraft:consumable").map(|cons| { + horizon_world::consumable::Consumable { + seconds: cons["consume_seconds"].as_f64().map_or(1.6, |s| s as f32), + animation: crate::first_person::consumable_animation(cons), + sound: cons["sound"] + .as_str() + .unwrap_or("minecraft:entity.generic.eat") + .to_owned(), + particles: cons["has_consume_particles"].as_bool().unwrap_or(true), + effects: std::mem::take(&mut consume_effects), + } + }), + use_remainder: c["minecraft:use_remainder"]["id"] + .as_str() + .map(str::to_owned), model: c["minecraft:item_model"] .as_str() .unwrap_or(name) @@ -1607,18 +1635,63 @@ mod tests { let apple = items.get("minecraft:golden_apple").expect("golden apple"); assert!(apple.can_always_eat); assert!(apple.food.is_some()); - assert!(!apple.consume_effects.is_empty()); + assert!(!apple.consumable.as_ref().unwrap().effects.is_empty()); let enchanted = items .get("minecraft:enchanted_golden_apple") .expect("enchanted golden apple"); assert!(enchanted.can_always_eat); assert!(enchanted.food.is_some()); - assert!(!enchanted.consume_effects.is_empty()); + assert!(!enchanted.consumable.as_ref().unwrap().effects.is_empty()); let beef = items.get("minecraft:cooked_beef").expect("cooked beef"); assert!(!beef.can_always_eat); assert!(beef.food.is_some()); + + // Consumables without food, their style and their remainders. + use horizon_world::consumable::UseAnimation; + let milk = items.get("minecraft:milk_bucket").expect("milk bucket"); + let drink = milk.consumable.as_ref().unwrap(); + assert!(milk.food.is_none()); + assert_eq!(drink.effects, [ConsumeEffect::ClearAllEffects]); + assert_eq!((drink.ticks(), drink.animation), (32, UseAnimation::Drink)); + assert_eq!(drink.sound, "minecraft:entity.generic.drink"); + assert!(!drink.particles); + assert_eq!(milk.use_remainder.as_deref(), Some("minecraft:bucket")); + let honey = items.get("minecraft:honey_bottle").expect("honey bottle"); + let sip = honey.consumable.as_ref().unwrap(); + assert_eq!(sip.ticks(), 40); + assert_eq!(sip.sound, "minecraft:item.honey_bottle.drink"); + assert_eq!( + sip.effects, + [ConsumeEffect::RemoveEffects(vec![ + "minecraft:poison".into() + ])] + ); + assert_eq!( + honey.use_remainder.as_deref(), + Some("minecraft:glass_bottle") + ); + let kelp = items.get("minecraft:dried_kelp").unwrap(); + let bite = kelp.consumable.as_ref().unwrap(); + assert_eq!((bite.ticks(), bite.animation), (16, UseAnimation::Eat)); + assert_eq!(bite.sound, "minecraft:entity.generic.eat"); + assert!(bite.particles && kelp.use_remainder.is_none()); + let chorus = items.get("minecraft:chorus_fruit").unwrap(); + assert_eq!( + chorus.consumable.as_ref().unwrap().effects, + [ConsumeEffect::TeleportRandomly( + horizon_world::teleport_consume::TeleportConsume { + diameter: 16.0, + directional_particles: true, + } + )] + ); + let chicken = items.get("minecraft:chicken").unwrap(); + assert!(matches!( + chicken.consumable.as_ref().unwrap().effects[..], + [ConsumeEffect::ApplyEffects { probability, .. }] if probability == 0.3 + )); } } diff --git a/crates/horizon-client/src/motion.rs b/crates/horizon-client/src/motion.rs index 7dab3a5aa..edd2a349e 100644 --- a/crates/horizon-client/src/motion.rs +++ b/crates/horizon-client/src/motion.rs @@ -639,7 +639,8 @@ impl MotionWorld<'_, '_, '_> { entities: self.entities, } } - pub(crate) fn no_player_collision(&mut self, bounds: Aabb) -> Result<bool> { + /// `Level.noCollision(player, bounds)`: blocks and the host's entity boxes. + pub fn no_player_collision(&mut self, bounds: Aabb) -> Result<bool> { let context = self.context(); Ok(world_movement::no_world_collision( &mut self.movement_collisions(), diff --git a/crates/horizon-client/src/particles.rs b/crates/horizon-client/src/particles.rs index 57d9e60d7..938e8d72d 100644 --- a/crates/horizon-client/src/particles.rs +++ b/crates/horizon-client/src/particles.rs @@ -1264,12 +1264,21 @@ impl ParticleEngine { } self.create(options, p, v); } - /// `LevelEventHandler.singleBlockTeleportationParticles` (event 2015). - pub fn block_teleportation(&mut self, from: [i32; 3], data: i32, particle_level: u8) { + /// `LevelEventHandler.singleBlockTeleportationParticles` towards + /// `BlockUtil.unpackDifferenceInPosition(from, data, radius)`: the dragon + /// egg's event 2015 packs offsets within (16, 8, 16), a consumable's + /// teleport (2017) within (127, 127, 127). + pub fn block_teleportation( + &mut self, + from: [i32; 3], + data: i32, + radius: [i32; 3], + particle_level: u8, + ) { let to = [ - from[0].wrapping_add(((data >> 16) & 255) - 16), - from[1].wrapping_add(((data >> 8) & 255) - 8), - from[2].wrapping_add((data & 255) - 16), + from[0].wrapping_add(((data >> 16) & 255) - radius[0]), + from[1].wrapping_add(((data >> 8) & 255) - radius[1]), + from[2].wrapping_add((data & 255) - radius[2]), ] .map(f64::from); let from = from.map(f64::from); @@ -3798,7 +3807,7 @@ mod tests { let mut engine = ParticleEngine::new(Path::new(""), &HashMap::new()); engine.seed_randoms(0, 0, 0); // Destination offset (-15, 7, 15); the unused top byte is ignored. - engine.block_teleportation([4, 12, -5], 0xff01_0f1fu32 as i32, 0); + engine.block_teleportation([4, 12, -5], 0xff01_0f1fu32 as i32, [16, 8, 16], 0); assert_eq!(engine.pending.len(), 128); assert!(engine.pending.iter().all(|p| p.ty == ParticleType::Portal)); let first = &engine.pending[0]; @@ -3818,6 +3827,25 @@ mod tests { assert!(engine.sounds.is_empty()); } + #[test] + fn consume_teleport_unpacks_offsets_within_127() { + let mut engine = ParticleEngine::new(Path::new(""), &HashMap::new()); + engine.seed_randoms(0, 0, 0); + // TeleportRandomlyConsumeEffect: BlockUtil.clampedPackDifferenceInPosition + // of the move (-7, -3, 9) with radii 127, from (4, 12, -5) to (-3, 9, 4). + let data = (-7 + 127) << 16 | (-3 + 127) << 8 | (9 + 127); + engine.block_teleportation([4, 12, -5], data, [127, 127, 127], 0); + assert_eq!(engine.pending.len(), 128); + for p in &engine.pending { + let [x, y, z] = p.position; + assert!((-3.0..5.0).contains(&x), "{x}"); + assert!((8.5..12.5).contains(&y), "{y}"); + assert!((-5.0..5.0).contains(&z), "{z}"); + } + // The same draws as the egg's: only the unpacking differs. + assert_eq!(engine.level_random.state(), 99_413_408_083_437); + } + #[test] fn egg_teleport_options_roll_before_distance_rejection() { for (option, count, state) in [ @@ -3831,7 +3859,7 @@ mod tests { if distant { engine.camera = [1000.0; 3]; } - engine.block_teleportation([4, 12, -5], 0x010f1f, option); + engine.block_teleportation([4, 12, -5], 0x010f1f, [16, 8, 16], option); assert_eq!(engine.pending.len(), if distant { 0 } else { count }); assert_eq!(engine.level_random.state(), state); } diff --git a/tools/agent_control_e2e.py b/tools/agent_control_e2e.py index ab408b2b2..53296669a 100644 --- a/tools/agent_control_e2e.py +++ b/tools/agent_control_e2e.py @@ -7,7 +7,8 @@ runs through the CLI (one horizon-ctl process per command) and through `horizon- small JSON-RPC client, and saves a screenshot of each run. The ui scenario drives the menus by widget id instead: the title screen, the options (a slider set by id) and the inventory's slots; the options scenario reads and sets options.txt values by key; the events scenario waits for -states (wait-for) and reads the event log. +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. python3 tools/agent_control_e2e.py # both modes python3 tools/agent_control_e2e.py --mode mcp # one of them @@ -378,7 +379,52 @@ def events_scenario(d, out): return {'events': len(events)} -SCENARIOS = {'survival': scenario, 'ui': ui_scenario, 'options': options_scenario, 'events': events_scenario} +def consume_scenario(d, out): + # Consumables finish as vanilla's Consumable.onConsume: always-edible food at full hunger with its + # effects, milk and honey (no food or drink sounds) with their effects and use remainders, and + # chorus fruit's random teleport. + d('click', id='singleplayer') + if 'game' not in widgets(d): + d('click', id='create-new-world') + d('type', field='name', replace=True, text='Consume') + d('click', id='create-new-world') + d('wait_for', condition='loaded', timeout=400) + + def consume(item, seconds): + d('command', command='clear @s') + d('give', item=item, count=1) + d('use_item', hold=seconds) + d('wait', ticks=5) + state = d('state') + return state, {e['id'] for e in state['player']['effects']} + + def held(state): + return state['held'] and state['held']['item'] + + state, effects = consume('golden_apple', 2.2) + assert state['player']['food'] == 20 and {'regeneration', 'absorption'} <= effects, effects + assert held(state) is None, state['held'] + d('command', command='effect give @s minecraft:speed 60') + state, effects = consume('milk_bucket', 2.2) + assert effects == set(), effects + assert held(state) == 'minecraft:bucket', state['held'] + d('command', command='effect give @s minecraft:poison 60') + d('command', command='effect give @s minecraft:speed 60') + state, effects = consume('honey_bottle', 2.6) + assert effects == {'speed'}, effects + assert held(state) == 'minecraft:glass_bottle', state['held'] + before = d('state')['player']['position'] + state, _ = consume('chorus_fruit', 2.2) + after = state['player']['position'] + moved = [b - a for a, b in zip(before, after)] + assert held(state) is None, state['held'] + assert moved != [0, 0, 0] and abs(moved[0]) <= 8 and abs(moved[2]) <= 8, moved + d('screenshot', path=str(out / f'consume-{d.name}.png')) + return {'teleported': [round(m, 2) for m in moved]} + + +SCENARIOS = {'survival': scenario, 'ui': ui_scenario, 'options': options_scenario, 'events': events_scenario, + 'consume': consume_scenario} def run(mode, ctl, out, resources, which='survival'): From c6531e4bdee77cfd85a9ae13508226e0487bb59d Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 21:12:18 +0200 Subject: [PATCH 053/163] Server players finish vanilla's FULL square, not a 1.5x circle DistanceManager.PlayerTicketTracker gives every chunk within the server's view distance (Chebyshev) of a player a PLAYER_LOADING ticket at level 31, so FULL (33) reaches two chunks past it and FEATURES and TERRAIN one and two more. A server player's streaming area was a circle of radius (view distance + 2) * 3 / 2 + 1, finished one further: 2.1x the chunks at view distance 12. It is now that square, and lan status reports the server world's chunk counts. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game/lan.rs | 18 ++++- crates/horizon-client/src/streaming.rs | 101 +++++++++++++++++++------ 2 files changed, 92 insertions(+), 27 deletions(-) diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index 57c7b9ee0..acd3c4cc5 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -363,6 +363,12 @@ impl Game<'_> { "open": true, "host": h.host_name, "port": h.settings.port, + // The server's own world: its finished chunks and how many it + // has generated or loaded so far. + "world": { + "chunks": self.world.chunks.len(), + "generated": self.streaming.generated_total, + }, "guests": h.hub.guests.iter().map(|g| json!({ "name": g.name, "position": g.position, @@ -1063,14 +1069,20 @@ impl Game<'_> { /// Keep the chunks around every guest loaded. fn lan_update_streaming(&mut self, host: &LanHost) { + // DistanceManager.PlayerTicketTracker: every chunk within the server's + // view distance (Chebyshev) of a player holds a PLAYER_LOADING ticket + // at the entity-ticking level (31), whatever the player asked for; + // levels rise by one a chunk, so FULL (33) reaches two chunks past + // it. An extra area finishes its chunks out to its radius + 1. That + // covers what the player tracks (`ChunkTrackingView`, within its view + // distance + 1) and those chunks' lit neighbours. + let radius = host.hub.config.view_distance + 1; self.streaming.extra = host .hub .guests .iter() .filter(|g| host.hub.here(g)) - // The tracked square's corners and their lit neighbours lie - // within (view distance + 2) * √2 of the player's chunk. - .map(|g| (g.chunk(), (g.view_distance + 2) * 3 / 2 + 1)) + .map(|g| (g.chunk(), radius)) .collect(); } diff --git a/crates/horizon-client/src/streaming.rs b/crates/horizon-client/src/streaming.rs index 7b3f3dd50..bff0a8fd6 100644 --- a/crates/horizon-client/src/streaming.rs +++ b/crates/horizon-client/src/streaming.rs @@ -200,8 +200,10 @@ pub struct Streaming { /// Chunks come from a server (`insert_remote`/`forget`): nothing is /// generated and columns are only unloaded when the server says so. pub remote: bool, - /// More areas to keep loaded (centre chunk, radius), e.g. around guests - /// of a world open to the network. They are generated and kept but not meshed. + /// More areas to keep loaded (centre chunk, radius), e.g. around the + /// players of a server. Each is a square, like vanilla's ticket levels: + /// chunks finish out to `radius + 1` (Chebyshev) and generation reaches + /// past that as around the player. They are generated and kept but not meshed. pub extra: Vec<((i32, i32), i32)>, /// Mesh the sections for drawing (false on a server thread). pub mesh: bool, @@ -788,20 +790,17 @@ impl Streaming { world.dirty_sections.retain(|k| !far.contains(&(k.0, k.2))); } // Drop far proto chunks that are not checked out. - let areas: Vec<((i32, i32), i64)> = - std::iter::once((self.center, i64::from(self.radius + 4))) - .chain(self.extra.iter().map(|&(c, r)| (c, i64::from(r + 4)))) - .collect(); - let forced = &self.forced; + let (center, r4) = (self.center, i64::from(self.radius + 4)); + let ranges = self.ranges(); let far: Vec<(i32, i32)> = self .protos .iter() .filter(|&(&(x, z), p)| { p.is_some() - && !areas.iter().any(|&((cx, cz), r4)| { - i64::from(x - cx).pow(2) + i64::from(z - cz).pow(2) <= r4 * r4 - }) - && !forced + && i64::from(x - center.0).pow(2) + i64::from(z - center.1).pow(2) > r4 * r4 + && !ranges.in_extra(x, z, 4) + && !ranges + .forced .iter() .any(|f| (x - f.0).abs() <= 3 && (z - f.1).abs() <= 3) }) @@ -1277,21 +1276,21 @@ impl Ranges<'_> { /// circles, so a fixed margin alone misses the corners of those squares /// (render distance 2 never finished the chunks next to the player). fn near_finished(&self, x: i32, z: i32, reach: i32) -> bool { - let near = |c: (i32, i32), radius: i32| { - let gap = |d: i32| i64::from((d.abs() - reach).max(0)); - let (dx, dz) = (gap(x - c.0), gap(z - c.1)); - let r = i64::from(radius + 1); - dx * dx + dz * dz <= r * r - }; - near(self.center, self.radius) || self.extra.iter().any(|&(c, r)| near(c, r)) + let gap = |d: i32| i64::from((d.abs() - reach).max(0)); + let (dx, dz) = (gap(x - self.center.0), gap(z - self.center.1)); + let r = i64::from(self.radius + 1); + // The extra areas are squares: their finished square grown by `reach`. + dx * dx + dz * dz <= r * r || self.in_extra(x, z, 1 + reach) } fn in_range(&self, x: i32, z: i32, margin: i32) -> bool { - self.in_main_range(x, z, margin) - || self.extra.iter().any(|&(c, radius)| { - let r = i64::from(radius + margin); - let (dx, dz) = (i64::from(x - c.0), i64::from(z - c.1)); - dx * dx + dz * dz <= r * r - }) + self.in_main_range(x, z, margin) || self.in_extra(x, z, margin) + } + /// Within `margin` of an extra area's square (Chebyshev distance, as + /// vanilla's ticket levels spread). + fn in_extra(&self, x: i32, z: i32, margin: i32) -> bool { + self.extra + .iter() + .any(|&(c, radius)| (x - c.0).abs().max((z - c.1).abs()) <= radius + margin) } /// The columns meshed for drawing: those vanilla draws around the /// player (`in_view_distance`), and forced ones. @@ -1778,4 +1777,58 @@ mod tests { } } } + + /// A server player's area (`lan_update_streaming`: the server view + /// distance + 1) finishes vanilla's FULL square: PLAYER_LOADING tickets at + /// level 31 out to the view distance, FULL (33) two chunks past it. Every + /// chunk the player tracks has its 3x3 neighbourhood finished, so it can + /// be lit and sent, and generation reaches vanilla's FEATURES (34) and + /// TERRAIN (35) rings. + #[test] + fn server_player_areas_finish_vanillas_full_square() { + let forced = HashSet::new(); + for view in 2..=32 { + let extra = [((40, -9), view + 1)]; + let r = Ranges { + // The window's own area, far away. + center: (-400, 300), + radius: 2, + extra: &extra, + forced: &forced, + }; + let level = |x: i32, z: i32| 31 + ((x - 40).abs().max((z + 9).abs()) - view).max(0); + for x in 40 - view - 8..=40 + view + 8 { + for z in -9 - view - 8..=-9 + view + 8 { + assert_eq!( + r.in_range(x, z, 1), + level(x, z) <= 33, + "view {view}: ({x}, {z})" + ); + assert_eq!( + r.requested(x, z, true), + level(x, z) <= 35, + "view {view}: ({x}, {z})" + ); + assert_eq!( + r.unloaded(x, z, true), + level(x, z) > 35, + "view {view}: ({x}, {z})" + ); + // ChunkTrackingView.contains, at any view distance the player may ask for. + let tracked = |v: i64| { + let gap = |d: i32| i64::from(((d).abs() - 2).max(0)); + gap(x - 40).pow(2) + gap(z + 9).pow(2) < v * v + }; + if tracked(i64::from(view)) { + for (dx, dz) in (-1..=1).flat_map(|dx| (-1..=1).map(move |dz| (dx, dz))) { + assert!( + r.in_range(x + dx, z + dz, 1), + "view {view}: ({x}, {z}) tracked, not lit" + ); + } + } + } + } + } + } } From 65d5a35cd22aa723695b0885a5ecd7d5e3a4b710 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 21:40:57 +0200 Subject: [PATCH 054/163] Server: a dead guest is sent its health of 0, as ServerPlayer.doTick does The hub held SetHealth back once a guest died, so the guest's health stayed at its last positive value under the death screen. ServerPlayer sends it every tick it changes, dead or not, and only when the health or the food level changes or the saturation reaches or leaves zero: the hub sent it on every change of saturation too. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/lan/guest.rs | 3 ++- crates/horizon-client/src/lan/hub.rs | 18 ++++++++---------- tools/lan_e2e.py | 5 ++++- 3 files changed, 14 insertions(+), 12 deletions(-) diff --git a/crates/horizon-client/src/lan/guest.rs b/crates/horizon-client/src/lan/guest.rs index ea12c2edb..780be4a33 100644 --- a/crates/horizon-client/src/lan/guest.rs +++ b/crates/horizon-client/src/lan/guest.rs @@ -137,7 +137,8 @@ pub struct Guest { /// What the client believes the inventory menu holds (for change detection). pub menu_sent: Vec<Option<ItemStack>>, pub menu_state: i32, - pub sent_health: Option<(f32, i32, f32)>, + /// `lastSentHealth`, `lastSentFood` and `lastFoodSaturationZero`. + pub sent_health: Option<(f32, i32, bool)>, pub sent_xp: Option<(f32, i32, i32)>, /// Where the player last died (Player.lastDeathLocation), sent with the respawn. pub last_death: Option<[i32; 3]>, diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index b18187835..845f094eb 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -1585,17 +1585,15 @@ impl Hub { self.flush_advancements(i, true); } } - let health = { - let g = &self.guests[i]; - (g.health, g.food, g.saturation) - }; - // A dead player's health isn't sent (the death screen shows from the combat kill). - if self.guests[i].sent_health != Some(health) && !self.guests[i].dead { - let g = &mut self.guests[i]; + // Sent when the health or the food level changes, or the saturation + // reaches or leaves zero; a dead player's health of 0 too. + let g = &mut self.guests[i]; + let health = (g.health, g.food, g.saturation == 0.0); + if g.sent_health != Some(health) { g.send(&C::SetHealth(play::SetHealth { - health: health.0, - food: health.1, - saturation: health.2, + health: g.health, + food: g.food, + saturation: g.saturation, })); g.sent_health = Some(health); } diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index b1e7ec098..790778968 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -454,6 +454,9 @@ def check_hazards(host, guest, out): # A fresh life: full health, so no regeneration eats food while the guest runs. guest('command', command='kill @s') guest.wait(20) + # ServerPlayer.doTick sends the dead player's health of 0 too. + died = {'screen': guest('state').get('screen'), 'health': remote(guest)['health']} + assert died == {'screen': 'dead', 'health': 0.0}, f'the guest was killed: {died}' guest.raw('respawn') guest.wait(40) # Sprint-jumping down a stone lane: ServerPlayer.jumpFromGround and checkMovementStatistics. @@ -506,7 +509,7 @@ def check_hazards(host, guest, out): assert spent > 1.0, f'no hunger from moving: {hunger} ({spent:.2f} spent)' for name, (before, after) in hurt.items(): assert after < before, f'{name} never hurt the guest: health {before} -> {after} (all: {hurt})' - return {'hunger': hunger, **hurt} + return {'died': died, 'hunger': hunger, **hurt} def check_pvp(host, guest, out): From c12f5cf41adfc96551da6715b2f086203e8d7a72 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 21:46:30 +0200 Subject: [PATCH 055/163] Server titles: /title reaches the guest, and its HUD shows and clears them TitleCommand sends the targeted player ClientboundSetTitleText, SetSubtitleText, SetActionBarText, SetTitlesAnimation and ClearTitles. A guest's /title (the window's own player on the server thread too) only changed the server's HUD; it is now sent to the guest. The remote client showed titles and action bars as a bare line and ignored subtitles, times and clearing; it now feeds the HUD's titles as ClientPacketListener does (the action bar of a SystemChat overlay too) and ticks them (Gui.tick). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game.rs | 3 ++ .../src/game/commands/text_commands.rs | 43 +++++++++++++---- crates/horizon-client/src/game/lan_actions.rs | 3 ++ crates/horizon-client/src/game/remote.rs | 46 +++++++++---------- tools/lan_e2e.py | 21 ++++++++- 5 files changed, 80 insertions(+), 36 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 38edb3605..789479710 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -1152,6 +1152,8 @@ struct Game<'a> { lan_acting_uuid: Option<u128>, /// Command feedback to forward to a guest. chat_capture: Option<Vec<horizon_client::text::Text>>, + /// Packets for the guest acting now, sent once its action returns. + guest_packets: Vec<horizon_protocol::packets::play::Clientbound>, /// `broadcastToAdmins` lines a guest's command queued, sent once it /// returns: the line, whether operators get it and whether the console /// logs it. @@ -10374,6 +10376,7 @@ impl<'a> Game<'a> { lan_entity_events: Vec::new(), lid_openers: HashMap::new(), lan_acting: None, + guest_packets: Vec::new(), lan_acting_name: None, lan_acting_uuid: None, chat_capture: None, diff --git a/crates/horizon-client/src/game/commands/text_commands.rs b/crates/horizon-client/src/game/commands/text_commands.rs index da8485849..dead07d71 100644 --- a/crates/horizon-client/src/game/commands/text_commands.rs +++ b/crates/horizon-client/src/game/commands/text_commands.rs @@ -1,6 +1,7 @@ //! `/tellraw` (TellRawCommand) and `/title` (TitleCommand). use super::{Arg, Context, Game, R, Target, err}; -use horizon_client::text::Text; +use horizon_client::{hud_overlays::Titles, lan::data::component_nbt, text::Text}; +use horizon_protocol::packets::play::{self, Clientbound as C}; impl Game<'_> { /// ComponentArgument with selectors resolved for the source @@ -153,30 +154,45 @@ impl Game<'_> { let name = self.target_name(Target::Player); let single = n == 1; let key = if ctx.has("clear") { - self.titles.clear(); + self.titles_or_packet(Titles::clear, C::ClearTitles(play::Bool1 { value: false })); "cleared" } else if ctx.has("reset") { - self.titles.clear(); - self.titles.reset_times(); + self.titles_or_packet( + |t| { + t.clear(); + t.reset_times(); + }, + C::ClearTitles(play::Bool1 { value: true }), + ); "reset" } else if ctx.has("times") { let get = |k: &str| match ctx.get(k) { Some(Arg::Int(v)) => *v, _ => -1, }; - self.titles - .set_times(get("fadeIn"), get("stay"), get("fadeOut")); + let (fade_in, stay, fade_out) = (get("fadeIn"), get("stay"), get("fadeOut")); + self.titles_or_packet( + |t| t.set_times(fade_in, stay, fade_out), + C::SetTitlesAnimation(play::TitlesAnimation { + fade_in, + stay, + fade_out, + }), + ); "times" } else { let text = self.component_arg(ctx, "title")?; + let sent = play::Text { + text: component_nbt(&text.component()), + }; if ctx.has("subtitle") { - self.titles.set_subtitle(text); + self.titles_or_packet(|t| t.set_subtitle(text), C::SetSubtitleText(sent)); "show.subtitle" } else if ctx.has("actionbar") { - self.titles.set_overlay(text, false); + self.titles_or_packet(|t| t.set_overlay(text, false), C::SetActionBarText(sent)); "show.actionbar" } else { - self.titles.set_title(text); + self.titles_or_packet(|t| t.set_title(text), C::SetTitleText(sent)); "show.title" } }; @@ -191,4 +207,13 @@ impl Game<'_> { self.feedback(message); Ok(n as i32) } + /// The player the title is for: the guest acting now is sent the packet + /// (TitleCommand's `connection.send`), the window's own player shows it. + fn titles_or_packet(&mut self, local: impl FnOnce(&mut Titles), packet: C) { + if self.lan_acting.is_some() { + self.guest_packets.push(packet); + } else { + local(&mut self.titles); + } + } } diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index 68b29a360..9c0f0ec88 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -203,6 +203,9 @@ impl Game<'_> { self.lan_acting_uuid = Some(g.uuid); let result = f(self); + for packet in std::mem::take(&mut self.guest_packets) { + host.hub.send_to(conn, &packet); + } self.lan_acting = None; self.lan_acting_name = None; self.lan_acting_uuid = None; diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 991bc42b2..ef7fad329 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -40,13 +40,15 @@ use horizon_protocol::{ text::{Language, format_java, plain}, }; use horizon_world::{nbt::Tag, registry::BlockStateId}; -use std::{ - collections::HashMap, - sync::Arc, - time::{Duration, Instant}, -}; +use std::{collections::HashMap, sync::Arc, time::Instant}; use winit::{event::MouseButton, keyboard::KeyCode}; +/// A text component the server sent, for the HUD. +fn remote_text(tag: &Tag) -> horizon_client::text::Text { + use horizon_client::scoreboard::{comp_text, tag_to_json}; + comp_text(&tag_to_json(tag)) +} + /// Streaming needs a generator; a server world never generates. struct NoTerrain; impl ChunkGenerator for NoTerrain { @@ -120,7 +122,6 @@ pub(super) struct Remote { pub chat: Vec<(String, Instant)>, /// The server's command tree (ClientboundCommandsPacket). pub commands: Option<horizon_client::command::Dispatcher>, - action_bar: Option<(String, Instant)>, players: HashMap<u128, String>, /// `ClientPacketListener.playerInfoMap` as player-list entries, and /// which of them are listed. @@ -306,7 +307,6 @@ impl Game<'_> { game_mode: 0, chat: Vec::new(), commands: None, - action_bar: None, players: HashMap::new(), tab_players: HashMap::new(), skin_textures: HashMap::new(), @@ -1659,10 +1659,9 @@ impl Game<'_> { .map(|r| r.lang.clone()) .unwrap_or_default(), ); + // ChatListener.handleOverlay. if p.overlay { - if let Some(r) = self.remote.as_mut() { - r.action_bar = Some((text, Instant::now())); - } + self.titles.set_overlay(remote_text(&p.content), false); } else { self.chat_line(text); } @@ -1893,15 +1892,16 @@ impl Game<'_> { self.stats.values.entry(ty).or_default().insert(key, count); } } - C::SetActionBarText(p) | C::SetTitleText(p) => { - let lang = self - .remote - .as_ref() - .map(|r| r.lang.clone()) - .unwrap_or_default(); - let text = plain(&p.text, &lang); - if let Some(r) = self.remote.as_mut() { - r.action_bar = Some((text, Instant::now())); + // ClientPacketListener.setActionBarText, setTitleText, + // setSubtitleText, setTitlesAnimation and handleTitlesClear. + C::SetActionBarText(p) => self.titles.set_overlay(remote_text(&p.text), false), + C::SetTitleText(p) => self.titles.set_title(remote_text(&p.text)), + C::SetSubtitleText(p) => self.titles.set_subtitle(remote_text(&p.text)), + C::SetTitlesAnimation(p) => self.titles.set_times(p.fade_in, p.stay, p.fade_out), + C::ClearTitles(p) => { + self.titles.clear(); + if p.value { + self.titles.reset_times(); } } _ => {} @@ -2252,6 +2252,8 @@ impl Game<'_> { self.tick_client_effects(); // Player.tick's sleep counter (the darkening and the wake-up fade). self.sleep_timer = super::tick_sleep_timer(self.sleep_timer, self.sleeping.is_some()); + // Gui.tick: the titles, the action bar and the held item's name. + self.tick_hud(); let ghast_collisions = self.happy_ghast_player_collisions(); let pushed = self.remote_pushes(); let Some(player) = self.player.as_mut() else { @@ -3507,12 +3509,6 @@ impl Game<'_> { batch.text(atlas, text, 4.0, y, rgba(255, 255, 255, a), true); y -= 9.0; } - if let Some((text, at)) = &r.action_bar - && now.duration_since(*at) < Duration::from_secs(3) - { - let tw = HudBatch::text_width(atlas, text); - batch.text(atlas, text, (w - tw) / 2.0, h - 68.0, u32::MAX, true); - } if self.screen == Screen::Dead && let Some(message) = &r.death_message { diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index b1e7ec098..1532d1cf5 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -74,7 +74,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', 'containers', 'feedback', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'effects', 'portals'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'effects', 'portals'] class Game: @@ -775,6 +775,22 @@ def check_recipes(host, guest, out): return {'known': known, 'grid': grid} +def check_titles(host, guest, out): + # TitleCommand sends the guest its title packets; its HUD shows and clears them. + for command in ('title @s times 10 400 10', 'title @s subtitle "Under"', 'title @s title "Over"', + 'title @s actionbar "Bar"'): + guest('command', command=command) + guest.wait(5) + shown = {k: guest.raw('messages', 1)[k] for k in ('title', 'subtitle', 'actionbar')} + guest.shot(out, 'titles') + guest('command', command='title @s clear') + guest.wait(5) + cleared = {k: guest.raw('messages', 1)[k] for k in ('title', 'subtitle')} + assert shown == {'title': 'Over', 'subtitle': 'Under', 'actionbar': 'Bar'}, f'titles shown: {shown}' + assert cleared == {'title': None, 'subtitle': None}, f'titles cleared: {cleared}' + return {'shown': shown, 'cleared': cleared} + + def png_rows(path): """The rows of an 8-bit RGB or RGBA PNG, unfiltered, as bytes of 4 (or 3) per pixel.""" data = Path(path).read_bytes() @@ -1047,7 +1063,8 @@ def check_xp(host, guest, out): CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'nametags': check_nametags, 'chest': check_chest, 'crafting': check_crafting, 'sign': check_sign, 'damage': check_damage, 'mobs': check_mobs, 'hazards': check_hazards, 'pvp': check_pvp, - 'containers': check_containers, 'feedback': check_feedback, 'commands': check_commands, + 'containers': check_containers, 'feedback': check_feedback, 'titles': check_titles, + 'commands': check_commands, 'recipes': check_recipes, 'trials': check_trials, 'walls': check_walls, 'effects': check_effects, 'portals': check_portals, 'clicks': check_clicks, 'sleep': check_sleep, 'push': check_push, 'eat': check_eat, From d370364f1235e3828b2cd1c328628c34bbe8aa38 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sun, 18 Oct 2026 02:44:11 +0100 Subject: [PATCH 056/163] Specialize constant material rule branches after binding --- .../src/worldgen/material_condition.rs | 8 + .../src/worldgen/material_condition/rule.rs | 20 +- .../tests/material_rule_specialization.rs | 172 ++++++++++++++++++ 3 files changed, 197 insertions(+), 3 deletions(-) create mode 100644 crates/horizon-world/tests/material_rule_specialization.rs diff --git a/crates/horizon-world/src/worldgen/material_condition.rs b/crates/horizon-world/src/worldgen/material_condition.rs index 30eb26ec8..6433b09a4 100644 --- a/crates/horizon-world/src/worldgen/material_condition.rs +++ b/crates/horizon-world/src/worldgen/material_condition.rs @@ -300,6 +300,14 @@ enum Kind<R: RandomSource> { Not(Box<Compiled<R>>), } impl<R: RandomSource> Compiled<R> { + fn constant_result(&self) -> Option<bool> { + match &self.kind { + Kind::Constant(value) => Some(*value), + Kind::Not(child) => child.constant_result().map(|value| !value), + _ => None, + } + } + fn compile<S: MaterialSurfaceQueries>( condition: MaterialCondition, root: &R::Positional, diff --git a/crates/horizon-world/src/worldgen/material_condition/rule.rs b/crates/horizon-world/src/worldgen/material_condition/rule.rs index 9dfc2ff1e..cf4fc8547 100644 --- a/crates/horizon-world/src/worldgen/material_condition/rule.rs +++ b/crates/horizon-world/src/worldgen/material_condition/rule.rs @@ -70,6 +70,7 @@ impl From<horizon_core::density::SampleError> for MaterialRuleError { } pub(super) enum CompiledRule<R: RandomSource> { + Empty, Block(BlockStateId), OreVein { blocks: [BlockStateId; 3], @@ -127,7 +128,12 @@ impl<R: RandomSource> CompiledRule<R> { // whether the predicate will match any subsequent position. let condition = Compiled::compile(if_true, root, context, depth + 1)?; let rule = Box::new(Self::compile(*then_run, root, context, depth + 1, nodes)?); - Self::Condition { condition, rule } + // Compile both sides first: binding and errors must retain their order. + match condition.constant_result() { + Some(false) => Self::Empty, + Some(true) => *rule, + None => Self::Condition { condition, rule }, + } } MaterialRule::Sequence(mut children) => { if children.len() == 1 { @@ -135,9 +141,16 @@ impl<R: RandomSource> CompiledRule<R> { } let mut result = Vec::with_capacity(children.len()); for child in children { - result.push(Self::compile(child, root, context, depth + 1, nodes)?); + let child = Self::compile(child, root, context, depth + 1, nodes)?; + if !matches!(child, Self::Empty) { + result.push(child); + } + } + match result.len() { + 0 => Self::Empty, + 1 => result.pop().unwrap(), + _ => Self::Sequence(result), } - Self::Sequence(result) } }) } @@ -147,6 +160,7 @@ impl<R: RandomSource> CompiledRule<R> { context: &mut Context<S>, ) -> Result<Option<BlockStateId>, MaterialRuleError> { match self { + Self::Empty => Ok(None), Self::Block(block) => Ok(Some(*block)), Self::OreVein { blocks, diff --git a/crates/horizon-world/tests/material_rule_specialization.rs b/crates/horizon-world/tests/material_rule_specialization.rs new file mode 100644 index 000000000..e953e908e --- /dev/null +++ b/crates/horizon-world/tests/material_rule_specialization.rs @@ -0,0 +1,172 @@ +use horizon_core::{ + density::{ConstantSampler, DensitySampler}, + position::BlockPos, + random::{RandomSource, XoroshiroRandom}, +}; +use horizon_world::{ + registry::BlockStateId, + worldgen::{ + DecodeError, + anchor::WorldGenerationContext, + material_condition::{ + MaterialCondition, MaterialConditions, MaterialRule, MaterialRuleError, + MaterialSurfaceQueries, + }, + }, +}; +use std::{collections::BTreeSet, sync::Arc}; + +#[derive(Default)] +struct Queries { + bindings: Vec<bool>, + temperatures: usize, + biomes: usize, + fail_binding: bool, + fail_temperature: bool, +} +impl MaterialSurfaceQueries for Queries { + fn possible_biomes(&self) -> Option<BTreeSet<String>> { + Some(BTreeSet::from(["minecraft:plains".into()])) + } + fn surface_depth(&mut self, _: i32, _: i32) -> i32 { + 1 + } + fn surface_secondary(&mut self, _: i32, _: i32) -> f64 { + 0. + } + fn bind_density( + &mut self, + _: Arc<dyn DensitySampler>, + eager: bool, + ) -> Result<usize, DecodeError> { + self.bindings.push(eager); + if self.fail_binding { + return Err(DecodeError::Field("test binding failure")); + } + Ok(self.bindings.len() - 1) + } + fn biome(&mut self, _: BlockPos) -> Result<Option<Arc<str>>, MaterialRuleError> { + self.biomes += 1; + Ok(Some(Arc::from("minecraft:plains"))) + } + fn cold_enough_to_snow( + &mut self, + _: &str, + _: BlockPos, + _: i32, + ) -> Result<bool, MaterialRuleError> { + self.temperatures += 1; + if self.fail_temperature { + Err(MaterialRuleError::BiomeQueryFailed) + } else { + Ok(true) + } + } +} +fn worker(surface: Queries) -> MaterialConditions<XoroshiroRandom, Queries> { + MaterialConditions::new( + WorldGenerationContext::new(-64, 384, 63), + XoroshiroRandom::new(7).fork_positional(), + surface, + ) +} +fn condition(if_true: MaterialCondition, then_run: MaterialRule) -> MaterialRule { + MaterialRule::Condition { + if_true, + then_run: Box::new(then_run), + } +} +fn biome(name: &str) -> MaterialCondition { + MaterialCondition::Biome(vec![name.into()]) +} +fn ore() -> MaterialRule { + MaterialRule::OreVein { + ore: BlockStateId(1), + raw_ore: BlockStateId(2), + filler: BlockStateId(3), + raw_ore_chance: 0.02, + density: Arc::new(ConstantSampler(1.)), + richness: Arc::new(ConstantSampler(1.)), + filler_gap: Arc::new(ConstantSampler(-1.)), + } +} +#[test] +fn constant_branches_keep_binding_order_and_short_circuit_queries() { + let mut w = worker(Queries::default()); + let rule = w + .add_rule(MaterialRule::Sequence(vec![ + condition(biome("minecraft:desert"), ore()), + condition( + MaterialCondition::Not(Box::new(biome("minecraft:desert"))), + MaterialRule::Block(BlockStateId(9)), + ), + ore(), + ])) + .unwrap(); + w.update_xz(4, 5, 0, 0); + w.update_y(1, 1, i32::MIN, 64); + for _ in 0..2 { + assert_eq!( + w.try_apply(rule, BlockPos::new(4, 64, 5)), + Ok(Some(BlockStateId(9))) + ); + } + let q = w.into_surface(); + assert_eq!(q.bindings, [true, true, false, true, true, false]); + assert_eq!(q.biomes, 0); + assert_eq!(q.temperatures, 0); +} +#[test] +fn unreachable_children_still_fail_compilation_without_adding_a_rule() { + for preceding_block in [false, true] { + let mut w = worker(Queries { + fail_binding: true, + ..Queries::default() + }); + let dead = condition(biome("minecraft:desert"), ore()); + let rule = if preceding_block { + MaterialRule::Sequence(vec![MaterialRule::Block(BlockStateId(9)), dead]) + } else { + dead + }; + assert!(w.add_rule(rule).is_err()); + assert_eq!( + w.try_apply(0, BlockPos::new(0, 0, 0)), + Err(MaterialRuleError::UnknownRule) + ); + assert_eq!(w.into_surface().bindings, [true]); + } +} +#[test] +fn dynamic_predicate_on_empty_child_retains_each_temperature_call_and_error() { + for fail in [false, true] { + let mut w = worker(Queries { + fail_temperature: fail, + ..Queries::default() + }); + let rule = w + .add_rule(condition( + MaterialCondition::Temperature, + condition( + biome("minecraft:desert"), + MaterialRule::Block(BlockStateId(9)), + ), + )) + .unwrap(); + w.update_xz(0, 0, 0, 0); + w.update_y(1, 1, i32::MIN, 64); + for _ in 0..2 { + assert_eq!( + w.try_apply(rule, BlockPos::new(0, 64, 0)), + if fail { + Err(MaterialRuleError::BiomeQueryFailed) + } else { + Ok(None) + } + ); + } + let q = w.into_surface(); + assert_eq!(q.temperatures, 2); + assert_eq!(q.biomes, 1); + } +} From 4cfa6a507cd2ebdaa4f05a9ffbb094c7871d4c94 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sun, 18 Oct 2026 03:11:34 +0100 Subject: [PATCH 057/163] Document incremental surface optimization measurements --- docs/surface-generation-benchmark.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 docs/surface-generation-benchmark.md diff --git a/docs/surface-generation-benchmark.md b/docs/surface-generation-benchmark.md new file mode 100644 index 000000000..e40849c19 --- /dev/null +++ b/docs/surface-generation-benchmark.md @@ -0,0 +1,15 @@ +# Constant surface-rule specialization benchmark + +The upstream PR contains only the surface change and tests, reapplied to upstream main. The measurements below were collected with #796 present; they are historical incremental measurements, not new timings for the rebased upstream head. + +This surface-only change is based on the bulk unary density optimization in [upstream PR #796](https://github.com/ludovic111/horizon/pull/796). Measurements compare against `eb3789038e3184c98a1459fe638947200217d360`, which already includes that optimization; its savings are not counted again. + +With one worker, primary initialized Overworld terrain time improved from 10.664 to 10.298 ms/input chunk (3.43%). Terrain plus decoration improved from 12.645 to 12.242 (3.19%). With four workers, terrain improved 2.48% and combined time 2.07%. Nether terrain improved 4.16% / 3.93% with one/four workers; combined improved 3.76% / 3.63%. The second Overworld site improved terrain 2.53% / 2.81%. End improved 2.95% with one worker but regressed 2.93% with four, with substantial paired noise. This meets the revised 3% median gate on selected representative cases, not the original 5% gate or every workload. + +Cases were declared before editing. Each used one discarded pair followed by five alternating baseline/candidate pairs, with identical work and builds. The primary case used seed 12345, center (0,0), 256 terrain chunks and 196 decorated interior chunks, at one/four workers across all three dimensions. The second Overworld case used seed -1 at (32,-32). An offset 9×9 generation pass initialized the same seeded generator without pre-generating the measured region. Wall time is elapsed/input count; combined time includes the complete decoration phase and required borders. Cold startup was measured separately. + +Machine: AMD Ryzen 5 5600X, 32 GiB RAM, Linux, Rust 1.99.0. Optimized `fast` profile: release optimization, LTO off, 16 codegen units. Runs and builds were sequential; background desktop activity was not isolated. Memory use was effectively unchanged. The benchmark used the existing chunkgen benchmark with identical optional initialization and exact timing instrumentation on both revisions. `crates/horizon-world/examples/chunkgen_bench.rs` is the standard workload entry point; its thread-multiplied human-readable ms/chunk display differs from actual elapsed/count. + +Validation passed: 102 targeted Rust tests; 162 world-crate tests; 24 exact complete-field baseline/candidate terrain and decorated comparisons across three dimensions, two sites/seeds, and one/four workers; and six fresh pinned Java 26.3 client/server suites covering material stages, rule library, conditions, temperature, extensions, and surface generation. Differential snapshots included block states/palettes, quart biomes, binary entities/block entities, scheduled ticks, all six heightmaps, ordered postprocessing, non-air counts, and chunk metadata. Compilation/binding errors, dynamic queries, and short-circuit behavior have regression coverage. The final production executable matched the measured candidate byte-for-byte. + +The repository quick PR check also passed public-tree validation, Python tests, formatting, clippy, and world tests. Validation is scoped to the declared corpora and does not establish complete gameplay parity. Generated timing files, diagnostic runners, patches, and validation logs are retained locally outside the repository and are not included in this PR. From 20fada25bd4bdc62465dd09160862049c9a1d2fd Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 04:27:55 +0200 Subject: [PATCH 058/163] Rerun CI now that the PR is ready for review Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> From e8eaaf59d79332a5861f1410e17c4e0e17791a99 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 04:35:23 +0200 Subject: [PATCH 059/163] Rerun CI (flaky options_ui test, #802) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> From 0f482a45c868a8e2cab8803e4fcc8e01411edd8c Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 04:01:54 +0200 Subject: [PATCH 060/163] Dedicated server: never mesh sections A dedicated server draws nothing, like the integrated server, yet its streaming still meshed every section it lit (Streaming::mesh followed only options.integrated). It now skips meshing too. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game.rs | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index fd47d2986..8366c5ec9 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -6566,8 +6566,9 @@ impl Game<'_> { streaming.biome_zoom = BiomeZoom::new(obfuscate_seed(seed)); streaming.sky_light = dim != Dim::Nether; streaming.nether_shading = dim == Dim::Nether; - // The integrated server draws nothing (the dedicated server keeps its behaviour). - streaming.mesh = !self.options.integrated; + // A server draws nothing: neither the integrated server nor the + // dedicated one meshes sections. + streaming.mesh = !self.options.integrated && self.options.dedicated.is_none(); Ok((streaming, save)) } /// Change dimension through a portal (Entity.changeDimension with From ff6e01de03f5d3df0bb51b2bdc945955fbd01aca Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 00:04:14 +0200 Subject: [PATCH 061/163] Command suggestions: ask the server for nodes the tree marks ask_server A remote client's chat now sends ServerboundCommandSuggestionPacket for an argument node whose provider is minecraft:ask_server (bossbar ids, data storage, datapacks, team names, functions...), as ClientSuggestionProvider.customSuggestion does. The suggestions are done when ClientboundCommandSuggestionsPacket answers that id; its completions join the local ones (Suggestions.merge). Replies to older requests are dropped. The remote tree takes each node's provider from the packet only: a local provider the server didn't send stood in for the server's before. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/chat.rs | 88 ++++++++++++++++++-- crates/horizon-client/src/chat_tests.rs | 55 ++++++++++++ crates/horizon-client/src/command/mod.rs | 27 +++++- crates/horizon-client/src/command/network.rs | 11 ++- crates/horizon-client/src/game/chat.rs | 17 ++++ crates/horizon-client/src/game/remote.rs | 55 ++++++++++++ tools/lan_e2e.py | 20 ++++- 7 files changed, 257 insertions(+), 16 deletions(-) diff --git a/crates/horizon-client/src/chat.rs b/crates/horizon-client/src/chat.rs index 6156a041d..7c51a40f1 100644 --- a/crates/horizon-client/src/chat.rs +++ b/crates/horizon-client/src/chat.rs @@ -386,6 +386,12 @@ pub struct ChatScreen { parse: Option<ParseResults>, /// The completions at the cursor (`pendingSuggestions`): range start (bytes) and list. pending: Option<(usize, Vec<Suggestion>)>, + /// Completions waiting for the server's (an `ask_server` node at the + /// cursor): `pendingSuggestions` is not done until they come. + awaiting: Option<Awaiting>, + /// The request to send (`ServerboundCommandSuggestionPacket`): id and + /// the command up to the cursor. + request: Option<(i32, String)>, suggestions: Option<SuggestionList>, usage: Vec<Text>, usage_position: i32, @@ -394,6 +400,16 @@ pub struct ChatScreen { keep_suggestions: bool, pub auto_suggestions: bool, } +/// Local completions waiting for the server's reply to request `id`. +struct Awaiting { + id: i32, + /// The command up to the cursor, as sent. + truncated: String, + local: Vec<Suggestion>, +} +/// `ClientSuggestionProvider.pendingSuggestionsId`: one counter for the +/// connection, so a reply to an older request never matches. +static SUGGESTION_ID: std::sync::atomic::AtomicI32 = std::sync::atomic::AtomicI32::new(0); /// `CommandSuggestions`' fill colour. const FILL: i32 = -805306368; fn byte_at(s: &str, chars: usize) -> usize { @@ -442,6 +458,8 @@ impl ChatScreen { history_pos: history_len, parse: None, pending: None, + awaiting: None, + request: None, suggestions: None, usage: Vec::new(), usage_position: 0, @@ -518,24 +536,84 @@ impl ChatScreen { } if cursor >= 1 && (self.suggestions.is_none() || !self.keep_suggestions) { let parse = self.parse.as_ref().expect("parsed above"); - let (range, list) = c - .dispatcher - .client_suggestions(parse, cursor_b, c.registries); - self.pending = Some((range.0, list)); - self.update_usage_info(m, c); + let (range, list, ask) = + c.dispatcher + .client_suggestions_asking(parse, cursor_b, c.registries); + if ask { + // ClientSuggestionProvider.customSuggestion: the + // suggestions are done when the server answers. + let id = SUGGESTION_ID.fetch_add(1, std::sync::atomic::Ordering::Relaxed) + 1; + let truncated = command[..cursor_b].to_owned(); + self.request = Some((id, truncated.clone())); + self.awaiting = Some(Awaiting { + id, + truncated, + local: list, + }); + self.pending = None; + } else { + self.awaiting = None; + self.pending = Some((range.0, list)); + self.update_usage_info(m, c); + } } } else if !command.chars().all(char::is_whitespace) { let partial = &command[..cursor_b]; let mut builder = SuggestionsBuilder::new(partial, last_word_index(partial)); builder.suggest_matching(c.registries.players.iter().map(String::as_str)); let (range, list) = merge_suggestions(partial, builder.out); + self.awaiting = None; self.pending = Some((range.0, list)); self.usage_width = 0; self.usage_position = 0; } else { + self.awaiting = None; self.pending = None; } } + /// The completion request to send to the server, if one is waiting. + pub fn take_request(&mut self) -> Option<(i32, String)> { + self.request.take() + } + /// `ClientSuggestionProvider.completeCustomSuggestions`: the server's + /// completions for request `id`, with `range` in UTF-16 units of the + /// command sent. They join the local ones (`Suggestions.merge`) and the + /// pending suggestions are done. + pub fn server_suggestions( + &mut self, + m: &Measure, + c: &Commands, + id: i32, + range: (usize, usize), + list: Vec<(String, Option<String>)>, + ) { + let Some(awaiting) = self.awaiting.take_if(|a| a.id == id) else { + return; + }; + let input = &awaiting.truncated; + let byte = |units: usize| { + let mut n = 0; + input + .char_indices() + .find(|(_, ch)| { + let past = n >= units; + n += ch.len_utf16(); + past + }) + .map_or(input.len(), |(i, _)| i) + }; + let range = (byte(range.0), byte(range.0 + range.1)); + let mut all = awaiting.local; + all.extend(list.into_iter().map(|(text, tooltip)| Suggestion { + range, + text, + tooltip, + int_value: None, + })); + let (range, list) = merge_suggestions(input, all); + self.pending = Some((range.0, list)); + self.update_usage_info(m, c); + } /// `CommandSuggestions.updateUsageInfo`. fn update_usage_info(&mut self, m: &Measure, c: &Commands) { let Some(parse) = &self.parse else { return }; diff --git a/crates/horizon-client/src/chat_tests.rs b/crates/horizon-client/src/chat_tests.rs index 3cbac071b..e1bf2feda 100644 --- a/crates/horizon-client/src/chat_tests.rs +++ b/crates/horizon-client/src/chat_tests.rs @@ -230,3 +230,58 @@ fn mod_commands_are_coloured_and_complete_like_vanilla_ones() { screen.key(&m, &c, &[], winit::keyboard::KeyCode::Tab, false, false); assert_eq!(screen.value(), "/coords"); } + +#[test] +fn ask_server_nodes_wait_for_the_servers_completions() { + // ClientSuggestionProvider.customSuggestion: an `ask_server` node at the + // cursor sends the command so far, and the list is done with the reply. + let font = font(); + let m = Measure(&font); + let registries = Registries { + permission: 4, + ..Registries::default() + }; + let mut d = crate::command::vanilla::game_dispatcher().clone(); + let child = |d: &crate::command::Dispatcher, n: usize, name: &str| { + d.nodes[n] + .children + .iter() + .copied() + .find(|&c| d.nodes[c].name() == name) + .expect(name) + }; + let id = child(&d, child(&d, child(&d, 0, "bossbar"), "get"), "id"); + d.nodes[id].suggests = Some(crate::command::Suggests::AskServer); + let c = Commands { + dispatcher: &d, + registries: ®istries, + }; + let tab = |screen: &mut ChatScreen| { + screen.key(&m, &c, &[], winit::keyboard::KeyCode::Tab, false, false); + }; + let mut screen = ChatScreen::new(&m, &c, "", 0, 640, 360); + screen.type_text(&m, &c, "/bossbar get pt"); + let (request, sent) = screen.take_request().expect("the server is asked"); + assert_eq!(sent, "/bossbar get pt"); + assert_eq!(screen.take_request(), None); + // Nothing to complete until the reply. + tab(&mut screen); + assert_eq!(screen.value(), "/bossbar get pt"); + // A reply to an older request is dropped; the range is in UTF-16 units. + let reply = |text: &str| vec![(text.to_owned(), None)]; + screen.server_suggestions(&m, &c, request - 1, (13, 2), reply("pt6:old")); + tab(&mut screen); + assert_eq!(screen.value(), "/bossbar get pt"); + screen.server_suggestions(&m, &c, request, (13, 2), reply("pt6:check")); + tab(&mut screen); + assert_eq!(screen.value(), "/bossbar get pt6:check"); + // Without the server's provider the local list is done at once. + let local = crate::command::vanilla::game_dispatcher(); + let c = Commands { + dispatcher: local, + registries: ®istries, + }; + let mut screen = ChatScreen::new(&m, &c, "", 0, 640, 360); + screen.type_text(&m, &c, "/bossbar get pt"); + assert_eq!(screen.take_request(), None); +} diff --git a/crates/horizon-client/src/command/mod.rs b/crates/horizon-client/src/command/mod.rs index 8fcb30830..e9aeaae51 100644 --- a/crates/horizon-client/src/command/mod.rs +++ b/crates/horizon-client/src/command/mod.rs @@ -312,6 +312,9 @@ pub enum Suggests { /// ScoreboardCommand.suggestTriggers: trigger objectives some of the /// parsed `targets` have no score in, or a locked one. EnableTriggers, + /// SuggestionProviders.ASK_SERVER: the server completes the node + /// (ClientSuggestionProvider.customSuggestion); nothing locally. + AskServer, } impl Node { pub fn name(&self) -> &str { @@ -691,7 +694,7 @@ impl Suggests { Suggests::Triggers => { builder.suggest_matching(reg.trigger_objectives.iter().map(String::as_str)) } - Suggests::Nothing => {} + Suggests::Nothing | Suggests::AskServer => {} } } } @@ -955,7 +958,8 @@ impl Dispatcher { cursor: usize, reg: &Registries, ) -> (Range, Vec<Suggestion>) { - self.suggestions_within(parse, cursor, reg, u8::MAX) + let (range, list, _) = self.suggestions_within(parse, cursor, reg, u8::MAX); + (range, list) } /// The suggestions the player's chat shows: the client's tree only holds /// the nodes the player may use (Commands.sendCommands prunes by canUse). @@ -965,6 +969,18 @@ impl Dispatcher { cursor: usize, reg: &Registries, ) -> (Range, Vec<Suggestion>) { + let (range, list, _) = self.suggestions_within(parse, cursor, reg, reg.permission); + (range, list) + } + /// [`Self::client_suggestions`], and whether a node at the cursor asks + /// the server (`ask_server`): its completions come with the server's + /// reply, to be merged with these. + pub fn client_suggestions_asking( + &self, + parse: &ParseResults, + cursor: usize, + reg: &Registries, + ) -> (Range, Vec<Suggestion>, bool) { self.suggestions_within(parse, cursor, reg, reg.permission) } fn suggestions_within( @@ -973,15 +989,17 @@ impl Dispatcher { cursor: usize, reg: &Registries, permission: u8, - ) -> (Range, Vec<Suggestion>) { + ) -> (Range, Vec<Suggestion>, bool) { let (parent, start, context) = parse.context.suggestion_context(cursor); let start = start.min(cursor); let truncated = &parse.input[..cursor.min(parse.input.len())]; let mut all = Vec::new(); + let mut ask = false; for &child in &self.nodes[parent].children { if self.nodes[child].permission > permission { continue; } + ask |= matches!(self.nodes[child].suggests, Some(Suggests::AskServer)); let mut builder = SuggestionsBuilder::new(truncated, start); match &self.nodes[child].kind { NodeKind::Literal(l) => { @@ -997,7 +1015,8 @@ impl Dispatcher { } all.extend(builder.out); } - merge_suggestions(truncated, all) + let (range, list) = merge_suggestions(truncated, all); + (range, list, ask) } fn smart_usage_of(&self, node: usize, optional: bool, deep: bool, level: u8) -> Option<String> { let n = &self.nodes[node]; diff --git a/crates/horizon-client/src/command/network.rs b/crates/horizon-client/src/command/network.rs index 32f446f5c..8fed97db0 100644 --- a/crates/horizon-client/src/command/network.rs +++ b/crates/horizon-client/src/command/network.rs @@ -83,10 +83,9 @@ pub fn from_packet(packet: &Commands, local: &Dispatcher) -> Dispatcher { } _ => NodeKind::Root, }; - let suggests = match local_node { - Some(l) => l.suggests.clone(), - None => node.suggestions.as_deref().and_then(provider), - }; + // The server's providers, as the client knows them + // (ArgumentNodeStub.build): its own custom ones arrive as `ask_server`. + let suggests = node.suggestions.as_deref().and_then(provider); nodes[index(i)] = Some(Node { kind: if i == root { NodeKind::Root } else { kind }, children: node.children.iter().filter_map(valid).map(index).collect(), @@ -104,10 +103,10 @@ pub fn from_packet(packet: &Commands, local: &Dispatcher) -> Dispatcher { d } -/// SuggestionProviders by id (`ask_server` asks the server; the client's -/// own argument suggestions stand in for it). +/// SuggestionProviders by id (`SuggestionProviders.getProvider`). fn provider(id: &str) -> Option<Suggests> { match id { + "minecraft:ask_server" => Some(Suggests::AskServer), "minecraft:summonable_entities" => Some(Suggests::SummonableEntities), _ => None, } diff --git a/crates/horizon-client/src/game/chat.rs b/crates/horizon-client/src/game/chat.rs index b19cd9d01..cb8a3a0b5 100644 --- a/crates/horizon-client/src/game/chat.rs +++ b/crates/horizon-client/src/game/chat.rs @@ -533,6 +533,23 @@ impl Game<'_> { } } } + /// The server's completions for an `ask_server` request + /// (ClientPacketListener.handleCommandSuggestions). + pub(super) fn chat_server_suggestions( + &mut self, + id: i32, + range: (usize, usize), + list: Vec<(String, Option<String>)>, + ) { + let m = Measure(&self.atlas.font); + let c = Commands { + dispatcher: chat_tree(&self.remote, &self.mods), + registries: &self.ui.registries, + }; + if let Some(screen) = self.ui.chat_screen.as_mut() { + screen.server_suggestions(&m, &c, id, range, list); + } + } /// Text typed into the chat box (control socket `chat`). pub(super) fn chat_type(&mut self, text: &str) { let m = Measure(&self.atlas.font); diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 991bc42b2..b15793003 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -558,8 +558,58 @@ impl Game<'_> { break; } } + self.send_suggestion_request(); Ok(()) } + /// ClientSuggestionProvider.customSuggestion: the chat's completion + /// request for an `ask_server` node goes to the server. + fn send_suggestion_request(&mut self) { + if self.remote.is_none() { + return; + } + let Some((id, command)) = self.ui.chat_screen.as_mut().and_then(|s| s.take_request()) + else { + return; + }; + let mut w = horizon_protocol::buf::Writer::new(); + w.varint(id); + w.string(&command); + self.send(S::Unknown( + horizon_protocol::ids::play::serverbound::COMMAND_SUGGESTION, + w.data, + )); + } + /// ClientboundCommandSuggestionsPacket: id, range start and length, then + /// each suggestion's text and optional tooltip. + fn handle_command_suggestions(&mut self, data: &[u8]) { + let lang = self + .remote + .as_ref() + .map(|r| r.lang.clone()) + .unwrap_or_default(); + let mut r = horizon_protocol::buf::Reader::new(data); + let decoded = (|| { + let id = r.varint()?; + let start = r.varint()?; + let length = r.varint()?; + let n = r.count(usize::MAX)?; + let mut list = Vec::with_capacity(n.min(1000)); + for _ in 0..n { + let text = r.string(32767)?; + let tooltip = if r.bool()? { + Some(plain(&r.nbt()?, &lang)) + } else { + None + }; + list.push((text, tooltip)); + } + horizon_protocol::Result::Ok((id, start, length, list)) + })(); + if let Ok((id, start, length, list)) = decoded { + let range = (start.max(0) as usize, length.max(0) as usize); + self.chat_server_suggestions(id, range, list); + } + } fn set_registries(&mut self, registries: Arc<Dynamic>) { let biomes: Vec<u16> = registries .registries @@ -1641,6 +1691,11 @@ impl Game<'_> { self.capture(true); } } + C::Unknown(id, data) + if id == horizon_protocol::ids::play::clientbound::COMMAND_SUGGESTIONS => + { + self.handle_command_suggestions(&data); + } C::Commands(p) => { let tree = horizon_client::command::network::from_packet( &p, diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index b1e7ec098..13b1d48aa 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -732,11 +732,29 @@ def check_commands(host, guest, out): screen = guest('state').get('screen') guest('command', command='gamemode survival') guest.wait(10) + # A node the tree marks ask_server (a bossbar id): the guest asks the + # server, which completes it from its own bossbars. + host('command', command='bossbar add pt6:check "Check"') + host.wait(5) + guest.raw('key', 'slash', 'tap') + guest.wait(3) + guest.raw('type', 'bossbar get pt') + guest.wait(10) + guest.raw('key', 'tab', 'tap') + guest.wait(2) + asked = chat_input(guest) + for _ in range(3): + if guest('screen').get('screen') != 'chat': + break + guest.raw('key', 'esc', 'tap') + guest.wait(3) + host('command', command='bossbar remove pt6:check') assert literal == '/gamemode', f'Tab after /gamem: {literal!r}' assert argument == '/gamemode creative', f'Tab after /gamemode cr: {argument!r}' assert mode == 'creative', f'the completed command did not run: {mode}' assert screen in (None, 'playing'), f'the chat did not close: {screen}' - return {'literal': literal, 'argument': argument, 'mode': mode} + assert asked == '/bossbar get pt6:check', f'Tab after /bossbar get pt: {asked!r}' + return {'literal': literal, 'argument': argument, 'mode': mode, 'ask_server': asked} def centre(rect): From 6f7096b39644e070d79e670389f9b22e3ef9272b Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 05:00:16 +0200 Subject: [PATCH 062/163] Ore veins: sample shared richness once, index the volume without division 26.3's copper and iron vein rules both bind minecraft:overworld/ore_vein/richness eagerly, so the material stage sampled the same root over the same chunk volume twice. Bindings of one compiled root now share its buffer; sampling is deterministic, so the values are identical. The two vein density reads per solid block went through DensityVolume::index_of_block, which divides and takes the remainder by the step on each axis. The stage's volumes are unit-step, so index them directly (falling back for strided volumes). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../worldgen/material_condition/density.rs | 153 ++++++++++++++++-- 1 file changed, 142 insertions(+), 11 deletions(-) diff --git a/crates/horizon-world/src/worldgen/material_condition/density.rs b/crates/horizon-world/src/worldgen/material_condition/density.rs index 5c98c75e0..b10ea815a 100644 --- a/crates/horizon-world/src/worldgen/material_condition/density.rs +++ b/crates/horizon-world/src/worldgen/material_condition/density.rs @@ -15,6 +15,8 @@ pub struct MaterialDensitySources<S: MaterialSurfaceQueries> { surface: S, expected: DensityVolume, densities: Vec<BoundDensity>, + /// Eagerly sampled volumes, shared by bindings of the same density root. + buffers: Vec<Vec<f32>>, retained_samples: usize, plane: DensityVolume, sampler: Arc<dyn DensitySampler>, @@ -23,7 +25,7 @@ pub struct MaterialDensitySources<S: MaterialSurfaceQueries> { } struct BoundDensity { sampler: Arc<dyn DensitySampler>, - buffer: Option<Vec<f32>>, + buffer: Option<usize>, } impl<S: MaterialSurfaceQueries> MaterialDensitySources<S> { pub fn sampler_context_mut(&mut self) -> &mut SamplerContext { @@ -50,6 +52,7 @@ impl<S: MaterialSurfaceQueries> MaterialDensitySources<S> { surface, expected, densities: Vec::new(), + buffers: Vec::new(), retained_samples: 0, plane, sampler, @@ -71,13 +74,23 @@ impl<S: MaterialSurfaceQueries> MaterialSurfaceQueries for MaterialDensitySource { return Err(DecodeError::Field("material density storage bound")); } - let buffer = if eager { - let mut buffer = vec![0.0; self.expected.size()]; - sampler.sample_volume(&mut self.context, &mut buffer, self.expected)?; - self.retained_samples += buffer.len(); - Some(buffer) - } else { - None + let shared = self + .densities + .iter() + .find(|bound| bound.buffer.is_some() && Arc::ptr_eq(&bound.sampler, &sampler)) + .and_then(|bound| bound.buffer); + let buffer = match (eager, shared) { + (false, _) => None, + // Sampling a root over the same volume and context is deterministic, + // so a second binding (iron and copper veins' richness) reuses it. + (true, Some(buffer)) => Some(buffer), + (true, None) => { + let mut buffer = vec![0.0; self.expected.size()]; + sampler.sample_volume(&mut self.context, &mut buffer, self.expected)?; + self.retained_samples += buffer.len(); + self.buffers.push(buffer); + Some(self.buffers.len() - 1) + } }; let index = self.densities.len(); self.densities.push(BoundDensity { sampler, buffer }); @@ -89,9 +102,9 @@ impl<S: MaterialSurfaceQueries> MaterialSurfaceQueries for MaterialDensitySource .get(index) .ok_or(MaterialRuleError::MissingDensityProvider)?; let position = [position.x, position.y, position.z]; - if let Some(buffer) = &source.buffer { - if let Some(index) = self.expected.index_of_block(position) { - return Ok(buffer[index]); + if let Some(buffer) = source.buffer { + if let Some(index) = block_index(self.expected, position) { + return Ok(self.buffers[buffer][index]); } } Ok(source.sampler.sample_value(&mut self.context, position)?) @@ -145,3 +158,121 @@ impl<S: MaterialSurfaceQueries> MaterialSurfaceQueries for MaterialDensitySource self.surface.band(position) } } + +/// `DensityVolume::index_of_block` without its per-axis divisions for the +/// unit-step volumes the material stage samples (one or two lookups per block). +#[inline] +fn block_index(volume: DensityVolume, position: [i32; 3]) -> Option<usize> { + if volume.steps() != [1; 3] { + return volume.index_of_block(position); + } + let [mx, my, mz] = volume.minimum(); + let [sx, sy, sz] = volume.sizes(); + let x = position[0].wrapping_sub(mx) as u32 as usize; + let y = position[1].wrapping_sub(my) as u32 as usize; + let z = position[2].wrapping_sub(mz) as u32 as usize; + (x < sx && y < sy && z < sz).then(|| y + (x + z * sx) * sy) +} + +#[cfg(test)] +mod tests { + use super::*; + use horizon_core::density::SampleError; + use std::sync::atomic::{AtomicUsize, Ordering}; + + struct Surface; + impl MaterialSurfaceQueries for Surface { + fn surface_depth(&mut self, _: i32, _: i32) -> i32 { + 0 + } + fn surface_secondary(&mut self, _: i32, _: i32) -> f64 { + 0.0 + } + } + /// Position-dependent values; counts bulk samples. + #[derive(Debug, Default)] + struct Counted(AtomicUsize); + impl DensitySampler for Counted { + fn sample_value(&self, _: &mut SamplerContext, p: [i32; 3]) -> Result<f32, SampleError> { + Ok((p[0] * 10_000 + p[1] * 100 + p[2]) as f32) + } + fn sample_volume( + &self, + context: &mut SamplerContext, + buffer: &mut [f32], + volume: DensityVolume, + ) -> Result<(), SampleError> { + self.0.fetch_add(1, Ordering::Relaxed); + for z in 0..volume.sizes()[2] { + for x in 0..volume.sizes()[0] { + for y in 0..volume.sizes()[1] { + let [mx, my, mz] = volume.minimum(); + let p = [mx + x as i32, my + y as i32, mz + z as i32]; + buffer[volume.index([x, y, z]).unwrap()] = self.sample_value(context, p)?; + } + } + } + Ok(()) + } + } + fn sources() -> MaterialDensitySources<Surface> { + let volume = DensityVolume::new([16, 24, 16], [32, -64, -16], [1; 3]).unwrap(); + MaterialDensitySources::new( + Surface, + volume, + Arc::new(Counted::default()), + SamplerContext::default(), + ) + .unwrap() + } + + #[test] + fn eager_bindings_of_one_root_share_a_single_sample() { + let mut sources = sources(); + let shared = Arc::new(Counted::default()); + let other = Arc::new(Counted::default()); + let a = sources.bind_density(shared.clone(), true).unwrap(); + let lazy = sources.bind_density(shared.clone(), false).unwrap(); + let b = sources.bind_density(shared.clone(), true).unwrap(); + let c = sources.bind_density(other.clone(), true).unwrap(); + assert_eq!(shared.0.load(Ordering::Relaxed), 1); + assert_eq!(other.0.load(Ordering::Relaxed), 1); + assert_eq!([a, lazy, b, c], [0, 1, 2, 3]); + for p in [[32, -64, -16], [47, -41, -1], [40, -50, -9], [48, 0, 0]] { + let position = BlockPos::new(p[0], p[1], p[2]); + let expected = (p[0] * 10_000 + p[1] * 100 + p[2]) as f32; + for index in [a, lazy, b, c] { + assert_eq!(sources.density(index, position).unwrap(), expected); + } + } + assert_eq!(shared.0.load(Ordering::Relaxed), 1); + } + + #[test] + fn block_index_matches_index_of_block() { + let unit = DensityVolume::new([16, 24, 16], [i32::MAX - 7, -64, -16], [1; 3]).unwrap(); + let strided = DensityVolume::new([5, 3, 5], [-8, -64, 0], [4, 8, 4]).unwrap(); + for volume in [unit, strided] { + let [mx, my, mz] = volume.minimum(); + for dx in [-1, 0, 1, 4, 7, 8, 15, 16, 17, 20] { + for dy in [-9, -1, 0, 8, 16, 23, 24] { + for dz in [-1, 0, 3, 15, 16, 20] { + let p = [ + mx.wrapping_add(dx), + my.wrapping_add(dy), + mz.wrapping_add(dz), + ]; + assert_eq!(block_index(volume, p), volume.index_of_block(p), "{p:?}"); + } + } + } + for p in [ + [i32::MIN, 0, 0], + [i32::MAX, i32::MAX, i32::MAX], + [0, i32::MIN, 0], + ] { + assert_eq!(block_index(volume, p), volume.index_of_block(p), "{p:?}"); + } + } + } +} From 65fc3b9f941d4573aded7e041bb2683c0860f655 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 22:23:11 +0200 Subject: [PATCH 063/163] Content mods: structure mods' worldgen joins the worldgen bundles A content mod's data/<ns>/worldgen/ files were copied into the content root, where nothing reads them: the worldgen loader reads bundles. The build now adds a mod's structures, structure sets, template pools, processor lists and configured and placed features to their bundles, its data/<ns>/structure/ templates to worldgen/structure/<ns>/, and its biome tags to the biome tag bundle. The loader refuses a biome tag naming what it lacks (another mod's biomes, a loader's convention tags), so those entries are dropped, as they are from block and item tags. Biomes, noise and density functions stay out: they would change vanilla's terrain. Structure and placement types Horizon does not have stay unsupported, as before; carry-over maps the common mod ones next. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/mod_content.rs | 100 +++++++++++++++++- .../horizon-client/src/mod_content_tests.rs | 81 ++++++++++++++ 2 files changed, 177 insertions(+), 4 deletions(-) diff --git a/crates/horizon-client/src/mod_content.rs b/crates/horizon-client/src/mod_content.rs index 8176ddfae..1cd155297 100644 --- a/crates/horizon-client/src/mod_content.rs +++ b/crates/horizon-client/src/mod_content.rs @@ -674,6 +674,28 @@ pub fn tag_namespaces(root: &Path) -> Vec<String> { /// Bundles of block tag files (tag id → the tag file's text). const TAG_BUNDLES: [&str; 2] = ["block-tags.json", "worldgen/block_tags.json"]; +/// The worldgen loader's bundle of biome tags. +const BIOME_TAGS: &str = "worldgen/biome_tags.json"; +/// Worldgen registries a content mod may add to, and the bundle the +/// worldgen loader reads each from (id → the file's text): what structure +/// mods hold. Biomes, noise and density functions change the terrain and +/// are not read from mods. +const WORLDGEN_BUNDLES: [(&str, &str); 6] = [ + ("structure", "worldgen/structures.json"), + ("structure_set", "worldgen/structure_sets.json"), + ("template_pool", "worldgen/template_pools.json"), + ("processor_list", "worldgen/processor_lists.json"), + ("configured_feature", "worldgen/features.json"), + ("placed_feature", "worldgen/placed_features.json"), +]; + +/// A mod file that adds to a worldgen bundle: (bundle, id). +fn worldgen_entry(file: &str) -> Option<(&'static str, String)> { + let (ns, rest) = file.strip_prefix("data/")?.split_once("/worldgen/")?; + let (kind, path) = rest.split_once('/')?; + let (_, bundle) = WORLDGEN_BUNDLES.iter().find(|(k, _)| *k == kind)?; + Some((bundle, format!("{ns}:{}", path.strip_suffix(".json")?))) +} /// The overlay being written: `out` mirrors `base` through links, and a /// directory becomes real only when something inside it is written. @@ -773,6 +795,9 @@ fn merge_tag(text: Option<&str>, more: &[J], what: &str) -> Result<String> { struct Known { blocks: std::collections::BTreeSet<String>, items: std::collections::BTreeSet<String>, + /// The worldgen loader's biomes and biome tags. + biomes: std::collections::BTreeSet<String>, + biome_tags: std::collections::BTreeSet<String>, /// `data/<ns>/tags/<kind>/<path>.json` files the mods add. tag_files: std::collections::BTreeSet<String>, } @@ -786,14 +811,27 @@ impl Known { items.extend(o.into_iter().map(|(k, _)| k)); } items.extend(plan.items.iter().map(|i| i.rename.to.clone())); + let keys = |name: &str| -> Result<std::collections::BTreeSet<String>> { + Ok(match base.join(name).exists() { + true => match read_json(&base.join(name))? { + J::Obj(o) => o.into_iter().map(|(k, _)| k).collect(), + _ => Default::default(), + }, + false => Default::default(), + }) + }; Ok(Known { blocks, items, + biomes: keys("worldgen/biomes.json")?, + biome_tags: keys(BIOME_TAGS)?, tag_files: tags.keys().cloned().collect(), }) } /// Whether tag `file` keeps entry `v`: a known id or an existing tag, - /// for block and item tags (other registries are kept as they are). + /// for block, item and biome tags (other registries are kept as they + /// are). The worldgen loader refuses a biome tag naming what it lacks + /// (another mod's biomes, a loader's tags), so those entries go. fn keeps(&self, file: &str, v: &J) -> bool { let id = match v { J::Str(s) => s.as_str(), @@ -803,23 +841,32 @@ impl Known { }, _ => return true, }; - let Some(kind) = file + let Some(rest) = file .strip_prefix("data/") .and_then(|r| r.split_once("/tags/")) - .and_then(|(_, rest)| Some(rest.split_once('/')?.0)) + .map(|(_, rest)| rest) else { return true; }; + let kind = match rest.strip_prefix("worldgen/biome/") { + Some(_) => "worldgen/biome", + None => rest.split_once('/').map_or("", |(k, _)| k), + }; let ids = match kind { "block" => &self.blocks, "item" => &self.items, + "worldgen/biome" => &self.biomes, _ => return true, }; match id.strip_prefix('#') { Some(tag) => { let (tns, path) = tag.split_once(':').unwrap_or(("minecraft", tag)); let rel = format!("data/{tns}/tags/{kind}/{path}.json"); - self.tag_files.contains(&rel) || tns == "minecraft" + self.tag_files.contains(&rel) + || match kind { + "worldgen/biome" => self.biome_tags.contains(&format!("{tns}:{path}")), + _ => tns == "minecraft", + } } None => ids.contains(id), } @@ -856,6 +903,7 @@ pub fn build(base: &Path, mods: &[ContentMod], out: &Path) -> Result<()> { } // Mod files, and every tag addition gathered per tag file. let mut tags: BTreeMap<String, Vec<J>> = BTreeMap::new(); + let mut worldgen: BTreeMap<&str, Vec<(String, String)>> = BTreeMap::new(); for m in mods { let declarations = format!("data/{}/horizon/", m.id); for file in &m.content.files { @@ -878,6 +926,18 @@ pub fn build(base: &Path, mods: &[ContentMod], out: &Path) -> Result<()> { .extend(values.iter().cloned()); } else if !file.starts_with(&declarations) { overlay.write(file, &bytes)?; + if let Some((bundle, id)) = worldgen_entry(file) { + let text = String::from_utf8(bytes).map_err(|e| format!("{file}: {e}"))?; + worldgen.entry(bundle).or_default().push((id, text)); + } else if let Some(template) = file + .strip_prefix("data/") + .and_then(|r| r.split_once("/structure/")) + .filter(|(_, path)| path.ends_with(".nbt")) + { + // The worldgen loader's templates: worldgen/structure/<ns>/<path>.nbt. + let (ns, path) = template; + overlay.write(&format!("worldgen/structure/{ns}/{path}"), &bytes)?; + } } } } @@ -921,6 +981,38 @@ pub fn build(base: &Path, mods: &[ContentMod], out: &Path) -> Result<()> { for (name, doc) in &bundles { overlay.write(name, &serde_json::to_vec(doc)?)?; } + // Biome tags, merged into the worldgen loader's bundle as block tags are. + let biome_tags: Vec<(String, &Vec<J>)> = tags + .iter() + .filter_map(|(file, values)| { + let (ns, path) = file + .strip_prefix("data/")? + .split_once("/tags/worldgen/biome/")?; + Some((format!("{ns}:{}", path.strip_suffix(".json")?), values)) + }) + .collect(); + if !biome_tags.is_empty() && base.join(BIOME_TAGS).exists() { + let mut doc = read_json(&base.join(BIOME_TAGS))?; + for (id, values) in biome_tags { + let text = match doc.get(&id) { + Some(J::Str(t)) => Some(t.clone()), + _ => None, + }; + doc.set(&id, J::Str(merge_tag(text.as_deref(), values, BIOME_TAGS)?)); + } + overlay.write(BIOME_TAGS, &serde_json::to_vec(&doc)?)?; + } + // Structures and the pools, sets, processors and features they use. + for (bundle, entries) in &worldgen { + if !base.join(bundle).exists() { + continue; + } + let mut doc = read_json(&base.join(bundle))?; + for (id, text) in entries { + doc.set(id, J::Str(text.clone())); + } + overlay.write(bundle, &serde_json::to_vec(&doc)?)?; + } // A block without its own blockstate looks like its template, so every // state still has a model. for m in mods { diff --git a/crates/horizon-client/src/mod_content_tests.rs b/crates/horizon-client/src/mod_content_tests.rs index c086f8c0c..614705562 100644 --- a/crates/horizon-client/src/mod_content_tests.rs +++ b/crates/horizon-client/src/mod_content_tests.rs @@ -537,3 +537,84 @@ fn content_root_is_reused_until_a_mod_changes() { ); let _ = fs::remove_dir_all(&scratch); } + +/// A structure mod's worldgen reaches the worldgen loader: its structure, +/// set, pool and templates join the bundles, and its biome tag keeps only +/// what the loader knows. +#[test] +fn content_root_carries_a_structure_mod() { + let Some(base) = prepared() else { + return; + }; + let scratch = std::env::temp_dir().join(format!("horizon-mod-worldgen-{}", std::process::id())); + let _ = fs::remove_dir_all(&scratch); + let dir = scratch.join("huts"); + let files = [ + ( + "horizon-mod.toml", + "id = \"huts\"\nname = \"Huts\"\nversion = \"1.0\"\napi = \"0.2\"\nside = \"both\"\ncapabilities = [\"registries\"]\n", + ), + ( + "data/huts/worldgen/structure/hut.json", + r##"{"type": "minecraft:jigsaw", "biomes": "#huts:has_hut", "step": "surface_structures", + "spawn_overrides": {}, "terrain_adaptation": "beard_thin", "start_pool": "huts:hut/start", + "size": 1, "start_height": {"absolute": 0}, "project_start_to_heightmap": "WORLD_SURFACE_WG", + "max_distance_from_center": 80}"##, + ), + ( + "data/huts/worldgen/template_pool/hut/start.json", + r#"{"fallback": "minecraft:empty", "elements": [{"weight": 1, "element": { + "element_type": "minecraft:single_pool_element", "location": "huts:hut", + "projection": "rigid", "processors": "minecraft:empty"}}]}"#, + ), + ( + "data/huts/worldgen/structure_set/huts.json", + r#"{"structures": [{"structure": "huts:hut", "weight": 1}], + "placement": {"type": "minecraft:random_spread", "salt": 7, "spacing": 4, "separation": 2}}"#, + ), + ( + "data/huts/tags/worldgen/biome/has_hut.json", + r##"{"values": ["#minecraft:is_overworld", "#c:is_plains", "othermod:glade", "minecraft:plains"]}"##, + ), + ]; + for (name, text) in files { + let path = dir.join(name); + fs::create_dir_all(path.parent().unwrap()).unwrap(); + fs::write(path, text).unwrap(); + } + // The template: vanilla's smallest plains house, as the mod's own file. + let house = + base.join("worldgen/structure/minecraft/village/plains/houses/plains_small_house_1.nbt"); + fs::create_dir_all(dir.join("data/huts/structure")).unwrap(); + fs::copy(&house, dir.join("data/huts/structure/hut.nbt")).unwrap(); + let package = horizon_mods::Package::read(&dir).unwrap(); + let m = ContentMod { + id: "huts".into(), + content: Content::read(&dir, &package.manifest).unwrap(), + }; + let root = resource_root(&base, &[m], &scratch.join("cache")).unwrap(); + assert!(root.join("worldgen/structure/huts/hut.nbt").exists()); + let tags: BTreeMap<String, String> = + serde_json::from_slice(&fs::read(root.join("worldgen/biome_tags.json")).unwrap()).unwrap(); + let hut: serde_json::Value = serde_json::from_str(&tags["huts:has_hut"]).unwrap(); + assert_eq!( + hut["values"], + serde_json::json!(["#minecraft:is_overworld", "minecraft:plains"]) + ); + + let assets = Assets::load(&root).unwrap(); + let biomes = crate::biome::Biomes::load(&root).unwrap(); + let terrain = crate::vanillagen::VanillaTerrain::new( + &root.join("worldgen"), + assets.registry, + &biomes, + 1234, + ) + .unwrap(); + let (name, at) = terrain + .locate(&["huts:hut".to_owned()], [0, 64, 0], 16) + .expect("the mod's structure generates"); + assert_eq!(name, "huts:hut"); + assert!(at[0].abs() < 1024 && at[2].abs() < 1024, "{at:?}"); + let _ = fs::remove_dir_all(&scratch); +} From cf97a5e1dc164d51d3fef86bf8b0f56d33f45902 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 05:44:08 +0200 Subject: [PATCH 064/163] Decoration order: dense grids instead of hash maps vanilla_order replays vanilla's ticket scheduler over every chunk in view each time the player crosses into another chunk, on the render thread. At render distance 32 that is about 200,000 level updates in SipHash maps: 8 ms per call. Over dense grids covering the square it can touch, the same replay takes 1 ms. A test checks the order against the hash map version for several centres and radii. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../src/worldgen/decoration_order.rs | 155 +++++++++++++++--- 1 file changed, 133 insertions(+), 22 deletions(-) diff --git a/crates/horizon-world/src/worldgen/decoration_order.rs b/crates/horizon-world/src/worldgen/decoration_order.rs index 52649ceed..6b0fb2252 100644 --- a/crates/horizon-world/src/worldgen/decoration_order.rs +++ b/crates/horizon-world/src/worldgen/decoration_order.rs @@ -121,7 +121,7 @@ fn ticket_hash(x: i32, z: i32) -> u64 { /// The chunks decorated around a player at `center`, in vanilla's order. pub fn vanilla_order(center: (i32, i32), radius: i32) -> Vec<(i32, i32)> { use std::cmp::Reverse; - use std::collections::{BinaryHeap, HashSet, VecDeque}; + use std::collections::{BinaryHeap, VecDeque}; let mut tickets: Vec<(i32, i32)> = (-radius..=radius) .flat_map(|dx| (-radius..=radius).map(move |dz| (center.0 + dx, center.1 + dz))) .collect(); @@ -133,35 +133,45 @@ pub fn vanilla_order(center: (i32, i32), radius: i32) -> Vec<(i32, i32)> { ) }); let mut tickets: VecDeque<_> = tickets.into(); + // Every chunk this touches lies within `half` of the centre: tickets + // reach `LIGHT_LEVEL - TICKET_LEVEL` further, and FULL tasks decorate + // one more ring. Dense grids over that square replace hash maps. + let reach = LIGHT_LEVEL - TICKET_LEVEL; + let half = radius.max(0) + reach + 1; + let side = (2 * half + 1) as usize; + let cell = |(x, z): (i32, i32)| { + ((x - center.0 + half) as usize) * side + (z - center.1 + half) as usize + }; let mut active: Vec<(i32, i32)> = Vec::new(); - // Queued task per chunk (level, sequence); stale heap entries are skipped. - let mut queued: HashMap<(i32, i32), (i32, u64)> = HashMap::new(); + // Queued task per chunk (level, sequence), `NONE` when there is none; + // stale heap entries are skipped. + const NONE: (i32, u64) = (i32::MAX, 0); + let mut queued = vec![NONE; side * side]; let mut heap = BinaryHeap::new(); let mut sequence = 0u64; - let mut full = HashSet::new(); - let mut seen = HashSet::new(); + let mut full = vec![false; side * side]; + let mut seen = vec![false; side * side]; let mut order = Vec::new(); // Each ticket lowers the levels around it to 31 + its Chebyshev distance. - let mut levels: HashMap<(i32, i32), i32> = HashMap::new(); + let mut levels = vec![i32::MAX; side * side]; let mut add = |ticket: (i32, i32), active: &mut Vec<(i32, i32)>, - queued: &mut HashMap<(i32, i32), (i32, u64)>, + queued: &mut [(i32, u64)], heap: &mut BinaryHeap<Reverse<(i32, u64, (i32, i32))>>, - full: &HashSet<(i32, i32)>| { + full: &[bool]| { active.push(ticket); - let reach = LIGHT_LEVEL - TICKET_LEVEL; for x in ticket.0 - reach..=ticket.0 + reach { for z in ticket.1 - reach..=ticket.1 + reach { let own = TICKET_LEVEL + (x - ticket.0).abs().max((z - ticket.1).abs()); - let l = levels.entry((x, z)).or_insert(i32::MAX); - *l = (*l).min(own); - let l = *l; - if full.contains(&(x, z)) { + let i = cell((x, z)); + levels[i] = levels[i].min(own); + let l = levels[i]; + if full[i] { continue; } - if queued.get(&(x, z)).is_none_or(|&(old, _)| l < old) { + if l < queued[i].0 { sequence += 1; - queued.insert((x, z), (l, sequence)); + queued[i] = (l, sequence); heap.push(Reverse((l, sequence, (x, z)))); } } @@ -173,24 +183,25 @@ pub fn vanilla_order(center: (i32, i32), radius: i32) -> Vec<(i32, i32)> { } } while let Some(Reverse((l, s, chunk))) = heap.pop() { - if queued.get(&chunk) != Some(&(l, s)) { + let i = cell(chunk); + if queued[i] != (l, s) { continue; } - queued.remove(&chunk); + queued[i] = NONE; let r = i32::from(l <= FULL_LEVEL); for x in chunk.0 - r..=chunk.0 + r { for z in chunk.1 - r..=chunk.1 + r { - if seen.insert((x, z)) { + let seen = &mut seen[cell((x, z))]; + if !*seen { + *seen = true; order.push((x, z)); } } } if l <= FULL_LEVEL { - full.insert(chunk); + full[i] = true; } - active.retain(|t| { - !(-2..=2).all(|dx| (-2..=2).all(|dz| full.contains(&(t.0 + dx, t.1 + dz)))) - }); + active.retain(|t| !(-2..=2).all(|dx| (-2..=2).all(|dz| full[cell((t.0 + dx, t.1 + dz))]))); while active.len() < TICKETS_IN_FLIGHT { let Some(t) = tickets.pop_front() else { break }; add(t, &mut active, &mut queued, &mut heap, &full); @@ -203,6 +214,106 @@ pub fn vanilla_order(center: (i32, i32), radius: i32) -> Vec<(i32, i32)> { mod tests { use super::*; + /// The hash map version this module had before its dense grids. + fn hashed_order(center: (i32, i32), radius: i32) -> Vec<(i32, i32)> { + use std::cmp::Reverse; + use std::collections::{BinaryHeap, HashSet, VecDeque}; + let mut tickets: Vec<(i32, i32)> = (-radius..=radius) + .flat_map(|dx| (-radius..=radius).map(move |dz| (center.0 + dx, center.1 + dz))) + .collect(); + // A fastutil open hash set iterates its slots from the last to the first. + tickets.sort_by_key(|&(x, z)| { + ( + (x - center.0).abs().max((z - center.1).abs()), + Reverse(ticket_hash(x, z) & (TICKET_SET_CAPACITY - 1)), + ) + }); + let mut tickets: VecDeque<_> = tickets.into(); + let mut active: Vec<(i32, i32)> = Vec::new(); + // Queued task per chunk (level, sequence); stale heap entries are skipped. + let mut queued: HashMap<(i32, i32), (i32, u64)> = HashMap::new(); + let mut heap = BinaryHeap::new(); + let mut sequence = 0u64; + let mut full = HashSet::new(); + let mut seen = HashSet::new(); + let mut order = Vec::new(); + // Each ticket lowers the levels around it to 31 + its Chebyshev distance. + let mut levels: HashMap<(i32, i32), i32> = HashMap::new(); + let mut add = |ticket: (i32, i32), + active: &mut Vec<(i32, i32)>, + queued: &mut HashMap<(i32, i32), (i32, u64)>, + heap: &mut BinaryHeap<Reverse<(i32, u64, (i32, i32))>>, + full: &HashSet<(i32, i32)>| { + active.push(ticket); + let reach = LIGHT_LEVEL - TICKET_LEVEL; + for x in ticket.0 - reach..=ticket.0 + reach { + for z in ticket.1 - reach..=ticket.1 + reach { + let own = TICKET_LEVEL + (x - ticket.0).abs().max((z - ticket.1).abs()); + let l = levels.entry((x, z)).or_insert(i32::MAX); + *l = (*l).min(own); + let l = *l; + if full.contains(&(x, z)) { + continue; + } + if queued.get(&(x, z)).is_none_or(|&(old, _)| l < old) { + sequence += 1; + queued.insert((x, z), (l, sequence)); + heap.push(Reverse((l, sequence, (x, z)))); + } + } + } + }; + for _ in 0..TICKETS_IN_FLIGHT { + if let Some(t) = tickets.pop_front() { + add(t, &mut active, &mut queued, &mut heap, &full); + } + } + while let Some(Reverse((l, s, chunk))) = heap.pop() { + if queued.get(&chunk) != Some(&(l, s)) { + continue; + } + queued.remove(&chunk); + let r = i32::from(l <= FULL_LEVEL); + for x in chunk.0 - r..=chunk.0 + r { + for z in chunk.1 - r..=chunk.1 + r { + if seen.insert((x, z)) { + order.push((x, z)); + } + } + } + if l <= FULL_LEVEL { + full.insert(chunk); + } + active.retain(|t| { + !(-2..=2).all(|dx| (-2..=2).all(|dz| full.contains(&(t.0 + dx, t.1 + dz)))) + }); + while active.len() < TICKETS_IN_FLIGHT { + let Some(t) = tickets.pop_front() else { break }; + add(t, &mut active, &mut queued, &mut heap, &full); + } + } + order + } + + #[test] + fn dense_grids_keep_the_hashed_order() { + for (center, radius) in [ + ((0, 0), -1), + ((0, 0), 0), + ((0, 0), 1), + ((12, -15), 8), + ((-30_000, 29_999), 5), + ((7, 3), 12), + ((-61, 1234), 32), + ] { + assert_eq!( + vanilla_order(center, radius), + hashed_order(center, radius), + "{center:?} radius {radius}" + ); + } + } + #[test] fn first_wave_matches_vanilla() { // Seed 1891623539983467248, player teleported into chunk 12,-15 with From b540ccb642a20d6a22c75383dd49fd4817410e95 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 07:17:44 +0200 Subject: [PATCH 065/163] Brewing stands tick in the level's block entity ticker list Brewing stands were the last server ticker with a pass of its own over the whole block entity map every tick. They now tick in their place in Level.blockEntityTickers, as BrewingStandBlock.getTicker makes them: in list order, only in block-ticking range and inside the world border, with their bottle states written as each one ticks. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game.rs | 1 - .../src/game/block_entity_ticks.rs | 4 ++- crates/horizon-client/src/game/stations.rs | 32 +++++++++---------- tools/test_block_entity_tickers_parity.py | 4 +-- 4 files changed, 21 insertions(+), 20 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 2ab3a7c07..d4a595a3f 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -3617,7 +3617,6 @@ impl Game<'_> { horizon_client::spans::time("tick_block_entities", || self.tick_block_entities())?; horizon_client::spans::time("tick_sculk_entities", || self.tick_sculk_entities()); horizon_client::spans::time("tick_sculk_blocks", || self.tick_sculk_blocks())?; - horizon_client::spans::time("tick_brewing_stands", || self.tick_brewing_stands())?; } if running { // ClientLevel.tickBlockEntities (not while paused or frozen): diff --git a/crates/horizon-client/src/game/block_entity_ticks.rs b/crates/horizon-client/src/game/block_entity_ticks.rs index afe1224fb..f596f2d8b 100644 --- a/crates/horizon-client/src/game/block_entity_ticks.rs +++ b/crates/horizon-client/src/game/block_entity_ticks.rs @@ -52,6 +52,7 @@ impl Game<'_> { Some(BlockEntity::Vault(_)) => self.tick_vault(pos)?, Some(BlockEntity::Beehive(_)) => self.tick_beehive(pos), Some(BlockEntity::Furnace(_)) => self.tick_furnace(pos)?, + Some(BlockEntity::Brewing(_)) => self.tick_brewing_stand(pos)?, _ => {} } } @@ -85,7 +86,8 @@ impl Game<'_> { | "minecraft:trial_spawner" | "minecraft:vault" | "minecraft:beehive" - | "minecraft:bee_nest" => Ticking::Yes, + | "minecraft:bee_nest" + | "minecraft:brewing_stand" => Ticking::Yes, "minecraft:jukebox" => { let record = registry .state(state) diff --git a/crates/horizon-client/src/game/stations.rs b/crates/horizon-client/src/game/stations.rs index 332f06b23..7b70cb1f1 100644 --- a/crates/horizon-client/src/game/stations.rs +++ b/crates/horizon-client/src/game/stations.rs @@ -2173,22 +2173,22 @@ impl Game<'_> { // ---------------------------------------------------------------- brewing stand - /// Ticks every brewing stand (`BrewingStandBlockEntity.serverTick`). - pub(super) fn tick_brewing_stands(&mut self) -> horizon_client::Result<()> { - let mut changes = Vec::new(); - for (pos, entity) in self.world.block_entities.iter_mut() { - if let BlockEntity::Brewing(b) = entity { - let out = b.tick( - &self.res.stations.brewing, - &self.res.items, - &self.res.providers, - ); - if out != brewing::BrewTick::default() { - changes.push((*pos, out)); - } - } - } - for ((x, y, z), out) in changes { + /// `BrewingStandBlockEntity.serverTick` of the brewing stand at `pos`, in + /// its place among the level's block entity tickers. + pub(super) fn tick_brewing_stand( + &mut self, + pos: (i32, i32, i32), + ) -> horizon_client::Result<()> { + let Some(BlockEntity::Brewing(b)) = self.world.block_entities.get_mut(&pos) else { + return Ok(()); + }; + let out = b.tick( + &self.res.stations.brewing, + &self.res.items, + &self.res.providers, + ); + if out != brewing::BrewTick::default() { + let (x, y, z) = pos; self.world.modified.insert((x >> 4, z >> 4)); if out.brewed { self.play_at("minecraft:block.brewing_stand.brew", [x, y, z], 1.0, 1.0); diff --git a/tools/test_block_entity_tickers_parity.py b/tools/test_block_entity_tickers_parity.py index 58604b269..459e7a926 100644 --- a/tools/test_block_entity_tickers_parity.py +++ b/tools/test_block_entity_tickers_parity.py @@ -9,7 +9,7 @@ of a server level and prints, after each tick, the positions of the live tickers in list order; `examples/block_entity_tickers_fixture` runs the same on `horizon_client::block_entities::BlockEntities`. The block entities are the kinds the game ticks in that list (hoppers, furnaces, beacons, spawners, -trial spawners, vaults, hives, crafters, jukebox), with chests and barrels, +trial spawners, vaults, hives, crafters, brewing stands, jukebox), with chests and barrels, which have no ticker, among them. """ import argparse @@ -25,7 +25,7 @@ except ImportError: PARITY = lab.ROOT / 'mods/horizon/src/test/java/dev/horizonlab/parity' TICKING = ['hopper', 'furnace', 'blast_furnace', 'smoker', 'beacon', 'spawner', 'trial_spawner', 'vault', - 'beehive', 'bee_nest', 'crafter', 'jukebox_record'] + 'beehive', 'bee_nest', 'crafter', 'brewing_stand', 'jukebox_record'] KINDS = TICKING + ['jukebox', 'chest', 'barrel'] From 29327041567b12ea441352d6803232e181331090 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 06:55:44 +0200 Subject: [PATCH 066/163] Region files: write each saved chunk in place, as vanilla's RegionFile Saving a chunk read every chunk of its region file and wrote them all to a new file. The writer now writes only the saved chunk, into the first free run of sectors (RegionBitmap), points the header at it and then frees its old sectors (RegionFile.write / clear), with one flush per region and batch. Readers and the writer share one open file per region. A chunk queued again before the writer reached it is written once, by its newest batch (IOWorker.pendingWrites). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/save.rs | 163 ++++++++++++------------ crates/horizon-world/src/region.rs | 165 ++++++++++++++++++++++++- crates/horizon-world/tests/world_io.rs | 118 ++++++++++++++++++ 3 files changed, 357 insertions(+), 89 deletions(-) diff --git a/crates/horizon-client/src/save.rs b/crates/horizon-client/src/save.rs index c60da2caa..d94bb7182 100644 --- a/crates/horizon-client/src/save.rs +++ b/crates/horizon-client/src/save.rs @@ -31,7 +31,7 @@ use horizon_world::{ compression::Compression, heightmap::{Heightmap, HeightmapChunk, HeightmapType}, nbt::{self, Compound, JavaString, Limits, NamedTag, Tag}, - region::{ChunkRecord, RegionFile, RegionWriter}, + region::{ChunkRecord, RegionFile}, registry::{BlockRegistry, BlockStateId}, worldgen::terrain::TerrainBlockStates, }; @@ -1306,94 +1306,87 @@ pub fn load_light(tag: &Tag, chunk: &mut Chunk, sky_light: bool) { } type RegionCache = Mutex<HashMap<(i32, i32), Option<Arc<Mutex<RegionFile>>>>>; -/// Rewrite every region file in `folder` touched by `records`, keeping its -/// other chunks. `None` deletes a chunk. +/// The region file at `path` through the cache, which readers and the writer +/// share, so a read never sees a header older than the sectors it points to. +/// `create` makes a missing file (for a write); otherwise a missing file is +/// `None`, until a write creates it. +fn cached_region( + cache: &RegionCache, + key: (i32, i32), + path: &Path, + create: bool, +) -> Result<Option<Arc<Mutex<RegionFile>>>> { + let mut regions = cache.lock().map_err(|_| "region cache poisoned")?; + if let Some(Some(region)) = regions.get(&key) { + return Ok(Some(region.clone())); + } + if !create && regions.contains_key(&key) { + return Ok(None); + } + if create && let Some(parent) = path.parent() { + fs::create_dir_all(parent)?; + } + // A file this process can't write (a read-only world) is still read. + let region = match RegionFile::open_writable(path, create) { + Err(e) if !create && e.kind() == std::io::ErrorKind::PermissionDenied => { + RegionFile::open(path) + } + other => other, + }; + let region = match region { + Ok(r) => Some(Arc::new(Mutex::new(r))), + Err(_) if !create => None, + Err(e) => return Err(e.into()), + }; + regions.insert(key, region.clone()); + Ok(region) +} +/// Write `records` into the region files of `folder` in place, as vanilla's +/// `RegionFile.write` does: each chunk takes free sectors and the header +/// then points to it; the region's other chunks are not touched. `None` +/// clears a chunk. The chunks are compressed before their region is locked +/// for the writes, and each region is flushed to the disk once. fn write_region_records( root: &Path, cache: &RegionCache, folder: &str, records: Vec<((i32, i32), Option<Arc<NamedTag>>)>, ) -> Result<()> { - let mut by_region: BTreeMap<(i32, i32), Vec<((i32, i32), Option<Arc<NamedTag>>)>> = - BTreeMap::new(); - for (key, tag) in records { - by_region - .entry((key.0 >> 5, key.1 >> 5)) - .or_default() - .push((key, tag)); - } - if by_region.is_empty() { - return Ok(()); - } - let staging = root.join(folder).join(".staging"); - fs::create_dir_all(&staging)?; let timestamp = std::time::SystemTime::now() .duration_since(std::time::UNIX_EPOCH) .map_or(0, |d| d.as_secs() as u32); + let mut by_region: BTreeMap<(i32, i32), Vec<(ChunkPos, Option<ChunkRecord>)>> = BTreeMap::new(); + for ((x, z), tag) in records { + let record = tag + .map(|tag| ChunkRecord::from_nbt(&tag, Compression::Zlib, timestamp, Limits::default())) + .transpose()?; + by_region + .entry((x >> 5, z >> 5)) + .or_default() + .push((ChunkPos::new(x, z), record)); + } for ((rx, rz), list) in by_region { let path = region_path(root, folder, rx, rz); - let mut records: BTreeMap<(i32, i32), ChunkRecord> = BTreeMap::new(); - let only_deletes = list.iter().all(|(_, tag)| tag.is_none()); - if let Ok(mut existing) = RegionFile::open(&path) { - let positions: Vec<ChunkPos> = existing.chunks().map(|(p, _)| p).collect(); - if only_deletes - && !positions - .iter() - .any(|p| list.iter().any(|(k, _)| *k == (p.x, p.z))) - { - continue; - } - for p in positions { - if let Ok(Some(r)) = existing.read(p) { - records.insert((p.x, p.z), r); - } - } - } else if only_deletes { + // Clearing chunks of a region that doesn't exist changes nothing. + let create = list.iter().any(|(_, r)| r.is_some()); + let Some(region) = cached_region(cache, (rx, rz), &path, create)? else { continue; - } - // Deleting chunks the region doesn't hold changes nothing: leave - // the file alone (unloading empty entity chunks asks for that). + }; + let mut region = region.lock().map_err(|_| "region file poisoned")?; let mut changed = false; - for (key, tag) in list { - match tag { - Some(tag) => { + for (pos, record) in &list { + match record { + Some(record) => { + region.write(*pos, record)?; changed = true; - records.insert( - key, - ChunkRecord::from_nbt( - &tag, - Compression::Zlib, - timestamp, - Limits::default(), - )?, - ); - } - None => { - changed |= records.remove(&key).is_some(); } + None => changed |= region.clear(*pos, timestamp)?, } } - if !changed { - continue; + if changed { + region.sync()?; } - if records.is_empty() { - let _ = fs::remove_file(&path); - } else { - let temporary = staging.join(format!("r.{rx}.{rz}.mca")); - let _ = fs::remove_file(&temporary); - let mut writer = RegionWriter::create(&temporary)?; - for ((x, z), r) in &records { - writer.write(ChunkPos::new(*x, *z), r)?; - } - writer.finish()?; - fs::rename(&temporary, &path)?; - } - cache - .lock() - .map_err(|_| "region cache poisoned")? - .remove(&(rx, rz)); } - let _ = fs::remove_dir(&staging); Ok(()) } @@ -1436,7 +1429,7 @@ impl Record { type PendingWrites = Mutex<HashMap<(bool, i32, i32), (u64, Record)>>; type WriteBatch = (bool, Vec<((i32, i32), Record, u64)>); -/// The background thread that encodes chunks and rewrites region files, in +/// The background thread that encodes chunks and writes them into the region files, in /// submission order. struct Writer { send: mpsc::Sender<WriteBatch>, @@ -1498,17 +1491,8 @@ impl SaveDir { } else { &self.entity_regions }; - let region = { - let mut regions = cache.lock().ok()?; - regions - .entry(key) - .or_insert_with(|| { - RegionFile::open(self.region_path(folder, key.0, key.1)) - .ok() - .map(|r| Arc::new(Mutex::new(r))) - }) - .clone()? - }; + let path = self.region_path(folder, key.0, key.1); + let region = cached_region(cache, key, &path, false).ok()??; let record = region.lock().ok()?.read(ChunkPos::new(x, z)).ok()??; record.nbt(Limits::default()).ok() } @@ -1614,7 +1598,18 @@ impl SaveDir { } else { ("region", ®ions) }; - let records = batch.iter().map(|(k, r, _)| (*k, r.tag())).collect(); + // IOWorker.pendingWrites: a chunk queued again since is + // written once, by its newest batch. + let newest = |k: &(i32, i32), seq: u64| { + pending.lock().map_or(true, |p| { + p.get(&(entities, k.0, k.1)).is_none_or(|p| p.0 <= seq) + }) + }; + let records = batch + .iter() + .filter(|(k, _, seq)| newest(k, *seq)) + .map(|(k, r, _)| (*k, r.tag())) + .collect(); if let Err(e) = write_region_records(&root, cache, folder, records) { log::warn!("Horizon: failed to write {folder} files: {e}"); } @@ -1650,7 +1645,7 @@ impl SaveDir { }; } } - /// Rewrite every region touched by `chunks`, keeping their other chunks. + /// Write `chunks` into their region files and wait until they are on disk. pub fn save( &self, chunks: &[Arc<Chunk>], diff --git a/crates/horizon-world/src/region.rs b/crates/horizon-world/src/region.rs index 05bdc1a54..1e4ba176c 100644 --- a/crates/horizon-world/src/region.rs +++ b/crates/horizon-world/src/region.rs @@ -1,5 +1,7 @@ -//! Anvil region reading and export to a new region. Existing files are never -//! overwritten. Use a separate directory for offline edits and copied .mcc data. +//! Anvil region reading, export to a new region, and in-place chunk writes +//! as vanilla's `RegionFile` makes them (a file opened with `open_writable`). +//! Exports never overwrite a file: use a separate directory for offline +//! edits and copied .mcc data. use crate::{ compression::{Compression, invalid}, nbt::{self, Limits, NamedTag}, @@ -54,6 +56,9 @@ pub struct RegionFile { position: ChunkPos, offsets: [u32; 1024], timestamps: [u32; 1024], + /// The sectors in use (`RegionBitmap`): the header's two and every + /// chunk's. + used: Vec<bool>, } pub fn position_from_path(path: &Path) -> io::Result<ChunkPos> { @@ -94,6 +99,12 @@ fn position(region: ChunkPos, index: usize) -> ChunkPos { fn external_path(directory: &Path, chunk: ChunkPos) -> PathBuf { directory.join(format!("c.{}.{}.mcc", chunk.x, chunk.z)) } +fn remove_if_exists(path: &Path) -> io::Result<()> { + match fs::remove_file(path) { + Err(e) if e.kind() != io::ErrorKind::NotFound => Err(e), + _ => Ok(()), + } +} impl RegionFile { pub fn position(&self) -> ChunkPos { @@ -101,8 +112,25 @@ impl RegionFile { } pub fn open(path: impl AsRef<Path>) -> io::Result<Self> { let path = path.as_ref().to_owned(); + let file = File::open(&path)?; + Self::from_file(path, file) + } + + /// Open for reading and in-place writes (`write`, `clear`), creating an + /// empty region with `create`. + pub fn open_writable(path: impl AsRef<Path>, create: bool) -> io::Result<Self> { + let path = path.as_ref().to_owned(); + let file = OpenOptions::new() + .read(true) + .write(true) + .create(create) + .truncate(false) + .open(&path)?; + Self::from_file(path, file) + } + + fn from_file(path: PathBuf, mut file: File) -> io::Result<Self> { let position = position_from_path(&path)?; - let mut file = File::open(&path)?; let len = file.metadata()?.len(); // RegionFile's constructor: a short header (an empty or truncated file) // reads as far as it goes, the rest stays zero (no chunks). @@ -134,13 +162,140 @@ impl RegionFile { offsets[i] = 0; } } - Ok(Self { + let mut region = Self { file, path, position, offsets, timestamps, - }) + used: Vec::new(), + }; + region.force(0, 2); + for offset in offsets.into_iter().filter(|&o| o != 0) { + region.force((offset >> 8) as usize, (offset & 255) as usize); + } + Ok(region) + } + + /// `RegionBitmap.force`. + fn force(&mut self, start: usize, count: usize) { + if self.used.len() < start + count { + self.used.resize(start + count, false); + } + self.used[start..start + count].fill(true); + } + /// `RegionBitmap.free`. + fn free(&mut self, start: usize, count: usize) { + let end = (start + count).min(self.used.len()); + if start < end { + self.used[start..end].fill(false); + } + } + /// `RegionBitmap.allocate`: the first run of free sectors long enough + /// (the end of the file is free). + fn allocate(&mut self, count: usize) -> usize { + let mut current = 0; + loop { + let start = (current..self.used.len()) + .find(|&s| !self.used[s]) + .unwrap_or(self.used.len()); + let end = (start..self.used.len()).find(|&s| self.used[s]); + if end.is_none_or(|end| end - start >= count) { + self.force(start, count); + return start; + } + current = end.unwrap_or(start); + } + } + + /// `RegionFile.write`: the chunk goes to the first free run of sectors + /// that holds it (an oversized one, 256 sectors or more, to its external + /// `c.X.Z.mcc` file with a one-sector stub), the header points to it, + /// and only then are its old sectors freed. The other chunks stay where + /// they are. A chunk's last sector is padded with zeros. + pub fn write(&mut self, chunk: ChunkPos, record: &ChunkRecord) -> io::Result<()> { + let i = slot(self.position, chunk)?; + if record.compressed.len() > MAX_COMPRESSED { + return Err(invalid("compressed chunk limit exceeded")); + } + let required = (record.compressed.len() + 5).div_ceil(SECTOR); + let external = required >= 256; + let sectors = if external { 1 } else { required }; + let start = self.allocate(sectors); + if start + sectors > 0x100_0000 { + self.free(start, sectors); + return Err(invalid("region sector address limit exceeded")); + } + let directory = self.path.parent().unwrap_or(Path::new(".")).to_owned(); + let external_file = external_path(&directory, chunk); + let mut data = Vec::with_capacity(sectors * SECTOR); + if external { + let temporary = directory.join(format!(".c.{}.{}.mcc.tmp", chunk.x, chunk.z)); + let written = File::create(&temporary) + .and_then(|mut f| f.write_all(&record.compressed)) + .and_then(|_| fs::rename(&temporary, &external_file)); + if let Err(e) = written { + let _ = fs::remove_file(&temporary); + self.free(start, sectors); + return Err(e); + } + data.extend_from_slice(&1u32.to_be_bytes()); + data.push(record.compression as u8 | 128); + } else { + data.extend_from_slice(&(record.compressed.len() as u32 + 1).to_be_bytes()); + data.push(record.compression as u8); + data.extend_from_slice(&record.compressed); + } + data.resize(sectors * SECTOR, 0); + let written = self + .file + .seek(SeekFrom::Start((start * SECTOR) as u64)) + .and_then(|_| self.file.write_all(&data)); + if let Err(e) = written { + self.free(start, sectors); + return Err(e); + } + let old = self.offsets[i]; + self.offsets[i] = (start as u32) << 8 | sectors as u32; + self.timestamps[i] = record.timestamp; + self.write_header_entry(i)?; + if !external { + remove_if_exists(&external_file)?; + } + if old != 0 { + self.free((old >> 8) as usize, (old & 255) as usize); + } + Ok(()) + } + + /// `RegionFile.clear`: the chunk is gone; `timestamp` marks when. + /// Returns whether the region held it. + pub fn clear(&mut self, chunk: ChunkPos, timestamp: u32) -> io::Result<bool> { + let i = slot(self.position, chunk)?; + let old = self.offsets[i]; + if old == 0 { + return Ok(false); + } + self.offsets[i] = 0; + self.timestamps[i] = timestamp; + self.write_header_entry(i)?; + let directory = self.path.parent().unwrap_or(Path::new(".")); + remove_if_exists(&external_path(directory, chunk))?; + self.free((old >> 8) as usize, (old & 255) as usize); + Ok(true) + } + + /// Flush the writes to the disk. + pub fn sync(&self) -> io::Result<()> { + self.file.sync_data() + } + + /// The header's offset and timestamp of slot `i`. + fn write_header_entry(&mut self, i: usize) -> io::Result<()> { + self.file.seek(SeekFrom::Start((i * 4) as u64))?; + self.file.write_all(&self.offsets[i].to_be_bytes())?; + self.file.seek(SeekFrom::Start((SECTOR + i * 4) as u64))?; + self.file.write_all(&self.timestamps[i].to_be_bytes()) } pub fn chunks(&self) -> impl Iterator<Item = (ChunkPos, u32)> + '_ { diff --git a/crates/horizon-world/tests/world_io.rs b/crates/horizon-world/tests/world_io.rs index 65b5006a8..3dd897794 100644 --- a/crates/horizon-world/tests/world_io.rs +++ b/crates/horizon-world/tests/world_io.rs @@ -74,6 +74,70 @@ fn external_threshold_negative_coordinates_and_timestamps_roundtrip() { assert!(reader.read(ChunkPos::new(0, 0)).is_err()); } +#[test] +fn in_place_writes_reuse_freed_sectors_and_keep_other_chunks() { + let dir = Directory::new(); + let (a, b, c) = ( + ChunkPos::new(-32, 0), + ChunkPos::new(-31, 0), + ChunkPos::new(-1, 31), + ); + let mut region = RegionFile::open_writable(dir.region(), true).unwrap(); + // RegionBitmap: a at sectors 2..4, b at 4. + region.write(a, &record(2 * 4096 - 5)).unwrap(); + region.write(b, &record(100)).unwrap(); + let sectors = |path: &Path| fs::metadata(path).unwrap().len() / 4096; + assert_eq!(sectors(&dir.region()), 5); + // a grows: it moves past b, and its two old sectors are free again. + region.write(a, &record(3 * 4096 - 5)).unwrap(); + assert_eq!(sectors(&dir.region()), 8); + // c fits in a's old sectors; then an oversized c goes to its .mcc file + // (a one-sector stub, at the end: sector 8) and back inline (sector 2). + region.write(c, &record(2 * 4096 - 5)).unwrap(); + assert_eq!(sectors(&dir.region()), 8); + region.write(c, &record(256 * 4096)).unwrap(); + assert!(dir.0.join("c.-1.31.mcc").exists()); + region.write(c, &record(10)).unwrap(); + assert!(!dir.0.join("c.-1.31.mcc").exists()); + assert!(region.clear(b, 7).unwrap()); + assert!(!region.clear(b, 7).unwrap()); + region.sync().unwrap(); + drop(region); + let mut reader = RegionFile::open(dir.region()).unwrap(); + assert_eq!(reader.chunks().map(|(p, _)| p).collect::<Vec<_>>(), [a, c]); + assert_eq!( + reader.read(a).unwrap().unwrap().compressed, + record(3 * 4096 - 5).compressed + ); + assert_eq!( + reader.read(c).unwrap().unwrap().compressed, + record(10).compressed + ); + assert!(reader.read(b).unwrap().is_none()); + // Reopened, the bitmap holds the chunks' sectors: new chunks take the + // first free runs (sectors 3 and 4), not theirs. + let mut region = RegionFile::open_writable(dir.region(), false).unwrap(); + region.write(b, &record(4096 - 5)).unwrap(); + region + .write(ChunkPos::new(-30, 0), &record(4096 - 5)) + .unwrap(); + drop(region); + let mut reader = RegionFile::open(dir.region()).unwrap(); + assert_eq!( + reader.read(a).unwrap().unwrap().compressed, + record(3 * 4096 - 5).compressed + ); + assert_eq!( + reader.read(c).unwrap().unwrap().compressed, + record(10).compressed + ); + assert_eq!( + reader.read(b).unwrap().unwrap().compressed, + record(4096 - 5).compressed + ); + assert_eq!(sectors(&dir.region()), 9); +} + #[test] fn failed_writer_cannot_commit_and_removes_its_own_external_files() { let dir = Directory::new(); @@ -206,3 +270,57 @@ fn chunk_storage_edit_preserves_unknown_fields_and_other_blocks() { let record = ChunkRecord::from_nbt(&root, Compression::Lz4, 17, Limits::default()).unwrap(); assert_eq!(record.nbt(Limits::default()).unwrap(), root); } + +/// Saving one chunk into a full region: the whole file rewritten (every +/// chunk read and written again, then the new file published), against +/// vanilla's in-place write. Run with --ignored --nocapture. +#[test] +#[ignore = "microbenchmark; run with --ignored --nocapture"] +fn benchmark_saving_into_a_full_region() { + let dir = Directory::new(); + let chunks: Vec<ChunkPos> = (0..1024) + .map(|i| ChunkPos::new(-32 + i % 32, i / 32)) + .collect(); + // About what a compressed overworld chunk weighs: two sectors. + let saved = record(6000); + let mut region = RegionFile::open_writable(dir.region(), true).unwrap(); + for &c in &chunks { + region.write(c, &saved).unwrap(); + } + region.sync().unwrap(); + drop(region); + let rounds = 100; + let start = std::time::Instant::now(); + for round in 0..rounds { + let changed = chunks[round * 7 % 1024]; + let mut existing = RegionFile::open(dir.region()).unwrap(); + let mut records = Vec::new(); + for (p, _) in existing.chunks().collect::<Vec<_>>() { + let r = if p == changed { + saved.clone() + } else { + existing.read(p).unwrap().unwrap() + }; + records.push((p, r)); + } + let staging = dir.0.join("staging"); + fs::create_dir_all(&staging).unwrap(); + let temporary = staging.join("r.-1.0.mca"); + let _ = fs::remove_file(&temporary); + let mut writer = RegionWriter::create(&temporary).unwrap(); + for (p, r) in &records { + writer.write(*p, r).unwrap(); + } + writer.finish().unwrap(); + fs::rename(&temporary, dir.region()).unwrap(); + } + let rewrite = start.elapsed() / rounds as u32; + let mut region = RegionFile::open_writable(dir.region(), false).unwrap(); + let start = std::time::Instant::now(); + for round in 0..rounds { + region.write(chunks[round * 7 % 1024], &saved).unwrap(); + region.sync().unwrap(); + } + let in_place = start.elapsed() / rounds as u32; + println!("one chunk into a full region: rewrite {rewrite:?}, in place {in_place:?}"); +} From 9190d14b7fa88fb7e409d72b1be48d112f5a35c3 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 07:35:27 +0200 Subject: [PATCH 067/163] Block registry: read facts.json as it streams The game and the assets step each parsed facts.json into a JSON tree, then copied each state into an NBT tree, before building the registry. With a pack's 214,000 states each step peaked at 816 MB for a 139 MB registry. The registry now deserializes the rows it needs straight from the file (each row's state and its air and fluid columns, and the defaults): registry peak 816 -> 153 MB, assets peak 816 -> 235 MB, RSS after the assets step 1,344 -> 442 MB. Vanilla: 138 -> 27 MB. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/assets.rs | 73 ++------- crates/horizon-world/src/level/data.rs | 40 +---- crates/horizon-world/src/registry.rs | 58 ++++++-- crates/horizon-world/src/registry/facts.rs | 164 +++++++++++++++++++++ 4 files changed, 228 insertions(+), 107 deletions(-) create mode 100644 crates/horizon-world/src/registry/facts.rs diff --git a/crates/horizon-client/src/assets.rs b/crates/horizon-client/src/assets.rs index f278740f5..c42f0aaf7 100644 --- a/crates/horizon-client/src/assets.rs +++ b/crates/horizon-client/src/assets.rs @@ -2,14 +2,13 @@ use crate::Result; use horizon_world::{ DATA_VERSION, heightmap::HeightmapState, - nbt::Tag, registry::{BlockRegistry, BlockStateId}, worldgen::{tags::TagDefinitions, terrain::TerrainBlockStates}, }; use serde_json::Value; use std::{ collections::BTreeSet, - fs::{self, File}, + fs::File, io::{self, BufReader}, path::Path, sync::Arc, @@ -74,24 +73,6 @@ pub struct Assets { fn invalid(message: &str) -> io::Error { io::Error::new(io::ErrorKind::InvalidData, message) } -fn tag(value: &Value) -> Result<Tag> { - Ok(match value { - Value::String(value) => Tag::String(value.as_str().into()), - Value::Number(value) => Tag::Int(i32::try_from( - value - .as_i64() - .ok_or_else(|| invalid("invalid registry number"))?, - )?), - Value::Array(values) => Tag::List(values.iter().map(tag).collect::<Result<_>>()?), - Value::Object(values) => Tag::Compound( - values - .iter() - .map(|(name, value)| Ok((name.as_str().into(), tag(value)?))) - .collect::<Result<_>>()?, - ), - _ => return Err(invalid("unsupported registry value").into()), - }) -} impl Assets { pub fn load(root: &Path) -> Result<Self> { let manifest: Value = serde_json::from_reader(BufReader::new(File::open( @@ -100,23 +81,8 @@ impl Assets { if manifest["data_version"].as_i64() != Some(i64::from(DATA_VERSION)) { return Err(invalid("resources do not match Horizon's pinned data version").into()); } - let facts: Value = serde_json::from_slice(&fs::read(root.join("facts.json"))?)?; - let states = facts["states"] - .as_array() - .ok_or_else(|| invalid("missing registry state facts"))?; - let registry = BlockRegistry::from_nbt(&Tag::compound([ - ("DataVersion", Tag::Int(DATA_VERSION)), - ( - "states", - Tag::List( - states - .iter() - .map(|state| tag(&state[4])) - .collect::<Result<_>>()?, - ), - ), - ("defaults", tag(&facts["defaults"])?), - ]))?; + let (registry, flags) = + BlockRegistry::from_facts_json_with_flags(File::open(root.join("facts.json"))?)?; let bundle: Value = serde_json::from_reader(BufReader::new(File::open(root.join("block-tags.json"))?))?; let mut definitions = TagDefinitions::default(); @@ -132,7 +98,7 @@ impl Assets { )?; } let built = - definitions.build(|name, _| facts["defaults"].get(name).map(|_| name.to_owned()))?; + definitions.build(|name, _| registry.default_state(name).map(|_| name.to_owned()))?; if !built.missing.is_empty() { return Err(invalid("unresolved block tags").into()); } @@ -158,27 +124,20 @@ impl Assets { .cloned() .collect(); let properties = Properties(Arc::new( - states + flags .iter() - .map(|state| { + .enumerate() + .map(|(i, &(air, fluid))| { + let name = ®istry + .state(BlockStateId(i as u32)) + .ok_or_else(|| invalid("missing registry state"))? + .name; Ok(StateFacts { - air: state[1] - .as_bool() - .ok_or_else(|| invalid("missing air fact"))?, - fluid: state[2] - .as_bool() - .ok_or_else(|| invalid("missing fluid fact"))?, - air_block: state[0].as_str() == Some("minecraft:air"), - motion: motion.contains( - state[0] - .as_str() - .ok_or_else(|| invalid("missing state name"))?, - ), - no_leaves: no_leaves.contains( - state[0] - .as_str() - .ok_or_else(|| invalid("missing state name"))?, - ), + air, + fluid, + air_block: name == "minecraft:air", + motion: motion.contains(name.as_str()), + no_leaves: no_leaves.contains(name.as_str()), }) }) .collect::<Result<_>>()?, diff --git a/crates/horizon-world/src/level/data.rs b/crates/horizon-world/src/level/data.rs index 0862aa5b8..e0ef0dca1 100644 --- a/crates/horizon-world/src/level/data.rs +++ b/crates/horizon-world/src/level/data.rs @@ -613,45 +613,9 @@ fn set_type(value: &Value, cache: &mut HashMap<String, Arc<str>>) -> Option<SetT } /// Build the block-state registry from the resources' `facts.json` (the -/// same source the native client uses). +/// same source the native client uses), streamed. pub fn load_registry(root: &Path) -> io::Result<BlockRegistry> { - use crate::{DATA_VERSION, nbt::Tag}; - fn tag(value: &Value) -> io::Result<Tag> { - Ok(match value { - Value::String(value) => Tag::String(value.as_str().into()), - Value::Number(value) => Tag::Int( - value - .as_i64() - .and_then(|v| i32::try_from(v).ok()) - .ok_or_else(|| fail("invalid registry number"))?, - ), - Value::Array(values) => Tag::List(values.iter().map(tag).collect::<io::Result<_>>()?), - Value::Object(values) => Tag::Compound( - values - .iter() - .map(|(name, value)| Ok((name.as_str().into(), tag(value)?))) - .collect::<io::Result<_>>()?, - ), - _ => return Err(fail("unsupported registry value")), - }) - } - let facts = read_json(&root.join("facts.json"))?; - let states = facts["states"] - .as_array() - .ok_or_else(|| fail("missing registry state facts"))?; - BlockRegistry::from_nbt(&Tag::compound([ - ("DataVersion", Tag::Int(DATA_VERSION)), - ( - "states", - Tag::List( - states - .iter() - .map(|state| tag(&state[4])) - .collect::<io::Result<_>>()?, - ), - ), - ("defaults", tag(&facts["defaults"])?), - ])) + BlockRegistry::from_facts_json(File::open(root.join("facts.json"))?) } pub(super) fn load(registry: &BlockRegistry, root: &Path) -> io::Result<Behaviours> { diff --git a/crates/horizon-world/src/registry.rs b/crates/horizon-world/src/registry.rs index 30cd5e83c..9ce9a6814 100644 --- a/crates/horizon-world/src/registry.rs +++ b/crates/horizon-world/src/registry.rs @@ -1,5 +1,6 @@ //! Runtime block-state IDs imported from a version-pinned registry data export. //! This supplies identities and default properties, not block behavior. +mod facts; mod json; use crate::{DATA_VERSION, chunk::BlockState, compression::invalid, nbt::Tag}; pub use json::BlockStateJsonCodec; @@ -45,17 +46,53 @@ impl BlockRegistry { let Some(Tag::Compound(defaults)) = tag.get("defaults") else { return Err(invalid("missing registry defaults")); }; - if entries.is_empty() || entries.len() > i32::MAX as usize { + let states = entries + .iter() + .map(BlockState::from_nbt) + .collect::<io::Result<_>>()?; + let defaults = defaults + .iter() + .map(|(name, id)| { + let name = name.to_string().map_err(|e| invalid(e.to_string()))?; + let Tag::Int(id) = id else { + return Err(invalid("default state ID is not an int")); + }; + Ok((name, i64::from(*id))) + }) + .collect::<io::Result<_>>()?; + Self::from_states(states, defaults) + } + + /// The registry of a resources `facts.json` (`{"states": [[..., ..., ..., + /// ..., state], ...], "defaults": {name: id}}`), read as it streams: no + /// JSON or NBT tree of the whole file is built. For a pack of 190,000 + /// states the two trees were several hundred megabytes at startup. + pub fn from_facts_json(reader: impl io::Read) -> io::Result<Self> { + Ok(Self::from_facts_json_with_flags(reader)?.0) + } + + /// [`Self::from_facts_json`], with each state's `(air, fluid)` columns. + pub fn from_facts_json_with_flags( + reader: impl io::Read, + ) -> io::Result<(Self, Vec<(bool, bool)>)> { + let facts: facts::Facts = serde_json::from_reader(io::BufReader::new(reader)) + .map_err(|e| invalid(e.to_string()))?; + let flags = facts.states.iter().map(|r| (r.air, r.fluid)).collect(); + let states = facts.states.into_iter().map(|r| r.state).collect(); + Ok((Self::from_states(states, facts.defaults)?, flags)) + } + + fn from_states(states: Vec<BlockState>, defaults: BTreeMap<String, i64>) -> io::Result<Self> { + if states.is_empty() || states.len() > i32::MAX as usize { return Err(invalid("invalid registry size")); } let mut result = Self { - states: Vec::with_capacity(entries.len()), - ids: HashMap::with_capacity(entries.len()), + states: Vec::with_capacity(states.len()), + ids: HashMap::with_capacity(states.len()), collided: BTreeMap::new(), defaults: BTreeMap::new(), }; - for (i, entry) in entries.iter().enumerate() { - let state = BlockState::from_nbt(entry)?; + for (i, state) in states.into_iter().enumerate() { if result.id(&state).is_some() { return Err(invalid("duplicate block registry state")); } @@ -72,19 +109,16 @@ impl BlockRegistry { result.states.push(state); } for (name, id) in defaults { - let name = name.to_string().map_err(|e| invalid(e.to_string()))?; - let Tag::Int(id) = id else { - return Err(invalid("default state ID is not an int")); - }; - if *id < 0 + if id < 0 + || id > i64::from(i32::MAX) || result .states - .get(*id as usize) + .get(id as usize) .is_none_or(|s| s.name != name) { return Err(invalid("invalid default block state ID")); } - result.defaults.insert(name, BlockStateId(*id as u32)); + result.defaults.insert(name, BlockStateId(id as u32)); } let names: BTreeSet<_> = result.states.iter().map(|s| &s.name).collect(); if names.len() != result.defaults.len() diff --git a/crates/horizon-world/src/registry/facts.rs b/crates/horizon-world/src/registry/facts.rs new file mode 100644 index 000000000..3371a8283 --- /dev/null +++ b/crates/horizon-world/src/registry/facts.rs @@ -0,0 +1,164 @@ +//! The part of `facts.json` the block registry reads, deserialized as it +//! streams: each row's state (its fifth column) and the defaults. +use crate::chunk::BlockState; +use serde::{ + Deserialize, Deserializer, + de::{self, IgnoredAny, SeqAccess, Visitor}, +}; +use std::{collections::BTreeMap, fmt}; + +#[derive(Deserialize)] +pub(super) struct Facts { + pub states: Vec<Row>, + pub defaults: BTreeMap<String, i64>, +} + +/// One `states` row: `[name, air, fluid, description, state, ...]`, keeping +/// the two flags and the state. +pub(super) struct Row { + pub air: bool, + pub fluid: bool, + pub state: BlockState, +} + +impl<'de> Deserialize<'de> for Row { + fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> { + struct RowVisitor; + impl<'de> Visitor<'de> for RowVisitor { + type Value = Row; + fn expecting(&self, f: &mut fmt::Formatter) -> fmt::Result { + f.write_str("a registry state row") + } + fn visit_seq<A: SeqAccess<'de>>(self, mut seq: A) -> Result<Row, A::Error> { + let length = |i| de::Error::invalid_length(i, &self); + seq.next_element::<IgnoredAny>()?.ok_or_else(|| length(0))?; + let air = seq.next_element::<bool>()?.ok_or_else(|| length(1))?; + let fluid = seq.next_element::<bool>()?.ok_or_else(|| length(2))?; + seq.next_element::<IgnoredAny>()?.ok_or_else(|| length(3))?; + let state = seq.next_element::<State>()?.ok_or_else(|| length(4))?; + while seq.next_element::<IgnoredAny>()?.is_some() {} + Ok(Row { + air, + fluid, + state: state.0, + }) + } + } + deserializer.deserialize_seq(RowVisitor) + } +} + +/// A state as BlockState::from_nbt reads it: a name, or `{"id", "properties"}`. +struct State(BlockState); + +impl<'de> Deserialize<'de> for State { + fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> { + #[derive(Deserialize)] + #[serde(untagged)] + enum Shape { + Name(String), + Full { + id: String, + #[serde(default)] + properties: BTreeMap<String, String>, + }, + } + Ok(State(match Shape::deserialize(deserializer)? { + Shape::Name(name) => BlockState { + name, + properties: BTreeMap::new(), + }, + Shape::Full { id, properties } => BlockState { + name: id, + properties, + }, + })) + } +} + +#[cfg(test)] +mod tests { + use crate::{ + DATA_VERSION, + chunk::BlockState, + nbt::Tag, + registry::{BlockRegistry, BlockStateId}, + }; + use serde_json::Value; + use std::path::Path; + + #[test] + fn reads_states_and_defaults() { + let json = br#"{"defaults": {"minecraft:air": 0, "minecraft:oak_slab": 2}, + "states": [ + ["minecraft:air", true, false, "Block{minecraft:air}", "minecraft:air"], + ["minecraft:oak_slab", false, false, "x", {"id": "minecraft:oak_slab", "properties": {"type": "top"}}, "extra"], + ["minecraft:oak_slab", false, true, "x", {"id": "minecraft:oak_slab", "properties": {"type": "bottom"}}] + ], "other": [1, 2]}"#; + let (registry, flags) = BlockRegistry::from_facts_json_with_flags(&json[..]).unwrap(); + assert_eq!(registry.len(), 3); + assert_eq!(flags, [(true, false), (false, false), (false, true)]); + assert_eq!( + registry.default_state("minecraft:oak_slab"), + Some(BlockStateId(2)) + ); + let top = BlockState { + name: "minecraft:oak_slab".into(), + properties: [("type".into(), "top".into())].into(), + }; + assert_eq!(registry.id(&top), Some(BlockStateId(1))); + // A default naming another block, a short row, a missing default. + for bad in [ + &br#"{"defaults": {"minecraft:air": 1}, "states": [["minecraft:air", true, false, "", "minecraft:air"], ["minecraft:stone", false, false, "", "minecraft:stone"]]}"#[..], + br#"{"defaults": {"minecraft:air": 0}, "states": [["minecraft:air", true, false, ""]]}"#, + br#"{"defaults": {}, "states": [["minecraft:air", true, false, "", "minecraft:air"]]}"#, + ] { + assert!(BlockRegistry::from_facts_json(bad).is_err()); + } + } + + /// The streamed registry is the one the JSON and NBT trees built. + #[test] + fn matches_the_tree_built_registry() { + let path = Path::new(env!("CARGO_MANIFEST_DIR")) + .join("../../.local/horizon-client/26.3/facts.json"); + let Ok(bytes) = std::fs::read(&path) else { + eprintln!("skipped: no prepared facts.json"); + return; + }; + fn tag(v: &Value) -> Tag { + match v { + Value::String(s) => Tag::String(s.as_str().into()), + Value::Number(n) => Tag::Int(n.as_i64().unwrap() as i32), + Value::Object(o) => { + Tag::Compound(o.iter().map(|(k, v)| (k.as_str().into(), tag(v))).collect()) + } + _ => unreachable!(), + } + } + let facts: Value = serde_json::from_slice(&bytes).unwrap(); + let rows = facts["states"].as_array().unwrap(); + let tree = BlockRegistry::from_nbt(&Tag::compound([ + ("DataVersion", Tag::Int(DATA_VERSION)), + ( + "states", + Tag::List(rows.iter().map(|r| tag(&r[4])).collect()), + ), + ("defaults", tag(&facts["defaults"])), + ])) + .unwrap(); + let (streamed, flags) = BlockRegistry::from_facts_json_with_flags(&bytes[..]).unwrap(); + assert_eq!(streamed.len(), tree.len()); + for (i, row) in rows.iter().enumerate() { + let id = BlockStateId(i as u32); + assert_eq!(streamed.state(id), tree.state(id)); + assert_eq!( + flags[i], + (row[1].as_bool().unwrap(), row[2].as_bool().unwrap()) + ); + } + for name in facts["defaults"].as_object().unwrap().keys() { + assert_eq!(streamed.default_state(name), tree.default_state(name)); + } + } +} From 7d27950e31983b0b1ac7f59f0b271a4f15028338 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 05:55:57 +0200 Subject: [PATCH 068/163] Carry: write worldgen block states in 26.3's shape 1.21.1 writes a block or fluid state in worldgen JSON as {"Name", "Properties"}; 26.3's codec reads {"id", "properties"} and refuses the old shape, so every processor list, feature or pool holding one failed to decode. Carry now rewrites them. On ATM10's carried mods: 1,005 files in 17 mods. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/worldgen.rs | 67 ++++++++++++++++++++++-- 1 file changed, 64 insertions(+), 3 deletions(-) diff --git a/crates/horizon-port-pack/src/worldgen.rs b/crates/horizon-port-pack/src/worldgen.rs index c44cc1108..c308f4159 100644 --- a/crates/horizon-port-pack/src/worldgen.rs +++ b/crates/horizon-port-pack/src/worldgen.rs @@ -1,6 +1,7 @@ -//! Structure mods' worldgen, carried over: the structure, placement and pool -//! element types of the common structure libraries rewritten as vanilla's, -//! and the loader's convention biome tags (`c:`) the structures name. +//! Structure mods' worldgen, carried over: block and fluid states in 26.3's +//! shape, the structure, placement and pool element types of the common +//! structure libraries rewritten as vanilla's, and the loader's convention +//! biome tags (`c:`) the structures name. //! //! The libraries' types add rules on top of vanilla's (a structure that may //! not start in liquid, a minimum distance from the world origin, a count @@ -44,6 +45,8 @@ const ELEMENTS: [(&str, &str); 3] = [ pub struct Upgrade { /// Files rewritten to vanilla types. pub mapped: usize, + /// Files whose block and fluid states were written in 26.3's shape. + pub block_states: usize, /// Types left as they are (Horizon skips what it cannot run), by type. pub unsupported: BTreeMap<String, usize>, } @@ -51,6 +54,41 @@ pub struct Upgrade { /// Rewrites one `data/<ns>/worldgen/<kind>/...` file in place; whether it /// changed. pub fn upgrade(kind: &str, v: &mut Value, report: &mut Upgrade) -> bool { + let states = block_states(v); + report.block_states += usize::from(states); + upgrade_types(kind, v, report) || states +} + +/// 1.21.1 writes a block or fluid state as `{"Name": ..., "Properties": +/// {...}}`; 26.3's codec reads `{"id": ..., "properties": {...}}` and +/// refuses the old shape, which fails the processor list, feature or pool +/// holding it. Whether anything changed. +fn block_states(v: &mut Value) -> bool { + match v { + Value::Object(o) => { + let state = o.get("Name").is_some_and(Value::is_string) + && o.keys().all(|k| k == "Name" || k == "Properties"); + if state { + if let Some(name) = o.remove("Name") { + o.insert("id".into(), name); + } + if let Some(properties) = o.remove("Properties") { + o.insert("properties".into(), properties); + } + return true; + } + o.values_mut() + .fold(false, |changed, x| block_states(x) | changed) + } + Value::Array(a) => a + .iter_mut() + .fold(false, |changed, x| block_states(x) | changed), + _ => false, + } +} + +/// The library types of one file rewritten as vanilla's; whether it changed. +fn upgrade_types(kind: &str, v: &mut Value, report: &mut Upgrade) -> bool { let mut unsupported = |t: &str| *report.unsupported.entry(t.to_owned()).or_default() += 1; let changed = match kind { "structure" => match v["type"].as_str() { @@ -223,6 +261,7 @@ mod tests { "minecraft:empty_pool_element" ); assert_eq!(report.mapped, 3); + assert_eq!(report.block_states, 0); assert_eq!( report.unsupported, BTreeMap::from([ @@ -235,6 +274,28 @@ mod tests { ); } + #[test] + fn writes_block_states_in_26_3_shape() { + let mut report = Upgrade::default(); + let mut list = json!({"processors": [{"processor_type": "minecraft:rule", "rules": [{ + "input_predicate": {"predicate_type": "minecraft:always_true"}, + "output_state": {"Name": "minecraft:oak_stairs", "Properties": {"facing": "east"}}}]}]}); + assert!(upgrade("processor_list", &mut list, &mut report)); + assert_eq!( + list["processors"][0]["rules"][0]["output_state"], + json!({"id": "minecraft:oak_stairs", "properties": {"facing": "east"}}) + ); + let mut spring = json!({"type": "minecraft:spring_feature", "config": { + "state": {"Name": "minecraft:water"}, "valid_blocks": ["minecraft:stone"]}}); + assert!(upgrade("configured_feature", &mut spring, &mut report)); + assert_eq!(spring["config"]["state"], json!({"id": "minecraft:water"})); + // An object with other keys is not a state; a 26.3 state is left as it is. + let mut other = json!({"Name": "x", "weight": 1, "state": {"id": "minecraft:stone"}}); + assert!(!upgrade("configured_feature", &mut other, &mut report)); + assert_eq!(report.block_states, 2); + assert_eq!(report.mapped, 0); + } + #[test] fn convention_tags_include_theirs() { let conventions = BTreeMap::from([ From f72c8674ad2d2ab616b028f814c9fa07132e2dfe Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 06:31:25 +0200 Subject: [PATCH 069/163] Carry: the start and placement rules of mapped jigsaws Repurposed Structures' and Moog's jigsaws and spreads add rules on top of vanilla's; mapped to vanilla they were lost, and Moog's spreads structures 1.65 times as far apart as its files say, so MVS alone started 9x as often as on NeoForge. Carry now writes the start rules under horizon:start_checks, the minimum distance and the super exclusion zone's sets (from the mod's structure set tags) under horizon: placement keys, and scales Moog's spacing. Layout rules (piece clipping, burying) are still lost and counted in the carry report's rules_lost. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/carry.rs | 4 +- crates/horizon-port-pack/src/worldgen.rs | 321 +++++++++++++++++++++-- 2 files changed, 306 insertions(+), 19 deletions(-) diff --git a/crates/horizon-port-pack/src/carry.rs b/crates/horizon-port-pack/src/carry.rs index 7b9bc8fee..c73570684 100644 --- a/crates/horizon-port-pack/src/carry.rs +++ b/crates/horizon-port-pack/src/carry.rs @@ -362,6 +362,7 @@ pub fn carry( let mut convention = BTreeSet::new(); let mut block_loot = BTreeSet::new(); let mut biome_conventions = BTreeSet::new(); + let set_tags = crate::worldgen::structure_set_tags(&mut zip); for i in 0..zip.len() { let mut entry = zip.by_index(i).map_err(|e| e.to_string())?; let name = entry.name().to_owned(); @@ -421,7 +422,8 @@ pub fn carry( if kind == "structure" { crate::worldgen::convention_tags(&v["biomes"], &mut biome_conventions); } - if crate::worldgen::upgrade(kind, &mut v, &mut report.worldgen_types) { + if crate::worldgen::upgrade(kind, &mut v, &mut report.worldgen_types, &set_tags) + { bytes = serde_json::to_vec_pretty(&v).unwrap_or(bytes); } } diff --git a/crates/horizon-port-pack/src/worldgen.rs b/crates/horizon-port-pack/src/worldgen.rs index c308f4159..91ff1bfef 100644 --- a/crates/horizon-port-pack/src/worldgen.rs +++ b/crates/horizon-port-pack/src/worldgen.rs @@ -3,12 +3,16 @@ //! structure libraries rewritten as vanilla's, and the loader's convention //! biome tags (`c:`) the structures name. //! -//! The libraries' types add rules on top of vanilla's (a structure that may -//! not start in liquid, a minimum distance from the world origin, a count -//! cap per piece). Mapped to vanilla, those rules are lost: the structure -//! keeps its pieces and its spacing but can start where the mod would not. -//! Each rewrite is counted in the carry report, and every type left as it is -//! is listed, so the coverage report can say what generates and how closely. +//! The libraries' types add rules on top of vanilla's. The start and +//! placement rules of Repurposed Structures' and Moog's jigsaws (no start in +//! liquid, biomes and terrain height in a radius, a minimum distance from +//! the world origin, sets to keep away from) are written under `horizon:` +//! keys the game reads (`horizon_world::worldgen::structure::start_checks`), +//! so those structures start where the mod would. Rules that change how the +//! pieces are laid out (piece caps, burying, clipping) are lost and counted +//! by name. Each rewrite is counted in the carry report, and every type left +//! as it is is listed, so the coverage report can say what generates and how +//! closely. use serde_json::Value; use std::{ collections::{BTreeMap, BTreeSet}, @@ -27,6 +31,25 @@ const SPREADS: [&str; 2] = [ "moogs_structures:advanced_random_spread", "repurposed_structures:advanced_random_spread", ]; +/// Moog's Structure Lib spreads its structures 1.65 times as far apart as +/// its files say (AdvancedRandomSpread's constructor). +const MOOGS_SPACING: f64 = 1.65; +/// The jigsaws' start rules and the `horizon:start_checks` key each maps to. +const START_RULES: [(&str, &str); 3] = [ + ("valid_biome_radius_check", "biome_radius"), + ("terrain_height_radius_check", "terrain_radius"), + ("allowed_terrain_height_range", "terrain_range"), +]; +/// The jigsaws' rules on laying out pieces, which vanilla's jigsaw has no +/// place for. +const LAYOUT_RULES: [&str; 6] = [ + "y_allowance", + "burying_type", + "use_bounding_box_hack", + "pools_that_ignore_boundaries", + "enhanced_terrain_adaptation", + "vertical_distance_from_start_piece", +]; /// Pool elements that are vanilla's with extra fields: (mod type, vanilla type). const ELEMENTS: [(&str, &str); 3] = [ ( @@ -49,14 +72,23 @@ pub struct Upgrade { pub block_states: usize, /// Types left as they are (Horizon skips what it cannot run), by type. pub unsupported: BTreeMap<String, usize>, + /// Rules of mapped types the game does not run, by field. + pub rules_lost: BTreeMap<String, usize>, } /// Rewrites one `data/<ns>/worldgen/<kind>/...` file in place; whether it /// changed. -pub fn upgrade(kind: &str, v: &mut Value, report: &mut Upgrade) -> bool { +/// `set_tags` are the mod's structure set tags, expanded +/// ([`structure_set_tags`]). +pub fn upgrade( + kind: &str, + v: &mut Value, + report: &mut Upgrade, + set_tags: &BTreeMap<String, Vec<String>>, +) -> bool { let states = block_states(v); report.block_states += usize::from(states); - upgrade_types(kind, v, report) || states + upgrade_types(kind, v, report, set_tags) || states } /// 1.21.1 writes a block or fluid state as `{"Name": ..., "Properties": @@ -88,11 +120,22 @@ fn block_states(v: &mut Value) -> bool { } /// The library types of one file rewritten as vanilla's; whether it changed. -fn upgrade_types(kind: &str, v: &mut Value, report: &mut Upgrade) -> bool { +fn upgrade_types( + kind: &str, + v: &mut Value, + report: &mut Upgrade, + set_tags: &BTreeMap<String, Vec<String>>, +) -> bool { + let lost = &mut report.rules_lost; let mut unsupported = |t: &str| *report.unsupported.entry(t.to_owned()).or_default() += 1; let changed = match kind { "structure" => match v["type"].as_str() { Some(t) if JIGSAWS.contains(&t) => { + let liquid = match t.split_once(':').map(|(ns, _)| ns) { + Some("moogs_structures") => "top", + _ => "lowest", + }; + start_checks(v, liquid, lost); v["type"] = "minecraft:jigsaw".into(); true } @@ -104,7 +147,13 @@ fn upgrade_types(kind: &str, v: &mut Value, report: &mut Upgrade) -> bool { }, "structure_set" => match v["placement"]["type"].as_str() { Some(t) if SPREADS.contains(&t) => { - v["placement"]["type"] = "minecraft:random_spread".into(); + let moogs = t.starts_with("moogs_structures:"); + let p = &mut v["placement"]; + if moogs { + moogs_spacing(p, lost); + } + placement_rules(p, set_tags, lost); + p["type"] = "minecraft:random_spread".into(); true } Some(t) if !t.starts_with("minecraft:") => { @@ -144,6 +193,144 @@ fn upgrade_types(kind: &str, v: &mut Value, report: &mut Upgrade) -> bool { changed } +/// Moves a Repurposed Structures or Moog's jigsaw's start rules under +/// `horizon:start_checks`, and counts the layout rules it loses. `liquid` is +/// the block its no-start-in-liquid rule reads. +fn start_checks(v: &mut Value, liquid: &str, lost: &mut BTreeMap<String, usize>) { + let Some(o) = v.as_object_mut() else { + return; + }; + let mut checks = serde_json::Map::new(); + for (from, to) in START_RULES { + if let Some(n) = o.remove(from) { + checks.insert(to.into(), n); + } + } + if o.remove("cannot_spawn_in_liquid").and_then(|b| b.as_bool()) == Some(true) { + checks.insert("liquid".into(), liquid.into()); + } + // y_allowance bounds the terrain heights checked; it also clips pieces, + // which is lost. + for (from, to) in [("min_y_allowed", "min_y"), ("max_y_allowed", "max_y")] { + if let Some(n) = o.get("y_allowance").and_then(|y| y.get(from)) { + checks.insert(to.into(), n.clone()); + } + } + for rule in LAYOUT_RULES { + if o.remove(rule).is_some_and(|r| r != Value::Bool(false)) { + *lost.entry(rule.into()).or_default() += 1; + } + } + if !checks.is_empty() { + o.insert("horizon:start_checks".into(), checks.into()); + } +} + +/// AdvancedRandomSpread's spacing and separation, as Moog's computes them +/// with its default config: 1.65 times the file's, rounded, the separation +/// below the spacing. `when_replacing` (other numbers while a preset +/// replaces a vanilla structure) is lost. +fn moogs_spacing(p: &mut Value, lost: &mut BTreeMap<String, usize>) { + let scaled = |k: &str| (p[k].as_f64().unwrap_or(0.) * MOOGS_SPACING).round() as i64; + let spacing = scaled("spacing").max(1); + let separation = scaled("separation").min(spacing - 1); + p["spacing"] = spacing.into(); + p["separation"] = separation.into(); + if let Some(o) = p.as_object_mut() { + if o.remove("when_replacing").is_some() { + *lost.entry("when_replacing".into()).or_default() += 1; + } + } +} + +/// An advanced random spread's minimum distance from the world origin and +/// its super exclusion zone (sets named by a tag) under `horizon:` keys. +fn placement_rules( + p: &mut Value, + set_tags: &BTreeMap<String, Vec<String>>, + lost: &mut BTreeMap<String, usize>, +) { + let Some(o) = p.as_object_mut() else { + return; + }; + if let Some(d) = o.remove("min_distance_from_world_origin") { + o.insert("horizon:min_distance_from_world_origin".into(), d); + } + if let Some(zone) = o.remove("super_exclusion_zone") { + let sets: Vec<String> = match &zone["other_set"] { + Value::String(s) => match s.strip_prefix('#') { + Some(tag) => set_tags.get(tag).cloned().unwrap_or_default(), + None => vec![s.clone()], + }, + Value::Array(a) => a + .iter() + .filter_map(|s| Some(s.as_str()?.to_owned())) + .collect(), + _ => Vec::new(), + }; + if sets.is_empty() { + *lost.entry("super_exclusion_zone".into()).or_default() += 1; + } else { + o.insert( + "horizon:exclusion_zone".into(), + serde_json::json!({"other_sets": sets, "chunk_count": zone["chunk_count"]}), + ); + } + } +} + +/// The mod's structure set tags (`data/<ns>/tags/worldgen/structure_set/`), +/// by tag id, with the tags they include expanded. Optional entries +/// (`{"id": ..., "required": false}`) count as their id. +pub fn structure_set_tags<R: Read + std::io::Seek>( + zip: &mut zip::ZipArchive<R>, +) -> BTreeMap<String, Vec<String>> { + let mut raw: BTreeMap<String, Vec<String>> = BTreeMap::new(); + for i in 0..zip.len() { + let Ok(mut entry) = zip.by_index(i) else { + continue; + }; + let Some(id) = entry + .name() + .strip_prefix("data/") + .and_then(|r| r.split_once("/tags/worldgen/structure_set/")) + .and_then(|(ns, path)| Some(format!("{ns}:{}", path.strip_suffix(".json")?))) + else { + continue; + }; + let mut text = String::new(); + let Ok(v) = entry.read_to_string(&mut text).map_err(drop).and_then(|_| { + serde_json::from_str::<Value>(text.trim_start_matches('\u{feff}')).map_err(drop) + }) else { + continue; + }; + let values = v["values"].as_array().into_iter().flatten(); + raw.insert( + id, + values + .filter_map(|e| e.as_str().or_else(|| e["id"].as_str()).map(str::to_owned)) + .collect(), + ); + } + let expand = |tag: &str| { + let (mut out, mut seen, mut todo) = (Vec::new(), BTreeSet::new(), vec![tag.to_owned()]); + while let Some(t) = todo.pop() { + if !seen.insert(t.clone()) { + continue; + } + for e in raw.get(&t).into_iter().flatten() { + match e.strip_prefix('#') { + Some(inner) => todo.push(inner.to_owned()), + None if !out.contains(e) => out.push(e.clone()), + None => {} + } + } + } + out + }; + raw.keys().map(|t| (t.clone(), expand(t))).collect() +} + /// The `#c:` biome tags `v` names. pub fn convention_tags(v: &Value, out: &mut BTreeSet<String>) { match v { @@ -231,27 +418,40 @@ mod tests { use super::*; use serde_json::json; + const NO_TAGS: BTreeMap<String, Vec<String>> = BTreeMap::new(); + #[test] fn maps_library_types_to_vanillas() { let mut report = Upgrade::default(); let mut s = json!({"type": "lithostitched:jigsaw", "start_pool": "a:b"}); - assert!(upgrade("structure", &mut s, &mut report)); + assert!(upgrade("structure", &mut s, &mut report, &NO_TAGS)); assert_eq!(s["type"], "minecraft:jigsaw"); let mut nether = json!({"type": "moogs_structures:moogs_structures_generic_nether_jigsaw_structure"}); - assert!(!upgrade("structure", &mut nether, &mut report)); + assert!(!upgrade("structure", &mut nether, &mut report, &NO_TAGS)); let mut set = json!({"placement": {"type": "moogs_structures:advanced_random_spread", "spacing": 10, "separation": 5, "min_distance_from_world_origin": 250}}); - assert!(upgrade("structure_set", &mut set, &mut report)); + assert!(upgrade("structure_set", &mut set, &mut report, &NO_TAGS)); assert_eq!(set["placement"]["type"], "minecraft:random_spread"); - assert_eq!(set["placement"]["spacing"], 10); + // Moog's spreads 1.65 times as far as its file says. + assert_eq!(set["placement"]["spacing"], 17); + assert_eq!(set["placement"]["separation"], 8); + assert_eq!( + set["placement"]["horizon:min_distance_from_world_origin"], + 250 + ); + assert!( + set["placement"] + .get("min_distance_from_world_origin") + .is_none() + ); let mut pool = json!({"elements": [ {"weight": 1, "element": {"element_type": "moogs_structures:versioned_single_pool_element", "location": "m:x"}}, {"weight": 1, "element": {"element_type": "minecraft:list_pool_element", "elements": [ {"element_type": "empty_pool_element"}]}}, {"weight": 1, "element": {"element_type": "yungsapi:yung_single_element"}} ]}); - assert!(upgrade("template_pool", &mut pool, &mut report)); + assert!(upgrade("template_pool", &mut pool, &mut report, &NO_TAGS)); assert_eq!( pool["elements"][0]["element"]["element_type"], "minecraft:single_pool_element" @@ -274,24 +474,109 @@ mod tests { ); } + #[test] + fn keeps_the_jigsaws_start_rules() { + let mut report = Upgrade::default(); + let mut moogs = json!({"type": "moogs_structures:moogs_structures_generic_jigsaw_structure", + "cannot_spawn_in_liquid": true, "terrain_height_radius_check": 2, + "allowed_terrain_height_range": 12, "valid_biome_radius_check": 1, + "y_allowance": {"min_y_allowed": 60}, "burying_type": "lowest_corner", + "use_bounding_box_hack": false, "size": 7}); + assert!(upgrade("structure", &mut moogs, &mut report, &NO_TAGS)); + assert_eq!( + moogs["horizon:start_checks"], + json!({"liquid": "top", "terrain_radius": 2, "terrain_range": 12, + "biome_radius": 1, "min_y": 60}) + ); + for gone in [ + "cannot_spawn_in_liquid", + "y_allowance", + "burying_type", + "use_bounding_box_hack", + ] { + assert!(moogs.get(gone).is_none(), "{gone}"); + } + assert_eq!(moogs["size"], 7); + // Repurposed Structures reads the block above the bottom. + let mut rs = json!({"type": "repurposed_structures:generic_jigsaw_structure", + "cannot_spawn_in_liquid": true}); + assert!(upgrade("structure", &mut rs, &mut report, &NO_TAGS)); + assert_eq!(rs["horizon:start_checks"], json!({"liquid": "lowest"})); + // Nothing to check: no key. + let mut plain = json!({"type": "lithostitched:jigsaw", "cannot_spawn_in_liquid": false}); + assert!(upgrade("structure", &mut plain, &mut report, &NO_TAGS)); + assert!(plain.get("horizon:start_checks").is_none()); + assert_eq!( + report.rules_lost, + BTreeMap::from([("burying_type".into(), 1), ("y_allowance".into(), 1)]) + ); + } + + #[test] + fn super_exclusion_zones_name_their_sets() { + let mut zip = zip::ZipWriter::new(std::io::Cursor::new(Vec::new())); + let opts = zip::write::SimpleFileOptions::default(); + for (name, text) in [ + ( + "data/rs/tags/worldgen/structure_set/avoid.json", + r##"{"values": ["minecraft:villages", "#rs:more", {"id": "x:y", "required": false}]}"##, + ), + ( + "data/rs/tags/worldgen/structure_set/more.json", + r##"{"values": ["minecraft:villages", "rs:cities", "#rs:avoid"]}"##, + ), + ] { + zip.start_file(name, opts).unwrap(); + std::io::Write::write_all(&mut zip, text.as_bytes()).unwrap(); + } + let mut zip = zip::ZipArchive::new(zip.finish().unwrap()).unwrap(); + let tags = structure_set_tags(&mut zip); + assert_eq!(tags["rs:avoid"], ["minecraft:villages", "x:y", "rs:cities"]); + let mut report = Upgrade::default(); + let mut set = json!({"placement": {"type": "repurposed_structures:advanced_random_spread", + "spacing": 30, "separation": 10, + "super_exclusion_zone": {"chunk_count": 4, "other_set": "#rs:avoid"}}}); + assert!(upgrade("structure_set", &mut set, &mut report, &tags)); + assert_eq!(set["placement"]["spacing"], 30); + assert_eq!( + set["placement"]["horizon:exclusion_zone"], + json!({"other_sets": ["minecraft:villages", "x:y", "rs:cities"], "chunk_count": 4}) + ); + let mut unknown = json!({"placement": {"type": "repurposed_structures:advanced_random_spread", + "spacing": 30, "separation": 10, + "super_exclusion_zone": {"chunk_count": 4, "other_set": "#rs:none"}}}); + assert!(upgrade("structure_set", &mut unknown, &mut report, &tags)); + assert_eq!(report.rules_lost["super_exclusion_zone"], 1); + } + #[test] fn writes_block_states_in_26_3_shape() { let mut report = Upgrade::default(); let mut list = json!({"processors": [{"processor_type": "minecraft:rule", "rules": [{ "input_predicate": {"predicate_type": "minecraft:always_true"}, "output_state": {"Name": "minecraft:oak_stairs", "Properties": {"facing": "east"}}}]}]}); - assert!(upgrade("processor_list", &mut list, &mut report)); + assert!(upgrade("processor_list", &mut list, &mut report, &NO_TAGS)); assert_eq!( list["processors"][0]["rules"][0]["output_state"], json!({"id": "minecraft:oak_stairs", "properties": {"facing": "east"}}) ); let mut spring = json!({"type": "minecraft:spring_feature", "config": { "state": {"Name": "minecraft:water"}, "valid_blocks": ["minecraft:stone"]}}); - assert!(upgrade("configured_feature", &mut spring, &mut report)); + assert!(upgrade( + "configured_feature", + &mut spring, + &mut report, + &NO_TAGS + )); assert_eq!(spring["config"]["state"], json!({"id": "minecraft:water"})); // An object with other keys is not a state; a 26.3 state is left as it is. let mut other = json!({"Name": "x", "weight": 1, "state": {"id": "minecraft:stone"}}); - assert!(!upgrade("configured_feature", &mut other, &mut report)); + assert!(!upgrade( + "configured_feature", + &mut other, + &mut report, + &NO_TAGS + )); assert_eq!(report.block_states, 2); assert_eq!(report.mapped, 0); } From 65732406fc428926985929b1367d42b6d57abde5 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 06:48:02 +0200 Subject: [PATCH 070/163] Carry: take processors written in Java out of their lists The game, like vanilla, refuses a processor list holding a type it does not know, and with it every pool naming the list, so those structures did not generate at all. Carry now takes the library types out of processor lists (files and inline ones in pool elements) and counts them by type in the carry report: the structures generate, undecorated. On ATM10's carried mods: 1,427 processors of 146 types; pool decode failures 31 -> 0. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/worldgen.rs | 96 +++++++++++++++++++++++- 1 file changed, 95 insertions(+), 1 deletion(-) diff --git a/crates/horizon-port-pack/src/worldgen.rs b/crates/horizon-port-pack/src/worldgen.rs index 91ff1bfef..25e0dbbea 100644 --- a/crates/horizon-port-pack/src/worldgen.rs +++ b/crates/horizon-port-pack/src/worldgen.rs @@ -74,6 +74,8 @@ pub struct Upgrade { pub unsupported: BTreeMap<String, usize>, /// Rules of mapped types the game does not run, by field. pub rules_lost: BTreeMap<String, usize>, + /// Processors written in Java, taken out of their lists, by type. + pub processors_dropped: BTreeMap<String, usize>, } /// Rewrites one `data/<ns>/worldgen/<kind>/...` file in place; whether it @@ -88,7 +90,55 @@ pub fn upgrade( ) -> bool { let states = block_states(v); report.block_states += usize::from(states); - upgrade_types(kind, v, report, set_tags) || states + let dropped = match kind { + "processor_list" => drop_java_processors(v, &mut report.processors_dropped), + "template_pool" => { + let mut changed = false; + for e in v["elements"].as_array_mut().into_iter().flatten() { + let element = &mut e["element"]; + if let Some(list) = element.get_mut("elements").and_then(Value::as_array_mut) { + for inner in list { + if let Some(p) = inner.get_mut("processors") { + changed |= drop_java_processors(p, &mut report.processors_dropped); + } + } + } else if let Some(p) = element.get_mut("processors") { + changed |= drop_java_processors(p, &mut report.processors_dropped); + } + } + changed + } + _ => false, + }; + upgrade_types(kind, v, report, set_tags) || states || dropped +} + +/// Takes the processors written in Java (any type outside `minecraft:`) +/// out of a processor list: `{"processors": [...]}`, a bare list, or an id +/// (left as it is). The game, like vanilla, refuses a list holding a type it +/// does not know, and with it every pool that names the list, so without +/// this the structure does not generate at all. Without them it generates +/// undecorated: no pillars under it, spawners left as the template has +/// them, blocks not swapped. Whether anything was taken out. +fn drop_java_processors(list: &mut Value, dropped: &mut BTreeMap<String, usize>) -> bool { + let processors = match list { + Value::Array(a) => a, + Value::Object(o) => match o.get_mut("processors") { + Some(Value::Array(a)) => a, + _ => return false, + }, + _ => return false, + }; + let before = processors.len(); + processors.retain(|p| { + let t = p["processor_type"].as_str().unwrap_or_default(); + let java = !t.starts_with("minecraft:"); + if java { + *dropped.entry(t.to_owned()).or_default() += 1; + } + !java + }); + processors.len() != before } /// 1.21.1 writes a block or fluid state as `{"Name": ..., "Properties": @@ -549,6 +599,50 @@ mod tests { assert_eq!(report.rules_lost["super_exclusion_zone"], 1); } + #[test] + fn drops_processors_written_in_java() { + let mut report = Upgrade::default(); + let mut list = json!({"processors": [ + {"processor_type": "repurposed_structures:bottom_pillar_processor"}, + {"processor_type": "minecraft:gravity", "heightmap": "WORLD_SURFACE_WG", "offset": -1}, + {"processor_type": "moogs_structures:spawner_randomizing_processor"}]}); + assert!(upgrade("processor_list", &mut list, &mut report, &NO_TAGS)); + assert_eq!( + list["processors"], + json!([{"processor_type": "minecraft:gravity", + "heightmap": "WORLD_SURFACE_WG", "offset": -1}]) + ); + let mut pool = json!({"elements": [ + {"weight": 1, "element": {"element_type": "minecraft:single_pool_element", + "processors": {"processors": [{"processor_type": "lithostitched:block_swap"}]}}}, + {"weight": 1, "element": {"element_type": "minecraft:list_pool_element", "elements": [ + {"element_type": "minecraft:single_pool_element", "processors": "x:named"}]}}]}); + assert!(upgrade("template_pool", &mut pool, &mut report, &NO_TAGS)); + assert_eq!( + pool["elements"][0]["element"]["processors"], + json!({"processors": []}) + ); + assert_eq!( + pool["elements"][1]["element"]["elements"][0]["processors"], + "x:named" + ); + let mut vanilla = json!({"processors": [{"processor_type": "minecraft:nop"}]}); + assert!(!upgrade( + "processor_list", + &mut vanilla, + &mut report, + &NO_TAGS + )); + assert_eq!( + report.processors_dropped, + BTreeMap::from([ + ("lithostitched:block_swap".into(), 1), + ("moogs_structures:spawner_randomizing_processor".into(), 1), + ("repurposed_structures:bottom_pillar_processor".into(), 1), + ]) + ); + } + #[test] fn writes_block_states_in_26_3_shape() { let mut report = Upgrade::default(); From d0d5e79f1afaeec9107b88fa6a12c4f4f093936d Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 06:31:33 +0200 Subject: [PATCH 071/163] Structures: honour a carried mod's start and placement rules Repurposed Structures' and Moog's jigsaws check biomes and terrain height in a radius and refuse to start in liquid; their spreads keep a minimum distance from the world origin and away from several other sets. Carry maps them to vanilla's jigsaw and random spread and writes those rules under horizon: keys; the game now runs them (start_checks.rs, the spread's min distance and exclusion sets). Vanilla data has none of the keys. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../horizon-world/src/worldgen/structure.rs | 1 + .../src/worldgen/structure/start.rs | 76 ++++- .../src/worldgen/structure/start_checks.rs | 277 ++++++++++++++++++ 3 files changed, 341 insertions(+), 13 deletions(-) create mode 100644 crates/horizon-world/src/worldgen/structure/start_checks.rs diff --git a/crates/horizon-world/src/worldgen/structure.rs b/crates/horizon-world/src/worldgen/structure.rs index f15c37dc2..361b2c1d0 100644 --- a/crates/horizon-world/src/worldgen/structure.rs +++ b/crates/horizon-world/src/worldgen/structure.rs @@ -14,6 +14,7 @@ pub mod processor; pub mod ruined_portal; pub mod simple; pub mod start; +pub mod start_checks; pub mod stronghold; pub mod template; pub mod temple; diff --git a/crates/horizon-world/src/worldgen/structure/start.rs b/crates/horizon-world/src/worldgen/structure/start.rs index 1b443eba5..a66f27509 100644 --- a/crates/horizon-world/src/worldgen/structure/start.rs +++ b/crates/horizon-world/src/worldgen/structure/start.rs @@ -55,6 +55,8 @@ pub struct JigsawDef { aliases: Vec<Value>, padding: [i32; 2], waterlogging: bool, + /// A carried mod's start rules (`"horizon:start_checks"`). + checks: super::start_checks::StartChecks, } #[derive(Debug)] pub enum StructureKind { @@ -129,6 +131,12 @@ pub struct StructureSet { frequency: f32, reduction: Reduction, exclusion: Option<(String, i32)>, + /// A carried mod's placement rules: no start nearer the world origin + /// than this many blocks (`"horizon:min_distance_from_world_origin"`), + /// and none within `chunk_count` chunks of any of several sets + /// (`"horizon:exclusion_zone"`: `other_sets`, `chunk_count`). + min_distance: Option<i64>, + avoid: Option<(Vec<String>, i32)>, } fn heightmap(name: &str) -> Option<HeightmapType> { @@ -193,6 +201,7 @@ impl StructureRegistry { aliases: v["pool_aliases"].as_array().cloned().unwrap_or_default(), padding: pair(v.get("dimension_padding"), "bottom", "top", 0), waterlogging: v["liquid_settings"].as_str() != Some("ignore_waterlogging"), + checks: super::start_checks::StartChecks::decode(v.get("horizon:start_checks")), }), "minecraft:buried_treasure" => StructureKind::BuriedTreasure, "minecraft:igloo" => StructureKind::Igloo, @@ -291,6 +300,20 @@ impl StructureRegistry { z["chunk_count"].as_i64().unwrap_or(0) as i32, ) }), + min_distance: p + .get("horizon:min_distance_from_world_origin") + .and_then(Value::as_i64), + avoid: p.get("horizon:exclusion_zone").map(|z| { + ( + z["other_sets"] + .as_array() + .into_iter() + .flatten() + .filter_map(|s| Some(s.as_str()?.to_owned())) + .collect(), + z["chunk_count"].as_i64().unwrap_or(0) as i32, + ) + }), }); } Ok(Self { @@ -397,26 +420,47 @@ impl StructureRegistry { if !placed { return false; } + // AdvancedRandomSpread.isPlacementChunk, in blocks from the chunk's corner. + if let Some(d) = set.min_distance { + let (bx, bz) = (i64::from(x) * 16, i64::from(z) * 16); + if bx * bx + bz * bz < d * d { + return false; + } + } + if let Some((others, range)) = &set.avoid { + if others + .iter() + .any(|other| self.has_start_in_range(other, seed, x, z, *range, rings)) + { + return false; + } + } if set.frequency < 1. && !reduce(set.reduction, seed, set.salt, x, z, set.frequency) { return false; } match &set.exclusion { - Some((other, range)) => { - let Some(other) = self.sets.iter().find(|s| s.name == *other) else { - return true; - }; - for tx in x - range..=x + range { - for tz in z - range..=z + range { - if self.is_structure_chunk(other, seed, tx, tz, rings) { - return false; - } - } - } - true - } + Some((other, range)) => !self.has_start_in_range(other, seed, x, z, *range, rings), None => true, } } + /// ChunkGeneratorStructureState.hasStructureChunkInRange: whether set + /// `other` places a structure within `range` chunks of (`x`, `z`). + fn has_start_in_range( + &self, + other: &str, + seed: i64, + x: i32, + z: i32, + range: i32, + rings: &Rings, + ) -> bool { + let Some(other) = self.sets.iter().find(|s| s.name == other) else { + return false; + }; + (x - range..=x + range).any(|tx| { + (z - range..=z + range).any(|tz| self.is_structure_chunk(other, seed, tx, tz, rings)) + }) + } } impl StructureSet { /// The random spread's spacing in chunks (`None` for rings). @@ -606,6 +650,12 @@ fn try_generate( .start_height .sample(&mut random, context.generation()) .ok()?; + if !jigsaw + .checks + .pass(context, &def.biomes, chunk, height, jigsaw.project_to) + { + return None; + } let start = [chunk.x * 16, height, chunk.z * 16]; let aliases = resolve_aliases(&jigsaw.aliases, start, seed); let config = JigsawConfig { diff --git a/crates/horizon-world/src/worldgen/structure/start_checks.rs b/crates/horizon-world/src/worldgen/structure/start_checks.rs new file mode 100644 index 000000000..45b991531 --- /dev/null +++ b/crates/horizon-world/src/worldgen/structure/start_checks.rs @@ -0,0 +1,277 @@ +//! Start rules a carried structure mod adds on top of vanilla's jigsaw. +//! +//! Repurposed Structures and Moog's Structure Lib give their jigsaw +//! structures checks that run before the pieces are laid out: every biome +//! in a radius must be one the structure allows, the start column may not +//! end in liquid, and the terrain in a radius must lie within a height range. +//! Carry (`horizon-port-pack`) maps those structures to `minecraft:jigsaw` +//! and writes the checks under `"horizon:start_checks"`; vanilla data never +//! has the key, so vanilla structures are unchanged. +//! +//! ```json +//! "horizon:start_checks": { +//! "biome_radius": 2, // chunks; every noise biome must be allowed +//! "liquid": "top", // "top": the column's highest block; "lowest": the block above min_y +//! "terrain_radius": 1, // chunks, with terrain_range and/or min_y, max_y +//! "terrain_range": 15, +//! "min_y": 60, +//! "max_y": 200 +//! } +//! ``` +use crate::{heightmap::HeightmapType, worldgen::biome::BiomeId}; +use horizon_core::position::ChunkPos; +use serde_json::Value; +use std::collections::BTreeSet; + +/// Which block of the start column must not be a liquid. +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub enum LiquidCheck { + /// The highest non-air block of the noise column (Moog's). + Top, + /// The block above the column's bottom (Repurposed Structures: its loop + /// keeps the last block it reads, not the first solid one). + Lowest, +} + +/// The checks of one structure; all empty for vanilla's. +#[derive(Clone, Debug, Default, PartialEq, Eq)] +pub struct StartChecks { + biome_radius: Option<i32>, + liquid: Option<LiquidCheck>, + terrain_radius: Option<i32>, + terrain_range: Option<i32>, + min_y: Option<i32>, + max_y: Option<i32>, +} + +/// The column and biome queries the checks need. +pub trait CheckQueries { + /// ChunkGenerator.getFirstFreeHeight. + fn first_free_height(&mut self, x: i32, z: i32, kind: HeightmapType) -> i32; + /// The noise column at (`x`, `z`) as (not air, blocks motion) per block + /// from the noise's bottom up: in a noise column a block that is not air + /// and does not block motion is a liquid. + fn liquid_column(&mut self, x: i32, z: i32) -> (Vec<bool>, Vec<bool>); + fn noise_biome(&mut self, quart: [i32; 3]) -> BiomeId; +} + +impl<T: super::start::StartContext> CheckQueries for T { + fn first_free_height(&mut self, x: i32, z: i32, kind: HeightmapType) -> i32 { + self.base_height(x, z, kind) + } + fn liquid_column(&mut self, x: i32, z: i32) -> (Vec<bool>, Vec<bool>) { + let mut columns = self.base_columns( + x, + z, + &[HeightmapType::WorldSurfaceWg, HeightmapType::OceanFloorWg], + ); + let solid = columns.pop().unwrap_or_default(); + (columns.pop().unwrap_or_default(), solid) + } + fn noise_biome(&mut self, quart: [i32; 3]) -> BiomeId { + super::start::StartContext::noise_biome(self, quart) + } +} + +impl StartChecks { + /// `"horizon:start_checks"` of a structure, or none. + pub fn decode(value: Option<&Value>) -> Self { + let Some(v) = value else { + return Self::default(); + }; + let int = |k: &str| v.get(k).and_then(Value::as_i64).map(|n| n as i32); + Self { + biome_radius: int("biome_radius"), + liquid: match v.get("liquid").and_then(Value::as_str) { + Some("top") => Some(LiquidCheck::Top), + Some("lowest") => Some(LiquidCheck::Lowest), + _ => None, + }, + terrain_radius: int("terrain_radius"), + terrain_range: int("terrain_range"), + min_y: int("min_y"), + max_y: int("max_y"), + } + } + + /// GenericJigsawStructure.extraSpawningChecks: whether the structure may + /// start in `chunk` at `y` (the sampled start height). + pub fn pass( + &self, + queries: &mut impl CheckQueries, + biomes: &BTreeSet<BiomeId>, + chunk: ChunkPos, + y: i32, + project_to: Option<HeightmapType>, + ) -> bool { + let (x0, z0) = (chunk.x * 16, chunk.z * 16); + if let Some(radius) = self.biome_radius { + let mut section_y = y; + if let Some(kind) = project_to { + section_y += queries.first_free_height(x0 + 7, z0 + 7, kind) - 1; + } + for cx in chunk.x - radius..=chunk.x + radius { + for cz in chunk.z - radius..=chunk.z + radius { + if !biomes.contains(&queries.noise_biome([cx << 2, section_y >> 2, cz << 2])) { + return false; + } + } + } + } + if let Some(check) = self.liquid { + let (filled, solid) = queries.liquid_column(x0 + 7, z0 + 7); + // From the top down to the block above the bottom, as the mods loop. + let index = match check { + LiquidCheck::Top => (1..filled.len()).rev().find(|&i| filled[i]), + LiquidCheck::Lowest => Some(1).filter(|&i| i < filled.len()), + }; + if index.is_some_and(|i| filled[i] && !solid[i]) { + return false; + } + } + if let Some(radius) = self + .terrain_radius + .filter(|_| self.terrain_range.is_some() || self.min_y.is_some()) + { + let kind = project_to.unwrap_or(HeightmapType::WorldSurfaceWg); + let (mut highest, mut lowest) = (i32::MIN, i32::MAX); + for cx in chunk.x - radius..=chunk.x + radius { + for cz in chunk.z - radius..=chunk.z + radius { + let height = queries.first_free_height((cx << 4) + 7, (cz << 4) + 7, kind); + highest = highest.max(height); + lowest = lowest.min(height); + // Both bounds test the lowest height so far, as the mods do. + if self.min_y.is_some_and(|m| lowest < m) + || self.max_y.is_some_and(|m| lowest > m) + { + return false; + } + } + } + if self + .terrain_range + .is_some_and(|range| highest - lowest > range) + { + return false; + } + } + true + } +} + +#[cfg(test)] +mod tests { + use super::*; + use serde_json::json; + use std::collections::BTreeMap; + + /// Heights per (x, z), a liquid column, one biome per quart column. + #[derive(Default)] + struct Fake { + heights: BTreeMap<(i32, i32), i32>, + column: Vec<char>, + biomes: BTreeMap<(i32, i32), u32>, + asked: Vec<[i32; 3]>, + } + impl CheckQueries for Fake { + fn first_free_height(&mut self, x: i32, z: i32, _: HeightmapType) -> i32 { + self.heights.get(&(x, z)).copied().unwrap_or(64) + } + fn liquid_column(&mut self, _: i32, _: i32) -> (Vec<bool>, Vec<bool>) { + // '.' air, '#' stone, '~' water, from the bottom up. + ( + self.column.iter().map(|&c| c != '.').collect(), + self.column.iter().map(|&c| c == '#').collect(), + ) + } + fn noise_biome(&mut self, quart: [i32; 3]) -> BiomeId { + self.asked.push(quart); + BiomeId(self.biomes.get(&(quart[0], quart[2])).copied().unwrap_or(1)) + } + } + fn checks(v: Value) -> StartChecks { + StartChecks::decode(Some(&v)) + } + const CHUNK: ChunkPos = ChunkPos { x: 2, z: -1 }; + + #[test] + fn vanilla_structures_pass_everything() { + let mut fake = Fake { + column: "#~~.".chars().collect(), + ..Fake::default() + }; + let none = StartChecks::decode(None); + assert_eq!(none, StartChecks::default()); + assert!(none.pass(&mut fake, &BTreeSet::new(), CHUNK, 0, None)); + assert!(fake.asked.is_empty()); + } + + #[test] + fn every_biome_in_the_radius_must_be_allowed() { + let allowed = BTreeSet::from([BiomeId(1)]); + let mut fake = Fake::default(); + fake.heights.insert((39, -9), 70); + let c = checks(json!({"biome_radius": 1})); + assert!(c.pass( + &mut fake, + &allowed, + CHUNK, + 10, + Some(HeightmapType::WorldSurfaceWg) + )); + // Section y: start height plus the projected height minus one, in quarts. + assert_eq!(fake.asked.len(), 9); + assert!(fake.asked.iter().all(|q| q[1] == (10 + 70 - 1) >> 2)); + assert_eq!(fake.asked[0], [4, 19, -8]); + fake.biomes.insert((12, 0), 2); // chunk (3, 0), the radius' corner + assert!(!c.pass(&mut fake, &allowed, CHUNK, 10, None)); + } + + #[test] + fn liquid_checks_read_the_mods_block() { + let top = checks(json!({"liquid": "top"})); + let lowest = checks(json!({"liquid": "lowest"})); + let none = BTreeSet::new(); + let mut ocean = Fake { + column: "##~~~..".chars().collect(), + ..Fake::default() + }; + assert!(!top.pass(&mut ocean, &none, CHUNK, 0, None)); + assert!(lowest.pass(&mut ocean, &none, CHUNK, 0, None)); + let mut land = Fake { + column: "#~###..".chars().collect(), + ..Fake::default() + }; + assert!(top.pass(&mut land, &none, CHUNK, 0, None)); + assert!(!lowest.pass(&mut land, &none, CHUNK, 0, None)); + // The bottom block itself is never read; an empty column passes. + let mut empty = Fake { + column: "~....".chars().collect(), + ..Fake::default() + }; + assert!(top.pass(&mut empty, &none, CHUNK, 0, None)); + } + + #[test] + fn terrain_must_lie_within_its_range() { + let none = BTreeSet::new(); + let mut fake = Fake::default(); + // Chunk centres around (2, -1): x 23, 39, 55; z -25, -9, 7. + fake.heights.insert((23, -25), 60); + fake.heights.insert((55, 7), 75); + let range = |r: i32| checks(json!({"terrain_radius": 1, "terrain_range": r})); + assert!(range(15).pass(&mut fake, &none, CHUNK, 0, None)); + assert!(!range(14).pass(&mut fake, &none, CHUNK, 0, None)); + // The radius alone, or with only max_y, checks nothing. + assert!( + checks(json!({"terrain_radius": 1, "max_y": 0})).pass(&mut fake, &none, CHUNK, 0, None) + ); + let bounds = + |min: i32, max: i32| checks(json!({"terrain_radius": 1, "min_y": min, "max_y": max})); + assert!(bounds(60, 64).pass(&mut fake, &none, CHUNK, 0, None)); + assert!(!bounds(61, 100).pass(&mut fake, &none, CHUNK, 0, None)); + // max_y is compared with the lowest height so far: 75 never fails it. + assert!(bounds(0, 64).pass(&mut fake, &none, CHUNK, 0, None)); + assert!(!bounds(0, 59).pass(&mut fake, &none, CHUNK, 0, None)); + } +} From 05517a167fd71b4c160b999f765a053c505072af Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 07:40:41 +0200 Subject: [PATCH 072/163] docs/modpacks.md: structure carry-over now decodes and starts where the mod would; facts.json streams Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- docs/modpacks.md | 59 +++++++++++++++++++++++++++++++++++++----------- 1 file changed, 46 insertions(+), 13 deletions(-) diff --git a/docs/modpacks.md b/docs/modpacks.md index adf9a5318..1ecaed8bb 100644 --- a/docs/modpacks.md +++ b/docs/modpacks.md @@ -420,21 +420,52 @@ Two cases the oracle fills in: - their `advanced_random_spread` becomes `minecraft:random_spread`; - their versioned, legacy and empty pool elements become vanilla's. - The rules these libraries add on top of vanilla's (no start in liquid, a minimum distance, - caps per piece) are lost, so a mapped structure can start where the mod would not. NeoForge's - convention biome tags (`#c:is_forest`, ...) come from the loader jar - (`<work>/loader/neoforge-<version>-universal.jar`, fetched dev-only and SHA-1 checked) and - are written into the carry. Each mod's `carry-report.json` lists what was mapped and the - types left as they are. The game skips the structures it cannot decode. + Three more rewrites make the mapped structures decode and start where their mod would: + - **Block states.** 1.21.1 writes a block or fluid state as `{"Name", "Properties"}`, 26.3 + as `{"id", "properties"}` and refuses the old shape, which failed the whole processor + list, feature or pool. Carry rewrites them (#816; 1,005 files in 17 of ATM10's mods). + - **Start and placement rules** (#820 in the game, #821 in carry). Repurposed Structures' + and Moog's jigsaws refuse to start in liquid and check biomes and terrain height in a + radius; their spreads keep a minimum distance from the world origin and away from other + sets (named by a structure set tag). Carry writes these under `horizon:start_checks`, + `horizon:min_distance_from_world_origin` and `horizon:exclusion_zone`; the game runs them + (`horizon-world`'s `structure/start_checks.rs`). Vanilla data has none of the keys. Moog's + also spreads its structures 1.65 times as far apart as its files say, which carry now + applies. MVS went from 829 starts to 90 in a 128×128-chunk square (seed 1234): 294 from the + spacing, the rest from the start checks. + - **Processors written in Java** are taken out of their lists (#822). The game, like + vanilla, refuses a list holding a type it does not know, and with it every pool naming the + list. The structures now generate undecorated (no pillars under them, spawners as the + template has them); 1,427 processors of 146 types in ATM10's mods, the most common + `lithostitched:block_swap`, Formations' `biome_replacements` and Repurposed Structures' + pillar, fluid and void processors. Porting the common ones is next. - On ATM10's 40 data-tier mods: + Each mod's `carry-report.json` lists what was mapped, the rules and processors lost by name, + and the types left as they are. NeoForge's convention biome tags (`#c:is_forest`, ...) come + from the loader jar (`<work>/loader/neoforge-<version>-universal.jar`, fetched dev-only and + SHA-1 checked) and are written into the carry. The game skips the structures it cannot + decode. + + On ATM10's 42 data-tier mods with a jar (seed 1234, chunks -64..63, `chunkgen_bench + --starts` over the carried worldgen): 286 starts with 15,097 pieces, 150 of them vanilla's + (unchanged), and no pool that fails to decode (65 before #816 in the 64×64 centre). - 1,061 files were mapped (MVS 413, MNS 210, MSS 157, MES 110, Repurposed Structures 104, ChoiceTheorem's Overhauled Village 66), and 103 convention biome tags written. - When Dungeons Arise, Structory and Towns and Towers use vanilla's types already. - - Not generated yet, because their types are Java code: YUNG's API (491 elements and - jigsaws: every "YUNG's Better" mod), Formations (179), the nether jigsaw variants of Moog's - and Repurposed (69), MO Structures (38), and Repurposed's mineshafts, mansions, monuments - and cities. + - Still lost, written in Java: + - YUNG's API: its own jigsaw assembler (priority pieces, per-piece caps, conditions, + enhanced terrain adaptation) and 491 elements and jigsaws, behind every "YUNG's Better" + mod; + - Formations' structure and element types (179); + - the nether jigsaw variants of Moog's and Repurposed (69), which search the column for + land after the layout; + - Moog's and Repurposed's layout rules: they centre the pieces on the start, bury or lift + the structure to the terrain and cap pieces per pool; + - Repurposed's mineshafts, mansions, monuments and cities, and MO Structures (38; its + library is only on CurseForge). + - CTOV's villages and outposts are added to vanilla's `villages` and `pillager_outposts` + sets by Java code, as lithostitched's `add_structure_set_entries` worldgen modifiers do for + many packs; a content mod has no way to add to a vanilla set yet, so none start. In a world with the 40 mods, seed 1234, `/locate structure mvs:azelea_house` finds one 27 blocks from spawn and it stands there as the template builds it; When Dungeons Arise's @@ -682,8 +713,10 @@ ATM10 mods (153,511 states), the peak of each step falls by about 210 MB: The fluid tables no longer decode the 211 MB `gameplay-facts.json` a second time (#754). The content root is kept between starts (#756). What is left at startup: -- `facts.json` goes through a JSON tree, then an NBT tree, in both the registry and the assets - step; +- `facts.json` went through a JSON tree, then an NBT tree, in both the registry and the assets + step. It now streams (#825): at ATM10's size (214,338 states) each step's peak fell from + 816 MB to 153 MB (registry) and 235 MB (assets), and the RSS after the assets step from + 1,344 MB to 442 MB; - on a first start, the content-root build and `Behaviours`' decode of `gameplay-facts.json` (cached afterwards in the behaviour snapshot). From 454b3842bb9fe9fec0b75fcfa599f14d78a3dd8d Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 07:28:35 +0200 Subject: [PATCH 073/163] feat(server): secure chat, as vanilla 26.3's server Chat session updates with their profile key checked against the services' keys, signed chat and the message chain, last-seen acknowledgements, the signature cache, signed say/me/msg, enforce-secure-profile, and vanilla's log lines. Offline servers and players without a chat session chat unsigned, as on vanilla. tools/test_secure_chat_parity.py compares both servers with test keys and a mock services server. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- Cargo.lock | 2 + crates/horizon-client/examples/lan_flat.rs | 4 +- crates/horizon-client/src/game.rs | 1 + crates/horizon-client/src/game/dedicated.rs | 15 +- crates/horizon-client/src/game/lan.rs | 33 +- crates/horizon-client/src/game/lan_actions.rs | 22 +- crates/horizon-client/src/game/lan_chat.rs | 194 ++++++ crates/horizon-client/src/lan/guest.rs | 9 + crates/horizon-client/src/lan/hub.rs | 79 +-- crates/horizon-client/src/lan/hub/chat.rs | 500 ++++++++++++++ crates/horizon-client/src/lan/mod.rs | 52 +- crates/horizon-protocol/Cargo.toml | 2 + crates/horizon-protocol/src/buf.rs | 10 + crates/horizon-protocol/src/lib.rs | 1 + crates/horizon-protocol/src/packets/play.rs | 63 +- crates/horizon-protocol/src/rsa.rs | 92 ++- crates/horizon-protocol/src/secure_chat.rs | 491 ++++++++++++++ crates/horizon-server-files/Cargo.toml | 2 + crates/horizon-server-files/src/profiles.rs | 68 ++ docs/hosting.md | 5 +- docs/server.md | 4 +- .../horizonlab/parity/SecureChatClient.java | 625 ++++++++++++++++++ tools/test_secure_chat_parity.py | 317 +++++++++ 23 files changed, 2505 insertions(+), 86 deletions(-) create mode 100644 crates/horizon-client/src/game/lan_chat.rs create mode 100644 crates/horizon-client/src/lan/hub/chat.rs create mode 100644 crates/horizon-protocol/src/secure_chat.rs create mode 100644 mods/horizon/src/test/java/dev/horizonlab/parity/SecureChatClient.java create mode 100644 tools/test_secure_chat_parity.py diff --git a/Cargo.lock b/Cargo.lock index 2f389dfef..b4081e7af 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -1539,6 +1539,7 @@ dependencies = [ "horizon-world", "serde_json", "sha1", + "sha2", ] [[package]] @@ -1569,6 +1570,7 @@ dependencies = [ name = "horizon-server-files" version = "0.1.0" dependencies = [ + "base64", "horizon-core", "horizon-protocol", "horizon-world", diff --git a/crates/horizon-client/examples/lan_flat.rs b/crates/horizon-client/examples/lan_flat.rs index 4800f05fa..20d87e03c 100644 --- a/crates/horizon-client/examples/lan_flat.rs +++ b/crates/horizon-client/examples/lan_flat.rs @@ -128,7 +128,9 @@ fn main() -> Result<(), Box<dyn std::error::Error>> { eprintln!("[lan] {packet:?}"); } } - HostEvent::Chat(line) | HostEvent::Warn(line) => println!("{line}"), + HostEvent::Chat { line, .. } | HostEvent::Warn(line) | HostEvent::Error(line) => { + println!("{line}") + } HostEvent::Left(_) => {} } } diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index cfbb526ef..e30ef829e 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -64,6 +64,7 @@ mod item_particles; mod jukebox; mod lan; mod lan_actions; +mod lan_chat; mod lan_crafting; mod lan_entities; mod lan_mobs; diff --git a/crates/horizon-client/src/game/dedicated.rs b/crates/horizon-client/src/game/dedicated.rs index 7348f3f9e..8a8ed63f9 100644 --- a/crates/horizon-client/src/game/dedicated.rs +++ b/crates/horizon-client/src/game/dedicated.rs @@ -473,6 +473,18 @@ impl Game<'_> { // DedicatedServer.initServer: names nobody has resolve offline only without authentication. cache.resolve_offline_users = !props.online_mode; *USER_CACHE.lock().unwrap() = Some(cache); + // Services.create: the services' public keys, fetched in the + // background (they check players' chat keys). + let secure_chat = Arc::new(horizon_client::lan::SecureChat::new( + props.enforce_secure_profile && props.online_mode, + || { + let discovery = profiles::discovery_url(); + profiles::fetch_profile_key_keys(&discovery).unwrap_or_else(|e| { + ::log::error!("{e}"); + Vec::new() + }) + }, + )); log("INFO", "Starting minecraft server version 26.3"); log("INFO", "Loading properties"); let game_mode = props.game_mode; @@ -571,8 +583,7 @@ impl Game<'_> { enable_status: props.enable_status, hide_online_players: props.hide_online_players, favicon, - // DedicatedServer.enforceSecureProfile needs online mode. - enforces_secure_chat: false, + secure_chat: Some(secure_chat), accepts_transfers: props.accepts_transfers, announce: false, listen: true, diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index 30cd89b3d..114330e51 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -855,6 +855,9 @@ impl Game<'_> { } for event in events { match event { + event @ (HostEvent::Chat { .. } | HostEvent::Warn(_) | HostEvent::Error(_)) => { + self.lan_log_event(event); + } HostEvent::Joined(conn) => { self.lan_guest_joined(&mut host, conn, state.as_ref(), &entities, spawn); if self.options.dedicated.is_some() @@ -911,15 +914,6 @@ impl Game<'_> { ); } } - // MinecraftServer.logChatMessage of an unsigned message. - HostEvent::Chat(line) if self.options.dedicated.is_some() => { - super::dedicated::log("INFO", &format!("[Not Secure] {line}")); - } - HostEvent::Chat(line) => self.system_message(Text::literal(line)), - HostEvent::Warn(line) if self.options.dedicated.is_some() => { - super::dedicated::log("WARN", &line); - } - HostEvent::Warn(line) => log::warn!("{line}"), HostEvent::Packet(conn, packet) => { self.lan_guest_packet(&mut host, conn, *packet); } @@ -1209,3 +1203,24 @@ impl Game<'_> { } } } + +impl Game<'_> { + /// A hub's chat and log lines: a dedicated server logs them + /// (MinecraftServer.logChatMessage, `[Not Secure]` for unsigned or + /// expired messages); a LAN host shows the chat. + pub(super) fn lan_log_event(&mut self, event: HostEvent) { + let dedicated = self.options.dedicated.is_some(); + match event { + HostEvent::Chat { line, secure } if dedicated => { + let tag = if secure { "" } else { "[Not Secure] " }; + super::dedicated::log("INFO", &format!("{tag}{line}")); + } + HostEvent::Chat { line, .. } => self.system_message(Text::literal(line)), + HostEvent::Warn(line) if dedicated => super::dedicated::log("WARN", &line), + HostEvent::Warn(line) => log::warn!("{line}"), + HostEvent::Error(line) if dedicated => super::dedicated::log("ERROR", &line), + HostEvent::Error(line) => log::error!("{line}"), + _ => {} + } + } +} diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index 59d71e7b2..ced435d8d 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -639,7 +639,8 @@ impl Game<'_> { self.drop_guest_items(host, gi, vec![c]); } } - S::ChatCommand(c) => self.guest_command(host, conn, &c.command), + S::ChatCommand(c) => self.guest_chat_command(host, conn, &c.command), + S::ChatCommandSigned(p) => self.guest_signed_command(host, conn, p), S::ChangeDifficulty(p) if host.hub.guests[gi].permission >= 2 => { if !self.level.difficulty_locked && (0..=3).contains(&p.difficulty) { self.ui.difficulty = if self.level.hardcore { @@ -731,12 +732,6 @@ impl Game<'_> { self.send_admin_feedback(host, Some(conn)); } } - S::Unknown(8, payload) => { - // A signed command: the text comes first. - if let Ok(text) = horizon_protocol::buf::Reader::new(&payload).string(32767) { - self.guest_command(host, conn, &text); - } - } S::Unknown(id, payload) if id == horizon_protocol::ids::play::serverbound::COMMAND_SUGGESTION => { @@ -861,7 +856,18 @@ impl Game<'_> { } /// Commands.performCommand for a guest with command access. - fn guest_command(&mut self, host: &mut LanHost, conn: u32, command: &str) { + /// Commands.performCommand for a guest, with the message arguments it + /// signed (none after an unsigned command packet). + pub(super) fn guest_command( + &mut self, + host: &mut LanHost, + conn: u32, + command: &str, + signed: Option<Vec<(String, horizon_client::lan::hub::chat::ChatMessage)>>, + ) { + if self.guest_message_command(host, conn, command, signed.as_ref()) { + return; + } // ListPlayersCommand needs no permission and lists every player. let words: Vec<&str> = command.trim_start_matches('/').split(' ').collect(); if words[0] == "list" && (words.len() == 1 || words[1..] == ["uuids"]) { diff --git a/crates/horizon-client/src/game/lan_chat.rs b/crates/horizon-client/src/game/lan_chat.rs new file mode 100644 index 000000000..f678480ab --- /dev/null +++ b/crates/horizon-client/src/game/lan_chat.rs @@ -0,0 +1,194 @@ +//! A guest's commands that carry chat: the unsigned and signed command +//! packets (ServerGamePacketListenerImpl.handleChatCommand and +//! handleSignedChatCommand), and the message commands whose text they sign +//! (SayCommand, EmoteCommands, MsgCommand), relayed by the hub as chat. +use super::{Game, lan::LanHost}; +use horizon_client::{ + command::{Arg, ArgType, NodeKind, ParseResults, vanilla}, + lan::{ + data::component_nbt, + hub::{HostEvent, chat::ChatMessage}, + }, + text::{self, Text}, +}; +use horizon_protocol::packets::play::{self, Clientbound as C}; + +/// The signing context of a command: each message argument as the chain +/// let it through, by argument name (CommandSigningContext.SignedArguments). +type Signed = Vec<(String, ChatMessage)>; + +impl Game<'_> { + /// CommandDispatcher.parse with the guest's permission level. + fn parse_as(&mut self, permission: u8, command: &str) -> ParseResults { + let level = std::mem::replace(&mut self.ui.registries.permission, permission); + let parse = vanilla::game_dispatcher().parse(command, &self.ui.registries); + self.ui.registries.permission = level; + parse + } + + /// SignableCommand.of: the command's message arguments, by name, with + /// their text, not past a redirect to the root (`execute ... run`). + fn signable_arguments(&mut self, permission: u8, command: &str) -> Vec<(String, String)> { + let parse = self.parse_as(permission, command); + let nodes = &vanilla::game_dispatcher().nodes; + let root = parse.context.root; + let mut out = Vec::new(); + let mut context = Some(&parse.context); + while let Some(c) = context { + for &(node, (start, end)) in &c.nodes { + if let NodeKind::Argument { + ty: ArgType::Message, + name, + } = &nodes[node].kind + && let Some(text) = command.get(start..end) + { + out.push((name.clone(), text.to_owned())); + } + } + context = c.child.as_deref().filter(|child| child.root != root); + } + out + } + + /// handleChatCommand (performUnsignedChatCommand): refused when the + /// server enforces secure chat and the command has a message to sign. + pub(super) fn guest_chat_command(&mut self, host: &mut LanHost, conn: u32, command: &str) { + let Some(i) = host.hub.guests.iter().position(|g| g.conn == conn) else { + return; + }; + if !host.hub.try_handle_chat(i, command, true) { + return; + } + let permission = host.hub.guests[i].permission; + if host.hub.enforces_secure_chat() + && !self.signable_arguments(permission, command).is_empty() + { + let name = host.hub.guests[i].name.clone(); + self.lan_log_event(HostEvent::Error(format!( + "Received unsigned command packet from {name}, but the command requires signable arguments: {command}" + ))); + let failure = Text::translate("chat.disabled.invalid_command_signature", &[]) + .with_color(text::RED); + host.hub.guests[i].send(&C::SystemChat(play::SystemChat { + content: component_nbt(&failure.component()), + overlay: false, + })); + return; + } + self.guest_command(host, conn, command, None); + } + + /// handleSignedChatCommand: the acknowledgements, then each message + /// argument through the sender's chain, then the command with them. + pub(super) fn guest_signed_command( + &mut self, + host: &mut LanHost, + conn: u32, + p: play::ChatCommandSigned, + ) { + let Some(i) = host.hub.guests.iter().position(|g| g.conn == conn) else { + return; + }; + let mut events = Vec::new(); + let mut signed = None; + if let Some(last_seen) = host.hub.apply_last_seen(i, &p.last_seen, &mut events) + && host.hub.try_handle_chat(i, &p.command, true) + { + let permission = host.hub.guests[i].permission; + let parsed = self.signable_arguments(permission, &p.command); + match host + .hub + .signed_arguments(i, &p, &parsed, &last_seen, &mut events) + { + Ok(arguments) => signed = Some(arguments), + Err(e) => host.hub.decode_failure(i, e, &mut events), + } + } + for event in events { + self.lan_log_event(event); + } + if let Some(signed) = signed { + self.guest_command(host, conn, &p.command, Some(signed)); + } + } + + /// SayCommand, EmoteCommands and MsgCommand for a guest: chat to the + /// players, signed when the guest signed it (a disguised chat after an + /// unsigned command packet). False when the command is another one, or + /// one this can't run (selectors other than `@s` and `@a`), for the + /// game's dispatcher to handle. + pub(super) fn guest_message_command( + &mut self, + host: &mut LanHost, + conn: u32, + command: &str, + signed: Option<&Signed>, + ) -> bool { + let Some(i) = host.hub.guests.iter().position(|g| g.conn == conn) else { + return false; + }; + let parse = self.parse_as(host.hub.guests[i].permission, command); + let Ok((context, id)) = parse.executable() else { + return false; + }; + let argument = if id == "me" { "action" } else { "message" }; + let (Some(Arg::Str(text)), true) = + (context.get(argument), matches!(id, "say" | "me" | "msg")) + else { + return false; + }; + let message = signed.and_then(|s| { + s.iter() + .find(|(n, _)| n == argument) + .map(|(_, m)| m.clone()) + }); + let mut events = Vec::new(); + if id == "msg" { + let Some(Arg::Entity(selector)) = context.get("targets") else { + return false; + }; + let raw = context + .args + .iter() + .rev() + .find(|a| a.name == "targets") + .and_then(|a| command.get(a.range.0..a.range.1)); + let guests = &host.hub.guests; + let placed = |k: &usize| guests[*k].placed; + let targets: Vec<usize> = match (raw, &selector.player_name, selector.uuid) { + (Some("@s"), ..) => vec![i], + (Some("@a"), ..) => (0..guests.len()).filter(placed).collect(), + (_, Some(name), _) => (0..guests.len()) + .filter(|&k| placed(&k) && guests[k].name.eq_ignore_ascii_case(name)) + .collect(), + (_, None, Some(uuid)) => (0..guests.len()) + .filter(|&k| placed(&k) && guests[k].uuid == uuid) + .collect(), + _ => return false, + }; + if targets.is_empty() { + let failure = Text::empty() + .append(Text::translate("argument.entity.notfound.player", &[])) + .with_color(text::RED); + host.hub.guests[i].send(&C::SystemChat(play::SystemChat { + content: component_nbt(&failure.component()), + overlay: false, + })); + return true; + } + host.hub.whisper(i, &targets, message, text); + } else { + let chat_type = if id == "say" { + "say_command" + } else { + "emote_command" + }; + host.hub + .broadcast_command_chat(i, chat_type, message, text, &mut events); + } + for event in events { + self.lan_log_event(event); + } + true + } +} diff --git a/crates/horizon-client/src/lan/guest.rs b/crates/horizon-client/src/lan/guest.rs index 780be4a33..1a699bc45 100644 --- a/crates/horizon-client/src/lan/guest.rs +++ b/crates/horizon-client/src/lan/guest.rs @@ -37,6 +37,12 @@ pub struct Guest { pub last_action_tick: u64, /// The next ClientboundPlayerChatPacket.globalIndex for this connection. pub chat_index: i32, + /// Secure chat (ServerGamePacketListenerImpl): the player's message + /// chain, keyed once it sends a chat session; the messages its + /// acknowledgements cover; the signatures its client caches. + pub chain: horizon_protocol::secure_chat::Chain, + pub last_seen: horizon_protocol::secure_chat::LastSeenValidator, + pub signatures: horizon_protocol::secure_chat::SignatureCache, /// The hub tick the player was placed on: chunks go out from the tick /// after next, behind the first doTick's packets, as vanilla's do. pub placed_at: u64, @@ -188,6 +194,9 @@ impl Guest { address: j.address, last_action_tick: 0, chat_index: 0, + chain: Default::default(), + last_seen: Default::default(), + signatures: Default::default(), placed_at: 0, center_sent: None, left_reason: String::new(), diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index e877fdd64..2d754dc24 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -33,6 +33,8 @@ use horizon_world::{ use std::sync::{Arc, atomic::Ordering}; /// GameEvent types (ClientboundGameEventPacket). +pub mod chat; + pub mod game_event { pub const START_RAINING: u8 = 1; pub const STOP_RAINING: u8 = 2; @@ -108,10 +110,16 @@ pub enum HostEvent { /// A guest left (state to save, entities to drop). Left(Box<Guest>), Packet(u32, Box<S>), - /// A chat line to show on the host (already broadcast to the guests). - Chat(String), + /// A chat line to show on the host (already broadcast to the guests); + /// a dedicated server logs it, `[Not Secure]` unless signed and fresh. + Chat { + line: String, + secure: bool, + }, /// A server log warning (ServerGamePacketListenerImpl's LOGGER.warn). Warn(String), + /// A server log error (LOGGER.error). + Error(String), } pub struct Hub { @@ -411,56 +419,23 @@ impl Hub { }, })); } - /// PlayerList.broadcastChatMessage of a guest's unsigned message - /// (PlayerChatMessage.unsigned): a ClientboundPlayerChatPacket to every - /// player, each connection numbering its messages. - pub fn player_chat(&mut self, from: usize, text: &str) { - let (uuid, name) = (self.guests[from].uuid, self.guests[from].name.clone()); - let timestamp = std::time::SystemTime::now() - .duration_since(std::time::UNIX_EPOCH) - .map_or(0, |d| d.as_millis() as i64); - let bound = play::ChatTypeBound { - chat_type: self.chat_type, - name: display_name(uuid, &name), - target: None, - }; - for g in self.guests.iter_mut().filter(|g| g.placed) { - let packet = C::PlayerChat(play::PlayerChat { - global_index: g.chat_index, - sender: uuid, - index: 0, - signature: None, - content: text.to_owned(), - timestamp, - salt: 0, - last_seen: Vec::new(), - unsigned_content: None, - filter: (0, Vec::new()), - chat_type: bound.clone(), - }); - g.chat_index += 1; - g.send(&packet); - } - } - /// Disconnect a guest with a reason (ServerGamePacketListenerImpl.disconnect). pub fn kick(&mut self, conn: u32, reason: Tag) { - if let Some(g) = self.guest(conn) { + // The log's "lost connection" line gives the reason, as vanilla's. + let text = self.english(&reason); + if let Some(g) = self.guest_mut(conn) { + g.left_reason = text; g.sender.disconnect(reason); } } fn player_info(&self, uuid: u128, name: &str, mode: i32, latency: i32) -> play::PlayerInfo { + let guest = self.guests.iter().find(|g| g.uuid == uuid); play::PlayerInfo { uuid, name: Some(name.to_owned()), - properties: self - .guests - .iter() - .find(|g| g.uuid == uuid) - .map(|g| g.properties.clone()) - .unwrap_or_default(), - chat_session: None, + properties: guest.map(|g| g.properties.clone()).unwrap_or_default(), + chat_session: guest.and_then(|g| g.chain.session()).map(|s| s.data()), game_mode: Some(mode), listed: Some(true), latency: Some(latency), @@ -553,8 +528,9 @@ impl Hub { show_death_screen: true, limited_crafting: false, spawn: self.spawn_info(mode), - online_mode: false, - enforces_secure_chat: false, + // MinecraftServer.usesAuthentication, enforceSecureProfile. + online_mode: self.lan.shared.config.online.is_some(), + enforces_secure_chat: self.enforces_secure_chat(), })); g.send(&C::ChangeDifficulty(play::ChangeDifficulty { difficulty: ctx.difficulty, @@ -1056,7 +1032,9 @@ impl Hub { fn remove_guest(&mut self, i: usize, reason: &str) -> Guest { let mut g = self.guests.remove(i); - g.left_reason = reason.to_owned(); + if g.left_reason.is_empty() { + g.left_reason = reason.to_owned(); + } if std::env::var_os("HORIZON_NET_DEBUG").is_some() { log::info!("[lan] {} left: {reason}", g.name); } @@ -1807,14 +1785,9 @@ impl Hub { 0 => self.wake(i), _ => {} }, - S::Chat(c) => { - let text: String = c.message.chars().filter(|c| !c.is_control()).collect(); - if !text.is_empty() { - let name = self.guests[i].name.clone(); - self.player_chat(i, &text); - events.push(HostEvent::Chat(format!("<{name}> {text}"))); - } - } + S::Chat(c) => self.handle_chat(i, c, events), + S::ChatAck(p) => self.chat_ack(i, p.offset, events), + S::ChatSessionUpdate(p) => self.chat_session_update(i, p, events), other => events.push(HostEvent::Packet(conn, Box::new(other))), } } diff --git a/crates/horizon-client/src/lan/hub/chat.rs b/crates/horizon-client/src/lan/hub/chat.rs new file mode 100644 index 000000000..7e75c84c5 --- /dev/null +++ b/crates/horizon-client/src/lan/hub/chat.rs @@ -0,0 +1,500 @@ +//! Chat on the server side, as ServerGamePacketListenerImpl and PlayerList +//! handle it: chat sessions validated against the services' keys, signed +//! messages checked link by link, the acknowledged window, and messages +//! relayed with each connection's numbering and signature cache. +use super::{HostEvent, Hub, display_name}; +use horizon_protocol::{ + packets::play::{self, Clientbound as C}, + secure_chat::{self, Body, Chain, ChatSession, DecodeError, ProfileKey, Signature, Unpacked}, + text::{literal, translatable}, +}; +use horizon_world::nbt::{JavaString, Tag}; + +/// Now, in epoch milliseconds (Instant.now()). +pub fn now_millis() -> i64 { + std::time::SystemTime::now() + .duration_since(std::time::UNIX_EPOCH) + .map_or(0, |d| d.as_millis() as i64) +} + +/// StringUtil.isAllowedChatCharacter. +fn allowed(c: char) -> bool { + c != '\u{a7}' && c >= ' ' && c != '\u{7f}' +} + +/// A translatable message in red. +fn red(key: &str) -> Tag { + let mut t = translatable(key, &[]); + if let Tag::Compound(map) = &mut t { + map.insert( + JavaString::from("color"), + Tag::String(JavaString::from("red")), + ); + } + t +} + +/// PlayerChatMessage as the server relays it. +#[derive(Clone, Debug, PartialEq)] +pub struct ChatMessage { + pub sender: u128, + /// The link's index in the sender's chain (0 when unsigned). + pub index: i32, + pub signature: Option<Signature>, + pub content: String, + /// Epoch milliseconds. + pub timestamp: i64, + pub salt: i64, + pub last_seen: Vec<Signature>, + /// What clients show instead of the signed text (withUnsignedContent). + pub unsigned_content: Option<Tag>, +} + +impl ChatMessage { + /// The message a chain let through: a signed one keeps its body; + /// PlayerChatMessage.unsigned takes the time now, no salt, nothing seen. + pub fn new(sender: u128, unpacked: Unpacked, body: &Body, now: i64) -> Self { + let (index, signature, timestamp, salt, last_seen) = match unpacked { + Unpacked::Unsigned => (0, None, now, 0, Vec::new()), + Unpacked::Signed { index, signature } => ( + index, + Some(signature), + body.timestamp, + body.salt, + body.last_seen.to_vec(), + ), + }; + Self { + sender, + index, + signature, + content: body.content.to_owned(), + timestamp, + salt, + last_seen, + unsigned_content: None, + } + } + /// hasExpiredServer. + pub fn expired(&self, now: i64) -> bool { + now > self.timestamp + secure_chat::EXPIRES_AFTER_SERVER + } + /// PlayerList.verifyChatTrusted: signed and not expired. + pub fn trusted(&self, now: i64) -> bool { + self.signature.is_some() && !self.expired(now) + } +} + +impl Hub { + /// MinecraftServer.enforceSecureProfile. + pub fn enforces_secure_chat(&self) -> bool { + self.lan.shared.config.enforces_secure_chat() + } + + /// Component.getString in the server's language, for the log. + pub(crate) fn english(&self, tag: &Tag) -> String { + match &self.lan.shared.config.log { + Some(log) => horizon_protocol::text::plain(tag, &log.lang), + None => horizon_protocol::text::plain(tag, &Default::default()), + } + } + + /// tryHandleChat: an illegal character disconnects; with chat hidden a + /// message (not a command) is refused. Whether to go on. + pub fn try_handle_chat(&mut self, i: usize, message: &str, command: bool) -> bool { + let conn = self.guests[i].conn; + if !message.chars().all(allowed) { + self.kick( + conn, + translatable("multiplayer.disconnect.illegal_characters", &[]), + ); + return false; + } + // ChatVisiblity.HIDDEN. + if !command && self.guests[i].info.chat_visibility == 2 { + self.guests[i].send(&C::SystemChat(play::SystemChat { + content: red("chat.disabled.options"), + overlay: false, + })); + return false; + } + true + } + + /// unpackAndApplyLastSeen: the acknowledged messages, or a disconnect. + pub fn apply_last_seen( + &mut self, + i: usize, + update: &play::LastSeenUpdate, + events: &mut Vec<HostEvent>, + ) -> Option<Vec<Signature>> { + let g = &mut self.guests[i]; + match g + .last_seen + .apply_update(update.offset, update.acknowledged, update.checksum) + { + Ok(seen) => Some(seen), + // Vanilla logs the ValidationException's stack trace after the line. + Err(_) => { + events.push(HostEvent::Error(format!( + "Failed to validate message acknowledgements from {}", + g.name + ))); + let conn = g.conn; + self.kick( + conn, + translatable("multiplayer.disconnect.chat_validation_failed", &[]), + ); + None + } + } + } + + /// handleChatAck. + pub(super) fn chat_ack(&mut self, i: usize, offset: i32, events: &mut Vec<HostEvent>) { + let g = &mut self.guests[i]; + if g.last_seen.apply_offset(offset).is_err() { + events.push(HostEvent::Error(format!( + "Failed to validate message acknowledgement offset from {}", + g.name + ))); + let conn = g.conn; + self.kick( + conn, + translatable("multiplayer.disconnect.chat_validation_failed", &[]), + ); + } + } + + /// handleMessageDecodeFailure: logged, and the reason in red for the player. + pub fn decode_failure(&mut self, i: usize, e: DecodeError, events: &mut Vec<HostEvent>) { + let reason = red(e.key()); + events.push(HostEvent::Warn(format!( + "Failed to update secure chat state for {}: '{}'", + self.guests[i].name, + self.english(&reason) + ))); + self.guests[i].send(&C::SystemChat(play::SystemChat { + content: reason, + overlay: false, + })); + } + + /// handleChat: the acknowledgements, then the message through the + /// sender's chain, then to everyone. + pub(super) fn handle_chat(&mut self, i: usize, c: play::Chat, events: &mut Vec<HostEvent>) { + let Some(last_seen) = self.apply_last_seen(i, &c.last_seen, events) else { + return; + }; + if !self.try_handle_chat(i, &c.message, false) { + return; + } + let (enforce, now) = (self.enforces_secure_chat(), now_millis()); + let body = Body { + content: &c.message, + timestamp: c.timestamp, + salt: c.salt, + last_seen: &last_seen, + }; + let signature = c.signature.as_deref().and_then(secure_chat::signature); + let g = &mut self.guests[i]; + let (uuid, name) = (g.uuid, g.name.clone()); + let message = match g + .chain + .unpack(uuid, signature.as_ref(), &body, enforce, now) + { + Ok(unpacked) => ChatMessage::new(uuid, unpacked, &body, now), + Err(e) => return self.decode_failure(i, e, events), + }; + if message.signature.is_some() && message.expired(now) { + events.push(HostEvent::Warn(format!( + "Received expired chat: '{}'. Is the client/server system time unsynchronized?", + message.content + ))); + } + let bound = play::ChatTypeBound { + chat_type: self.chat_type, + name: display_name(uuid, &name), + target: None, + }; + let line = format!("<{name}> {}", message.content); + self.broadcast_chat(&message, &bound, line, events); + } + + /// handleChatSessionUpdate: a new profile key, validated against the + /// services' keys, starts a new chain and is announced to everyone. + pub(super) fn chat_session_update( + &mut self, + i: usize, + p: play::ChatSessionUpdate, + events: &mut Vec<HostEvent>, + ) { + let key = ProfileKey { + expires_at: p.expires_at, + key: p.key, + signature: p.key_signature, + }; + let g = &self.guests[i]; + let (conn, uuid) = (g.conn, g.uuid); + let old = g.chain.session().map(|s| s.profile_key.expires_at); + if g.chain.session().is_some_and(|s| s.profile_key == key) { + return; + } + if old.is_some_and(|old| key.expires_at < old) { + self.kick( + conn, + translatable("multiplayer.disconnect.expired_public_key", &[]), + ); + return; + } + let secure = self.lan.shared.config.secure_chat.clone(); + let keys = secure.as_deref().map_or(&[][..], |s| s.keys()); + if keys.is_empty() { + events.push(HostEvent::Warn(format!( + "Ignoring chat session from {} due to missing Services public key", + g.name + ))); + return; + } + match ChatSession::validate(p.session, key, keys, uuid) { + Ok(session) => { + let data = session.data(); + self.guests[i].chain = Chain::keyed(session); + // resetPlayerChatState: INITIALIZE_CHAT to every player. + self.broadcast(&C::PlayerInfoUpdate(play::PlayerInfoUpdate { + actions: 2, + entries: vec![play::PlayerInfo { + uuid, + chat_session: Some(data), + ..Default::default() + }], + })); + } + Err(reason) => { + events.push(HostEvent::Error( + "Failed to validate profile key".to_owned(), + )); + self.kick(conn, translatable(reason, &[])); + } + } + } + + /// PlayerList.broadcastChatMessage: logged (`[Not Secure]` unless signed + /// and fresh), then sent to every player. + pub fn broadcast_chat( + &mut self, + message: &ChatMessage, + bound: &play::ChatTypeBound, + line: String, + events: &mut Vec<HostEvent>, + ) { + let secure = message.trusted(now_millis()); + events.push(HostEvent::Chat { line, secure }); + for k in 0..self.guests.len() { + if self.guests[k].placed { + self.send_chat(k, message, bound); + } + } + } + + /// ServerPlayer.sendChatMessage (players who show chat) and + /// sendPlayerChatMessage: numbered for the connection, the last seen + /// packed against its cache; a signed message joins the cache and the + /// messages the player must acknowledge. + pub fn send_chat(&mut self, k: usize, message: &ChatMessage, bound: &play::ChatTypeBound) { + let g = &mut self.guests[k]; + if g.info.chat_visibility != 0 { + return; + } + let last_seen = message + .last_seen + .iter() + .map(|s| g.signatures.pack(s)) + .collect(); + g.send(&C::PlayerChat(play::PlayerChat { + global_index: g.chat_index, + sender: message.sender, + index: message.index, + signature: message.signature.map(|s| s.to_vec()), + content: message.content.clone(), + timestamp: message.timestamp, + salt: message.salt, + last_seen, + unsigned_content: message.unsigned_content.clone(), + filter: (0, Vec::new()), + chat_type: bound.clone(), + })); + g.chat_index += 1; + if let Some(signature) = &message.signature { + g.signatures.push(&message.last_seen, Some(signature)); + g.last_seen.add_pending(signature); + if g.last_seen.tracked_count() > 4096 { + let conn = g.conn; + self.kick( + conn, + translatable("multiplayer.disconnect.too_many_pending_chats", &[]), + ); + } + } + } + + /// sendChatMessage of a system message: a disguised chat, to players + /// who show chat. + fn send_disguised(&self, k: usize, message: Tag, chat_type: play::ChatTypeBound) { + let g = &self.guests[k]; + if g.info.chat_visibility == 0 { + g.send(&C::DisguisedChat(play::DisguisedChat { + message, + chat_type, + })); + } + } + + /// collectSignedArguments, or collectUnsignedArguments when the client + /// signed none: each of the command's message arguments (`parsed`, by + /// name) through the sender's chain. + pub fn signed_arguments( + &mut self, + i: usize, + p: &play::ChatCommandSigned, + parsed: &[(String, String)], + last_seen: &[Signature], + events: &mut Vec<HostEvent>, + ) -> Result<Vec<(String, ChatMessage)>, DecodeError> { + let (enforce, now) = (self.enforces_secure_chat(), now_millis()); + let g = &mut self.guests[i]; + let uuid = g.uuid; + let mut out = Vec::new(); + if p.arguments.is_empty() { + for (name, value) in parsed { + // SignedMessageBody.unsigned. + let body = Body { + content: value, + timestamp: now, + salt: 0, + last_seen: &[], + }; + let unpacked = g.chain.unpack(uuid, None, &body, enforce, now)?; + out.push((name.clone(), ChatMessage::new(uuid, unpacked, &body, now))); + } + return Ok(out); + } + let mismatch = |events: &mut Vec<HostEvent>| { + let names = |l: &mut dyn Iterator<Item = &String>| { + l.map(String::as_str).collect::<Vec<_>>().join(", ") + }; + events.push(HostEvent::Error(format!( + "Signed command mismatch between server and client ('{}'): got [{}] from client, but expected [{}]", + p.command, + names(&mut p.arguments.iter().map(|a| &a.0)), + names(&mut parsed.iter().map(|a| &a.0)), + ))); + DecodeError::InvalidCommandSignature + }; + for (name, signature) in &p.arguments { + let Some((_, value)) = parsed.iter().find(|(n, _)| n == name) else { + g.chain.set_broken(); + return Err(mismatch(events)); + }; + let body = Body { + content: value, + timestamp: p.timestamp, + salt: p.salt, + last_seen, + }; + let signature = secure_chat::signature(signature); + let unpacked = g + .chain + .unpack(uuid, signature.as_ref(), &body, enforce, now)?; + out.push((name.clone(), ChatMessage::new(uuid, unpacked, &body, now))); + } + if parsed.iter().any(|(n, _)| !out.iter().any(|(o, _)| o == n)) { + return Err(mismatch(events)); + } + Ok(out) + } + + /// A message command's chat (SayCommand, EmoteCommands): to everyone, + /// bound to `chat_type` and the sender's name. + pub fn broadcast_command_chat( + &mut self, + i: usize, + chat_type: &str, + message: Option<ChatMessage>, + text: &str, + events: &mut Vec<HostEvent>, + ) { + let (uuid, name) = (self.guests[i].uuid, self.guests[i].name.clone()); + let bound = play::ChatTypeBound { + chat_type: self.chat_type_id(chat_type), + name: display_name(uuid, &name), + target: None, + }; + let line = match chat_type { + "say_command" => format!("[{name}] {text}"), + _ => format!("* {name} {text}"), + }; + match message { + Some(message) => self.broadcast_chat(&message, &bound, line, events), + // An unsigned command packet (no signing context): + // PlayerChatMessage.system, a disguised chat. + None => { + events.push(HostEvent::Chat { + line, + secure: false, + }); + for k in 0..self.guests.len() { + if self.guests[k].placed { + self.send_disguised(k, literal(text), bound.clone()); + } + } + } + } + } + + /// MsgCommand.sendMessage to each target: the outgoing line for the + /// sender, the incoming one for the target. Nothing is logged. + pub fn whisper( + &mut self, + i: usize, + targets: &[usize], + message: Option<ChatMessage>, + text: &str, + ) { + let (uuid, name) = (self.guests[i].uuid, self.guests[i].name.clone()); + let (outgoing, incoming) = ( + self.chat_type_id("msg_command_outgoing"), + self.chat_type_id("msg_command_incoming"), + ); + for &t in targets { + let target = display_name(self.guests[t].uuid, &self.guests[t].name); + let out = play::ChatTypeBound { + chat_type: outgoing, + name: display_name(uuid, &name), + target: Some(target), + }; + let inc = play::ChatTypeBound { + chat_type: incoming, + name: display_name(uuid, &name), + target: None, + }; + match &message { + Some(m) => { + self.send_chat(i, m, &out); + self.send_chat(t, m, &inc); + } + None => { + self.send_disguised(i, literal(text), out); + self.send_disguised(t, literal(text), inc); + } + } + } + } + + /// A chat type's registry id. + fn chat_type_id(&self, name: &str) -> i32 { + self.sync + .id("minecraft:chat_type", &format!("minecraft:{name}")) + .unwrap_or(self.chat_type) + } +} diff --git a/crates/horizon-client/src/lan/mod.rs b/crates/horizon-client/src/lan/mod.rs index 7a1d921a4..afe188699 100644 --- a/crates/horizon-client/src/lan/mod.rs +++ b/crates/horizon-client/src/lan/mod.rs @@ -122,8 +122,8 @@ pub struct NetConfig { pub hide_online_players: bool, /// server-icon.png (64x64 PNG bytes). pub favicon: Option<Vec<u8>>, - /// MinecraftServer.enforceSecureProfile. - pub enforces_secure_chat: bool, + /// Secure chat (a dedicated server; none on a LAN world). + pub secure_chat: Option<Arc<SecureChat>>, pub accepts_transfers: bool, /// LanServerPinger: announce the world on the local network. pub announce: bool, @@ -138,6 +138,10 @@ pub struct NetConfig { pub log: Option<NetLog>, } impl NetConfig { + /// MinecraftServer.enforceSecureProfile. + pub fn enforces_secure_chat(&self) -> bool { + self.secure_chat.as_ref().is_some_and(|s| s.enforced()) + } /// IntegratedServer.publishServer. pub fn lan(port: u16, motd: String, max_players: usize) -> Self { Self { @@ -149,7 +153,7 @@ impl NetConfig { enable_status: true, hide_online_players: false, favicon: None, - enforces_secure_chat: false, + secure_chat: None, accepts_transfers: false, announce: true, listen: true, @@ -161,6 +165,46 @@ impl NetConfig { } } +/// A dedicated server's secure chat (DedicatedServer.enforceSecureProfile, +/// Services.profileKeySignatureValidator): the services' profile-key keys, +/// fetched in the background from startup and waited for by their first +/// use, as authlib's RetryableFetch does. +pub struct SecureChat { + /// enforce-secure-profile, in online mode. + pub enforce: bool, + keys: std::sync::OnceLock<Vec<horizon_protocol::rsa::RsaPublicKey>>, + fetch: Mutex<Option<JoinHandle<Vec<horizon_protocol::rsa::RsaPublicKey>>>>, +} + +impl SecureChat { + pub fn new( + enforce: bool, + fetch: impl FnOnce() -> Vec<horizon_protocol::rsa::RsaPublicKey> + Send + 'static, + ) -> Self { + let handle = std::thread::Builder::new() + .name("Services keys".into()) + .spawn(fetch) + .ok(); + Self { + enforce, + keys: std::sync::OnceLock::new(), + fetch: Mutex::new(handle), + } + } + /// The keys players' chat keys must be signed by (none when the + /// services couldn't be reached). + pub fn keys(&self) -> &[horizon_protocol::rsa::RsaPublicKey] { + self.keys.get_or_init(|| { + let handle = self.fetch.lock().ok().and_then(|mut h| h.take()); + handle.and_then(|h| h.join().ok()).unwrap_or_default() + }) + } + /// enforceSecureProfile: enforced, and able to check keys. + pub fn enforced(&self) -> bool { + self.enforce && !self.keys().is_empty() + } +} + /// State shared with the connection threads. pub struct Shared { pub sync: Arc<data::SyncData>, @@ -301,7 +345,7 @@ impl Shared { Json::String(format!("data:image/png;base64,{}", base64(icon))), )); } - if self.config.enforces_secure_chat { + if self.config.enforces_secure_chat() { status.push(("enforcesSecureChat".to_owned(), Json::Bool(true))); } Json::Object(status).compact() diff --git a/crates/horizon-protocol/Cargo.toml b/crates/horizon-protocol/Cargo.toml index aa1f60f89..66a0af162 100644 --- a/crates/horizon-protocol/Cargo.toml +++ b/crates/horizon-protocol/Cargo.toml @@ -13,6 +13,8 @@ serde_json = "1.0.151" # The shared secret and RSA padding (OS randomness) and the server hash. getrandom = "0.3" sha1 = "0.10" +# Secure chat: SHA256withRSA message signatures. +sha2 = "0.10" [lints] workspace = true diff --git a/crates/horizon-protocol/src/buf.rs b/crates/horizon-protocol/src/buf.rs index e761aec3f..349ec74cf 100644 --- a/crates/horizon-protocol/src/buf.rs +++ b/crates/horizon-protocol/src/buf.rs @@ -311,6 +311,16 @@ impl Codec<Vec<u8>> for Bytes { w.byte_array(v) } } +/// ByteBufCodecs.byteArray(N): VarInt-prefixed bytes, at most N. +pub struct BytesN<const N: usize>; +impl<const N: usize> Codec<Vec<u8>> for BytesN<N> { + fn read(r: &mut Reader) -> Result<Vec<u8>> { + r.byte_array(N) + } + fn write(v: &Vec<u8>, w: &mut Writer) { + w.byte_array(v) + } +} /// Everything left in the packet (custom payloads). pub struct Rest; impl Codec<Vec<u8>> for Rest { diff --git a/crates/horizon-protocol/src/lib.rs b/crates/horizon-protocol/src/lib.rs index e49031b77..1d0f081f7 100644 --- a/crates/horizon-protocol/src/lib.rs +++ b/crates/horizon-protocol/src/lib.rs @@ -13,6 +13,7 @@ pub mod item; pub mod packets; pub mod registry; pub mod rsa; +pub mod secure_chat; pub mod servers; pub mod text; diff --git a/crates/horizon-protocol/src/packets/play.rs b/crates/horizon-protocol/src/packets/play.rs index 20a25d078..895db9755 100644 --- a/crates/horizon-protocol/src/packets/play.rs +++ b/crates/horizon-protocol/src/packets/play.rs @@ -2,9 +2,9 @@ use crate::{ Error, Result, buf::{ - Bool, Byte, ChunkPos, Codec, Double, Float, Ident, Int, List, Long, LpVec3, Nbt, Opt, - OptVarInt, Pos, Reader, SectionPos, Short, Str, StrN, UByte, Uuid, VarInt, VarLong, Vec3d, - Writer, + Bool, Byte, BytesN, ChunkPos, Codec, Double, Float, Ident, Int, List, Long, LpVec3, Nbt, + Opt, OptVarInt, Pos, Reader, SectionPos, Short, Str, StrN, UByte, Uuid, VarInt, VarLong, + Vec3d, Writer, }, chunk::{ChunkData, LightData}, entity_data::{EntityData, Value}, @@ -1604,6 +1604,42 @@ packet!(Chat { last_seen: LastSeenUpdate => LastSeenUpdate, }); packet!(ChatCommand { command: String => Str }); +packet!(ChatAck { offset: i32 => VarInt }); +/// ArgumentSignatures: each signed argument's name (at most 16 chars) and +/// signature, at most 8. +pub struct ArgumentSignatures; +impl Codec<Vec<(String, Vec<u8>)>> for ArgumentSignatures { + fn read(r: &mut Reader) -> Result<Vec<(String, Vec<u8>)>> { + let n = r.count(8)?; + (0..n) + .map(|_| Ok((r.string(16)?, r.bytes(256)?.to_vec()))) + .collect() + } + fn write(v: &Vec<(String, Vec<u8>)>, w: &mut Writer) { + w.varint(v.len() as i32); + for (name, signature) in v { + w.string(name); + w.bytes(signature); + } + } +} +packet!(ChatCommandSigned { + command: String => Str, + timestamp: i64 => Long, + salt: i64 => Long, + arguments: Vec<(String, Vec<u8>)> => ArgumentSignatures, + last_seen: LastSeenUpdate => LastSeenUpdate, +}); +packet!( + /// RemoteChatSession.Data: the session id, then ProfilePublicKey.Data + /// (expiry in epoch milliseconds, X.509 key, the services' signature). + ChatSessionUpdate { + session: u128 => Uuid, + expires_at: i64 => Long, + key: Vec<u8> => BytesN<512>, + key_signature: Vec<u8> => BytesN<4096>, + } +); packet!(ChangeDifficultyRequest { difficulty: i32 => VarInt }); packet!(LockDifficulty { locked: bool => Bool }); packet!(SetGameRule { entries: Vec<GameRuleEntry> => List<GameRuleEntry> }); @@ -1697,7 +1733,10 @@ packet_enum!(Serverbound, crate::ids::play::serverbound { Attack(Attack) = ATTACK, ChangeGameMode(ChangeGameMode) = CHANGE_GAME_MODE, Chat(Chat) = CHAT, + ChatAck(ChatAck) = CHAT_ACK, ChatCommand(ChatCommand) = CHAT_COMMAND, + ChatCommandSigned(ChatCommandSigned) = CHAT_COMMAND_SIGNED, + ChatSessionUpdate(ChatSessionUpdate) = CHAT_SESSION_UPDATE, PlaceRecipe(super::recipes::PlaceRecipe) = PLACE_RECIPE, ChunkBatchReceived(ChunkBatchReceived) = CHUNK_BATCH_RECEIVED, ClientCommand(ClientCommand) = CLIENT_COMMAND, @@ -2184,6 +2223,24 @@ mod tests { Serverbound::ChatCommand(ChatCommand { command: "time set day".into(), }), + Serverbound::ChatAck(ChatAck { offset: 3 }), + Serverbound::ChatCommandSigned(ChatCommandSigned { + command: "say hi".into(), + timestamp: 1_700_000_000_000, + salt: -5, + arguments: vec![("message".into(), vec![9; 256])], + last_seen: LastSeenUpdate { + offset: 1, + acknowledged: [1, 0, 8], + checksum: -3, + }, + }), + Serverbound::ChatSessionUpdate(ChatSessionUpdate { + session: 0x1234, + expires_at: 1_800_000_000_000, + key: vec![0x30; 294], + key_signature: vec![7; 512], + }), Serverbound::ChunkBatchReceived(ChunkBatchReceived { chunks_per_tick: 9.5, }), diff --git a/crates/horizon-protocol/src/rsa.rs b/crates/horizon-protocol/src/rsa.rs index fe31e425e..d34489fb4 100644 --- a/crates/horizon-protocol/src/rsa.rs +++ b/crates/horizon-protocol/src/rsa.rs @@ -3,8 +3,10 @@ //! and challenge (Crypt.encryptUsingKey, Java's "RSA" cipher = //! RSA/ECB/PKCS1Padding), and on the server's side the key pair it makes at //! startup (Crypt.generateKeyPair: 1024 bits) and the decryption -//! (Crypt.decryptUsingKey). Modular exponentiation uses Montgomery -//! multiplication on 32-bit limbs; RSA moduli are always odd. +//! (Crypt.decryptUsingKey); and the PKCS#1 v1.5 signature checks of secure +//! chat (SHA256withRSA for messages, SHA1withRSA for the services' profile +//! key signatures). Modular exponentiation uses Montgomery multiplication on +//! 32-bit limbs; RSA moduli are always odd. use crate::{Error, Result}; /// A non-negative integer, little-endian 32-bit limbs. @@ -291,6 +293,63 @@ impl RsaPublicKey { } } +/// The digest a PKCS#1 v1.5 signature covers: Java's `SHA1withRSA` and +/// `SHA256withRSA`. +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub enum SignatureHash { + Sha1, + Sha256, +} + +impl SignatureHash { + /// The DER DigestInfo before the digest (RFC 8017 9.2, note 1). + fn prefix(self) -> &'static [u8] { + match self { + Self::Sha1 => &[ + 0x30, 0x21, 0x30, 0x09, 0x06, 0x05, 0x2b, 0x0e, 0x03, 0x02, 0x1a, 0x05, 0x00, 0x04, + 0x14, + ], + Self::Sha256 => &[ + 0x30, 0x31, 0x30, 0x0d, 0x06, 0x09, 0x60, 0x86, 0x48, 0x01, 0x65, 0x03, 0x04, 0x02, + 0x01, 0x05, 0x00, 0x04, 0x20, + ], + } + } + fn digest(self, message: &[u8]) -> Vec<u8> { + use sha1::Digest; + match self { + Self::Sha1 => sha1::Sha1::digest(message).to_vec(), + Self::Sha256 => sha2::Sha256::digest(message).to_vec(), + } + } +} + +impl RsaPublicKey { + /// `Signature.verify` for RSASSA-PKCS1-v1_5 (RFC 8017 8.2.2): the + /// signature is exactly the modulus' length and below it, and opens to + /// `00 01 FF.. 00 DigestInfo`. Anything else is a failed check, as + /// SignatureValidator reports Java's exceptions. + pub fn verify(&self, hash: SignatureHash, message: &[u8], signature: &[u8]) -> bool { + let k = self.size(); + // Equal lengths compare as big-endian numbers. + if signature.len() != k || signature >= self.modulus.as_slice() { + return false; + } + let (prefix, digest) = (hash.prefix(), hash.digest(message)); + let t = prefix.len() + digest.len(); + if k < t + 11 { + return false; + } + let mut expected = vec![0xff; k]; + expected[0] = 0; + expected[1] = 1; + expected[k - t - 1] = 0; + expected[k - t..k - digest.len()].copy_from_slice(prefix); + expected[k - digest.len()..].copy_from_slice(&digest); + self.apply(signature, &self.exponent) == expected + } +} + /// Small odd primes for sieving prime candidates. const SMALL_PRIMES: [u32; 53] = [ 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, 73, 79, 83, 89, 97, @@ -604,5 +663,34 @@ pub(crate) mod tests { assert!(block.ends_with(&hex( "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824" ))); + let signature = hex(TEST_SIG_HELLO); + assert!(key.verify(SignatureHash::Sha256, b"hello", &signature)); + assert!(!key.verify(SignatureHash::Sha256, b"hellO", &signature)); + assert!(!key.verify(SignatureHash::Sha1, b"hello", &signature)); + let mut flipped = signature.clone(); + flipped[40] ^= 1; + assert!(!key.verify(SignatureHash::Sha256, b"hello", &flipped)); + assert!(!key.verify(SignatureHash::Sha256, b"hello", &signature[1..])); + assert!(!key.verify(SignatureHash::Sha256, b"hello", &key.modulus)); + } + + /// Signatures made here with the private exponent (EMSA-PKCS1-v1_5 by + /// hand) check out for both digests. + #[test] + fn verifies_both_digests() { + let key = RsaPublicKey::from_der(&hex(TEST_SPKI)).unwrap(); + for hash in [SignatureHash::Sha1, SignatureHash::Sha256] { + let (prefix, digest) = (hash.prefix(), hash.digest(b"payload")); + let mut block = vec![0xff; 128]; + block[0] = 0; + block[1] = 1; + let t = prefix.len() + digest.len(); + block[127 - t] = 0; + block[128 - t..128 - digest.len()].copy_from_slice(prefix); + block[128 - digest.len()..].copy_from_slice(&digest); + let signature = key.apply(&block, &hex(TEST_D)); + assert!(key.verify(hash, b"payload", &signature)); + assert!(!key.verify(hash, b"payloaD", &signature)); + } } } diff --git a/crates/horizon-protocol/src/secure_chat.rs b/crates/horizon-protocol/src/secure_chat.rs new file mode 100644 index 000000000..534c132f6 --- /dev/null +++ b/crates/horizon-protocol/src/secure_chat.rs @@ -0,0 +1,491 @@ +//! Secure chat as vanilla 26.3's server keeps it: a player's profile key, +//! validated against the services' keys (ProfilePublicKey, +//! RemoteChatSession), the message chain each player signs +//! (SignedMessageChain), what a signature covers (PlayerChatMessage, +//! SignedMessageLink, SignedMessageBody), the window of messages a client +//! acknowledges (LastSeenMessagesValidator) and the cache a connection packs +//! signatures against (MessageSignatureCache). +use crate::rsa::{RsaPublicKey, SignatureHash}; +use std::collections::{HashSet, VecDeque}; + +/// MessageSignature.BYTES. +pub const SIGNATURE_BYTES: usize = 256; +/// A message signature (MessageSignature). +pub type Signature = [u8; SIGNATURE_BYTES]; +/// LastSeenMessages.LAST_SEEN_MESSAGES_MAX_LENGTH: the window a client acknowledges. +pub const LAST_SEEN: usize = 20; +/// PlayerChatMessage.MESSAGE_EXPIRES_AFTER_SERVER, in milliseconds. +pub const EXPIRES_AFTER_SERVER: i64 = 5 * 60 * 1000; + +/// A signature from its packet bytes (always 256 on the wire). +pub fn signature(bytes: &[u8]) -> Option<Signature> { + bytes.try_into().ok() +} + +/// ProfilePublicKey.Data: the player's chat key (X.509 DER), when it +/// expires (epoch milliseconds), and the services' signature over both. +#[derive(Clone, Debug, PartialEq, Eq)] +pub struct ProfileKey { + pub expires_at: i64, + pub key: Vec<u8>, + pub signature: Vec<u8>, +} + +impl ProfileKey { + /// Data.signedPayload: the profile id, the expiry and the key. + fn signed_payload(&self, profile: u128) -> Vec<u8> { + let mut out = Vec::with_capacity(24 + self.key.len()); + out.extend_from_slice(&profile.to_be_bytes()); + out.extend_from_slice(&self.expires_at.to_be_bytes()); + out.extend_from_slice(&self.key); + out + } + /// Data.validateSignature with the services' profile-key keys + /// (SignatureValidator.from(keySet, PROFILE_KEY): any of them, SHA1withRSA). + pub fn signed_by(&self, services: &[RsaPublicKey], profile: u128) -> bool { + let payload = self.signed_payload(profile); + services + .iter() + .any(|k| k.verify(SignatureHash::Sha1, &payload, &self.signature)) + } + /// Data.hasExpired. + pub fn has_expired(&self, now: i64) -> bool { + self.expires_at < now + } +} + +/// A validated RemoteChatSession: its id and the player's profile key. +#[derive(Clone, Debug)] +pub struct ChatSession { + pub id: u128, + pub profile_key: ProfileKey, + key: RsaPublicKey, +} + +impl ChatSession { + /// RemoteChatSession.Data.validate (ProfilePublicKey.createValidated); + /// the error is the disconnect message's translation key. + pub fn validate( + id: u128, + profile_key: ProfileKey, + services: &[RsaPublicKey], + profile: u128, + ) -> Result<Self, &'static str> { + const INVALID: &str = "multiplayer.disconnect.invalid_public_key_signature"; + let key = RsaPublicKey::from_der(&profile_key.key).map_err(|_| INVALID)?; + if !profile_key.signed_by(services, profile) { + return Err(INVALID); + } + Ok(Self { + id, + profile_key, + key, + }) + } + /// RemoteChatSession.Data, as ClientboundPlayerInfoUpdatePacket's + /// INITIALIZE_CHAT carries it. + pub fn data(&self) -> (u128, i64, Vec<u8>, Vec<u8>) { + let k = &self.profile_key; + (self.id, k.expires_at, k.key.clone(), k.signature.clone()) + } +} + +/// SignedMessageBody: what a player signed besides the chain link. +#[derive(Clone, Copy, Debug)] +pub struct Body<'a> { + pub content: &'a str, + /// Epoch milliseconds. + pub timestamp: i64, + pub salt: i64, + pub last_seen: &'a [Signature], +} + +/// PlayerChatMessage.updateSignature: the version, the link (sender, +/// session, index) and the body (salt, time in seconds, content, last seen). +pub fn signed_payload(sender: u128, session: u128, index: i32, body: &Body) -> Vec<u8> { + let content = body.content.as_bytes(); + let mut out = Vec::with_capacity(64 + content.len() + body.last_seen.len() * SIGNATURE_BYTES); + out.extend_from_slice(&1i32.to_be_bytes()); + out.extend_from_slice(&sender.to_be_bytes()); + out.extend_from_slice(&session.to_be_bytes()); + out.extend_from_slice(&index.to_be_bytes()); + out.extend_from_slice(&body.salt.to_be_bytes()); + out.extend_from_slice(&body.timestamp.div_euclid(1000).to_be_bytes()); + out.extend_from_slice(&(content.len() as i32).to_be_bytes()); + out.extend_from_slice(content); + out.extend_from_slice(&(body.last_seen.len() as i32).to_be_bytes()); + for s in body.last_seen { + out.extend_from_slice(s); + } + out +} + +/// SignedMessageChain.DecodeException's messages, and the signed command +/// mismatch (ServerGamePacketListenerImpl.INVALID_COMMAND_SIGNATURE). +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub enum DecodeError { + MissingProfileKey, + ChainBroken, + ExpiredProfileKey, + InvalidSignature, + OutOfOrderChat, + InvalidCommandSignature, +} + +impl DecodeError { + pub fn key(self) -> &'static str { + match self { + Self::MissingProfileKey => "chat.disabled.missingProfileKey", + Self::ChainBroken => "chat.disabled.chain_broken", + Self::ExpiredProfileKey => "chat.disabled.expiredProfileKey", + Self::InvalidSignature => "chat.disabled.invalid_signature", + Self::OutOfOrderChat => "chat.disabled.out_of_order_chat", + Self::InvalidCommandSignature => "chat.disabled.invalid_command_signature", + } + } +} + +/// A message the chain let through: unsigned (PlayerChatMessage.unsigned) +/// or signed at a link of the sender's chain. +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub enum Unpacked { + Unsigned, + Signed { index: i32, signature: Signature }, +} + +/// A player's SignedMessageChain.Decoder: unsigned until the player sends a +/// chat session, then keyed to it. +#[derive(Clone, Debug, Default)] +pub struct Chain { + session: Option<ChatSession>, + /// The next link's index; None once the chain is broken. + next: Option<i32>, + /// The last message's time (lastTimeStamp, from Instant.EPOCH). + last_timestamp: i64, +} + +impl Chain { + /// RemoteChatSession.createMessageDecoder: a new chain from link 0. + pub fn keyed(session: ChatSession) -> Self { + Self { + session: Some(session), + next: Some(0), + last_timestamp: 0, + } + } + pub fn session(&self) -> Option<&ChatSession> { + self.session.as_ref() + } + /// Decoder.unpack for `sender`'s message. Without a session the message + /// is unsigned unless the server enforces secure chat; with one it must + /// be the next link, in order, signed by the player's key. + pub fn unpack( + &mut self, + sender: u128, + signature: Option<&Signature>, + body: &Body, + enforce: bool, + now: i64, + ) -> Result<Unpacked, DecodeError> { + let Some(session) = &self.session else { + return if enforce { + Err(DecodeError::MissingProfileKey) + } else { + Ok(Unpacked::Unsigned) + }; + }; + let signature = signature.ok_or(DecodeError::MissingProfileKey)?; + if session.profile_key.has_expired(now) { + return Err(DecodeError::ExpiredProfileKey); + } + let index = self.next.ok_or(DecodeError::ChainBroken)?; + if body.timestamp < self.last_timestamp { + self.next = None; + return Err(DecodeError::OutOfOrderChat); + } + self.last_timestamp = body.timestamp; + let payload = signed_payload(sender, session.id, index, body); + if !session + .key + .verify(SignatureHash::Sha256, &payload, signature) + { + self.next = None; + return Err(DecodeError::InvalidSignature); + } + self.next = index.checked_add(1); + Ok(Unpacked::Signed { + index, + signature: *signature, + }) + } + /// Decoder.setChainBroken (nothing for the unsigned decoder). + pub fn set_broken(&mut self) { + if self.session.is_some() { + self.next = None; + } + } +} + +/// Arrays.hashCode(byte[]). +fn java_hash(bytes: &[u8]) -> i32 { + bytes.iter().fold(1i32, |h, &b| { + h.wrapping_mul(31).wrapping_add(i32::from(b as i8)) + }) +} + +/// LastSeenMessages.computeChecksum: never 0, which means "not checked". +pub fn checksum(entries: &[Signature]) -> i8 { + let c = entries + .iter() + .fold(1i32, |c, e| c.wrapping_mul(31).wrapping_add(java_hash(e))); + match c as i8 { + 0 => 1, + b => b, + } +} + +/// LastSeenMessagesValidator: the messages sent to a player that its next +/// acknowledgement may name, each pending until it does. +#[derive(Clone, Debug)] +pub struct LastSeenValidator { + tracked: VecDeque<Option<(Signature, bool)>>, + last_pending: Option<Signature>, +} + +impl Default for LastSeenValidator { + fn default() -> Self { + Self { + tracked: std::iter::repeat_n(None, LAST_SEEN).collect(), + last_pending: None, + } + } +} + +impl LastSeenValidator { + pub fn add_pending(&mut self, signature: &Signature) { + if self.last_pending.as_ref() != Some(signature) { + self.tracked.push_back(Some((*signature, true))); + self.last_pending = Some(*signature); + } + } + pub fn tracked_count(&self) -> usize { + self.tracked.len() + } + /// applyOffset: drop the `offset` oldest messages. + pub fn apply_offset(&mut self, offset: i32) -> Result<(), String> { + let max = self.tracked.len() as i64 - LAST_SEEN as i64; + if offset >= 0 && i64::from(offset) <= max { + self.tracked.drain(..offset as usize); + Ok(()) + } else { + Err(format!( + "Advanced last seen window by {offset} messages, but expected at most {max}" + )) + } + } + /// applyUpdate: the offset, then the acknowledged messages of the + /// window (a 20-bit set, little-endian bytes), checked against the + /// client's checksum unless it sent 0. + pub fn apply_update( + &mut self, + offset: i32, + acknowledged: [u8; 3], + checksum: i8, + ) -> Result<Vec<Signature>, String> { + self.apply_offset(offset)?; + let bit = |i: usize| acknowledged[i / 8] >> (i % 8) & 1 != 0; + let length = (0..24).rev().find(|&i| bit(i)).map_or(0, |i| i + 1); + if length > LAST_SEEN { + return Err(format!( + "Last seen update contained {length} messages, but maximum window size is {LAST_SEEN}" + )); + } + let mut seen = Vec::with_capacity(LAST_SEEN); + for i in 0..LAST_SEEN { + let entry = self.tracked[i]; + if bit(i) { + let Some((s, _)) = entry else { + return Err(format!( + "Last seen update acknowledged unknown or previously ignored message at index {i}" + )); + }; + self.tracked[i] = Some((s, false)); + seen.push(s); + } else { + if let Some((_, false)) = entry { + return Err(format!( + "Last seen update ignored previously acknowledged message at index {i}" + )); + } + self.tracked[i] = None; + } + } + if checksum != 0 && checksum != self::checksum(&seen) { + return Err( + "Checksum mismatch on last seen update: the client and server must have desynced" + .to_owned(), + ); + } + Ok(seen) + } +} + +/// MessageSignatureCache: the 128 signatures a connection's client also +/// holds, so a packed signature can name one by index. +#[derive(Clone, Debug)] +pub struct SignatureCache { + entries: Vec<Option<Signature>>, +} + +impl Default for SignatureCache { + fn default() -> Self { + Self { + entries: vec![None; 128], + } + } +} + +impl SignatureCache { + /// MessageSignature.pack: the cache index, or the full signature. + pub fn pack(&self, signature: &Signature) -> (i32, Option<Vec<u8>>) { + match self + .entries + .iter() + .position(|e| e.as_ref() == Some(signature)) + { + Some(i) => (i as i32, None), + None => (-1, Some(signature.to_vec())), + } + } + /// push(body, signature): the message's last seen and its signature go + /// to the front, most recent first; what they displace moves back. + pub fn push(&mut self, last_seen: &[Signature], signature: Option<&Signature>) { + let mut queue: VecDeque<Signature> = last_seen.iter().chain(signature).copied().collect(); + let new: HashSet<Signature> = queue.iter().copied().collect(); + for slot in &mut self.entries { + let Some(next) = queue.pop_back() else { break }; + if let Some(old) = slot.replace(next) + && !new.contains(&old) + { + queue.push_front(old); + } + } + } +} + +#[cfg(test)] +mod tests { + use super::*; + + fn sig(b: u8) -> Signature { + [b; SIGNATURE_BYTES] + } + + #[test] + fn payload_layout_matches_update_signature() { + let body = Body { + content: "hé", + timestamp: 1_700_000_123_456, + salt: -2, + last_seen: &[sig(7)], + }; + let p = signed_payload(1, 2, 3, &body); + assert_eq!(&p[..4], &[0, 0, 0, 1]); + assert_eq!(&p[4..20], &1u128.to_be_bytes()); + assert_eq!(&p[20..36], &2u128.to_be_bytes()); + assert_eq!(&p[36..40], &3i32.to_be_bytes()); + assert_eq!(&p[40..48], &(-2i64).to_be_bytes()); + assert_eq!(&p[48..56], &1_700_000_123i64.to_be_bytes()); + assert_eq!(&p[56..60], &3i32.to_be_bytes()); + assert_eq!(&p[60..63], "hé".as_bytes()); + assert_eq!(&p[63..67], &1i32.to_be_bytes()); + assert_eq!(p.len(), 67 + 256); + // Instant.getEpochSecond floors. + let before = Body { + timestamp: -1, + ..body + }; + assert_eq!( + &signed_payload(1, 2, 3, &before)[48..56], + &(-1i64).to_be_bytes() + ); + } + + #[test] + fn unsigned_chain_follows_enforcement() { + let mut chain = Chain::default(); + let body = Body { + content: "hi", + timestamp: 5, + salt: 0, + last_seen: &[], + }; + assert_eq!( + chain.unpack(1, None, &body, false, 0), + Ok(Unpacked::Unsigned) + ); + assert_eq!( + chain.unpack(1, Some(&sig(1)), &body, false, 0), + Ok(Unpacked::Unsigned) + ); + assert_eq!( + chain.unpack(1, None, &body, true, 0), + Err(DecodeError::MissingProfileKey) + ); + } + + #[test] + fn checksums_follow_java_hash_codes() { + // Arrays.hashCode(new byte[]{-1}) = 31 + (-1) = 30. + assert_eq!(java_hash(&[0xff]), 30); + assert_eq!(checksum(&[]), 1); + let one = [sig(0)]; + let expected = 31i32.wrapping_add(java_hash(&sig(0))) as i8; + assert_eq!(checksum(&one), if expected == 0 { 1 } else { expected }); + } + + #[test] + fn last_seen_window() { + let mut v = LastSeenValidator::default(); + assert_eq!(v.tracked_count(), 20); + v.add_pending(&sig(1)); + v.add_pending(&sig(1)); + v.add_pending(&sig(2)); + assert_eq!(v.tracked_count(), 22); + assert!(v.apply_offset(3).is_err()); + // Slide by two: the two messages are the window's last entries. + let mut ack = [0u8; 3]; + ack[18 / 8] |= 1 << (18 % 8); + ack[19 / 8] |= 1 << (19 % 8); + let seen = v.apply_update(2, ack, checksum(&[sig(1), sig(2)])).unwrap(); + assert_eq!(seen, vec![sig(1), sig(2)]); + // Once acknowledged, a message can't be ignored. + assert!(v.apply_update(0, [0; 3], 0).is_err()); + let mut v = LastSeenValidator::default(); + v.add_pending(&sig(1)); + assert!(v.apply_update(1, [0, 0, 0x10], 0).is_err(), "bit 20"); + let mut v = LastSeenValidator::default(); + assert!(v.apply_update(0, [1, 0, 0], 0).is_err(), "unknown"); + let mut v = LastSeenValidator::default(); + v.add_pending(&sig(1)); + let mut ack = [0u8; 3]; + ack[2] |= 1 << 3; + assert!(v.apply_update(1, ack, 99).is_err(), "checksum"); + } + + #[test] + fn cache_moves_recent_signatures_first() { + let mut c = SignatureCache::default(); + assert_eq!(c.pack(&sig(1)), (-1, Some(sig(1).to_vec()))); + c.push(&[], Some(&sig(1))); + assert_eq!(c.pack(&sig(1)), (0, None)); + c.push(&[sig(1)], Some(&sig(2))); + assert_eq!(c.pack(&sig(2)), (0, None)); + assert_eq!(c.pack(&sig(1)), (1, None)); + c.push(&[], Some(&sig(3))); + assert_eq!( + [c.pack(&sig(3)).0, c.pack(&sig(2)).0, c.pack(&sig(1)).0], + [0, 1, 2] + ); + } +} diff --git a/crates/horizon-server-files/Cargo.toml b/crates/horizon-server-files/Cargo.toml index 184dadc90..2643fc726 100644 --- a/crates/horizon-server-files/Cargo.toml +++ b/crates/horizon-server-files/Cargo.toml @@ -12,6 +12,8 @@ horizon-protocol = { path = "../horizon-protocol" } horizon-world = { path = "../horizon-world" } log = "0.4" # Online mode: finding accounts by name (the services' profiles endpoint). +# Secure chat: the services' public keys arrive base64-encoded. +base64 = "0.22" ureq = { version = "2", default-features = false, features = ["tls"] } [lints] diff --git a/crates/horizon-server-files/src/profiles.rs b/crates/horizon-server-files/src/profiles.rs index a093fbfb1..3e16e2a41 100644 --- a/crates/horizon-server-files/src/profiles.rs +++ b/crates/horizon-server-files/src/profiles.rs @@ -6,6 +6,7 @@ use crate::{ json::{self, Json}, user_lists::NameAndId, }; +use horizon_protocol::rsa::RsaPublicKey; use std::time::Duration; /// Mojang's services discovery document. @@ -51,6 +52,57 @@ pub fn find_by_name(discovery: &str, name: &str) -> Option<NameAndId> { found(&agent.get(&url).call().ok()?.into_string().ok()?, name) } +/// MinecraftServicesKeyInfo.get: the services' public keys from the +/// discovery document's `authentication` / `getPublicKeys` endpoint. The +/// profile-key keys (`playerCertificateKeys`, ServicesKeyType.PROFILE_KEY) +/// sign the players' chat keys; secure chat checks them. The error is the +/// line vanilla logs, after which it has no keys. +pub fn fetch_profile_key_keys(discovery: &str) -> Result<Vec<RsaPublicKey>, &'static str> { + const FAILED: &str = "Failed to request Minecraft Services public key"; + let agent = ureq::AgentBuilder::new() + .timeout(Duration::from_secs(15)) + .user_agent(concat!("Horizon/", env!("CARGO_PKG_VERSION"))) + .build(); + let get = |url: &str| agent.get(url).call().ok()?.into_string().ok(); + let doc = get(discovery) + .and_then(|d| json::parse(&d, true).ok()) + .ok_or(FAILED)?; + let url = endpoint(&doc, "authentication", "getPublicKeys").ok_or(FAILED)?; + profile_key_keys(&get(&url).ok_or(FAILED)?) +} + +/// The key set answer: `{"profilePropertyKeys": [...], "playerCertificateKeys": +/// [...]}`, each `{"publicKey": base64 X.509}`. One bad key makes the whole +/// answer malformed (parseList throws). +pub fn profile_key_keys(answer: &str) -> Result<Vec<RsaPublicKey>, &'static str> { + use base64::Engine; + const MALFORMED: &str = "Received malformed Minecraft Services public key data"; + let doc = json::parse(answer, true).map_err(|_| MALFORMED)?; + let list = |name: &str| -> Result<Vec<RsaPublicKey>, &'static str> { + let Some(entries) = doc.get(name) else { + return Ok(Vec::new()); + }; + let Json::Array(entries) = entries else { + return Err(MALFORMED); + }; + entries + .iter() + .map(|e| { + let text = e + .get("publicKey") + .and_then(Json::as_string) + .ok_or(MALFORMED)?; + let der = base64::engine::general_purpose::STANDARD + .decode(text) + .map_err(|_| MALFORMED)?; + RsaPublicKey::from_der(&der).map_err(|_| MALFORMED) + }) + .collect() + }; + list("profilePropertyKeys")?; + list("playerCertificateKeys") +} + /// MinecraftServicesDiscoveryService.getUrl(service, endpoint). fn endpoint(doc: &Json, service: &str, name: &str) -> Option<String> { doc.get("discovery")? @@ -97,4 +149,20 @@ mod tests { assert_eq!(found("{}", "Notch"), None); assert_eq!(found("", "Notch"), None); } + + #[test] + fn services_key_sets() { + // The 1024-bit test key of horizon-protocol's RSA tests, base64. + let key = "MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCrAmB0+SRQqPcm84lbsRF2yo8GXzEAzUFDusT302dO3P+VtBoFJdI2WlScEG7GaFiBs5IXdCD9Mf9cFE/xG6JDEedRzSxrXRgXtq9mhqQ8ldYSQ2EwBeaUW2CTzZUiPOxeiFaCbanS7hsyM2KsHOvqs2WcvEUxmptUDdqBakeY/wIDAQAB"; + let answer = format!( + r#"{{"profilePropertyKeys":[{{"publicKey":"{key}"}}],"playerCertificateKeys":[{{"publicKey":"{key}"}},{{"publicKey":"{key}"}}]}}"# + ); + let keys = profile_key_keys(&answer).unwrap(); + assert_eq!(keys.len(), 2); + assert_eq!(keys[0].size(), 128); + assert_eq!(profile_key_keys("{}").unwrap().len(), 0); + let bad = r#"{"profilePropertyKeys":[{"publicKey":"AAAA"}],"playerCertificateKeys":[]}"#; + assert!(profile_key_keys(bad).is_err()); + assert!(profile_key_keys("not json").is_err()); + } } diff --git a/docs/hosting.md b/docs/hosting.md index bb5d6db4d..346eb7c8b 100644 --- a/docs/hosting.md +++ b/docs/hosting.md @@ -20,8 +20,9 @@ plan are in [docs/server.md](https://github.com/ludovic111/horizon/blob/main/doc Until then Horizon players can join offline servers only (`online_mode = false`). An offline server never checks accounts: anyone who reaches it can join under any name. Keep it on your LAN or a tailnet (Tailscale, ZeroTier), or share it only with friends you trust. -- **No secure chat.** Chat isn't signed, and `enforce-secure-profile` has no effect. Vanilla clients show - chat from the server as not secure. +- **Secure chat** works as on vanilla's server: in online mode, vanilla clients sign their chat, and with + `enforce-secure-profile=true` (the default) unsigned chat is refused. On an offline server, or for a player + without a chat session (Horizon's own client today), chat stays unsigned and shows as not secure. - **Nether and End:** each player travels on their own through portals, and operators with `execute in <dimension> run tp`. The players in the level they leave stop seeing them, and the ones in the level they arrive in start to, as on vanilla (checked against vanilla with two players, by command and through an End diff --git a/docs/server.md b/docs/server.md index 30b81f64a..941a4341b 100644 --- a/docs/server.md +++ b/docs/server.md @@ -82,7 +82,8 @@ not tick cost, so it is in scope here (see section 9). | Area | Status | |---|---| -| `online-mode=true` | **Works** (ServerLoginPacketListenerImpl): a 1024-bit RSA key pair at start ("Generating keypair"), the encryption request, the shared secret and challenge, AES/CFB8, and the session service's `hasJoined` check (with the address when `prevent-proxy-connections` is on), with vanilla's log lines and messages. `test_online_mode_parity.py` runs the same logins against vanilla's server and Horizon's with a mock session service. Not yet: secure chat (chat is unsigned, as on a server that doesn't enforce it). | +| `online-mode=true` | **Works** (ServerLoginPacketListenerImpl): a 1024-bit RSA key pair at start ("Generating keypair"), the encryption request, the shared secret and challenge, AES/CFB8, and the session service's `hasJoined` check (with the address when `prevent-proxy-connections` is on), with vanilla's log lines and messages. `test_online_mode_parity.py` runs the same logins against vanilla's server and Horizon's with a mock session service. | +| Secure chat | **Works** (`SignedMessageChain`, `LastSeenMessagesValidator`, `MessageSignatureCache`): the chat session update and its profile key, checked against the services' `playerCertificateKeys`; signed chat, `say`, `me` and `msg`, relayed with their signatures and last-seen lists; `enforce-secure-profile` (with `online-mode`) refuses unsigned chat; and vanilla's log lines (`[Not Secure]`, the decoder's warnings, the kicks). Offline servers and players without a chat session chat unsigned, as on vanilla. `test_secure_chat_parity.py` runs the same signed and unsigned players against vanilla's server and Horizon's, with test keys and a mock services server. | | Nether and End | **Players can't change dimension.** The engine keeps one dimension loaded (`Game::enter_dimension` moves only the local single-player player), and the hub serves one `dimension` to everyone. | | Refused logins | Logged as vanilla does: `Disconnecting <name> (/address): <reason>`, then `<name> (/address) lost connection: <reason>`, and the session errors (`Username '<name>' tried to join with an invalid session`, `Couldn't verify username because servers are unavailable`). | | Gameplay for remote players | The LAN guest leftovers apply: an item used on a block is used twice, the recipe book doesn't work, status effects don't apply to guests, arrows don't record their owner, team friendly fire is ignored (#484). Block desync and short freezes are reported on a same-machine server (#500). | @@ -507,7 +508,6 @@ machine, then published in `benchmarks/`; and item 5. **Out (next):** -- secure chat on the server (online mode itself works); - the Nether and End for remote players; - the headless engine and its RAM win; - a server-only prepare without a JDK; diff --git a/mods/horizon/src/test/java/dev/horizonlab/parity/SecureChatClient.java b/mods/horizon/src/test/java/dev/horizonlab/parity/SecureChatClient.java new file mode 100644 index 000000000..4d08dafd2 --- /dev/null +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/SecureChatClient.java @@ -0,0 +1,625 @@ +package dev.horizonlab.parity; + +import com.google.gson.JsonArray; +import com.google.gson.JsonObject; +import com.mojang.serialization.JsonOps; +import io.netty.buffer.ByteBuf; +import io.netty.buffer.Unpooled; +import java.io.ByteArrayInputStream; +import java.io.DataInputStream; +import java.io.EOFException; +import java.io.InputStream; +import java.io.OutputStream; +import java.io.PrintWriter; +import java.math.BigInteger; +import java.net.HttpURLConnection; +import java.net.InetSocketAddress; +import java.net.Socket; +import java.net.URI; +import java.nio.ByteBuffer; +import java.nio.charset.StandardCharsets; +import java.nio.file.Files; +import java.nio.file.Path; +import java.security.KeyFactory; +import java.security.KeyPair; +import java.security.KeyPairGenerator; +import java.security.PrivateKey; +import java.security.spec.PKCS8EncodedKeySpec; +import java.time.Instant; +import java.util.ArrayList; +import java.util.Base64; +import java.util.HashMap; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.Optional; +import java.util.UUID; +import java.util.concurrent.BlockingQueue; +import java.util.concurrent.LinkedBlockingQueue; +import java.util.concurrent.TimeUnit; +import java.util.zip.Deflater; +import java.util.zip.Inflater; +import javax.crypto.Cipher; +import javax.crypto.CipherInputStream; +import javax.crypto.CipherOutputStream; +import javax.crypto.SecretKey; +import net.minecraft.SharedConstants; +import net.minecraft.commands.arguments.ArgumentSignatures; +import net.minecraft.core.UUIDUtil; +import net.minecraft.network.RegistryFriendlyByteBuf; +import net.minecraft.network.ProtocolInfo; +import net.minecraft.network.chat.Component; +import net.minecraft.network.chat.ComponentSerialization; +import net.minecraft.network.chat.LastSeenMessages; +import net.minecraft.network.chat.LastSeenMessagesTracker; +import net.minecraft.network.chat.LocalChatSession; +import net.minecraft.network.chat.MessageSignature; +import net.minecraft.network.chat.MessageSignatureCache; +import net.minecraft.network.chat.PlayerChatMessage; +import net.minecraft.network.chat.RemoteChatSession; +import net.minecraft.network.chat.SignedMessageBody; +import net.minecraft.network.chat.SignedMessageChain; +import net.minecraft.network.chat.SignedMessageLink; +import net.minecraft.network.chat.SignedMessageValidator; +import net.minecraft.network.protocol.Packet; +import net.minecraft.network.protocol.common.ClientboundDisconnectPacket; +import net.minecraft.network.protocol.common.ClientboundKeepAlivePacket; +import net.minecraft.network.protocol.common.ClientboundPingPacket; +import net.minecraft.network.protocol.common.ServerboundClientInformationPacket; +import net.minecraft.network.protocol.common.ServerboundKeepAlivePacket; +import net.minecraft.network.protocol.common.ServerboundPongPacket; +import net.minecraft.network.protocol.configuration.ClientboundFinishConfigurationPacket; +import net.minecraft.network.protocol.configuration.ClientboundSelectKnownPacks; +import net.minecraft.network.protocol.configuration.ConfigurationProtocols; +import net.minecraft.network.protocol.configuration.ServerboundFinishConfigurationPacket; +import net.minecraft.network.protocol.configuration.ServerboundSelectKnownPacks; +import net.minecraft.network.protocol.game.ClientboundChunkBatchFinishedPacket; +import net.minecraft.network.protocol.game.ClientboundDisguisedChatPacket; +import net.minecraft.network.protocol.game.ClientboundLoginPacket; +import net.minecraft.network.protocol.game.ClientboundPlayerChatPacket; +import net.minecraft.network.protocol.game.ClientboundPlayerInfoUpdatePacket; +import net.minecraft.network.protocol.game.ClientboundPlayerPositionPacket; +import net.minecraft.network.protocol.game.ClientboundSystemChatPacket; +import net.minecraft.network.protocol.game.GameProtocols; +import net.minecraft.network.protocol.game.ServerboundAcceptTeleportationPacket; +import net.minecraft.network.protocol.game.ServerboundChatAckPacket; +import net.minecraft.network.protocol.game.ServerboundChatCommandPacket; +import net.minecraft.network.protocol.game.ServerboundChatCommandSignedPacket; +import net.minecraft.network.protocol.game.ServerboundChatPacket; +import net.minecraft.network.protocol.game.ServerboundChatSessionUpdatePacket; +import net.minecraft.network.protocol.game.ServerboundChunkBatchReceivedPacket; +import net.minecraft.network.protocol.game.ServerboundPlayerLoadedPacket; +import net.minecraft.network.protocol.handshake.ClientIntent; +import net.minecraft.network.protocol.handshake.ClientIntentionPacket; +import net.minecraft.network.protocol.handshake.HandshakeProtocols; +import net.minecraft.network.protocol.login.ClientboundHelloPacket; +import net.minecraft.network.protocol.login.ClientboundLoginCompressionPacket; +import net.minecraft.network.protocol.login.ClientboundLoginDisconnectPacket; +import net.minecraft.network.protocol.login.ClientboundLoginFinishedPacket; +import net.minecraft.network.protocol.login.LoginProtocols; +import net.minecraft.network.protocol.login.ServerboundHelloPacket; +import net.minecraft.network.protocol.login.ServerboundKeyPacket; +import net.minecraft.network.protocol.login.ServerboundLoginAcknowledgedPacket; +import net.minecraft.server.level.ClientInformation; +import net.minecraft.util.Crypt; +import net.minecraft.util.Signer; +import net.minecraft.world.entity.player.ProfileKeyPair; +import net.minecraft.world.entity.player.ProfilePublicKey; + +/** + * Secure chat seen by vanilla-codec clients: several players on one server, + * signing their chat with profile keys that a mock of the Minecraft services + * signed (the harness serves its public key as the services' key set). + * + * <p>{@code keys <dir>} writes the mock services' key pair: the private key + * (PKCS#8) and {@code publickeys.json} as the services answer it. With a + * host, a port, the private key, an output file and a scenario, it plays the + * scenario. Each client signs and acknowledges exactly as + * ClientPacketListener does (LocalChatSession, SignedMessageChain's encoder, + * LastSeenMessagesTracker, MessageSignatureCache), and checks every player + * chat it receives with SignedMessageValidator against the sender's session + * from the player list. The transcript holds what each player received and + * whether its signature checked out; keys, salts, times and signatures + * differ between runs and are left out. + */ +public final class SecureChatClient { + private static final List<String> LINES = new ArrayList<>(); + private static PrivateKey services; + private static String sessionUrl; + + public static void main(String[] args) throws Exception { + ParityData.init(); + if (args[0].equals("keys")) { + keys(Path.of(args[1])); + return; + } + String host = args[0]; + int port = Integer.parseInt(args[1]); + services = KeyFactory.getInstance("RSA").generatePrivate(new PKCS8EncodedKeySpec(Files.readAllBytes(Path.of(args[2])))); + Path output = Path.of(args[3]); + String scenario = args[4]; + sessionUrl = args.length > 5 ? args[5] : null; + try { + if (scenario.equals("offline")) offline(host, port); + else online(host, port); + } catch (Exception e) { + StringBuilder line = new StringBuilder("error " + e); + for (Throwable c = e.getCause(); c != null; c = c.getCause()) line.append(" / caused by ").append(c); + LINES.add(line.toString()); + } + try (PrintWriter w = new PrintWriter(Files.newBufferedWriter(output, StandardCharsets.UTF_8))) { + for (String line : LINES) w.println(line); + } + System.exit(0); + } + + private static void keys(Path dir) throws Exception { + KeyPairGenerator generator = KeyPairGenerator.getInstance("RSA"); + generator.initialize(2048); + KeyPair pair = generator.generateKeyPair(); + Files.write(dir.resolve("services-private.der"), pair.getPrivate().getEncoded()); + JsonObject key = new JsonObject(); + key.addProperty("publicKey", Base64.getEncoder().encodeToString(pair.getPublic().getEncoded())); + JsonArray list = new JsonArray(); + list.add(key); + JsonObject set = new JsonObject(); + set.add("profilePropertyKeys", list); + set.add("playerCertificateKeys", list); + Files.writeString(dir.resolve("publickeys.json"), set.toString()); + } + + // ---- scenarios ---------------------------------------------------- + + /** Offline mode: the server checks chat sessions but enforces nothing. */ + private static void offline(String host, int port) throws Exception { + Client alice = Client.join(host, port, "Alice", true, null); + Client bob = Client.join(host, port, "Bob", true, null); + Client carol = Client.join(host, port, "Carol", false, null); + List<Client> all = List.of(alice, bob, carol); + settle(all, "joined"); + alice.chat("hello, signed"); + settle(all, "alice chats"); + bob.chat("seen it"); + settle(all, "bob chats with alice's message seen"); + carol.chat("no key here"); + settle(all, "carol chats unsigned"); + alice.signedCommand("say signed announcement", "message", "signed announcement"); + settle(all, "alice says"); + alice.signedCommand("me waves", "action", "waves"); + settle(all, "alice emotes"); + alice.signedCommand("msg Bob just between us", "message", "just between us"); + settle(all, "alice whispers to bob"); + carol.signedCommand("me shrugs", null, null); + settle(all, "carol emotes, unsigned arguments"); + carol.command("say plain announcement"); + settle(all, "carol says through the unsigned packet"); + bob.signedCommand("say mismatch", "nothing", "mismatch"); + settle(all, "bob signs the wrong argument"); + bob.chat("after the mismatch"); + settle(all, "bob's chain after the mismatch"); + alice.tamperedChat("forged"); + settle(all, "alice's signature fails"); + alice.chat("after the forgery"); + settle(all, "alice's chain is broken"); + bob.send(new ServerboundChatAckPacket(50)); + settle(all, "bob acknowledges too much"); + for (Client c : all) c.close(); + } + + /** Online mode with enforce-secure-profile: unsigned chat is refused. */ + private static void online(String host, int port) throws Exception { + Client alice = Client.join(host, port, "Alice", true, null); + Client carol = Client.join(host, port, "Carol", false, null); + List<Client> all = List.of(alice, carol); + settle(all, "joined"); + alice.chat("signed and enforced"); + settle(all, "alice chats"); + carol.chat("unsigned under enforcement"); + settle(all, "carol chats without a key"); + carol.command("me tries the unsigned packet"); + settle(all, "carol's unsigned command"); + carol.signedCommand("me tries without signatures", null, null); + settle(all, "carol's command without signatures"); + // A key the services signed for another player. + Client mallory = Client.join(host, port, "Mallory", true, UUID.nameUUIDFromBytes("someone else".getBytes())); + settle(List.of(alice, carol, mallory), "mallory's borrowed key"); + for (Client c : all) c.close(); + mallory.close(); + } + + /** Lets the server answer, then records what each player received, in player order. */ + private static void settle(List<Client> clients, String step) throws Exception { + Thread.sleep(1500); + LINES.add("step " + step); + for (Client c : clients) c.drain(); + } + + private static String json(Component c) { + return ComponentSerialization.CODEC.encodeStart(ParityData.access.createSerializationContext(JsonOps.INSTANCE), c).getOrThrow().toString(); + } + + /** A player: one connection, its chat session and what its client tracks. */ + private static final class Client { + final String name; + UUID id; + Socket socket; + DataInputStream in; + OutputStream out; + int threshold = -1; + ProtocolInfo<?> inbound; + ProtocolInfo<?> outbound; + final BlockingQueue<Packet<?>> queue = new LinkedBlockingQueue<>(); + volatile boolean closed; + LocalChatSession session; + SignedMessageChain.Encoder encoder = SignedMessageChain.Encoder.UNSIGNED; + final LastSeenMessagesTracker lastSeen = new LastSeenMessagesTracker(20); + final MessageSignatureCache cache = MessageSignatureCache.createDefault(); + int nextChatIndex; + final Map<UUID, String> names = new LinkedHashMap<>(); + final Map<UUID, SignedMessageValidator> validators = new HashMap<>(); + boolean enforced; + boolean loaded; + net.minecraft.world.entity.PositionMoveRotation position = new net.minecraft.world.entity.PositionMoveRotation( + net.minecraft.world.phys.Vec3.ZERO, net.minecraft.world.phys.Vec3.ZERO, 0, 0); + + Client(String name) { + this.name = name; + } + + void record(String line) { + LINES.add(name + " " + line); + } + + static Client join(String host, int port, String name, boolean signs, UUID keyOwner) throws Exception { + Client c = new Client(name); + c.connect(host, port, signs, keyOwner); + return c; + } + + void connect(String host, int port, boolean signs, UUID keyOwner) throws Exception { + socket = new Socket(); + socket.connect(new InetSocketAddress(host, port), 10_000); + socket.setSoTimeout(30_000); + socket.setTcpNoDelay(true); + in = new DataInputStream(socket.getInputStream()); + out = socket.getOutputStream(); + outbound = HandshakeProtocols.SERVERBOUND; + send(new ClientIntentionPacket(SharedConstants.getProtocolVersion(), host, port, ClientIntent.LOGIN)); + outbound = LoginProtocols.SERVERBOUND; + inbound = LoginProtocols.CLIENTBOUND; + send(new ServerboundHelloPacket(name, UUIDUtil.createOfflinePlayerUUID(name))); + while (true) { + Packet<?> p = read(); + if (p instanceof ClientboundHelloPacket hello) { + // ClientHandshakePacketListenerImpl.handleHello: join through the session service. + SecretKey secret = Crypt.generateSecretKey(); + String hash = new BigInteger(Crypt.digestData(hello.getServerId(), hello.getPublicKey(), secret)).toString(16); + joinSession(hash); + send(new ServerboundKeyPacket(secret, hello.getPublicKey(), hello.getChallenge())); + in = new DataInputStream(new CipherInputStream(socket.getInputStream(), Crypt.getCipher(Cipher.DECRYPT_MODE, secret))); + out = new CipherOutputStream(socket.getOutputStream(), Crypt.getCipher(Cipher.ENCRYPT_MODE, secret)); + } else if (p instanceof ClientboundLoginCompressionPacket compression) { + threshold = compression.getCompressionThreshold(); + } else if (p instanceof ClientboundLoginFinishedPacket finished) { + id = finished.gameProfile().id(); + record("logged in"); + send(ServerboundLoginAcknowledgedPacket.INSTANCE); + break; + } else if (p instanceof ClientboundLoginDisconnectPacket d) { + record("refused " + json(d.reason())); + closed = true; + return; + } + } + outbound = ConfigurationProtocols.SERVERBOUND; + inbound = ConfigurationProtocols.CLIENTBOUND; + send(new ServerboundClientInformationPacket(ClientInformation.createDefault())); + while (true) { + Packet<?> p = read(); + if (p instanceof ClientboundSelectKnownPacks packs) { + send(new ServerboundSelectKnownPacks(packs.knownPacks())); + } else if (p instanceof ClientboundKeepAlivePacket k) { + send(new ServerboundKeepAlivePacket(k.getId())); + } else if (p instanceof ClientboundPingPacket ping) { + send(new ServerboundPongPacket(ping.getId())); + } else if (p instanceof ClientboundFinishConfigurationPacket) { + send(ServerboundFinishConfigurationPacket.INSTANCE); + break; + } else if (p instanceof ClientboundDisconnectPacket d) { + record("disconnected " + json(d.reason())); + closed = true; + return; + } + } + GameProtocols.Context context = new GameProtocols.Context() { + @Override + public boolean hasInfiniteMaterials() { + return false; + } + + @Override + public boolean canUseCommandBlocks() { + return false; + } + }; + outbound = GameProtocols.SERVERBOUND_TEMPLATE.bind(RegistryFriendlyByteBuf.decorator(ParityData.access), context); + inbound = GameProtocols.CLIENTBOUND_TEMPLATE.bind(RegistryFriendlyByteBuf.decorator(ParityData.access)); + // ClientPacketListener.handleLogin: the session goes out once the + // login packet is in (prepareKeyPair, setKeyPair). + while (true) { + Packet<?> p = read(); + if (p instanceof ClientboundLoginPacket login) { + enforced = login.enforcesSecureChat(); + record("login online " + login.onlineMode() + " enforces " + login.enforcesSecureChat()); + if (signs) startSession(keyOwner == null ? id : keyOwner); + break; + } + } + Thread reader = new Thread(() -> { + try { + while (!closed) { + Packet<?> p = read(); + queue.put(p); + // Nothing follows a disconnect but the closed socket. + if (p instanceof ClientboundDisconnectPacket) return; + } + } catch (Exception e) { + if (!closed) queue.add(new ClientboundDisconnectPacket(Component.literal("connection lost: " + e))); + } + }, name + " reader"); + reader.setDaemon(true); + reader.start(); + } + + /** The session service's join, as the launcher's account would. */ + void joinSession(String serverHash) throws Exception { + HttpURLConnection http = (HttpURLConnection) URI.create(sessionUrl + "/session/minecraft/join").toURL().openConnection(); + http.setRequestMethod("POST"); + http.setDoOutput(true); + http.setRequestProperty("Content-Type", "application/json"); + JsonObject body = new JsonObject(); + body.addProperty("accessToken", "mock-token"); + body.addProperty("selectedProfile", name); + body.addProperty("serverId", serverHash); + http.getOutputStream().write(body.toString().getBytes(StandardCharsets.UTF_8)); + http.getResponseCode(); + http.disconnect(); + } + + /** A profile key pair the mock services signed for {@code owner}, and its session. */ + void startSession(UUID owner) throws Exception { + KeyPairGenerator generator = KeyPairGenerator.getInstance("RSA"); + generator.initialize(2048); + KeyPair pair = generator.generateKeyPair(); + Instant expires = Instant.now().plusSeconds(3600).truncatedTo(java.time.temporal.ChronoUnit.MILLIS); + byte[] key = pair.getPublic().getEncoded(); + byte[] payload = ByteBuffer.allocate(24 + key.length).putLong(owner.getMostSignificantBits()) + .putLong(owner.getLeastSignificantBits()).putLong(expires.toEpochMilli()).put(key).array(); + byte[] signature = Signer.from(services, "SHA1withRSA").sign(payload); + ProfilePublicKey publicKey = new ProfilePublicKey(new ProfilePublicKey.Data(expires, pair.getPublic(), signature)); + session = LocalChatSession.create(new ProfileKeyPair(pair.getPrivate(), publicKey, expires)); + encoder = session.createMessageEncoder(id); + send(new ServerboundChatSessionUpdatePacket(session.asRemote().asData())); + } + + /** ClientPacketListener.sendChat. */ + void chat(String content) throws Exception { + Instant now = Instant.now(); + long salt = Crypt.SaltSupplier.getLong(); + LastSeenMessagesTracker.Update update = lastSeen.generateAndApplyUpdate(); + MessageSignature signature = encoder.pack(new SignedMessageBody(content, now, salt, update.lastSeen())); + send(new ServerboundChatPacket(content, now, salt, Optional.ofNullable(signature), update.update())); + } + + /** A chat whose signature doesn't match its text. */ + void tamperedChat(String content) throws Exception { + Instant now = Instant.now(); + long salt = Crypt.SaltSupplier.getLong(); + LastSeenMessagesTracker.Update update = lastSeen.generateAndApplyUpdate(); + MessageSignature signature = encoder.pack(new SignedMessageBody(content + "!", now, salt, update.lastSeen())); + send(new ServerboundChatPacket(content, now, salt, Optional.ofNullable(signature), update.update())); + } + + /** ClientPacketListener.sendCommand for a command with one message argument (none: no signatures). */ + void signedCommand(String command, String argument, String value) throws Exception { + Instant now = Instant.now(); + long salt = Crypt.SaltSupplier.getLong(); + LastSeenMessagesTracker.Update update = lastSeen.generateAndApplyUpdate(); + List<ArgumentSignatures.Entry> entries = new ArrayList<>(); + if (argument != null) { + MessageSignature signature = encoder.pack(new SignedMessageBody(value, now, salt, update.lastSeen())); + if (signature != null) entries.add(new ArgumentSignatures.Entry(argument, signature)); + } + send(new ServerboundChatCommandSignedPacket(command, now, salt, new ArgumentSignatures(entries), update.update())); + } + + void command(String command) throws Exception { + send(new ServerboundChatCommandPacket(command)); + } + + /** Handles and records what arrived. */ + void drain() throws Exception { + Packet<?> p; + while ((p = queue.poll(50, TimeUnit.MILLISECONDS)) != null) handle(p); + } + + void handle(Packet<?> packet) throws Exception { + if (packet instanceof ClientboundKeepAlivePacket k) { + send(new ServerboundKeepAlivePacket(k.getId())); + } else if (packet instanceof ClientboundPingPacket ping) { + send(new ServerboundPongPacket(ping.getId())); + } else if (packet instanceof ClientboundPlayerPositionPacket pos) { + position = net.minecraft.world.entity.PositionMoveRotation.calculateAbsolute(position, pos.change(), pos.relatives()); + send(new ServerboundAcceptTeleportationPacket(pos.id(), position.position().x, position.position().y, + position.position().z, position.yRot(), position.xRot())); + if (!loaded) { + send(new ServerboundPlayerLoadedPacket()); + loaded = true; + } + } else if (packet instanceof ClientboundChunkBatchFinishedPacket) { + send(new ServerboundChunkBatchReceivedPacket(64.0F)); + } else if (packet instanceof ClientboundPlayerInfoUpdatePacket info) { + for (ClientboundPlayerInfoUpdatePacket.Entry e : info.entries()) { + if (info.actions().contains(ClientboundPlayerInfoUpdatePacket.Action.ADD_PLAYER)) { + names.put(e.profileId(), e.profile().name()); + } + if (info.actions().contains(ClientboundPlayerInfoUpdatePacket.Action.INITIALIZE_CHAT)) { + RemoteChatSession.Data data = e.chatSession(); + String who = names.getOrDefault(e.profileId(), "?"); + if (data != null) { + RemoteChatSession remote = new RemoteChatSession(data.sessionId(), new ProfilePublicKey(data.profilePublicKey())); + validators.put(e.profileId(), remote.createMessageValidator(ProfilePublicKey.EXPIRY_GRACE_PERIOD)); + sessions.put(e.profileId(), data.sessionId()); + record("session of " + who); + } else if (!info.actions().contains(ClientboundPlayerInfoUpdatePacket.Action.ADD_PLAYER)) { + record("session cleared for " + who); + } + } + } + } else if (packet instanceof ClientboundPlayerChatPacket chat) { + playerChat(chat); + } else if (packet instanceof ClientboundDisguisedChatPacket d) { + record("disguised " + d.chatType().chatType().getRegisteredName() + " " + json(d.chatType().name()) + " " + + d.chatType().targetName().map(SecureChatClient::json) + " " + json(d.message())); + } else if (packet instanceof ClientboundSystemChatPacket s) { + record("system " + json(s.content())); + } else if (packet instanceof ClientboundDisconnectPacket d) { + record("disconnected " + json(d.reason())); + closed = true; + } + } + + /** ClientPacketListener.handlePlayerChat, then markMessageAsProcessed. */ + void playerChat(ClientboundPlayerChatPacket p) { + int expected = nextChatIndex++; + String sender = names.getOrDefault(p.sender(), p.sender().toString()); + StringBuilder lastSeenPacked = new StringBuilder(); + for (MessageSignature.Packed packed : p.body().lastSeen().entries()) { + lastSeenPacked.append(packed.fullSignature() != null ? "full" : "cached:" + packed.id()).append(','); + } + Optional<SignedMessageBody> body = p.body().unpack(cache); + if (p.globalIndex() != expected || body.isEmpty()) { + record("chat out of order or unknown signature: index " + p.globalIndex() + " expected " + expected); + return; + } + MessageSignature signature = p.signature().orElse(null); + cache.push(body.get(), signature); + SignedMessageValidator validator = validators.get(p.sender()); + String verdict; + if (validator != null) { + PlayerChatMessage message = new PlayerChatMessage( + new SignedMessageLink(p.index(), p.sender(), sessionId(p.sender())), signature, body.get(), + p.unsignedContent().orElse(null), p.filterMask()); + verdict = validator.updateAndValidate(message) != null ? "verified" : "rejected"; + } else { + verdict = signature == null ? (enforced ? "unsigned-rejected" : "unsigned") : "no-session"; + } + record("chat #" + p.globalIndex() + " from " + sender + " link " + p.index() + " " + verdict + " '" + body.get().content() + + "' seen [" + lastSeenPacked + "] " + body.get().lastSeen().entries().size() + " unsigned " + + p.unsignedContent().map(SecureChatClient::json) + " " + p.chatType().chatType().getRegisteredName() + " " + + json(p.chatType().name()) + " " + p.chatType().targetName().map(SecureChatClient::json)); + if (signature != null) lastSeen.addPending(signature, true); + } + + private final Map<UUID, UUID> sessions = new HashMap<>(); + + UUID sessionId(UUID sender) { + return sessions.getOrDefault(sender, new UUID(0, 0)); + } + + // ---- framing ------------------------------------------------------ + + synchronized void send(Packet<?> packet) throws Exception { + ByteBuf body = Unpooled.buffer(); + encode(body, packet); + byte[] raw = new byte[body.readableBytes()]; + body.readBytes(raw); + ByteBuf frame = Unpooled.buffer(); + if (threshold >= 0) { + ByteBuf inner = Unpooled.buffer(); + if (raw.length >= threshold) { + writeVarInt(inner, raw.length); + Deflater d = new Deflater(); + d.setInput(raw); + d.finish(); + byte[] tmp = new byte[raw.length + 64]; + while (!d.finished()) inner.writeBytes(tmp, 0, d.deflate(tmp)); + d.end(); + } else { + writeVarInt(inner, 0); + inner.writeBytes(raw); + } + writeVarInt(frame, inner.readableBytes()); + frame.writeBytes(inner); + } else { + writeVarInt(frame, raw.length); + frame.writeBytes(raw); + } + byte[] bytes = new byte[frame.readableBytes()]; + frame.readBytes(bytes); + // A server that disconnected the player may close before this + // write: what it sent last is the disconnect, which the reader + // records, not the broken pipe. + if (broken) return; + try { + out.write(bytes); + out.flush(); + } catch (java.io.IOException e) { + broken = true; + } + } + + private boolean broken; + + @SuppressWarnings({"unchecked", "rawtypes"}) + private void encode(ByteBuf body, Packet<?> packet) { + ((ProtocolInfo) outbound).codec().encode(body, packet); + } + + Packet<?> read() throws Exception { + int length = readVarInt(in); + byte[] frame = new byte[length]; + in.readFully(frame); + byte[] raw = frame; + if (threshold >= 0) { + DataInputStream f = new DataInputStream(new ByteArrayInputStream(frame)); + int dataLength = readVarInt(f); + byte[] rest = f.readAllBytes(); + if (dataLength == 0) { + raw = rest; + } else { + Inflater inflater = new Inflater(); + inflater.setInput(rest); + raw = new byte[dataLength]; + inflater.inflate(raw); + inflater.end(); + } + } + return inbound.codec().decode(Unpooled.wrappedBuffer(raw)); + } + + void close() throws Exception { + closed = true; + socket.close(); + } + } + + private static int readVarInt(InputStream in) throws Exception { + int value = 0; + for (int i = 0; i < 5; i++) { + int b = in.read(); + if (b < 0) throw new EOFException(); + value |= (b & 0x7F) << (7 * i); + if ((b & 0x80) == 0) return value; + } + throw new IllegalStateException("VarInt too big"); + } + + private static void writeVarInt(ByteBuf buf, int value) { + while ((value & ~0x7F) != 0) { + buf.writeByte((value & 0x7F) | 0x80); + value >>>= 7; + } + buf.writeByte(value); + } +} diff --git a/tools/test_secure_chat_parity.py b/tools/test_secure_chat_parity.py new file mode 100644 index 000000000..13bf494dd --- /dev/null +++ b/tools/test_secure_chat_parity.py @@ -0,0 +1,317 @@ +#!/usr/bin/env python3 +"""Secure chat on vanilla's dedicated server and Horizon's, with no real account. + +A mock of the Minecraft services stands in for Mojang's: its key set (the +`authentication` / `getPublicKeys` endpoint) holds a key pair the harness +makes, so the profile keys it signs are as good as Mojang's to both servers. +Vanilla finds the mock through authlib's `-Dminecraft.api.discovery.host`, +Horizon through `HORIZON_API_DISCOVERY`. SecureChatClient (vanilla's own +codecs and chat classes) plays several players at once: each signs its chat +with a profile key the mock signed, acknowledges what it saw, and checks the +signature of every chat it receives against the sender's session from the +player list, as vanilla's client does. + +Two servers, each run on vanilla then on Horizon: +- offline mode (enforce-secure-profile is then off): signed chat with the + last-seen window and the signature cache, unsigned chat beside it, /say, + /me and /msg with signed and unsigned arguments, a signed argument under + the wrong name, a forged signature and the broken chain after it, and an + acknowledgement past the window; +- online mode with enforce-secure-profile: the status and the login packet + say so, unsigned chat and unsigned commands with a message are refused, and + a key signed for another player is refused. + +Compared: every player's transcript, the status' `enforcesSecureChat`, and +the servers' log lines about chat. +""" +import hashlib +import json +import os +from pathlib import Path +import platform +import re +import shutil +import socket +import subprocess +import sys +import time +import threading +import urllib.parse +from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer + +try: + from . import lab, oracle_harness as oh, test_rust_parity as base + from .test_dedicated_server_parity import Server, free_port +except ImportError: + import lab + import oracle_harness as oh + import test_rust_parity as base + from test_dedicated_server_parity import Server, free_port + +NAME = 'secure-chat-parity' +SCENARIOS = { + 'offline': {'online-mode': 'false'}, + 'online': {'online-mode': 'true', 'enforce-secure-profile': 'true'}, +} +PROPERTIES = { + 'white-list': 'false', + 'level-seed': '12345', + 'view-distance': '3', + 'simulation-distance': '3', + 'spawn-protection': '0', + 'max-players': '8', + 'pause-when-empty-seconds': '-1', +} + + +def account(name): + """The mock services' account id for a name.""" + return hashlib.md5(f'account:{name}'.encode()).hexdigest() + + +class Services: + """Discovery, the key set, the session service's join and hasJoined, profiles by name.""" + + def __init__(self, key_set): + self.joined = {} + self.lock = threading.Lock() + services = self + + class Handler(BaseHTTPRequestHandler): + def log_message(self, *args): + pass + + def reply(self, status, body=None): + data = b'' if body is None else json.dumps(body).encode() + self.send_response(status) + if body is not None: + self.send_header('Content-Type', 'application/json') + self.send_header('Content-Length', str(len(data))) + self.end_headers() + self.wfile.write(data) + + def do_GET(self): + url = urllib.parse.urlparse(self.path) + query = dict(urllib.parse.parse_qsl(url.query)) + if url.path == '/minecraft/client': + return self.reply(200, services.discovery()) + if url.path == '/publickeys': + return self.reply(200, key_set) + if url.path.startswith('/users/profiles/minecraft/'): + name = urllib.parse.unquote(url.path.rsplit('/', 1)[1]) + return self.reply(200, {'id': account(name), 'name': name}) + if url.path == '/session/minecraft/hasJoined': + name = query.get('username') + with services.lock: + ok = services.joined.get(name) == query.get('serverId') + if ok: + return self.reply(200, {'id': account(name), 'name': name, 'properties': []}) + return self.reply(204) + self.reply(404, {'error': 'NotFound'}) + + def do_POST(self): + body = json.loads(self.rfile.read(int(self.headers.get('Content-Length', 0))) or b'{}') + if self.path != '/session/minecraft/join': + return self.reply(404, {'error': 'NotFound'}) + # The test client names its account instead of its id. + with services.lock: + services.joined[body.get('selectedProfile')] = body.get('serverId') + self.reply(204) + + self.server = ThreadingHTTPServer(('127.0.0.1', 0), Handler) + self.url = f'http://127.0.0.1:{self.server.server_address[1]}' + threading.Thread(target=self.server.serve_forever, daemon=True).start() + + def discovery(self): + def endpoints(**names): + return {'endpoints': {k: {'uri': self.url + v} for k, v in names.items()}} + return {'environment': 'mock', 'product': 'minecraft', 'discovery': { + 'authentication': endpoints(getPublicKeys='/publickeys'), + 'session': endpoints(join='/session/minecraft/join', verify='/session/minecraft/hasJoined', + getProfileById='/session/minecraft/profile/{profileId}'), + 'player': {'endpoints': {}}, + 'profiles': {'endpoints': {'getTexture': {'validUris': [self.url + '/texture/{textureId}']}, + 'getByName': {'uri': self.url + '/users/profiles/minecraft/{name}'}}}, + 'telemetry': {'endpoints': {}}, + }} + + def stop(self): + self.server.shutdown() + + +def player_id(name, scenario): + """The player's id: the account's online, UUIDUtil.createOfflinePlayerUUID offline.""" + if scenario == 'online': + return account(name) + digest = bytearray(hashlib.md5(f'OfflinePlayer:{name}'.encode()).digest()) + digest[6] = digest[6] & 0x0F | 0x30 + digest[8] = digest[8] & 0x3F | 0x80 + return digest.hex() + + +def dashed(u): + return f'{u[:8]}-{u[8:12]}-{u[12:16]}-{u[16:20]}-{u[20:]}' + + +def varint(n): + out = b'' + while True: + b = n & 0x7F + n >>= 7 + out += bytes([b | (0x80 if n else 0)]) + if not n: + return out + + +def status(port): + """The status response's JSON (ServerStatus).""" + def packet(body): + return varint(len(body)) + body + + def read_varint(s): + value = 0 + for i in range(5): + b = s.recv(1)[0] + value |= (b & 0x7F) << (7 * i) + if not b & 0x80: + return value + with socket.create_connection(('127.0.0.1', port), timeout=10) as s: + host = b'127.0.0.1' + s.sendall(packet(b'\x00' + varint(777) + varint(len(host)) + host + port.to_bytes(2, 'big') + b'\x01')) + s.sendall(packet(b'\x00')) + length = read_varint(s) + data = b'' + while len(data) < length: + data += s.recv(length - len(data)) + text = data[1:] + n, shift, i = 0, 0, 0 + while True: + b = text[i] + n |= (b & 0x7F) << shift + shift += 7 + i += 1 + if not b & 0x80: + break + return json.loads(text[i:i + n]) + + +# The servers' lines about chat, with their level. The thread is left out: +# vanilla handles acknowledgements on its network threads, named per platform. +CHAT_LINE = re.compile(r'^\[\d\d:\d\d:\d\d\] \[([^\]]+)\]: (.*(?:<\w+>|\[Not Secure\]|\[\w+\] |\* \w+ |secure chat|' + r'signable|Signed command|acknowledgement|profile key|chat session|expired chat|lost connection|' + r'Disconnecting).*)$') + + +def chat_lines(lines): + out = [] + for line in lines: + if m := CHAT_LINE.match(line): + text = re.sub(r'/127\.0\.0\.1:\d+', '/127.0.0.1:_', m.group(2)) + out.append(f'[{m.group(1).rsplit("/", 1)[-1]}] {text}') + return out + + +def run_side(label, scenario, command, directory, client): + port = free_port() + shutil.rmtree(directory, ignore_errors=True) + directory.mkdir(parents=True) + props = dict(PROPERTIES, **SCENARIOS[scenario], **{'server-port': str(port)}) + (directory / 'server.properties').write_text(''.join(f'{k}={v}\n' for k, v in props.items())) + (directory / 'eula.txt').write_text('eula=true\n') + # Alice and Carol are operators (/say needs it), by their ids. + ops = [{'uuid': dashed(player_id(name, scenario)), 'name': name, 'level': 4, 'bypassesPlayerLimit': False} + for name in ('Alice', 'Carol')] + (directory / 'ops.json').write_text(json.dumps(ops, indent=2)) + server = Server(command, directory, f'{label}-{scenario}') + try: + server.wait_for(r'Done \(', timeout=600) + # A server can drop a ping in its first moments (the network thread still starting): try again. + for attempt in range(5): + try: + enforces = status(port).get('enforcesSecureChat', False) + break + except (OSError, IndexError): + if attempt == 4: + raise + time.sleep(2) + out = directory.parent / f'{label}-{scenario}.txt' + client(port, scenario, out) + transcript = [f'status enforcesSecureChat {enforces}'] + out.read_text(encoding='utf-8').splitlines() + finally: + server.stop() + return transcript, chat_lines(server.lines) + + +def main(): + lock, jars, libraries = base.verify_artifacts() + build = lab.LOCAL / NAME + build.mkdir(parents=True, exist_ok=True) + report = build / 'report.json' + report.unlink(missing_ok=True) + classes = build / 'classes' + shutil.rmtree(classes, ignore_errors=True) + classes.mkdir() + dependencies = os.pathsep.join(map(str, [jars['server'], *libraries])) + oracle = lab.ROOT / 'mods/horizon/src/test/java/dev/horizonlab/parity/SecureChatClient.java' + oh.run_logged(['javac', '--release', lock['minecraft']['java_major'], '-proc:none', '-nowarn', '-sourcepath', + lab.ROOT / 'mods/horizon/src/test/java', '-cp', dependencies, '-d', classes, oracle], + build, 'compile-java') + oh.run_logged(['cargo', 'build', '--release', '-p', 'horizon-client', '--bin', 'horizon-client'], build, + 'compile-rust') + metadata = json.loads(subprocess.check_output(['cargo', 'metadata', '--no-deps', '--format-version', '1'], + cwd=lab.ROOT, text=True)) + binary = Path(metadata['target_directory']) / 'release' / ('horizon-client.exe' if os.name == 'nt' else 'horizon-client') + java = ['java', '-Xmx1g', '-Duser.timezone=UTC', '-cp', str(classes) + os.pathsep + dependencies, + 'dev.horizonlab.parity.SecureChatClient'] + oh.run_logged([*java, 'keys', build], build, 'keys') + services = Services(json.loads((build / 'publickeys.json').read_text())) + discovery = services.url + '/minecraft/client' + os.environ.update(HORIZON_NO_AUDIO='1', HORIZON_API_DISCOVERY=discovery) + servers = { + 'vanilla': ['java', '-Xmx2g', '-Duser.timezone=UTC', f'-Dminecraft.api.discovery.host={discovery}', + '-cp', dependencies, 'net.minecraft.server.Main', 'nogui'], + 'horizon': [binary, '--resources', lab.LOCAL / 'horizon-client/26.3', '--dedicated', '--nogui'], + } + + def client(port, scenario, out): + oh.run_logged([*java, '127.0.0.1', port, build / 'services-private.der', out, scenario, services.url], + build, out.stem, timeout=300) + + differences = [] + try: + for scenario in SCENARIOS: + results = {} + for label, command in servers.items(): + results[label] = run_side(label, scenario, command, build / f'{label}-{scenario}', client) + transcript, log = results[label] + (build / f'{label}-{scenario}-all.txt').write_text('\n'.join(transcript + ['--- log'] + log) + '\n', + encoding='utf-8') + import difflib + for part, index in (('transcript', 0), ('log', 1)): + diff = [l for l in difflib.unified_diff(results['vanilla'][index], results['horizon'][index], + 'vanilla', 'horizon', n=0, lineterm='') + if l[:1] in '+-' and l[:3] not in ('+++', '---')] + if diff: + differences.append(f'{scenario} {part}:\n ' + '\n '.join(diff[:60])) + errors = [l for l in results['vanilla'][0] if l.startswith('error')] + if errors: + differences.append(f'{scenario}: the vanilla run failed: {errors}') + finally: + services.stop() + if differences: + raise AssertionError('\n'.join(differences) + f'\n(transcripts in {build})') + lab.write_json(report, dict( + schema=1, minecraft=lock['minecraft']['version'], platform=platform.platform(), + java=subprocess.check_output(['java', '--version'], text=True).splitlines()[0], + scope='Secure chat against vanilla\'s dedicated server: chat sessions validated against mock services keys, ' + 'signed chat with last seen and the signature cache, unsigned chat, /say /me /msg with signed and ' + 'unsigned arguments, mismatched and forged signatures, the broken chain, a bad acknowledgement; ' + 'enforce-secure-profile in online mode (status, login, refusals, a borrowed key); the chat log lines.')) + print('secure chat: transcripts and chat log lines identical') + + +if __name__ == '__main__': + try: + main() + except AssertionError as error: + sys.exit(f'{NAME}: {error}') From 8f3d35ab6df5a000bd0be437d8b060eae8ff4960 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 07:57:10 +0200 Subject: [PATCH 074/163] Block entity animations: read the drawn block entities only when they change tick_block_entity_anims rebuilt a map of every drawn block entity, sorted it and swept the animation states against it every tick. The renderer now keeps a revision that changes when its block entities do, and the sorted ticker list is rebuilt only then. The animation states use FxHashMap. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../horizon-client/src/block_entity_anim.rs | 55 +++++++++++-------- .../src/game/block_entity_anims.rs | 25 ++++++--- crates/horizon-client/src/gfx.rs | 28 ++++++++-- 3 files changed, 73 insertions(+), 35 deletions(-) diff --git a/crates/horizon-client/src/block_entity_anim.rs b/crates/horizon-client/src/block_entity_anim.rs index eefd1ba63..2a35c9835 100644 --- a/crates/horizon-client/src/block_entity_anim.rs +++ b/crates/horizon-client/src/block_entity_anim.rs @@ -12,11 +12,11 @@ //! (blocks, entities, game time) as closures, so the parity fixture can drive //! them with scripted inputs (`tools/test_block_entity_anim_parity.py`). use crate::block_entity_render::BlockAnim; +use crate::fast_hash::FxHashMap; use horizon_core::{ geometry::trig::{self, Mth}, random::{LegacyRandom, RandomSource}, }; -use std::collections::HashMap; /// `Direction` names by `get3DDataValue`. pub const DIRECTIONS: [&str; 6] = ["down", "up", "north", "south", "west", "east"]; @@ -832,38 +832,44 @@ pub fn ticker(name: &str, prop: impl Fn(&str) -> Option<String>) -> Option<Ticke /// The animated block entities of a level, by position. #[derive(Clone, Debug)] pub struct BlockEntityAnims { - pub chests: HashMap<[i32; 3], ChestLid>, - pub books: HashMap<[i32; 3], EnchantingBook>, + pub chests: FxHashMap<[i32; 3], ChestLid>, + pub books: FxHashMap<[i32; 3], EnchantingBook>, /// `EnchantingTableBlockEntity.RANDOM`, shared by every table. pub book_random: LegacyRandom, - pub shulkers: HashMap<[i32; 3], Shulker>, - pub bells: HashMap<[i32; 3], Bell>, - pub conduits: HashMap<[i32; 3], Conduit>, - pub skulls: HashMap<[i32; 3], Skull>, - pub pots: HashMap<[i32; 3], PotWobble>, - pub gateways: HashMap<[i32; 3], EndGateway>, + pub shulkers: FxHashMap<[i32; 3], Shulker>, + pub bells: FxHashMap<[i32; 3], Bell>, + pub conduits: FxHashMap<[i32; 3], Conduit>, + pub skulls: FxHashMap<[i32; 3], Skull>, + pub pots: FxHashMap<[i32; 3], PotWobble>, + pub gateways: FxHashMap<[i32; 3], EndGateway>, /// The integrated server's copies of the gateways (`portalTick`). - pub gateway_servers: HashMap<[i32; 3], EndGateway>, + pub gateway_servers: FxHashMap<[i32; 3], EndGateway>, /// The client level's random (conduit particles). pub random: LegacyRandom, /// [`Ticker`] by block state id (see [`BlockEntityAnims::classify`]). pub kinds: Vec<Option<Ticker>>, + /// The drawn block entities with a ticker, sorted by position, and the + /// renderer's block entity revision they were read at. + pub present: Vec<([i32; 3], Ticker)>, + pub present_revision: Option<u64>, } impl Default for BlockEntityAnims { fn default() -> Self { Self { - chests: HashMap::new(), - books: HashMap::new(), + chests: FxHashMap::default(), + books: FxHashMap::default(), book_random: LegacyRandom::new(0x626f6f6b), - shulkers: HashMap::new(), - bells: HashMap::new(), - conduits: HashMap::new(), - skulls: HashMap::new(), - pots: HashMap::new(), - gateways: HashMap::new(), - gateway_servers: HashMap::new(), + shulkers: FxHashMap::default(), + bells: FxHashMap::default(), + conduits: FxHashMap::default(), + skulls: FxHashMap::default(), + pots: FxHashMap::default(), + gateways: FxHashMap::default(), + gateway_servers: FxHashMap::default(), random: LegacyRandom::new(0x6c6576656c), kinds: Vec::new(), + present: Vec::new(), + present_revision: None, } } } @@ -877,15 +883,20 @@ impl BlockEntityAnims { .and_then(|s| ticker(&s.name, |k| s.properties.get(k).cloned())) }) .collect(); + self.present_revision = None; } /// The ticker of a block state. pub fn ticker(&self, state: u32) -> Option<Ticker> { self.kinds.get(state as usize).copied().flatten() } /// Drops the state of block entities that are gone or changed kind: - /// `present` maps the loaded block entities to their tickers. - pub fn retain_present(&mut self, present: &HashMap<[i32; 3], Ticker>) { - let is = |p: &[i32; 3], f: fn(&Ticker) -> bool| present.get(p).is_some_and(f); + /// `present` holds the loaded block entities' tickers, sorted by position. + pub fn retain_present(&mut self, present: &[([i32; 3], Ticker)]) { + let is = |p: &[i32; 3], f: fn(&Ticker) -> bool| { + present + .binary_search_by_key(p, |(q, _)| *q) + .is_ok_and(|i| f(&present[i].1)) + }; self.chests.retain(|p, _| is(p, |t| *t == Ticker::Lid)); self.books.retain(|p, _| is(p, |t| *t == Ticker::Book)); self.shulkers diff --git a/crates/horizon-client/src/game/block_entity_anims.rs b/crates/horizon-client/src/game/block_entity_anims.rs index d377aeb45..102b46063 100644 --- a/crates/horizon-client/src/game/block_entity_anims.rs +++ b/crates/horizon-client/src/game/block_entity_anims.rs @@ -13,7 +13,6 @@ use horizon_client::{ }; use horizon_core::geometry::{Aabb, Vec3}; use horizon_world::nbt::Tag; -use std::collections::HashMap; /// The handle of the local player among a bell's gathered entities. const PLAYER: u64 = u64::MAX; @@ -174,11 +173,20 @@ impl Game<'_> { let Some(r) = &self.renderer else { return; }; - let present: HashMap<[i32; 3], Ticker> = r - .block_entities() - .filter_map(|(p, s)| Some((*p, self.be_anims.ticker(*s)?))) - .collect(); - self.be_anims.retain_present(&present); + // Sorted by position: the order they tick in, and a quick lookup. + // Read again only when the drawn block entities changed. + let revision = r.block_entity_revision(); + if self.be_anims.present_revision != Some(revision) { + let mut present: Vec<([i32; 3], Ticker)> = r + .block_entities() + .filter_map(|(p, s)| Some((*p, self.be_anims.ticker(*s)?))) + .collect(); + present.sort_unstable_by_key(|(p, _)| *p); + self.be_anims.retain_present(&present); + self.be_anims.present = present; + self.be_anims.present_revision = Some(revision); + } + let positions = std::mem::take(&mut self.be_anims.present); let players: Vec<[f64; 3]> = match &self.player { Some(p) if !self.spectator() => vec![[p.position.x, p.position.y, p.position.z]], _ => Vec::new(), @@ -198,9 +206,7 @@ impl Game<'_> { .get("minecraft:conduit_effect_block") .cloned() .unwrap_or_default(); - let mut positions: Vec<([i32; 3], Ticker)> = present.into_iter().collect(); - positions.sort_unstable_by_key(|(p, _)| *p); - for (pos, ticker) in positions { + for &(pos, ticker) in &positions { match ticker { Ticker::Lid => self.be_anims.chests.entry(pos).or_default().tick(), Ticker::Book => { @@ -322,6 +328,7 @@ impl Game<'_> { } } } + self.be_anims.present = positions; } /// `EndGatewayBlock.entityInside` on the server: whether the gateway at /// `pos` let the entity in (`triggerCooldown`, with its block event). diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index be842c3c6..0ee935d75 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -69,6 +69,12 @@ pub mod translucency; pub(crate) mod upload; mod world_post; +/// A new value for `Renderer::block_entity_revision`. +fn next_block_entity_revision() -> u64 { + static NEXT: std::sync::atomic::AtomicU64 = std::sync::atomic::AtomicU64::new(0); + NEXT.fetch_add(1, std::sync::atomic::Ordering::Relaxed) +} + #[repr(C)] #[derive(Clone, Copy, bytemuck::Pod, bytemuck::Zeroable)] struct Globals { @@ -348,6 +354,8 @@ pub struct Renderer { draw_pages: Vec<(u32, Option<u32>)>, /// Block-entity blocks per meshed section (world position, state id). block_entities: HashMap<SectionKey, Vec<([i32; 3], u32)>>, + /// Changes whenever `block_entities` does (unique across renderers). + block_entity_revision: u64, /// VisGraph face connectivity per meshed section (cave culling). occlusion: occlusion::Occlusion, /// Resolution scale and FXAA (Horizon settings). @@ -1821,6 +1829,7 @@ impl Renderer { draws: Vec::new(), draw_pages: Vec::new(), block_entities: HashMap::new(), + block_entity_revision: next_block_entity_revision(), occlusion: occlusion::Occlusion::new(crate::chunk::HEIGHT / 16), world_post, pack: None, @@ -1987,10 +1996,14 @@ impl Renderer { } pub fn upload(&mut self, key: SectionKey, mesh: &SectionMesh) { self.occlusion.set(key, mesh.visibility); - if mesh.block_entities.is_empty() { - self.block_entities.remove(&key); + let changed = if mesh.block_entities.is_empty() { + self.block_entities.remove(&key).is_some() } else { - self.block_entities.insert(key, mesh.block_entities.clone()); + let old = self.block_entities.insert(key, mesh.block_entities.clone()); + old.as_deref() != Some(&mesh.block_entities[..]) + }; + if changed { + self.block_entity_revision = next_block_entity_revision(); } let solid = (mesh.solid.len() / 4) as u32; let translucent = (mesh.translucent.len() / 4) as u32; @@ -2099,8 +2112,13 @@ impl Renderer { pub fn block_entities(&self) -> impl Iterator<Item = &([i32; 3], u32)> { self.block_entities.values().flatten() } + /// A value that changes whenever `block_entities` gives something else. + pub fn block_entity_revision(&self) -> u64 { + self.block_entity_revision + } pub fn clear_sections(&mut self) { self.block_entities.clear(); + self.block_entity_revision = next_block_entity_revision(); self.sections.clear(); self.arena.clear(); if let Some(flat) = &mut self.flat { @@ -2111,7 +2129,9 @@ impl Renderer { self.occlusion.clear(); } pub fn remove(&mut self, key: SectionKey) { - self.block_entities.remove(&key); + if self.block_entities.remove(&key).is_some() { + self.block_entity_revision = next_block_entity_revision(); + } self.occlusion.remove(key); self.release_section(key); } From a2363a3bf635f7035052f97dfea488c2d16f878c Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 08:09:49 +0200 Subject: [PATCH 075/163] fix(server-thread): the integrated server follows the render distance, past 32 too IntegratedServer.tickServer: the server takes the window's render and simulation distances when they change ("Changing view distance to N, from M"), tells every player (SetChunkCacheRadius, SetSimulationDistance), and each player's chunks follow, up to what they asked for. The integrated server no longer clamps the view distance to 32, and a remote client sends its render distance again when it changes (Options.broadcastOptions), past 32 too. Fixes #804. lan_e2e: a distance check (--server-thread), and the guest is found by name in lan status, where the server thread lists the owner too: the hazards check read the owner's food (the "no hunger from moving" gap). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game.rs | 4 ++ crates/horizon-client/src/game/integrated.rs | 48 ++++++++++++++++++-- crates/horizon-client/src/game/remote.rs | 30 ++++++++++-- crates/horizon-client/src/lan/hub.rs | 16 +++++++ tools/lan_e2e.py | 43 +++++++++++++++--- 5 files changed, 127 insertions(+), 14 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index cfbb526ef..bb9d8f0a7 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -9979,6 +9979,10 @@ impl ApplicationHandler for Game<'_> { self.pause = self.pauses_game(); if let Some(server) = &self.integrated { server.set_paused(self.pause); + server.set_distances( + self.settings.render_distance, + self.settings.simulation_distance, + ); } self.clock.end_frame(self.pause); let finished = self diff --git a/crates/horizon-client/src/game/integrated.rs b/crates/horizon-client/src/game/integrated.rs index 412c41693..b2c0a2e7f 100644 --- a/crates/horizon-client/src/game/integrated.rs +++ b/crates/horizon-client/src/game/integrated.rs @@ -28,7 +28,7 @@ use std::{ path::Path, sync::{ Arc, - atomic::{AtomicBool, AtomicU16, AtomicU32, Ordering}, + atomic::{AtomicBool, AtomicI32, AtomicU16, AtomicU32, Ordering}, mpsc::{Receiver, Sender, channel, sync_channel}, }, thread::JoinHandle, @@ -45,6 +45,10 @@ struct Flags { /// while it is not. published: AtomicU16, smoothed_tick_ms: AtomicU32, + /// `options.renderDistance` and `options.simulationDistance`, which the + /// server follows while it runs (IntegratedServer.tickServer). + render_distance: AtomicI32, + simulation_distance: AtomicI32, } /// Work the window hands its server thread (`MinecraftServer.execute`). @@ -66,6 +70,13 @@ impl Integrated { pub fn set_paused(&self, paused: bool) { self.flags.paused.store(paused, Ordering::Relaxed); } + /// The window's render and simulation distances, for the server to follow. + pub fn set_distances(&self, render: i32, simulation: i32) { + self.flags.render_distance.store(render, Ordering::Relaxed); + self.flags + .simulation_distance + .store(simulation, Ordering::Relaxed); + } /// `IntegratedServer.getPort` while `isPublished`. pub fn published(&self) -> Option<u16> { Some(self.flags.published.load(Ordering::Relaxed)).filter(|&p| p != 0) @@ -192,6 +203,12 @@ impl Game<'_> { options.dev_mods.clear(); let (res, pack, settings) = (self.res.clone(), self.pack.clone(), self.settings.clone()); let flags = Arc::new(Flags::default()); + flags + .render_distance + .store(settings.render_distance, Ordering::Relaxed); + flags + .simulation_distance + .store(settings.simulation_distance, Ordering::Relaxed); let (ready_tx, ready) = channel(); let (tasks, server_tasks) = channel(); let server_flags = flags.clone(); @@ -249,7 +266,9 @@ impl Game<'_> { launch.create.as_ref(), )?; let saved = Box::new(self.level.clone()); - let view_distance = self.settings.render_distance.clamp(2, 32); + // Math.max(2, options.renderDistance): past vanilla's 32 when the + // window's render distance is (Horizon's options go to 64). + let view_distance = self.settings.render_distance.max(2); let config = HubConfig { default_game_mode: self.level.mode(), // Only the owner until it is opened to the LAN. @@ -257,7 +276,7 @@ impl Game<'_> { force_game_mode: false, hardcore: self.level.hardcore, view_distance, - simulation_distance: self.settings.simulation_distance.clamp(2, 32), + simulation_distance: self.settings.simulation_distance.max(2), dimension: self.dim.id().to_owned(), seed: self.level.seed, max_players: MAX_PLAYERS, @@ -318,6 +337,7 @@ impl Game<'_> { // Only the connections run. self.tick_server(true)?; } else { + self.follow_distances(&flags); let started = Instant::now(); self.tick_server(false)?; self.debug_charts.log_tick(started, started.elapsed()); @@ -438,6 +458,28 @@ impl Game<'_> { } /// Publish or unpublish for real, once the hub is in its place (a /// player's `/publish` runs while it is out). + /// IntegratedServer.tickServer: the server follows the window's render + /// and simulation distances when they change. + fn follow_distances(&mut self, flags: &Flags) { + let Some(host) = self.lan.as_mut() else { + return; + }; + let view = flags.render_distance.load(Ordering::Relaxed).max(2); + let old = host.hub.config.view_distance; + if view != old { + log::info!("Changing view distance to {view}, from {old}"); + host.hub.set_view_distance(view); + self.settings.render_distance = view; + } + let simulation = flags.simulation_distance.load(Ordering::Relaxed).max(2); + let old = host.hub.config.simulation_distance; + if simulation != old { + log::info!("Changing simulation distance to {simulation}, from {old}"); + host.hub.set_simulation_distance(simulation); + self.settings.simulation_distance = simulation; + } + } + fn apply_publish(&mut self) { if self.lan.is_none() { return; diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index e5769acde..474e943c0 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -100,6 +100,8 @@ pub(super) struct Remote { was_sprinting: bool, carried: Option<usize>, loaded_sent: bool, + /// The view distance last sent in ClientInformation. + sent_view: i8, /// BlockStatePredictionHandler: blocks changed ahead of the server (a predicted break), /// with the sequence of the last action that changed them and the state the server /// last said they have. Until the server acknowledges that sequence its block updates @@ -209,7 +211,7 @@ impl Game<'_> { .and_then(|p| Builtin::load(&p).ok()) .ok_or("Resources are incomplete: registries.json is missing or invalid. Click \"Prepare again\" in the launcher (or run horizon-prepare), then try again.")?; let lang = Arc::new(horizon_client::net::load_language(&root)); - let view = self.settings.render_distance.clamp(2, 32) as i8; + let view = client_view_distance(self.settings.render_distance); if local.is_none() { horizon_client::crash::set_detail( "Server", @@ -296,6 +298,7 @@ impl Game<'_> { was_sprinting: false, carried: None, loaded_sent: false, + sent_view: view, predictions: HashMap::new(), menu: None, menu_title: None, @@ -1153,10 +1156,12 @@ impl Game<'_> { self.streaming.radius = self.settings.render_distance.min(p.chunk_radius + 1).max(2); self.enter_remote_dimension(&p.spawn, false); + let view = client_view_distance(self.settings.render_distance); + if let Some(r) = self.remote.as_mut() { + r.sent_view = view; + } self.send(S::ClientInformation( - horizon_protocol::packets::configuration::ClientInformation::new( - self.settings.render_distance.clamp(2, 32) as i8, - ), + horizon_protocol::packets::configuration::ClientInformation::new(view), )); } C::Respawn(p) => { @@ -2303,6 +2308,17 @@ impl Game<'_> { /// One client tick while connected (Minecraft.tick with a ClientLevel). pub(super) fn tick_remote(&mut self) -> Result<()> { self.ticks += 1; + // Options.broadcastOptions: a changed render distance is sent again. + let view = client_view_distance(self.settings.render_distance); + if let Some(r) = self.remote.as_mut() + && r.joined + && r.sent_view != view + { + r.sent_view = view; + self.send(S::ClientInformation( + horizon_protocol::packets::configuration::ClientInformation::new(view), + )); + } // Minecraft.tick: TickRateManager.tick; ClientLevel.tick advances // the time only while the level runs normally. let running = self.clock.world_runs(); @@ -3749,6 +3765,12 @@ pub(super) fn input_ordinal(input: Input) -> i32 { } } +/// The view distance a client asks for: its render distance, which Horizon +/// lets go past vanilla's 32 (a vanilla server still caps it at its own). +fn client_view_distance(render_distance: i32) -> i8 { + render_distance.clamp(2, i32::from(i8::MAX)) as i8 +} + #[cfg(test)] mod tests { use super::Game; diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index e877fdd64..54b3ba63b 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -299,6 +299,22 @@ impl Hub { g.sender.send(body.clone()); } } + /// PlayerList.setViewDistance: every player is told the new radius, + /// and each one's chunks follow it, up to what they asked for + /// (ChunkMap.getPlayerViewDistance). + pub fn set_view_distance(&mut self, distance: i32) { + self.config.view_distance = distance; + self.broadcast(&C::SetChunkCacheRadius(play::Distance { distance })); + for g in &mut self.guests { + g.view_distance = i32::from(g.info.view_distance).clamp(2, distance); + g.center = None; + } + } + /// PlayerList.setSimulationDistance. + pub fn set_simulation_distance(&mut self, distance: i32) { + self.config.simulation_distance = distance; + self.broadcast(&C::SetSimulationDistance(play::Distance { distance })); + } /// Whether a guest is placed in the level in place (`config.dimension`). pub fn here(&self, g: &Guest) -> bool { g.placed && g.dimension == self.config.dimension diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 7dc8b2c01..c306504ab 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -23,6 +23,8 @@ address. The script then checks, from both sides, what a guest's game used to ge opens as 9x6 with the right half first; - feedback: the guest's command feedback names the guest and shows the numbers; - effects: a beacon's power reaches every player in range, the host and the guest; +- distance: (--server-thread) the server follows the host's render distance, past vanilla's 32 too + (IntegratedServer.tickServer), and the guest's chunks follow the server's (#804) - portals: (--server-thread) the server holds a level per dimension: the guest goes to the Nether through a portal while the host stays, then the host goes to the End while the guest is in the Nether, and both come back. @@ -79,7 +81,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', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'objects', 'projectiles', 'effects', 'portals'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'objects', 'projectiles', 'effects', 'portals', 'distance'] class Game: @@ -192,7 +194,7 @@ def check_armour(host, guest, out): face_each_other(host, guest) host.shot(out, 'armour') guest.shot(out, 'armour') - seen = host.raw('lan', 'status')['guests'][0].get('model_armor') + seen = lan_guest(host).get('model_armor') assert seen == [None, 'minecraft:diamond_chestplate', 'minecraft:diamond_leggings', None], \ f'the host draws the guest in {seen}' host_gear = [e for e in remote(guest).get('player_equipment', [])] @@ -355,6 +357,33 @@ def nether_portal(game, x, y, z): game('command', command=f'fill {x} {y} {z} {x + 1} {y + 2} {z} minecraft:nether_portal[axis=x]') +def lan_guest(host): + """The guest's entry in the host's `lan status` (on the server thread the owner is listed too).""" + guests = host.raw('lan', 'status')['guests'] + return next(g for g in guests if g['name'] == GUEST_NAME) + +def check_distance(host, guest, out): + """IntegratedServer.tickServer: the server takes the host's render distance as its view distance + (past 32, which Horizon's options allow) and sends it to every player (SetChunkCacheRadius).""" + if not SERVER_THREAD: + return 'skipped (needs --server-thread)' + seen = {} + try: + for distance in (48, 6): + host.raw('render-distance', distance) + # The pause screen doesn't hold the server here: it follows on its next tick. + host.wait(20) + guest.wait(20) + seen[distance] = (host('status').get('render_distance'), guest('status').get('render_distance')) + finally: + host.raw('render-distance', 12) + # A client streams out to min(its render distance, the server's view distance + 1). + assert seen[48][0] == 48, f'the host at 48 streams {seen[48][0]} chunks out (all: {seen})' + assert seen[6][0] == 6, f'the host at 6 streams {seen[6][0]} chunks out (all: {seen})' + assert seen[6][1] == 7, f'the guest streams {seen[6][1]} with the server at 6 (all: {seen})' + return seen + + def check_portals(host, guest, out): if not SERVER_THREAD: return 'skipped (needs --server-thread)' @@ -470,14 +499,14 @@ def check_hazards(host, guest, out): guest.wait(10) x, y, z = pos_of(guest) guest.raw('look-at', f'{x + 60:.2f}', f'{y + 1.6:.2f}', f'{z:.2f}') - food = host.raw('lan', 'status')['guests'][0]['food'] + food = lan_guest(host)['food'] for k in ('w', 'ctrl', 'space'): guest.raw('key', k, 'down') guest.wait(160) for k in ('space', 'ctrl', 'w'): guest.raw('key', k, 'up') guest.wait(10) - fed = host.raw('lan', 'status')['guests'][0]['food'] + fed = lan_guest(host)['food'] hunger = {'before': food, 'after': fed} hurt = {} hx, hy, hz = (int(v // 1) for v in pos_of(host)) @@ -865,7 +894,7 @@ def changed_pixels(a, b): def sneaking_on_host(host, want, ticks=40): """Whether the host sees the guest crouching, once it matches `want` or after `ticks`.""" for _ in range(ticks // 5): - sneaking = host.raw('lan', 'status')['guests'][0]['sneaking'] + sneaking = lan_guest(host)['sneaking'] if sneaking == want: return sneaking host.wait(5) @@ -988,7 +1017,7 @@ def check_sleep(host, guest, out): guest.raw('interact', *guest_bed) guest.wait(10) asleep = {'guest': guest('state').get('sleeping'), 'host': host('state').get('sleeping'), - 'server': host.raw('lan', 'status')['guests'][0].get('sleeping')} + 'server': lan_guest(host).get('sleeping')} guest.shot(out, 'sleep-guest') # Alone in bed: still night 120 ticks later (everyone must sleep). guest.wait(120) @@ -1178,7 +1207,7 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'containers': check_containers, 'feedback': check_feedback, 'titles': check_titles, 'commands': check_commands, 'recipes': check_recipes, 'trials': check_trials, 'walls': check_walls, - 'effects': check_effects, 'portals': check_portals, 'clicks': check_clicks, + 'effects': check_effects, 'portals': check_portals, 'distance': check_distance, 'clicks': check_clicks, 'sleep': check_sleep, 'push': check_push, 'eat': check_eat, 'xp': check_xp, 'objects': check_objects, 'projectiles': check_projectiles} From 84d3d2a9a025df673abefe6d815f4d8da8191e40 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 08:14:28 +0200 Subject: [PATCH 076/163] Rerun CI (flaky options_ui test, #802) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> From 1ccc41c8b29cb2034d6e1bed1662665f58fd093c Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 08:56:01 +0200 Subject: [PATCH 077/163] Content mods: add to other structure sets and pools (horizon:add_to) A content mod's structure set or template pool file holding "horizon:add_to" appends its entries to the sets or pools it names (vanilla's, another mod's) instead of being one of its own, as lithostitched's add_structure_set_entries and add_template_pool_elements modifiers do on NeoForge and Fabric. The content root merges them after every mod's own files, in mod and file order; a name nobody defines is skipped. Vanilla data never has the key. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/mod_content.rs | 87 ++++++++++++++++++- .../horizon-client/src/mod_content_tests.rs | 43 +++++++++ docs/mods.md | 16 ++++ 3 files changed, 144 insertions(+), 2 deletions(-) diff --git a/crates/horizon-client/src/mod_content.rs b/crates/horizon-client/src/mod_content.rs index 1cd155297..c396c3333 100644 --- a/crates/horizon-client/src/mod_content.rs +++ b/crates/horizon-client/src/mod_content.rs @@ -697,6 +697,78 @@ fn worldgen_entry(file: &str) -> Option<(&'static str, String)> { Some((bundle, format!("{ns}:{}", path.strip_suffix(".json")?))) } +/// The key of a mod's structure set or template pool file that adds its +/// entries to other sets or pools (vanilla's, another mod's) instead of +/// being one of its own. Vanilla data never has it. +const ADD_TO: &str = "horizon:add_to"; +/// The bundles a mod may add to, and the list each entry goes into. +const ADDABLE: [(&str, &str); 2] = [ + ("worldgen/structure_sets.json", "structures"), + ("worldgen/template_pools.json", "elements"), +]; + +/// A mod file's additions (`horizon:add_to`): its entries appended to the +/// list of each set or pool it names, as lithostitched's +/// `add_structure_set_entries` and `add_template_pool_elements` do for +/// NeoForge and Fabric packs. +struct Addition { + targets: Vec<String>, + list: &'static str, + entries: Vec<J>, +} +impl Addition { + /// What a mod file of `bundle` adds, if it is an addition file. + fn read(bundle: &str, text: &str) -> Result<Option<Self>> { + let Some((_, list)) = ADDABLE.iter().find(|(b, _)| *b == bundle) else { + return Ok(None); + }; + if !text.contains(ADD_TO) { + return Ok(None); + } + let doc: J = serde_json::from_str(text)?; + let Some(targets) = doc.get(ADD_TO) else { + return Ok(None); + }; + let targets = match targets { + J::Str(s) => vec![s.clone()], + J::Arr(a) => a + .iter() + .map(|v| match v { + J::Str(s) => Some(s.clone()), + _ => None, + }) + .collect::<Option<_>>() + .ok_or(format!("{ADD_TO}: not a list of ids"))?, + _ => return Err(format!("{ADD_TO}: not an id or a list of ids").into()), + }; + let Some(J::Arr(entries)) = doc.get(list) else { + return Err(format!("{ADD_TO} without a {list} list").into()); + }; + Ok(Some(Self { + targets, + list, + entries: entries.clone(), + })) + } + /// Appends the entries to each target in the bundle `doc` (id → the + /// file's text). A target nobody defines is skipped, as a tag entry + /// naming an unknown id is. + fn apply(&self, doc: &mut J) -> Result<()> { + for target in &self.targets { + let Some(J::Str(text)) = doc.get(target) else { + continue; + }; + let mut v: J = serde_json::from_str(text).map_err(|e| format!("{target}: {e}"))?; + let Some(J::Arr(list)) = v.get_mut(self.list) else { + continue; + }; + list.extend(self.entries.iter().cloned()); + doc.set(target, J::Str(serde_json::to_string(&v)?)); + } + Ok(()) + } +} + /// The overlay being written: `out` mirrors `base` through links, and a /// directory becomes real only when something inside it is written. struct Overlay<'a> { @@ -904,6 +976,7 @@ pub fn build(base: &Path, mods: &[ContentMod], out: &Path) -> Result<()> { // Mod files, and every tag addition gathered per tag file. let mut tags: BTreeMap<String, Vec<J>> = BTreeMap::new(); let mut worldgen: BTreeMap<&str, Vec<(String, String)>> = BTreeMap::new(); + let mut additions: BTreeMap<&str, Vec<Addition>> = BTreeMap::new(); for m in mods { let declarations = format!("data/{}/horizon/", m.id); for file in &m.content.files { @@ -928,7 +1001,11 @@ pub fn build(base: &Path, mods: &[ContentMod], out: &Path) -> Result<()> { overlay.write(file, &bytes)?; if let Some((bundle, id)) = worldgen_entry(file) { let text = String::from_utf8(bytes).map_err(|e| format!("{file}: {e}"))?; - worldgen.entry(bundle).or_default().push((id, text)); + let entries = worldgen.entry(bundle).or_default(); + match Addition::read(bundle, &text).map_err(|e| format!("{file}: {e}"))? { + Some(addition) => additions.entry(bundle).or_default().push(addition), + None => entries.push((id, text)), + } } else if let Some(template) = file .strip_prefix("data/") .and_then(|r| r.split_once("/structure/")) @@ -1002,7 +1079,8 @@ pub fn build(base: &Path, mods: &[ContentMod], out: &Path) -> Result<()> { } overlay.write(BIOME_TAGS, &serde_json::to_vec(&doc)?)?; } - // Structures and the pools, sets, processors and features they use. + // Structures and the pools, sets, processors and features they use, then + // what mods add to sets and pools, in mod and file order. for (bundle, entries) in &worldgen { if !base.join(bundle).exists() { continue; @@ -1011,6 +1089,11 @@ pub fn build(base: &Path, mods: &[ContentMod], out: &Path) -> Result<()> { for (id, text) in entries { doc.set(id, J::Str(text.clone())); } + for addition in additions.get(bundle).into_iter().flatten() { + addition + .apply(&mut doc) + .map_err(|e| format!("{bundle}: {e}"))?; + } overlay.write(bundle, &serde_json::to_vec(&doc)?)?; } // A block without its own blockstate looks like its template, so every diff --git a/crates/horizon-client/src/mod_content_tests.rs b/crates/horizon-client/src/mod_content_tests.rs index 614705562..c80b45c3e 100644 --- a/crates/horizon-client/src/mod_content_tests.rs +++ b/crates/horizon-client/src/mod_content_tests.rs @@ -576,6 +576,18 @@ fn content_root_carries_a_structure_mod() { "data/huts/tags/worldgen/biome/has_hut.json", r##"{"values": ["#minecraft:is_overworld", "#c:is_plains", "othermod:glade", "minecraft:plains"]}"##, ), + // Additions to vanilla's set and pool; a target nobody defines is skipped. + ( + "data/huts/worldgen/structure_set/added/villages.json", + r#"{"horizon:add_to": "minecraft:villages", + "structures": [{"structure": "huts:hut", "weight": 3}]}"#, + ), + ( + "data/huts/worldgen/template_pool/added/houses.json", + r#"{"horizon:add_to": ["othermod:houses", "minecraft:village/plains/houses"], + "elements": [{"weight": 2, "element": {"element_type": "minecraft:single_pool_element", + "location": "huts:hut", "projection": "rigid", "processors": "minecraft:empty"}}]}"#, + ), ]; for (name, text) in files { let path = dir.join(name); @@ -601,6 +613,37 @@ fn content_root_carries_a_structure_mod() { hut["values"], serde_json::json!(["#minecraft:is_overworld", "minecraft:plains"]) ); + // The additions join vanilla's entries at the end and are no set or pool + // of their own. + let bundle = |name: &str, base: &Path| -> BTreeMap<String, String> { + serde_json::from_slice(&fs::read(base.join("worldgen").join(name)).unwrap()).unwrap() + }; + for (name, id, list, added) in [ + ( + "structure_sets.json", + "minecraft:villages", + "structures", + serde_json::json!({"structure": "huts:hut", "weight": 3}), + ), + ( + "template_pools.json", + "minecraft:village/plains/houses", + "elements", + serde_json::json!({"weight": 2, "element": {"element_type": "minecraft:single_pool_element", + "location": "huts:hut", "projection": "rigid", "processors": "minecraft:empty"}}), + ), + ] { + let (ours, vanilla) = (bundle(name, &root), bundle(name, &base)); + let entries = |text: &str| -> Vec<serde_json::Value> { + let v: serde_json::Value = serde_json::from_str(text).unwrap(); + v[list].as_array().unwrap().clone() + }; + let mut expected = entries(&vanilla[id]); + expected.push(added); + assert_eq!(entries(&ours[id]), expected, "{id}"); + assert!(!ours.keys().any(|k| k.starts_with("huts:added/")), "{name}"); + assert!(!ours.contains_key("othermod:houses")); + } let assets = Assets::load(&root).unwrap(); let biomes = crate::biome::Biomes::load(&root).unwrap(); diff --git a/docs/mods.md b/docs/mods.md index d1556abd7..bdf45f620 100644 --- a/docs/mods.md +++ b/docs/mods.md @@ -287,6 +287,22 @@ its row. The game reads this content into its block and item tables nobody registers (a block a port left out, another mod's item) is dropped, so the rest of the tag still loads; vanilla would drop the whole tag. +A mod adds to structure sets and template pools that are not its own +(vanilla's villages, another mod's houses) with a set or pool file in its own +namespace holding `horizon:add_to`, a key vanilla data never has. Its entries +are appended to each set or pool named, after every mod's own files, in mod +and file order; the file is no set or pool itself. A name nobody defines is +skipped. + +```json +{ "horizon:add_to": "minecraft:villages", + "structures": [ { "structure": "mymod:village_beach", "weight": 10 } ] } +``` + +A pool addition holds `"elements"` as a pool does. This is what lithostitched's +`add_structure_set_entries` and `add_template_pool_elements` modifiers do on +NeoForge and Fabric, and `horizon-port-pack carry` writes them from those. + ## Versions and compatibility - The API is the WIT package `horizon:mods@0.1.0`. New functions and From d8f81f7a984874456b1b1f72a84703f9f6176c24 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 08:56:01 +0200 Subject: [PATCH 078/163] Carry: lithostitched set and pool additions, and CTOV's villages Lithostitched's add_structure_set_entries and add_template_pool_elements modifiers become horizon:add_to files under worldgen/<kind>/horizon_added/, upgraded as the mod's own pools are. Their load conditions (lithostitched's predicate, NeoForge's, else Fabric's) are checked against the mods ported along; other modifier types and tag targets are counted, not carried. ChoiceTheorem's Overhauled Village adds its villages and outposts to vanilla's sets in Java code; carry writes them with its default config (small, medium and large villages weighted 10, 4 and 1, outposts 1). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/carry.rs | 94 +++++++- crates/horizon-port-pack/src/pipeline.rs | 23 +- crates/horizon-port-pack/src/worldgen.rs | 282 +++++++++++++++++++++++ 3 files changed, 392 insertions(+), 7 deletions(-) diff --git a/crates/horizon-port-pack/src/carry.rs b/crates/horizon-port-pack/src/carry.rs index c73570684..505c20250 100644 --- a/crates/horizon-port-pack/src/carry.rs +++ b/crates/horizon-port-pack/src/carry.rs @@ -331,13 +331,16 @@ fn unreadable(name: &str, bytes: &mut Vec<u8>) -> Option<String> { /// Carries `jar` over into `out/carry/`. With the oracle's `facts`, blocks /// and items are the ones the mod registers, with the templates and numbers -/// the facts give; `allowed` says which vanilla blocks the game has. +/// the facts give; `allowed` says which vanilla blocks the game has; +/// `loaded` which mods are ported along, for the conditions of the mod's +/// worldgen modifiers. pub fn carry( jar: &Path, info: &JarInfo, out: &Path, facts: Option<&Facts>, allowed: &dyn Fn(&str) -> bool, + loaded: &dyn Fn(&str) -> bool, conventions: &BTreeMap<String, Value>, ) -> Result<Report, String> { let id = &info.mod_id; @@ -427,6 +430,26 @@ pub fn carry( bytes = serde_json::to_vec_pretty(&v).unwrap_or(bytes); } } + } else if let Some(path) = rel + .strip_prefix("lithostitched/worldgen_modifier/") + .filter(|_| name.starts_with("data/") && name.ends_with(".json")) + { + // Additions to other sets and pools, as files the game merges. + let modifier = serde_json::from_slice::<Value>(&bytes).ok(); + let types = &mut report.worldgen_types; + if let Some((kind, mut added)) = + modifier.and_then(|v| crate::worldgen::modifier(&v, loaded, types)) + { + crate::worldgen::upgrade(kind, &mut added, types, &set_tags); + let to = format!( + "data/{id}/worldgen/{kind}/{}/{path}", + crate::worldgen::ADDED + ); + write( + &inside.join(to), + &serde_json::to_vec_pretty(&added).unwrap_or_default(), + )?; + } } else if rel.starts_with("tags/worldgen/biome/") && name.starts_with("data/") { if let Ok(v) = serde_json::from_slice::<Value>(&bytes) { crate::worldgen::convention_tags(&v, &mut biome_conventions); @@ -462,6 +485,35 @@ pub fn carry( } write(&dest, &bytes)?; } + // Entries the mod adds to other structure sets in Java code, for the + // structures it has. + for (file, set, entries) in crate::worldgen::code_set_entries(id) { + let entries: Vec<Value> = entries + .into_iter() + .filter(|(s, _)| { + s.split_once(':').is_some_and(|(ns, path)| { + inside + .join(format!("data/{ns}/worldgen/structure/{path}.json")) + .exists() + }) + }) + .map(|(structure, weight)| json!({"structure": structure, "weight": weight})) + .collect(); + if entries.is_empty() { + continue; + } + let added = &mut report.worldgen_types.added_to; + *added.entry(set.to_owned()).or_default() += entries.len(); + let to = format!( + "data/{id}/worldgen/structure_set/{}/{file}.json", + crate::worldgen::ADDED + ); + let v = json!({"horizon:add_to": set, "structures": entries}); + write( + &inside.join(to), + &serde_json::to_vec_pretty(&v).unwrap_or_default(), + )?; + } // 1.21.4 moved item models behind `items/<name>.json` definitions. for m in &item_models { let def = inside.join(format!("assets/{id}/items/{m}.json")); @@ -832,6 +884,14 @@ mod tests { r#"{"values": ["gem:gem_block"]}"#, ), ("data/c/tags/item/gems.json", r#"{"values": ["gem:gem"]}"#), + ( + "data/gem/lithostitched/worldgen_modifier/houses.json", + r#"{"type": "lithostitched:add_template_pool_elements", + "template_pools": "minecraft:village/plains/houses", + "elements": [{"weight": 2, "element": {"element_type": "minecraft:single_pool_element", + "location": "gem:hut", "projection": "rigid", + "processors": {"processors": [{"processor_type": "lithostitched:block_swap"}]}}}]}"#, + ), // What the game would refuse: vanilla skips these files alone. ("assets/gem/lang/ry_UA.json", r#"{"item.gem.gem": "Gem"}"#), ("data/gem/tags/item/empty.json", ""), @@ -858,8 +918,17 @@ mod tests { ); assert_eq!(info.census.classes, 1); let out = dir.join("work/mods/gem"); - let report = carry(&jar, &info, &out, None, &|_| true, &BTreeMap::new()).unwrap(); - assert_eq!(report.copied, 13); + let report = carry( + &jar, + &info, + &out, + None, + &|_| true, + &|_| true, + &BTreeMap::new(), + ) + .unwrap(); + assert_eq!(report.copied, 14); let unreadable: Vec<&str> = report.unreadable.keys().map(String::as_str).collect(); assert_eq!( unreadable, @@ -892,6 +961,25 @@ mod tests { ) .unwrap(); assert_eq!(recipe["key"]["#"], "gem:gem"); + // A lithostitched pool addition, as a file the game merges, upgraded + // as the mod's own pools are. + let added: Value = serde_json::from_slice( + &fs::read(carried.join("data/gem/worldgen/template_pool/horizon_added/houses.json")) + .unwrap(), + ) + .unwrap(); + assert_eq!( + added["horizon:add_to"], + json!(["minecraft:village/plains/houses"]) + ); + assert_eq!( + added["elements"][0]["element"]["processors"], + json!({"processors": []}) + ); + assert_eq!( + report.worldgen_types.added_to["minecraft:village/plains/houses"], + 1 + ); // Horizon's own reader accepts it: blocks and items declared, files fenced. let package = horizon_mods::Package::read(&carried).unwrap(); diff --git a/crates/horizon-port-pack/src/pipeline.rs b/crates/horizon-port-pack/src/pipeline.rs index 3afe5b3a3..7152dc921 100644 --- a/crates/horizon-port-pack/src/pipeline.rs +++ b/crates/horizon-port-pack/src/pipeline.rs @@ -120,13 +120,27 @@ pub fn carry( }); let allowed = |b: &str| vanilla.as_ref().is_none_or(|v| v.contains(b)); let conventions = crate::worldgen::loader_biome_tags(work); - let mut done = 0; - for r in &records { - let chosen = if only.is_empty() { + let chosen = |r: &inventory::Record| { + if only.is_empty() { r.class == "content" } else { only.contains(&r.key) - }; + } + }; + // The mods ported along (carried now or before), for the conditions of + // the mods' worldgen modifiers. + let ported: BTreeSet<&str> = records + .iter() + .filter(|r| { + r.jar.is_some() && (chosen(r) || work.join("mods").join(&r.key).join("carry").is_dir()) + }) + .filter_map(|r| Some(r.info.as_ref()?.mod_id.as_str())) + .chain(["minecraft"]) + .collect(); + let loaded = |m: &str| ported.contains(m); + let mut done = 0; + for r in &records { + let chosen = chosen(r); let (Some(jar), Some(info)) = (&r.jar, &r.info) else { if chosen && !only.is_empty() { log(format!( @@ -155,6 +169,7 @@ pub fn carry( &work.join("mods").join(&r.key), facts.as_ref().filter(seen), &allowed, + &loaded, &conventions, ) { Ok(report) => { diff --git a/crates/horizon-port-pack/src/worldgen.rs b/crates/horizon-port-pack/src/worldgen.rs index 25e0dbbea..0e9292fc4 100644 --- a/crates/horizon-port-pack/src/worldgen.rs +++ b/crates/horizon-port-pack/src/worldgen.rs @@ -76,6 +76,206 @@ pub struct Upgrade { pub rules_lost: BTreeMap<String, usize>, /// Processors written in Java, taken out of their lists, by type. pub processors_dropped: BTreeMap<String, usize>, + /// Entries added to other structure sets and template pools + /// (`horizon:add_to`), by the set or pool they join. + pub added_to: BTreeMap<String, usize>, + /// Lithostitched worldgen modifiers not carried: by type, `conditions` + /// when they need a mod that is not ported along, `target` when they + /// name their sets or pools by a tag. + pub modifiers_left: BTreeMap<String, usize>, +} + +/// Where a mod's additions to other sets and pools go in its carry: +/// `data/<id>/worldgen/<kind>/horizon_added/<name>.json`. +pub const ADDED: &str = "horizon_added"; + +/// A lithostitched worldgen modifier +/// (`data/<ns>/lithostitched/worldgen_modifier/`) that adds to structure +/// sets or template pools, as a file the game merges into them (the key +/// `horizon:add_to`, `horizon_client::mod_content`): (kind, file). The +/// modifier's conditions are checked against `loaded`, the mods ported +/// along: a compat addition for a mod that is not would place that mod's +/// blocks, which the game does not have. Other modifier types are left out. +/// Both are counted in `report`. +pub fn modifier( + v: &Value, + loaded: &dyn Fn(&str) -> bool, + report: &mut Upgrade, +) -> Option<(&'static str, Value)> { + let t = v["type"].as_str().unwrap_or_default(); + let mut left = |why: &str| *report.modifiers_left.entry(why.to_owned()).or_default() += 1; + let (kind, targets, from, to) = match t { + "lithostitched:add_structure_set_entries" => { + ("structure_set", "structure_sets", "entries", "structures") + } + "lithostitched:add_template_pool_elements" => { + ("template_pool", "template_pools", "elements", "elements") + } + _ => { + left(t); + return None; + } + }; + if !conditions_hold(v, loaded) { + left("conditions"); + return None; + } + let targets: Option<Vec<&str>> = match &v[targets] { + Value::String(s) => Some(vec![s.as_str()]), + Value::Array(a) => a.iter().map(Value::as_str).collect(), + _ => None, + }; + let Some(targets) = targets.filter(|t| !t.is_empty() && t.iter().all(|t| !t.starts_with('#'))) + else { + left("target"); + return None; + }; + let entries = v[from].as_array().cloned().unwrap_or_default(); + for target in &targets { + *report.added_to.entry((*target).to_owned()).or_default() += entries.len(); + } + Some(( + kind, + serde_json::json!({"horizon:add_to": targets, to: entries}), + )) +} + +/// Whether a modifier's load conditions hold: lithostitched's `predicate`, +/// and the loader's conditions (NeoForge's, else Fabric's). A condition +/// type not known here does not hold. +fn conditions_hold(v: &Value, loaded: &dyn Fn(&str) -> bool) -> bool { + let all = |list: &Value, test: &dyn Fn(&Value) -> bool| { + list.as_array().is_some_and(|a| a.iter().all(test)) + }; + fn predicate(p: &Value, loaded: &dyn Fn(&str) -> bool) -> bool { + let test = |q: &Value| predicate(q, loaded); + let list = &p["predicates"]; + match p["type"] + .as_str() + .map(|t| t.trim_start_matches("lithostitched:")) + { + Some("true") => true, + Some("mod_loaded") => p["mod_id"].as_str().is_some_and(loaded), + Some("not") => !predicate(&p["predicate"], loaded), + Some("all_of") => list.as_array().is_some_and(|a| a.iter().all(test)), + Some("any_of") => list.as_array().is_some_and(|a| a.iter().any(test)), + _ => false, + } + } + fn neoforge(c: &Value, loaded: &dyn Fn(&str) -> bool) -> bool { + let test = |q: &Value| neoforge(q, loaded); + match c["type"].as_str() { + Some("neoforge:true") => true, + Some("neoforge:mod_loaded") => c["modid"].as_str().is_some_and(loaded), + Some("neoforge:not") => !neoforge(&c["value"], loaded), + Some("neoforge:and") => c["values"].as_array().is_some_and(|a| a.iter().all(test)), + Some("neoforge:or") => c["values"].as_array().is_some_and(|a| a.iter().any(test)), + _ => false, + } + } + fn fabric(c: &Value, loaded: &dyn Fn(&str) -> bool) -> bool { + let test = |q: &Value| fabric(q, loaded); + let mods = || { + c["values"] + .as_array() + .into_iter() + .flatten() + .map(Value::as_str) + }; + match c["condition"].as_str() { + Some("fabric:true") => true, + Some("fabric:all_mods_loaded") => mods().all(|m| m.is_some_and(loaded)), + Some("fabric:any_mods_loaded") => mods().any(|m| m.is_some_and(loaded)), + Some("fabric:not") => !fabric(&c["value"], loaded), + Some("fabric:and") => c["values"].as_array().is_some_and(|a| a.iter().all(test)), + Some("fabric:or") => c["values"].as_array().is_some_and(|a| a.iter().any(test)), + _ => false, + } + } + let litho = v.get("predicate").is_none_or(|p| predicate(p, loaded)); + let loader = match ( + v.get("neoforge:conditions"), + v.get("fabric:load_conditions"), + ) { + (Some(c), _) => all(c, &|c| neoforge(c, loaded)), + // One condition or a list of them. + (None, Some(c)) if c.is_array() => all(c, &|c| fabric(c, loaded)), + (None, Some(c)) => fabric(c, loaded), + (None, None) => true, + }; + litho && loader +} + +/// ChoiceTheorem's Overhauled Village's villages and outposts, which it adds +/// to vanilla's `villages` and `pillager_outposts` sets in Java code +/// (`CTOV.registerstructure`, through lithostitched), with its default +/// config: every village type in three sizes, weighted 10, 4 and 1, and +/// every outpost weighted 1. Vanilla's own entries stay (weight 1 each). +const CTOV_VILLAGES: [&str; 21] = [ + "beach", + "christmas", + "desert", + "desert_oasis", + "dark_forest", + "jungle", + "jungle_tree", + "mesa", + "mesa_fortified", + "mountain", + "mountain_alpine", + "mushroom", + "plains", + "plains_fortified", + "savanna", + "savanna_na", + "snowy_igloo", + "swamp", + "swamp_fortified", + "taiga", + "taiga_fortified", +]; +const CTOV_OUTPOSTS: [&str; 11] = [ + "beach", + "dark_forest", + "desert", + "jungle", + "badlands", + "mountain", + "plains", + "savanna", + "snowy", + "swamp", + "taiga", +]; + +/// The entries a mod adds to other structure sets in Java code, as its +/// default config has them: (file name, set, `[(structure, weight)]`). +/// Lithostitched appends them in the order of a hash map of every modifier +/// in the pack, which carry cannot know; they are written in the order the +/// mod registers them. Each set picks by weight, so how often each starts +/// is the same. +pub fn code_set_entries(mod_id: &str) -> Vec<(&'static str, &'static str, Vec<(String, u32)>)> { + match mod_id { + "ctov" => { + let outposts = CTOV_OUTPOSTS + .iter() + .map(|v| (format!("ctov:pillager_outpost_{v}"), 1)) + .collect(); + let villages = [("small", 10), ("medium", 4), ("large", 1)] + .into_iter() + .flat_map(|(size, weight)| { + CTOV_VILLAGES + .iter() + .map(move |v| (format!("ctov:{size}/village_{v}"), weight)) + }) + .collect(); + vec![ + ("pillager_outposts", "minecraft:pillager_outposts", outposts), + ("villages", "minecraft:villages", villages), + ] + } + _ => Vec::new(), + } } /// Rewrites one `data/<ns>/worldgen/<kind>/...` file in place; whether it @@ -675,6 +875,88 @@ mod tests { assert_eq!(report.mapped, 0); } + #[test] + fn modifiers_add_to_sets_and_pools() { + let mut report = Upgrade::default(); + let only_fd = |m: &str| m == "farmersdelight"; + let set = json!({"type": "lithostitched:add_structure_set_entries", + "structure_sets": "minecraft:villages", + "entries": [{"structure": "x:village", "weight": 4}]}); + let (kind, added) = modifier(&set, &only_fd, &mut report).unwrap(); + assert_eq!(kind, "structure_set"); + assert_eq!( + added, + json!({"horizon:add_to": ["minecraft:villages"], + "structures": [{"structure": "x:village", "weight": 4}]}) + ); + // A compat addition holds only when its mod is ported along. + let pool = |modid: &str| { + json!({"type": "lithostitched:add_template_pool_elements", + "neoforge:conditions": [{"type": "neoforge:mod_loaded", "modid": modid}], + "fabric:load_conditions": {"condition": "fabric:all_mods_loaded", "values": ["other"]}, + "template_pools": ["x:houses", "y:houses"], + "elements": [{"weight": 5, "element": {"element_type": "minecraft:single_pool_element", + "location": "x:fd_farm", "projection": "rigid", "processors": "minecraft:empty"}}]}) + }; + let (kind, added) = modifier(&pool("farmersdelight"), &only_fd, &mut report).unwrap(); + assert_eq!(kind, "template_pool"); + assert_eq!(added["horizon:add_to"], json!(["x:houses", "y:houses"])); + assert_eq!(added["elements"][0]["weight"], 5); + assert!(modifier(&pool("create"), &only_fd, &mut report).is_none()); + // Fabric's conditions when there are no NeoForge ones; lithostitched's own. + let fabric = json!({"type": "lithostitched:add_structure_set_entries", + "fabric:load_conditions": [{"condition": "fabric:not", + "value": {"condition": "fabric:any_mods_loaded", "values": ["create"]}}], + "predicate": {"type": "lithostitched:all_of", "predicates": [ + {"type": "lithostitched:mod_loaded", "mod_id": "farmersdelight"}, + {"type": "lithostitched:true"}]}, + "structure_sets": "minecraft:villages", "entries": []}); + assert!(modifier(&fabric, &only_fd, &mut report).is_some()); + let tagged = json!({"type": "lithostitched:add_structure_set_entries", + "structure_sets": "#x:sets", "entries": []}); + assert!(modifier(&tagged, &only_fd, &mut report).is_none()); + let features = json!({"type": "lithostitched:add_features"}); + assert!(modifier(&features, &only_fd, &mut report).is_none()); + assert_eq!( + report.added_to, + BTreeMap::from([ + ("minecraft:villages".into(), 1), + ("x:houses".into(), 1), + ("y:houses".into(), 1), + ]) + ); + assert_eq!( + report.modifiers_left, + BTreeMap::from([ + ("conditions".into(), 1), + ("lithostitched:add_features".into(), 1), + ("target".into(), 1), + ]) + ); + } + + #[test] + fn ctov_joins_vanillas_villages_and_outposts() { + let sets = code_set_entries("ctov"); + let (file, set, outposts) = &sets[0]; + assert_eq!( + (*file, *set), + ("pillager_outposts", "minecraft:pillager_outposts") + ); + assert_eq!(outposts.len(), 11); + assert!(outposts.iter().all(|(_, w)| *w == 1)); + let (_, set, villages) = &sets[1]; + assert_eq!(*set, "minecraft:villages"); + assert_eq!(villages.len(), 63); + assert_eq!(villages[0], ("ctov:small/village_beach".into(), 10)); + assert_eq!(villages[21], ("ctov:medium/village_beach".into(), 4)); + assert_eq!( + villages[62], + ("ctov:large/village_taiga_fortified".into(), 1) + ); + assert!(code_set_entries("mvs").is_empty()); + } + #[test] fn convention_tags_include_theirs() { let conventions = BTreeMap::from([ From 817a71ffa5c57fada9ee5a19a7f4e751486df187 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 06:09:46 +0200 Subject: [PATCH 079/163] Clients keep the light the server sends; the server sends light updates A remote client (a LAN guest, or the game on its server thread) threw away the light in each LevelChunkWithLight and relit the column and its neighbours itself. It now applies the sky and block layers as ClientPacketListener.applyLightData does, and relights only block changes, as vanilla's client does. The hub now sends ClientboundLightUpdatePacket for the light sections that changed in a column to the players for whom it is on the tracked border (ChunkHolder.broadcastChanges), so light from blocks a guest doesn't track reaches it. horizon-ctl gains 'light X1 Y1 Z1 X2 Y2 Z2', and lan_e2e a 'light' check comparing the guest's light with the host's. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../src/bin/horizon-ctl/commands.rs | 4 + crates/horizon-client/src/game.rs | 1 + crates/horizon-client/src/game/agent.rs | 38 +++++- crates/horizon-client/src/game/lan.rs | 2 + crates/horizon-client/src/game/remote.rs | 60 ++++++++++ crates/horizon-client/src/lan/chunks.rs | 27 +++++ crates/horizon-client/src/lan/hub.rs | 41 +++++++ crates/horizon-client/src/light.rs | 113 ++++++++++++++++++ crates/horizon-client/src/save.rs | 27 +---- crates/horizon-client/src/streaming.rs | 33 ++++- crates/horizon-client/src/world.rs | 5 + docs/native-client.md | 2 +- tools/lan_e2e.py | 73 ++++++++++- 13 files changed, 394 insertions(+), 32 deletions(-) diff --git a/crates/horizon-client/src/bin/horizon-ctl/commands.rs b/crates/horizon-client/src/bin/horizon-ctl/commands.rs index c5e716a03..3e47a0545 100644 --- a/crates/horizon-client/src/bin/horizon-ctl/commands.rs +++ b/crates/horizon-client/src/bin/horizon-ctl/commands.rs @@ -187,6 +187,10 @@ pub const COMMANDS: &[Cmd] = &[ &[opt("radius", Ty::Num, "search radius in blocks (default 32)"), opt("type", Ty::Str, "entity type filter")], mcp: true, local: false), cmd!("block", Observe, "block X Y Z", "the block state at a position", "", ["horizon-ctl block 10 64 -3"], &BLOCK_XYZ, mcp: true, local: false), + 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), 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), diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 54d032d20..9bf2096aa 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -6634,6 +6634,7 @@ impl Game<'_> { world.weather = self.world.weather; // An open hub keeps hearing the new level's block changes. world.block_log = self.world.block_log.as_ref().map(|_| Vec::new()); + world.light_log = self.world.light_log.as_ref().map(|_| Default::default()); // The sculk tables' watched blocks are built once per game. world.watched = std::mem::take(&mut self.world.watched); self.streaming = streaming; diff --git a/crates/horizon-client/src/game/agent.rs b/crates/horizon-client/src/game/agent.rs index 8a6b54650..b11fdd552 100644 --- a/crates/horizon-client/src/game/agent.rs +++ b/crates/horizon-client/src/game/agent.rs @@ -4,7 +4,13 @@ //! take time run as a task advanced every frame and reply when they finish or //! time out, so `horizon-ctl break 10 64 3` returns what the block dropped. use super::{Game, Screen}; -use horizon_client::{Result, block_entity_anim::Ticker, items::ItemStack, widgets}; +use horizon_client::{ + Result, + block_entity_anim::Ticker, + chunk::{MIN_Y, SECTIONS}, + items::ItemStack, + widgets, +}; use horizon_core::geometry::Vec3; use horizon_world::registry::BlockStateId; use serde_json::{Value, json}; @@ -27,6 +33,7 @@ pub(super) const HELP: &[&str] = &[ "entities [RADIUS] [TYPE] mobs, dropped items and orbs near the player, nearest first", "block X Y Z the block state at a position", "blocks X1 Y1 Z1 X2 Y2 Z2 the non-air blocks of a box (at most 32768 blocks)", + "light X1 Y1 Z1 X2 Y2 Z2 the stored sky and block light of a box (at most 32768 blocks)", "find-block BLOCK [RADIUS] the nearest loaded blocks of a kind (default radius 32)", "inventory hotbar, main inventory, armor, offhand and carried stack", "screen the open screen or menu, its slots and its buttons", @@ -962,6 +969,35 @@ impl Game<'_> { } ok(json!({ "from": lo, "to": hi, "counts": census, "blocks": list })) } + "light" => { + self.need_world()?; + let (p, q) = (a.block_pos(0)?, a.block_pos(3)?); + let lo = [0, 1, 2].map(|i| p[i].min(q[i])); + let hi = [0, 1, 2].map(|i| p[i].max(q[i])); + let volume: i64 = (0..3).map(|i| i64::from(hi[i] - lo[i] + 1)).product(); + if volume > 32768 { + return Err(format!("{volume} blocks; at most 32768 per request").into()); + } + // One hex digit per block, x fastest, then z, then y; `.` + // outside the loaded chunks. + let (mut sky, mut block) = (String::new(), String::new()); + for y in lo[1]..=hi[1] { + for z in lo[2]..=hi[2] { + for x in lo[0]..=hi[0] { + let packed = self + .world + .chunks + .get(&(x >> 4, z >> 4)) + .filter(|_| (MIN_Y..MIN_Y + SECTIONS as i32 * 16).contains(&y)) + .map(|c| c.light(x & 15, y, z & 15)); + let digit = |v: u8| char::from_digit(u32::from(v), 16).unwrap_or('.'); + sky.push(packed.map_or('.', |v| digit(v >> 4))); + block.push(packed.map_or('.', |v| digit(v & 15))); + } + } + } + ok(json!({ "from": lo, "to": hi, "sky": sky, "block": block })) + } "find-block" => { self.need_world()?; let want = namespaced(a.get(0, "BLOCK")?); diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index 114330e51..d35bf787a 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -504,6 +504,7 @@ impl Game<'_> { let hub = Hub::new(lan, sync, encoder, config); let port = hub.lan.port; self.world.block_log = Some(Vec::new()); + self.world.light_log = Some(Default::default()); self.lan = Some(LanHost { hub, settings: LanSettings { port, ..settings }, @@ -553,6 +554,7 @@ impl Game<'_> { // Give the writer threads a moment to flush the disconnect packets. std::thread::sleep(std::time::Duration::from_millis(100)); self.world.block_log = None; + self.world.light_log = None; self.audio.capture = None; self.lan_events.clear(); self.streaming.extra.clear(); diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 474e943c0..680360c93 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -49,6 +49,9 @@ fn remote_text(tag: &Tag) -> horizon_client::text::Text { comp_text(&tag_to_json(tag)) } +/// A section's sky and block light layers from the wire. +type LightLayers = (Option<Vec<u8>>, Option<Vec<u8>>); + /// Streaming needs a generator; a server world never generates. struct NoTerrain; impl ChunkGenerator for NoTerrain { @@ -771,8 +774,64 @@ impl Game<'_> { PalettedContainer::from_values(BIOME_STRATEGY, &cells); } } + // ClientPacketListener.applyLightData: the column keeps the light + // the server sent; nothing is relit. + let (layers, above) = self.wire_light(&p.light); + let sky = r.dimension.has_skylight; + horizon_client::light::light_from_layers(&mut chunk, &layers, above, sky); Ok(chunk) } + /// `ClientPacketListener.readSectionList`: the sky and block layers of a + /// light packet, by section of the client's column, and the sky light + /// above the column's top section (from the light section just above + /// it, else open sky). + fn wire_light( + &self, + light: &horizon_protocol::chunk::LightData, + ) -> (Vec<LightLayers>, [u8; 256]) { + let mut layers: Vec<LightLayers> = vec![(None, None); SECTIONS]; + let Some(r) = self.remote.as_ref() else { + return (layers, [0; 256]); + }; + let sky = r.dimension.has_skylight; + let mut above = [if sky { 15 } else { 0 }; 256]; + // Light section b is the dimension's section b - 1. + let first = (r.dimension.min_y - MIN_Y).div_euclid(16) - 1; + for (b, layer) in light + .layers(r.dimension.sections() + 2) + .into_iter() + .enumerate() + { + let si = first + b as i32; + if (0..SECTIONS as i32).contains(&si) { + layers[si as usize] = layer; + } else if si == SECTIONS as i32 + && sky + && let Some(l) = &layer.0 + { + for (i, a) in above.iter_mut().enumerate() { + *a = (l[i >> 1] >> ((i & 1) * 4)) & 15; + } + } + } + (layers, above) + } + /// `handleLightUpdatePacket`: the sections it names take its light. + fn remote_light_update(&mut self, p: &play::LightUpdate) { + let Some(sky) = self.remote.as_ref().map(|r| r.dimension.has_skylight) else { + return; + }; + if !self.world.chunks.contains_key(&(p.x, p.z)) { + return; + } + let (layers, _) = self.wire_light(&p.light); + let Some(chunk) = self.world.chunks.get_mut(&(p.x, p.z)) else { + return; + }; + let changed = + horizon_client::light::update_light_layers(Arc::make_mut(chunk), &layers, sky); + Streaming::light_updated(&mut self.world, p.x, p.z, &changed); + } /// `ClientChunkCache.Storage.inRange`: within the storage around the /// view centre, `calculateStorageRange` (the server's radius, at least /// two, plus three) chunks each way. @@ -1219,6 +1278,7 @@ impl Game<'_> { } Err(e) => log::warn!("Horizon: chunk {} {}: {e}", p.x, p.z), }, + C::LightUpdate(p) => self.remote_light_update(&p), C::ForgetLevelChunk(p) => { let [x, z] = p.pos; self.streaming.forget(&mut self.world, x, z); diff --git a/crates/horizon-client/src/lan/chunks.rs b/crates/horizon-client/src/lan/chunks.rs index d6a7dc3a1..a9cf57a7d 100644 --- a/crates/horizon-client/src/lan/chunks.rs +++ b/crates/horizon-client/src/lan/chunks.rs @@ -480,6 +480,33 @@ impl ChunkEncoder { w.data } + /// ClientboundLightUpdatePacket for the light sections over `changed` (a + /// bit per section of the column, `sectionLightChanged`), as vanilla's + /// `ClientboundLightUpdatePacketData` writes them, with both kinds of + /// each section (Horizon's light engine doesn't tell them apart; the + /// client keeps the same light either way). A section changed as its + /// last block went (light dimming around a removed block) is sent too: + /// a client not tracking the block would otherwise keep its old light. + pub fn light_update(&self, chunk: &Chunk, changed: u32) -> Vec<u8> { + let first = self.sections.start; + let lights: Vec<(usize, SectionLight)> = self + .light_sections(chunk, u64::MAX) + .into_iter() + .filter(|&(b, _)| { + // Light section b holds the column's section first + b - 1. + (1..=self.sections.len()).contains(&b) && changed >> (first + b - 1) & 1 != 0 + }) + .collect(); + horizon_protocol::packets::play::Clientbound::LightUpdate( + horizon_protocol::packets::play::LightUpdate { + x: chunk.x, + z: chunk.z, + light: light_data_of(&lights, self.sky), + }, + ) + .encode() + } + pub fn encode( &self, chunk: &Chunk, diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index faff066ab..c88292787 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -988,18 +988,23 @@ impl Hub { .any(|g| g.dimension == self.config.dimension) { let _ = ctx.world.block_log.take(); + let _ = ctx.world.light_log.take(); } return events; } if ctx.world.block_log.is_none() { ctx.world.block_log = Some(Vec::new()); } + if ctx.world.light_log.is_none() { + ctx.world.light_log = Some(Default::default()); + } self.sync_world(ctx); for i in 0..self.guests.len() { if self.here(&self.guests[i]) { self.update_chunks(i, ctx); } } + self.broadcast_light_changes(ctx.world); self.broadcast_block_changes(ctx.world); // ServerGamePacketListenerImpl.tick: the actions handled since the last tick are // acknowledged after the block changes they made were sent, so a client's predicted @@ -1234,6 +1239,42 @@ impl Hub { } } + /// `ChunkHolder.broadcastChanges`' light part: the light sections that + /// changed in a column go to the players for whom it is on the border of + /// what they track (`ChunkMap.isChunkOnTrackedBorder`); the others light + /// the blocks they are sent themselves. + fn broadcast_light_changes(&mut self, world: &mut World) { + let Some(log) = world.light_log.as_mut() else { + return; + }; + if log.is_empty() { + return; + } + let mut changes: Vec<((i32, i32), u32)> = log.drain().collect(); + changes.sort_unstable(); + for ((x, z), sections) in changes { + let tracked = |g: &Guest, x: i32, z: i32| g.sent_chunks.contains(&(x, z)); + let viewers: Vec<usize> = (0..self.guests.len()) + .filter(|&i| { + let g = &self.guests[i]; + self.here(g) + && tracked(g, x, z) + && (-1..=1).any(|dz| (-1..=1).any(|dx| !tracked(g, x + dx, z + dz))) + }) + .collect(); + if viewers.is_empty() { + continue; + } + let Some(chunk) = world.chunks.get(&(x, z)) else { + continue; + }; + let body = self.encoder.light_update(chunk, sections); + for &i in &viewers { + self.guests[i].sender.send(body.clone()); + } + } + } + fn broadcast_block_changes(&mut self, world: &mut World) { let Some(log) = world.block_log.as_mut() else { return; diff --git a/crates/horizon-client/src/light.rs b/crates/horizon-client/src/light.rs index dcf4633a9..7a939b308 100644 --- a/crates/horizon-client/src/light.rs +++ b/crates/horizon-client/src/light.rs @@ -381,6 +381,81 @@ pub fn apply_relighting(chunk: &mut Chunk, lights: Vec<Light>) -> Vec<(i32, i32, changed } +/// `DataLayer.get`: the nibble at index `i` (`y << 8 | z << 4 | x`), low first. +#[inline] +fn nibble(layer: &[u8], i: usize) -> u8 { + (layer[i >> 1] >> ((i & 1) * 4)) & 15 +} + +/// A column's light as vanilla stores it, two DataLayers per section (sky, +/// block; `layers[i]` for section `i`, `None` where no layer is stored), into +/// the sections' packed light, which then needs no light job. A missing sky +/// layer repeats the bottom layer of the nearest stored one above it, and +/// `above` (per `z << 4 | x`) above the highest +/// (`SkyLightSectionStorage.getLightValue`); a missing block layer is dark. +pub fn light_from_layers<L: AsRef<[u8]>>( + chunk: &mut Chunk, + layers: &[(Option<L>, Option<L>)], + mut above: [u8; 256], + sky_light: bool, +) { + for (si, (sky, block)) in layers.iter().enumerate().take(SECTIONS).rev() { + let sky = sky.as_ref().filter(|_| sky_light); + let section = Arc::make_mut(&mut chunk.sections[si]); + if sky.is_none() && block.is_none() && above.iter().all(|&v| v == above[0]) { + section.light = Light::Uniform(above[0] << 4); + section.compact(); + continue; + } + let mut data = Box::new([0u8; 4096]); + for (i, packed) in data.iter_mut().enumerate() { + let s = sky.map_or(above[i & 255], |a| nibble(a.as_ref(), i)); + let b = block.as_ref().map_or(0, |a| nibble(a.as_ref(), i)); + *packed = s << 4 | b; + } + for (i, a) in above.iter_mut().enumerate() { + *a = data[i] >> 4; + } + section.light = Light::Full(data); + section.compact(); + } + chunk.lit = true; + chunk.light_loaded = true; +} + +/// A light update's layers (`LevelLightEngine.queueSectionData`): each one +/// given replaces that kind of light in its section, the other kind stays. +/// Returns the sections whose light changed. +pub fn update_light_layers<L: AsRef<[u8]>>( + chunk: &mut Chunk, + layers: &[(Option<L>, Option<L>)], + sky_light: bool, +) -> Vec<usize> { + let mut changed = Vec::new(); + for (si, (sky, block)) in layers.iter().enumerate().take(SECTIONS) { + let sky = sky.as_ref().filter(|_| sky_light); + if sky.is_none() && block.is_none() { + continue; + } + let old = &chunk.sections[si].light; + let mut data = Box::new([0u8; 4096]); + for (i, packed) in data.iter_mut().enumerate() { + let was = old.get(i); + let s = sky.map_or(was >> 4, |a| nibble(a.as_ref(), i)); + let b = block.as_ref().map_or(was & 15, |a| nibble(a.as_ref(), i)); + *packed = s << 4 | b; + } + if (0..4096).all(|i| old.get(i) == data[i]) { + continue; + } + let section = Arc::make_mut(&mut chunk.sections[si]); + section.light = Light::Full(data); + section.compact(); + changed.push(si); + } + changed +} + /// Resident chunks the incremental relighter reads and writes. pub trait LightWorld { fn state(&self, x: i32, y: i32, z: i32) -> Option<u32>; @@ -809,6 +884,44 @@ mod tests { assert!(copied <= 3, "{copied} sections copied"); } + #[test] + fn stored_layers_fill_the_column_as_vanilla_reads_them() { + // Section 10's sky layer is 7 on its bottom row and 3 above; no + // layers anywhere else; a block layer of 5 in section 2. + let mut sky = vec![0x33u8; 2048]; + sky[..128].fill(0x77); + let mut layers: Vec<(Option<Vec<u8>>, Option<Vec<u8>>)> = vec![(None, None); SECTIONS]; + layers[10].0 = Some(sky); + layers[2].1 = Some(vec![0x55; 2048]); + let mut chunk = Chunk::empty(0, 0); + light_from_layers(&mut chunk, &layers, [15; 256], true); + let at = |c: &Chunk, si: usize, i: usize| c.sections[si].light(i); + assert!(chunk.lit && chunk.light_loaded); + assert!( + matches!(chunk.sections[11].light, Light::Uniform(0xF0)), + "above: open sky" + ); + assert_eq!((at(&chunk, 10, 0), at(&chunk, 10, 4095)), (0x70, 0x30)); + // Below, each section repeats the bottom row of the stored one above. + assert!(matches!(chunk.sections[9].light, Light::Uniform(0x70))); + assert_eq!(at(&chunk, 2, 100), 0x75, "block light only where stored"); + assert!(matches!(chunk.sections[0].light, Light::Uniform(0x70))); + + // A light update replaces one kind of light in the sections it names. + let mut update: Vec<(Option<Vec<u8>>, Option<Vec<u8>>)> = vec![(None, None); SECTIONS]; + update[2].1 = Some(vec![0; 2048]); + update[3].0 = Some(vec![0x77; 2048]); + let changed = update_light_layers(&mut chunk, &update, true); + assert_eq!(changed, vec![2]); + assert!(matches!(chunk.sections[2].light, Light::Uniform(0x70))); + update[3].0 = Some(vec![0xFF; 2048]); + assert_eq!( + update_light_layers(&mut chunk, &update, false), + Vec::<usize>::new(), + "no sky storage" + ); + } + #[test] fn empty_chunk_missing_neighbours_and_no_sky() { let mut chunk = Chunk::empty(0, 0); diff --git a/crates/horizon-client/src/save.rs b/crates/horizon-client/src/save.rs index c60da2caa..ccef3e567 100644 --- a/crates/horizon-client/src/save.rs +++ b/crates/horizon-client/src/save.rs @@ -1278,31 +1278,8 @@ pub fn load_light(tag: &Tag, chunk: &mut Chunk, sky_light: bool) { }; layers[si as usize] = (layer("SkyLight"), layer("BlockLight")); } - let sky_default = if sky_light { 15u8 } else { 0 }; - // Sky nibbles of the section above's bottom layer, going down. - let mut above: [u8; 256] = [sky_default; 256]; - for si in (0..SECTIONS).rev() { - let (sky, block) = layers[si]; - let mut data = Box::new([0u8; 4096]); - let nibble = |a: &[u8], i: usize| (a[i >> 1] >> ((i & 1) * 4)) & 15; - for (i, packed) in data.iter_mut().enumerate() { - let s = match sky { - Some(a) if sky_light => nibble(a, i), - _ => above[i & 255], - }; - let b = block.map_or(0, |a| nibble(a, i)); - *packed = s << 4 | b; - } - for (i, a) in above.iter_mut().enumerate() { - *a = data[i] >> 4; - } - let mut section = (*chunk.sections[si]).clone(); - section.light = Light::Full(data); - section.compact(); - chunk.sections[si] = Arc::new(section); - } - chunk.lit = true; - chunk.light_loaded = true; + let above = [if sky_light { 15 } else { 0 }; 256]; + crate::light::light_from_layers(chunk, &layers, above, sky_light); } type RegionCache = Mutex<HashMap<(i32, i32), Option<Arc<Mutex<RegionFile>>>>>; diff --git a/crates/horizon-client/src/streaming.rs b/crates/horizon-client/src/streaming.rs index bff0a8fd6..6acdcafd2 100644 --- a/crates/horizon-client/src/streaming.rs +++ b/crates/horizon-client/src/streaming.rs @@ -502,16 +502,38 @@ impl Streaming { } } } - /// A column received from a server: store it and relight it and its neighbours. + /// A column received from a server, with the light it sent + /// (`ClientPacketListener.handleLevelChunkWithLight`): nothing is + /// relit, and it and its neighbours remesh (`enableChunkLight`). pub fn insert_remote(&mut self, world: &mut World, chunk: Chunk) { let key = (chunk.x, chunk.z); - self.lit.remove(&key); self.lighting.remove(&key); + self.light_snapshots.remove(&key); world.chunks.insert(key, Arc::new(chunk)); + self.lit.insert(key); self.generated_total += 1; for dz in -1..=1 { for dx in -1..=1 { - world.dirty_light.insert((key.0 + dx, key.1 + dz)); + for sy in 0..SECTIONS as i32 { + world.dirty_sections.insert((key.0 + dx, sy, key.1 + dz)); + } + } + } + } + /// A server's light update for a resident column: the sections whose + /// light changed and their neighbours remesh + /// (`setSectionDirtyWithNeighbors`). + pub fn light_updated(world: &mut World, x: i32, z: i32, sections: &[usize]) { + for &sy in sections { + for dz in -1..=1 { + for dy in -1..=1 { + for dx in -1..=1 { + let s = sy as i32 + dy; + if (0..SECTIONS as i32).contains(&s) { + world.dirty_sections.insert((x + dx, s, z + dz)); + } + } + } } } } @@ -1148,6 +1170,11 @@ impl Streaming { /// Sections whose meshes sample a changed light value (faces and corners /// read light from neighbouring blocks). fn mark_light_changes(world: &mut World, changed: &[(i32, i32, i32)]) { + if let Some(log) = &mut world.light_log { + for &(x, y, z) in changed { + *log.entry((x >> 4, z >> 4)).or_default() |= 1 << ((y - crate::chunk::MIN_Y) >> 4); + } + } let mut last = None; for &(x, y, z) in changed { for dz in -1..=1 { diff --git a/crates/horizon-client/src/world.rs b/crates/horizon-client/src/world.rs index f6fbcd04d..efcbf9591 100644 --- a/crates/horizon-client/src/world.rs +++ b/crates/horizon-client/src/world.rs @@ -47,6 +47,10 @@ pub struct World { /// Every block position written since the log was last drained, kept /// only while the world is open to the network (see `lan`). pub block_log: Option<Vec<(i32, i32, i32)>>, + /// The sections whose light changed since the log was last drained, as + /// a bit per section of each column, kept while `block_log` is + /// (`ChunkHolder.sectionLightChanged`). + pub light_log: Option<crate::fast_hash::FxHashMap<(i32, i32), u32>>, /// The villager POIs of each section (`PoiManager`'s sections). pub pois: crate::poi_sections::PoiSections<crate::mobs::villager_brain::Poi>, } @@ -133,6 +137,7 @@ impl World { day_time: 1000, weather: Weather::default(), block_log: None, + light_log: None, pois: Default::default(), } } diff --git a/docs/native-client.md b/docs/native-client.md index 4911c8197..fcf28246a 100644 --- a/docs/native-client.md +++ b/docs/native-client.md @@ -109,7 +109,7 @@ game accepts, test hooks included. - **Observe:** `state` (position, rotation, velocity, health, food, saturation, XP, effects, game mode, dimension, time, weather, the screen and what the crosshair points at), `looking-at`, `entities [RADIUS] [TYPE]` (mobs with - ids and health, dropped items, orbs), `block X Y Z`, `blocks X1 Y1 Z1 X2 Y2 Z2`, + ids and health, dropped items, orbs), `block X Y Z`, `blocks X1 Y1 Z1 X2 Y2 Z2`, `light X1 Y1 Z1 X2 Y2 Z2`, `find-block BLOCK [RADIUS]`, `inventory` (stacks with their components as SNBT), `screen` (the open screen or title menu, its buttons and slots) and `messages` (chat, title, subtitle and action bar). diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index c306504ab..4d13b1c22 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -49,6 +49,9 @@ address. The script then checks, from both sides, what a guest's game used to ge guest as the host has them (kind, place, rotation, what they hold or wear, the variant). - projectiles: primed TNT (one falling), an end crystal and an arrow that lands reach the guest where the host has them; a falling block lands on both sides. +- light: the guest's light matches the host's: around a torch placed near it, under a roof and + once a block of the roof is removed under the sky, and in the last chunk it tracks next to + glowstone in a chunk it doesn't (only the server's light updates bring that one). Each check is reported on its own (a failing one doesn't stop the others) and the screenshots of both sides go to --out (host-*.png, guest-*.png). @@ -81,7 +84,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', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'objects', 'projectiles', 'effects', 'portals', 'distance'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'objects', 'projectiles', 'light', 'effects', 'portals', 'distance'] class Game: @@ -1201,6 +1204,71 @@ def check_projectiles(host, guest, out): return f'{len(theirs)} identical, fuses (host, guest) {fuses}' +def light_differences(host, guest, lo, hi): + """Positions of the box loaded on both sides, and those whose sky or block light differ.""" + h, g = host.raw('light', *lo, *hi), guest.raw('light', *lo, *hi) + both = [i for i in range(len(h['sky'])) if h['sky'][i] != '.' and g['sky'][i] != '.'] + differ = [i for i in both if (h['sky'][i], h['block'][i]) != (g['sky'][i], g['block'][i])] + return h, g, both, differ + + +def same_light(host, guest, lo, hi, what, ticks=100): + """Wait until the guest's light over the box is the host's; the number of positions compared.""" + for _ in range(ticks // 10): + h, g, both, differ = light_differences(host, guest, lo, hi) + if not differ: + assert both, f'{what}: no position of the box is loaded on both sides' + return len(both) + host.wait(10) + i = differ[0] + nx, nz = hi[0] - lo[0] + 1, hi[2] - lo[2] + 1 + pos = (lo[0] + i % nx, lo[1] + i // (nx * nz), lo[2] + i // nx % nz) + raise AssertionError(f'{what}: {len(differ)} of {len(both)} positions differ, first {pos}: host sky ' + f'{h["sky"][i]} block {h["block"][i]}, guest sky {g["sky"][i]} block {g["block"][i]}') + + +def check_light(host, guest, out): + gx, gy, gz = (int(v // 1) for v in pos_of(guest)) + results = {} + # A torch near the guest: the guest lights it itself, as vanilla's client does. + torch = (gx + 3, gy, gz + 3) + host('command', command=f'setblock {torch[0]} {torch[1]} {torch[2]} minecraft:torch') + try: + results['torch'] = same_light(host, guest, (gx - 12, gy - 1, gz - 12), (gx + 16, gy + 3, gz + 16), 'torch') + finally: + host('command', command=f'setblock {torch[0]} {torch[1]} {torch[2]} minecraft:air') + # A roof over the guest, then a hole in it: sky light falls through. + roof = f'{gx - 3} {gy + 4} {gz - 3} {gx + 3} {gy + 4} {gz + 3}' + box = (gx - 6, gy - 1, gz - 6), (gx + 6, gy + 5, gz + 6) + host('command', command=f'fill {roof} minecraft:stone') + try: + results['roof'] = same_light(host, guest, *box, 'roof') + host('command', command=f'setblock {gx} {gy + 4} {gz} minecraft:air') + results['hole'] = same_light(host, guest, *box, 'hole in the roof') + finally: + host('command', command=f'fill {roof} minecraft:air') + # The last chunk the guest tracks eastwards, and glowstone high up just past it in a chunk it + # doesn't track: the guest never sees that block, only the light updates of its border chunk. + y = 200 + row = guest.raw('light', gx, y, gz, gx + 16 * 24, y, gz)['sky'] + assert '.' in row, 'the guest has every chunk 24 chunks east' + untracked = (gx + row.index('.')) >> 4 + near = untracked * 16 + 1 + # On its server thread the host's own game is a client too, sent the same light updates. + if not SERVER_THREAD: + assert host.raw('light', near, y, gz, near, y, gz)['sky'] != '.', 'the host lacks the chunk past the guest' + host('command', command=f'setblock {near} {y} {gz} minecraft:glowstone') + try: + lo, hi = (untracked * 16 - 16, y - 3, gz - 8), (untracked * 16 - 1, y + 3, gz + 8) + results['border'] = same_light(host, guest, lo, hi, 'border chunk') + lit = guest.raw('light', near - 2, y, gz, near - 2, y, gz)['block'] + assert lit == 'd', f'the border chunk by the glowstone has block light {lit}, not 13' + finally: + host('command', command=f'setblock {near} {y} {gz} minecraft:air') + results['border_cleared'] = same_light(host, guest, lo, hi, 'border chunk without the glowstone') + return results + + CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'nametags': check_nametags, 'chest': check_chest, 'crafting': check_crafting, 'sign': check_sign, 'damage': check_damage, 'mobs': check_mobs, 'hazards': check_hazards, 'pvp': check_pvp, @@ -1209,7 +1277,8 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'recipes': check_recipes, 'trials': check_trials, 'walls': check_walls, 'effects': check_effects, 'portals': check_portals, 'distance': check_distance, 'clicks': check_clicks, 'sleep': check_sleep, 'push': check_push, 'eat': check_eat, - 'xp': check_xp, 'objects': check_objects, 'projectiles': check_projectiles} + 'xp': check_xp, 'objects': check_objects, 'projectiles': check_projectiles, + 'light': check_light} def run(ctl, out, resources, checks): From 8901a49d0b914f7812c4c1be204596f681d16593 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 09:40:55 +0200 Subject: [PATCH 080/163] Upload section meshes through a reused staging belt Queue::write_buffer creates a staging buffer for every call: on Metal a kernel call to make the buffer, then page faults while the mesh is copied into fresh memory. While exploring at render distance 32 the render thread made two such writes per uploaded section, plus one for its flat-draw ids. Section meshes and flat ids now go through their own StagingBelt (4 MiB mapped buffers, reused once the GPU has read them) into one encoder that the frame's submission runs ahead of its own commands. A page of the section arena that grows records its copy into that encoder too, so copies recorded before the grow reach the grown buffer. A frame that is not drawn still submits the copies, and more than 64 MiB of them are submitted early. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/gfx.rs | 71 ++++++++++++++++++--- crates/horizon-client/src/gfx/arena.rs | 84 ++++++++++++++++++------- crates/horizon-client/src/gfx/flat.rs | 12 +++- crates/horizon-client/src/gfx/upload.rs | 7 ++- 4 files changed, 141 insertions(+), 33 deletions(-) diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index be842c3c6..ce47eb659 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -107,6 +107,12 @@ struct SectionGpu { } /// Line segments the hit outline can hold. const MAX_OUTLINE_EDGES: u64 = 256; +/// Staging buffer size for section meshes: a frame of uploads while +/// exploring fits in a few. +const SECTION_UPLOAD_CHUNK: u64 = 4 << 20; +/// Section copies are submitted early past this many staged bytes, which +/// bounds the staging memory frames that are not drawn can hold. +const SECTION_COPY_LIMIT: u64 = 64 << 20; pub struct Frame<'a> { pub camera: DVec3, pub yaw: f32, @@ -319,6 +325,13 @@ pub struct Renderer { lightmap_sampler: wgpu::Sampler, animations: AnimatedSprites, uploads: upload::Uploads, + /// Section meshes are staged through their own belt into + /// `section_copies`, which the next submission runs ahead of the frame: + /// `Queue::write_buffer` would make a staging buffer per write. + section_uploads: upload::Uploads, + section_copies: Option<wgpu::CommandEncoder>, + /// Bytes staged in `section_copies`. + section_copy_bytes: u64, /// Whether `lightmap` holds `lightmap_pixels` yet. lightmap_uploaded: bool, sprite_minimum_size: u32, @@ -1726,6 +1739,7 @@ impl Renderer { .contains(wgpu::Features::INDIRECT_FIRST_INSTANCE); let world_post = world_post::Post::new(&device, config.format.remove_srgb_suffix()); let uploads = upload::Uploads::new(&device); + let section_uploads = upload::Uploads::with_chunk(&device, SECTION_UPLOAD_CHUNK); let panorama = panorama::Panorama::new( &device, &queue, @@ -1800,6 +1814,9 @@ impl Renderer { lightmap_sampler, animations: AnimatedSprites::new(animations, sprite_size, sprite_mips), uploads, + section_uploads, + section_copies: None, + section_copy_bytes: 0, lightmap_uploaded: false, sprite_minimum_size, indices, @@ -2004,14 +2021,20 @@ impl Renderer { self.indices = Self::quad_indices(&self.device, self.index_quads); } let vertices = (mesh.solid.len() + mesh.translucent.len()) as u64; + let encoder = self.section_copies.get_or_insert_with(|| { + self.device + .create_command_encoder(&wgpu::CommandEncoderDescriptor { + label: Some("Section uploads"), + }) + }); // With video and system memory both full, the section is not drawn. - let Some((page, start)) = self.arena.alloc(&self.device, &self.queue, vertices) else { + let Some((page, start)) = self.arena.alloc(&self.device, encoder, vertices) else { return; }; let sorted_indices = if translucent > 0 { let indices = self.sorted_indices - .alloc(&self.device, &self.queue, u64::from(translucent) * 6); + .alloc(&self.device, encoder, u64::from(translucent) * 6); if indices.is_none() { self.arena.release(page, start, vertices); return; @@ -2020,22 +2043,35 @@ impl Renderer { } else { None }; - let flat_id = self - .flat - .as_mut() - .map(|f| f.add(&self.device, &self.queue, page, start, vertices)); + let flat_id = self.flat.as_mut().map(|f| { + f.add( + &self.device, + encoder, + &mut self.section_uploads, + page, + start, + vertices, + ) + }); let stride = std::mem::size_of::<TerrainVertex>() as u64; for (offset, part) in [(0, &mesh.solid), (mesh.solid.len(), &mesh.translucent)] { if !part.is_empty() { let bytes: &[u8] = bytemuck::cast_slice(part); self.uploaded_bytes += bytes.len() as u64; - self.queue.write_buffer( + self.section_copy_bytes += bytes.len() as u64; + self.section_uploads.buffer( + encoder, self.arena.buffer(page), (start + offset as u64) * stride, bytes, ); } } + if self.section_copy_bytes >= SECTION_COPY_LIMIT + && let Some(copies) = self.take_section_copies() + { + self.queue.submit([copies]); + } self.sections.insert( key, SectionGpu { @@ -2057,6 +2093,13 @@ impl Renderer { }, ); } + /// The section copies recorded since the last submission, closed. + fn take_section_copies(&mut self) -> Option<wgpu::CommandBuffer> { + let encoder = self.section_copies.take()?; + self.section_copy_bytes = 0; + self.section_uploads.finish(&encoder); + Some(encoder.finish()) + } /// Draws `count` section draws from `first` with the arena and section /// origins bound: one indirect multi-draw, or a loop without it. /// Consecutive draws in one arena page share a vertex buffer binding, @@ -2286,6 +2329,14 @@ impl Renderer { ); } pub fn render(&mut self, frame: &Frame) -> Result<bool> { + let rendered = self.draw_frame(frame); + // A frame that was not drawn still submits the section copies. + if let Some(copies) = self.take_section_copies() { + self.queue.submit([copies]); + } + rendered + } + fn draw_frame(&mut self, frame: &Frame) -> Result<bool> { self.arena.trim(); self.sorted_indices.trim(); if let Some(flat) = &mut self.flat { @@ -3159,7 +3210,11 @@ impl Renderer { .map(|path| (path, self.copy_frame(&mut encoder, &target_texture))); self.uploads.finish(&encoder); let commands = crate::spans::time("encode", || encoder.finish()); - let submission = crate::spans::time("submit", || self.queue.submit([commands])); + // The section copies run first: this frame draws what they write. + let copies = self.take_section_copies(); + let submission = crate::spans::time("submit", || { + self.queue.submit(copies.into_iter().chain([commands])) + }); if let Some(timer) = &mut self.gpu_timer { timer.submitted(); timer.collect(&self.device, &mut self.gpu_times); diff --git a/crates/horizon-client/src/gfx/arena.rs b/crates/horizon-client/src/gfx/arena.rs index 74d3b98e9..8da835aa2 100644 --- a/crates/horizon-client/src/gfx/arena.rs +++ b/crates/horizon-client/src/gfx/arena.rs @@ -155,12 +155,14 @@ impl Arena { .buffer } /// A range of `vertices`: (page, first vertex). Grows the newest page - /// (copying its contents on the GPU) or starts a new one when nothing - /// free is large enough; `None` when no memory is left for it. + /// (copying its contents on the GPU, in `encoder`) or starts a new one + /// when nothing free is large enough; `None` when no memory is left for + /// it. Writes to the arena belong in `encoder` too, so that those + /// recorded before a grow reach the grown page. pub fn alloc( &mut self, device: &wgpu::Device, - queue: &wgpu::Queue, + encoder: &mut wgpu::CommandEncoder, vertices: u64, ) -> Option<(u32, u64)> { let len = Self::span(vertices).min(self.page_limit); @@ -178,7 +180,7 @@ impl Arena { let current = page.capacity; let grown = (current * 2).max(current + len).min(self.page_limit); if (grown - current >= len || grown == self.page_limit) - && self.grow(device, queue, last, grown) + && self.grow(device, encoder, last, grown) && let Some(start) = self.pages[last].as_mut().unwrap().free.take(len) { return Some((last as u32, start)); @@ -228,7 +230,7 @@ impl Arena { fn grow( &mut self, device: &wgpu::Device, - queue: &wgpu::Queue, + encoder: &mut wgpu::CommandEncoder, page: usize, capacity: u64, ) -> bool { @@ -237,12 +239,8 @@ impl Arena { return false; }; let old = self.pages[page].as_mut().expect("live arena page"); - let mut encoder = device.create_command_encoder(&wgpu::CommandEncoderDescriptor { - label: Some("Grow section arena"), - }); + // Copies recorded for the old buffer run before this one. encoder.copy_buffer_to_buffer(&old.buffer, 0, &buffer, 0, old.capacity * self.stride); - // Writes queued for the old buffer run before this copy. - queue.submit([encoder.finish()]); let previous = old.capacity; old.buffer = buffer; old.capacity = capacity; @@ -304,6 +302,50 @@ mod tests { .ok() } + /// `Arena::alloc`, with the copies of a grow submitted at once. + fn alloc( + arena: &mut Arena, + device: &wgpu::Device, + queue: &wgpu::Queue, + vertices: u64, + ) -> Option<(u32, u64)> { + let mut encoder = device.create_command_encoder(&Default::default()); + let range = arena.alloc(device, &mut encoder, vertices); + queue.submit([encoder.finish()]); + range + } + + #[test] + fn writes_recorded_before_a_grow_reach_the_grown_page() { + let Some((device, queue)) = device() else { + eprintln!("no GPU adapter: skipped"); + return; + }; + let mut arena = Arena::indices(&device, GRAIN, false); + let mut uploads = super::super::upload::Uploads::new(&device); + let mut encoder = device.create_command_encoder(&Default::default()); + let (page, start) = arena.alloc(&device, &mut encoder, GRAIN).unwrap(); + uploads.buffer( + &mut encoder, + arena.buffer(page), + start * 4, + &7u32.to_le_bytes(), + ); + // The page is full: the next range grows it, in the same encoder. + let (grown, next) = arena.alloc(&device, &mut encoder, GRAIN).unwrap(); + assert_eq!(grown, page); + uploads.buffer( + &mut encoder, + arena.buffer(grown), + next * 4, + &9u32.to_le_bytes(), + ); + uploads.finish(&encoder); + queue.submit([encoder.finish()]); + assert_eq!(read(&device, &queue, arena.buffer(page), start * 4), 7); + assert_eq!(read(&device, &queue, arena.buffer(page), next * 4), 9); + } + #[test] fn empty_pages_are_reclaimed_without_moving_live_ranges() { let Some((device, queue)) = device() else { @@ -313,9 +355,9 @@ mod tests { let mut arena = Arena::new(&device, 4, GRAIN); arena.page_limit = 2 * GRAIN; assert_eq!(arena.bytes(), 0); - let (first, a) = arena.alloc(&device, &queue, GRAIN).unwrap(); - let (_, b) = arena.alloc(&device, &queue, GRAIN).unwrap(); - let (live, c) = arena.alloc(&device, &queue, 2 * GRAIN).unwrap(); + let (first, a) = alloc(&mut arena, &device, &queue, GRAIN).unwrap(); + let (_, b) = alloc(&mut arena, &device, &queue, GRAIN).unwrap(); + let (live, c) = alloc(&mut arena, &device, &queue, 2 * GRAIN).unwrap(); let buffer = arena.buffer(live).clone(); let data = [1u8, 2, 3, 4]; queue.write_buffer(&buffer, c * 4, &data); @@ -327,7 +369,7 @@ mod tests { arena.trim(); assert_eq!(arena.bytes(), 2 * GRAIN * 4); assert_eq!(arena.buffer(live), &buffer); - let (reused, d) = arena.alloc(&device, &queue, GRAIN).unwrap(); + let (reused, d) = alloc(&mut arena, &device, &queue, GRAIN).unwrap(); assert_eq!(reused, first); let (tx, rx) = std::sync::mpsc::channel(); @@ -356,11 +398,11 @@ mod tests { Arena::new(&device, 28, GRAIN), Arena::indices(&device, GRAIN, false), ] { - arena.alloc(&device, &queue, GRAIN).unwrap(); + alloc(&mut arena, &device, &queue, GRAIN).unwrap(); assert_eq!(arena.bytes(), arena.stride * GRAIN); arena.clear(); assert_eq!(arena.bytes(), 0); - assert_eq!(arena.alloc(&device, &queue, GRAIN), Some((0, 0))); + assert_eq!(alloc(&mut arena, &device, &queue, GRAIN), Some((0, 0))); assert_eq!(arena.bytes(), arena.stride * GRAIN); } } @@ -414,12 +456,12 @@ mod tests { return; } let mut arena = Arena::indices(&device, GRAIN, false); - let (page, start) = arena.alloc(&device, &queue, GRAIN).unwrap(); + let (page, start) = alloc(&mut arena, &device, &queue, GRAIN).unwrap(); queue.write_buffer(arena.buffer(page), start * 4, &7u32.to_le_bytes()); arena.video_memory_full = true; // The full page can't grow in video memory: it moves to system // memory with its contents, and new ranges come from there. - let (grown, next) = arena.alloc(&device, &queue, GRAIN).unwrap(); + let (grown, next) = alloc(&mut arena, &device, &queue, GRAIN).unwrap(); assert!(arena.spilled); assert_eq!(grown, page); assert!( @@ -439,13 +481,13 @@ mod tests { return; }; let mut arena = Arena::indices(&device, GRAIN, false); - arena.alloc(&device, &queue, GRAIN).unwrap(); + alloc(&mut arena, &device, &queue, GRAIN).unwrap(); arena.video_memory_full = true; // Without mappable primary buffers nothing can spill: the request // fails, and the arena keeps what it has. - assert_eq!(arena.alloc(&device, &queue, GRAIN), None); + assert_eq!(alloc(&mut arena, &device, &queue, GRAIN), None); assert_eq!(arena.bytes(), GRAIN * 4); arena.release(0, 0, GRAIN); - assert_eq!(arena.alloc(&device, &queue, GRAIN), Some((0, 0))); + assert_eq!(alloc(&mut arena, &device, &queue, GRAIN), Some((0, 0))); } } diff --git a/crates/horizon-client/src/gfx/flat.rs b/crates/horizon-client/src/gfx/flat.rs index b867a42c2..ff58e3ca6 100644 --- a/crates/horizon-client/src/gfx/flat.rs +++ b/crates/horizon-client/src/gfx/flat.rs @@ -262,11 +262,12 @@ impl Flat { } } /// A section uploaded to `vertices` vertices from `start` of `page`: its - /// id, which its blocks now name. + /// id, which its blocks now name (written through `uploads` in `encoder`). pub fn add( &mut self, device: &wgpu::Device, - queue: &wgpu::Queue, + encoder: &mut wgpu::CommandEncoder, + uploads: &mut super::upload::Uploads, page: u32, start: u64, vertices: u64, @@ -290,7 +291,12 @@ impl Flat { }); let first = start / GRAIN; let ids = vec![id; vertices.div_ceil(GRAIN) as usize]; - queue.write_buffer(&table.blocks, first * 4, bytemuck::cast_slice(&ids)); + uploads.buffer( + encoder, + &table.blocks, + first * 4, + bytemuck::cast_slice(&ids), + ); id } pub fn remove(&mut self, id: u32) { diff --git a/crates/horizon-client/src/gfx/upload.rs b/crates/horizon-client/src/gfx/upload.rs index d42958862..a60791d4c 100644 --- a/crates/horizon-client/src/gfx/upload.rs +++ b/crates/horizon-client/src/gfx/upload.rs @@ -14,8 +14,13 @@ pub struct Uploads { impl Uploads { pub fn new(device: &wgpu::Device) -> Self { + Self::with_chunk(device, CHUNK) + } + /// A belt whose staging buffers hold `chunk` bytes (larger writes get + /// a buffer of their own). + pub fn with_chunk(device: &wgpu::Device, chunk: u64) -> Self { Self { - belt: wgpu::util::StagingBelt::new(device.clone(), CHUNK), + belt: wgpu::util::StagingBelt::new(device.clone(), chunk), } } /// Copy tightly packed RGBA8 `pixels` (`width` by `height`) into one mip From 571066158ede74d0d73c729d8a3745f880cc741e Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 09:54:31 +0200 Subject: [PATCH 081/163] Structure templates read without a node cap, as vanilla does Vanilla reads structure templates with NbtAccounter.unlimitedHeap() (TemplateSource.readStructure). Horizon used the default 1,000,000-node cap, so a template past it loaded as empty: YUNG's Better Ocean Monuments' start piece (115x64x126 blocks) never started. Limits::templates keeps the 256 MiB byte cap and drops the node cap, for worldgen and /place. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../horizon-client/src/game/commands/place.rs | 8 +----- crates/horizon-world/src/nbt.rs | 25 +++++++++++++++++++ .../horizon-world/src/worldgen/structure.rs | 6 +---- 3 files changed, 27 insertions(+), 12 deletions(-) diff --git a/crates/horizon-client/src/game/commands/place.rs b/crates/horizon-client/src/game/commands/place.rs index 3e447a7fb..c2ea487ee 100644 --- a/crates/horizon-client/src/game/commands/place.rs +++ b/crates/horizon-client/src/game/commands/place.rs @@ -53,13 +53,7 @@ impl Game<'_> { let Ok(raw) = Compression::Gzip.decode(&bytes, 1 << 28) else { continue; }; - let Ok((named, _)) = nbt::read_named( - &raw, - Limits { - max_bytes: 1 << 28, - ..Limits::default() - }, - ) else { + let Ok((named, _)) = nbt::read_named(&raw, Limits::templates()) else { continue; }; return Some(Arc::new(StructureTemplate::from_nbt( diff --git a/crates/horizon-world/src/nbt.rs b/crates/horizon-world/src/nbt.rs index 2a8b11591..a8bed543a 100644 --- a/crates/horizon-world/src/nbt.rs +++ b/crates/horizon-world/src/nbt.rs @@ -110,6 +110,19 @@ impl Limits { max_depth: 512, } } + + /// Structure templates (`structure/*.nbt`): vanilla reads them with + /// `NbtAccounter.unlimitedHeap()` (TemplateSource.readStructure), and + /// mods ship templates past the default node cap (YUNG's Better Ocean + /// Monuments' start piece, 115x64x126 blocks, holds millions of tags). + /// The byte cap stays as the only guard on the decompressed file. + pub fn templates() -> Self { + Self { + max_bytes: 1 << 28, + max_nodes: usize::MAX, + max_depth: 512, + } + } } #[derive(Clone, Debug, PartialEq, Eq)] @@ -836,6 +849,18 @@ mod tests { assert!(read_network(&bytes, limits).is_err()); } #[test] + fn templates_read_past_the_default_node_cap() { + // A big mod template (YUNG's monument start) holds more tags than the + // default cap; vanilla reads templates with an unlimited accounter. + let root = NamedTag { + name: JavaString::default(), + tag: Tag::compound([("blocks", Tag::List(vec![Tag::Byte(1); 1_000_001]))]), + }; + let bytes = write_named(&root, Limits::templates()).unwrap(); + assert!(read_named(&bytes, Limits::default()).is_err()); + assert_eq!(read_named(&bytes, Limits::templates()).unwrap().0, root); + } + #[test] fn depth_boundary_and_every_truncated_prefix() { let mut tag = Tag::Int(1); for _ in 0..512 { diff --git a/crates/horizon-world/src/worldgen/structure.rs b/crates/horizon-world/src/worldgen/structure.rs index 361b2c1d0..de312c3cd 100644 --- a/crates/horizon-world/src/worldgen/structure.rs +++ b/crates/horizon-world/src/worldgen/structure.rs @@ -342,11 +342,7 @@ impl StructureResources { flate2::read::GzDecoder::new(bytes.as_slice()) .read_to_end(&mut raw) .ok()?; - let limits = Limits { - max_bytes: 1 << 28, - ..Limits::default() - }; - let tag = nbt::read_named(&raw, limits).ok()?.0.tag; + let tag = nbt::read_named(&raw, Limits::templates()).ok()?.0.tag; Some(Arc::new(StructureTemplate::from_nbt( &tag, self.registry, From 3c08f74d79ba37259b6c0e50873c35e3be831cff Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 09:54:51 +0200 Subject: [PATCH 082/163] Structures: YUNG's API's jigsaw assembler for carried structures A jigsaw structure with "horizon:yungsapi" (min_y/max_y) assembles the way YUNG's API's JigsawManager does: the start piece by priority then weight from the shuffled raw entries, children breadth-first, pool or fallback per depth, and per-element rules from the element's "horizon:yungsapi": a name capped by max_count, a depth range, a priority, ignore_bounds and a condition (true, false, not, all_of, any_of, depth, altitude, random_chance, rotation, piece_in_horizontal_direction). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../horizon-world/src/worldgen/structure.rs | 1 + .../src/worldgen/structure/jigsaw.rs | 55 +- .../src/worldgen/structure/start.rs | 33 +- .../src/worldgen/structure/yung.rs | 727 ++++++++++++++++++ 4 files changed, 792 insertions(+), 24 deletions(-) create mode 100644 crates/horizon-world/src/worldgen/structure/yung.rs diff --git a/crates/horizon-world/src/worldgen/structure.rs b/crates/horizon-world/src/worldgen/structure.rs index 361b2c1d0..4f533d06b 100644 --- a/crates/horizon-world/src/worldgen/structure.rs +++ b/crates/horizon-world/src/worldgen/structure.rs @@ -18,6 +18,7 @@ pub mod start_checks; pub mod stronghold; pub mod template; pub mod temple; +pub mod yung; use crate::{ nbt::{self, Limits}, diff --git a/crates/horizon-world/src/worldgen/structure/jigsaw.rs b/crates/horizon-world/src/worldgen/structure/jigsaw.rs index a50275941..a5c2b8358 100644 --- a/crates/horizon-world/src/worldgen/structure/jigsaw.rs +++ b/crates/horizon-world/src/worldgen/structure/jigsaw.rs @@ -39,6 +39,9 @@ pub enum PoolElement { legacy: bool, projection: Projection, waterlogging: Option<bool>, + /// YUNG's API's rules on the piece (`"horizon:yungsapi"`), read only + /// by its assembler ([`super::yung`]). + yung: Option<Box<super::yung::Rules>>, }, Feature { feature: String, @@ -81,11 +84,12 @@ fn opposite(d: Direction) -> Direction { Direction::East => Direction::West, } } -fn step(d: Direction) -> [i32; 3] { +pub(super) fn step(d: Direction) -> [i32; 3] { let n = d.normal(); [n[0], n[1], n[2]] } -fn shuffle<T>(list: &mut [T], random: &mut impl RandomSource) { +/// Util.shuffle. +pub(super) fn shuffle<T>(list: &mut [T], random: &mut impl RandomSource) { for i in (2..=list.len()).rev() { let swap = random.next_int_bound(i as i32).unwrap_or(0) as usize; list.swap(i - 1, swap); @@ -135,6 +139,10 @@ impl PoolElement { Some("ignore_waterlogging") => Some(false), _ => None, }, + yung: value + .get("horizon:yungsapi") + .map(|rules| super::yung::Rules::decode(rules, resources).map(Box::new)) + .transpose()?, } } "minecraft:feature_pool_element" => Self::Feature { @@ -219,10 +227,13 @@ impl PoolElement { .first() .map(|e| e.shuffled_jigsaws(resources, position, rotation, random)) .unwrap_or_default(), - Self::Single { template, .. } => { + Self::Single { template, yung, .. } => { let mut jigsaws = template_jigsaws(resources, template, position, rotation); shuffle(&mut jigsaws, random); - jigsaws.sort_by_key(|j| std::cmp::Reverse(j.selection_priority)); + // YUNG's elements keep the shuffled order. + if yung.is_none() { + jigsaws.sort_by_key(|j| std::cmp::Reverse(j.selection_priority)); + } jigsaws } } @@ -230,6 +241,13 @@ impl PoolElement { pub fn ground_level_delta(&self) -> i32 { 1 } + /// YUNG's API's rules, on a piece of one of its structures. + pub fn yung(&self) -> Option<&super::yung::Rules> { + match self { + Self::Single { yung, .. } => yung.as_deref(), + _ => None, + } + } } /// StructureTemplate.getJigsaws: palette chosen by a position-seeded random. fn template_jigsaws( @@ -274,7 +292,7 @@ fn template_jigsaws( }) .collect() } -fn can_attach(source: &Jigsaw, target: &Jigsaw) -> bool { +pub(super) fn can_attach(source: &Jigsaw, target: &Jigsaw) -> bool { source.front == opposite(target.front) && (source.rollable || source.top == target.top) && target @@ -285,8 +303,11 @@ fn can_attach(source: &Jigsaw, target: &Jigsaw) -> bool { #[derive(Debug)] pub struct Pool { - templates: Vec<Arc<PoolElement>>, - fallback: String, + /// Each element repeated by its weight. + pub(super) templates: Vec<Arc<PoolElement>>, + /// The elements with their weights, in file order (`rawTemplates`). + pub(super) raw: Vec<(Arc<PoolElement>, i32)>, + pub(super) fallback: String, max_size: OnceLock<i32>, } impl Pool { @@ -304,7 +325,7 @@ impl Pool { shuffle(&mut copy, random); copy } - fn max_size(&self) -> i32 { + pub(super) fn max_size(&self) -> i32 { *self.max_size.get_or_init(|| { self.templates .iter() @@ -343,7 +364,7 @@ impl Pools { } let pool = self.raw.get(name).and_then(|json| { let value: Value = serde_json::from_str(json).ok()?; - let mut templates = Vec::new(); + let (mut templates, mut raw) = (Vec::new(), Vec::new()); for entry in value["elements"].as_array()? { let element = match PoolElement::decode(&entry["element"], resources, bindings, None) { @@ -355,12 +376,15 @@ impl Pools { return None; } }; - for _ in 0..entry["weight"].as_i64().unwrap_or(1) { + let weight = entry["weight"].as_i64().unwrap_or(1); + for _ in 0..weight { templates.push(element.clone()); } + raw.push((element, weight as i32)); } Some(Arc::new(Pool { templates, + raw, fallback: value["fallback"] .as_str() .unwrap_or("minecraft:empty") @@ -393,7 +417,7 @@ pub struct PoolPiece { pub waterlogging: bool, } impl PoolPiece { - fn moved(&mut self, dy: i32) { + pub(super) fn moved(&mut self, dy: i32) { self.position[1] += dy; self.bounding_box = self.bounding_box.moved([0, dy, 0]); } @@ -466,6 +490,7 @@ fn place_element<W: FeatureWorld + PlacementContext, R: RandomSource>( legacy, projection, waterlogging: override_liquid, + .. } => { let ignore = if *legacy { IGNORE_STRUCTURE_AND_AIR.get_or_init(|| { @@ -547,13 +572,13 @@ pub struct JigsawConfig<'a> { /// Free space for children: an inclusive container box minus placed boxes. #[derive(Debug)] -struct Free { - container: BoundingBox, - removed: Vec<BoundingBox>, +pub(super) struct Free { + pub(super) container: BoundingBox, + pub(super) removed: Vec<BoundingBox>, } impl Free { /// Whether every point of the (0.25-deflated) box lies in free space. - fn fits(&self, b: &BoundingBox) -> bool { + pub(super) fn fits(&self, b: &BoundingBox) -> bool { (0..3).all(|i| b.min[i] >= self.container.min[i] && b.max[i] <= self.container.max[i]) && !self.removed.iter().any(|r| r.intersects(b)) } diff --git a/crates/horizon-world/src/worldgen/structure/start.rs b/crates/horizon-world/src/worldgen/structure/start.rs index a66f27509..ee6f63655 100644 --- a/crates/horizon-world/src/worldgen/structure/start.rs +++ b/crates/horizon-world/src/worldgen/structure/start.rs @@ -57,6 +57,8 @@ pub struct JigsawDef { waterlogging: bool, /// A carried mod's start rules (`"horizon:start_checks"`). checks: super::start_checks::StartChecks, + /// Laid out by YUNG's API's assembler (`"horizon:yungsapi"`). + yung: Option<super::yung::Config>, } #[derive(Debug)] pub enum StructureKind { @@ -202,6 +204,7 @@ impl StructureRegistry { padding: pair(v.get("dimension_padding"), "bottom", "top", 0), waterlogging: v["liquid_settings"].as_str() != Some("ignore_waterlogging"), checks: super::start_checks::StartChecks::decode(v.get("horizon:start_checks")), + yung: v.get("horizon:yungsapi").map(super::yung::Config::decode), }), "minecraft:buried_treasure" => StructureKind::BuriedTreasure, "minecraft:igloo" => StructureKind::Igloo, @@ -669,15 +672,27 @@ fn try_generate( padding: jigsaw.padding, waterlogging: jigsaw.waterlogging, }; - let (position, mut pieces) = assemble( - &config, - context, - ®istry.pools, - resources, - bindings, - &mut random, - start, - )?; + let (position, mut pieces) = match &jigsaw.yung { + Some(yung) => super::yung::assemble( + &config, + yung, + context, + ®istry.pools, + resources, + bindings, + &mut random, + start, + )?, + None => assemble( + &config, + context, + ®istry.pools, + resources, + bindings, + &mut random, + start, + )?, + }; if jigsaw.max_depth <= 0 { pieces.clear(); } diff --git a/crates/horizon-world/src/worldgen/structure/yung.rs b/crates/horizon-world/src/worldgen/structure/yung.rs new file mode 100644 index 000000000..07b363cfb --- /dev/null +++ b/crates/horizon-world/src/worldgen/structure/yung.rs @@ -0,0 +1,727 @@ +//! YUNG's API's jigsaw assembler, for the structures of the "YUNG's Better" +//! mods carried over from a modpack (docs/modpacks.md). Carry maps +//! `yungsapi:yung_jigsaw` to `minecraft:jigsaw` with a `"horizon:yungsapi"` +//! key, and its pool elements to vanilla's single element with the piece's +//! rules under the same key; vanilla data never has it. +//! +//! The assembler differs from vanilla's JigsawPlacement: it picks the start +//! piece and every child by weight from the pool's weighted entries (a +//! priority piece first), lays pieces out breadth first, caps pieces by name +//! (`max_count`), limits them by depth, lets some ignore the bounds, checks +//! each piece's condition, and keeps every piece between `min_y` and +//! `max_y`. Pieces fit the same free space as vanilla's. +use super::{ + BoundingBox, Rotation, StructureResources, StructureTemplate, + jigsaw::{ + Free, JigsawConfig, JigsawContext, Junction, PoolElement, PoolPiece, Pools, Projection, + can_attach, shuffle, step, + }, +}; +use crate::{ + heightmap::HeightmapType, + worldgen::{DecodeError, block_feature::FeatureBlockBindings}, +}; +use horizon_core::random::RandomSource; +use serde_json::Value; +use std::{ + cell::RefCell, + collections::{HashMap, VecDeque}, + rc::Rc, + sync::Arc, +}; + +/// A YUNG structure's own settings (`"horizon:yungsapi"` on the structure): +/// the heights every piece must stay within. +#[derive(Debug, Default)] +pub struct Config { + pub min_y: Option<i32>, + pub max_y: Option<i32>, +} +impl Config { + pub fn decode(v: &Value) -> Self { + let y = |k: &str| v[k].as_i64().map(|n| n as i32); + Self { + min_y: y("min_y"), + max_y: y("max_y"), + } + } +} + +/// A piece's rules (`"horizon:yungsapi"` on a pool element). +#[derive(Debug, Default)] +pub struct Rules { + /// Pieces sharing a name share the cap `max_count`. + name: Option<String>, + max_count: Option<i32>, + min_depth: Option<i32>, + max_depth: Option<i32>, + /// Chosen before any other piece of its pool. + priority: bool, + /// Placed even where it overlaps other pieces or leaves the bounds. + ignore_bounds: bool, + condition: Condition, +} +impl Rules { + pub fn decode(v: &Value, resources: &StructureResources) -> Result<Self, DecodeError> { + let int = |k: &str| v[k].as_i64().map(|n| n as i32); + Ok(Self { + name: v["name"].as_str().map(str::to_owned), + max_count: int("max_count"), + min_depth: int("min_depth"), + max_depth: int("max_depth"), + priority: v["priority"].as_bool().unwrap_or(false), + ignore_bounds: v["ignore_bounds"].as_bool().unwrap_or(false), + condition: match v.get("condition") { + Some(c) => Condition::decode(c, resources)?, + None => Condition::True, + }, + }) + } + /// YungJigsawPoolElement.isAtValidDepth. + fn at_valid_depth(&self, depth: i32) -> bool { + self.min_depth.is_none_or(|d| d <= depth) && self.max_depth.is_none_or(|d| d >= depth) + } + /// The name a capped piece counts under: `max_count` without a name is + /// ignored, as YUNG's does. + fn capped(&self) -> Option<(&str, i32)> { + Some((self.name.as_deref()?, self.max_count?)) + } +} + +/// YUNG's structure conditions, as carry writes them. +#[derive(Debug, Default)] +enum Condition { + #[default] + True, + False, + Not(Box<Condition>), + AllOf(Vec<Condition>), + AnyOf(Vec<Condition>), + Depth { + min: Option<i32>, + max: Option<i32>, + }, + Altitude { + bottom: Option<f64>, + top: Option<f64>, + }, + RandomChance(f32), + Rotation(Vec<Rotation>), + /// Another piece (of these templates, or any) within `range` blocks in + /// the direction `rotation` turns the piece's own north. + PieceInDirection { + templates: Vec<Arc<StructureTemplate>>, + range: i32, + rotation: Rotation, + }, +} +impl Condition { + fn decode(v: &Value, resources: &StructureResources) -> Result<Self, DecodeError> { + let list = |k: &'static str| -> Result<Vec<Condition>, DecodeError> { + v[k].as_array() + .ok_or(DecodeError::Field(k))? + .iter() + .map(|c| Self::decode(c, resources)) + .collect() + }; + let int = |k: &str| v[k].as_i64().map(|n| n as i32); + let rotation = |r: &Value| { + r.as_str() + .and_then(Rotation::from_name) + .ok_or(DecodeError::Field("condition rotation")) + }; + Ok(match v["type"].as_str().unwrap_or_default() { + "true" => Self::True, + "false" => Self::False, + "not" => Self::Not(Box::new(Self::decode(&v["condition"], resources)?)), + "all_of" => Self::AllOf(list("conditions")?), + "any_of" => Self::AnyOf(list("conditions")?), + "depth" => Self::Depth { + min: int("min_depth"), + max: int("max_depth"), + }, + "altitude" => Self::Altitude { + bottom: v["bottom"].as_f64(), + top: v["top"].as_f64(), + }, + "random_chance" => Self::RandomChance(v["chance"].as_f64().unwrap_or(0.) as f32), + "rotation" => Self::Rotation( + v["rotations"] + .as_array() + .into_iter() + .flatten() + .map(rotation) + .collect::<Result<_, _>>()?, + ), + "piece_in_horizontal_direction" => Self::PieceInDirection { + templates: v["pieces"] + .as_array() + .into_iter() + .flatten() + .filter_map(|p| resources.template(p.as_str()?)) + .collect(), + range: int("range").unwrap_or(0), + rotation: rotation(&v["rotation"])?, + }, + _ => return Err(DecodeError::Field("YUNG condition type")), + }) + } + /// StructureCondition.passes. `at` is the piece being placed: its box, + /// rotation and depth; the start piece has no box yet. + fn passes(&self, at: &At<'_>, random: &mut impl RandomSource) -> bool { + match self { + Self::True => true, + Self::False => false, + Self::Not(c) => !c.passes(at, random), + Self::AllOf(all) => all.iter().all(|c| c.passes(at, random)), + Self::AnyOf(any) => any.iter().any(|c| c.passes(at, random)), + Self::Depth { min, max } => { + min.is_none_or(|d| d <= at.depth) && max.is_none_or(|d| d >= at.depth) + } + Self::Altitude { bottom, top } => { + let [low, high] = at.piece.map_or([0, 0], |b| [b.min[1], b.max[1]]); + bottom.is_none_or(|y| f64::from(low) >= y) + && top.is_none_or(|y| f64::from(high) <= y) + } + Self::RandomChance(chance) => random.next_float() < *chance, + Self::Rotation(valid) => valid.contains(&at.rotation), + Self::PieceInDirection { + templates, + range, + rotation, + } => { + let Some(piece) = at.piece else { + return false; + }; + let mut search = piece; + match at.rotation.get_rotated(*rotation) { + Rotation::None => search.min[2] -= range, + Rotation::Clockwise90 => search.max[0] += range, + Rotation::Clockwise180 => search.max[2] += range, + Rotation::Counterclockwise90 => search.min[0] -= range, + } + at.pieces.iter().any(|other| { + let PoolElement::Single { template, .. } = other.element.as_ref() else { + return false; + }; + let b = other.bounding_box; + b != piece + && (templates.is_empty() + || templates.iter().any(|t| Arc::ptr_eq(t, template))) + && b.intersects(&search) + && !b.intersects(&piece) + }) + } + } + } +} + +/// The surface height query, object-safe for the per-call cache. +trait JigsawContextDyn { + fn surface(&mut self, x: i32, z: i32) -> i32; +} +impl<C: JigsawContext> JigsawContextDyn for C { + fn surface(&mut self, x: i32, z: i32) -> i32 { + self.base_height(x, z, HeightmapType::WorldSurfaceWg) + } +} + +/// What a condition sees of the piece being placed. +struct At<'a> { + depth: i32, + rotation: Rotation, + piece: Option<BoundingBox>, + pieces: &'a [PoolPiece], +} + +/// The index of the entry to try: the first priority piece, else one drawn +/// by weight (`nextInt(total) + 1`, counted down). +fn pick( + candidates: &[(Arc<PoolElement>, i32)], + total: i32, + random: &mut impl RandomSource, +) -> usize { + if let Some(i) = candidates + .iter() + .position(|(e, _)| e.yung().is_some_and(|r| r.priority)) + { + return i; + } + let mut chosen = random.next_int_bound(total).unwrap_or(0) + 1; + for (i, (_, weight)) in candidates.iter().enumerate() { + chosen -= weight; + if chosen <= 0 { + return i; + } + } + candidates.len() - 1 +} + +/// JigsawManager.assembleJigsawStructure: the start position and the +/// pieces, or None when no start piece fits. +#[allow(clippy::too_many_arguments)] +pub fn assemble( + config: &JigsawConfig<'_>, + yung: &Config, + context: &mut impl JigsawContext, + pools: &Pools, + resources: &StructureResources, + bindings: &FeatureBlockBindings<'_>, + random: &mut impl RandomSource, + position: [i32; 3], +) -> Option<([i32; 3], Vec<PoolPiece>)> { + let pool = pools.get(config.start_pool, resources, bindings)?; + let mut candidates = pool.raw.clone(); + shuffle(&mut candidates, random); + let rotation = Rotation::random(random); + let mut total: i32 = candidates.iter().map(|c| c.1).sum(); + let (element, adjusted, local) = loop { + if candidates.is_empty() || total <= 0 { + return None; + } + let index = pick(&candidates, total, random); + let (element, weight) = candidates[index].clone(); + if matches!(element.as_ref(), PoolElement::Empty) { + return None; + } + let anchored = match config.start_jigsaw { + Some(name) => { + element + .shuffled_jigsaws(resources, position, rotation, random) + .into_iter() + .find(|j| j.name.as_deref() == Some(name))? + .pos + } + None => position, + }; + let local: [i32; 3] = std::array::from_fn(|i| anchored[i] - position[i]); + let adjusted: [i32; 3] = std::array::from_fn(|i| position[i] - local[i]); + let at = At { + depth: 0, + rotation, + piece: None, + pieces: &[], + }; + if element + .yung() + .is_some_and(|r| !r.condition.passes(&at, random)) + { + total -= weight; + candidates.remove(index); + continue; + } + break (element, adjusted, local); + }; + let mut start = PoolPiece { + bounding_box: element.bounding_box(adjusted, rotation), + ground_level_delta: element.ground_level_delta(), + element, + position: adjusted, + rotation, + junctions: Vec::new(), + waterlogging: config.waterlogging, + }; + let b = start.bounding_box; + let (cx, cz) = ((b.max[0] + b.min[0]) / 2, (b.max[2] + b.min[2]) / 2); + let bottom = match config.project_to { + Some(kind) => position[1] + context.base_height(cx, cz, kind), + None => adjusted[1], + }; + start.moved(bottom - (b.min[1] + start.ground_level_delta)); + let cy = bottom + local[1]; + let d = config.max_distance[0]; + let free = Rc::new(RefCell::new(Free { + container: BoundingBox::new([cx - d, cy - d, cz - d], [cx + d, cy + d, cz + d]), + removed: vec![start.bounding_box], + })); + let mut assembler = Assembler { + config, + yung, + pools, + resources, + bindings, + pieces: vec![start], + states: vec![(free, 0)], + counts: HashMap::new(), + }; + if config.max_depth > 0 { + let mut queue = VecDeque::from([0]); + while let Some(piece) = queue.pop_front() { + assembler.children(piece, &mut queue, context, random); + } + } + Some(([cx, cy, cz], assembler.pieces)) +} + +/// JigsawStructureAssembler. +struct Assembler<'a> { + config: &'a JigsawConfig<'a>, + yung: &'a Config, + pools: &'a Pools, + resources: &'a StructureResources, + bindings: &'a FeatureBlockBindings<'a>, + pieces: Vec<PoolPiece>, + /// Per piece: the free space it was placed in, and its depth. + states: Vec<(Rc<RefCell<Free>>, i32)>, + /// Pieces placed per capped name. + counts: HashMap<String, i32>, +} + +/// Where a child goes: the parent's jigsaw and what it needs. +struct Slot<'s> { + source: usize, + jigsaw: &'s super::jigsaw::Jigsaw, + target_pos: [i32; 3], + free: Rc<RefCell<Free>>, + depth: i32, +} + +impl Assembler<'_> { + fn pool(&self, name: &str) -> Option<Arc<super::jigsaw::Pool>> { + let name = self.config.aliases.get(name).map_or(name, String::as_str); + self.pools.get(name, self.resources, self.bindings) + } + /// JigsawStructureAssembler.Settings.isInBounds. + fn in_bounds(&self, y: i32, context: &impl JigsawContext) -> bool { + self.yung.max_y.is_none_or(|m| y <= m) + && self.yung.min_y.is_none_or(|m| y >= m) + && y >= context.min_y() + self.config.padding[0] + && y <= context.max_y() + 1 - self.config.padding[1] + } + /// addChildrenForPiece: one child per jigsaw where one fits, from the + /// target pool unless the piece is at the last depth, else its fallback. + fn children( + &mut self, + source: usize, + queue: &mut VecDeque<usize>, + context: &mut impl JigsawContext, + random: &mut impl RandomSource, + ) { + let (element, position, rotation, source_box) = { + let s = &self.pieces[source]; + (s.element.clone(), s.position, s.rotation, s.bounding_box) + }; + let (context_free, depth) = self.states[source].clone(); + let mut source_free: Option<Rc<RefCell<Free>>> = None; + for jigsaw in element.shuffled_jigsaws(self.resources, position, rotation, random) { + let Some(target) = self.pool(&jigsaw.pool) else { + continue; + }; + if target.templates.is_empty() && jigsaw.pool != "minecraft:empty" { + continue; + } + let Some(fallback) = self.pool(&target.fallback) else { + continue; + }; + if fallback.templates.is_empty() && target.fallback != "minecraft:empty" { + continue; + } + let s = step(jigsaw.front); + let target_pos: [i32; 3] = std::array::from_fn(|i| jigsaw.pos[i] + s[i]); + let free = if source_box.is_inside(target_pos) { + source_free + .get_or_insert_with(|| { + Rc::new(RefCell::new(Free { + container: source_box, + removed: Vec::new(), + })) + }) + .clone() + } else { + context_free.clone() + }; + let slot = Slot { + source, + jigsaw: &jigsaw, + target_pos, + free, + depth, + }; + let placed = depth != self.config.max_depth + && self.choose(&slot, target.raw.clone(), queue, context, random); + if !placed { + self.choose(&slot, fallback.raw.clone(), queue, context, random); + } + } + } + /// chooseCandidateFromPool: whether a piece was placed. + fn choose( + &mut self, + slot: &Slot<'_>, + mut candidates: Vec<(Arc<PoolElement>, i32)>, + queue: &mut VecDeque<usize>, + context: &mut impl JigsawContext, + random: &mut impl RandomSource, + ) -> bool { + let jigsaw = slot.jigsaw; + let (source_rigid, source_y, source_ground) = { + let s = &self.pieces[slot.source]; + ( + s.element.projection() == Projection::Rigid, + s.bounding_box.min[1], + s.ground_level_delta, + ) + }; + let local_y = jigsaw.pos[1] - source_y; + // The surface at the jigsaw, read once per call. + let mut surface = None; + let (x, z) = (jigsaw.pos[0], jigsaw.pos[2]); + let mut base = |context: &mut dyn JigsawContextDyn| { + *surface.get_or_insert_with(|| context.surface(x, z)) + }; + shuffle(&mut candidates, random); + let mut total: i32 = candidates.iter().map(|c| c.1).sum(); + while !candidates.is_empty() && total > 0 { + let index = pick(&candidates, total, random); + let (target, weight) = candidates[index].clone(); + if matches!(target.as_ref(), PoolElement::Empty) { + return false; + } + let rules = target.yung(); + let capped = rules.and_then(Rules::capped); + let full = capped + .is_some_and(|(name, max)| self.counts.get(name).copied().unwrap_or(0) >= max); + if full || rules.is_some_and(|r| !r.at_valid_depth(slot.depth)) { + total -= weight; + candidates.remove(index); + continue; + } + let mut rotations = Rotation::ALL; + shuffle(&mut rotations, random); + for rotation in rotations { + let target_jigsaws = + target.shuffled_jigsaws(self.resources, [0; 3], rotation, random); + let hack_box = target.bounding_box([0; 3], rotation); + let expand_to = if self.config.use_expansion_hack && hack_box.span()[1] <= 16 { + target_jigsaws + .iter() + .map(|tj| { + let st = step(tj.front); + if !hack_box.is_inside(std::array::from_fn(|i| tj.pos[i] + st[i])) { + return 0; + } + let child = self.pool(&tj.pool); + let child_size = child.as_ref().map_or(0, |p| p.max_size()); + let fallback_size = child + .and_then(|p| self.pool(&p.fallback)) + .map_or(0, |p| p.max_size()); + child_size.max(fallback_size) + }) + .max() + .unwrap_or(0) + } else { + 0 + }; + for target_jigsaw in &target_jigsaws { + if !can_attach(jigsaw, target_jigsaw) { + continue; + } + let target_local = target_jigsaw.pos; + let raw_position: [i32; 3] = + std::array::from_fn(|i| slot.target_pos[i] - target_local[i]); + let raw_box = target.bounding_box(raw_position, rotation); + let target_rigid = target.projection() == Projection::Rigid; + let delta_y = local_y - target_local[1] + step(jigsaw.front)[1]; + let target_y = if source_rigid && target_rigid { + source_y + delta_y + } else { + base(context) - target_local[1] + }; + let offset = target_y - raw_box.min[1]; + let mut target_box = raw_box.moved([0, offset, 0]); + let target_position = + [raw_position[0], raw_position[1] + offset, raw_position[2]]; + if expand_to > 0 { + let size = (expand_to + 1).max(target_box.max[1] - target_box.min[1]); + target_box.max[1] = target_box.min[1] + size; + } + if !self.in_bounds(target_box.max[1], context) + || !self.in_bounds(target_box.min[1], context) + { + continue; + } + if !rules.is_some_and(|r| r.ignore_bounds) + && !slot.free.borrow().fits(&target_box) + { + continue; + } + let target_ground = if target_rigid { + source_ground - delta_y + } else { + target.ground_level_delta() + }; + let junction_y = if source_rigid { + source_y + local_y + } else if target_rigid { + target_y + target_local[1] + } else { + base(context) + delta_y / 2 + }; + let at = At { + depth: slot.depth + 1, + rotation, + piece: Some(target_box), + pieces: &self.pieces, + }; + if rules.is_some_and(|r| !r.condition.passes(&at, random)) { + continue; + } + self.pieces[slot.source].junctions.push(Junction { + source_x: slot.target_pos[0], + source_ground_y: junction_y - local_y + source_ground, + source_z: slot.target_pos[2], + }); + slot.free.borrow_mut().removed.push(target_box); + self.pieces.push(PoolPiece { + element: target.clone(), + position: target_position, + ground_level_delta: target_ground, + rotation, + bounding_box: target_box, + junctions: vec![Junction { + source_x: jigsaw.pos[0], + source_ground_y: junction_y - target_local[1] + target_ground, + source_z: jigsaw.pos[2], + }], + waterlogging: self.config.waterlogging, + }); + self.states.push((slot.free.clone(), slot.depth + 1)); + if slot.depth < self.config.max_depth { + queue.push_back(self.pieces.len() - 1); + } + if let Some((name, _)) = capped { + *self.counts.entry(name.to_owned()).or_default() += 1; + } + return true; + } + } + total -= weight; + candidates.remove(index); + } + false + } +} + +#[cfg(test)] +mod tests { + use super::*; + use horizon_core::random::LegacyRandom; + + fn single(template: &Arc<StructureTemplate>, rules: Option<Rules>) -> Arc<PoolElement> { + Arc::new(PoolElement::Single { + template: template.clone(), + processors: Default::default(), + legacy: false, + projection: Projection::Rigid, + waterlogging: None, + yung: rules.map(Box::new), + }) + } + + #[test] + fn picks_priority_pieces_then_by_weight() { + let t = Arc::new(StructureTemplate::empty()); + let plain = single(&t, None); + let first = single( + &t, + Some(Rules { + priority: true, + ..Rules::default() + }), + ); + let mut random = LegacyRandom::new(7); + let list = vec![(plain.clone(), 3), (first, 1)]; + assert_eq!(pick(&list, 4, &mut random), 1); + // By weight: nextInt(total) + 1, counted down; the first entry + // takes draws 1..=3 of 4. + let list = vec![(plain.clone(), 3), (plain, 1)]; + let mut ours = LegacyRandom::new(42); + let mut theirs = LegacyRandom::new(42); + for _ in 0..32 { + let draw = theirs.next_int_bound(4).unwrap() + 1; + assert_eq!(pick(&list, 4, &mut ours), usize::from(draw > 3)); + } + } + + #[test] + fn rules_cap_by_name_and_depth() { + let rules = Rules { + name: Some("room".into()), + max_count: Some(2), + min_depth: Some(1), + max_depth: Some(3), + ..Rules::default() + }; + assert_eq!(rules.capped(), Some(("room", 2))); + assert!(!rules.at_valid_depth(0) && rules.at_valid_depth(1) && !rules.at_valid_depth(4)); + // max_count without a name is ignored, as YUNG's does. + let unnamed = Rules { + max_count: Some(1), + ..Rules::default() + }; + assert_eq!(unnamed.capped(), None); + } + + #[test] + fn conditions() { + let t = Arc::new(StructureTemplate::empty()); + let other = Arc::new(StructureTemplate::empty()); + let neighbour = PoolPiece { + element: single(&t, None), + position: [0; 3], + ground_level_delta: 1, + rotation: Rotation::None, + bounding_box: BoundingBox::new([0, 0, -6], [4, 4, -1]), + junctions: Vec::new(), + waterlogging: true, + }; + let pieces = [neighbour]; + let at = |rotation, depth| At { + depth, + rotation, + piece: Some(BoundingBox::new([0, 10, 0], [4, 14, 4])), + pieces: &pieces, + }; + let mut random = LegacyRandom::new(1); + let depth = Condition::Depth { + min: Some(2), + max: None, + }; + assert!(!depth.passes(&at(Rotation::None, 1), &mut random)); + assert!(depth.passes(&at(Rotation::None, 2), &mut random)); + let altitude = |bottom, top| Condition::Altitude { bottom, top }; + assert!(altitude(Some(10.), Some(14.)).passes(&at(Rotation::None, 0), &mut random)); + assert!(!altitude(Some(10.5), None).passes(&at(Rotation::None, 0), &mut random)); + assert!(!altitude(None, Some(13.9)).passes(&at(Rotation::None, 0), &mut random)); + // North (-Z) of an unrotated piece, within 5 blocks; the neighbour + // stays below it in Y, but only X and Z are searched, and it must + // not overlap the piece itself. + let north = |templates, rotation| Condition::PieceInDirection { + templates, + range: 5, + rotation, + }; + assert!(!north(Vec::new(), Rotation::None).passes(&at(Rotation::None, 1), &mut random)); + let low = At { + piece: Some(BoundingBox::new([0, 0, 0], [4, 4, 4])), + ..at(Rotation::None, 1) + }; + assert!(north(Vec::new(), Rotation::None).passes(&low, &mut random)); + assert!(north(vec![t.clone()], Rotation::None).passes(&low, &mut random)); + assert!(!north(vec![other], Rotation::None).passes(&low, &mut random)); + // The piece turned 180°: its north is south. + let turned = At { + rotation: Rotation::Clockwise180, + ..low + }; + assert!(!north(Vec::new(), Rotation::None).passes(&turned, &mut random)); + assert!(north(Vec::new(), Rotation::Clockwise180).passes(&turned, &mut random)); + let all = Condition::AllOf(vec![ + Condition::True, + Condition::Not(Box::new(Condition::False)), + Condition::Rotation(vec![Rotation::Clockwise180]), + ]); + assert!(all.passes(&turned, &mut random)); + assert!(!Condition::AnyOf(vec![Condition::False]).passes(&turned, &mut random)); + } +} From 4676ea2819b89f93c8f73ccd95bdf628f485519f Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 09:16:16 +0200 Subject: [PATCH 083/163] Carry: YUNG's jigsaws and pieces with their rules Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/worldgen.rs | 169 ++++++++++++++++++++++- 1 file changed, 167 insertions(+), 2 deletions(-) diff --git a/crates/horizon-port-pack/src/worldgen.rs b/crates/horizon-port-pack/src/worldgen.rs index 25e0dbbea..ecc5d3590 100644 --- a/crates/horizon-port-pack/src/worldgen.rs +++ b/crates/horizon-port-pack/src/worldgen.rs @@ -180,6 +180,10 @@ fn upgrade_types( let mut unsupported = |t: &str| *report.unsupported.entry(t.to_owned()).or_default() += 1; let changed = match kind { "structure" => match v["type"].as_str() { + Some("yungsapi:yung_jigsaw") => { + yung_structure(v, lost); + true + } Some(t) if JIGSAWS.contains(&t) => { let liquid = match t.split_once(':').map(|(ns, _)| ns) { Some("moogs_structures") => "top", @@ -231,6 +235,9 @@ fn upgrade_types( if let Some((_, to)) = ELEMENTS.iter().find(|(from, _)| *from == t) { element["element_type"] = (*to).into(); changed = true; + } else if t == "yungsapi:yung_single_element" { + yung_element(element, lost); + changed = true; } else if !t.starts_with("minecraft:") { unsupported(t); } @@ -243,6 +250,118 @@ fn upgrade_types( changed } +/// YUNG's API's jigsaw as vanilla's, laid out by its own assembler in the +/// game (`horizon:yungsapi`, `horizon_world::worldgen::structure::yung`): +/// the heights pieces stay within move under the key. Its terrain +/// adaptation and a start offset in the chunk are lost. +fn yung_structure(v: &mut Value, lost: &mut BTreeMap<String, usize>) { + let Some(o) = v.as_object_mut() else { + return; + }; + o.insert("type".into(), "minecraft:jigsaw".into()); + let mut rules = serde_json::Map::new(); + for key in ["min_y", "max_y"] { + if let Some(y) = o.remove(key) { + rules.insert(key.into(), y); + } + } + let none = |a: &Value| a["type"] == "yungsapi:none"; + if o.remove("enhanced_terrain_adaptation") + .is_some_and(|a| !none(&a)) + { + *lost + .entry("enhanced_terrain_adaptation".into()) + .or_default() += 1; + } + for key in ["x_offset_in_chunk", "z_offset_in_chunk"] { + if o.remove(key).is_some_and(|n| n != 0) { + *lost.entry(key.into()).or_default() += 1; + } + } + o.insert("horizon:yungsapi".into(), rules.into()); +} + +/// YUNG's single pool element as vanilla's, its rules under +/// `horizon:yungsapi`: name and `max_count`, depth range, priority, +/// `ignore_bounds` and its condition. Its terrain adaptation, dead-end pool +/// and modifiers are lost. +fn yung_element(element: &mut Value, lost: &mut BTreeMap<String, usize>) { + let Some(o) = element.as_object_mut() else { + return; + }; + o.insert( + "element_type".into(), + "minecraft:single_pool_element".into(), + ); + let mut rules = serde_json::Map::new(); + for (from, to) in [ + ("name", "name"), + ("max_count", "max_count"), + ("min_required_depth", "min_depth"), + ("max_possible_depth", "max_depth"), + ("is_priority", "priority"), + ("ignore_bounds", "ignore_bounds"), + ] { + if let Some(x) = o.remove(from) { + rules.insert(to.into(), x); + } + } + if let Some(c) = o.remove("condition") { + rules.insert("condition".into(), yung_condition(&c, lost)); + } + for key in ["enhanced_terrain_adaptation", "deadend_pool", "modifiers"] { + let empty = + |x: &Value| x.as_array().is_some_and(Vec::is_empty) || x["type"] == "yungsapi:none"; + if o.remove(key).is_some_and(|x| !empty(&x)) { + *lost.entry(format!("yungsapi {key}")).or_default() += 1; + } + } + o.insert("horizon:yungsapi".into(), rules.into()); +} + +/// One of YUNG's structure conditions in the game's terms. `mod_loaded` +/// holds for Minecraft alone: a mod that needs code is not ported, and the +/// pieces it guards would place its blocks. A condition the game does not +/// have does not hold, and is counted. +fn yung_condition(c: &Value, lost: &mut BTreeMap<String, usize>) -> Value { + let t = c["type"].as_str().unwrap_or_default(); + let list = |lost: &mut BTreeMap<String, usize>| -> Value { + let all = c["conditions"].as_array().into_iter().flatten(); + all.map(|x| yung_condition(x, lost)) + .collect::<Vec<_>>() + .into() + }; + let opt = |k: &str| c.get(k).cloned().unwrap_or(Value::Null); + match t.trim_start_matches("yungsapi:") { + "always_true" => serde_json::json!({"type": "true"}), + "not" => { + serde_json::json!({"type": "not", "condition": yung_condition(&c["condition"], lost)}) + } + "all_of" => serde_json::json!({"type": "all_of", "conditions": list(lost)}), + "any_of" => serde_json::json!({"type": "any_of", "conditions": list(lost)}), + "depth" => serde_json::json!({"type": "depth", + "min_depth": opt("min_required_depth"), "max_depth": opt("max_possible_depth")}), + "altitude" => serde_json::json!({"type": "altitude", + "bottom": opt("bottom_cutoff_y"), "top": opt("top_cutoff_y")}), + "random_chance" => serde_json::json!({"type": "random_chance", "chance": opt("chance")}), + "rotation" => serde_json::json!({"type": "rotation", "rotations": opt("rotations")}), + "piece_in_horizontal_direction" => { + // "yungsapi:all" (or no list) matches any piece. + let pieces: Vec<Value> = c["pieces"].as_array().cloned().unwrap_or_default(); + let any = pieces.is_empty() || pieces.iter().any(|p| p == "yungsapi:all"); + serde_json::json!({"type": "piece_in_horizontal_direction", + "pieces": if any { Vec::new() } else { pieces }, + "range": opt("range"), "rotation": opt("rotation")}) + } + "mod_loaded" if c["modid"] == "minecraft" => serde_json::json!({"type": "true"}), + "mod_loaded" => serde_json::json!({"type": "false"}), + _ => { + *lost.entry(format!("yungsapi condition {t}")).or_default() += 1; + serde_json::json!({"type": "false"}) + } + } +} + /// Moves a Repurposed Structures or Moog's jigsaw's start rules under /// `horizon:start_checks`, and counts the layout rules it loses. `liquid` is /// the block its no-start-in-liquid rule reads. @@ -499,7 +618,7 @@ mod tests { {"weight": 1, "element": {"element_type": "moogs_structures:versioned_single_pool_element", "location": "m:x"}}, {"weight": 1, "element": {"element_type": "minecraft:list_pool_element", "elements": [ {"element_type": "empty_pool_element"}]}}, - {"weight": 1, "element": {"element_type": "yungsapi:yung_single_element"}} + {"weight": 1, "element": {"element_type": "somelib:element"}} ]}); assert!(upgrade("template_pool", &mut pool, &mut report, &NO_TAGS)); assert_eq!( @@ -519,7 +638,7 @@ mod tests { "moogs_structures:moogs_structures_generic_nether_jigsaw_structure".into(), 1 ), - ("yungsapi:yung_single_element".into(), 1), + ("somelib:element".into(), 1), ]) ); } @@ -599,6 +718,52 @@ mod tests { assert_eq!(report.rules_lost["super_exclusion_zone"], 1); } + #[test] + fn yungs_jigsaws_keep_their_rules() { + let mut report = Upgrade::default(); + let mut s = json!({"type": "yungsapi:yung_jigsaw", "start_pool": "y:start", "size": 20, + "max_y": 60, "x_offset_in_chunk": 0, "max_distance_from_center": 80, + "enhanced_terrain_adaptation": {"type": "yungsapi:custom", "kernel_size": 24}}); + assert!(upgrade("structure", &mut s, &mut report, &NO_TAGS)); + assert_eq!(s["type"], "minecraft:jigsaw"); + assert_eq!(s["horizon:yungsapi"], json!({"max_y": 60})); + for gone in ["max_y", "x_offset_in_chunk", "enhanced_terrain_adaptation"] { + assert!(s.get(gone).is_none(), "{gone}"); + } + let mut pool = json!({"elements": [{"weight": 3, "element": { + "element_type": "yungsapi:yung_single_element", "location": "y:room", + "processors": "minecraft:empty", "projection": "rigid", + "name": "room", "max_count": 2, "min_required_depth": 1, "is_priority": true, + "ignore_bounds": false, "deadend_pool": "y:end", + "condition": {"type": "yungsapi:all_of", "conditions": [ + {"type": "yungsapi:piece_in_horizontal_direction", "pieces": ["yungsapi:all"], + "range": 5, "rotation": "none"}, + {"type": "yungsapi:not", "condition": {"type": "yungsapi:mod_loaded", "modid": "create"}}, + {"type": "yungsapi:biome", "biomes": []}]}}}]}); + assert!(upgrade("template_pool", &mut pool, &mut report, &NO_TAGS)); + let e = &pool["elements"][0]["element"]; + assert_eq!(e["element_type"], "minecraft:single_pool_element"); + assert_eq!(e["location"], "y:room"); + assert_eq!( + e["horizon:yungsapi"], + json!({"name": "room", "max_count": 2, "min_depth": 1, "priority": true, + "ignore_bounds": false, "condition": {"type": "all_of", "conditions": [ + {"type": "piece_in_horizontal_direction", "pieces": [], "range": 5, "rotation": "none"}, + {"type": "not", "condition": {"type": "false"}}, + {"type": "false"}]}}) + ); + assert!(e.get("deadend_pool").is_none()); + assert_eq!( + report.rules_lost, + BTreeMap::from([ + ("enhanced_terrain_adaptation".into(), 1), + ("yungsapi condition yungsapi:biome".into(), 1), + ("yungsapi deadend_pool".into(), 1), + ]) + ); + assert!(report.unsupported.is_empty()); + } + #[test] fn drops_processors_written_in_java() { let mut report = Upgrade::default(); From 7ddb4ddae5433a0b474a3b55b72cab86cf8d96e1 Mon Sep 17 00:00:00 2001 From: LookImEcho-Rick <62575172+LookImEcho-Rick@users.noreply.github.com> Date: Sun, 18 Oct 2026 03:02:53 -0500 Subject: [PATCH 084/163] Fix falling block collisions with partial blocks --- crates/horizon-client/src/collisions.rs | 15 +- crates/horizon-client/src/game.rs | 208 ++++++++++++++++++------ tools/test_world_movement_parity.py | 16 +- 3 files changed, 189 insertions(+), 50 deletions(-) diff --git a/crates/horizon-client/src/collisions.rs b/crates/horizon-client/src/collisions.rs index 5d5f4c1bb..a52f25ce7 100644 --- a/crates/horizon-client/src/collisions.rs +++ b/crates/horizon-client/src/collisions.rs @@ -131,12 +131,25 @@ impl SceneCollisions<'_, '_> { movement: Vec3, max_step: f32, on_ground: bool, + ) -> Result<Vec3> { + self.resolve_with_context(bounds, movement, max_step, on_ground, self.context(bounds)) + } + /// Resolve movement with the entity's captured collision context. Most + /// callers only need the position context; entities such as falling blocks + /// also affect contextual block shapes (for example powder snow). + pub fn resolve_with_context( + &mut self, + bounds: Aabb, + movement: Vec3, + max_step: f32, + on_ground: bool, + context: CollisionContext<'_>, ) -> Result<Vec3> { Ok(resolve_world_movement( self, MovementRequest { entity: EntityIdentity(0), - context: self.context(bounds), + context, bounds, movement, max_step, diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 2ac64c50a..2b4091821 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -193,6 +193,8 @@ use horizon_core::{ use horizon_core::{geometry::Vec3, random::RandomSource}; use horizon_world::{ block_collision::BlockCollisionRegistry, + collision_context::{CollisionContext, CollisionEntity, CollisionItem}, + entity_obstruction::{EntityIdentity, EntityObstructionWorld, ObstructionEntity}, level::{ Behaviours, Dimension as LevelDimension, EntityQuery, Landing, LevelAccess, LevelEvent, PlaceContext, PlaceOutcome, PlayerContext, PlayerEffect, Ticks, flags as level_flags, @@ -451,12 +453,14 @@ struct Hit { struct GameLevel<'w> { world: &'w mut World, facts: &'w BlockFacts, + collision: &'w BlockCollisionRegistry<'w>, events: &'w mut Vec<LevelEvent>, dimension: LevelDimension, darken: i32, raining: bool, thundering: bool, player_box: Option<([f64; 3], [f64; 3])>, + player_collision: Option<PlayerCollision>, /// Minecart boxes (detector rails). cart_boxes: Vec<([f64; 3], [f64; 3])>, biomes: &'w Biomes, @@ -472,6 +476,32 @@ struct GameLevel<'w> { pending: &'w mut spill::Pending, spill: &'w mut spill::Spill, } +struct PlayerCollision { + y: f64, + descending: bool, + fall_distance: f64, + main_hand_item: Arc<str>, + main_hand_count: i32, + leather_boots: bool, +} +struct PlayerObstruction(Aabb); +impl EntityObstructionWorld for PlayerObstruction { + type Error = std::convert::Infallible; + fn obstruction_candidates( + &mut self, + _excluded: Option<EntityIdentity>, + _bounds: Aabb, + ) -> std::result::Result<Vec<ObstructionEntity>, Self::Error> { + Ok(vec![ObstructionEntity { + identity: EntityIdentity(0), + root_vehicle: EntityIdentity(0), + bounds: self.0, + removed: false, + spectator: false, + blocks_building: true, + }]) + } +} impl LevelAccess for GameLevel<'_> { fn precipitation(&self, pos: BlockPos) -> Option<horizon_world::level::Precipitation> { self.behaviours.precipitation_info(self, pos) @@ -584,21 +614,63 @@ impl LevelAccess for GameLevel<'_> { fn dimension(&self) -> LevelDimension { self.dimension } - /// Level.isUnobstructed against the player for full-collision blocks. + /// `Level.isUnobstructed`: the placed state's collision shape against the player. fn is_unobstructed(&self, pos: BlockPos, state: BlockStateId) -> bool { let Some((lo, hi)) = self.player_box else { return true; }; - if !self.facts.get(state).full_collision { + let player = self.player_collision.as_ref(); + let context = player.map_or_else( + || CollisionContext::position(lo[1]), + |player| { + CollisionContext::for_entity( + CollisionEntity { + identity: EntityIdentity(0), + y: player.y, + descending: player.descending, + main_hand: Some(CollisionItem { + item: &player.main_hand_item, + count: player.main_hand_count, + }), + }, + false, + ) + }, + ); + let mut scene = collisions::SceneCollisions { + world: &*self.world, + binding: self.collision, + subject: player.map(|player| horizon_client::collisions::PowderSnowSubject { + fall_distance: player.fall_distance, + falling_block: false, + leather_boots: player.leather_boots, + walkable_type: false, + lava_walker: false, + }), + }; + let Ok(shape) = self + .collision + .collision_shape_with_context(&mut scene, state, pos, &context) + else { + return false; + }; + if shape.is_empty() { return true; } - let (x, y, z) = (f64::from(pos.x), f64::from(pos.y), f64::from(pos.z)); - !(x < hi[0] - 1e-7 - && x + 1.0 > lo[0] + 1e-7 - && y < hi[1] - 1e-7 - && y + 1.0 > lo[1] + 1e-7 - && z < hi[2] - 1e-7 - && z + 1.0 > lo[2] + 1e-7) + let shape = shape.moved(horizon_core::geometry::Vec3::new( + f64::from(pos.x), + f64::from(pos.y), + f64::from(pos.z), + )); + horizon_world::entity_obstruction::is_unobstructed( + &mut PlayerObstruction(Aabb::new( + horizon_core::geometry::Vec3::new(lo[0], lo[1], lo[2]), + horizon_core::geometry::Vec3::new(hi[0], hi[1], hi[2]), + )), + None, + &shape, + ) + .unwrap_or(false) } /// Entities that trigger pressure plates, tripwires and detector rails: /// the player (a mob) and the minecarts. @@ -1769,6 +1841,22 @@ impl Game<'_> { ], ) }); + let player_collision = self.player.as_ref().filter(|_| !spectator).map(|p| { + let main_hand = self.inventory.get(self.selected).and_then(Option::as_ref); + PlayerCollision { + y: p.position.y, + descending: p.velocity.y < 0.0, + fall_distance: p.fall_distance, + main_hand_item: main_hand.map_or_else( + || Arc::from("minecraft:air"), + |stack| Arc::clone(&stack.item), + ), + main_hand_count: main_hand.map_or(0, |stack| stack.count as i32), + leather_boots: self.armor[3] + .as_ref() + .is_some_and(|stack| stack.item.as_ref() == "minecraft:leather_boots"), + } + }); let cart_boxes = self .carts .iter() @@ -1790,12 +1878,14 @@ impl Game<'_> { cart_boxes, world: &mut self.world, facts: &self.res.facts, + collision: self.collision, events: &mut self.level_events, dimension, darken, raining: rain > 0.2, thundering: thunder > 0.9, player_box, + player_collision, biomes: &self.res.biomes, seed: self.level.seed, behaviours: &self.res.behaviours, @@ -2297,65 +2387,87 @@ impl Game<'_> { let mut falling = std::mem::take(&mut self.falling); let mut landed = Vec::new(); let mut dropped = Vec::new(); + let mut collision_error = None; let entity_drops = self.ui.rules.bool("entity_drops"); falling.retain_mut(|f| { + let original = f.clone(); f.previous = f.position; f.age = f.age.wrapping_add(1); if !f.no_gravity { f.velocity.y -= 0.04; } + let wanted = f.velocity; + let mut scene = collisions::SceneCollisions { + world: &self.world, + binding: self.collision, + subject: Some(collisions::PowderSnowSubject { + fall_distance: f.fall_distance, + falling_block: true, + ..Default::default() + }), + }; + let context = CollisionContext::for_entity( + CollisionEntity { + identity: EntityIdentity(0), + y: f.position.y, + descending: wanted.y < 0.0, + main_hand: None, + }, + false, + ); + let movement = match scene.resolve_with_context( + horizon_client::falling_block::bounds(f.position), + wanted, + 0.0, + false, + context, + ) { + Ok(movement) => movement, + Err(error) => { + *f = original; + collision_error.get_or_insert(error); + return true; + } + }; let next = Vec3::new( - f.position.x + f.velocity.x, - f.position.y + f.velocity.y, - f.position.z + f.velocity.z, + f.position.x + movement.x, + f.position.y + movement.y, + f.position.z + movement.z, ); - let below = self.world.block( - next.x.floor() as i32, - next.y.floor() as i32, - next.z.floor() as i32, - ); - let below_facts = self.res.facts.get(below); - // PowderSnowBlock.getCollisionShape for a FallingBlockEntity: the - // whole block, or 0.9 high after a fall of more than 2.5 blocks, - // where the block it rests in is the snow itself. - let powder_snow = &*below_facts.name == "minecraft:powder_snow"; - let sunk = powder_snow - && f.fall_distance > 2.5 - && next.y - next.y.floor() < f64::from(0.9_f32); - let solid = - (below_facts.full_collision || powder_snow && f.fall_distance <= 2.5 || sunk) - && f.velocity.y < 0.0; + let on_ground = wanted.y < 0.0 && movement.y != wanted.y; // FallingBlockEntity.tick: off the ground, it gives up after 600 // ticks (100 outside the world) and drops itself as an item. let y = next.y.floor() as i32; let outside = y <= horizon_client::chunk::MIN_Y || y >= horizon_client::chunk::MIN_Y + 384; - if !solid && (f.age > 100 && outside || f.age > 600) { + if !on_ground && (f.age > 100 && outside || f.age > 600) { if f.drop_item && entity_drops { dropped.push((f.state, next)); } return false; } - if solid { - let pos = [ - next.x.floor() as i32, - next.y.floor() as i32 + i32::from(!sunk), - next.z.floor() as i32, - ]; - let landing_y = if sunk { - next.y.floor() + f64::from(0.9_f32) - } else { - f64::from(pos[1]) - }; - f.fall_distance += (f.position.y - landing_y).max(0.0); - f.position = Vec3::new(next.x, landing_y, next.z); - landed.push((f.clone(), pos)); - return false; - } if next.y < f.position.y { f.fall_distance += f.position.y - next.y; } f.position = next; + if on_ground { + let pos = [ + f.position.x.floor() as i32, + f.position.y.floor() as i32, + f.position.z.floor() as i32, + ]; + landed.push((f.clone(), pos)); + return false; + } + if movement.x != wanted.x { + f.velocity.x = 0.0; + } + if movement.y != wanted.y { + f.velocity.y = 0.0; + } + if movement.z != wanted.z { + f.velocity.z = 0.0; + } f.velocity = Vec3::new( f.velocity.x * 0.98, f.velocity.y * 0.98, @@ -2386,7 +2498,11 @@ impl Game<'_> { for (block, pos) in landed { self.finish_falling_block(block, pos); } - self.process_level_events() + self.process_level_events()?; + if let Some(error) = collision_error { + return Err(error); + } + Ok(()) } fn break_block(&mut self, pos: [i32; 3]) -> Result<()> { self.with_player_actor(|game| game.break_block_as_player(pos)) diff --git a/tools/test_world_movement_parity.py b/tools/test_world_movement_parity.py index 8cffb456c..e01a989f5 100644 --- a/tools/test_world_movement_parity.py +++ b/tools/test_world_movement_parity.py @@ -18,18 +18,28 @@ except ImportError: def corpus(facts): def bits(v):return struct.pack('>d',float(v)).hex() - def row(state,delta=(1,-0.08,0),step=0.6,grounded=True,context=2,offset=0,fail=-1,extra=(),entities=(),border=None): + def row(state,delta=(1,-0.08,0),step=0.6,grounded=True,context=2,offset=0,fail=-1,extra=(),entities=(),border=None,box=None): blocks=[[x+offset,-1,z,facts['defaults']['minecraft:stone']] for x in range(-2,4) for z in range(-2,3)] blocks.append([offset,0,0,state]);blocks.extend(extra) return dict(chunks=[[x,z] for x in range((offset>>4)-1,(offset>>4)+2) for z in range(-1,2)], blocks=blocks,context=context,y=bits(0),entities=[0,0],fail=fail,limit=100000,suffocating=False, - box=list(map(bits,[-0.6+offset,0,0.2,-0.2+offset,1.8,0.8])), + box=list(map(bits,box if box is not None else [-0.6+offset,0,0.2,-0.2+offset,1.8,0.8])), movement=dict(delta=list(map(bits,delta)),step=bits(step),grounded=grounded, entities=[list(map(bits,b)) for b in entities],border=None if border is None else list(map(bits,border)))) states=facts['states'] for state in range(len(states)): yield row(state,context=state%4) defaults=facts['defaults'] + falling_surfaces=[('minecraft:stone_slab',0.5),('minecraft:oak_stairs',1.0),('minecraft:snow',0.125), + ('minecraft:oak_fence',1.5),('minecraft:iron_bars',1.0),('minecraft:soul_sand',0.875), + ('minecraft:farmland',0.9375)] + for block_id,top in falling_surfaces: + state=defaults[block_id] + size=struct.unpack('>f',struct.pack('>f',0.98))[0] + half=size/2 + bottom=top+0.1 + box=[0.5-half,bottom,0.5-half,0.5+half,bottom+size,0.5+half] + yield row(state,delta=(0,-0.25,0),step=0,grounded=False,context=2,box=box) obstacles=[i for i,s in enumerate(states) if s['id'] in ['minecraft:oak_stairs','minecraft:stone_slab', 'minecraft:snow','minecraft:scaffolding','minecraft:powder_snow','minecraft:water', 'minecraft:shulker_box','minecraft:moving_piston','minecraft:piston','minecraft:soul_sand', @@ -114,7 +124,7 @@ def main(): 'definition_counts':dict(collections.Counter(definitions.values())), 'native_chunk_storage':'ProtoChunk', 'rust_chunk_storage':'TerrainChunk', 'fixtures':count, 'sources_sha256':tested, 'fixtures_sha256':fixtures, 'rust_output_sha256':lab.digest(build/'rust.txt', 'sha256'), 'references':references, - 'scope':'Actual native Entity.collide executes initial collision and step-up decisions over BlockCollisions, registered block shapes and resident ProtoChunk sections. Rust combines owned/fallible step resolution with registry-bound TerrainChunk scanning. All registered states are used as obstacles, plus step heights, falling/grounded motion, zero and underflow motion, partial blocks, fluids, dynamic blocks, ceilings, chunk boundaries and query failures. Entity collider lists and world-border proximity/shape are controlled inputs; query order and reuse, shape collection and resulting displacement are compared. Contexts are deliberately supplied empty/position/placement snapshots in both worlds. This does not establish entity broad-phase selection, actual world-border proximity, travel/gravity/velocity or grounded side effects, experimental minecarts or a playable game.'} + 'scope':'Actual native Entity.collide executes initial collision and step-up decisions over BlockCollisions, registered block shapes and resident ProtoChunk sections. Rust combines owned/fallible step resolution with registry-bound TerrainChunk scanning. All registered states are used as obstacles, plus step heights, falling/grounded motion, zero and underflow motion, partial blocks including exact falling-block-sized boxes over slabs, stairs, snow, fences, iron bars, soul sand and farmland, fluids, dynamic blocks, ceilings, chunk boundaries and query failures. Entity collider lists and world-border proximity/shape are controlled inputs; query order and reuse, shape collection and resulting displacement are compared. Contexts are deliberately supplied empty/position/placement snapshots in both worlds. This does not establish entity broad-phase selection, actual world-border proximity, travel/gravity/velocity or grounded side effects, experimental minecarts or a playable game.'} lab.write_json(report_path, report);print(f'Scoped world movement parity passed: {report_path}', flush=True) From 9dd896bfc30d26c69c83adafb2cb018c2800bdec Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 10:10:57 +0200 Subject: [PATCH 085/163] tooltip_display harness: write the case flags in lowercase Rust's bool parser takes only true/false, so the fixture failed on Python's True/False; Java's Boolean.parseBoolean ignores case. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- tools/test_tooltip_display_parity.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/tools/test_tooltip_display_parity.py b/tools/test_tooltip_display_parity.py index e98807d1b..22b485320 100644 --- a/tools/test_tooltip_display_parity.py +++ b/tools/test_tooltip_display_parity.py @@ -16,7 +16,8 @@ def cases(build): (True, True, True), ] path = build / 'cases.txt' - path.write_text('\n'.join('\t'.join(map(str, row)) for row in values) + '\n') + # Lowercase: Rust's bool parser takes only true/false (Java's parseBoolean ignores case). + path.write_text('\n'.join('\t'.join(str(v).lower() for v in row) for row in values) + '\n') return path, len(values) From c7c97259420125dab174b8efb966628afb054f90 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 10:22:22 +0200 Subject: [PATCH 086/163] Structures: YUNG's placements and their vanilla counterparts turned off Three keys a carried mod's data can hold, which vanilla data never has: - "horizon:ring_sections" on a random spread (BetterStrongholdsPlacement): starts only in the odd rings around the origin, with Java's int math. - "horizon:avoid_biomes" (BetterDesertTemplePlacement and BetterJungleTemplePlacement): no start when one of the biomes is found around the chunk's middle block, as findBiomeHorizontal samples it. - "horizon:disables" on a structure: every structure of the listed types fails to start, as YUNG's DisableVanilla*Mixin makes ChunkGenerator.tryGenerateStructure return false; in a set of several structures the next one is tried, as in vanilla. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../src/worldgen/structure/start.rs | 243 ++++++++++++++++++ 1 file changed, 243 insertions(+) diff --git a/crates/horizon-world/src/worldgen/structure/start.rs b/crates/horizon-world/src/worldgen/structure/start.rs index a66f27509..c585bec77 100644 --- a/crates/horizon-world/src/worldgen/structure/start.rs +++ b/crates/horizon-world/src/worldgen/structure/start.rs @@ -97,6 +97,9 @@ pub struct StructureDef { pub biomes: BTreeSet<BiomeId>, pub step: usize, pub terrain: TerrainAdjustment, + /// Another loaded structure turns this one's type off + /// (`"horizon:disables"`): it never starts. + pub disabled: bool, } #[derive(Clone, Copy, Debug, PartialEq, Eq)] enum Reduction { @@ -137,6 +140,107 @@ pub struct StructureSet { /// (`"horizon:exclusion_zone"`: `other_sets`, `chunk_count`). min_distance: Option<i64>, avoid: Option<(Vec<String>, i32)>, + /// `"horizon:ring_sections"`: starts only in odd rings around the origin. + rings: Option<RingSections>, + /// `"horizon:avoid_biomes"`: no start with one of these biomes near. + avoid_biomes: Option<AvoidBiomes>, +} + +/// YUNG's Better Strongholds' placement (BetterStrongholdsPlacement +/// .isPlacementChunk): the world is cut into rings `thickness` chunks wide, +/// the first one starting `distance_to_first_ring` chunks out; a start is +/// placed only in the odd ones, and in none past `max_section`. +/// +/// ```json +/// "horizon:ring_sections": {"distance_to_first_ring": 80, "thickness": 96, "max_section": 5} +/// ``` +#[derive(Debug, Clone, PartialEq, Eq)] +struct RingSections { + first: i32, + thickness: i32, + max: Option<i32>, +} +impl RingSections { + fn decode(v: &Value) -> Self { + let int = |k: &str| v[k].as_i64().map(|n| n as i32); + Self { + first: int("distance_to_first_ring").unwrap_or(0), + thickness: int("thickness").unwrap_or(1).max(1), + max: int("max_section"), + } + } + fn allows(&self, x: i32, z: i32) -> bool { + // Java int arithmetic: the squares wrap past 46,340 chunks, and the + // square root of a negative int is NaN, which casts to 0. + let squared = x.wrapping_mul(x).wrapping_add(z.wrapping_mul(z)); + let distance = f64::from(squared).sqrt() as i32; + let section = distance.wrapping_add(self.thickness - self.first) / self.thickness; + !self.max.is_some_and(|max| section > max) && section % 2 == 1 + } +} + +/// YUNG's Better Desert and Jungle Temples' placement: no start when a +/// biome of the set is found around the chunk's middle block at height `y` +/// (BiomeSource.findBiomeHorizontal with `radius` blocks and `step` quarts +/// between samples, closest first). +/// +/// ```json +/// "horizon:avoid_biomes": {"biomes": ["#minecraft:is_river", "#minecraft:is_ocean"], +/// "radius": 48, "step": 2, "y": 120} +/// ``` +#[derive(Debug)] +struct AvoidBiomes { + biomes: BTreeSet<BiomeId>, + radius: i32, + step: i32, + y: i32, +} +impl AvoidBiomes { + fn decode( + v: &Value, + biome_set: &dyn Fn(&Value) -> Result<BTreeSet<BiomeId>, DecodeError>, + ) -> Result<Self, DecodeError> { + let mut biomes = BTreeSet::new(); + match &v["biomes"] { + Value::Array(list) => { + for entry in list { + biomes.extend(biome_set(entry)?); + } + } + other => biomes = biome_set(other)?, + } + let int = |k: &str, default: i32| v[k].as_i64().map_or(default, |n| n as i32); + Ok(Self { + biomes, + radius: int("radius", 0), + step: int("step", 1).max(1), + y: int("y", 0), + }) + } + fn near(&self, chunk: ChunkPos, mut biome: impl FnMut([i32; 3]) -> BiomeId) -> bool { + // ChunkPos.getMiddleBlockPosition, then QuartPos.fromBlock. + let (cx, cz) = ((chunk.x * 16 + 8) >> 2, (chunk.z * 16 + 8) >> 2); + let (radius, y) = (self.radius >> 2, self.y >> 2); + let mut r = 0; + while r <= radius { + let mut dz = -r; + while dz <= r { + let z_edge = dz.abs() == r; + let mut dx = -r; + while dx <= r { + if (z_edge || dx.abs() == r) + && self.biomes.contains(&biome([cx + dx, y, cz + dz])) + { + return true; + } + dx += self.step; + } + dz += self.step; + } + r += self.step; + } + false + } } fn heightmap(name: &str) -> Option<HeightmapType> { @@ -182,8 +286,19 @@ impl StructureRegistry { biome_set: &dyn Fn(&Value) -> Result<BTreeSet<BiomeId>, DecodeError>, ) -> Result<Self, DecodeError> { let mut defs = Vec::new(); + let (mut types, mut disables) = (Vec::new(), BTreeSet::new()); for (name, json) in structures { let v: Value = serde_json::from_str(json)?; + types.push(v["type"].as_str().unwrap_or_default().to_owned()); + // YUNG's mods turn their vanilla counterparts off (the + // DisableVanilla*Mixin on ChunkGenerator.tryGenerateStructure). + disables.extend( + v["horizon:disables"] + .as_array() + .into_iter() + .flatten() + .filter_map(|t| Some(t.as_str()?.to_owned())), + ); let kind = match v["type"].as_str().unwrap_or_default() { "minecraft:jigsaw" => StructureKind::Jigsaw(JigsawDef { start_pool: v["start_pool"].as_str().unwrap_or_default().to_owned(), @@ -251,8 +366,12 @@ impl StructureRegistry { .position(|s| Some(*s) == v["step"].as_str()) .unwrap_or(4), terrain: terrain(v["terrain_adaptation"].as_str()), + disabled: false, }); } + for (def, kind) in defs.iter_mut().zip(&types) { + def.disabled = disables.contains(kind); + } let index = |name: &str| defs.iter().position(|d| d.name == name); let mut out = Vec::new(); for (name, json) in sets { @@ -314,6 +433,11 @@ impl StructureRegistry { z["chunk_count"].as_i64().unwrap_or(0) as i32, ) }), + rings: p.get("horizon:ring_sections").map(RingSections::decode), + avoid_biomes: p + .get("horizon:avoid_biomes") + .map(|a| AvoidBiomes::decode(a, biome_set)) + .transpose()?, }); } Ok(Self { @@ -420,6 +544,9 @@ impl StructureRegistry { if !placed { return false; } + if set.rings.as_ref().is_some_and(|r| !r.allows(x, z)) { + return false; + } // AdvancedRandomSpread.isPlacementChunk, in blocks from the chunk's corner. if let Some(d) = set.min_distance { let (bx, bz) = (i64::from(x) * 16, i64::from(z) * 16); @@ -591,6 +718,16 @@ pub fn create_starts( if !registry.is_structure_chunk(set, seed, chunk.x, chunk.z, rings) { continue; } + // Part of the set's placement in YUNG's mods; checked here, where the + // biome source is at hand, so another set's exclusion zone naming + // this one does not see it. + if set + .avoid_biomes + .as_ref() + .is_some_and(|a| a.near(chunk, |q| context.noise_biome(q))) + { + continue; + } if set.structures.len() == 1 { if let Some(start) = try_generate( registry, @@ -640,6 +777,9 @@ fn try_generate( chunk: ChunkPos, ) -> Option<StructureStart> { let def = ®istry.structures[structure]; + if def.disabled { + return None; + } context.set_valid_biomes(&def.biomes); let seed = context.seed(); let mut random = WorldgenRandom::new(LegacyRandom::new(0)); @@ -1114,3 +1254,106 @@ pub fn place_in_chunk<W: FeatureWorld + PlacementContext, R: RandomSource + 'sta } Ok(()) } + +#[cfg(test)] +mod tests { + use super::*; + use serde_json::json; + + fn registry(structures: &[(&str, Value)], sets: &[(&str, Value)]) -> StructureRegistry { + let text = |l: &[(&str, Value)]| { + l.iter() + .map(|(k, v)| ((*k).to_owned(), v.to_string())) + .collect::<BTreeMap<_, _>>() + }; + // Biome tags: `#t:one` is biome 1, `#t:two` biome 2. + StructureRegistry::new(&text(structures), &text(sets), BTreeMap::new(), &|v| { + Ok(match v.as_str() { + Some("#t:one") => BTreeSet::from([BiomeId(1)]), + Some("#t:two") => BTreeSet::from([BiomeId(2)]), + _ => BTreeSet::new(), + }) + }) + .unwrap() + } + + #[test] + fn a_structure_turns_its_vanilla_counterpart_off() { + let r = registry( + &[ + ( + "minecraft:pyramid", + json!({"type": "minecraft:desert_pyramid"}), + ), + ("minecraft:igloo", json!({"type": "minecraft:igloo"})), + ( + "yung:temple", + json!({"type": "minecraft:swamp_hut", "horizon:disables": ["minecraft:desert_pyramid"]}), + ), + ], + &[], + ); + let disabled: Vec<_> = r + .structures + .iter() + .map(|d| (d.name.as_str(), d.disabled)) + .collect(); + assert_eq!( + disabled, + [ + ("minecraft:igloo", false), + ("minecraft:pyramid", true), + ("yung:temple", false) + ] + ); + } + + #[test] + fn ring_sections_keep_the_odd_rings() { + let rings = RingSections::decode( + &json!({"distance_to_first_ring": 80, "thickness": 96, "max_section": 3}), + ); + // (d + 16) / 96: 0 inside 80 chunks, 1 to 175, 2 to 271, 3 to 367. + assert!(!rings.allows(79, 0)); + assert!(rings.allows(80, 0)); + assert!(rings.allows(0, -175)); + assert!(!rings.allows(176, 0)); + assert!(rings.allows(272, 0)); + assert!(!rings.allows(464, 0), "section 5 is past max_section 3"); + // Java's int square wraps: 50,000² + 0 is negative, its root NaN, 0. + assert!(!rings.allows(50_000, 0)); + let open = RingSections::decode(&json!({"distance_to_first_ring": 80, "thickness": 96})); + assert!(open.allows(464, 0)); + } + + #[test] + fn avoid_biomes_samples_around_the_middle_block() { + let r = registry( + &[], + &[( + "yung:temples", + json!({"structures": [], "placement": {"type": "minecraft:random_spread", + "spacing": 24, "separation": 8, "salt": 1, + "horizon:avoid_biomes": {"biomes": ["#t:one", "#t:two"], + "radius": 48, "step": 2, "y": 120}}}), + )], + ); + let avoid = r.sets[0].avoid_biomes.as_ref().unwrap(); + assert_eq!(avoid.biomes, BTreeSet::from([BiomeId(1), BiomeId(2)])); + // Chunk (1, -1): middle block (24, 120, -8), quart (6, 30, -2). + let mut asked = Vec::new(); + assert!(!avoid.near(ChunkPos::new(1, -1), |q| { + asked.push(q); + BiomeId(0) + })); + assert_eq!(asked[0], [6, 30, -2]); + // Every even offset within 12 quarts, once: 13 x 13. + assert_eq!(asked.len(), 169); + assert!(asked.contains(&[6 - 12, 30, -2 + 12])); + assert!(!asked.contains(&[7, 30, -2])); + // An ocean on the edge of the square is found. + assert!(avoid.near(ChunkPos::new(1, -1), |q| { + BiomeId(if q == [18, 30, 10] { 2 } else { 0 }) + })); + } +} From c63fa742393405cc57f8551a2eb1013af9bdbcdd Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 07:44:30 +0200 Subject: [PATCH 087/163] Server: track each entity once for all its clients, as vanilla's ServerEntity Every guest had its own copy of what it was last told about every entity, so each tick compared each entity's data and built and encoded its update packets once per guest. A level now keeps one ServerEntity state per entity (ChunkMap.entityMap), whose changes are worked out once a tick, encoded once and sent to every guest tracking it; a guest's Tracker is the set of entities it is paired with. The update cadence is the entity's own tickCount, as vanilla's, and late clients are paired with the data the others hold. The per-tick copy of every entity state, the id lists and the packet lists are gone too. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/lan/conn.rs | 13 + crates/horizon-client/src/lan/entity.rs | 638 +++++++++++++++++------- crates/horizon-client/src/lan/hub.rs | 119 ++--- 3 files changed, 528 insertions(+), 242 deletions(-) diff --git a/crates/horizon-client/src/lan/conn.rs b/crates/horizon-client/src/lan/conn.rs index 5c448d8ab..2805cf1da 100644 --- a/crates/horizon-client/src/lan/conn.rs +++ b/crates/horizon-client/src/lan/conn.rs @@ -174,6 +174,19 @@ impl PlayerSender { self.deliver(Out::Packet(body)); } } + /// Several packets in order, as [`Self::send`] each: under one lock + /// while the tick holds them. + pub fn send_many(&self, bodies: impl IntoIterator<Item = Vec<u8>>) { + if !HOLDING.get() { + bodies.into_iter().for_each(|body| self.send(body)); + return; + } + let mut held = self.held(); + for body in bodies { + self.pending.fetch_add(body.len(), Ordering::Relaxed); + held.push(body); + } + } /// Hand the held packets to the writer thread. pub fn flush(&self) { let held = std::mem::take(&mut *self.held()); diff --git a/crates/horizon-client/src/lan/entity.rs b/crates/horizon-client/src/lan/entity.rs index 36e153c02..3d8090267 100644 --- a/crates/horizon-client/src/lan/entity.rs +++ b/crates/horizon-client/src/lan/entity.rs @@ -1,8 +1,10 @@ //! Entity tracking (ChunkMap.TrackedEntity / ServerEntity): the game describes -//! every entity it simulates as an `EntityState` each tick; a `Tracker` -//! remembers what one client has been told and produces the spawn, movement, -//! motion, metadata, equipment and removal packets that bring it up to date, -//! at the entity type's update interval (`tracking`). +//! every entity it simulates as an `EntityState` each tick. A level's +//! `Entities` remember what its clients were last told about each entity, +//! once for all of them as vanilla's ServerEntity does, and produce the +//! movement, motion, metadata and equipment packets that bring them up to +//! date at the entity type's update interval (`tracking`); each client's +//! `Tracker` is the set of entities it has been paired with. use super::tracking; use horizon_protocol::{ buf::pack_degrees, @@ -61,29 +63,6 @@ fn acceleration_power(kind: &str) -> Option<f64> { } } -/// What a client was last told about one entity (ServerEntity's fields). -struct Sent { - /// VecDeltaCodec's base: the last position sent. - base: [f64; 3], - /// lastSentYRot / lastSentXRot / lastSentYHeadRot. - rotation: (i8, i8), - head: i8, - /// lastSentMovement. - velocity: [f64; 3], - meta: Vec<(u8, i32, Value)>, - equipment: Vec<(u8, Option<Stack>)>, - was_on_ground: bool, - tick: u32, - teleport_delay: u32, - /// The type's update interval (0: never) and whether velocity is tracked. - interval: u32, - track_deltas: bool, - /// lastPassengers, and wasRiding: a passenger's position isn't synced, - /// and the first update after it dismounts is a full position sync. - passengers: Vec<i32>, - was_riding: bool, -} - /// Who rides what this tick (`Entity.getPassengers`, `isPassenger`). #[derive(Default)] pub struct Riding { @@ -114,9 +93,42 @@ impl Riding { } } -#[derive(Default)] -pub struct Tracker { - sent: crate::fast_hash::FxHashMap<i32, Sent>, +/// What a level's clients were last told about one entity (ServerEntity's +/// fields), shared by every client that tracks it. +struct ServerEntity { + /// The registry id of its type (None: a type the clients don't know, + /// never paired). + kind: Option<i32>, + /// The type's tracking range in chunks, update interval (0: never), + /// whether velocity is tracked, whether it is an `AbstractArrow` and its + /// `AbstractHurtingProjectile.accelerationPower`. + range: i32, + interval: u32, + track_deltas: bool, + arrow: bool, + power: Option<f64>, + /// VecDeltaCodec's base: the last position sent. + base: [f64; 3], + /// lastSentYRot / lastSentXRot / lastSentYHeadRot. + rotation: (i8, i8), + head: i8, + /// lastSentMovement. + velocity: [f64; 3], + /// trackedDataValues: the entity data the clients hold. + meta: Vec<(u8, i32, Value)>, + equipment: Vec<(u8, Option<Stack>)>, + was_on_ground: bool, + tick: u32, + teleport_delay: u32, + /// lastPassengers, and wasRiding: a passenger's position isn't synced, + /// and the first update after it dismounts is a full position sync. + passengers: Vec<i32>, + was_riding: bool, + /// The level tick it was last seen in, its place in that tick's list, and + /// whether it was added in it (its first update is the next tick's). + seen: u32, + index: usize, + added: bool, } /// VecDeltaCodec.encode. @@ -124,116 +136,94 @@ fn encode(v: f64) -> i64 { (v * 4096.0).round() as i64 } -/// The type's tracking range in chunks: a client sees an entity of `kind` -/// within it, capped by the view distance, horizontally -/// (TrackedEntity.updatePlayer). -pub fn tracking_chunks(kind: &str) -> i32 { - i32::from(tracking::settings(kind).0) -} - -impl Tracker { - pub fn is_tracking(&self, id: i32) -> bool { - self.sent.contains_key(&id) - } - pub fn ids(&self) -> Vec<i32> { - self.sent.keys().copied().collect() - } - pub fn forget(&mut self, id: i32) { - self.sent.remove(&id); - } - pub fn clear(&mut self) { - self.sent.clear(); - } - pub fn len(&self) -> usize { - self.sent.len() - } - pub fn is_empty(&self) -> bool { - self.sent.is_empty() +impl ServerEntity { + /// `new ServerEntity`: the entity as it is when it joins the level. + fn new(e: &EntityState, kind: Option<i32>, riding: &Riding) -> Self { + let (range, interval, track_deltas) = tracking::settings(&e.kind); + Self { + kind, + range: i32::from(range), + interval, + track_deltas, + arrow: is_arrow(&e.kind), + power: acceleration_power(&e.kind), + base: e.position, + rotation: (pack_degrees(e.pitch), pack_degrees(e.yaw)), + head: pack_degrees(e.head_yaw), + velocity: e.velocity, + meta: e.meta.clone(), + equipment: e.equipment.clone(), + was_on_ground: e.on_ground, + tick: 0, + teleport_delay: 0, + passengers: riding.passengers(e.id).to_vec(), + was_riding: false, + seen: 0, + index: 0, + added: true, + } } - /// The packets that introduce an entity (ServerEntity.sendPairingData). - pub fn spawn( - &mut self, + /// ServerEntity.sendPairingData: the packets that introduce the entity + /// to a client that starts tracking it. + fn pairing( + &self, e: &EntityState, - entity_type: i32, + kind: i32, riding: &Riding, - ) -> Vec<play::Clientbound> { - let rotation = (pack_degrees(e.pitch), pack_degrees(e.yaw)); - let head = pack_degrees(e.head_yaw); - let (_, interval, track_deltas) = tracking::settings(&e.kind); - let mut out = vec![play::Clientbound::AddEntity(AddEntity { + out: &mut Vec<play::Clientbound>, + ) { + out.push(play::Clientbound::AddEntity(AddEntity { id: e.id, uuid: e.uuid, - kind: entity_type, + kind, position: e.position, velocity: e.velocity, - pitch: rotation.0, - yaw: rotation.1, - head_yaw: head, + pitch: pack_degrees(e.pitch), + yaw: pack_degrees(e.yaw), + head_yaw: pack_degrees(e.head_yaw), data: e.data, - })]; - if !e.meta.is_empty() { + })); + if !self.meta.is_empty() { out.push(play::Clientbound::SetEntityData(SetEntityData { id: e.id, - values: e.meta.clone(), + values: self.meta.clone(), })); } - if !e.equipment.is_empty() { + if !self.equipment.is_empty() { out.push(play::Clientbound::SetEquipment(SetEquipment { id: e.id, - slots: e.equipment.clone(), + slots: self.equipment.clone(), })); } - let passengers = riding.passengers(e.id).to_vec(); - if !passengers.is_empty() { + if !riding.passengers(e.id).is_empty() { out.push(riding.set_passengers(e.id)); } if let Some(&vehicle) = riding.vehicle.get(&e.id) { out.push(riding.set_passengers(vehicle)); } - self.sent.insert( - e.id, - Sent { - base: e.position, - rotation, - head, - velocity: e.velocity, - meta: e.meta.clone(), - equipment: e.equipment.clone(), - was_on_ground: e.on_ground, - tick: 0, - teleport_delay: 0, - interval, - track_deltas, - passengers, - was_riding: false, - }, - ); - out } /// Changes since the last update (ServerEntity.sendChanges): movement and /// rotation every update interval (positions at least every 60 ticks, a /// full position sync every 400 or when the entity lands or leaves the /// ground), velocity for types that track it, changed data at once. - pub fn update(&mut self, e: &EntityState, riding: &Riding) -> Vec<play::Clientbound> { - let Some(s) = self.sent.get_mut(&e.id) else { - return Vec::new(); - }; - let mut out = Vec::new(); + fn send_changes(&mut self, e: &EntityState, riding: &Riding, out: &mut Vec<play::Clientbound>) { let passengers = riding.passengers(e.id); - if passengers != s.passengers.as_slice() { + if passengers != self.passengers.as_slice() { out.push(riding.set_passengers(e.id)); - s.passengers = passengers.to_vec(); + self.passengers.clear(); + self.passengers.extend_from_slice(passengers); } - let dirty = e.meta != s.meta; - let due = s.interval != 0 && s.tick.is_multiple_of(s.interval); + // SynchedEntityData.isDirty: once for every client. + let dirty = e.meta != self.meta; + let due = self.interval != 0 && self.tick.is_multiple_of(self.interval); if due || dirty { let rotation = (pack_degrees(e.pitch), pack_degrees(e.yaw)); let turned = |a: i8, b: i8| (i32::from(a) - i32::from(b)).abs() >= 1; - let arrow = is_arrow(&e.kind); - let rotate = - arrow || turned(rotation.1, s.rotation.1) || turned(rotation.0, s.rotation.0); + let rotate = self.arrow + || turned(rotation.1, self.rotation.1) + || turned(rotation.0, self.rotation.0); if riding.vehicle.contains_key(&e.id) { // A passenger: its rotation alone (its vehicle places it). if rotate { @@ -245,19 +235,19 @@ impl Tracker { on_ground: e.on_ground, }, ))); - s.rotation = rotation; + self.rotation = rotation; } - s.base = e.position; - s.was_riding = true; - Self::send_dirty(e, s, dirty, &mut out); - Self::send_head(e, s, &mut out); - s.tick += 1; - Self::send_equipment(e, s, &mut out); - return out; + self.base = e.position; + self.was_riding = true; + self.send_dirty(e, dirty, out); + self.send_head(e, out); + self.tick += 1; + self.send_equipment(e, out); + return; } - s.teleport_delay += 1; - let d: f64 = (0..3).map(|k| (e.position[k] - s.base[k]).powi(2)).sum(); - let send_position = arrow || d >= 7.629_394_5e-6 || s.tick.is_multiple_of(60); + self.teleport_delay += 1; + let d: f64 = (0..3).map(|k| (e.position[k] - self.base[k]).powi(2)).sum(); + let send_position = self.arrow || d >= 7.629_394_5e-6 || self.tick.is_multiple_of(60); let sync = EntityPositionSync { id: e.id, path: PositionPath::Linear(e.position), @@ -267,16 +257,16 @@ impl Tracker { }; // ServerEntity.createMovePacket. let packet = if e.precise - || s.teleport_delay > 400 - || s.was_riding - || s.was_on_ground != e.on_ground + || self.teleport_delay > 400 + || self.was_riding + || self.was_on_ground != e.on_ground { - s.was_on_ground = e.on_ground; - s.teleport_delay = 0; - s.was_riding = false; + self.was_on_ground = e.on_ground; + self.teleport_delay = 0; + self.was_riding = false; Some(play::Clientbound::EntityPositionSync(sync)) } else if send_position { - let delta = [0, 1, 2].map(|k| encode(e.position[k]) - encode(s.base[k])); + let delta = [0, 1, 2].map(|k| encode(e.position[k]) - encode(self.base[k])); if delta.iter().any(|v| i16::try_from(*v).is_err()) { Some(play::Clientbound::EntityPositionSync(sync)) } else { @@ -304,18 +294,18 @@ impl Tracker { } else { None }; - if s.track_deltas { + if self.track_deltas { let diff: f64 = (0..3) - .map(|k| (e.velocity[k] - s.velocity[k]).powi(2)) + .map(|k| (e.velocity[k] - self.velocity[k]).powi(2)) .sum(); let still = e.velocity.iter().all(|v| *v == 0.0); if diff > 1.0e-7 || diff > 0.0 && still { - s.velocity = e.velocity; + self.velocity = e.velocity; let motion = play::Clientbound::SetEntityMotion(SetEntityMotion { id: e.id, velocity: e.velocity, }); - match acceleration_power(&e.kind) { + match self.power { // A bundle: the motion and the projectile's power. Some(power) => out.extend([ play::Clientbound::BundleDelimiter(horizon_protocol::packets::Empty), @@ -339,29 +329,28 @@ impl Tracker { }; out.push(packet); if position { - s.base = e.position; + self.base = e.position; } if rotated { - s.rotation = rotation; + self.rotation = rotation; } } - Self::send_dirty(e, s, dirty, &mut out); - Self::send_head(e, s, &mut out); + self.send_dirty(e, dirty, out); + self.send_head(e, out); } - s.tick += 1; - Self::send_equipment(e, s, &mut out); - out + self.tick += 1; + self.send_equipment(e, out); } /// ServerEntity.sendDirtyEntityData. - fn send_dirty(e: &EntityState, s: &mut Sent, dirty: bool, out: &mut Vec<play::Clientbound>) { + fn send_dirty(&mut self, e: &EntityState, dirty: bool, out: &mut Vec<play::Clientbound>) { if !dirty { return; } let changed: Vec<_> = e .meta .iter() - .filter(|m| !s.meta.contains(m)) + .filter(|m| !self.meta.contains(m)) .cloned() .collect(); if !changed.is_empty() { @@ -370,31 +359,31 @@ impl Tracker { values: changed, })); } - s.meta = e.meta.clone(); + self.meta.clone_from(&e.meta); } - fn send_head(e: &EntityState, s: &mut Sent, out: &mut Vec<play::Clientbound>) { + fn send_head(&mut self, e: &EntityState, out: &mut Vec<play::Clientbound>) { let head = pack_degrees(e.head_yaw); - if (i32::from(head) - i32::from(s.head)).abs() >= 1 { + if (i32::from(head) - i32::from(self.head)).abs() >= 1 { out.push(play::Clientbound::RotateHead(RotateHead { id: e.id, head_yaw: head, })); - s.head = head; + self.head = head; } } /// LivingEntity.detectEquipmentUpdates: changed slots every tick. - fn send_equipment(e: &EntityState, s: &mut Sent, out: &mut Vec<play::Clientbound>) { - if e.equipment != s.equipment { + fn send_equipment(&mut self, e: &EntityState, out: &mut Vec<play::Clientbound>) { + if e.equipment != self.equipment { // Cleared slots are sent as empty stacks. let mut slots: Vec<(u8, Option<Stack>)> = e .equipment .iter() - .filter(|m| !s.equipment.contains(m)) + .filter(|m| !self.equipment.contains(m)) .cloned() .collect(); - for (slot, _) in &s.equipment { + for (slot, _) in &self.equipment { if !e.equipment.iter().any(|(k, _)| k == slot) { slots.push((*slot, None)); } @@ -405,11 +394,195 @@ impl Tracker { slots, })); } - s.equipment = e.equipment.clone(); + self.equipment.clone_from(&e.equipment); } } } +/// The entities one client tracks (`TrackedEntity.seenBy`, from the +/// client's side). +#[derive(Default)] +pub struct Tracker { + seen: crate::fast_hash::FxHashSet<i32>, +} + +impl Tracker { + pub fn is_tracking(&self, id: i32) -> bool { + self.seen.contains(&id) + } + pub fn ids(&self) -> Vec<i32> { + self.seen.iter().copied().collect() + } + pub fn clear(&mut self) { + self.seen.clear(); + } + pub fn len(&self) -> usize { + self.seen.len() + } + pub fn is_empty(&self) -> bool { + self.seen.is_empty() + } +} + +/// Who a level's entities are tracked by this tick: a client's position, +/// view distance and chunks. +pub struct Viewer<'a> { + pub entity_id: i32, + pub position: [f64; 3], + pub view_distance: i32, + pub chunks: &'a crate::fast_hash::FxHashSet<(i32, i32)>, + pub tracker: &'a mut Tracker, + /// What the tick sends it, in order. + pub out: &'a mut Vec<Vec<u8>>, +} + +/// TrackedEntity.updatePlayer: within the type's range (capped by the view +/// distance) horizontally, in a chunk the client has. +fn sees( + position: [f64; 3], + view_distance: i32, + chunks: &crate::fast_hash::FxHashSet<(i32, i32)>, + e: &EntityState, + range: i32, +) -> bool { + let range = f64::from(range.min(view_distance) * 16); + let (dx, dz) = (position[0] - e.position[0], position[2] - e.position[2]); + let chunk = ( + (e.position[0].floor() as i32) >> 4, + (e.position[2].floor() as i32) >> 4, + ); + dx * dx + dz * dz <= range * range && chunks.contains(&chunk) +} + +/// One level's tracked entities (ChunkMap.entityMap). +#[derive(Default)] +pub struct Entities { + states: crate::fast_hash::FxHashMap<i32, ServerEntity>, + /// The level tick, stamped on every entity still in the level. + tick: u32, + /// This tick's tracking range of each entity, and what each client + /// makes of each entity ([`SEES`], [`TRACKS`]), kept between ticks. + ranges: Vec<i32>, + flags: Vec<Vec<u8>>, + /// One entity's packets and their bodies, kept between entities. + packets: Vec<play::Clientbound>, + bodies: Vec<Vec<u8>>, +} + +/// The client sees the entity this tick, and already tracked it. +const SEES: u8 = 1; +const TRACKS: u8 = 2; + +fn encode_all(packets: &[play::Clientbound], bodies: &mut Vec<Vec<u8>>) { + bodies.clear(); + bodies.extend(packets.iter().map(play::Clientbound::encode)); +} + +impl Entities { + pub fn len(&self) -> usize { + self.states.len() + } + pub fn is_empty(&self) -> bool { + self.states.is_empty() + } + + /// One tick of ChunkMap.tick for the entities in the level now and the + /// clients in it: each client first loses the entities that left its + /// range or the level (one ClientboundRemoveEntitiesPacket), then each + /// entity's changes are made once and go to every client tracking it, + /// and the clients that start tracking it are paired with it. A client + /// never tracks its own entity. `kind` names a type's registry id. + pub fn tick( + &mut self, + entities: &[&EntityState], + riding: &Riding, + viewers: &mut [Viewer], + mut kind: impl FnMut(&str) -> Option<i32>, + ) { + self.tick = self.tick.wrapping_add(1); + let now = self.tick; + self.ranges.clear(); + for (index, e) in entities.iter().enumerate() { + let s = self + .states + .entry(e.id) + .or_insert_with(|| ServerEntity::new(e, kind(&e.kind), riding)); + s.seen = now; + s.index = index; + self.ranges.push(s.range); + } + self.flags.resize_with(viewers.len(), Vec::new); + for (v, flags) in viewers.iter_mut().zip(&mut self.flags) { + flags.clear(); + let mut kept = 0; + flags.extend(entities.iter().zip(&self.ranges).map(|(e, &range)| { + if e.id == v.entity_id || !sees(v.position, v.view_distance, v.chunks, e, range) { + 0 + } else if v.tracker.seen.contains(&e.id) { + kept += 1; + SEES | TRACKS + } else { + SEES + } + })); + // Usually the client still sees all it tracks. + let mut removed = Vec::new(); + if kept != v.tracker.seen.len() { + let states = &self.states; + v.tracker.seen.retain(|id| match states.get(id) { + Some(s) if s.seen == now && flags[s.index] & TRACKS != 0 => true, + _ => { + removed.push(*id); + false + } + }); + } + if !removed.is_empty() { + v.out.push( + play::Clientbound::RemoveEntities(play::RemoveEntities { ids: removed }) + .encode(), + ); + } + } + for (index, e) in entities.iter().enumerate() { + let Some(s) = self.states.get_mut(&e.id) else { + continue; + }; + self.packets.clear(); + if !s.added { + s.send_changes(e, riding, &mut self.packets); + } + s.added = false; + let mut encoded = false; + let mut pairing: Option<Vec<Vec<u8>>> = None; + for (v, flags) in viewers.iter_mut().zip(&self.flags) { + let f = flags[index]; + if f & TRACKS != 0 { + if self.packets.is_empty() { + continue; + } + if !encoded { + encode_all(&self.packets, &mut self.bodies); + encoded = true; + } + v.out.extend(self.bodies.iter().cloned()); + } else if f & SEES != 0 + && let Some(kind) = s.kind + { + let bodies = pairing.get_or_insert_with(|| { + let mut packets = Vec::new(); + s.pairing(e, kind, riding, &mut packets); + packets.iter().map(play::Clientbound::encode).collect() + }); + v.out.extend(bodies.iter().cloned()); + v.tracker.seen.insert(e.id); + } + } + } + self.states.retain(|_, s| s.seen == now); + } +} + #[cfg(test)] mod tests { use super::*; @@ -432,39 +605,49 @@ mod tests { } } + /// The entity as added this tick, then its updates (one a tick). + fn added(e: &EntityState) -> ServerEntity { + ServerEntity::new(e, Some(100), &Riding::default()) + } + fn changes(s: &mut ServerEntity, e: &EntityState) -> Vec<play::Clientbound> { + let mut out = Vec::new(); + s.send_changes(e, &Riding::default(), &mut out); + out + } + #[test] fn moves_go_out_every_update_interval() { - let mut t = Tracker::default(); - let spawn = t.spawn(&state(0.0), 100, &Riding::default()); - assert!(matches!(spawn[0], play::Clientbound::AddEntity(_))); + let mut s = added(&state(0.0)); + let mut spawn = Vec::new(); + s.pairing(&state(0.0), 100, &Riding::default(), &mut spawn); + assert!(matches!(spawn[..], [play::Clientbound::AddEntity(_)])); // Tick 0 is due and a multiple of 60: the position goes out unchanged. assert!(matches!( - t.update(&state(0.0), &Riding::default())[..], + changes(&mut s, &state(0.0))[..], [play::Clientbound::MoveEntityPos(_)] )); // A zombie updates every third tick. - assert!(t.update(&state(0.5), &Riding::default()).is_empty()); - assert!(t.update(&state(0.5), &Riding::default()).is_empty()); + assert!(changes(&mut s, &state(0.5)).is_empty()); + assert!(changes(&mut s, &state(0.5)).is_empty()); assert!(matches!( - t.update(&state(0.5), &Riding::default())[..], + changes(&mut s, &state(0.5))[..], [play::Clientbound::MoveEntityPos(_)] )); for _ in 0..2 { - t.update(&state(40.0), &Riding::default()); + changes(&mut s, &state(40.0)); } - let jump = t.update(&state(40.0), &Riding::default()); + let jump = changes(&mut s, &state(40.0)); assert!(matches!(jump[0], play::Clientbound::EntityPositionSync(_))); } #[test] fn fireballs_bundle_their_motion_with_their_power() { - let mut t = Tracker::default(); let mut e = state(0.0); e.kind = "minecraft:fireball".into(); e.on_ground = false; - t.spawn(&e, 100, &Riding::default()); + let mut s = added(&e); e.velocity = [0.0, 0.0, 0.5]; - let out = t.update(&e, &Riding::default()); + let out = changes(&mut s, &e); assert!(matches!( out[..], [ @@ -479,53 +662,49 @@ mod tests { #[test] fn arrows_send_position_and_rotation_every_update() { - let mut t = Tracker::default(); let mut e = state(0.0); e.kind = "minecraft:arrow".into(); - t.spawn(&e, 100, &Riding::default()); + let mut s = added(&e); assert!(matches!( - t.update(&e, &Riding::default())[..], + changes(&mut s, &e)[..], [play::Clientbound::MoveEntityPosRot(_)] )); } #[test] fn precise_entities_sync_their_position() { - let mut t = Tracker::default(); let mut e = state(0.0); e.kind = "minecraft:tnt".into(); e.precise = true; - t.spawn(&e, 100, &Riding::default()); + let mut s = added(&e); assert!(matches!( - t.update(&e, &Riding::default())[..], + changes(&mut s, &e)[..], [play::Clientbound::EntityPositionSync(_)] )); } #[test] fn landing_sends_a_position_sync() { - let mut t = Tracker::default(); let mut e = state(0.0); - t.spawn(&e, 100, &Riding::default()); - t.update(&e, &Riding::default()); + let mut s = added(&e); + changes(&mut s, &e); e.on_ground = false; - t.update(&e, &Riding::default()); - t.update(&e, &Riding::default()); + changes(&mut s, &e); + changes(&mut s, &e); assert!(matches!( - t.update(&e, &Riding::default())[..], + changes(&mut s, &e)[..], [play::Clientbound::EntityPositionSync(_)] )); } #[test] fn metadata_and_equipment_send_only_the_changes() { - let mut t = Tracker::default(); let mut e = state(0.0); - t.spawn(&e, 100, &Riding::default()); - t.update(&e, &Riding::default()); + let mut s = added(&e); + changes(&mut s, &e); e.meta.push((0, 0, Value::Byte(1))); e.equipment.push((0, Some(Stack::new(5, 1)))); - let out = t.update(&e, &Riding::default()); + let out = changes(&mut s, &e); assert!( out.iter() .any(|p| matches!(p, play::Clientbound::SetEntityData(_))) @@ -534,12 +713,119 @@ mod tests { out.iter() .any(|p| matches!(p, play::Clientbound::SetEquipment(_))) ); - assert!(t.update(&e, &Riding::default()).is_empty()); + assert!(changes(&mut s, &e).is_empty()); e.equipment.clear(); - let out = t.update(&e, &Riding::default()); + let out = changes(&mut s, &e); let Some(play::Clientbound::SetEquipment(eq)) = out.first() else { panic!("expected equipment"); }; assert_eq!(eq.slots, vec![(0, None)]); } + + /// Two clients at the origin; the chunks they hold. + struct Clients { + chunks: crate::fast_hash::FxHashSet<(i32, i32)>, + trackers: [Tracker; 2], + out: [Vec<Vec<u8>>; 2], + positions: [[f64; 3]; 2], + } + + impl Clients { + fn new() -> Self { + Self { + chunks: (-4..4).flat_map(|x| (-4..4).map(move |z| (x, z))).collect(), + trackers: Default::default(), + out: Default::default(), + positions: [[0.0, 64.0, 0.0]; 2], + } + } + fn tick(&mut self, level: &mut Entities, entities: &[&EntityState]) { + for out in &mut self.out { + out.clear(); + } + let [t0, t1] = &mut self.trackers; + let [o0, o1] = &mut self.out; + let mut viewers = [ + Viewer { + entity_id: 1, + position: self.positions[0], + view_distance: 10, + chunks: &self.chunks, + tracker: t0, + out: o0, + }, + Viewer { + entity_id: 2, + position: self.positions[1], + view_distance: 10, + chunks: &self.chunks, + tracker: t1, + out: o1, + }, + ]; + level.tick(entities, &Riding::default(), &mut viewers, |_| Some(100)); + } + } + + fn body(p: play::Clientbound) -> Vec<u8> { + p.encode() + } + + #[test] + fn every_client_gets_the_same_changes_and_late_ones_are_paired() { + let mut level = Entities::default(); + let mut c = Clients::new(); + // The second client is out of range at first. + c.positions[1] = [500.0, 64.0, 0.0]; + let mut e = state(0.0); + c.tick(&mut level, &[&e]); + assert!(c.trackers[0].is_tracking(7) && !c.trackers[1].is_tracking(7)); + assert!(c.out[1].is_empty()); + // Tick 0's forced position goes to the client tracking it. + c.tick(&mut level, &[&e]); + assert_eq!(c.out[0].len(), 1); + // The second client comes in range: paired with the entity as it is, + // then sent the same changes as the first. + c.positions[1] = [0.0, 64.0, 0.0]; + e.position[0] = 1.0; + c.tick(&mut level, &[&e]); + assert!(c.trackers[1].is_tracking(7)); + assert!(c.out[0].is_empty()); + assert_eq!(c.out[1].len(), 1); + c.tick(&mut level, &[&e]); + e.position[0] = 2.0; + c.tick(&mut level, &[&e]); + assert!(!c.out[0].is_empty()); + assert_eq!(c.out[0], c.out[1]); + } + + #[test] + fn clients_lose_what_leaves_range_or_the_level_and_never_track_themselves() { + let mut level = Entities::default(); + let mut c = Clients::new(); + let mut me = state(0.0); + me.id = 1; + me.kind = "minecraft:player".into(); + let mut e = state(0.0); + c.tick(&mut level, &[&me, &e]); + assert!(!c.trackers[0].is_tracking(1) && c.trackers[1].is_tracking(1)); + assert!(c.trackers[0].is_tracking(7)); + // Out of the zombie's 8 chunks. + e.position[0] = 200.0; + c.tick(&mut level, &[&me, &e]); + assert!(!c.trackers[0].is_tracking(7)); + let removed = body(play::Clientbound::RemoveEntities(play::RemoveEntities { + ids: vec![7], + })); + assert_eq!(c.out[0].first(), Some(&removed)); + // Gone from the level: the other client loses it too, and so does + // the level. + e.position[0] = 0.0; + c.tick(&mut level, &[&me, &e]); + assert!(c.trackers[0].is_tracking(7)); + c.tick(&mut level, &[&me]); + assert!(!c.trackers[0].is_tracking(7) && !c.trackers[1].is_tracking(7)); + assert_eq!(c.out[0].first(), Some(&removed)); + assert_eq!(level.len(), 1); + } } diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index c88292787..5d593be2d 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -8,7 +8,7 @@ use super::{ Lan, NetEvent, chunks::ChunkEncoder, data::SyncData, - entity::EntityState, + entity::{Entities, EntityState, Viewer}, guest::{Guest, SentEffect, stack_to_network}, }; use crate::{ @@ -148,6 +148,10 @@ pub struct Hub { clock_ids: Vec<i32>, item_ids: std::collections::HashMap<Arc<str>, i32>, entity_types: std::collections::HashMap<String, i32>, + /// Each level's tracked entities, by dimension. + entities: std::collections::HashMap<String, Entities>, + /// What one tick of entity tracking sends each guest, kept between ticks. + entity_out: Vec<Vec<Vec<u8>>>, } fn string(s: &str) -> Tag { @@ -201,6 +205,20 @@ fn yellow_names(key: &str, names: Vec<Tag>) -> Tag { ]) } +/// An entity type's registry id, remembered once looked up. +fn entity_type( + types: &mut std::collections::HashMap<String, i32>, + sync: &SyncData, + kind: &str, +) -> Option<i32> { + if let Some(id) = types.get(kind) { + return Some(*id); + } + let id = sync.builtin.get("minecraft:entity_type")?.id(kind)?; + types.insert(kind.to_owned(), id); + Some(id) +} + /// ChunkTrackingView.contains: the chunks a player at (cx, cz) with view /// distance `r` is sent (isWithinDistance with the neighbours' buffer). fn tracked(cx: i32, cz: i32, r: i32, x: i32, z: i32) -> bool { @@ -259,6 +277,8 @@ impl Hub { clock_ids, item_ids: Default::default(), entity_types: Default::default(), + entities: Default::default(), + entity_out: Vec::new(), } } @@ -292,14 +312,6 @@ impl Hub { let sync = self.sync.clone(); stack_to_network(|_| id, |name| sync.id("minecraft:enchantment", name), s) } - fn entity_type(&mut self, kind: &str) -> Option<i32> { - if let Some(id) = self.entity_types.get(kind) { - return Some(*id); - } - let id = self.sync.builtin.get("minecraft:entity_type")?.id(kind)?; - self.entity_types.insert(kind.to_owned(), id); - Some(id) - } pub fn broadcast(&self, packet: &C) { let body = packet.encode(); @@ -1493,65 +1505,40 @@ impl Hub { }) .collect(); all.extend(guest_states); - all.extend(ctx.entities.iter().cloned()); - let by_id: std::collections::HashMap<i32, usize> = - all.iter().enumerate().map(|(i, e)| (e.id, i)).collect(); - // Each entity type's tracking range, looked up once rather than for - // every player. - let ranges: Vec<i32> = all - .iter() - .map(|e| super::entity::tracking_chunks(&e.kind)) + let entities: Vec<&EntityState> = all.iter().chain(ctx.entities).collect(); + // ChunkMap.tick: the level's entities, once for all its players. + let mut level = self + .entities + .remove(&self.config.dimension) + .unwrap_or_default(); + let mut outs = std::mem::take(&mut self.entity_out); + let dimension = &self.config.dimension; + let here = |g: &Guest| g.placed && g.dimension == *dimension; + outs.resize_with(self.guests.iter().filter(|g| here(g)).count(), Vec::new); + let mut viewers: Vec<Viewer> = self + .guests + .iter_mut() + .filter(|g| here(g)) + .zip(outs.iter_mut()) + .map(|(g, out)| Viewer { + entity_id: g.entity_id, + position: g.position, + view_distance: g.view_distance, + chunks: &g.sent_chunks, + tracker: &mut g.tracker, + out, + }) .collect(); - for gi in 0..self.guests.len() { - if !self.here(&self.guests[gi]) { - continue; - } - let view = self.guests[gi].view_distance; - let me = self.guests[gi].entity_id; - let origin = self.guests[gi].position; - // TrackedEntity.updatePlayer: within the type's range (capped by the - // view distance) horizontally, in a chunk the client has. - let visible = |g: &Guest, ei: usize| { - let e = &all[ei]; - let range = f64::from(ranges[ei].min(view) * 16); - let (dx, dz) = (origin[0] - e.position[0], origin[2] - e.position[2]); - let chunk = ( - (e.position[0].floor() as i32) >> 4, - (e.position[2].floor() as i32) >> 4, - ); - dx * dx + dz * dz <= range * range && g.sent_chunks.contains(&chunk) - }; - // Forget what disappeared or left range. - let mut removed = Vec::new(); - for id in self.guests[gi].tracker.ids() { - match by_id.get(&id) { - Some(&ei) if visible(&self.guests[gi], ei) => {} - _ => removed.push(id), - } - } - if !removed.is_empty() { - for id in &removed { - self.guests[gi].tracker.forget(*id); - } - self.guests[gi].send(&C::RemoveEntities(play::RemoveEntities { ids: removed })); - } - for (ei, e) in all.iter().enumerate() { - if e.id == me { - continue; - } - if self.guests[gi].tracker.is_tracking(e.id) { - let packets = self.guests[gi].tracker.update(e, &self.riding); - self.guests[gi].send_all(&packets); - } else if visible(&self.guests[gi], ei) { - let Some(kind) = self.entity_type(&e.kind) else { - continue; - }; - // Players need their list entry first; guests got it at join. - let packets = self.guests[gi].tracker.spawn(e, kind, &self.riding); - self.guests[gi].send_all(&packets); - } - } + let (types, sync) = (&mut self.entity_types, &self.sync); + level.tick(&entities, &self.riding, &mut viewers, |kind| { + entity_type(types, sync, kind) + }); + drop(viewers); + for (g, out) in self.guests.iter().filter(|g| here(g)).zip(outs.iter_mut()) { + g.sender.send_many(out.drain(..)); } + self.entity_out = outs; + self.entities.insert(self.config.dimension.clone(), level); } /// ServerPlayer.stopSleepInBed: the wake-up animation goes to the player From 4db511079d3bf4314d3338832f5f5f57e2efc467 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 08:43:59 +0200 Subject: [PATCH 088/163] Locator bar: update each connection in place, without clones ServerWaypointManager's per-tick work for every moving player copied each connection out of its row (its icon's style string too), scanned the row again to put it back, copied the lists of players and waypoints it walked, and looked players up through SipHash. Connections are now updated where they are (the same row order and the same packets), the lists are walked by index and the maps use FxHash. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/lan/waypoints.rs | 56 +++++++++++++--------- 1 file changed, 33 insertions(+), 23 deletions(-) diff --git a/crates/horizon-client/src/lan/waypoints.rs b/crates/horizon-client/src/lan/waypoints.rs index a8797dbaf..e3067871c 100644 --- a/crates/horizon-client/src/lan/waypoints.rs +++ b/crates/horizon-client/src/lan/waypoints.rs @@ -10,10 +10,10 @@ //! `waypoint_transmit_range` and tracks or untracks the waypoint, as //! `LivingEntity.onAttributeUpdated` does; joining or leaving a team remakes the //! connections with the team's colour (`ServerScoreboard.updatePlayerWaypoint`). +use crate::fast_hash::FxHashMap as HashMap; use horizon_protocol::packets::play::{ Clientbound as C, TrackedWaypoint, WaypointId, WaypointTarget, waypoint_operation, }; -use std::collections::HashMap; /// `Player.createAttributes`: both waypoint ranges. pub const PLAYER_RANGE: f64 = 6.0e7; @@ -304,8 +304,13 @@ impl Tick<'_> { WaypointTarget::Azimuth(now) } }; - let icon = c.icon.clone(); - self.send(receiver, source, waypoint_operation::UPDATE, &icon, target); + self.send( + receiver, + source, + waypoint_operation::UPDATE, + &c.icon, + target, + ); } } @@ -347,30 +352,41 @@ impl Waypoints { } } } - /// `updateConnection`. + /// `updateConnection`, on the connection in its place. fn update_connection(&mut self, t: &mut Tick, receiver: u128, source: u128) { if receiver == source || !t.enabled { return; } - let Some(mut c) = self.connection(receiver, source).cloned() else { + let Some(row) = self.connections.get_mut(&receiver) else { return; }; - if !t.broken(&c, source, receiver) { - t.update(&mut c, source, receiver); - self.put(receiver, source, c); + let Some(i) = row.iter().position(|(s, _)| *s == source) else { + return; + }; + let c = &mut row[i].1; + if !t.broken(c, source, receiver) { + t.update(c, source, receiver); return; } match t.make(source, receiver) { Some(new) => { t.connect(receiver, source, &new); - self.put(receiver, source, new); + *c = new; } None => { t.disconnect(receiver, source); - self.take(receiver, source); + row.remove(i); } } } + /// The receiver's connection to the source updated, or made if it has none. + fn update_or_create(&mut self, t: &mut Tick, receiver: u128, source: u128) { + if self.connection(receiver, source).is_some() { + self.update_connection(t, receiver, source); + } else { + self.create_connection(t, receiver, source); + } + } /// `trackWaypoint`. fn track(&mut self, t: &mut Tick, source: u128) { if !self.waypoints.contains(&source) { @@ -385,12 +401,9 @@ impl Waypoints { if !self.waypoints.contains(&source) { return; } - for receiver in self.players.clone() { - if self.connection(receiver, source).is_some() { - self.update_connection(t, receiver, source); - } else { - self.create_connection(t, receiver, source); - } + // Connections change; the players don't. + for k in 0..self.players.len() { + self.update_or_create(t, self.players[k], source); } } /// `untrackWaypoint`. @@ -416,12 +429,9 @@ impl Waypoints { } /// `updatePlayer`. fn update_player(&mut self, t: &mut Tick, player: u128) { - for source in self.waypoints.clone() { - if self.connection(player, source).is_some() { - self.update_connection(t, player, source); - } else { - self.create_connection(t, player, source); - } + // Connections change; the waypoints don't. + for k in 0..self.waypoints.len() { + self.update_or_create(t, player, self.waypoints[k]); } } /// `removePlayer`. @@ -454,7 +464,7 @@ impl Waypoints { ) -> Vec<(u32, C)> { let mut t = Tick { players: players.iter().map(|p| (p.uuid, p)).collect(), - view: HashMap::new(), + view: HashMap::default(), fresh: respawned, enabled: locator_bar, out: Vec::new(), From 54bae6131bab839a702ca3fce0e66dbe6700f2ed Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 10:39:01 +0200 Subject: [PATCH 089/163] feat(server): commands act on other players (names, UUIDs, @a/@p/@r/@s) EntitySelector.findPlayers and EntityArgument's player targets on a hosted world or dedicated server: every guest other than the one in place is Target::Guest, found by name, UUID or selector, and what a command does to them (give, gamemode, tp, kill, effect give/clear, data) runs with their state swapped in, their own messages going to their chat. The console, operators and command blocks can all target them; execute as/at reads their position, rotation and eye height; a teleport into another level (execute in, the console's Overworld, a destination in another level) moves them there. as_guest splits into enter_guest/leave_guest so that guest turns nest, and a guest's commands run with the hub back in self.lan (queued per packet), so they reach the other players (and /kick works for ops). Item and advancement names and player names in feedback take vanilla's component shape; /kill on a guest sends vanilla's death message. Harness: tools/test_server_player_targets_parity.py. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../horizon-client/src/game/advancements.rs | 32 +- crates/horizon-client/src/game/commands.rs | 279 ++++++++++----- .../horizon-client/src/game/commands/data.rs | 5 + .../src/game/commands/effects.rs | 35 +- .../src/game/commands/execute.rs | 11 +- .../src/game/commands/players.rs | 210 +++++++++++ crates/horizon-client/src/game/dedicated.rs | 1 + crates/horizon-client/src/game/lan.rs | 15 +- crates/horizon-client/src/game/lan_actions.rs | 336 ++++++++++++++---- crates/horizon-client/src/game/scoreboard.rs | 3 +- crates/horizon-client/src/lan/hub.rs | 10 + crates/horizon-client/src/text.rs | 6 + .../horizonlab/parity/LocatorBarClient.java | 41 ++- tools/test_server_player_targets_parity.py | 199 +++++++++++ 14 files changed, 995 insertions(+), 188 deletions(-) create mode 100644 crates/horizon-client/src/game/commands/players.rs create mode 100644 tools/test_server_player_targets_parity.py diff --git a/crates/horizon-client/src/game/advancements.rs b/crates/horizon-client/src/game/advancements.rs index 882b5cc93..2ca6980ba 100644 --- a/crates/horizon-client/src/game/advancements.rs +++ b/crates/horizon-client/src/game/advancements.rs @@ -497,10 +497,13 @@ impl Game<'_> { // PlayerList.broadcastSystemMessage: everyone hears of a // network player's advancement. match self.lan_acting_name.clone() { - Some(player) => self - .adv - .announced - .push(Text::translate(key, &[Text::literal(&player), name])), + // Player.getDisplayName. + Some(_) => { + let player = self.target_name(super::commands::Target::Player); + self.adv + .announced + .push(Text::translate(key, &[player, name])); + } None => self.system_message(Text::translate( key, &[Text::literal(super::chat::PLAYER_NAME), name], @@ -832,18 +835,25 @@ pub(super) fn adv_name(a: &adv::Advancement) -> Text { Frame::Challenge => text::DARK_PURPLE, _ => text::GREEN, }; - let tooltip = text_of(&d.title) - .with_color(color) + // Advancement.decorateName: the title in the frame's colour (styles + // merged into it), a new line and the description. + let coloured = text_of(&d.title).with_color(color); + let mut component = coloured.component(); + if let Some(o) = component.as_object_mut() { + o.insert( + "extra".into(), + serde_json::json!(["\n", text_of(&d.description).component()]), + ); + } + let tooltip = coloured .append("\n") - .append(text_of(&d.description)); + .append(text_of(&d.description)) + .with_component(component); let title = text_of(&d.title).with_style(&Style { hover: Some(Box::new(tooltip)), ..Style::default() }); - Text::literal("[") - .append(title) - .append("]") - .with_color(color) + Text::translate("chat.square_brackets", &[title]).with_color(color) } impl Game<'_> { /// `AdvancementCommands.Action.GRANT` on one advancement (or one of diff --git a/crates/horizon-client/src/game/commands.rs b/crates/horizon-client/src/game/commands.rs index 575f5c93e..a788ce5c9 100644 --- a/crates/horizon-client/src/game/commands.rs +++ b/crates/horizon-client/src/game/commands.rs @@ -9,6 +9,7 @@ pub(super) mod extra; mod items; mod misc; mod place; +mod players; mod raid; mod terrain_cmds; mod text_commands; @@ -33,7 +34,11 @@ pub(super) type R<T> = Result<T, CommandError>; /// An entity a selector found. #[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)] pub(super) enum Target { + /// The player in place: the host's, or the guest whose turn it is. Player, + /// Another player of a hosted world or server: a guest by connection + /// (game/commands/players.rs). + Guest(u32), Mob(u32), Item(u32), Orb(usize), @@ -232,9 +237,16 @@ impl Game<'_> { } match &self.player { Some(p) => [p.position.x, p.position.y, p.position.z], - None => self.spawn.map_or([0.0, 64.0, 0.0], |s| [s.x, s.y, s.z]), + None => self.server_position(), } } + /// MinecraftServer.createCommandSourceStack's position: the corner of + /// the respawn block (`Vec3.atLowerCornerOf`). + pub(super) fn server_position(&self) -> [f64; 3] { + self.spawn.map_or([0.0, 64.0, 0.0], |s| { + [s.x.floor(), s.y.floor(), s.z.floor()] + }) + } fn source_rotation(&self) -> [f32; 2] { self.command_source .map_or([self.yaw, self.pitch], |s| s.rot) @@ -288,6 +300,7 @@ impl Game<'_> { .player .as_ref() .map(|p| [p.position.x, p.position.y, p.position.z]), + Target::Guest(conn) => self.command_guest(conn).map(|g| g.position), Target::Mob(id) => self .mobs .iter() @@ -347,7 +360,7 @@ impl Game<'_> { } pub(super) fn target_type(&self, t: Target) -> String { match t { - Target::Player => "minecraft:player".into(), + Target::Player | Target::Guest(_) => "minecraft:player".into(), Target::Mob(id) => self .mobs .iter() @@ -394,12 +407,19 @@ impl Game<'_> { match t { Target::Player => { let name = self.acting_player_name(); + if let Some(uuid) = self.lan_acting_uuid { + return self.player_text(name, uuid); + } match self.score.board.players_team(name) { // PlayerTeam.formatNameForTeam. Some(team) => team.formatted_name(Text::literal(name)), None => Text::literal(name), } } + Target::Guest(conn) => match self.command_guest(conn) { + Some(g) => self.player_text(&g.name, g.uuid), + None => Text::empty(), + }, Target::Item(id) => { let item = self .dropped @@ -446,11 +466,10 @@ impl Game<'_> { /// EntitySelector.findEntities. pub(super) fn select(&mut self, s: &Selector) -> Vec<Target> { if let Some(name) = &s.player_name { - return if name.eq_ignore_ascii_case(PLAYER_NAME) && self.player.is_some() { - vec![Target::Player] - } else { - Vec::new() - }; + return self.player_named(name).into_iter().collect(); + } + if let Some(uuid) = s.uuid { + return self.target_by_uuid(uuid).into_iter().collect(); } let origin = { let p = self.source_position(); @@ -464,10 +483,15 @@ impl Game<'_> { match (s.kind, self.command_source) { // @s: the executing entity (none for a server source). ('s', Some(source)) => candidates.extend(source.entity), - _ if self.player.is_some() => candidates.push(Target::Player), + ('s', None) => candidates.extend(self.source_entity()), + // A guest in place is among the players, in join order. + _ if self.player.is_some() && self.lan_acting.is_none() => { + candidates.push(Target::Player); + } _ => {} } if s.kind != 's' { + candidates.extend(self.player_candidates(s)); candidates.extend( self.mobs .iter() @@ -511,7 +535,7 @@ impl Game<'_> { } } if !s.include_entities - && t != Target::Player + && !t.is_player() && s.types.iter().all(|(w, n)| *n || w != &ty) && s.kind != 'e' && s.kind != 'n' @@ -527,16 +551,20 @@ impl Game<'_> { if !passing.contains(&t) { return None; } + let player = match t { + Target::Player => Some((level, if creative { "creative" } else { "survival" })), + Target::Guest(conn) => self.guest_level_and_mode(conn), + _ => None, + }; if let Some((lo, hi)) = s.level - && (t != Target::Player - || lo.is_some_and(|l| level < l) - || hi.is_some_and(|h| level > h)) + && player.is_none_or(|(level, _)| { + lo.is_some_and(|l| level < l) || hi.is_some_and(|h| level > h) + }) { return None; } for (mode, neg) in &s.gamemodes { - let current = if creative { "creative" } else { "survival" }; - if t != Target::Player || (current == mode) == *neg { + if player.is_none_or(|(_, current)| (current == mode) == *neg) { return None; } } @@ -595,12 +623,12 @@ impl Game<'_> { /// EntityArgument.getEntities / getPlayers / getEntity / getPlayer. pub(super) fn entities(&mut self, ctx: &Context, name: &str, players: bool) -> R<Vec<Target>> { let Some(Arg::Entity(s)) = ctx.get(name).cloned() else { - return Ok(vec![Target::Player]); + return Ok(vec![self.implied_player()]); }; let found: Vec<Target> = self .select(&s) .into_iter() - .filter(|t| !players || *t == Target::Player) + .filter(|t| !players || t.is_player()) .collect(); if found.is_empty() { return Err(err( @@ -806,63 +834,63 @@ impl Game<'_> { let targets = if ctx.get("target").is_some() { self.entities(ctx, "target", true)? } else { - vec![Target::Player] + vec![self.implied_player()] }; let mut count = 0; for t in targets { - if t != Target::Player || !self.set_game_mode(mode) { + let mode_name = Text::translate(&format!("gameMode.{}", mode.name()), &[]); + // GameModeCommand.logGamemodeChange: the source's own entity. + let own = self.source_entity() == Some(t); + let told = !own && self.ui.rules.bool("send_command_feedback"); + let changed = self.for_player(t, |g| { + if !g.set_game_mode(mode) { + return false; + } + if told { + g.system_message(Text::translate( + "gameMode.changed", + std::slice::from_ref(&mode_name), + )); + } + true + }); + if changed != Some(true) { continue; } count += 1; - let mode_name = Text::translate(&format!("gameMode.{}", mode.name()), &[]); - // GameModeCommand.logGamemodeChange: the source's own entity. - let own = match self.command_source { - None => true, - Some(s) => s.entity == Some(t), - }; if own { self.feedback(Text::translate( "commands.gamemode.success.self", &[mode_name], )); } else { - if self.ui.rules.bool("send_command_feedback") { - self.system_message(Text::translate( - "gameMode.changed", - std::slice::from_ref(&mode_name), - )); - } self.feedback(Text::translate( "commands.gamemode.success.other", - &[Text::literal(self.acting_player_name()), mode_name], + &[self.target_name(t), mode_name], )); } } Ok(count) } - /// ItemStack.getDisplayName: "[Name]" in the rarity colour. + /// ItemStack.getDisplayName of one `item` with no components. pub(super) fn item_display_name(&self, item: &str) -> Text { - let rarity = self.item_rarity(item); - let color = match rarity.as_str() { - "uncommon" => text::YELLOW, - "rare" => text::AQUA, - "epic" => text::LIGHT_PURPLE, - _ => text::WHITE, - }; - Text::literal("[") - .append(Text::literal(self.pack.names.item(item))) - .append("]") - .with_color(color) + self.stack_display_name(&ItemStack { + item: item.into(), + count: 1, + damage: 0, + extra: None, + }) } /// `ItemStack.getDisplayName`: the hover name (custom name in italics, - /// a written book's title, a potion's effect name...) in brackets, in the - /// rarity colour unless the stack is empty. + /// a written book's title, a potion's effect name, else the item's + /// translated name) in brackets, in the rarity colour and showing the + /// stack on hover unless it is empty. pub(super) fn stack_display_name(&self, s: &ItemStack) -> Text { let item = &*s.item; let empty = item == "minecraft:air" || s.count == 0; let custom = s.custom_name(); let hover = if let Some(c) = custom { - Text::literal(c).italic() + Text::literal(c) } else if let Some(title) = s .data() .and_then(|d| d.written.as_ref()) @@ -883,9 +911,22 @@ impl Game<'_> { &[], ) } else { - Text::literal(self.pack.names.item(item)) + // Item.getDescriptionId: a block item's is the block's. + let (namespace, path) = item.split_once(':').unwrap_or(("minecraft", item)); + let key = format!("item.{namespace}.{path}"); + let key = if self.pack.names.get(&key).is_some() { + key + } else { + format!("block.{namespace}.{path}") + }; + Text::translate(&key, &[]) }; - let wrapped = Text::translate("chat.square_brackets", &[hover]); + // Component.empty().append(getHoverName()), italic for a custom name. + let mut name = Text::empty().append(hover); + if custom.is_some() { + name = name.italic(); + } + let wrapped = Text::translate("chat.square_brackets", &[name]); if empty { return wrapped; } @@ -903,7 +944,14 @@ impl Game<'_> { "epic" => text::LIGHT_PURPLE, _ => text::WHITE, }; - wrapped.with_color(color) + // HoverEvent.ShowItem: the count only when it is not one. + let mut shown = serde_json::json!({"action": "show_item", "id": item}); + if s.count != 1 { + shown["count"] = s.count.into(); + } + wrapped + .with_color(color) + .with_component_fields(vec![("hover_event".into(), shown)]) } pub(super) fn item_rarity(&self, item: &str) -> String { static RARITY: std::sync::OnceLock<std::collections::HashMap<String, String>> = @@ -953,33 +1001,38 @@ impl Game<'_> { } // An air stack is empty: nothing is given (but the message still is). let empty = id == "minecraft:air"; - for _ in targets.iter().filter(|_| !empty) { - let mut remaining = count; - while remaining > 0 { - let size = remaining.min(max_stack); - remaining -= size; - let left = self.give(ItemStack { - item: id.as_str().into(), - count: size as u32, - damage, - extra: extra.clone(), - }); - if let Some(rest) = left { - // Inventory full: drop the rest at the player's feet without pickup delay. - let p = self.source_position(); - self.spawn_item(rest, [p[0], p[1] + 1.32, p[2]], [0.0, 0.0, 0.0], 0); - } else { - let r = &mut self.world.random; - let pitch = ((r.next_float() - r.next_float()) * 0.7 + 1.0) * 2.0; - let p = self.source_position(); - self.audio - .play("minecraft:entity.item.pickup", Some(p), 0.2, pitch); + for &t in targets.iter().filter(|_| !empty) { + self.for_player(t, |g| { + let mut remaining = count; + while remaining > 0 { + let size = remaining.min(max_stack); + remaining -= size; + let left = g.give(ItemStack { + item: id.as_str().into(), + count: size as u32, + damage, + extra: extra.clone(), + }); + // At the player who gets them. + let p = g + .target_position(Target::Player) + .unwrap_or(g.source_position()); + if let Some(rest) = left { + // Inventory full: drop the rest at the player's feet without pickup delay. + g.spawn_item(rest, [p[0], p[1] + 1.32, p[2]], [0.0, 0.0, 0.0], 0); + } else { + let r = &mut g.world.random; + let pitch = ((r.next_float() - r.next_float()) * 0.7 + 1.0) * 2.0; + g.audio + .play("minecraft:entity.item.pickup", Some(p), 0.2, pitch); + } } - } + }); } + // The prototype stack: one item. let name = self.stack_display_name(&ItemStack { item: id.as_str().into(), - count: count.max(1) as u32, + count: 1, damage, extra: extra.clone(), }); @@ -989,7 +1042,7 @@ impl Game<'_> { &[ Text::literal(count.to_string()), name, - Text::literal(self.acting_player_name()), + self.target_name(targets[0]), ], ) } else { @@ -1008,6 +1061,9 @@ impl Game<'_> { fn teleport_to(&mut self, t: Target, pos: [f64; 3], rotation: Option<[f32; 2]>) { let v = Vec3::new(pos[0], pos[1], pos[2]); match t { + Target::Guest(_) => { + self.for_player(t, |g| g.teleport_to(Target::Player, pos, rotation)); + } Target::Player => { if let Some(p) = self.player.as_mut() { p.position = v; @@ -1088,17 +1144,59 @@ impl Game<'_> { Target::Frame(_) | Target::Painting(_) => {} } } + /// A server's player teleported into another level than theirs + /// (ServerPlayer.teleport): queued to move after the command. False + /// when `t` is not a player in another level. + fn teleport_across( + &mut self, + t: Target, + level: super::Dim, + pos: [f64; 3], + rotation: Option<[f32; 2]>, + ) -> bool { + let (conn, at) = match t { + Target::Player => (self.lan_acting, self.dim), + Target::Guest(conn) => ( + Some(conn), + self.command_guest(conn) + .map_or(self.dim, |g| super::Dim::from_id(&g.dimension)), + ), + _ => (None, self.dim), + }; + let Some(conn) = conn.filter(|_| at != level && self.options.dedicated.is_some()) else { + return false; + }; + self.level_teleports + .push(super::server_travel::LevelTeleport { + conn, + dim: level, + at: pos, + rotation, + }); + true + } fn cmd_teleport(&mut self, id: &str, ctx: &Context) -> R<i32> { let targets = if id.starts_with("teleport.targets") { self.entities(ctx, "targets", false)? } else { - vec![Target::Player] + vec![self.implied_player()] }; if id.ends_with("destination") { let dest = self.entities(ctx, "destination", false)?[0]; let pos = self.target_position(dest).unwrap_or(self.source_position()); + // Into the destination's level. + let level = match dest { + Target::Guest(conn) => self + .command_guest(conn) + .map_or(self.dim, |g| super::Dim::from_id(&g.dimension)), + _ => self.dim, + }; + // TeleportCommand.teleportToEntity: the destination's rotation too. + let rotation = Some(self.target_rotation(dest)); for &t in &targets { - self.teleport_to(t, pos, None); + if !self.teleport_across(t, level, pos, rotation) { + self.teleport_to(t, pos, rotation); + } } let message = if targets.len() == 1 { Text::translate( @@ -1156,24 +1254,18 @@ impl Game<'_> { (-(dy.atan2(horizontal).to_degrees())) as f32, ]); } - // `execute in` another dimension: a server's player moves to that - // level (ServerPlayer.teleport into another level), after the command. - let level = self - .command_source - .and_then(|s| s.level) - .filter(|d| *d != self.dim && self.options.dedicated.is_some()); + // A server's player in another level than the source's (`execute + // in`, the console's Overworld) moves there (ServerPlayer.teleport + // into another level), after the command. + let source_level = match self.command_source.and_then(|s| s.level) { + Some(level) => level, + None if self.source_entity().is_none() => super::Dim::Overworld, + None => self.dim, + }; for &t in &targets { - if let (Some(dim), Target::Player, Some(conn)) = (level, t, self.lan_acting) { - self.level_teleports - .push(super::server_travel::LevelTeleport { - conn, - dim, - at: pos, - rotation, - }); - continue; + if !self.teleport_across(t, source_level, pos, rotation) { + self.teleport_to(t, pos, rotation); } - self.teleport_to(t, pos, rotation); } let [x, y, z] = pos.map(|v| Text::literal(format_double(v))); let message = if targets.len() == 1 { @@ -1373,6 +1465,9 @@ impl Game<'_> { } fn kill_target(&mut self, t: Target) { match t { + Target::Guest(_) => { + self.for_player(t, |g| g.kill_target(Target::Player)); + } Target::Player => { if let Some(p) = self.player.as_mut() { let _ = p.set_health(0.0, false); @@ -1415,7 +1510,7 @@ impl Game<'_> { let targets = if ctx.get("targets").is_some() { self.entities(ctx, "targets", false)? } else { - vec![Target::Player] + vec![self.implied_player()] }; let names: Vec<Text> = targets.iter().map(|&t| self.target_name(t)).collect(); // Remove indexed entities from the back so earlier indices stay valid. diff --git a/crates/horizon-client/src/game/commands/data.rs b/crates/horizon-client/src/game/commands/data.rs index 1d2321a1a..c1f02821f 100644 --- a/crates/horizon-client/src/game/commands/data.rs +++ b/crates/horizon-client/src/game/commands/data.rs @@ -35,6 +35,11 @@ impl Game<'_> { pub(in crate::game) fn entity_nbt(&mut self, t: Target) -> Option<Tag> { let player_uuid = self.level.player_uuid; Some(match t { + Target::Guest(_) => { + return self + .for_player(t, |g| g.entity_nbt(Target::Player)) + .flatten(); + } Target::Player => { self.player.as_ref()?; self.sync_level(); diff --git a/crates/horizon-client/src/game/commands/effects.rs b/crates/horizon-client/src/game/commands/effects.rs index 86726fed9..ecfc8bc00 100644 --- a/crates/horizon-client/src/game/commands/effects.rs +++ b/crates/horizon-client/src/game/commands/effects.rs @@ -59,7 +59,7 @@ impl Game<'_> { if ctx.get("targets").is_some() { self.entities(ctx, "targets", false) } else { - Ok(vec![Target::Player]) + Ok(vec![self.implied_player()]) } } /// `EffectCommands.giveEffect`. @@ -83,10 +83,11 @@ impl Game<'_> { let mut tracker = Tracker::default(); for t in self.living_targets(ctx)? { let changed = match t { - Target::Player => { + Target::Player | Target::Guest(_) => { let mut instance = EffectInstance::new(effect.id, duration, amplifier); instance.visible = particles; - self.add_player_effect(instance) + self.for_player(t, |g| g.add_player_effect(instance)) + .unwrap_or(false) } Target::Mob(id) => match self.mobs.iter_mut().find(|m| m.id == id) { Some(m) => { @@ -131,18 +132,22 @@ impl Game<'_> { let mut tracker = Tracker::default(); for t in self.living_targets(ctx)? { let changed = match (t, effect) { - (Target::Player, None) => { - let any = !self.potions.effects.list.is_empty(); - self.potions.effects.clear(); - self.apply_effect_status(); - any - } - (Target::Player, Some(e)) => { - let before = self.potions.effects.list.len(); - self.potions.effects.list.retain(|x| x.id != e.id); - self.apply_effect_status(); - self.potions.effects.list.len() != before - } + (Target::Player | Target::Guest(_), None) => self + .for_player(t, |g| { + let any = !g.potions.effects.list.is_empty(); + g.potions.effects.clear(); + g.apply_effect_status(); + any + }) + .unwrap_or(false), + (Target::Player | Target::Guest(_), Some(e)) => self + .for_player(t, |g| { + let before = g.potions.effects.list.len(); + g.potions.effects.list.retain(|x| x.id != e.id); + g.apply_effect_status(); + g.potions.effects.list.len() != before + }) + .unwrap_or(false), (Target::Mob(id), e) => match self.mobs.iter_mut().find(|m| m.id == id) { Some(m) => { let before = m.extra.effects.len(); diff --git a/crates/horizon-client/src/game/commands/execute.rs b/crates/horizon-client/src/game/commands/execute.rs index 01488db2c..5ec1b48f4 100644 --- a/crates/horizon-client/src/game/commands/execute.rs +++ b/crates/horizon-client/src/game/commands/execute.rs @@ -73,7 +73,8 @@ impl Game<'_> { /// The source a command typed by the player starts from. pub(in crate::game) fn player_source(&self) -> Source { Source { - entity: Some(Target::Player), + // The server console has no entity (CommandSourceStack of the server). + entity: self.player.is_some().then_some(Target::Player), pos: self.source_position(), rot: self.source_rotation(), eyes: false, @@ -88,7 +89,7 @@ impl Game<'_> { pub(in crate::game) fn server_source(&self) -> Source { Source { entity: None, - pos: self.spawn.map_or([0.0, 64.0, 0.0], |s| [s.x, s.y, s.z]), + pos: self.server_position(), rot: [0.0, 0.0], eyes: false, silent: true, @@ -101,6 +102,9 @@ impl Game<'_> { pub(super) fn target_rotation(&self, t: Target) -> [f32; 2] { match t { Target::Player => [self.yaw, self.pitch], + Target::Guest(conn) => self + .command_guest(conn) + .map_or([0.0; 2], |g| [g.yaw, g.pitch]), Target::Mob(id) => self .mobs .iter() @@ -135,6 +139,7 @@ impl Game<'_> { .player .as_ref() .map_or(1.62, |p| f64::from(p.dimensions.eye_height)), + Target::Guest(conn) => self.command_guest(conn).map_or(1.62, |g| g.eye_height()), Target::Mob(id) => self .mobs .iter() @@ -633,7 +638,7 @@ impl Game<'_> { }) .collect() } - fn target_with_uuid(&self, uuid: [i32; 4]) -> Option<Target> { + pub(super) fn target_with_uuid(&self, uuid: [i32; 4]) -> Option<Target> { if Some(uuid) == self.level.player_uuid { return Some(Target::Player); } diff --git a/crates/horizon-client/src/game/commands/players.rs b/crates/horizon-client/src/game/commands/players.rs new file mode 100644 index 000000000..d71c219a8 --- /dev/null +++ b/crates/horizon-client/src/game/commands/players.rs @@ -0,0 +1,210 @@ +//! Commands acting on the other players of a hosted world or a server +//! (EntitySelector.findPlayers and EntityArgument's player targets). The +//! player in place (the host's, or the guest whose turn it is) is +//! `Target::Player`; every other guest is `Target::Guest`, found by name, +//! UUID or selector, and what a command does to them runs with their state +//! swapped in (`for_player`), as their own turn, what it tells them going to +//! their chat. +use super::{Game, Target}; +use horizon_client::{command::args::Selector, lan::guest::Guest, text::Text}; +use horizon_protocol::packets::play::{self, Clientbound as C}; + +impl Target { + /// A player, in place or not (`instanceof ServerPlayer`). + pub(in crate::game) fn is_player(self) -> bool { + matches!(self, Target::Player | Target::Guest(_)) + } +} + +/// GameType.getName for a guest's game mode id. +fn mode_name(id: i32) -> &'static str { + match id { + 1 => "creative", + 2 => "adventure", + 3 => "spectator", + _ => "survival", + } +} + +impl Game<'_> { + /// The guest `conn`, while the hub is in `self.lan`. + pub(in crate::game) fn command_guest(&self, conn: u32) -> Option<&Guest> { + self.lan.as_ref()?.hub.guest(conn) + } + + /// `PlayerList.getPlayers` but the player in place: the guests who + /// joined the world. + fn command_players(&self) -> impl Iterator<Item = &Guest> { + let acting = self.lan_acting; + self.lan + .iter() + .flat_map(|h| h.hub.guests.iter()) + .filter(move |g| g.placed && Some(g.conn) != acting) + } + + /// The entity the command runs as (`CommandSourceStack.getEntity`): a + /// command typed by the player in place runs as them, the server + /// console's as nobody. + pub(in crate::game) fn source_entity(&self) -> Option<Target> { + match self.command_source { + Some(s) => s.entity, + None => self.player.is_some().then_some(Target::Player), + } + } + + /// `CommandSourceStack.getPlayerOrException` for the commands whose + /// player argument is optional: the source's player (the player in + /// place when it has none, as before). + pub(in crate::game) fn implied_player(&self) -> Target { + self.source_entity() + .filter(|t| t.is_player()) + .unwrap_or(Target::Player) + } + + /// `PlayerList.getPlayerByName`: names are not case sensitive. + pub(super) fn player_named(&self, name: &str) -> Option<Target> { + if self.player.is_some() && name.eq_ignore_ascii_case(self.acting_player_name()) { + return Some(Target::Player); + } + self.command_players() + .find(|g| g.name.eq_ignore_ascii_case(name)) + .map(|g| Target::Guest(g.conn)) + } + + /// `EntitySelector.findEntities` with a UUID: the player with it, else + /// the entity. + pub(super) fn target_by_uuid(&self, uuid: u128) -> Option<Target> { + let own = self.lan_acting_uuid.or_else(|| { + self.level.player_uuid.map(|[a, b, c, d]| { + (u128::from(a as u32) << 96) + | (u128::from(b as u32) << 64) + | (u128::from(c as u32) << 32) + | u128::from(d as u32) + }) + }); + if self.player.is_some() && own == Some(uuid) { + return Some(Target::Player); + } + if let Some(g) = self.command_players().find(|g| g.uuid == uuid) { + return Some(Target::Guest(g.conn)); + } + let words = [96, 64, 32, 0].map(|shift| (uuid >> shift) as u32 as i32); + self.target_with_uuid(words) + } + + /// The guests a selector looks at, in join order (`PlayerList.getPlayers`), + /// the one in place as `Target::Player`: all of them, or those in the + /// source's level when it limits the search to a place + /// (`isWorldLimited`); `@e` and `@n` skip the dead (`Entity::isAlive`). + pub(super) fn player_candidates(&self, s: &Selector) -> Vec<Target> { + let limited = s.distance.is_some() + || s.pos.iter().any(Option::is_some) + || s.delta.iter().any(Option::is_some); + let alive = matches!(s.kind, 'e' | 'n'); + let here = self.dim.id(); + let in_place = self.lan_acting.filter(|_| self.player.is_some()); + self.lan + .iter() + .flat_map(|h| h.hub.guests.iter()) + .filter(|g| g.placed) + .filter(|g| !limited || g.dimension == here || Some(g.conn) == in_place) + .filter(|g| !alive || (!g.dead && g.health > 0.0)) + .map(|g| { + if Some(g.conn) == in_place { + Target::Player + } else { + Target::Guest(g.conn) + } + }) + .collect() + } + + /// A guest's experience level and game mode, for `level=` and `gamemode=`. + pub(super) fn guest_level_and_mode(&self, conn: u32) -> Option<(i32, &'static str)> { + self.command_guest(conn) + .map(|g| (g.xp_level, mode_name(g.game_mode))) + } + + /// `Player.getDisplayName`: the name as its team shows it, suggesting a + /// `/tell`, showing the player on hover, inserting the name. + pub(in crate::game) fn player_text(&self, name: &str, uuid: u128) -> Text { + let shown = match self.score.board.players_team(name) { + Some(team) => team.formatted_name(Text::literal(name)), + None => Text::literal(name), + }; + shown.with_component_fields(vec![ + ( + "click_event".into(), + serde_json::json!({"action": "suggest_command", "command": format!("/tell {name} ")}), + ), + ( + "hover_event".into(), + serde_json::json!({"action": "show_entity", "id": "minecraft:player", + "uuid": horizon_protocol::crypto::uuid_string(uuid), "name": name}), + ), + ("insertion".into(), name.into()), + ]) + } + + /// Run `f` for the player `t` (None for anything else): in place, or + /// with the guest's state swapped in, in their level, as their own turn. + /// What `f` tells the player (`system_message`) goes to their chat; the + /// command's own feedback is the caller's to send. + pub(in crate::game) fn for_player<T>( + &mut self, + t: Target, + f: impl FnOnce(&mut Self) -> T, + ) -> Option<T> { + let conn = match t { + Target::Player => return Some(f(self)), + Target::Guest(conn) if self.lan_acting == Some(conn) => return Some(f(self)), + Target::Guest(conn) => conn, + _ => return None, + }; + let mut host = self.lan.take()?; + let back = self.dim; + let theirs = host + .hub + .guest(conn) + .map(|g| super::super::Dim::from_id(&g.dimension)); + if let Some(dim) = theirs.filter(|d| *d != back) + && let Err(e) = self.enter_level(Some(&mut host), dim) + { + log::error!("could not open {}: {e}", dim.id()); + } + let Some(swap) = self.enter_guest(&mut host, conn) else { + if self.dim != back + && let Err(e) = self.enter_level(Some(&mut host), back) + { + log::error!("could not reopen {}: {e}", back.id()); + } + self.lan = Some(host); + return None; + }; + self.lan = Some(host); + let source = self.chat_capture.replace(Vec::new()); + let out = f(self); + let told = std::mem::replace(&mut self.chat_capture, source).unwrap_or_default(); + let mut host = self + .lan + .take() + .expect("the hub is back after a player's turn"); + self.leave_guest(&mut host, swap); + for line in told { + host.hub.send_to( + conn, + &C::SystemChat(play::SystemChat { + content: horizon_client::lan::data::component_nbt(&line.component()), + overlay: false, + }), + ); + } + if self.dim != back + && let Err(e) = self.enter_level(Some(&mut host), back) + { + log::error!("could not reopen {}: {e}", back.id()); + } + self.lan = Some(host); + Some(out) + } +} diff --git a/crates/horizon-client/src/game/dedicated.rs b/crates/horizon-client/src/game/dedicated.rs index 8a8ed63f9..68ca25c0d 100644 --- a/crates/horizon-client/src/game/dedicated.rs +++ b/crates/horizon-client/src/game/dedicated.rs @@ -829,6 +829,7 @@ impl Game<'_> { self.console_command(state, line); self.console_broadcast = None; if let Some(mut host) = self.lan.take() { + self.run_level_teleports(&mut host); self.send_admin_feedback(&mut host, None); self.lan = Some(host); } diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index d35bf787a..27095a4c6 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -61,6 +61,9 @@ pub(super) struct LanHost { /// are dead, whose respawn replaces their waypoint. pub waypoints: lan::waypoints::Waypoints, pub waypoint_dead: std::collections::HashSet<u128>, + /// Guests' commands waiting for the hub to be back in `self.lan`, where + /// a command can reach every player (game/lan_actions.rs). + pub commands: Vec<super::lan_actions::GuestCommand>, } /// The player who owns an integrated server's world: a guest whose state is @@ -520,6 +523,7 @@ impl Game<'_> { owner: None, waypoints: Default::default(), waypoint_dead: Default::default(), + commands: Vec::new(), }); self.audio.capture = Some(Vec::new()); Ok(()) @@ -796,7 +800,11 @@ impl Game<'_> { }; // What the tick sends a guest goes to its connection at the end. let holding = lan::Holding::start(); - // The host's own commands' broadcastToAdmins lines. + // The host's own commands' (and command blocks') players moving + // to another level, and their broadcastToAdmins lines. + if !self.level_teleports.is_empty() { + self.run_level_teleports(&mut host); + } if !self.admin_feedback.is_empty() { self.send_admin_feedback(&mut host, None); } @@ -918,6 +926,11 @@ impl Game<'_> { } HostEvent::Packet(conn, packet) => { self.lan_guest_packet(&mut host, conn, *packet); + if !host.commands.is_empty() { + self.lan = Some(host); + self.run_guest_commands(); + host = self.lan.take().expect("the hub is back after the commands"); + } } } } diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index ced435d8d..e3d816cff 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -58,6 +58,69 @@ pub(super) struct GuestPlay { pub(super) portal: horizon_client::nether_portal::PortalState, /// `Player.takeXpDelay`: ticks until the next orb can be taken. xp_delay: u32, + /// What last killed the guest outright (`/kill`): the death message's key. + death_cause: Option<String>, +} + +/// A guest's command waiting for the hub (`LanHost::commands`). +pub(super) struct GuestCommand { + conn: u32, + command: String, + permission: u8, + /// An integrated server's: no admin feedback or level teleports (yet). + integrated: bool, +} + +/// The game's own state while a guest's is swapped in (`enter_guest`), and +/// the guest's records that live outside `Guest`. +pub(super) struct GuestSwap { + conn: u32, + i: usize, + play: GuestPlay, + player: Option<PlayerMotion>, + /// The guest's eye height and the game's. + eye: (f32, f32), + yaw: f32, + pitch: f32, + selected: usize, + mode: horizon_client::command::args::GameMode, + creative: bool, + xp: Experience, + host_keys: std::collections::HashSet<KeyCode>, + screen: Screen, + host_sign: Option<super::sign_edit::SignEditor>, + host_book: Option<super::books::BookScreen>, + host_command_block: Option<super::command_blocks::CommandBlockScreen>, + host_mount_menu: super::mount_menu::MountMenu, + craft_size: usize, + craft_grid: Vec<Option<ItemStack>>, + container: Option<(i32, i32, i32)>, + mining: Option<Mining>, + destroy_delay: u32, + using: Option<(usize, u32)>, + use_delay: u32, + attack_ticks: u32, + swing: horizon_client::first_person::SwingState, + left: bool, + right: bool, + riding: Option<u32>, + host_station: Option<super::stations::Station>, + sleeping: Option<[i32; 3]>, + sleep_timer: u32, + spawn: Option<Vec3>, + respawn: ( + Option<super::respawn_anchor::RespawnConfig>, + Option<[f64; 3]>, + ), + message: Option<(String, std::time::Instant)>, + host_ender: Option<(i32, i32, i32)>, + adv_loaded: bool, + last_inventory: u64, + death_cause: Option<String>, + /// The guest whose turn this one nests in, if any. + acting: (Option<u32>, Option<String>, Option<u128>), + /// The packets queued for that guest. + packets: Vec<play::Clientbound>, } struct ItemRules<'a>(&'a horizon_client::items::Items); @@ -95,6 +158,24 @@ impl Game<'_> { conn: u32, f: impl FnOnce(&mut Self) -> R, ) -> Option<R> { + let swap = self.enter_guest(host, conn)?; + let result = f(self); + self.leave_guest(host, swap); + Some(result) + } + + /// The first half of `as_guest`: the guest's state in place of the + /// game's, which the returned swap keeps until `leave_guest`. Between the + /// two the host may go back into `self.lan`, so that what the guest does + /// can reach the other players (their commands, `for_player`), and a + /// guest's turn can nest in another's: the acting guest and the packets + /// queued for them are kept and restored too. + pub(super) fn enter_guest(&mut self, host: &mut LanHost, conn: u32) -> Option<GuestSwap> { + // The guest whose turn it is is in place already (their record holds + // the game's state until their turn ends). + if self.lan_acting == Some(conn) { + return None; + } let i = host.hub.guests.iter().position(|g| g.conn == conn)?; if host.hub.guests[i].motion.is_none() { let p = Vec3::new( @@ -198,17 +279,109 @@ impl Game<'_> { std::mem::swap(&mut self.stats, &mut play.stats); let adv_loaded = std::mem::replace(&mut self.adv.loaded, true); let last_inventory = std::mem::replace(&mut self.adv.last_inventory, play.last_inventory); - self.lan_acting = Some(conn); - self.lan_acting_name = Some(g.name.clone()); - self.lan_acting_uuid = Some(g.uuid); + let death_cause = std::mem::replace(&mut self.ui.death_cause, play.death_cause.take()); + let acting = ( + self.lan_acting.replace(conn), + self.lan_acting_name.replace(g.name.clone()), + self.lan_acting_uuid.replace(g.uuid), + ); + let packets = std::mem::take(&mut self.guest_packets); + Some(GuestSwap { + conn, + i, + play, + player, + eye, + yaw, + pitch, + selected, + mode, + creative, + xp, + host_keys, + screen, + host_sign, + host_book, + host_command_block, + host_mount_menu, + craft_size, + craft_grid, + container, + mining, + destroy_delay, + using, + use_delay, + attack_ticks, + swing, + left, + right, + riding, + host_station, + sleeping, + sleep_timer, + spawn, + respawn, + message, + host_ender, + adv_loaded, + last_inventory, + death_cause, + acting, + packets, + }) + } - let result = f(self); - for packet in std::mem::take(&mut self.guest_packets) { + /// The second half of `as_guest`: the guest's state back into their + /// record, the game's back in place, and what the turn changed sent. + pub(super) fn leave_guest(&mut self, host: &mut LanHost, swap: GuestSwap) { + let GuestSwap { + conn, + i, + mut play, + mut player, + eye, + yaw, + pitch, + selected, + mode, + creative, + xp, + host_keys, + screen, + host_sign, + host_book, + host_command_block, + host_mount_menu, + craft_size, + craft_grid, + container, + mining, + destroy_delay, + using, + use_delay, + attack_ticks, + swing, + left, + right, + riding, + host_station, + sleeping, + sleep_timer, + spawn, + respawn, + message, + host_ender, + adv_loaded, + last_inventory, + death_cause, + acting, + packets, + } = swap; + for packet in std::mem::replace(&mut self.guest_packets, packets) { host.hub.send_to(conn, &packet); } - self.lan_acting = None; - self.lan_acting_name = None; - self.lan_acting_uuid = None; + (self.lan_acting, self.lan_acting_name, self.lan_acting_uuid) = acting; + play.death_cause = std::mem::replace(&mut self.ui.death_cause, death_cause); // An ender chest the guest opened: the menu shows their inventory // itself (lan_open_container), not a stand-in block entity. self.close_ender_chest(); @@ -281,6 +454,9 @@ impl Game<'_> { std::mem::swap(&mut self.armor, &mut g.armor); std::mem::swap(&mut self.offhand, &mut g.offhand); std::mem::swap(&mut self.carried, &mut g.carried); + // A teleport with a rotation (commands) turns the guest. + let turned = [self.yaw, self.pitch] != [g.yaw, g.pitch]; + [g.yaw, g.pitch] = [self.yaw, self.pitch]; self.yaw = yaw; self.pitch = pitch; self.eye = eye.1; @@ -294,7 +470,7 @@ impl Game<'_> { m.sprinting = false; 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 { + if moved > 0.0001 || turned { host.hub.teleport(i, Some(at)); } } @@ -331,7 +507,6 @@ impl Game<'_> { if opened_table { self.lan_open_crafting(host, conn); } - Some(result) } /// `ServerLevel.players()` in turn: the host's own player, then each @@ -884,34 +1059,12 @@ impl Game<'_> { return; } // An integrated server runs every player's commands at their own - // permission level (`CommandSourceStack.permissions`). - if host.hub.config.integrated { - let Some(level) = host.hub.guest(conn).map(|g| g.permission) else { - return; - }; - let command = command.trim_start_matches('/').to_owned(); - let lines = self.as_guest(host, conn, |g| { - let console = std::mem::replace(&mut g.ui.registries.permission, level); - g.chat_capture = Some(Vec::new()); - g.run_command(&command); - g.ui.registries.permission = console; - g.chat_capture.take().unwrap_or_default() - }); - for line in lines.unwrap_or_default() { - host.hub.send_to( - conn, - &C::SystemChat(play::SystemChat { - content: horizon_client::lan::data::component_nbt(&line.component()), - overlay: false, - }), - ); - } - return; - } - // A LAN world follows its Allow Commands; a dedicated server leaves - // it to the ops list (the guest's permission level). + // permission level (`CommandSourceStack.permissions`); a LAN world + // follows its Allow Commands, and a dedicated server leaves it to + // the ops list (the guest's permission level). + let integrated = host.hub.config.integrated; let allowed = self.options.dedicated.is_some() || self.allow_commands(); - if !host.settings.guest_commands || !allowed { + if !integrated && (!host.settings.guest_commands || !allowed) { host.hub.send_to( conn, &C::SystemChat(play::SystemChat { @@ -921,34 +1074,62 @@ impl Game<'_> { ); return; } - let command = command.trim_start_matches('/').to_owned(); - // The guest's own level (Commands.performCommand with the player's source): an - // operator's on a dedicated server, never the host's. - let permission = host.hub.guest(conn).map_or(0, |g| g.permission); - let lines = self.as_guest(host, conn, |g| { - g.chat_capture = Some(Vec::new()); - let level = std::mem::replace(&mut g.ui.registries.permission, permission); - g.run_command(&command); - g.ui.registries.permission = level; - g.chat_capture - .take() - .unwrap_or_default() - .iter() - .map(|t| horizon_client::lan::data::component_nbt(&t.component())) - .collect::<Vec<_>>() + // The guest's own level (Commands.performCommand with the player's + // source): an operator's on a dedicated server, never the host's. + let Some(permission) = host.hub.guest(conn).map(|g| g.permission) else { + return; + }; + host.commands.push(GuestCommand { + conn, + command: command.trim_start_matches('/').to_owned(), + permission, + integrated, }); - // A teleport into another level happens before its feedback is sent. - self.run_level_teleports(host); - for content in lines.unwrap_or_default() { - host.hub.send_to( - conn, - &C::SystemChat(play::SystemChat { - content, - overlay: false, - }), - ); + } + + /// The guests' queued commands, run with the hub in `self.lan` so that + /// they reach the other players too (`/give Bob`, `/tp Bob`, `/kick`). + pub(super) fn run_guest_commands(&mut self) { + loop { + let Some(host) = self.lan.as_mut() else { + return; + }; + if host.commands.is_empty() { + return; + } + let c = host.commands.remove(0); + let mut host = self.lan.take().expect("checked above"); + let Some(swap) = self.enter_guest(&mut host, c.conn) else { + self.lan = Some(host); + continue; + }; + self.lan = Some(host); + self.chat_capture = Some(Vec::new()); + let level = std::mem::replace(&mut self.ui.registries.permission, c.permission); + self.run_command(&c.command); + self.ui.registries.permission = level; + let lines = self.chat_capture.take().unwrap_or_default(); + let mut host = self.lan.take().expect("a command puts the hub back"); + self.leave_guest(&mut host, swap); + host.hub.sync_all_effects(); + if !c.integrated { + // A teleport into another level happens before its feedback is sent. + self.run_level_teleports(&mut host); + } + for line in lines { + host.hub.send_to( + c.conn, + &C::SystemChat(play::SystemChat { + content: horizon_client::lan::data::component_nbt(&line.component()), + overlay: false, + }), + ); + } + if !c.integrated { + self.send_admin_feedback(&mut host, Some(c.conn)); + } + self.lan = Some(host); } - self.send_admin_feedback(host, Some(conn)); } /// The `broadcastToAdmins` lines a command queued (`source`: the guest @@ -1165,7 +1346,34 @@ impl Game<'_> { total: g.xp_total, } .death_reward(self.ui.rules.bool("keep_inventory") || g.game_mode == SPECTATOR); - let message = literal(&format!("{} died", g.name)); + let (name, uuid) = (g.name.clone(), g.uuid); + let cause = host.play.get_mut(&conn).and_then(|p| p.death_cause.take()); + let message = match cause { + // ServerPlayer.die: the death message, to everyone unless + // the player's team hides it. + Some(key) if self.ui.rules.bool("show_death_messages") => { + let text = horizon_client::text::Text::translate( + &key, + &[self.player_text(&name, uuid)], + ); + let message = horizon_client::lan::data::component_nbt(&text.component()); + let team = self.score.board.players_team(&name); + if horizon_client::scoreboard::own_death_message_shown(team) { + host.hub.system_message(message.clone()); + if self.options.dedicated.is_some() { + super::dedicated::log( + "INFO", + &format!("System chat: {}", text.plain()), + ); + } else if self.player.is_some() { + self.system_message(text); + } + } + message + } + Some(_) => literal(""), + None => literal(&format!("{name} died")), + }; host.hub.send_to( conn, &C::PlayerCombatKill(play::PlayerCombatKill { id, message }), diff --git a/crates/horizon-client/src/game/scoreboard.rs b/crates/horizon-client/src/game/scoreboard.rs index 4e715c7b7..0acdbe998 100644 --- a/crates/horizon-client/src/game/scoreboard.rs +++ b/crates/horizon-client/src/game/scoreboard.rs @@ -131,6 +131,7 @@ impl Game<'_> { pub(super) fn holder_name(&mut self, t: Target) -> Option<String> { match t { Target::Player => Some(self.acting_player_name().to_owned()), + Target::Guest(conn) => self.command_guest(conn).map(|g| g.name.clone()), Target::Mob(id) | Target::Item(id) => Some(uuid_text(self.uuid_for(id))), _ => None, } @@ -179,7 +180,7 @@ impl Game<'_> { | Target::Cart(id) | Target::Other(id) => self.persist.raw.get(&id), Target::Player => self.level.player_extra.as_ref(), - Target::Orb(_) | Target::Arrow(_) => None, + Target::Guest(_) | Target::Orb(_) | Target::Arrow(_) => None, }; match raw.and_then(|r| r.get("Tags")) { Some(Tag::List(l)) => l diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index c88292787..e224ec086 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -670,6 +670,16 @@ impl Hub { /// onEffectsRemoved, from what changed since the client was told: an /// effect that only counted down is not sent again, except at every /// 600 ticks left (`LivingEntity.tickEffects`). + /// `sync_effects` for every player at once: what a command changed + /// leaves with its feedback (ServerPlayer.onEffectAdded sends at once), + /// not after the tick's countdown. + pub fn sync_all_effects(&mut self) { + for i in 0..self.guests.len() { + if self.guests[i].placed { + self.sync_effects(i); + } + } + } fn sync_effects(&mut self, i: usize) { let g = &self.guests[i]; if g.effects.list.is_empty() && g.sent_effects.is_empty() { diff --git a/crates/horizon-client/src/text.rs b/crates/horizon-client/src/text.rs index ea11d4163..3874efd17 100644 --- a/crates/horizon-client/src/text.rs +++ b/crates/horizon-client/src/text.rs @@ -279,6 +279,12 @@ impl Text { self.source = Some(c.into()); self } + /// The same spans, sent to vanilla as `component` (a shape the spans' + /// own JSON would not take, such as a styled root with siblings). + pub fn with_component(mut self, component: Value) -> Self { + self.source = Some(component.into()); + self + } pub fn with_color(self, color: u32) -> Self { self.with_style(&Style::color(color)) } diff --git a/mods/horizon/src/test/java/dev/horizonlab/parity/LocatorBarClient.java b/mods/horizon/src/test/java/dev/horizonlab/parity/LocatorBarClient.java index e2de1b004..3eb241d5e 100644 --- a/mods/horizon/src/test/java/dev/horizonlab/parity/LocatorBarClient.java +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/LocatorBarClient.java @@ -82,13 +82,16 @@ import net.minecraft.world.phys.Vec3; * players on|off} (whether each player also records the other players added * to and removed from its level, and its own respawns into a dimension), * {@code chat on|off} (whether the system chat each player receives is - * recorded too, as component JSON) and {@code end}, which writes each + * recorded too, as component JSON), {@code state on|off} (whether each player + * also records what the server changes about it: its game mode, teleports, + * inventory slots, effects and death) and {@code end}, which writes each * player's lines to OUT. */ public final class LocatorBarClient { private static volatile String step = "start"; private static volatile boolean players; private static volatile boolean chat; + private static volatile boolean state; private static final Map<UUID, String> NAMES = new LinkedHashMap<>(); public static void main(String[] args) throws Exception { @@ -122,6 +125,7 @@ public final class LocatorBarClient { case "quit" -> players.get(w[1]).close(); case "players" -> LocatorBarClient.players = w[1].equals("on"); case "chat" -> chat = w[1].equals("on"); + case "state" -> state = w[1].equals("on"); case "end" -> { try (PrintWriter out = new PrintWriter(Files.newBufferedWriter(output, StandardCharsets.UTF_8))) { for (Player p : players.values()) { @@ -179,6 +183,8 @@ public final class LocatorBarClient { private ProtocolInfo<?> outbound; private volatile PositionMoveRotation position = new PositionMoveRotation(Vec3.ZERO, Vec3.ZERO, 0, 0); private boolean loaded; + /** This player's own entity id (ClientboundLoginPacket). */ + private volatile int id = -1; /** The other players this one was sent, by entity id. */ private final Map<Integer, String> seen = new java.util.HashMap<>(); private final Object replyLock = new Object(); @@ -287,6 +293,10 @@ public final class LocatorBarClient { while (true) { Received r = read(); Packet<?> p = r.packet; + if (p instanceof net.minecraft.network.protocol.game.ClientboundLoginPacket l) { + id = l.playerId(); + } + if (state) recordState(p); if (p instanceof net.minecraft.network.protocol.game.ClientboundAddEntityPacket a && a.getType() == net.minecraft.world.entity.EntityTypes.PLAYER) { String who = NAMES.getOrDefault(a.getUUID(), "uuid?"); @@ -319,6 +329,10 @@ public final class LocatorBarClient { } else if (p instanceof ClientboundPlayerPositionPacket t) { position = PositionMoveRotation.calculateAbsolute(position, t.change(), t.relatives()); Vec3 at = position.position(); + if (state) { + record(String.format(java.util.Locale.ROOT, "teleport %.3f %.3f %.3f %.1f %.1f", + at.x, at.y, at.z, position.yRot(), position.xRot())); + } send(new ServerboundAcceptTeleportationPacket(t.id(), at.x, at.y, at.z, position.yRot(), position.xRot())); // Only the spawn teleport is answered with a position too (VanillaProtocolClient). if (!loaded) { @@ -338,6 +352,31 @@ public final class LocatorBarClient { } } + /** What the server changed about this player ({@code state on}). */ + private void recordState(Packet<?> p) { + if (p instanceof net.minecraft.network.protocol.game.ClientboundGameEventPacket g + && g.getEvent() == net.minecraft.network.protocol.game.ClientboundGameEventPacket.CHANGE_GAME_MODE) { + record("gamemode " + (int) g.getParam()); + } else if (p instanceof net.minecraft.network.protocol.game.ClientboundContainerSetSlotPacket c) { + record("slot " + c.getContainerId() + " " + c.getSlot() + " " + item(c.getItem())); + } else if (p instanceof net.minecraft.network.protocol.game.ClientboundSetPlayerInventoryPacket i) { + record("inventory " + i.slot() + " " + item(i.contents())); + } else if (p instanceof net.minecraft.network.protocol.game.ClientboundUpdateMobEffectPacket e && e.getEntityId() == id) { + record("effect " + e.getEffect().getRegisteredName() + " " + e.getEffectAmplifier() + " " + e.getEffectDurationTicks()); + } else if (p instanceof net.minecraft.network.protocol.game.ClientboundRemoveMobEffectPacket e && e.entityId() == id) { + record("effect-removed " + e.effect().getRegisteredName()); + } else if (p instanceof net.minecraft.network.protocol.game.ClientboundPlayerCombatKillPacket k) { + record("killed " + net.minecraft.network.chat.ComponentSerialization.CODEC + .encodeStart(ParityData.access.createSerializationContext(com.mojang.serialization.JsonOps.INSTANCE), k.message()) + .getOrThrow()); + } + } + + private static String item(net.minecraft.world.item.ItemStack stack) { + return stack.isEmpty() ? "empty" + : net.minecraft.core.registries.BuiltInRegistries.ITEM.getKey(stack.getItem()) + " x" + stack.getCount(); + } + private record Received(Packet<?> packet, byte[] payload) {} private Received read() throws Exception { diff --git a/tools/test_server_player_targets_parity.py b/tools/test_server_player_targets_parity.py new file mode 100644 index 000000000..f8f457143 --- /dev/null +++ b/tools/test_server_player_targets_parity.py @@ -0,0 +1,199 @@ +#!/usr/bin/env python3 +"""Commands acting on other players of a dedicated server, against vanilla's, seen by vanilla clients. + +EntitySelector.findPlayers and EntityArgument's player targets: names, UUIDs, `@a`, `@p`, `@r`, `@s` under +`execute as`, from the console and from an operator, with `give`, `gamemode`, `tp` (to a place, to a player, with a +rotation, and into another level by `execute in`, the console's own level or the destination's), `effect give` and +`effect clear`, and `kill`. + +A vanilla dedicated server and Horizon's (`horizon-client --dedicated --nogui`) each serve a copy of one flat world +vanilla generated first, with Alice and Bob as operators in creative. LocatorBarClient joins them both (players made +of vanilla's protocol code) and records, step by step, the system chat each receives and what the server changes +about it: game mode events, teleports, inventory slots, effects, its death (with the death message), the other +players it is sent or loses and the levels it respawns into. Each player's lines in each step are compared exactly, +in sorted order (the packets of one step may leave in another order within the tick). The locator bar's waypoints +and what a death does besides its messages are left to their own harnesses. +""" +import hashlib +import os +from pathlib import Path +import platform +import shutil +import subprocess +import sys +import time +import uuid as uuidlib + +try: + from . import lab, test_rust_parity as base + from .test_dedicated_server_parity import Server + from .test_locator_bar_parity import generate_world, server_dir +except ImportError: + import lab + import test_rust_parity as base + from test_dedicated_server_parity import Server + from test_locator_bar_parity import generate_world, server_dir + +NAME = 'server-player-targets-parity' +NETHER, OVERWORLD = 'minecraft:the_nether', 'minecraft:overworld' + + +def offline_uuid(name): + """UUIDUtil.createOfflinePlayerUUID.""" + digest = bytearray(hashlib.md5(f'OfflinePlayer:{name}'.encode()).digest()) + digest[6] = (digest[6] & 0x0F) | 0x30 + digest[8] = (digest[8] & 0x3F) | 0x80 + return str(uuidlib.UUID(bytes=bytes(digest))) + + +# (label, what the console does, what the players do). +SCRIPT = [ + ('console-give', ['give Bob minecraft:diamond 3'], []), + ('console-give-all', ['give @a minecraft:apple'], []), + ('alice-give-bob', [], ['cmd Alice give Bob minecraft:stick 2']), + ('console-give-uuid', [f'give {offline_uuid("Bob")} minecraft:iron_ingot'], []), + ('console-give-nearest', ['give @p minecraft:emerald'], []), + ('alice-give-random', [], ['cmd Alice give @r[name=Bob] minecraft:gold_ingot']), + ('console-gamemode', ['gamemode survival Bob'], []), + ('alice-gamemode-bob', [], ['cmd Alice gamemode creative Bob']), + ('alice-gamemode-all', [], ['cmd Alice gamemode adventure @a']), + ('console-gamemode-back', ['gamemode creative @a'], []), + ('console-tp', ['tp Bob 8.5 -60 8.5'], []), + ('alice-tp-bob-to-alice', [], ['cmd Alice tp Bob Alice']), + ('console-tp-rotation', ['tp Bob 4.5 -60 0.5 90 10'], []), + ('bob-tp-self', [], ['cmd Bob tp @s 6.5 -60 0.5']), + ('console-execute-as', ['execute as Bob run tp @s ~ ~ ~2'], []), + ('console-execute-at', ['execute at Bob run tp Alice ~1 ~ ~'], []), + ('alice-execute-as-all', [], ['cmd Alice execute as @a run give @s minecraft:bread']), + ('console-effect', ['effect give Bob minecraft:speed 30 1'], []), + ('alice-effect-all', [], ['cmd Alice effect give @a minecraft:haste infinite']), + ('console-effect-clear', ['effect clear Bob'], []), + ('alice-effect-clear-all', [], ['cmd Alice effect clear @a minecraft:haste']), + ('console-nether', [f'execute in {NETHER} run tp Bob 0.5 100 0.5'], []), + ('console-tp-home', ['tp Bob 4.5 -60 0.5'], []), + ('alice-nether', [], [f'cmd Alice execute in {NETHER} run tp Bob 0.5 100 0.5']), + ('console-tp-to-alice', ['tp Bob Alice'], []), + ('alice-kill-missing', [], ['cmd Alice kill Carol']), + ('console-kill', ['kill Bob'], []), +] +# What the players' locator bars show has its own harness (test_locator_bar_parity), and what a death does +# besides its messages (drops, the body leaving) the player combat ones: here only the messages of `kill`. +WAYPOINTS = ('track ', 'untrack ', 'update ') +DEATH_STEP = 'step=console-kill' +STEP_SECONDS = 2.5 + + +def run_side(label, server_command, client_command, build, world): + directory = build / label + port = server_dir(directory, world) + out = build / f'{label}.txt' + out.unlink(missing_ok=True) + server = Server(server_command, directory, label) + try: + server.wait_for(r'Done \(') + with (build / f'{label}-client.log').open('w') as log: + client = subprocess.Popen([*map(str, client_command), '127.0.0.1', str(port), str(out)], + cwd=lab.ROOT, stdin=subprocess.PIPE, stdout=log, stderr=subprocess.STDOUT, + text=True) + + def tell(line): + client.stdin.write(line + '\n') + client.stdin.flush() + try: + for name, x in (('Alice', 0.5), ('Bob', 4.5)): + tell(f'join {name}') + server.wait_for(rf'{name} joined the game', timeout=120) + tell(f'fly {name} on') + tell(f'cmd {name} tp @s {x} -60 0.5 0 0') + time.sleep(STEP_SECONDS) + for flag in ('chat', 'state', 'players'): + tell(f'{flag} on') + for step, console, actions in SCRIPT: + tell(f'step {step}') + for command in console: + server.console(command) + for action in actions: + tell(action) + time.sleep(STEP_SECONDS) + for name in ('Alice', 'Bob'): + tell(f'still {name}') + tell('end') + client.wait(timeout=60) + finally: + if client.poll() is None: + client.kill() + finally: + server.stop() + if not out.exists(): + raise AssertionError(f'{label}: the client wrote no transcript (see {build}/{label}-client.log)') + lines = out.read_text(encoding='utf-8').splitlines() + errors = [l for l in lines if ' error ' in f' {l} ' or 'disconnected' in l] + steps = {} + for line in lines: + who, step, rest = line.split(' ', 2) + # At the death, Alice picks up Bob's drops (and gets their advancements) in vanilla. + death_side = step == DEATH_STEP and (not rest.startswith(('chat ', 'killed ')) + or 'chat.type.advancement' in rest) + if rest.startswith(WAYPOINTS) or death_side: + continue + if step != 'step=start': + steps.setdefault((who, step), []).append(line) + order = {f'step={s}': i for i, (s, _, _) in enumerate(SCRIPT)} + keys = sorted(steps, key=lambda k: (k[0], order.get(k[1], -1))) + return [l for k in keys for l in sorted(steps[k])], errors + + +def main(): + lock, jars, libraries = base.verify_artifacts() + build = lab.LOCAL / NAME + build.mkdir(parents=True, exist_ok=True) + report = build / 'report.json' + report.unlink(missing_ok=True) + oracle = lab.ROOT / 'mods/horizon/src/test/java/dev/horizonlab/parity/LocatorBarClient.java' + classes = build / 'classes' + shutil.rmtree(classes, ignore_errors=True) + classes.mkdir() + dependencies = os.pathsep.join(map(str, [jars['server'], *libraries])) + subprocess.run(['javac', '--release', str(lock['minecraft']['java_major']), '-proc:none', '-nowarn', '-sourcepath', + lab.ROOT / 'mods/horizon/src/test/java', '-cp', dependencies, '-d', classes, oracle], + cwd=lab.ROOT, check=True, capture_output=True) + subprocess.run(['cargo', 'build', '--release', '-p', 'horizon-client', '--bin', 'horizon-client'], cwd=lab.ROOT, + check=True, capture_output=True) + import json + metadata = json.loads(subprocess.check_output(['cargo', 'metadata', '--no-deps', '--format-version', '1'], + cwd=lab.ROOT, text=True)) + binary = Path(metadata['target_directory']) / 'release' / ('horizon-client.exe' if os.name == 'nt' else 'horizon-client') + vanilla_server = ['java', '-Xmx2g', '-Duser.timezone=UTC', '-cp', dependencies, 'net.minecraft.server.Main', 'nogui'] + horizon_server = [binary, '--resources', lab.LOCAL / 'horizon-client/26.3', '--dedicated', '--nogui'] + client = ['java', '-Xmx1g', '-cp', str(classes) + os.pathsep + dependencies, 'dev.horizonlab.parity.LocatorBarClient'] + + world = generate_world(vanilla_server, build) + vanilla, vanilla_errors = run_side('vanilla', vanilla_server, client, build, world) + horizon, horizon_errors = run_side('horizon', horizon_server, client, build, world) + (build / 'vanilla.txt').write_text('\n'.join(vanilla) + '\n', encoding='utf-8') + (build / 'horizon.txt').write_text('\n'.join(horizon) + '\n', encoding='utf-8') + errors = vanilla_errors + horizon_errors + if errors or vanilla != horizon: + import difflib + diff = '\n'.join(difflib.unified_diff(vanilla, horizon, 'vanilla', 'horizon', n=1, lineterm='')) + raise AssertionError(f'{len(errors)} errors, transcripts differ (see {build}/vanilla.txt and horizon.txt):\n' + + '\n'.join(errors[:10]) + '\n' + diff[:8000]) + for needle in ('gamemode 0', 'minecraft:diamond x3', 'effect minecraft:speed', 'respawn ' + NETHER, + 'death.attack.genericKill'): + if not any(needle in l for l in vanilla): + raise AssertionError(f'vanilla never sent {needle!r}: the script did not run (see {build})') + lab.write_json(report, dict( + schema=1, minecraft=lock['minecraft']['version'], platform=platform.platform(), + java=subprocess.check_output(['java', '--version'], text=True).splitlines()[0], + lines=len(vanilla), output_sha256=lab.digest(build / 'horizon.txt', 'sha256'), + scope='Commands from the console and an operator acting on another player of a dedicated server: names, ' + 'UUIDs, @a, @p, @r and @s under execute as/at, with give, gamemode, tp (place, player, rotation, ' + 'execute in, across levels), effect give and clear and kill, as the players see them.')) + print(f'server player targets: {len(vanilla)} lines identical') + + +if __name__ == '__main__': + try: + main() + except AssertionError as error: + sys.exit(f'{NAME}: {error}') From f57c59a971e2f04b77cc05123a0a7e016a4a3e84 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 11:08:03 +0200 Subject: [PATCH 090/163] Structures: Repurposed Structures' and Moog's piece-limited jigsaw assembler A jigsaw structure with "horizon:piece_limited" is laid out as PieceLimitedJigsawManager does (the same code in both mods): a fresh random seeded by the chunk, the start piece drawn uniformly and moved to the surface at its center, a volume 120 blocks down and 180 up, children drawn by weight from the pools' entries in order, pieces capped per template and some required (retried up to 40 times), pools whose fallbacks ignore the bounds, y_allowance clipping. After the layout, the structure's postLayoutAdjustments: the pieces centred on the chunk corner, then buried (lowest corner, average land, lowest side) or, for the Nether variants, moved onto the highest or lowest land or a fixed height. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../horizon-world/src/worldgen/structure.rs | 1 + .../src/worldgen/structure/jigsaw.rs | 2 +- .../src/worldgen/structure/piece_limited.rs | 980 ++++++++++++++++++ .../src/worldgen/structure/start.rs | 26 +- 4 files changed, 1004 insertions(+), 5 deletions(-) create mode 100644 crates/horizon-world/src/worldgen/structure/piece_limited.rs diff --git a/crates/horizon-world/src/worldgen/structure.rs b/crates/horizon-world/src/worldgen/structure.rs index 4f533d06b..072b9f5f6 100644 --- a/crates/horizon-world/src/worldgen/structure.rs +++ b/crates/horizon-world/src/worldgen/structure.rs @@ -10,6 +10,7 @@ pub mod mineshaft; pub mod monument; pub mod nether_fossil; pub mod ocean_ruin; +pub mod piece_limited; pub mod processor; pub mod ruined_portal; pub mod simple; diff --git a/crates/horizon-world/src/worldgen/structure/jigsaw.rs b/crates/horizon-world/src/worldgen/structure/jigsaw.rs index a5c2b8358..34a2728f4 100644 --- a/crates/horizon-world/src/worldgen/structure/jigsaw.rs +++ b/crates/horizon-world/src/worldgen/structure/jigsaw.rs @@ -311,7 +311,7 @@ pub struct Pool { max_size: OnceLock<i32>, } impl Pool { - fn random_template(&self, random: &mut impl RandomSource) -> Arc<PoolElement> { + pub(super) fn random_template(&self, random: &mut impl RandomSource) -> Arc<PoolElement> { if self.templates.is_empty() { return Arc::new(PoolElement::Empty); } diff --git a/crates/horizon-world/src/worldgen/structure/piece_limited.rs b/crates/horizon-world/src/worldgen/structure/piece_limited.rs new file mode 100644 index 000000000..1372f247b --- /dev/null +++ b/crates/horizon-world/src/worldgen/structure/piece_limited.rs @@ -0,0 +1,980 @@ +//! The piece-limited jigsaw assembler of Repurposed Structures and Moog's +//! Structure Lib (PieceLimitedJigsawManager, the same code in both), for +//! their structures carried over from a modpack (docs/modpacks.md). Carry +//! maps their jigsaw types to `minecraft:jigsaw` with a +//! `"horizon:piece_limited"` key; vanilla data never has it. +//! +//! ```json +//! "horizon:piece_limited": { +//! "library": "moogs", // or "repurposed": their few differences +//! "min_y": 40, "max_y": 120, // y_allowance: pieces stay inside, unless buried +//! "burying": "lowest_corner", // or "average_land", "lowest_side" +//! "no_liquid": true, // cannot_spawn_in_liquid, as burying reads it +//! "ignore_bounds_pools": ["x:pool"], +//! "land_search": "highest_land", // the Nether variants: or "lowest_land", "fixed_height" +//! "ledge_offset_y": 2, +//! "pieces": [{"name": "x:piece", "required": 1, "min_depth": 3, "max": 2}] +//! } +//! ``` +//! +//! It differs from vanilla's JigsawPlacement: a fresh random seeded by the +//! chunk, the start piece drawn uniformly and moved to the surface at its +//! center, a bounding volume 120 blocks down and 180 up, children drawn by +//! weight from the pools' weighted entries in order (`nextInt(total) + 1`, +//! counted down), pieces capped by template (`max`) and some required +//! (`required`, from `min_depth`), the whole layout retried up to 40 times +//! until every required piece is in, and after it the pieces centred on the +//! chunk corner, then buried in the terrain or moved onto Nether land. +use super::{ + BoundingBox, Rotation, StructureResources, StructureTemplate, + jigsaw::{ + Free, JigsawConfig, Junction, PoolElement, PoolPiece, Pools, Projection, can_attach, + shuffle, step, + }, + start::StartContext, +}; +use crate::{ + heightmap::HeightmapType, identifier::Identifier, java_hash_map::JavaHashMap, + worldgen::block_feature::FeatureBlockBindings, +}; +use horizon_core::{ + position::ChunkPos, + random::{LegacyRandom, RandomSource, WorldgenRandom}, +}; +use serde_json::Value; +use std::{ + cell::RefCell, + collections::{HashSet, VecDeque}, + rc::Rc, + sync::Arc, +}; + +/// Which mod's copy of the code: they differ in a few post-layout steps. +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub enum Library { + Moogs, + Repurposed, +} + +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub enum Burying { + LowestCorner, + AverageLand, + LowestSide, +} + +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub enum LandSearch { + Highest, + Lowest, + Fixed, +} + +/// One template's counts (`*_pieces_spawn_counts`). +#[derive(Clone, Debug)] +struct Counted { + required: Option<i32>, + min_depth: i32, + max: Option<i32>, +} + +/// `"horizon:piece_limited"` of a jigsaw structure. +#[derive(Debug)] +pub struct Config { + library: Library, + min_y: Option<i32>, + max_y: Option<i32>, + burying: Option<Burying>, + no_liquid: bool, + ignore_bounds: HashSet<String>, + land_search: Option<LandSearch>, + ledge: i32, + /// Counted templates by id, in the order of Java's HashMap of the + /// required pieces (the first one still short is forced in first). + pieces: Vec<(Identifier, Counted)>, +} + +impl Config { + pub fn decode(v: &Value) -> Self { + let int = |k: &str| v[k].as_i64().map(|n| n as i32); + let mut pieces: Vec<(Identifier, Counted)> = Vec::new(); + for p in v["pieces"].as_array().into_iter().flatten() { + let Some(id) = p["name"].as_str().and_then(|n| Identifier::parse(n).ok()) else { + continue; + }; + let counted = Counted { + required: p["required"].as_i64().map(|n| n as i32), + min_depth: p["min_depth"].as_i64().unwrap_or(0) as i32, + max: p["max"].as_i64().map(|n| n as i32), + }; + // A later entry for the same piece replaces it, as HashMap.put. + match pieces.iter_mut().find(|(k, _)| *k == id) { + Some(slot) => slot.1 = counted, + None => pieces.push((id, counted)), + } + } + // getRequirePieces builds a HashMap of the required ones and the + // assembler copies it (new HashMap(map)): iterate as that copy does. + let mut map = JavaHashMap::default(); + for (i, (id, c)) in pieces.iter().enumerate() { + if c.required.is_some() { + map.put(id.clone(), i); + } + } + let order: Vec<usize> = map.copied().entries().map(|(_, &i)| i).collect(); + let mut sorted: Vec<(Identifier, Counted)> = + order.iter().map(|&i| pieces[i].clone()).collect(); + sorted.extend(pieces.iter().filter(|(_, c)| c.required.is_none()).cloned()); + Self { + library: match v["library"].as_str() { + Some("repurposed") => Library::Repurposed, + _ => Library::Moogs, + }, + min_y: int("min_y"), + max_y: int("max_y"), + burying: match v["burying"].as_str() { + Some("lowest_corner") => Some(Burying::LowestCorner), + Some("average_land") => Some(Burying::AverageLand), + Some("lowest_side") => Some(Burying::LowestSide), + _ => None, + }, + no_liquid: v["no_liquid"].as_bool().unwrap_or(false), + ignore_bounds: v["ignore_bounds_pools"] + .as_array() + .into_iter() + .flatten() + .filter_map(|p| Some(p.as_str()?.to_owned())) + .collect(), + land_search: match v["land_search"].as_str() { + Some("highest_land") => Some(LandSearch::Highest), + Some("lowest_land") => Some(LandSearch::Lowest), + Some("fixed_height") => Some(LandSearch::Fixed), + _ => None, + }, + ledge: int("ledge_offset_y").unwrap_or(0), + pieces: sorted, + } + } + fn required(&self) -> impl Iterator<Item = &Counted> { + self.pieces + .iter() + .map(|(_, c)| c) + .filter(|c| c.required.is_some()) + } +} + +/// The counted templates, loaded, in [`Config::pieces`] order. +struct Counts(Vec<Arc<StructureTemplate>>); +impl Counts { + fn new(limits: &Config, resources: &StructureResources) -> Self { + Self( + limits + .pieces + .iter() + .map(|(id, _)| { + resources + .template(&id.to_string()) + .unwrap_or_else(|| Arc::new(StructureTemplate::empty())) + }) + .collect(), + ) + } + /// The index of a single element's template among the counted ones. + fn of(&self, element: &PoolElement) -> Option<usize> { + let PoolElement::Single { template, .. } = element else { + return None; + }; + self.0.iter().position(|t| Arc::ptr_eq(t, template)) + } +} + +/// PieceLimitedJigsawManager.assembleJigsawStructure and the structure's +/// postLayoutAdjustments: the start's center and the pieces, or None when +/// nothing starts. `start` is the chunk's corner at the sampled start height. +#[allow(clippy::too_many_arguments)] +pub fn assemble( + config: &JigsawConfig<'_>, + limits: &Config, + context: &mut impl StartContext, + pools: &Pools, + resources: &StructureResources, + bindings: &FeatureBlockBindings<'_>, + chunk: ChunkPos, + start: [i32; 3], +) -> Option<([i32; 3], Vec<PoolPiece>)> { + let mut random = WorldgenRandom::new(LegacyRandom::new(0)); + random.set_large_feature_seed(context.seed(), chunk.x, chunk.z); + let rotation = Rotation::random(&mut random); + let pool = pools.get(config.start_pool, resources, bindings)?; + // An empty start pool crashes the mod's generation; nothing starts. + if pool.templates.is_empty() { + return None; + } + let element = pool.random_template(&mut random); + if matches!(element.as_ref(), PoolElement::Empty) { + return None; + } + let mut first = PoolPiece { + bounding_box: element.bounding_box(start, rotation), + ground_level_delta: element.ground_level_delta(), + element, + position: start, + rotation, + junctions: Vec::new(), + waterlogging: config.waterlogging, + }; + let b = first.bounding_box; + let (cx, cz) = ((b.max[0] + b.min[0]) / 2, (b.max[2] + b.min[2]) / 2); + let top = limits.max_y.unwrap_or(i32::MAX); + let bottom = limits.min_y.unwrap_or(i32::MIN); + let cy = match config.project_to { + Some(kind) => { + let y = start[1] + context.base_height(cx, cz, kind); + if y > top || y < bottom { + return None; + } + y + } + None => start[1], + }; + first.moved(cy - (b.min[1] + first.ground_level_delta)); + let start_box = first.bounding_box; + let (start_position, start_rotation) = (first.position, first.rotation); + let counts = Counts::new(limits, resources); + let run_once = limits.required().next().is_none(); + let mut pieces = vec![first]; + let mut attempts = 0; + // `for (attempts = 0; runOnce || doesNotHaveAllRequiredPieces(...); attempts++)`: + // the first test sees the start piece alone. + while run_once || lacks_required(limits, &counts, &pieces) { + if attempts == 40 { + break; + } + if attempts > 0 { + let element = pool.random_template(&mut random); + pieces = vec![PoolPiece { + bounding_box: element.bounding_box(start_position, start_rotation), + ground_level_delta: element.ground_level_delta(), + element, + position: start_position, + rotation: start_rotation, + junctions: Vec::new(), + waterlogging: config.waterlogging, + }]; + } else { + pieces.truncate(1); + } + if config.max_depth > 0 { + let r = config.max_distance[0]; + let free = Rc::new(RefCell::new(Free { + container: BoundingBox::new([cx - r, cy - 120, cz - r], [cx + r, cy + 180, cz + r]), + removed: vec![start_box], + })); + let buried = limits.burying.is_some(); + let mut assembler = Assembler { + config, + limits, + counted: &counts, + pools, + resources, + bindings, + pieces: std::mem::take(&mut pieces), + states: vec![(free, 0)], + counts: vec![0; limits.pieces.len()], + max_y: if buried { i32::MAX } else { top }, + min_y: if buried { i32::MIN } else { bottom }, + }; + let mut queue = VecDeque::from([0]); + while let Some(piece) = queue.pop_front() { + assembler.children(piece, &mut queue, context, &mut random); + } + pieces = assembler.pieces; + } + if run_once { + break; + } + attempts += 1; + } + adjust(config, limits, context, start, &mut pieces); + if pieces.is_empty() { + return None; + } + let mut whole = pieces[0].bounding_box; + for p in &pieces[1..] { + whole.encapsulate(&p.bounding_box); + } + // The builder is cleared when the layout reaches past the build height. + if whole.max[1] > context.max_y() + 1 { + return None; + } + Some(([cx, cy, cz], pieces)) +} + +/// doesNotHaveAllRequiredPieces. +fn lacks_required(limits: &Config, counts: &Counts, pieces: &[PoolPiece]) -> bool { + let mut left: Vec<i32> = limits + .pieces + .iter() + .map(|(_, c)| c.required.unwrap_or(0)) + .collect(); + for p in pieces { + if let Some(i) = counts.of(&p.element) { + left[i] -= 1; + } + } + left.iter().any(|&n| n > 0) +} + +/// Moves a piece; Repurposed Structures' movePieceProperly also writes its +/// junctions, all three setters into the source X, so only the last sticks. +fn shift(limits: &Config, piece: &mut PoolPiece, d: [i32; 3]) { + piece.position = std::array::from_fn(|i| piece.position[i] + d[i]); + piece.bounding_box = piece.bounding_box.moved(d); + if limits.library == Library::Repurposed { + for j in &mut piece.junctions { + j.source_x = j.source_z + d[2]; + } + } +} +fn shift_all(limits: &Config, pieces: &mut [PoolPiece], d: [i32; 3]) { + for p in pieces { + shift(limits, p, d); + } +} + +/// The structure's postLayoutAdjustments. +fn adjust( + config: &JigsawConfig<'_>, + limits: &Config, + context: &mut impl StartContext, + start: [i32; 3], + pieces: &mut Vec<PoolPiece>, +) { + if pieces.is_empty() { + return; + } + // GeneralUtils.centerAllPieces on the chunk's corner. + let center = pieces[0].bounding_box.center(); + let d = [start[0] - center[0], 0, start[2] - center[2]]; + for p in pieces.iter_mut() { + // Centring uses StructurePiece.move in both mods. + p.position = std::array::from_fn(|i| p.position[i] + d[i]); + p.bounding_box = p.bounding_box.moved(d); + } + let offset_y = start[1]; + let sea = context.sea_level(); + if let Some(search) = limits.land_search { + nether(limits, context, search, offset_y, pieces); + return; + } + let Some(burying) = limits.burying else { + return; + }; + let kind = config.project_to.unwrap_or(HeightmapType::WorldSurfaceWg); + let ocean_floor = matches!( + kind, + HeightmapType::OceanFloorWg | HeightmapType::OceanFloor + ); + let box0 = pieces[0].bounding_box; + let mut land = match burying { + Burying::LowestCorner => [ + (box0.min[0], box0.min[2]), + (box0.min[0], box0.max[2]), + (box0.max[0], box0.min[2]), + (box0.max[0], box0.max[2]), + ] + .into_iter() + .map(|(x, z)| context.base_height(x, z, kind) - 1) + .min() + .unwrap_or(0), + Burying::LowestSide => { + let c = box0.center(); + let mut highest = i32::MAX; + for (x, z) in [ + (box0.min[0], c[2]), + (c[0], box0.max[2]), + (c[0], box0.min[2]), + (box0.max[0], c[2]), + ] { + // getFirstOccupiedHeight (Repurposed's cached free height - 1). + let land = context.base_height(x, z, kind) - 1; + match limits.min_y { + Some(min) if land >= min => highest = land, + Some(_) => {} + None => highest = highest.min(land), + } + } + if let Some(min) = limits.min_y.filter(|_| highest == i32::MAX) { + highest = min; + } + highest + } + Burying::AverageLand => { + average_land(limits, context, kind, ocean_floor, offset_y, pieces); + return; + } + }; + if limits.no_liquid || !ocean_floor { + land = land.max(sea); + } else { + land = land.min(sea - box0.span()[1]); + } + // offsetToNewHeight. + if limits.max_y.is_some() + && let Some(min) = limits.min_y + && box0.max[1] + offset_y < min + { + land = land.max(limits.max_y.unwrap_or(land)); + } + if let Some(min) = limits.min_y + && box0.min[1] + offset_y < min + { + land = land.min(min); + } + let dy = land - box0.min[1] + offset_y; + shift_all(limits, pieces, [0, dy, 0]); +} + +/// AVERAGE_LAND: the mean land height over a grid on the first piece's +/// footprint; no structure when none of the heights is allowed. +fn average_land( + limits: &Config, + context: &mut impl StartContext, + kind: HeightmapType, + ocean_floor: bool, + offset_y: i32, + pieces: &mut Vec<PoolPiece>, +) { + let b = pieces[0].bounding_box; + let c = b.center(); + let (lx, lz) = (b.max[0] - b.min[0], b.max[2] - b.min[2]); + let radius = (f64::from(lx * lx + lz * lz).sqrt() as i32) / 2; + // The mod's loop never ends with a step of 0; one block apart instead. + let step = (radius / 2).max(1); + let (min, max) = ( + limits.min_y.unwrap_or(i32::MIN), + limits.max_y.unwrap_or(i32::MAX), + ); + let (mut sum, mut n) = (0i64, 0i64); + let mut x = -radius; + while x <= radius { + let mut z = -radius; + while z <= radius { + let h = context.base_height(c[0] + x, c[2] + z, kind) - 1; + if h > min && h < max { + sum += i64::from(h); + n += 1; + } + z += step; + } + x += step; + } + let mut average = (n > 0).then(|| sum as f64 / n as f64); + if average.is_none() { + average = limits.max_y.or(limits.min_y).map(f64::from); + } + let Some(mut average) = average else { + pieces.clear(); + return; + }; + if limits.no_liquid && !ocean_floor { + average = average.max(f64::from(context.sea_level())); + if let Some(max) = limits.max_y { + // Math.max, as the mod has it. + average = average.max(f64::from(max)); + } + } + let dy = average as i32 - b.min[1] + offset_y; + shift_all(limits, pieces, [0, dy, 0]); +} + +/// The Nether variants: onto the highest or lowest land at the layout's +/// center (or a fixed height), a ledge above it, within y_allowance. +fn nether( + limits: &Config, + context: &mut impl StartContext, + search: LandSearch, + offset_y: i32, + pieces: &mut [PoolPiece], +) { + let mut whole = pieces[0].bounding_box; + for p in &pieces[1..] { + whole.encapsulate(&p.bounding_box); + } + let sea = context.sea_level(); + let generation = context.generation(); + let terrain_limit = generation.min_y + generation.height; + let base = pieces[0].bounding_box.min[1]; + let found = |context: &mut dyn ColumnQuery, highest: bool| { + let c = whole.center(); + context.land(c[0], c[2], highest, !limits.no_liquid, sea, terrain_limit) + }; + let mut target = match (limits.library, search) { + (Library::Moogs, LandSearch::Fixed) => offset_y + limits.ledge, + (library, search) => { + let y = found(context, search == LandSearch::Highest); + let at = if y < terrain_limit && y > sea + 1 { + y + } else { + sea + }; + if library == Library::Repurposed { + shift_all(limits, pieces, [0, at + limits.ledge - base, 0]); + return; + } + at + limits.ledge + offset_y + } + }; + let height = whole.max[1] - whole.min[1]; + let below = whole.min[1] - base; + if let Some(top) = limits.max_y { + target = target.min(top - height - below); + } + if let Some(bottom) = limits.min_y { + target = target.max(bottom - below); + } + shift_all(limits, pieces, [0, target - base, 0]); +} + +/// GeneralUtils.getHighestLand and getLowestLand on the noise column. +trait ColumnQuery { + fn land( + &mut self, + x: i32, + z: i32, + highest: bool, + on_liquid: bool, + sea: i32, + terrain_limit: i32, + ) -> i32; +} +impl<C: StartContext> ColumnQuery for C { + fn land( + &mut self, + x: i32, + z: i32, + highest: bool, + on_liquid: bool, + sea: i32, + terrain_limit: i32, + ) -> i32 { + let min = self.generation().min_y; + let mut columns = self.base_columns( + x, + z, + &[HeightmapType::WorldSurfaceWg, HeightmapType::OceanFloorWg], + ); + let solid = columns.pop().unwrap_or_default(); + let filled = columns.pop().unwrap_or_default(); + land_in(&filled, &solid, min, highest, on_liquid, sea, terrain_limit) + } +} + +/// The land search over one noise column: `filled` (not air) and `solid` +/// (canOcclude, for the noise's own blocks) from `min` up; past the +/// column's ends a NoiseColumn reads air. +fn land_in( + filled: &[bool], + solid: &[bool], + min: i32, + highest: bool, + on_liquid: bool, + sea: i32, + terrain_limit: i32, +) -> i32 { + let at = |c: &[bool], y: i32| { + usize::try_from(y - min) + .ok() + .and_then(|i| c.get(i).copied()) + .unwrap_or(false) + }; + let air = |y: i32| !at(filled, y); + let stands = |y: i32| if on_liquid { !air(y) } else { at(solid, y) }; + if highest { + let mut y = terrain_limit - 40; + while y > sea { + if at(solid, y) && air(y + 3) && stands(y) { + return y; + } + y -= 1; + } + y + } else { + let mut y = sea + 1; + while y <= terrain_limit - 40 { + if stands(y) && air(y + 1) && air(y + 5) { + return y + 1; + } + y += 1; + } + sea + } +} + +/// PieceLimitedJigsawManager.Assembler. +struct Assembler<'a> { + config: &'a JigsawConfig<'a>, + limits: &'a Config, + counted: &'a Counts, + pools: &'a Pools, + resources: &'a StructureResources, + bindings: &'a FeatureBlockBindings<'a>, + pieces: Vec<PoolPiece>, + /// Per piece: the free space it was placed in, and its depth. + states: Vec<(Rc<RefCell<Free>>, i32)>, + /// Pieces placed per counted template. + counts: Vec<i32>, + max_y: i32, + min_y: i32, +} + +/// Where a child goes: the parent's jigsaw and what it needs. +struct Slot<'s> { + source: usize, + jigsaw: &'s super::jigsaw::Jigsaw, + target_pos: [i32; 3], + free: Rc<RefCell<Free>>, + depth: i32, +} + +impl Assembler<'_> { + fn pool(&self, name: &str) -> Option<Arc<super::jigsaw::Pool>> { + let name = self.config.aliases.get(name).map_or(name, String::as_str); + self.pools.get(name, self.resources, self.bindings) + } + /// generatePiece: one child per jigsaw where one fits, from the target + /// pool unless the piece is at the last depth, else from its fallback. + fn children( + &mut self, + source: usize, + queue: &mut VecDeque<usize>, + context: &mut impl StartContext, + random: &mut impl RandomSource, + ) { + let (element, position, rotation, source_box) = { + let s = &self.pieces[source]; + (s.element.clone(), s.position, s.rotation, s.bounding_box) + }; + let (context_free, depth) = self.states[source].clone(); + let mut source_free: Option<Rc<RefCell<Free>>> = None; + for jigsaw in element.shuffled_jigsaws(self.resources, position, rotation, random) { + let Some(target) = self.pool(&jigsaw.pool) else { + continue; + }; + if target.templates.is_empty() && jigsaw.pool != "minecraft:empty" { + continue; + } + let s = step(jigsaw.front); + let target_pos: [i32; 3] = std::array::from_fn(|i| jigsaw.pos[i] + s[i]); + let free = if source_box.is_inside(target_pos) { + source_free + .get_or_insert_with(|| { + Rc::new(RefCell::new(Free { + container: source_box, + removed: Vec::new(), + })) + }) + .clone() + } else { + context_free.clone() + }; + let slot = Slot { + source, + jigsaw: &jigsaw, + target_pos, + free, + depth, + }; + if depth != self.config.max_depth + && self.process(&slot, target.raw.clone(), false, queue, context, random) + { + continue; + } + let Some(fallback) = self.pool(&target.fallback) else { + continue; + }; + let ignore = self.limits.ignore_bounds.contains(&target.fallback); + self.process(&slot, fallback.raw.clone(), ignore, queue, context, random); + } + } + /// processList: whether a piece was placed. + fn process( + &mut self, + slot: &Slot<'_>, + mut candidates: Vec<(Arc<PoolElement>, i32)>, + ignore_bounds: bool, + queue: &mut VecDeque<usize>, + context: &mut impl StartContext, + random: &mut impl RandomSource, + ) -> bool { + let jigsaw = slot.jigsaw; + let (source_rigid, source_y, source_ground) = { + let s = &self.pieces[slot.source]; + ( + s.element.projection() == Projection::Rigid, + s.bounding_box.min[1], + s.ground_level_delta, + ) + }; + let local_y = jigsaw.pos[1] - source_y; + let mut surface = None; + let (x, z) = (jigsaw.pos[0], jigsaw.pos[2]); + let mut base = + |context: &mut dyn SurfaceQuery| *surface.get_or_insert_with(|| context.surface(x, z)); + let mut total: i32 = candidates.iter().map(|c| c.1).sum(); + while !candidates.is_empty() { + let mut chosen = None; + // The first required piece still short is forced in once deep enough. + let needed = self + .limits + .pieces + .iter() + .enumerate() + .find(|(i, (_, c))| c.required.is_some_and(|r| self.counts[*i] < r)); + if let Some((need_index, (_, need))) = needed { + let need_template = &self.counted.0[need_index]; + let found = candidates.iter().position(|(e, _)| { + matches!(e.as_ref(), PoolElement::Single { template, .. } + if Arc::ptr_eq(template, need_template)) + }); + if let Some(i) = found { + if slot.depth >= (self.config.max_depth - 1).min(need.min_depth) { + chosen = Some(i); + } else { + total -= candidates[i].1; + candidates.remove(i); + } + } + } + let index = match chosen { + Some(i) => i, + None => { + if total <= 0 || candidates.is_empty() { + return false; + } + let mut weight = random.next_int_bound(total).unwrap_or(0) + 1; + let mut found = candidates.len() - 1; + for (i, (_, w)) in candidates.iter().enumerate() { + weight -= w; + if weight <= 0 { + found = i; + break; + } + } + found + } + }; + let (target, weight) = candidates[index].clone(); + if matches!(target.as_ref(), PoolElement::Empty) { + return false; + } + let counted = self.counted.of(&target); + let full = counted.is_some_and(|i| { + self.limits.pieces[i] + .1 + .max + .is_some_and(|m| self.counts[i] >= m) + }); + if full { + total -= weight; + candidates.remove(index); + continue; + } + let mut rotations = Rotation::ALL; + shuffle(&mut rotations, random); + for rotation in rotations { + let target_jigsaws = + target.shuffled_jigsaws(self.resources, [0; 3], rotation, random); + let hack_box = target.bounding_box([0; 3], rotation); + let expand_to = if self.config.use_expansion_hack && hack_box.span()[1] <= 16 { + target_jigsaws + .iter() + .map(|tj| { + let st = step(tj.front); + if !hack_box.is_inside(std::array::from_fn(|i| tj.pos[i] + st[i])) { + return 0; + } + let child = self.pool(&tj.pool); + let child_size = child.as_ref().map_or(0, |p| p.max_size()); + let fallback_size = child + .and_then(|p| self.pool(&p.fallback)) + .map_or(0, |p| p.max_size()); + child_size.max(fallback_size) + }) + .max() + .unwrap_or(0) + } else { + 0 + }; + for target_jigsaw in &target_jigsaws { + if !can_attach(jigsaw, target_jigsaw) { + continue; + } + let target_local = target_jigsaw.pos; + let raw_position: [i32; 3] = + std::array::from_fn(|i| slot.target_pos[i] - target_local[i]); + let raw_box = target.bounding_box(raw_position, rotation); + let target_rigid = target.projection() == Projection::Rigid; + let delta_y = local_y - target_local[1] + step(jigsaw.front)[1]; + let target_y = if source_rigid && target_rigid { + source_y + delta_y + } else { + base(context) - target_local[1] + }; + let offset = target_y - raw_box.min[1]; + let mut target_box = raw_box.moved([0, offset, 0]); + let target_position = + [raw_position[0], raw_position[1] + offset, raw_position[2]]; + if expand_to > 0 { + let size = (expand_to + 1).max(target_box.max[1] - target_box.min[1]); + target_box.max[1] = target_box.min[1] + size; + } + if target_box.max[1] > self.max_y || target_box.min[1] < self.min_y { + continue; + } + if !ignore_bounds && !slot.free.borrow().fits(&target_box) { + continue; + } + let target_ground = if target_rigid { + source_ground - delta_y + } else { + target.ground_level_delta() + }; + let junction_y = if source_rigid { + source_y + local_y + } else if target_rigid { + target_y + target_local[1] + } else { + base(context) + delta_y / 2 + }; + self.pieces[slot.source].junctions.push(Junction { + source_x: slot.target_pos[0], + source_ground_y: junction_y - local_y + source_ground, + source_z: slot.target_pos[2], + }); + slot.free.borrow_mut().removed.push(target_box); + self.pieces.push(PoolPiece { + element: target.clone(), + position: target_position, + ground_level_delta: target_ground, + rotation, + bounding_box: target_box, + junctions: vec![Junction { + source_x: jigsaw.pos[0], + source_ground_y: junction_y - target_local[1] + target_ground, + source_z: jigsaw.pos[2], + }], + waterlogging: self.config.waterlogging, + }); + self.states.push((slot.free.clone(), slot.depth + 1)); + if slot.depth < self.config.max_depth { + queue.push_back(self.pieces.len() - 1); + } + if let Some(i) = counted { + self.counts[i] += 1; + } + return true; + } + } + total -= weight; + candidates.remove(index); + } + false + } +} + +/// The surface height query, object-safe for the per-call cache. +trait SurfaceQuery { + fn surface(&mut self, x: i32, z: i32) -> i32; +} +impl<C: StartContext> SurfaceQuery for C { + fn surface(&mut self, x: i32, z: i32) -> i32 { + self.base_height(x, z, HeightmapType::WorldSurfaceWg) + } +} + +#[cfg(test)] +mod tests { + use super::*; + use serde_json::json; + + #[test] + fn required_pieces_follow_javas_hash_map() { + let limits = Config::decode(&json!({"library": "repurposed", "pieces": [ + {"name": "rs:city/a", "required": 1}, + {"name": "rs:city/x", "max": 2}, + {"name": "rs:city/b", "required": 1, "min_depth": 3}, + {"name": "rs:city/c", "required": 2}, + {"name": "rs:city/a", "required": 4}]})); + let names: Vec<String> = limits.pieces.iter().map(|(id, _)| id.to_string()).collect(); + // Buckets 3, 2, 1 of the copied map's 4: c, b, a; then the capped one. + assert_eq!(names, ["rs:city/c", "rs:city/b", "rs:city/a", "rs:city/x"]); + assert_eq!( + limits.pieces[2].1.required, + Some(4), + "a later entry replaces" + ); + assert_eq!(limits.pieces[1].1.min_depth, 3); + assert_eq!(limits.library, Library::Repurposed); + } + + #[test] + fn nether_land_is_found_in_the_column() { + // A column from y 0: netherrack to 40, lava 41..=45, air, a ledge 70..=72. + let (mut filled, mut solid) = (vec![false; 128], vec![false; 128]); + for y in 0..=45 { + filled[y] = true; + solid[y] = y <= 40; + } + for y in 70..=72 { + filled[y] = true; + solid[y] = true; + } + // Highest: from 88 down, a solid block with air 3 above. + assert_eq!(land_in(&filled, &solid, 0, true, true, 32, 128), 72); + // Lowest: from 33 up, a block to stand on with air 1 and 5 above; one up. + assert_eq!(land_in(&filled, &solid, 0, false, true, 32, 128), 46); + assert_eq!(land_in(&filled, &solid, 0, false, false, 32, 128), 73); + // Nothing found: the highest search stops at the sea level. + let empty = vec![false; 128]; + assert_eq!(land_in(&empty, &empty, 0, true, true, 32, 128), 32); + assert_eq!(land_in(&empty, &empty, 0, false, true, 32, 128), 32); + } + + #[test] + fn repurposed_moves_junctions_as_its_code_does() { + let template = Arc::new(StructureTemplate::empty()); + let element = Arc::new(PoolElement::Single { + template, + processors: Default::default(), + legacy: false, + projection: Projection::Rigid, + waterlogging: None, + yung: None, + }); + let piece = || PoolPiece { + bounding_box: BoundingBox::new([0; 3], [4; 3]), + ground_level_delta: 1, + element: element.clone(), + position: [0; 3], + rotation: Rotation::None, + junctions: vec![Junction { + source_x: 1, + source_ground_y: 2, + source_z: 3, + }], + waterlogging: true, + }; + let moogs = Config::decode(&json!({})); + let rs = Config::decode(&json!({"library": "repurposed"})); + let (mut a, mut b) = (piece(), piece()); + shift(&moogs, &mut a, [10, 20, 30]); + shift(&rs, &mut b, [10, 20, 30]); + assert_eq!(a.bounding_box, BoundingBox::new([10, 20, 30], [14, 24, 34])); + assert_eq!(a.position, [10, 20, 30]); + assert_eq!(a.junctions[0].source_x, 1); + // movePieceProperly sets the source X three times; Z + dz is left. + assert_eq!(b.junctions[0].source_x, 33); + assert_eq!(b.junctions[0].source_ground_y, 2); + } +} diff --git a/crates/horizon-world/src/worldgen/structure/start.rs b/crates/horizon-world/src/worldgen/structure/start.rs index ee6f63655..9ca5ee01f 100644 --- a/crates/horizon-world/src/worldgen/structure/start.rs +++ b/crates/horizon-world/src/worldgen/structure/start.rs @@ -59,6 +59,9 @@ pub struct JigsawDef { checks: super::start_checks::StartChecks, /// Laid out by YUNG's API's assembler (`"horizon:yungsapi"`). yung: Option<super::yung::Config>, + /// Laid out by Repurposed Structures' and Moog's piece-limited + /// assembler (`"horizon:piece_limited"`). + piece_limited: Option<super::piece_limited::Config>, } #[derive(Debug)] pub enum StructureKind { @@ -205,6 +208,9 @@ impl StructureRegistry { waterlogging: v["liquid_settings"].as_str() != Some("ignore_waterlogging"), checks: super::start_checks::StartChecks::decode(v.get("horizon:start_checks")), yung: v.get("horizon:yungsapi").map(super::yung::Config::decode), + piece_limited: v + .get("horizon:piece_limited") + .map(super::piece_limited::Config::decode), }), "minecraft:buried_treasure" => StructureKind::BuriedTreasure, "minecraft:igloo" => StructureKind::Igloo, @@ -672,8 +678,18 @@ fn try_generate( padding: jigsaw.padding, waterlogging: jigsaw.waterlogging, }; - let (position, mut pieces) = match &jigsaw.yung { - Some(yung) => super::yung::assemble( + let (position, mut pieces) = match (&jigsaw.yung, &jigsaw.piece_limited) { + (_, Some(limits)) => super::piece_limited::assemble( + &config, + limits, + context, + ®istry.pools, + resources, + bindings, + chunk, + start, + )?, + (Some(yung), None) => super::yung::assemble( &config, yung, context, @@ -683,7 +699,7 @@ fn try_generate( &mut random, start, )?, - None => assemble( + (None, None) => assemble( &config, context, ®istry.pools, @@ -693,7 +709,9 @@ fn try_generate( start, )?, }; - if jigsaw.max_depth <= 0 { + // Vanilla's JigsawPlacement keeps no piece at size 0; the + // piece-limited assembler keeps the start piece. + if jigsaw.max_depth <= 0 && jigsaw.piece_limited.is_none() { pieces.clear(); } ( From aab43c46ae63bed4554dcc8a83e084ff62106b6e Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 10:24:24 +0200 Subject: [PATCH 091/163] Carry: YUNG's placements, and the vanilla structures its mods turn off YUNG's enhanced random spread becomes vanilla's random spread with its enhanced exclusion zone as horizon:exclusion_zone; the desert and jungle temples' placements add horizon:avoid_biomes (no ocean or river within 48 blocks of the chunk's middle at y 120); Better Strongholds' adds horizon:ring_sections. A YUNG's structure the game can start gets horizon:disables with the vanilla type its mod's mixin turns off; Better Mineshafts, a Java structure type, leaves vanilla's mineshafts in place. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/carry.rs | 14 ++- crates/horizon-port-pack/src/worldgen.rs | 153 ++++++++++++++++++++++- 2 files changed, 163 insertions(+), 4 deletions(-) diff --git a/crates/horizon-port-pack/src/carry.rs b/crates/horizon-port-pack/src/carry.rs index c73570684..6a31834a3 100644 --- a/crates/horizon-port-pack/src/carry.rs +++ b/crates/horizon-port-pack/src/carry.rs @@ -422,8 +422,18 @@ pub fn carry( if kind == "structure" { crate::worldgen::convention_tags(&v["biomes"], &mut biome_conventions); } - if crate::worldgen::upgrade(kind, &mut v, &mut report.worldgen_types, &set_tags) - { + let mut changed = crate::worldgen::upgrade( + kind, + &mut v, + &mut report.worldgen_types, + &set_tags, + ); + if kind == "structure" { + let path = rel.trim_start_matches("worldgen/structure/"); + let structure = format!("{id}:{}", path.trim_end_matches(".json")); + changed |= crate::worldgen::disables(&structure, &mut v); + } + if changed { bytes = serde_json::to_vec_pretty(&v).unwrap_or(bytes); } } diff --git a/crates/horizon-port-pack/src/worldgen.rs b/crates/horizon-port-pack/src/worldgen.rs index ecc5d3590..1ad836ad1 100644 --- a/crates/horizon-port-pack/src/worldgen.rs +++ b/crates/horizon-port-pack/src/worldgen.rs @@ -31,6 +31,35 @@ const SPREADS: [&str; 2] = [ "moogs_structures:advanced_random_spread", "repurposed_structures:advanced_random_spread", ]; +/// YUNG's placements: vanilla's random spread with an enhanced exclusion +/// zone (several sets), plus, for the temples, no start near an ocean or a +/// river, and for strongholds, starts only in odd rings around the origin. +const YUNG_SPREADS: [&str; 4] = [ + "yungsapi:enhanced_random_spread", + "betterdeserttemples:desert_temple", + "betterjungletemples:jungle_temple", + "betterstrongholds:stronghold", +]; +/// YUNG's structures and the vanilla structure type each one's mod turns +/// off (its DisableVanilla*Mixin, on by default in each mod's config). +const YUNG_REPLACES: [(&str, &str); 7] = [ + ( + "betterdeserttemples:desert_temple", + "minecraft:desert_pyramid", + ), + ( + "betterjungletemples:jungle_temple", + "minecraft:jungle_temple", + ), + ("betterwitchhuts:witch_hut", "minecraft:swamp_hut"), + ( + "betteroceanmonuments:ocean_monument", + "minecraft:ocean_monument", + ), + ("betterstrongholds:stronghold", "minecraft:stronghold"), + ("betterfortresses:fortress", "minecraft:fortress"), + ("bettermineshafts:mineshaft_", "minecraft:mineshaft"), +]; /// Moog's Structure Lib spreads its structures 1.65 times as far apart as /// its files say (AdvancedRandomSpread's constructor). const MOOGS_SPACING: f64 = 1.65; @@ -210,6 +239,11 @@ fn upgrade_types( p["type"] = "minecraft:random_spread".into(); true } + Some(t) if YUNG_SPREADS.contains(&t) => { + let t = t.to_owned(); + yung_placement(&t, &mut v["placement"], set_tags, lost); + true + } Some(t) if !t.starts_with("minecraft:") => { unsupported(t); false @@ -425,7 +459,10 @@ fn placement_rules( if let Some(d) = o.remove("min_distance_from_world_origin") { o.insert("horizon:min_distance_from_world_origin".into(), d); } - if let Some(zone) = o.remove("super_exclusion_zone") { + let zone = ["super_exclusion_zone", "enhanced_exclusion_zone"] + .into_iter() + .find_map(|k| Some((k, o.remove(k)?))); + if let Some((key, zone)) = zone { let sets: Vec<String> = match &zone["other_set"] { Value::String(s) => match s.strip_prefix('#') { Some(tag) => set_tags.get(tag).cloned().unwrap_or_default(), @@ -438,7 +475,7 @@ fn placement_rules( _ => Vec::new(), }; if sets.is_empty() { - *lost.entry("super_exclusion_zone".into()).or_default() += 1; + *lost.entry(key.into()).or_default() += 1; } else { o.insert( "horizon:exclusion_zone".into(), @@ -448,6 +485,65 @@ fn placement_rules( } } +/// One of YUNG's placements as vanilla's random spread with `horizon:` keys: +/// the enhanced exclusion zone as `horizon:exclusion_zone`; the temples' +/// ocean and river search (findBiomeHorizontal around the chunk's middle +/// block at y 120, 48 blocks, every 2 quarts) as `horizon:avoid_biomes`; the +/// strongholds' rings as `horizon:ring_sections`. +fn yung_placement( + t: &str, + p: &mut Value, + set_tags: &BTreeMap<String, Vec<String>>, + lost: &mut BTreeMap<String, usize>, +) { + placement_rules(p, set_tags, lost); + p["type"] = "minecraft:random_spread".into(); + let Some(o) = p.as_object_mut() else { + return; + }; + match t { + "betterdeserttemples:desert_temple" | "betterjungletemples:jungle_temple" => { + o.insert( + "horizon:avoid_biomes".into(), + serde_json::json!({"biomes": ["#minecraft:is_river", "#minecraft:is_ocean"], + "radius": 48, "step": 2, "y": 120}), + ); + } + "betterstrongholds:stronghold" => { + let mut rings = serde_json::Map::new(); + for (from, to) in [ + ("chunk_distance_to_first_ring", "distance_to_first_ring"), + ("ring_chunk_thickness", "thickness"), + ("max_ring_section", "max_section"), + ] { + if let Some(n) = o.remove(from) { + rings.insert(to.into(), n); + } + } + o.insert("horizon:ring_sections".into(), rings.into()); + } + _ => {} + } +} + +/// Marks a YUNG's structure that the game can start (its type is vanilla's +/// after the upgrade) with the vanilla type its mod turns off, under +/// `horizon:disables`. One the game cannot start leaves the vanilla +/// structure in place, so the world keeps one of the two. +pub fn disables(id: &str, v: &mut Value) -> bool { + let Some((_, vanilla)) = YUNG_REPLACES.iter().find(|(s, _)| id.starts_with(s)) else { + return false; + }; + if !v["type"] + .as_str() + .is_some_and(|t| t.starts_with("minecraft:")) + { + return false; + } + v["horizon:disables"] = serde_json::json!([vanilla]); + true +} + /// The mod's structure set tags (`data/<ns>/tags/worldgen/structure_set/`), /// by tag id, with the tags they include expanded. Optional entries /// (`{"id": ..., "required": false}`) count as their id. @@ -808,6 +904,59 @@ mod tests { ); } + #[test] + fn yungs_placements_keep_their_rules() { + let tags = BTreeMap::from([( + "bf:avoid".to_owned(), + vec!["minecraft:nether_complexes".to_owned()], + )]); + let mut report = Upgrade::default(); + let mut fortress = json!({"placement": {"type": "yungsapi:enhanced_random_spread", + "salt": 1, "spacing": 30, "separation": 20, + "enhanced_exclusion_zone": {"other_set": "#bf:avoid", "chunk_count": 10}}}); + assert!(upgrade("structure_set", &mut fortress, &mut report, &tags)); + assert_eq!( + fortress["placement"], + json!({"type": "minecraft:random_spread", "salt": 1, "spacing": 30, "separation": 20, + "horizon:exclusion_zone": {"other_sets": ["minecraft:nether_complexes"], "chunk_count": 10}}) + ); + let mut temple = json!({"placement": {"type": "betterdeserttemples:desert_temple", + "salt": 2, "spacing": 30, "separation": 20, + "exclusion_zone": {"other_set": "minecraft:villages", "chunk_count": 6}}}); + assert!(upgrade("structure_set", &mut temple, &mut report, &tags)); + assert_eq!(temple["placement"]["type"], "minecraft:random_spread"); + assert_eq!(temple["placement"]["exclusion_zone"]["chunk_count"], 6); + assert_eq!( + temple["placement"]["horizon:avoid_biomes"], + json!({"biomes": ["#minecraft:is_river", "#minecraft:is_ocean"], + "radius": 48, "step": 2, "y": 120}) + ); + let mut stronghold = json!({"placement": {"type": "betterstrongholds:stronghold", + "salt": 3, "spacing": 85, "separation": 50, + "chunk_distance_to_first_ring": 80, "ring_chunk_thickness": 96}}); + assert!(upgrade( + "structure_set", + &mut stronghold, + &mut report, + &tags + )); + assert_eq!( + stronghold["placement"], + json!({"type": "minecraft:random_spread", "salt": 3, "spacing": 85, "separation": 50, + "horizon:ring_sections": {"distance_to_first_ring": 80, "thickness": 96}}) + ); + assert_eq!(report.mapped, 3); + assert!(report.unsupported.is_empty()); + // The vanilla counterpart is turned off only for a structure the game starts. + let mut ported = json!({"type": "minecraft:jigsaw"}); + assert!(disables("betterstrongholds:stronghold", &mut ported)); + assert_eq!(ported["horizon:disables"], json!(["minecraft:stronghold"])); + let mut java = json!({"type": "bettermineshafts:mineshaft"}); + assert!(!disables("bettermineshafts:mineshaft_oak", &mut java)); + let mut circle = json!({"type": "minecraft:jigsaw"}); + assert!(!disables("betterwitchhuts:witch_circle", &mut circle)); + } + #[test] fn writes_block_states_in_26_3_shape() { let mut report = Upgrade::default(); From 512962e3ca2d4c9d37db3232cdf6a3d28927981c Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 11:09:58 +0200 Subject: [PATCH 092/163] Carry: Repurposed Structures' and Moog's jigsaws keep their layout rules Their jigsaw structures, the Nether variants too, get a horizon:piece_limited key for the game's piece-limited assembler: y_allowance, burying_type, cannot_spawn_in_liquid, the pools whose fallbacks ignore the bounds, the Nether variants' land search and ledge, and each structure's piece counts from the mod's rs_pieces_spawn_counts or msl_pieces_spawn_counts files. use_bounding_box_hack becomes vanilla's use_expansion_hack. Lithostitched's jigsaw stays vanilla's. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/carry.rs | 3 + crates/horizon-port-pack/src/worldgen.rs | 238 +++++++++++++++++++++-- 2 files changed, 225 insertions(+), 16 deletions(-) diff --git a/crates/horizon-port-pack/src/carry.rs b/crates/horizon-port-pack/src/carry.rs index 6a31834a3..9ef4ee2fb 100644 --- a/crates/horizon-port-pack/src/carry.rs +++ b/crates/horizon-port-pack/src/carry.rs @@ -363,6 +363,7 @@ pub fn carry( let mut block_loot = BTreeSet::new(); let mut biome_conventions = BTreeSet::new(); let set_tags = crate::worldgen::structure_set_tags(&mut zip); + let piece_counts = crate::worldgen::piece_counts(&mut zip); for i in 0..zip.len() { let mut entry = zip.by_index(i).map_err(|e| e.to_string())?; let name = entry.name().to_owned(); @@ -432,6 +433,8 @@ pub fn carry( let path = rel.trim_start_matches("worldgen/structure/"); let structure = format!("{id}:{}", path.trim_end_matches(".json")); changed |= crate::worldgen::disables(&structure, &mut v); + changed |= + crate::worldgen::add_piece_counts(&structure, &mut v, &piece_counts); } if changed { bytes = serde_json::to_vec_pretty(&v).unwrap_or(bytes); diff --git a/crates/horizon-port-pack/src/worldgen.rs b/crates/horizon-port-pack/src/worldgen.rs index 1ad836ad1..269751ef1 100644 --- a/crates/horizon-port-pack/src/worldgen.rs +++ b/crates/horizon-port-pack/src/worldgen.rs @@ -26,6 +26,19 @@ const JIGSAWS: [&str; 3] = [ "moogs_structures:moogs_structures_generic_jigsaw_structure", "repurposed_structures:generic_jigsaw_structure", ]; +/// The Nether variants of the piece-limited jigsaws: laid out the same, +/// then moved onto land. +const NETHER_JIGSAWS: [&str; 2] = [ + "moogs_structures:moogs_structures_generic_nether_jigsaw_structure", + "repurposed_structures:generic_nether_jigsaw_structure", +]; +/// Layout rules the piece-limited assembler keeps (`horizon:piece_limited`). +const PIECE_LIMITED_RULES: [&str; 4] = [ + "y_allowance", + "burying_type", + "use_bounding_box_hack", + "pools_that_ignore_boundaries", +]; /// Placements that are vanilla's random spread with extra rules. const SPREADS: [&str; 2] = [ "moogs_structures:advanced_random_spread", @@ -213,12 +226,22 @@ fn upgrade_types( yung_structure(v, lost); true } - Some(t) if JIGSAWS.contains(&t) => { - let liquid = match t.split_once(':').map(|(ns, _)| ns) { - Some("moogs_structures") => "top", - _ => "lowest", + Some(t) if JIGSAWS.contains(&t) || NETHER_JIGSAWS.contains(&t) => { + let library = match t.split_once(':').map(|(ns, _)| ns) { + Some("moogs_structures") => Some("moogs"), + Some("repurposed_structures") => Some("repurposed"), + _ => None, }; - start_checks(v, liquid, lost); + let liquid = if library == Some("moogs") { + "top" + } else { + "lowest" + }; + let limited = library.map(|l| piece_limited(v, l)); + start_checks(v, liquid, lost, limited.is_some()); + if let Some(limited) = limited { + v["horizon:piece_limited"] = limited; + } v["type"] = "minecraft:jigsaw".into(); true } @@ -399,7 +422,7 @@ fn yung_condition(c: &Value, lost: &mut BTreeMap<String, usize>) -> Value { /// Moves a Repurposed Structures or Moog's jigsaw's start rules under /// `horizon:start_checks`, and counts the layout rules it loses. `liquid` is /// the block its no-start-in-liquid rule reads. -fn start_checks(v: &mut Value, liquid: &str, lost: &mut BTreeMap<String, usize>) { +fn start_checks(v: &mut Value, liquid: &str, lost: &mut BTreeMap<String, usize>, limited: bool) { let Some(o) = v.as_object_mut() else { return; }; @@ -420,7 +443,8 @@ fn start_checks(v: &mut Value, liquid: &str, lost: &mut BTreeMap<String, usize>) } } for rule in LAYOUT_RULES { - if o.remove(rule).is_some_and(|r| r != Value::Bool(false)) { + let kept = limited && PIECE_LIMITED_RULES.contains(&rule); + if o.remove(rule).is_some_and(|r| r != Value::Bool(false)) && !kept { *lost.entry(rule.into()).or_default() += 1; } } @@ -429,6 +453,121 @@ fn start_checks(v: &mut Value, liquid: &str, lost: &mut BTreeMap<String, usize>) } } +/// A Repurposed Structures or Moog's jigsaw's layout rules for the game's +/// piece-limited assembler: y_allowance, burying, the pools whose fallbacks +/// ignore the bounds, liquid, and the Nether variants' land search. The +/// bounding box hack is vanilla's expansion hack. The pieces' counts are +/// added from the mod's count files ([`piece_counts`]). +fn piece_limited(v: &mut Value, library: &str) -> Value { + let mut out = serde_json::Map::new(); + out.insert("library".into(), library.into()); + let lower = |x: &Value| x.as_str().map(str::to_ascii_lowercase); + for (from, to) in [("min_y_allowed", "min_y"), ("max_y_allowed", "max_y")] { + if let Some(n) = v.get("y_allowance").and_then(|y| y.get(from)) { + out.insert(to.into(), n.clone()); + } + } + if let Some(b) = v.get("burying_type").and_then(lower) { + out.insert("burying".into(), b.into()); + } + if v["cannot_spawn_in_liquid"].as_bool() == Some(true) { + out.insert("no_liquid".into(), true.into()); + } + if let Some(pools) = v + .get("pools_that_ignore_boundaries") + .filter(|p| p.is_array()) + { + out.insert("ignore_bounds_pools".into(), pools.clone()); + } + if v["use_bounding_box_hack"].as_bool() == Some(true) { + v["use_expansion_hack"] = true.into(); + } + if let Some(o) = v.as_object_mut() { + if let Some(search) = o.remove("land_search_direction") { + out.insert("land_search".into(), lower(&search).into()); + } + if let Some(ledge) = o.remove("ledge_offset_y") { + out.insert("ledge_offset_y".into(), ledge); + } + } + out.into() +} + +/// The pieces' spawn counts of the structures a mod ships, by structure id: +/// Repurposed Structures' `rs_pieces_spawn_counts` (each file names its +/// `target_structure`) and Moog's `msl_pieces_spawn_counts` (the file's id), +/// in the game's `horizon:piece_limited` shape. +pub fn piece_counts<R: Read + std::io::Seek>( + zip: &mut zip::ZipArchive<R>, +) -> BTreeMap<String, Value> { + let mut out = BTreeMap::new(); + for i in 0..zip.len() { + let Ok(mut entry) = zip.by_index(i) else { + continue; + }; + let name = entry.name().to_owned(); + let Some((ns, rest)) = name + .strip_prefix("data/") + .and_then(|r| r.strip_suffix(".json")) + .and_then(|r| r.split_once('/')) + else { + continue; + }; + let (rs, path) = if let Some(p) = rest.strip_prefix("rs_pieces_spawn_counts/") { + (true, p) + } else if let Some(p) = rest.strip_prefix("msl_pieces_spawn_counts/") { + (false, p) + } else { + continue; + }; + let mut text = String::new(); + let Ok(v) = entry + .read_to_string(&mut text) + .map_err(|_| ()) + .and_then(|_| serde_json::from_str::<Value>(&text).map_err(|_| ())) + else { + continue; + }; + let id = match v["target_structure"].as_str() { + Some(target) if rs => target.to_owned(), + _ if rs => continue, + _ => format!("{ns}:{path}"), + }; + let pieces: Vec<Value> = v["pieces_spawn_counts"] + .as_array() + .into_iter() + .flatten() + .filter_map(|p| { + let mut e = serde_json::Map::new(); + e.insert("name".into(), p["nbt_piece_name"].as_str()?.into()); + for (from, to) in [ + ("always_spawn_this_many", "required"), + ("never_spawn_more_than_this_many", "max"), + ("minimum_distance_from_center_piece", "min_depth"), + ] { + if let Some(n) = p.get(from).filter(|n| n.is_number()) { + e.insert(to.into(), n.clone()); + } + } + Some(Value::Object(e)) + }) + .collect(); + out.insert(id, pieces.into()); + } + out +} + +/// Adds a structure's piece counts to its `horizon:piece_limited` key. +pub fn add_piece_counts(id: &str, v: &mut Value, counts: &BTreeMap<String, Value>) -> bool { + match (counts.get(id), v.get_mut("horizon:piece_limited")) { + (Some(pieces), Some(limited)) => { + limited["pieces"] = pieces.clone(); + true + } + _ => false, + } +} + /// AdvancedRandomSpread's spacing and separation, as Moog's computes them /// with its default config: 1.65 times the file's, rounded, the separation /// below the spacing. `when_replacing` (other numbers while a preset @@ -691,9 +830,8 @@ mod tests { let mut s = json!({"type": "lithostitched:jigsaw", "start_pool": "a:b"}); assert!(upgrade("structure", &mut s, &mut report, &NO_TAGS)); assert_eq!(s["type"], "minecraft:jigsaw"); - let mut nether = - json!({"type": "moogs_structures:moogs_structures_generic_nether_jigsaw_structure"}); - assert!(!upgrade("structure", &mut nether, &mut report, &NO_TAGS)); + let mut formation = json!({"type": "formations:simple"}); + assert!(!upgrade("structure", &mut formation, &mut report, &NO_TAGS)); let mut set = json!({"placement": {"type": "moogs_structures:advanced_random_spread", "spacing": 10, "separation": 5, "min_distance_from_world_origin": 250}}); assert!(upgrade("structure_set", &mut set, &mut report, &NO_TAGS)); @@ -730,10 +868,7 @@ mod tests { assert_eq!( report.unsupported, BTreeMap::from([ - ( - "moogs_structures:moogs_structures_generic_nether_jigsaw_structure".into(), - 1 - ), + ("formations:simple".into(), 1), ("somelib:element".into(), 1), ]) ); @@ -771,9 +906,12 @@ mod tests { let mut plain = json!({"type": "lithostitched:jigsaw", "cannot_spawn_in_liquid": false}); assert!(upgrade("structure", &mut plain, &mut report, &NO_TAGS)); assert!(plain.get("horizon:start_checks").is_none()); + // The layout rules go to the piece-limited assembler. + assert!(report.rules_lost.is_empty()); assert_eq!( - report.rules_lost, - BTreeMap::from([("burying_type".into(), 1), ("y_allowance".into(), 1)]) + moogs["horizon:piece_limited"], + json!({"library": "moogs", "min_y": 60, "burying": "lowest_corner", + "no_liquid": true}) ); } @@ -957,6 +1095,74 @@ mod tests { assert!(!disables("betterwitchhuts:witch_circle", &mut circle)); } + #[test] + fn piece_limited_jigsaws_keep_their_layout() { + let mut report = Upgrade::default(); + let mut nether = json!({"type": "repurposed_structures:generic_nether_jigsaw_structure", + "start_pool": "rs:x", "size": 8, "y_allowance": {"min_y_allowed": 40, "max_y_allowed": 90}, + "cannot_spawn_in_liquid": true, "pools_that_ignore_boundaries": ["rs:roof"], + "use_bounding_box_hack": true, "land_search_direction": "HIGHEST_LAND", + "ledge_offset_y": 2}); + assert!(upgrade("structure", &mut nether, &mut report, &NO_TAGS)); + assert_eq!(nether["type"], "minecraft:jigsaw"); + assert_eq!( + nether["horizon:piece_limited"], + json!({"library": "repurposed", "min_y": 40, "max_y": 90, "no_liquid": true, + "ignore_bounds_pools": ["rs:roof"], "land_search": "highest_land", + "ledge_offset_y": 2}) + ); + assert_eq!(nether["use_expansion_hack"], true); + for gone in [ + "y_allowance", + "use_bounding_box_hack", + "land_search_direction", + "ledge_offset_y", + ] { + assert!(nether.get(gone).is_none(), "{gone}"); + } + let mut moogs = json!({"type": "moogs_structures:moogs_structures_generic_jigsaw_structure", + "burying_type": "AVERAGE_LAND"}); + assert!(upgrade("structure", &mut moogs, &mut report, &NO_TAGS)); + assert_eq!( + moogs["horizon:piece_limited"], + json!({"library": "moogs", "burying": "average_land"}) + ); + // Lithostitched's jigsaw is vanilla's: no key. + let mut litho = json!({"type": "lithostitched:jigsaw"}); + assert!(upgrade("structure", &mut litho, &mut report, &NO_TAGS)); + assert!(litho.get("horizon:piece_limited").is_none()); + assert!(report.rules_lost.is_empty(), "{:?}", report.rules_lost); + assert!(report.unsupported.is_empty()); + + let mut zip = zip::ZipWriter::new(std::io::Cursor::new(Vec::new())); + let opts = zip::write::SimpleFileOptions::default(); + for (name, text) in [ + ( + "data/rs/rs_pieces_spawn_counts/city.json", + r#"{"target_structure": "rs:city_nether", "pieces_spawn_counts": [ + {"nbt_piece_name": "rs:city/center", "always_spawn_this_many": 1, + "never_spawn_more_than_this_many": 1, "minimum_distance_from_center_piece": 3}]}"#, + ), + ( + "data/mvs/msl_pieces_spawn_counts/tower.json", + r#"{"pieces_spawn_counts": [{"nbt_piece_name": "mvs:top", "never_spawn_more_than_this_many": 2}]}"#, + ), + ] { + zip.start_file(name, opts).unwrap(); + std::io::Write::write_all(&mut zip, text.as_bytes()).unwrap(); + } + let mut zip = zip::ZipArchive::new(zip.finish().unwrap()).unwrap(); + let counts = piece_counts(&mut zip); + assert_eq!( + counts["rs:city_nether"], + json!([{"name": "rs:city/center", "required": 1, "max": 1, "min_depth": 3}]) + ); + assert_eq!(counts["mvs:tower"], json!([{"name": "mvs:top", "max": 2}])); + assert!(add_piece_counts("rs:city_nether", &mut nether, &counts)); + assert_eq!(nether["horizon:piece_limited"]["pieces"][0]["required"], 1); + assert!(!add_piece_counts("rs:other", &mut nether, &counts)); + } + #[test] fn writes_block_states_in_26_3_shape() { let mut report = Upgrade::default(); From 1b6a3cf53507f232a2a102ca06c2aca5ee36e7eb Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 11:41:27 +0200 Subject: [PATCH 093/163] Docs: modpacks, the structure libraries Horizon now runs Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- docs/modpacks.md | 58 +++++++++++++++++++++++++++++++++++++----------- 1 file changed, 45 insertions(+), 13 deletions(-) diff --git a/docs/modpacks.md b/docs/modpacks.md index 1ecaed8bb..3dced2eee 100644 --- a/docs/modpacks.md +++ b/docs/modpacks.md @@ -439,6 +439,35 @@ Two cases the oracle fills in: template has them); 1,427 processors of 146 types in ATM10's mods, the most common `lithostitched:block_swap`, Formations' `biome_replacements` and Repurposed Structures' pillar, fluid and void processors. Porting the common ones is next. + - **Big templates** (#838). Vanilla reads structure templates with no limit on their tag + count; Horizon now does too (`nbt::Limits::templates`). Seven of ATM10's 8,962 carried + templates are past the old 1,000,000-tag cap: YUNG's monument start, four When Dungeons + Arise main pieces and two Nullscape pieces. They used to load as empty templates, so their + structures never started. + - **Additions to other sets and pools** (#832 in the game, #833 in carry). A set or pool file + holding `horizon:add_to` appends its entries to the sets or pools it names (docs/mods.md). + Carry writes these from lithostitched's `add_structure_set_entries` and + `add_template_pool_elements` modifiers whose load conditions hold for the mods ported + along, and from CTOV's Java registration: its 21 village types and 11 outposts join + vanilla's `villages` and `pillager_outposts` with the mod's default weights. + - **YUNG's API** (#839, #846 in the game; #840, #847 in carry). `yungsapi:yung_jigsaw` and its + elements become vanilla's jigsaw and single element, with their rules under + `horizon:yungsapi`. The game assembles them as YUNG's `JigsawManager` does: priority + pieces, caps by name, depth ranges, `ignore_bounds` and the conditions tree. YUNG's + placements become `horizon:` keys on a random spread: `horizon:exclusion_zone` for the + enhanced exclusion zone, `horizon:avoid_biomes` for the temples' ocean and river search, + `horizon:ring_sections` for Better Strongholds' rings. `horizon:disables` on a YUNG + structure turns off the vanilla type its mod's mixin turns off. It is written only when + the game can start the replacement, so vanilla mineshafts stay while Better Mineshafts (a + Java type) can't. + - **Repurposed Structures' and Moog's own assembler** (#850 in the game, #851 in carry). Both + lay out their jigsaws with `PieceLimitedJigsawManager`, not vanilla's. Their structures, the + Nether variants too, get `horizon:piece_limited`: `y_allowance`, burying, the pools whose + fallbacks ignore the bounds, liquid, the Nether land search and ledge, and each + structure's piece caps and required pieces from the mod's `*_pieces_spawn_counts` files. + The game assembles them the mods' way and runs their post-layout steps (centring, + burying, the Nether land search). + Each mod's `carry-report.json` lists what was mapped, the rules and processors lost by name, and the types left as they are. NeoForge's convention biome tags (`#c:is_forest`, ...) come @@ -453,19 +482,22 @@ Two cases the oracle fills in: ChoiceTheorem's Overhauled Village 66), and 103 convention biome tags written. - When Dungeons Arise, Structory and Towns and Towers use vanilla's types already. - Still lost, written in Java: - - YUNG's API: its own jigsaw assembler (priority pieces, per-piece caps, conditions, - enhanced terrain adaptation) and 491 elements and jigsaws, behind every "YUNG's Better" - mod; - - Formations' structure and element types (179); - - the nether jigsaw variants of Moog's and Repurposed (69), which search the column for - land after the layout; - - Moog's and Repurposed's layout rules: they centre the pieces on the start, bury or lift - the structure to the terrain and cap pieces per pool; - - Repurposed's mineshafts, mansions, monuments and cities, and MO Structures (38; its - library is only on CurseForge). - - CTOV's villages and outposts are added to vanilla's `villages` and `pillager_outposts` - sets by Java code, as lithostitched's `add_structure_set_entries` worldgen modifiers do for - many packs; a content mod has no way to add to a vanilla set yet, so none start. + - Formations' structure and element types (179): their placements read block states in the + noise column (solid, water, lava), which the structure context doesn't give yet; + - Repurposed's mineshafts, mansions, monuments, Nether cities and shipwrecks, Better + Mineshafts and two Better Dungeons types: Java structure types; + - YUNG's and Moog's enhanced terrain adaptation, YUNG's piece modifiers and dead-end pools, + and the processors written in Java (YUNG's spawners, chests, banners; 29 in Better Dungeons + alone), so these structures place their template blocks only; + - MO Structures (38; its library is only on CurseForge). + + With every structure PR above, the same square (seed 1234, chunks -64..63) holds 362 + overworld starts with 22,026 pieces. CTOV has 7, Better Dungeons 72 and Better Ocean + Monuments 3, and vanilla's monuments are gone as YUNG's mod has them. In the Nether there + are 512 starts, up from 322: Moog's Nether Structures 147, Repurposed's Nether structures + 40, Better Fortresses 7, with no vanilla fortress. Over chunks -256..255: Better Strongholds 10 + (vanilla 0), Better Jungle Temples 5, Better Witch Huts 11. Vanilla's own worlds are + unchanged: the structure-start oracle still matches 35 of 35. In a world with the 40 mods, seed 1234, `/locate structure mvs:azelea_house` finds one 27 blocks from spawn and it stands there as the template builds it; When Dungeons Arise's From fdee6576c62731d3a00d70e4649c790e55f308f6 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 12:01:12 +0200 Subject: [PATCH 094/163] Paletted containers: build palettes without hashing palette_ids (behind PalettedContainer::pack, every saved and sent section, and from_values, every generated one) scanned the palette for each of the 4096 values while it had up to 16 entries, then hashed every value with SipHash. A run of one value is now matched once, and past 16 entries a thread-local table indexed by value (block states and biomes are below 65536) replaces the hash map; only the palette's entries are set, and they are cleared before returning. The output is unchanged: palette in first-occurrence order and the same ids. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-core/src/paletted.rs | 213 ++++++++++++++++++++++++++-- 1 file changed, 198 insertions(+), 15 deletions(-) diff --git a/crates/horizon-core/src/paletted.rs b/crates/horizon-core/src/paletted.rs index 5c0ec374c..3d56bb987 100644 --- a/crates/horizon-core/src/paletted.rs +++ b/crates/horizon-core/src/paletted.rs @@ -151,33 +151,85 @@ fn write(words: &mut [u64], bits: u8, i: usize, value: u32) { let (word, shift) = locate(bits, i); words[word] = (words[word] & !(mask(bits) << shift)) | (u64::from(value) << shift); } +/// Values below this are looked up in a table indexed by value once a +/// palette outgrows the scan: every block state and biome id of 26.3. +const DENSE_VALUES: u32 = 1 << 16; +thread_local! { + /// `palette_ids`' table: 1 + the id of each value seen, 0 for the others. + /// Only the entries of the palette being built are set, and they are + /// cleared again before it returns. + static DENSE_IDS: std::cell::RefCell<Vec<u32>> = const { std::cell::RefCell::new(Vec::new()) }; +} /// The distinct `values` in first-occurrence order and each value's index in -/// them. Up to 16 distinct values a scan finds them faster than hashing. +/// them. A run of one value (most of a section) is matched once, a scan finds +/// up to 16 distinct values faster than any lookup, and past that a table +/// indexed by value finds them without hashing. fn palette_ids(values: &[u32]) -> (Vec<u32>, Vec<u32>) { let mut palette: Vec<u32> = Vec::new(); - let mut small = true; - let mut lookup: std::collections::HashMap<u32, u32> = std::collections::HashMap::new(); let mut ids = Vec::with_capacity(values.len()); - for &value in values { - let id = if small { - match palette.iter().position(|&v| v == value) { + let mut last: Option<(u32, u32)> = None; + let mut rest = values; + while let Some((&value, tail)) = rest.split_first() { + let id = match last { + Some((v, id)) if v == value => id, + _ if palette.len() > 16 => break, + _ => match palette.iter().position(|&v| v == value) { Some(id) => id as u32, None => { palette.push(value); - if palette.len() > 16 { - small = false; - lookup.extend(palette.iter().enumerate().map(|(i, &v)| (v, i as u32))); - } palette.len() as u32 - 1 } + }, + }; + last = Some((value, id)); + ids.push(id); + rest = tail; + } + if rest.is_empty() { + return (palette, ids); + } + if palette.iter().chain(rest).all(|&v| v < DENSE_VALUES) { + DENSE_IDS.with(|table| { + let mut table = table.borrow_mut(); + for (id, &v) in palette.iter().enumerate() { + let v = v as usize; + if table.len() <= v { + table.resize(v + 1, 0); + } + table[v] = id as u32 + 1; } - } else { - *lookup.entry(value).or_insert_with(|| { + for &value in rest { + let v = value as usize; + if table.len() <= v { + table.resize(v + 1, 0); + } + let id = match table[v] { + 0 => { + palette.push(value); + table[v] = palette.len() as u32; + palette.len() as u32 - 1 + } + slot => slot - 1, + }; + ids.push(id); + } + for &v in &palette { + table[v as usize] = 0; + } + }); + } else { + let mut lookup: std::collections::HashMap<u32, u32> = palette + .iter() + .enumerate() + .map(|(i, &v)| (v, i as u32)) + .collect(); + for &value in rest { + let id = *lookup.entry(value).or_insert_with(|| { palette.push(value); palette.len() as u32 - 1 - }) - }; - ids.push(id); + }); + ids.push(id); + } } (palette, ids) } @@ -828,4 +880,135 @@ mod tests { ); } } + + /// The pre-optimization `palette_ids` (scan, then a SipHash map), kept to + /// compare against. + fn baseline_palette_ids(values: &[u32]) -> (Vec<u32>, Vec<u32>) { + let mut palette: Vec<u32> = Vec::new(); + let mut small = true; + let mut lookup: std::collections::HashMap<u32, u32> = std::collections::HashMap::new(); + let mut ids = Vec::with_capacity(values.len()); + for &value in values { + let id = if small { + match palette.iter().position(|&v| v == value) { + Some(id) => id as u32, + None => { + palette.push(value); + if palette.len() > 16 { + small = false; + lookup.extend(palette.iter().enumerate().map(|(i, &v)| (v, i as u32))); + } + palette.len() as u32 - 1 + } + } + } else { + *lookup.entry(value).or_insert_with(|| { + palette.push(value); + palette.len() as u32 - 1 + }) + }; + ids.push(id); + } + (palette, ids) + } + /// Sections like the ones saved: stone, ores and caves under dirt, grass + /// and air; a mixed surface (plants, leaves, logs) in short runs; a + /// global palette; ids past the table; and biomes. + fn palette_cases() -> Vec<(&'static str, Vec<u32>)> { + let mut state = 0x9E37_79B9_7F4A_7C15u64; + let mut terrain = Vec::with_capacity(4096); + for i in 0..4096u32 { + let y = i >> 8; + let r = rng(&mut state); + terrain.push(match y { + 0..=8 if r % 40 == 0 => 2000 + (r >> 8) as u32 % 6, + 0..=8 if r % 13 == 0 => 0, + 0..=8 => 1, + 9..=10 => 10, + 11 => 9, + _ => 0, + }); + } + let mut surface = Vec::with_capacity(4096); + while surface.len() < 4096 { + let r = rng(&mut state); + let run = 1 + (r % 8) as usize; + let v = 100 + ((r >> 8) % 24) as u32 * 37; + surface.extend(std::iter::repeat_n(v, run.min(4096 - surface.len()))); + } + let global: Vec<u32> = (0..4096) + .map(|_| (rng(&mut state) % 600) as u32 * 41) + .collect(); + let large: Vec<u32> = (0..4096) + .map(|i| { + if i % 3 == 0 { + 70_000 + (rng(&mut state) % 40) as u32 + } else { + i as u32 % 20 + } + }) + .collect(); + let biomes: Vec<u32> = (0..64).map(|i| [3, 3, 3, 7, 7, 12][i % 6]).collect(); + vec![ + ("terrain", terrain), + ("surface", surface), + ("global", global), + ("large ids", large), + ("biomes", biomes), + ("single", vec![5; 4096]), + ("seventeen", (0..4096).map(|i| (i % 17) as u32).collect()), + ] + } + #[test] + fn palette_ids_match_first_occurrence_order() { + for (name, values) in palette_cases() { + assert_eq!( + palette_ids(&values), + baseline_palette_ids(&values), + "{name}" + ); + // The table is left clean for the next section. + assert_eq!( + palette_ids(&values), + baseline_palette_ids(&values), + "{name} again" + ); + } + DENSE_IDS.with(|t| assert!(t.borrow().iter().all(|&slot| slot == 0))); + } + /// `palette_ids` against the pre-optimization implementation over the + /// cases above. 25 measured rounds alternate order and report the median + /// microseconds per call. + #[test] + #[ignore = "microbenchmark; run with --ignored --nocapture"] + fn benchmark_palette_ids() { + use std::{hint::black_box, time::Instant}; + for (name, values) in palette_cases() { + let mut times = [Vec::new(), Vec::new()]; + for round in 0..25 { + for optimized in [round % 2 == 0, round % 2 != 0] { + let started = Instant::now(); + for _ in 0..500 { + if optimized { + black_box(palette_ids(black_box(&values))); + } else { + black_box(baseline_palette_ids(black_box(&values))); + } + } + if round > 0 { + times[usize::from(optimized)] + .push(started.elapsed().as_secs_f64() * 1e6 / 500.0); + } + } + } + for t in &mut times { + t.sort_by(f64::total_cmp); + } + let (base, new) = (times[0][times[0].len() / 2], times[1][times[1].len() / 2]); + println!( + "palette_ids {name}: baseline {base:.2} us, new {new:.2} us, {:.2}x", + base / new + ); + } + } } From d1db8c4a54635193b77a3600fdd019af905a54fd Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 11:43:31 +0200 Subject: [PATCH 095/163] Region writer: encode and compress a batch's chunks on helper threads The writer thread encoded (NBT) and zlib-compressed every chunk of a batch one after another before writing them. A batch of at least 8 chunks is now shared out to scoped helper threads (at most half the hardware threads), which take the next chunk as they finish one. The results are put back in submission order and written exactly as before, so the region files are byte-identical: each chunk's bytes depend only on the chunk, and sector allocation follows the same write order. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/save.rs | 108 +++++++++++++++++++++++++++--- 1 file changed, 98 insertions(+), 10 deletions(-) diff --git a/crates/horizon-client/src/save.rs b/crates/horizon-client/src/save.rs index 569e7ef3c..c407a7967 100644 --- a/crates/horizon-client/src/save.rs +++ b/crates/horizon-client/src/save.rs @@ -1321,22 +1321,22 @@ fn cached_region( /// Write `records` into the region files of `folder` in place, as vanilla's /// `RegionFile.write` does: each chunk takes free sectors and the header /// then points to it; the region's other chunks are not touched. `None` -/// clears a chunk. The chunks are compressed before their region is locked -/// for the writes, and each region is flushed to the disk once. +/// clears a chunk. The chunks are encoded and compressed before their region +/// is locked for the writes (`compress_records`), and each region is flushed +/// to the disk once. fn write_region_records( root: &Path, cache: &RegionCache, folder: &str, - records: Vec<((i32, i32), Option<Arc<NamedTag>>)>, + records: &[((i32, i32), &Record)], ) -> Result<()> { let timestamp = std::time::SystemTime::now() .duration_since(std::time::UNIX_EPOCH) .map_or(0, |d| d.as_secs() as u32); + let compressed = compress_records(records, timestamp); let mut by_region: BTreeMap<(i32, i32), Vec<(ChunkPos, Option<ChunkRecord>)>> = BTreeMap::new(); - for ((x, z), tag) in records { - let record = tag - .map(|tag| ChunkRecord::from_nbt(&tag, Compression::Zlib, timestamp, Limits::default())) - .transpose()?; + for (&((x, z), _), record) in records.iter().zip(compressed) { + let record = record?; by_region .entry((x >> 5, z >> 5)) .or_default() @@ -1367,6 +1367,57 @@ fn write_region_records( Ok(()) } +/// Fewest chunks each helper of `compress_records` takes: below this a thread +/// costs more to start than it saves. +const CHUNKS_PER_HELPER: usize = 4; +/// Each record encoded and compressed (`None` for a deletion), in the order +/// given. Vanilla's IOWorker does this one chunk after another; here a batch +/// is shared out to scoped threads, which take the next chunk as they finish +/// one. Each chunk's bytes depend only on the chunk, and the writes stay in +/// order, so the files are the same as from one thread. At most half the +/// hardware threads help, leaving the rest to the game and its workers. +fn compress_records( + records: &[((i32, i32), &Record)], + timestamp: u32, +) -> Vec<std::io::Result<Option<ChunkRecord>>> { + let compress = |record: &Record| { + record + .tag() + .map(|tag| ChunkRecord::from_nbt(&tag, Compression::Zlib, timestamp, Limits::default())) + .transpose() + }; + let helpers = std::thread::available_parallelism() + .map_or(1, |n| n.get().div_ceil(2)) + .min(records.len() / CHUNKS_PER_HELPER); + if helpers <= 1 { + return records.iter().map(|(_, r)| compress(r)).collect(); + } + let next = std::sync::atomic::AtomicUsize::new(0); + let mut done: Vec<(usize, std::io::Result<Option<ChunkRecord>>)> = + std::thread::scope(|scope| { + let threads: Vec<_> = (0..helpers) + .map(|_| { + scope.spawn(|| { + let mut out = Vec::new(); + loop { + let i = next.fetch_add(1, Ordering::Relaxed); + let Some((_, record)) = records.get(i) else { + return out; + }; + out.push((i, compress(record))); + } + }) + }) + .collect(); + threads + .into_iter() + .flat_map(|t| t.join().unwrap_or_else(|e| std::panic::resume_unwind(e))) + .collect() + }); + done.sort_unstable_by_key(|(i, _)| *i); + done.into_iter().map(|(_, r)| r).collect() +} + fn region_path(root: &Path, folder: &str, rx: i32, rz: i32) -> PathBuf { root.join(format!("{folder}/r.{rx}.{rz}.mca")) } @@ -1582,12 +1633,12 @@ impl SaveDir { p.get(&(entities, k.0, k.1)).is_none_or(|p| p.0 <= seq) }) }; - let records = batch + let records: Vec<_> = batch .iter() .filter(|(k, _, seq)| newest(k, *seq)) - .map(|(k, r, _)| (*k, r.tag())) + .map(|(k, r, _)| (*k, r)) .collect(); - if let Err(e) = write_region_records(&root, cache, folder, records) { + if let Err(e) = write_region_records(&root, cache, folder, &records) { log::warn!("Horizon: failed to write {folder} files: {e}"); } // Readers find the files (and a fresh region cache) from here on. @@ -2905,6 +2956,43 @@ mod tests { assert_eq!(source.block_entities[0].0, (99, 0, 99)); } + #[test] + fn records_compressed_on_helpers_match_one_thread_in_order() { + use super::{Record, compress_records}; + let records: Vec<((i32, i32), Record)> = (0..53i32) + .map(|i| { + let record = if i % 7 == 3 { + Record::Delete + } else { + let payload: Vec<i64> = (0..i * 97 % 2000).map(|v| i64::from(v * i)).collect(); + Record::Tag(Arc::new(NamedTag { + name: "".into(), + tag: Tag::compound([ + ("xPos", Tag::Int(i)), + ("Data", Tag::LongArray(payload)), + ]), + })) + }; + ((i, -i), record) + }) + .collect(); + let refs: Vec<_> = records.iter().map(|(k, r)| (*k, r)).collect(); + let compressed = compress_records(&refs, 1234); + assert_eq!(compressed.len(), records.len()); + for ((_, record), got) in records.iter().zip(compressed) { + let want = record + .tag() + .map(|t| ChunkRecord::from_nbt(&t, Compression::Zlib, 1234, Limits::default())) + .transpose() + .unwrap(); + let got = got.unwrap(); + assert_eq!( + got.as_ref().map(|r| (&r.compressed, r.timestamp)), + want.as_ref().map(|r| (&r.compressed, r.timestamp)) + ); + } + } + #[test] fn older_worlds_are_upgraded_on_opening() { let dir = std::env::temp_dir().join(format!("horizon-dv-{}", std::process::id())); From df58a474fbd654e7d74b7c4298e1278bbbe611dd Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 12:05:22 +0200 Subject: [PATCH 096/163] Terrain vertices in 24 bytes: the UV as 16-bit fixed point TerrainVertex goes from 28 to 24 bytes: the UV becomes two u16 in 32768 steps per unit, which hold model UVs (multiples of 1/16 and their halves) exactly and decode exactly in terrain.wgsl. The position stays a float: fixed point moves the edges of offset plants and rotated elements by a fraction of a pixel. Section vertex memory drops 14% (RD 16: 380 -> 325 MB, arena 503 -> 369 MB); pixels are unchanged on Metal and Vulkan outside animated water. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../examples/section_mesh_fixture.rs | 11 +-- crates/horizon-client/src/gfx.rs | 4 +- crates/horizon-client/src/mesher.rs | 68 +++++++++++++++---- crates/horizon-client/src/mesher/facing.rs | 8 +-- crates/horizon-client/src/mesher/fluid.rs | 8 +-- crates/horizon-client/src/terrain.wgsl | 13 ++-- 6 files changed, 71 insertions(+), 41 deletions(-) diff --git a/crates/horizon-client/examples/section_mesh_fixture.rs b/crates/horizon-client/examples/section_mesh_fixture.rs index 6359f32d0..3f0caaf12 100644 --- a/crates/horizon-client/examples/section_mesh_fixture.rs +++ b/crates/horizon-client/examples/section_mesh_fixture.rs @@ -159,15 +159,8 @@ fn scene( let vertices: Vec<Value> = quad .iter() .map(|v| { - json!([ - v.pos[0], - v.pos[1], - v.pos[2], - v.uv[0], - v.uv[1], - argb(v.color), - light_coords(v.light) - ]) + let ([x, y, z], [u, w]) = (v.pos, v.uv()); + json!([x, y, z, u, w, argb(v.color), light_coords(v.light)]) }) .collect(); quads.push(json!({"layer": layer, "sprite": sprite, "vertices": vertices})); diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 22d88c770..dcc3f417d 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -24,7 +24,7 @@ const CRUMBLING_BLEND: wgpu::BlendState = wgpu::BlendState { }; /// `TerrainVertex` for `vs_terrain`: position, UV, layer, light, colour. const TERRAIN_ATTRIBUTES: [wgpu::VertexAttribute; 5] = - wgpu::vertex_attr_array![0=>Float32x3,1=>Float32x2,2=>Uint16,4=>Uint8x2,3=>Unorm8x4]; + wgpu::vertex_attr_array![0=>Float32x3,1=>Uint16x2,2=>Uint16,4=>Uint8x2,3=>Unorm8x4]; /// entity.wgsl after the OverlayTexture constants it reads. fn entity_shader() -> String { @@ -3521,7 +3521,7 @@ mod tests { (3, offset_of!(TerrainVertex, color)), ] ); - assert_eq!(std::mem::size_of::<TerrainVertex>(), 28); + assert_eq!(std::mem::size_of::<TerrainVertex>(), 24); } #[test] fn cracks_multiply_instead_of_covering_the_block() { diff --git a/crates/horizon-client/src/mesher.rs b/crates/horizon-client/src/mesher.rs index c3990f598..5e657e82c 100644 --- a/crates/horizon-client/src/mesher.rs +++ b/crates/horizon-client/src/mesher.rs @@ -39,16 +39,22 @@ pub struct Vertex { /// RGBA8_SNORM face normal; w = -127 for two-sided lighting, 0 to keep baked/unlit colour. pub normal: [i8; 4], } -/// A section vertex, 28 bytes like vanilla's `DefaultVertexFormat.BLOCK` -/// (position, colour, UV0, UV2) with the sprite's array layer beside the -/// light. Terrain has no normal: `ModelBlockRenderer` bakes the face shade -/// into the colour and `terrain.vsh` only multiplies it by the lightmap. +/// A section vertex: vanilla's `DefaultVertexFormat.BLOCK` (position, colour, +/// UV0, UV2) with the sprite's array layer beside the light, in 24 bytes +/// rather than vanilla's 28: the UV is fixed point, which holds model UVs +/// (multiples of 1/16 and their halves) exactly. The position stays a float: +/// fixed point would move the edges of offset plants and rotated elements by +/// a fraction of a pixel. Terrain has no normal: `ModelBlockRenderer` bakes +/// the face shade into the colour and `terrain.vsh` only multiplies it by the +/// lightmap. #[repr(C)] #[derive(Clone, Copy, Debug, bytemuck::Pod, bytemuck::Zeroable)] pub struct TerrainVertex { /// Section-relative position. pub pos: [f32; 3], - pub uv: [f32; 2], + /// UV within the sprite, `UV_STEPS` per unit (`TerrainVertex::new`, + /// `terrain.wgsl`'s `terrain_uv`). + pub(crate) uv: [u16; 2], /// Sprite array layer, with `OPAQUE_LAYER` for opaque leaves. pub layer: u16, /// Smooth light, 16x fixed point: sky in the low byte, block in the high one. @@ -56,6 +62,44 @@ pub struct TerrainVertex { /// RGBA8: tint multiplied by directional shade and ambient occlusion. pub color: u32, } +/// Fixed-point steps per unit of `TerrainVertex` UVs, which span `[0, 2)`. +pub const UV_STEPS: f32 = 32768.0; +impl TerrainVertex { + pub fn new(pos: [f32; 3], uv: [f32; 2], layer: u16, color: u32, light: u16) -> Self { + Self { + pos, + uv: uv.map(|v| (v * UV_STEPS).round().clamp(0.0, f32::from(u16::MAX)) as u16), + layer, + light, + color, + } + } + /// The UV the GPU samples. + pub fn uv(&self) -> [f32; 2] { + self.uv.map(|v| f32::from(v) / UV_STEPS) + } +} +#[cfg(test)] +mod vertex_tests { + use super::TerrainVertex; + #[test] + fn model_uvs_pack_exactly() { + for i in 0..=32 { + let u = i as f32 / 32.0; + let v = TerrainVertex::new([0.0; 3], [u, 1.0 - u], 0, 0, 0); + assert_eq!(v.uv(), [u, 1.0 - u]); + } + } + #[test] + fn other_uvs_round_within_a_step() { + // A flowing fluid's rotated UV. + let uv = [0.5 + 0.25 * 0.3f32.sin(), 0.5 - 0.25 * 0.3f32.cos()]; + let packed = TerrainVertex::new([0.0; 3], uv, 0, 0, 0).uv(); + for (a, b) in packed.iter().zip(uv) { + assert!((a - b).abs() <= 0.5 / 32768.0, "{a} {b}"); + } + } +} pub struct SectionMesh { pub solid: Vec<TerrainVertex>, /// `solid`'s quads by the side they face (`facing`). @@ -786,18 +830,18 @@ impl Mesher<'_> { None => [g; 3], }; let p = q.positions[i]; - target.push(TerrainVertex { - pos: [p[0] + origin[0], p[1] + origin[1], p[2] + origin[2]], - uv: q.uv[i], + target.push(TerrainVertex::new( + [p[0] + origin[0], p[1] + origin[1], p[2] + origin[2]], + q.uv[i], // Opaque leaves (forceOpaque) draw in the solid layer: no alpha cutout. - layer: if !self.cutout_leaves && state.leaves { + if !self.cutout_leaves && state.leaves { face.layer as u16 | OPAQUE_LAYER } else { face.layer as u16 }, - color: pack_rgb(rgb), - light: pack_coords(lighting::with_emission(coords[i], q.light_emission)), - }); + pack_rgb(rgb), + pack_coords(lighting::with_emission(coords[i], q.light_emission)), + )); } } } diff --git a/crates/horizon-client/src/mesher/facing.rs b/crates/horizon-client/src/mesher/facing.rs index 2a7f0ba61..e82ad6a06 100644 --- a/crates/horizon-client/src/mesher/facing.rs +++ b/crates/horizon-client/src/mesher/facing.rs @@ -175,13 +175,7 @@ mod tests { use super::*; fn vertex(pos: [f32; 3], layer: u16) -> TerrainVertex { - TerrainVertex { - pos, - uv: [0.0; 2], - layer, - light: 0, - color: 0, - } + TerrainVertex::new(pos, [0.0; 2], layer, 0, 0) } /// A unit quad in the plane `axis = plane`, wound to face `sign`, tagged /// with `layer` so tests can follow it. diff --git a/crates/horizon-client/src/mesher/fluid.rs b/crates/horizon-client/src/mesher/fluid.rs index c29f2b92c..6e42685ba 100644 --- a/crates/horizon-client/src/mesher/fluid.rs +++ b/crates/horizon-client/src/mesher/fluid.rs @@ -306,13 +306,7 @@ pub(super) fn tesselate( }; let mut quad = |v: [([f32; 3], [f32; 2]); 4], layer: u16, color: u32, light: u16, back: bool| { - let vertex = |(pos, uv): ([f32; 3], [f32; 2])| TerrainVertex { - pos, - uv, - layer, - color, - light, - }; + let vertex = |(pos, uv)| TerrainVertex::new(pos, uv, layer, color, light); target.extend(v.map(vertex)); if back { target.extend([v[0], v[3], v[2], v[1]].map(vertex)); diff --git a/crates/horizon-client/src/terrain.wgsl b/crates/horizon-client/src/terrain.wgsl index 504d197aa..7d25cef2f 100644 --- a/crates/horizon-client/src/terrain.wgsl +++ b/crates/horizon-client/src/terrain.wgsl @@ -72,11 +72,16 @@ fn sample_lightmap(sky: f32, block: f32) -> vec4<f32> { return textureSampleLevel(lightmap, lightmap_sampler, clamp(uv / 256.0 + 0.5 / 16.0, vec2(0.5 / 16.0), vec2(15.5 / 16.0)), 0.0); } +// mesher.rs's TerrainVertex holds the UV in 32768 steps per unit: a power of +// two on an integer below 2^24, so it decodes exactly. +fn terrain_uv(packed: vec2<u32>) -> vec2<f32> { + return vec2<f32>(packed) * (1.0 / 32768.0); +} @vertex fn vs_terrain( - @location(0) position: vec3<f32>, @location(1) uv: vec2<f32>, + @location(0) position: vec3<f32>, @location(1) uv: vec2<u32>, @location(2) layer: u32, @location(3) color: vec4<f32>, @location(4) light: vec2<u32>, @location(5) origin: vec4<f32>) -> TerrainOut { - return terrain_vertex(position, uv, layer, color, light, origin.xyz); + return terrain_vertex(position, terrain_uv(uv), layer, color, light, origin.xyz); } // Flat section draws (gfx/flat.rs): one draw per arena page over the frame's // index list. A section's vertices fill whole 256-vertex blocks of its page: @@ -85,11 +90,11 @@ fn sample_lightmap(sky: f32, block: f32) -> vec4<f32> { @group(1) @binding(1) var<storage, read> slot_origins: array<vec4<f32>>; @vertex fn vs_terrain_flat( @builtin(vertex_index) vertex: u32, - @location(0) position: vec3<f32>, @location(1) uv: vec2<f32>, + @location(0) position: vec3<f32>, @location(1) uv: vec2<u32>, @location(2) layer: u32, @location(3) color: vec4<f32>, @location(4) light: vec2<u32> ) -> TerrainOut { let origin = slot_origins[block_slots[vertex >> 8u]]; - return terrain_vertex(position, uv, layer, color, light, origin.xyz); + return terrain_vertex(position, terrain_uv(uv), layer, color, light, origin.xyz); } fn terrain_vertex(position: vec3<f32>, uv: vec2<f32>, layer: u32, color: vec4<f32>, light: vec2<u32>, origin: vec3<f32>) -> TerrainOut { From 6bf479ec0bb7501b34b59b40cfe18244cedb4900 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 11:48:16 +0200 Subject: [PATCH 097/163] Light changes dirty sections by section, not cell by cell Relighting block edits and relit chunks collected every changed cell, sorted and de-duplicated them, then marked the sections around each cell for remeshing. Vanilla's light engine reports changed sections to LevelRenderer instead. LightChanges now keeps, per changed section, which of 27 border classes (low face, inside, high face per axis) its changed cells fall in; that gives exactly the same dirty sections and light log without keeping or sorting the cells. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../horizon-client/examples/light_parity.rs | 11 +- crates/horizon-client/src/light.rs | 204 +++++++++++++++--- crates/horizon-client/src/streaming.rs | 46 ++-- 3 files changed, 199 insertions(+), 62 deletions(-) diff --git a/crates/horizon-client/examples/light_parity.rs b/crates/horizon-client/examples/light_parity.rs index 29488130e..f660189a2 100644 --- a/crates/horizon-client/examples/light_parity.rs +++ b/crates/horizon-client/examples/light_parity.rs @@ -206,7 +206,7 @@ fn incremental( sky_light: bool, edits: usize, ) { - use horizon_client::light::relight; + use horizon_client::light::{LightChanges, relight}; use std::sync::Arc; let mut world: HashMap<(i32, i32), Arc<Chunk>> = HashMap::new(); let inner: Vec<(i32, i32)> = { @@ -285,7 +285,14 @@ fn incremental( if old == state || !tables.differs(old, state) { continue; } - relight(&mut world, tables, sky_light, &[(x, y, z)], false); + relight( + &mut world, + tables, + sky_light, + &[(x, y, z)], + false, + &mut LightChanges::default(), + ); for dz in -1..=1 { for dx in -1..=1 { let (kx, kz) = (cx + dx, cz + dz); diff --git a/crates/horizon-client/src/light.rs b/crates/horizon-client/src/light.rs index 2ef7af301..d7ea7d7fd 100644 --- a/crates/horizon-client/src/light.rs +++ b/crates/horizon-client/src/light.rs @@ -14,6 +14,7 @@ //! most 15 blocks, so the 48-wide region determines the centre exactly. //! `relight_block` applies vanilla's incremental decrease/increase passes //! directly to resident chunks after a block change. +use crate::fast_hash::FxHashMap; use crate::{ blocks::BlockFacts, chunk::{Chunk, HEIGHT, Light, MIN_Y, SECTIONS, index}, @@ -464,10 +465,8 @@ pub fn apply_lighting(chunk: &mut Chunk, lights: Vec<Light>) { } /// `apply_lighting` for a chunk lit before: writes only the sections whose -/// light changed and returns the block positions that changed. -pub fn apply_relighting(chunk: &mut Chunk, lights: Vec<Light>) -> Vec<(i32, i32, i32)> { - let mut changed = Vec::new(); - let (bx, bz) = (chunk.x * 16, chunk.z * 16); +/// light changed and adds the cells that changed to `changed`. +pub fn apply_relighting(chunk: &mut Chunk, lights: Vec<Light>, changed: &mut LightChanges) { for (sy, (section, light)) in chunk.sections.iter_mut().zip(lights).enumerate() { let old = §ion.light; if let (Light::Uniform(a), Light::Uniform(b)) = (old, &light) @@ -475,18 +474,18 @@ pub fn apply_relighting(chunk: &mut Chunk, lights: Vec<Light>) -> Vec<(i32, i32, { continue; } - let before = changed.len(); + let mut classes = 0; for i in 0..4096 { if old.get(i) != light.get(i) { - let y = MIN_Y + sy as i32 * 16 + (i >> 8) as i32; - changed.push((bx + (i & 15) as i32, y, bz + (i >> 4 & 15) as i32)); + let (x, y, z) = (i as i32 & 15, (i >> 8) as i32, (i >> 4) as i32 & 15); + classes |= 1 << LightChanges::class(x, y, z); } } - if changed.len() > before { + if classes != 0 { + changed.add((chunk.x, sy as i32, chunk.z), classes); Arc::make_mut(section).light = light; } } - changed } /// `DataLayer.get`: the nibble at index `i` (`y << 8 | z << 4 | x`), low first. @@ -607,6 +606,90 @@ impl<S: std::hash::BuildHasher> LightWorld for HashMap<(i32, i32), Arc<Chunk>, S } } type Pos = (i32, i32, i32); +/// Changed light by section, as vanilla's light engine reports it to +/// `LevelRenderer` (`setSectionDirty`) instead of cell by cell: for each +/// section (x, section index, z), a bit per class of position the changed +/// cells take in it, `3 * 3 * 3` classes for the low face, the inside and the +/// high face of each axis. Meshes sample light one block across a face, so the +/// class says which neighbouring sections a change dirties too. +#[derive(Clone, Debug, Default, PartialEq)] +pub struct LightChanges { + sections: FxHashMap<Pos, u32>, +} +impl LightChanges { + /// A cell whose stored light changed. + #[inline] + pub fn push(&mut self, (x, y, z): Pos) { + let key = (x >> 4, (y - MIN_Y) >> 4, z >> 4); + *self.sections.entry(key).or_default() |= 1 << Self::class(x, y, z); + } + /// Cells of section `key` (x, section index, z) in the given classes. + fn add(&mut self, key: Pos, classes: u32) { + *self.sections.entry(key).or_default() |= classes; + } + /// The class of a cell in its section: per axis 0 on the low face, 1 + /// inside, 2 on the high face. + fn class(x: i32, y: i32, z: i32) -> u32 { + let axis = |v: i32| match v & 15 { + 0 => 0, + 15 => 2, + _ => 1, + }; + axis(x) + 3 * axis(y) + 9 * axis(z) + } + pub fn is_empty(&self) -> bool { + self.sections.is_empty() + } + /// The sections (x, section index, z) holding changed cells. + pub fn sections(&self) -> impl Iterator<Item = Pos> + '_ { + self.sections.keys().copied() + } + /// Every section (x, section index, z) whose cells lie within one block + /// of a changed cell, section indexes outside `0..SECTIONS` left out (a + /// section next to several changed ones comes once for each). + pub fn dirty_sections(&self, mut out: impl FnMut(Pos)) { + // Per class, the bit set of neighbour offsets (dx, dy, dz in -1..=1, + // bit (dx + 1) + 3 (dy + 1) + 9 (dz + 1)) its cells reach. + const REACH: [u32; 27] = { + let mut reach = [0; 27]; + let mut class = 0; + while class < 27 { + let axis = [class % 3, class / 3 % 3, class / 9]; + let mut offset = 0; + while offset < 27 { + let d = [offset % 3, offset / 3 % 3, offset / 9]; + // Every class reaches its own section (d = 1, offset 0); + // the low face also -1 (d = 0), the high face +1 (d = 2). + if (d[0] == 1 || d[0] == axis[0]) + && (d[1] == 1 || d[1] == axis[1]) + && (d[2] == 1 || d[2] == axis[2]) + { + reach[class] |= 1 << offset; + } + offset += 1; + } + class += 1; + } + reach + }; + for (&(x, sy, z), &classes) in &self.sections { + let mut offsets = 0; + let mut rest = classes; + while rest != 0 { + offsets |= REACH[rest.trailing_zeros() as usize]; + rest &= rest - 1; + } + while offsets != 0 { + let o = offsets.trailing_zeros() as i32; + offsets &= offsets - 1; + let s = sy + o / 3 % 3 - 1; + if (0..SECTIONS as i32).contains(&s) { + out((x + o % 3 - 1, s, z + o / 9 - 1)); + } + } + } + } +} fn level(world: &impl LightWorld, sky: bool, p: Pos) -> Option<u8> { world .light(p.0, p.1, p.2) @@ -645,8 +728,8 @@ pub fn lowest_sky_source(world: &impl LightWorld, tables: &LightTables, x: i32, /// Vanilla's `checkBlock` + `runLightUpdates` for changed positions on /// resident, lit chunks: clear the light that may have come through or from /// the old states (decrease pass), then re-seed sources and propagate back in -/// from the brighter boundary (increase pass). Returns every position whose -/// stored light changed, for remeshing. `force` clears around each position +/// from the brighter boundary (increase pass). Adds every position whose +/// stored light changed to `changed`, for remeshing. `force` clears around each position /// as if it had been fully lit, for light computed from outdated blocks. pub fn relight( world: &mut impl LightWorld, @@ -654,16 +737,9 @@ pub fn relight( sky_light: bool, positions: &[Pos], force: bool, -) -> Vec<Pos> { - let mut changed = Vec::new(); - relight_layer( - world, - tables, - false, - positions.to_vec(), - force, - &mut changed, - ); + changed: &mut LightChanges, +) { + relight_layer(world, tables, false, positions.to_vec(), force, changed); if sky_light { let mut seeds = positions.to_vec(); let mut columns: HashMap<(i32, i32), i32> = HashMap::new(); @@ -686,11 +762,8 @@ pub fn relight( y -= 1; } } - relight_layer(world, tables, true, seeds, force, &mut changed); + relight_layer(world, tables, true, seeds, force, changed); } - changed.sort_unstable(); - changed.dedup(); - changed } fn relight_layer( world: &mut impl LightWorld, @@ -698,7 +771,7 @@ fn relight_layer( sky: bool, seeds: Vec<Pos>, force: bool, - changed: &mut Vec<Pos>, + changed: &mut LightChanges, ) { let mut decrease: VecDeque<(Pos, u8)> = VecDeque::new(); let mut cleared: Vec<Pos> = Vec::new(); @@ -894,7 +967,14 @@ mod tests { ]; for ((x, y, z), state) in edits { Arc::make_mut(w.get_mut(&(0, 0)).unwrap()).set(x, y, z, state); - relight(&mut w, &tables(), true, &[(x, y, z)], false); + relight( + &mut w, + &tables(), + true, + &[(x, y, z)], + false, + &mut LightChanges::default(), + ); } let region: [[Option<&Chunk>; 3]; 3] = std::array::from_fn(|dz| { std::array::from_fn(|dx| w.get(&(dx as i32 - 1, dz as i32 - 1)).map(|c| &**c)) @@ -940,7 +1020,16 @@ mod tests { assert_eq!(edited_snapshot.sections[0].light(index(8, MIN_Y, 8)), 0xF0); let mut world = HashMap::from([((0, 0), Arc::new(current))]); // Streaming replays edits made after the job snapshot with force=true. - relight(&mut world, &tables(), true, &[(8, MIN_Y, 8)], true); + let mut changed = LightChanges::default(); + relight( + &mut world, + &tables(), + true, + &[(8, MIN_Y, 8)], + true, + &mut changed, + ); + assert!(!changed.is_empty()); let region = [[None; 3], [None, Some(&*world[&(0, 0)]), None], [None; 3]]; let fresh = light_chunk(®ion, &tables(), true); for (section, light) in world[&(0, 0)].sections.iter().zip(fresh) { @@ -963,7 +1052,9 @@ mod tests { let sections: Vec<_> = chunk.sections.iter().map(Arc::as_ptr).collect(); // The same light again: nothing changes and no section is copied. let light = lit(&chunk); - assert!(apply_relighting(&mut chunk, light).is_empty()); + let mut changed = LightChanges::default(); + apply_relighting(&mut chunk, light, &mut changed); + assert!(changed.is_empty()); assert_eq!( sections, chunk.sections.iter().map(Arc::as_ptr).collect::<Vec<_>>() @@ -971,8 +1062,8 @@ mod tests { let before = chunk.clone(); chunk.set(3, MIN_Y + 20, 5, STONE); let light = lit(&chunk); - let changed = apply_relighting(&mut chunk, light); - let mut expected = Vec::new(); + apply_relighting(&mut chunk, light, &mut changed); + let mut expected = LightChanges::default(); for (sy, (old, new)) in before.sections.iter().zip(&chunk.sections).enumerate() { for i in 0..4096 { if old.light(i) != new.light(i) { @@ -992,6 +1083,57 @@ mod tests { assert!(copied <= 3, "{copied} sections copied"); } + #[test] + fn changes_dirty_the_sections_within_a_block_of_each_cell() { + // Cells inside sections, on each face and corner, at the bottom and + // top of the world, on negative coordinates. + let mut cells = Vec::new(); + for x in [-17, -16, -1, 0, 7, 15, 16, 31] { + for y in [ + MIN_Y, + MIN_Y + 15, + MIN_Y + 16, + 70, + 79, + 80, + MIN_Y + HEIGHT - 1, + ] { + for z in [-33, -32, 5, 15] { + cells.push((x, y, z)); + } + } + } + for n in [1, 2, cells.len()] { + for start in 0..cells.len().min(8) { + let some: Vec<Pos> = cells.iter().copied().cycle().skip(start).take(n).collect(); + let mut changes = LightChanges::default(); + some.iter().for_each(|&c| changes.push(c)); + let mut dirty = std::collections::BTreeSet::new(); + changes.dirty_sections(|s| { + dirty.insert(s); + }); + let mut expected = std::collections::BTreeSet::new(); + for &(x, y, z) in &some { + for (dx, dy, dz) in (-1..=1) + .flat_map(|a| (-1..=1).flat_map(move |b| (-1..=1).map(move |c| (a, b, c)))) + { + let s = (y + dy - MIN_Y) >> 4; + if (0..SECTIONS as i32).contains(&s) { + expected.insert(((x + dx) >> 4, s, (z + dz) >> 4)); + } + } + } + assert_eq!(dirty, expected, "{some:?}"); + let sections: std::collections::BTreeSet<_> = changes.sections().collect(); + let own: std::collections::BTreeSet<_> = some + .iter() + .map(|&(x, y, z)| (x >> 4, (y - MIN_Y) >> 4, z >> 4)) + .collect(); + assert_eq!(sections, own); + } + } + } + #[test] fn stored_layers_fill_the_column_as_vanilla_reads_them() { // Section 10's sky layer is 7 on its bottom row and 3 above; no diff --git a/crates/horizon-client/src/streaming.rs b/crates/horizon-client/src/streaming.rs index 6acdcafd2..ca1af4388 100644 --- a/crates/horizon-client/src/streaming.rs +++ b/crates/horizon-client/src/streaming.rs @@ -5,7 +5,7 @@ use crate::fast_hash::{FxHashMap, FxHashSet}; use crate::{ chunk::{Chunk, SECTIONS}, - light::{LightTables, apply_lighting, apply_relighting, light_chunk}, + light::{LightChanges, LightTables, apply_lighting, apply_relighting, light_chunk}, mesher::{MeshTables, Mesher, Region, SectionMesh, borrow}, world::World, }; @@ -748,12 +748,12 @@ impl Streaming { // only around the light that changed, as vanilla's light // updates dirty only their sections (#270). let first = self.lit.insert((x, z)); - let changed = if first { + let mut changed = LightChanges::default(); + if first { apply_lighting(chunk, sections); - Vec::new() } else { - apply_relighting(chunk, sections) - }; + apply_relighting(chunk, sections, &mut changed); + } chunk.lit = true; if first { for dz in -1..=1 { @@ -1125,12 +1125,14 @@ impl Streaming { if positions.is_empty() { return; } - let changed = crate::light::relight( + let mut changed = LightChanges::default(); + crate::light::relight( &mut world.chunks, &self.light_tables, self.sky_light, &positions, false, + &mut changed, ); Self::mark_light_changes(world, &changed); if !self.light_snapshots.is_empty() { @@ -1152,12 +1154,14 @@ impl Streaming { .map(|(_, p)| *p) .collect(); if !positions.is_empty() { - let changed = crate::light::relight( + let mut changed = LightChanges::default(); + crate::light::relight( &mut world.chunks, &self.light_tables, self.sky_light, &positions, true, + &mut changed, ); Self::mark_light_changes(world, &changed); } @@ -1169,31 +1173,15 @@ impl Streaming { } /// Sections whose meshes sample a changed light value (faces and corners /// read light from neighbouring blocks). - fn mark_light_changes(world: &mut World, changed: &[(i32, i32, i32)]) { + fn mark_light_changes(world: &mut World, changed: &LightChanges) { if let Some(log) = &mut world.light_log { - for &(x, y, z) in changed { - *log.entry((x >> 4, z >> 4)).or_default() |= 1 << ((y - crate::chunk::MIN_Y) >> 4); - } - } - let mut last = None; - for &(x, y, z) in changed { - for dz in -1..=1 { - for dy in -1..=1 { - for dx in -1..=1 { - let s = ( - (y + dy - crate::chunk::MIN_Y) >> 4, - (x + dx) >> 4, - (z + dz) >> 4, - ); - if last == Some(s) || !(0..SECTIONS as i32).contains(&s.0) { - continue; - } - last = Some(s); - world.dirty_sections.insert((s.1, s.0, s.2)); - } - } + for (x, sy, z) in changed.sections() { + *log.entry((x, z)).or_default() |= 1 << sy; } } + changed.dirty_sections(|section| { + world.dirty_sections.insert(section); + }); } fn ranges(&self) -> Ranges<'_> { Ranges { From 2ec71e53875b9db9e0ed5fa2932c9f23ef47e89c Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 11:52:47 +0200 Subject: [PATCH 098/163] Mesh scheduling looks at dirty sections column by column Sections waiting to be remeshed were one hash set that the render thread walked section by section every frame, though every check (column loaded, in view, its 3x3 lit, its region) holds for a whole column. At RD 32 about 12,000 sections wait at the edge of the lit area at any time. They are now kept per column (a bit per section index), so each frame looks at each column once and meshes all of its ready sections together. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/streaming.rs | 107 ++++++++++++++----------- crates/horizon-client/src/world.rs | 42 +++++++++- 2 files changed, 99 insertions(+), 50 deletions(-) diff --git a/crates/horizon-client/src/streaming.rs b/crates/horizon-client/src/streaming.rs index 6acdcafd2..4d658fd56 100644 --- a/crates/horizon-client/src/streaming.rs +++ b/crates/horizon-client/src/streaming.rs @@ -544,7 +544,7 @@ impl Streaming { self.lighting.remove(&(x, z)); self.meshing.retain(|k, _| (k.0, k.2) != (x, z)); self.waiting.retain(|k| (k.0, k.2) != (x, z)); - world.dirty_sections.retain(|k| (k.0, k.2) != (x, z)); + world.dirty_sections.take_column(x, z); world.chunks.remove(&(x, z)) } fn submit(&mut self, priority: i64, job: Job) { @@ -809,7 +809,9 @@ impl Streaming { let far: HashSet<(i32, i32)> = far.iter().copied().collect(); self.meshing.retain(|k, _| !far.contains(&(k.0, k.2))); self.waiting.retain(|k| !far.contains(&(k.0, k.2))); - world.dirty_sections.retain(|k| !far.contains(&(k.0, k.2))); + world + .dirty_sections + .retain_columns(|x, z| !far.contains(&(x, z))); } // Drop far proto chunks that are not checked out. let (center, r4) = (self.center, i64::from(self.radius + 4)); @@ -1025,66 +1027,63 @@ impl Streaming { !back }); } - let dirty: Vec<_> = world.dirty_sections.iter().copied().collect(); - let mut columns: FxHashMap<(i32, i32), Option<Box<Region>>> = FxHashMap::default(); - let mut ready_columns: FxHashMap<(i32, i32), bool> = FxHashMap::default(); - for (x, sy, z) in dirty { + // Column by column: the checks below hold for all of a column's + // sections, and columns waiting for light cost one look per frame. + let columns: Vec<_> = world.dirty_sections.columns().collect(); + for ((x, z), sections) in columns { if !world.chunks.contains_key(&(x, z)) { - world.dirty_sections.remove(&(x, sy, z)); + world.dirty_sections.take_column(x, z); continue; } if !self.ranges().in_view(x, z) { - world.dirty_sections.remove(&(x, sy, z)); - self.waiting.insert((x, sy, z)); + world.dirty_sections.take_column(x, z); + for sy in section_indexes(sections) { + self.waiting.insert((x, sy, z)); + } continue; } - // Once per column: the 3x3 check would otherwise repeat for each - // of its sections every frame. A neighbour being lit dirties this - // column again when its light job finishes (new chunks relight - // their eight neighbours), so wait for it rather than mesh once - // per neighbour. Columns still in `dirty_light` here can't be lit - // yet (a neighbour of theirs is missing): waiting for them could - // last until the player comes back. - let (lit, lighting) = (&self.lit, &self.lighting); - let ready = *ready_columns.entry((x, z)).or_insert_with(|| { - (-1..=1).all(|dz| { - (-1..=1).all(|dx| { - let n = (x + dx, z + dz); - lit.contains(&n) && !lighting.contains_key(&n) - }) + // A neighbour being lit dirties this column again when its light + // job finishes (new chunks relight their eight neighbours), so + // wait for it rather than mesh once per neighbour. Columns still + // in `dirty_light` here can't be lit yet (a neighbour of theirs is + // missing): waiting for them could last until the player comes + // back. + let ready = (-1..=1).all(|dz| { + (-1..=1).all(|dx| { + let n = (x + dx, z + dz); + self.lit.contains(&n) && !self.lighting.contains_key(&n) }) }); if !ready { continue; } - let region = columns - .entry((x, z)) - .or_insert_with(|| Self::region(world, x, z)); - let Some(region) = region.clone() else { + let Some(region) = Self::region(world, x, z) else { continue; }; - world.dirty_sections.remove(&(x, sy, z)); - let first = self.meshed.insert((x, z)); - self.sequence += 1; - self.meshing.insert((x, sy, z), self.sequence); - self.submit( - self.distance(x, z) * 4 + if first { 2 } else { 0 }, - Job::Mesh( - x, - sy, - z, - region, - self.sequence, - MeshSettings { - nether: self.nether_shading, - zoom: self.biome_zoom, - blend_radius: self.biome_blend, - smooth_lighting: self.smooth_lighting, - cutout_leaves: self.cutout_leaves, - cull_leaves: self.cull_leaves, - }, - ), - ); + world.dirty_sections.take_column(x, z); + for sy in section_indexes(sections) { + let first = self.meshed.insert((x, z)); + self.sequence += 1; + self.meshing.insert((x, sy, z), self.sequence); + self.submit( + self.distance(x, z) * 4 + if first { 2 } else { 0 }, + Job::Mesh( + x, + sy, + z, + region.clone(), + self.sequence, + MeshSettings { + nether: self.nether_shading, + zoom: self.biome_zoom, + blend_radius: self.biome_blend, + smooth_lighting: self.smooth_lighting, + cutout_leaves: self.cutout_leaves, + cull_leaves: self.cull_leaves, + }, + ), + ); + } } (uploads, removed) } @@ -1355,6 +1354,16 @@ impl Drop for Streaming { } } } +/// The section indexes set in a column's bits, lowest first. +fn section_indexes(mut bits: u32) -> impl Iterator<Item = i32> { + std::iter::from_fn(move || { + (bits != 0).then(|| { + let sy = bits.trailing_zeros() as i32; + bits &= bits - 1; + sy + }) + }) +} #[cfg(test)] mod tests { use super::*; diff --git a/crates/horizon-client/src/world.rs b/crates/horizon-client/src/world.rs index efcbf9591..350201e5e 100644 --- a/crates/horizon-client/src/world.rs +++ b/crates/horizon-client/src/world.rs @@ -8,6 +8,46 @@ use std::{ sync::Arc, }; +/// Sections (x, section index, z) waiting to be remeshed, kept by column +/// (a bit per section index), so the mesh scheduler looks at each column once +/// rather than at every section of it. +#[derive(Clone, Debug, Default)] +pub struct DirtySections { + columns: crate::fast_hash::FxHashMap<(i32, i32), u32>, +} +const _: () = assert!(SECTIONS <= 32); +impl DirtySections { + pub fn insert(&mut self, (x, sy, z): (i32, i32, i32)) { + debug_assert!((0..SECTIONS as i32).contains(&sy)); + *self.columns.entry((x, z)).or_default() |= 1 << sy; + } + pub fn contains(&self, &(x, sy, z): &(i32, i32, i32)) -> bool { + (0..SECTIONS as i32).contains(&sy) + && self.columns.get(&(x, z)).is_some_and(|m| m & 1 << sy != 0) + } + /// The dirty section indexes of column (x, z), as bits, removed. + pub fn take_column(&mut self, x: i32, z: i32) -> u32 { + self.columns.remove(&(x, z)).unwrap_or(0) + } + /// Keep the columns `keep` accepts. + pub fn retain_columns(&mut self, mut keep: impl FnMut(i32, i32) -> bool) { + self.columns.retain(|&(x, z), _| keep(x, z)); + } + /// The columns holding dirty sections, with their section bits. + pub fn columns(&self) -> impl Iterator<Item = ((i32, i32), u32)> + '_ { + self.columns.iter().map(|(&c, &m)| (c, m)) + } + pub fn clear(&mut self) { + self.columns.clear(); + } + pub fn is_empty(&self) -> bool { + self.columns.is_empty() + } + /// How many sections are dirty. + pub fn len(&self) -> usize { + self.columns.values().map(|m| m.count_ones() as usize).sum() + } +} pub struct World { pub fast_lava: bool, pub chunks: crate::chunk_map::ChunkMap, @@ -16,7 +56,7 @@ pub struct World { pub health_rules: crate::health::HealthRules, pub air: BlockStateId, /// Sections whose geometry changed and need remeshing. - pub dirty_sections: crate::fast_hash::FxHashSet<(i32, i32, i32)>, + pub dirty_sections: DirtySections, /// Chunks whose light must be recomputed. pub dirty_light: crate::fast_hash::FxHashSet<(i32, i32)>, /// Edits on lit chunks (position, old state, new state), relit From 8f8db8096b763d6433909ad558e9ba54afbb4241 Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Sun, 18 Oct 2026 06:26:49 -0400 Subject: [PATCH 099/163] Preserve non-heart block entities until normal removal --- crates/horizon-client/src/game/creaking.rs | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/crates/horizon-client/src/game/creaking.rs b/crates/horizon-client/src/game/creaking.rs index 1df29a3e4..d75becb8d 100644 --- a/crates/horizon-client/src/game/creaking.rs +++ b/crates/horizon-client/src/game/creaking.rs @@ -220,6 +220,12 @@ impl Game<'_> { /// death and a natural heart drops experience. pub(super) fn creaking_heart_broken(&mut self, pos: [i32; 3]) { let key = (pos[0], pos[1], pos[2]); + if !matches!( + self.world.block_entities.get(&key), + Some(BlockEntity::CreakingHeart(_)) + ) { + return; + } let Some(BlockEntity::CreakingHeart(mut heart)) = self.world.block_entities.take(&key) else { return; From 0bc5f4263c68cd76a4d9df01550a446fe8923067 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 12:00:57 +0200 Subject: [PATCH 100/163] save_bench: time the region writer on a saved world's chunks Reads every chunk of a saved dimension, then times SaveDir's save_later and flush against the same encoding and compression done on one thread, and checks the written chunks byte for byte. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/examples/save_bench.rs | 128 +++++++++++++++++++ 1 file changed, 128 insertions(+) create mode 100644 crates/horizon-client/examples/save_bench.rs diff --git a/crates/horizon-client/examples/save_bench.rs b/crates/horizon-client/examples/save_bench.rs new file mode 100644 index 000000000..2e3084290 --- /dev/null +++ b/crates/horizon-client/examples/save_bench.rs @@ -0,0 +1,128 @@ +//! The region writer on real chunks, without a window: how long a world's +//! chunks take to be encoded, compressed and written by `SaveDir`, against +//! the same encoding and compression done one chunk after another (what the +//! writer thread did alone before it had helpers). +//! +//! save_bench RESOURCES DIMENSION_DIR [--rounds N] +//! +//! DIMENSION_DIR is a saved dimension folder (`saves/W/dimensions/minecraft/ +//! overworld`); its chunks are read once, then each round saves them all into +//! a scratch folder with `save_later` + `flush`, and times the one-thread +//! baseline. The written chunks are checked byte for byte against the +//! baseline's compressed records. +use horizon_client::{ + assets::Assets, + biome::Biomes, + blocks::BlockFacts, + save::{SaveDir, SaveTables, encode_with}, +}; +use horizon_core::position::ChunkPos; +use horizon_world::{ + compression::Compression, + nbt::Limits, + region::{ChunkRecord, RegionFile}, +}; +use std::{path::PathBuf, sync::Arc, time::Instant}; + +type Result<T> = std::result::Result<T, Box<dyn std::error::Error>>; + +fn main() -> Result<()> { + let args: Vec<String> = std::env::args().skip(1).collect(); + let usage = "usage: save_bench RESOURCES DIMENSION_DIR [--rounds N]"; + let root = PathBuf::from(args.first().ok_or(usage)?); + let dimension = PathBuf::from(args.get(1).ok_or(usage)?); + let rounds: usize = args + .iter() + .position(|a| a == "--rounds") + .and_then(|i| args.get(i + 1)) + .and_then(|v| v.parse().ok()) + .unwrap_or(5); + + let assets = Assets::load(&root)?; + let facts = BlockFacts::load(&root, assets.registry)?; + let biomes = Arc::new(Biomes::load(&root)?); + let tables = Arc::new(SaveTables::new(&assets).with_block_entities(&facts)); + let registry = assets.registry; + + let source = SaveDir::new(dimension.clone()); + let _ = source.tables.set(tables.clone()); + let mut chunks = Vec::new(); + for entry in std::fs::read_dir(dimension.join("region"))? { + let path = entry?.path(); + if path.extension().is_none_or(|e| e != "mca") { + continue; + } + let region = RegionFile::open(&path)?; + for (pos, _) in region.chunks() { + if let Some(chunk) = source.load(pos.x, pos.z, registry, &biomes) { + chunks.push(Arc::new(chunk)); + } + } + } + chunks.sort_by_key(|c| (c.x, c.z)); + println!("{} chunks from {}", chunks.len(), dimension.display()); + + let scratch = std::env::temp_dir().join(format!("save_bench_{}", std::process::id())); + // Encoding and compressing on one thread (what the writer did alone), + // then SaveDir's writer with its helpers. + let mut times = [Vec::new(), Vec::new(), Vec::new()]; + let mut written = Vec::new(); + for round in 0..rounds { + let started = Instant::now(); + let tags: Vec<_> = chunks + .iter() + .map(|c| encode_with(c, registry, &biomes, Some(&tables), true)) + .collect(); + times[0].push(started.elapsed().as_secs_f64()); + let started = Instant::now(); + let baseline: Vec<ChunkRecord> = tags + .iter() + .map(|tag| ChunkRecord::from_nbt(tag, Compression::Zlib, 0, Limits::default())) + .collect::<std::io::Result<_>>()?; + times[1].push(started.elapsed().as_secs_f64()); + drop(tags); + + let _ = std::fs::remove_dir_all(&scratch); + let save = SaveDir::new(scratch.clone()); + let _ = save.tables.set(tables.clone()); + let started = Instant::now(); + save.save_later(&chunks, registry, &biomes)?; + save.flush(); + times[2].push(started.elapsed().as_secs_f64()); + drop(save); + + if round == 0 { + for (chunk, want) in chunks.iter().zip(&baseline) { + let path = scratch.join(format!("region/r.{}.{}.mca", chunk.x >> 5, chunk.z >> 5)); + let got = RegionFile::open(&path)? + .read(ChunkPos::new(chunk.x, chunk.z))? + .ok_or("a saved chunk is missing")?; + if got.compressed != want.compressed { + return Err(format!("chunk {} {} differs", chunk.x, chunk.z).into()); + } + } + written = baseline.iter().map(|r| r.compressed.len()).collect(); + } + } + let _ = std::fs::remove_dir_all(&scratch); + println!( + "{} KiB compressed, identical to the one-thread records", + written.iter().sum::<usize>() / 1024 + ); + let per_chunk = 1000.0 / chunks.len() as f64; + let names = [ + "one thread: encode", + "one thread: compress", + "SaveDir (encode, compress, write)", + ]; + for (name, t) in names.iter().zip(&mut times) { + t.sort_by(f64::total_cmp); + println!( + "{name}: best {:.0} ms, median {:.0} ms of {rounds} ({:.3} ms per chunk at best)", + t[0] * 1000.0, + t[t.len() / 2] * 1000.0, + t[0] * per_chunk + ); + } + Ok(()) +} From bfa622bbdec711618b8516a1d7dbe164265b471a Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 13:21:13 +0200 Subject: [PATCH 101/163] Server: send entity attributes to clients ClientboundUpdateAttributesPacket, as vanilla's ServerEntity sends it: every client-syncable instance when an entity is paired, the changed ones with the dirty entity data, and a player's dirty set to the player itself. - Mobs and armor stands report the instances vanilla would have created (movement speed, finalizeSpawn's bases and modifiers, the baby modifier, effects', equipment's and /attribute's), players their LiveAttributes. - Guests get the per-tick movement speed instance and the creative reach modifiers (ServerPlayer.updatePlayerAttributes). - cube::set_size sets the attribute bases as AbstractCubeMob.setSize does, so a summoned slime has its size's health and speed. - server_entities compares attributes again, the player's own too, with a slime and a scaled pig in its scene. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/examples/lan_flat.rs | 1 + crates/horizon-client/src/effects.rs | 139 ++++----- crates/horizon-client/src/entity_nbt.rs | 7 +- crates/horizon-client/src/game.rs | 1 + crates/horizon-client/src/game/lan.rs | 5 + crates/horizon-client/src/game/lan_actions.rs | 1 + .../horizon-client/src/game/lan_attributes.rs | 274 ++++++++++++++++++ .../horizon-client/src/game/lan_entities.rs | 2 + crates/horizon-client/src/lan/attributes.rs | 143 +++++++++ crates/horizon-client/src/lan/entity.rs | 113 ++++++-- crates/horizon-client/src/lan/hub.rs | 22 ++ crates/horizon-client/src/lan/mod.rs | 1 + crates/horizon-client/src/mobs/cube.rs | 20 +- crates/horizon-client/src/mobs/finalize.rs | 16 +- crates/horizon-client/tests/lan_bot.rs | 2 + crates/horizon-protocol/src/packets/play.rs | 58 ++++ crates/horizon-world/src/attributes/entity.rs | 9 + .../horizonlab/parity/EntityTranscript.java | 19 +- .../parity/VanillaProtocolClient.java | 2 +- tools/test_server_entities_parity.py | 41 ++- 20 files changed, 754 insertions(+), 122 deletions(-) create mode 100644 crates/horizon-client/src/game/lan_attributes.rs create mode 100644 crates/horizon-client/src/lan/attributes.rs diff --git a/crates/horizon-client/examples/lan_flat.rs b/crates/horizon-client/examples/lan_flat.rs index 20d87e03c..aae3be203 100644 --- a/crates/horizon-client/examples/lan_flat.rs +++ b/crates/horizon-client/examples/lan_flat.rs @@ -101,6 +101,7 @@ fn main() -> Result<(), Box<dyn std::error::Error>> { sprinting: false, equipment: Default::default(), health: 20.0, + attributes: Vec::new(), }; loop { world.game_time += 1; diff --git a/crates/horizon-client/src/effects.rs b/crates/horizon-client/src/effects.rs index a258ccf3a..17dce93ab 100644 --- a/crates/horizon-client/src/effects.rs +++ b/crates/horizon-client/src/effects.rs @@ -336,73 +336,8 @@ impl PlayerEffects { pub fn modifiers(&self) -> Vec<(&'static str, &'static str, f64, &'static str)> { let mut out = Vec::new(); for e in &self.list { - let level = f64::from(e.amplifier + 1); - let m = match e.id { - "speed" => Some(( - "minecraft:movement_speed", - "minecraft:effect.speed", - 0.2, - "add_multiplied_total", - )), - "slowness" => Some(( - "minecraft:movement_speed", - "minecraft:effect.slowness", - -0.15, - "add_multiplied_total", - )), - "haste" => Some(( - "minecraft:attack_speed", - "minecraft:effect.haste", - 0.1, - "add_multiplied_total", - )), - "mining_fatigue" => Some(( - "minecraft:attack_speed", - "minecraft:effect.mining_fatigue", - -0.1, - "add_multiplied_total", - )), - "strength" => Some(( - "minecraft:attack_damage", - "minecraft:effect.strength", - 3.0, - "add_value", - )), - "weakness" => Some(( - "minecraft:attack_damage", - "minecraft:effect.weakness", - -4.0, - "add_value", - )), - "jump_boost" => Some(( - "minecraft:safe_fall_distance", - "minecraft:effect.jump_boost", - 1.0, - "add_value", - )), - "health_boost" => Some(( - "minecraft:max_health", - "minecraft:effect.health_boost", - 4.0, - "add_value", - )), - "absorption" => Some(( - "minecraft:max_absorption", - "minecraft:effect.absorption", - 4.0, - "add_value", - )), - "luck" => Some(("minecraft:luck", "minecraft:effect.luck", 1.0, "add_value")), - "unluck" => Some(( - "minecraft:luck", - "minecraft:effect.unluck", - -1.0, - "add_value", - )), - _ => None, - }; - if let Some((a, id, amount, op)) = m { - out.push((a, id, amount * level, op)); + if let Some((a, id, amount, op)) = effect_modifier(e.id) { + out.push((a, id, amount * f64::from(e.amplifier + 1), op)); } } out @@ -445,6 +380,76 @@ impl StatusFlags { } } +/// The attribute modifier an effect adds at amplifier 0 +/// (`MobEffect.addAttributeModifier`): (attribute, id, amount, operation). +/// Each level multiplies the amount (`amplifier + 1`). +pub fn effect_modifier(effect: &str) -> Option<(&'static str, &'static str, f64, &'static str)> { + match effect { + "speed" => Some(( + "minecraft:movement_speed", + "minecraft:effect.speed", + 0.2, + "add_multiplied_total", + )), + "slowness" => Some(( + "minecraft:movement_speed", + "minecraft:effect.slowness", + -0.15, + "add_multiplied_total", + )), + "haste" => Some(( + "minecraft:attack_speed", + "minecraft:effect.haste", + 0.1, + "add_multiplied_total", + )), + "mining_fatigue" => Some(( + "minecraft:attack_speed", + "minecraft:effect.mining_fatigue", + -0.1, + "add_multiplied_total", + )), + "strength" => Some(( + "minecraft:attack_damage", + "minecraft:effect.strength", + 3.0, + "add_value", + )), + "weakness" => Some(( + "minecraft:attack_damage", + "minecraft:effect.weakness", + -4.0, + "add_value", + )), + "jump_boost" => Some(( + "minecraft:safe_fall_distance", + "minecraft:effect.jump_boost", + 1.0, + "add_value", + )), + "health_boost" => Some(( + "minecraft:max_health", + "minecraft:effect.health_boost", + 4.0, + "add_value", + )), + "absorption" => Some(( + "minecraft:max_absorption", + "minecraft:effect.absorption", + 4.0, + "add_value", + )), + "luck" => Some(("minecraft:luck", "minecraft:effect.luck", 1.0, "add_value")), + "unluck" => Some(( + "minecraft:luck", + "minecraft:effect.unluck", + -1.0, + "add_value", + )), + _ => None, + } +} + #[cfg(test)] mod tests { use super::*; diff --git a/crates/horizon-client/src/entity_nbt.rs b/crates/horizon-client/src/entity_nbt.rs index d627dc363..ee86211a1 100644 --- a/crates/horizon-client/src/entity_nbt.rs +++ b/crates/horizon-client/src/entity_nbt.rs @@ -840,9 +840,12 @@ pub fn mob_from_nbt(tag: &Tag, types: &HashMap<String, Arc<MobType>>, id: u32) - m.species(), crate::mobs::Species::Slime | crate::mobs::Species::MagmaCube ) { - let health = m.health; + // AbstractCubeMob.readAdditionalSaveData: the size's attributes, then + // the saved health, the max health when there is none. crate::mobs::cube::set_size(&mut m, number(tag.get("Size")).unwrap_or(0) as i32 + 1); - m.health = health; + if let Some(h) = float(tag.get("Health")) { + m.health = h as f32; + } m.extra.flag2 = flag(tag, "wasOnGround"); } // Zombie, Piglin and Zoglin.readAdditionalSaveData: IsBaby (the baby diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 68058cbeb..568115b71 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -64,6 +64,7 @@ mod item_particles; mod jukebox; mod lan; mod lan_actions; +mod lan_attributes; mod lan_chat; mod lan_crafting; mod lan_entities; diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index d35bf787a..5659793ed 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -722,6 +722,7 @@ impl Game<'_> { sprinting: p.sprinting, equipment, health: p.health.health(), + attributes: horizon_client::lan::attributes::syncable(&p.attributes), }) } @@ -732,6 +733,7 @@ impl Game<'_> { let kind = m.kind.id.as_str(); let meta = mob_meta(m, hub); let equipment = mob_equipment(m, hub); + let attributes = self.mob_attributes(m); let (yaw, pitch) = (m.yaw, m.head_pitch); out.push(EntityState { id: m.id as i32, @@ -746,6 +748,7 @@ impl Game<'_> { data: 0, meta, equipment, + attributes, precise: false, }); } @@ -764,6 +767,7 @@ impl Game<'_> { data: 0, meta: vec![(8, serializer::ITEM_STACK, Value::Item(stack))], equipment: Vec::new(), + attributes: Vec::new(), precise: false, }); } @@ -782,6 +786,7 @@ impl Game<'_> { // ExperienceOrb.DATA_VALUE. meta: vec![(8, serializer::INT, Value::Int(o.value as i32))], equipment: Vec::new(), + attributes: Vec::new(), precise: false, }); } diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index ced435d8d..6963ad460 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -1149,6 +1149,7 @@ impl Game<'_> { self.as_guest(host, conn, |g| { g.count_tick_stats(sleeping); g.tick_advancements(); + g.update_player_attributes(); }); host.hub.flush_progress(conn); self.guest_dig_feedback(host, conn); diff --git a/crates/horizon-client/src/game/lan_attributes.rs b/crates/horizon-client/src/game/lan_attributes.rs new file mode 100644 index 000000000..9a324e332 --- /dev/null +++ b/crates/horizon-client/src/game/lan_attributes.rs @@ -0,0 +1,274 @@ +//! The attribute instances a server syncs for the living entities it tracks +//! (`ClientboundUpdateAttributesPacket`, lan/attributes.rs): the ones +//! vanilla's `AttributeMap` would have created by then, since only those are +//! sent, never the type's other defaults. +use super::Game; +use super::commands::Target; +use horizon_client::{ + effects, + lan::attributes::{add_modifier, generic_syncable, instance, operation_named}, + mobs::{ + Mob, + finalize::{self, Attr, Op}, + }, +}; +use horizon_protocol::packets::play::{AttributeModifier, AttributeSnapshot}; +use std::sync::Arc; + +/// `EquipmentSlotGroup.test`: whether a modifier's slot group covers a slot. +fn slot_in_group(group: &str, slot: &str) -> bool { + group == slot + || group == "any" + || (group == "hand" && matches!(slot, "mainhand" | "offhand")) + || (group == "armor" && matches!(slot, "feet" | "legs" | "chest" | "head" | "body")) +} + +impl Game<'_> { + /// The registry id of a client-syncable attribute the entity type has + /// (`AttributeMap.getInstance` is null for the others), by name. + fn synced_attribute(&self, entity: &str, name: &str) -> Option<i32> { + let catalog = &self.motion.attributes; + let id = catalog.id(name)?; + (catalog.attribute(id).syncable && catalog.default_base(entity, id).is_some()) + .then(|| id.registry_id()) + } + + /// The type's base value of an attribute, as the instance starts. + fn attribute_default(&self, entity: &str, name: &str) -> f64 { + let catalog = &self.motion.attributes; + catalog + .id(name) + .and_then(|id| catalog.default_base(entity, id)) + .unwrap_or(0.0) + } + + /// `LivingEntity.collectEquipmentChanges`: each worn or held item's + /// attribute modifiers, slot by slot in `EquipmentSlot` order, create + /// their instances (an instance without a modifier keeps its base). + fn equipment_attributes<'a>( + &self, + entity: &str, + base: impl Fn(&str) -> Option<f64>, + slots: impl IntoIterator<Item = (&'static str, Option<&'a Arc<str>>)>, + out: &mut Vec<AttributeSnapshot>, + ) { + for (slot, item) in slots { + let Some(info) = item.and_then(|i| self.res.items.get(i)) else { + continue; + }; + for (attribute, id, amount, op, group) in &info.modifiers { + if !slot_in_group(group, slot) { + continue; + } + let Some(a) = self.synced_attribute(entity, attribute) else { + continue; + }; + let start = + base(attribute).unwrap_or_else(|| self.attribute_default(entity, attribute)); + add_modifier( + out, + a, + start, + AttributeModifier { + id: id.clone(), + amount: *amount, + operation: operation_named(op), + }, + ); + } + } + } + + /// A mob's synced instances: movement speed (its first `aiStep` reads it, + /// `LivingEntity.removeFrost`), what finalizeSpawn set, the baby speed + /// modifier, its effects' modifiers, its equipment's, and what + /// `/attribute` changed. + pub(super) fn mob_attributes(&self, m: &Mob) -> Vec<AttributeSnapshot> { + let kind = m.kind.id.as_str(); + let mut out = Vec::new(); + if let Some(a) = self.synced_attribute(kind, "minecraft:movement_speed") { + instance(&mut out, a, finalize::base_value(m, Attr::MovementSpeed)); + } + if let Some(s) = m.extra.attributes.as_deref() { + for (attr, v) in &s.bases { + if let Some(a) = self.synced_attribute(kind, &format!("minecraft:{}", attr.name())) + { + instance(&mut out, a, *v).base = *v; + } + } + for x in &s.modifiers { + if let Some(a) = + self.synced_attribute(kind, &format!("minecraft:{}", x.attr.name())) + { + add_modifier( + &mut out, + a, + finalize::base_value(m, x.attr), + AttributeModifier { + id: x.id.to_owned(), + amount: x.amount, + operation: match x.op { + Op::AddValue => 0, + Op::AddMultipliedBase => 1, + Op::AddMultipliedTotal => 2, + }, + }, + ); + } + } + } + if let (Some(a), Some((amount, Op::AddMultipliedBase))) = ( + self.synced_attribute(kind, "minecraft:movement_speed"), + finalize::transient(m, Attr::MovementSpeed), + ) { + add_modifier( + &mut out, + a, + finalize::base_value(m, Attr::MovementSpeed), + AttributeModifier { + id: "minecraft:baby".into(), + amount, + operation: 1, + }, + ); + } + let base = |name: &str| { + Attr::ALL + .into_iter() + .find(|a| name.strip_prefix("minecraft:") == Some(a.name())) + .map(|a| finalize::base_value(m, a)) + }; + // LivingEntity.onEffectAdded: MobEffect.addAttributeModifiers. + for &(effect, _, amplifier) in &m.extra.effects { + let Some((attribute, id, amount, op)) = + effects::effect_modifier(effect.trim_start_matches("minecraft:")) + else { + continue; + }; + let Some(a) = self.synced_attribute(kind, attribute) else { + continue; + }; + let start = base(attribute).unwrap_or_else(|| self.attribute_default(kind, attribute)); + add_modifier( + &mut out, + a, + start, + AttributeModifier { + id: id.to_owned(), + amount: amount * f64::from(amplifier + 1), + operation: operation_named(op), + }, + ); + } + let e = &m.extra; + self.equipment_attributes( + kind, + base, + [ + ("mainhand", e.main_hand.as_ref()), + ("offhand", e.off_hand.as_ref()), + ("feet", e.feet.as_ref()), + ("legs", e.legs.as_ref()), + ("chest", e.chest.as_ref()), + ("head", e.head.as_ref()), + ], + &mut out, + ); + self.generic_attributes_of(Target::Mob(m.id), &mut out); + out + } + + /// An armor stand's synced instances: movement speed (its first + /// `aiStep`), its equipment's modifiers and what `/attribute` changed. + pub(super) fn stand_attributes( + &self, + id: u32, + equipment: &[Option<horizon_client::items::ItemStack>; 6], + ) -> Vec<AttributeSnapshot> { + const KIND: &str = "minecraft:armor_stand"; + let mut out = Vec::new(); + if let Some(a) = self.synced_attribute(KIND, "minecraft:movement_speed") { + instance( + &mut out, + a, + self.attribute_default(KIND, "minecraft:movement_speed"), + ); + } + let slots = horizon_client::entities::ArmorStand::SLOTS + .into_iter() + .zip(equipment.iter().map(|s| s.as_ref().map(|s| &s.item))); + self.equipment_attributes(KIND, |_| None, slots, &mut out); + self.generic_attributes_of(Target::Stand(id), &mut out); + out + } + + /// The instances a server player's tick creates, and + /// `ServerPlayer.updatePlayerAttributes`: a creative player reaches 0.5 + /// further to blocks and 2 to entities. Its client reads the reach from + /// these synced modifiers. (The crouching player's waypoint range is + /// server-side only: lan_waypoints.rs hides it.) + pub(super) fn update_player_attributes(&mut self) { + let creative = self.mode_id() == 1; + let Some(p) = self.player.as_mut() else { + return; + }; + // LivingEntity.aiStep's removeFrost reads the movement speed instance + // every tick, which creates it (and its first sync). + if let Some(key) = p.attributes.key("minecraft:movement_speed") { + let _ = p.attributes.get_instance(Some(key)); + } + for (attribute, id, amount) in [ + ( + "minecraft:block_interaction_range", + "minecraft:creative_mode_block_range", + 0.5, + ), + ( + "minecraft:entity_interaction_range", + "minecraft:creative_mode_entity_range", + 2.0, + ), + ] { + let Some(key) = p.attributes.key(attribute) else { + continue; + }; + // getAttribute creates the instance, a creative player's or not. + if !matches!(p.attributes.get_instance(Some(key.clone())), Ok(Some(_))) { + continue; + } + // addOrUpdateTransientModifier with the same modifier and + // removeModifier of a missing one leave the instance clean. + let has = p.attributes.has_modifier(Some(key), id).unwrap_or(false); + if has != creative { + let _ = p.set_modifier(attribute, id, amount, "add_value", creative); + } + } + } + + /// The instances `/attribute` created in an entity's generic map + /// replace the ones derived from its state. + fn generic_attributes_of(&self, t: Target, out: &mut Vec<AttributeSnapshot>) { + let Some(map) = self.cmds.attributes.get(&t) else { + return; + }; + for s in generic_syncable(map) { + let (attribute, base) = (s.attribute, s.base); + *instance(out, attribute, base) = s; + } + } +} + +#[cfg(test)] +mod tests { + use super::slot_in_group; + + #[test] + fn slot_groups_cover_their_slots() { + assert!(slot_in_group("head", "head")); + assert!(slot_in_group("armor", "chest")); + assert!(!slot_in_group("armor", "mainhand")); + assert!(slot_in_group("hand", "offhand")); + assert!(slot_in_group("any", "feet")); + assert!(!slot_in_group("mainhand", "offhand")); + } +} diff --git a/crates/horizon-client/src/game/lan_entities.rs b/crates/horizon-client/src/game/lan_entities.rs index 3ea172482..7a1236e52 100644 --- a/crates/horizon-client/src/game/lan_entities.rs +++ b/crates/horizon-client/src/game/lan_entities.rs @@ -37,6 +37,7 @@ fn state(id: u32, kind: &str, position: [f64; 3], yaw: f32, on_ground: bool) -> data: 0, meta: Vec::new(), equipment: Vec::new(), + attributes: Vec::new(), precise: false, } } @@ -179,6 +180,7 @@ impl Game<'_> { e.equipment.push((slot as u8, hub.stack(item))); } } + e.attributes = self.stand_attributes(a.id, &a.equipment); out.push(e); } for f in &self.item_frames { diff --git a/crates/horizon-client/src/lan/attributes.rs b/crates/horizon-client/src/lan/attributes.rs new file mode 100644 index 000000000..bc208b6f9 --- /dev/null +++ b/crates/horizon-client/src/lan/attributes.rs @@ -0,0 +1,143 @@ +//! `ClientboundUpdateAttributesPacket`: the attribute instances a server syncs +//! to its clients. `ServerEntity.sendPairingData` sends every client-syncable +//! instance an entity has (`AttributeMap.getSyncableAttributes`: the instances +//! created so far, not the type's defaults), `sendDirtyEntityData` the ones +//! changed since (`getAttributesToSync`), to the trackers and the player itself. +use horizon_protocol::packets::play::{AttributeModifier, AttributeSnapshot}; +use horizon_world::attributes::{ + Instance, Operation, + entity::{AttributeId, EntityAttributes}, + live::LiveAttributes, +}; + +/// `AttributeModifier.Operation.id`. +pub fn operation_id(op: Operation) -> i32 { + match op { + Operation::AddValue => 0, + Operation::AddMultipliedBase => 1, + Operation::AddMultipliedTotal => 2, + } +} + +/// An `Operation`'s serialized name (`add_value` ...) as its id. +pub fn operation_named(name: &str) -> i32 { + match name { + "add_multiplied_base" => 1, + "add_multiplied_total" => 2, + _ => 0, + } +} + +/// `AttributeSnapshot`: the base and every modifier, in the order they were added. +pub fn snapshot(attribute: AttributeId, instance: &Instance) -> AttributeSnapshot { + AttributeSnapshot { + attribute: attribute.registry_id(), + base: instance.base_value(), + modifiers: instance + .modifiers() + .iter() + .map(|m| AttributeModifier { + id: m.id().to_owned(), + amount: m.amount(), + operation: operation_id(m.operation()), + }) + .collect(), + } +} + +/// `AttributeMap.getSyncableAttributes` of a live map (a player's). +pub fn syncable<G: FnMut() -> i32>(map: &LiveAttributes<G>) -> Vec<AttributeSnapshot> { + let catalog = map.catalog(); + map.instances() + .filter(|(_, key, _)| catalog.attribute(key.attribute()).syncable) + .map(|(_, key, instance)| snapshot(key.attribute(), instance)) + .collect() +} + +/// `getAttributesToSync`, cleared once read (`ServerEntity.sendDirtyEntityData`). +pub fn take_dirty<G: FnMut() -> i32>(map: &mut LiveAttributes<G>) -> Vec<AttributeSnapshot> { + if map.sync().is_empty() { + return Vec::new(); + } + let handles: Vec<_> = map.sync().values().flatten().cloned().collect(); + map.sync_mut().clear(); + handles + .iter() + .filter_map(|h| { + let key = map.attribute(h).ok()?; + Some(snapshot(key.attribute(), map.instance(h).ok()?)) + }) + .collect() +} + +/// The client-syncable instances of a generic attribute map. +pub fn generic_syncable(map: &EntityAttributes) -> impl Iterator<Item = AttributeSnapshot> + '_ { + let catalog = map.catalog(); + catalog + .attributes() + .filter(|(_, a)| a.syncable) + .filter_map(move |(id, _)| map.instance(id).map(|i| snapshot(id, i))) +} + +/// Adds a modifier to the snapshot of `attribute`, creating it with `base`. +pub fn add_modifier( + out: &mut Vec<AttributeSnapshot>, + attribute: i32, + base: f64, + modifier: AttributeModifier, +) { + let snapshot = instance(out, attribute, base); + match snapshot.modifiers.iter_mut().find(|m| m.id == modifier.id) { + Some(m) => *m = modifier, + None => snapshot.modifiers.push(modifier), + } +} + +/// The snapshot of `attribute`, created with `base` if it isn't there yet. +pub fn instance( + out: &mut Vec<AttributeSnapshot>, + attribute: i32, + base: f64, +) -> &mut AttributeSnapshot { + let i = match out.iter().position(|a| a.attribute == attribute) { + Some(i) => i, + None => { + out.push(AttributeSnapshot { + attribute, + base, + modifiers: Vec::new(), + }); + out.len() - 1 + } + }; + &mut out[i] +} + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn modifiers_replace_by_id_and_instances_are_created_once() { + let mut out = Vec::new(); + let m = |id: &str, amount| AttributeModifier { + id: id.into(), + amount, + operation: 0, + }; + add_modifier(&mut out, 1, 0.0, m("minecraft:armor.helmet", 3.0)); + add_modifier(&mut out, 1, 5.0, m("minecraft:armor.chestplate", 8.0)); + add_modifier(&mut out, 1, 5.0, m("minecraft:armor.helmet", 2.0)); + assert_eq!(out.len(), 1); + assert_eq!(out[0].base, 0.0); + assert_eq!( + out[0].modifiers, + [ + m("minecraft:armor.helmet", 2.0), + m("minecraft:armor.chestplate", 8.0) + ] + ); + instance(&mut out, 26, 0.7); + assert_eq!(out.len(), 2); + } +} diff --git a/crates/horizon-client/src/lan/entity.rs b/crates/horizon-client/src/lan/entity.rs index 3d8090267..45688e52c 100644 --- a/crates/horizon-client/src/lan/entity.rs +++ b/crates/horizon-client/src/lan/entity.rs @@ -11,12 +11,28 @@ use horizon_protocol::{ entity_data::Value, item::Stack, packets::play::{ - self, AddEntity, EntityPositionSync, MoveEntity, MoveEntityPos, MoveEntityPosRot, - MoveEntityRot, PositionPath, RotateHead, SetEntityData, SetEntityMotion, SetEquipment, - SetPassengers, VecDelta, + self, AddEntity, AttributeSnapshot, EntityPositionSync, MoveEntity, MoveEntityPos, + MoveEntityPosRot, MoveEntityRot, PositionPath, RotateHead, SetEntityData, SetEntityMotion, + SetEquipment, SetPassengers, UpdateAttributes, VecDelta, }, }; +/// The attribute instances of `now` that differ from what `sent` held (an +/// instance is never removed: one that disappears is left as it was sent). +pub fn changed_attributes( + now: &[AttributeSnapshot], + sent: &[AttributeSnapshot], +) -> Vec<AttributeSnapshot> { + now.iter() + .filter(|a| { + sent.iter() + .find(|b| b.attribute == a.attribute) + .is_none_or(|b| b != *a) + }) + .cloned() + .collect() +} + /// What the game says about one entity this tick. #[derive(Clone, Debug)] pub struct EntityState { @@ -37,6 +53,9 @@ pub struct EntityState { /// EquipmentSlot ordinals (0 main hand, 1 off hand, 2 feet, 3 legs, /// 4 chest, 5 head, 6 body, 7 saddle) and their stacks. pub equipment: Vec<(u8, Option<Stack>)>, + /// A living entity's client-syncable attribute instances + /// (`AttributeMap.getSyncableAttributes`), by registry id. + pub attributes: Vec<AttributeSnapshot>, /// `Entity.getRequiresPrecisePosition` (primed TNT and falling blocks /// touching a block): moves are sent as full position syncs. pub precise: bool, @@ -117,6 +136,8 @@ struct ServerEntity { /// trackedDataValues: the entity data the clients hold. meta: Vec<(u8, i32, Value)>, equipment: Vec<(u8, Option<Stack>)>, + /// The attribute instances the clients hold. + attributes: Vec<AttributeSnapshot>, was_on_ground: bool, tick: u32, teleport_delay: u32, @@ -153,6 +174,7 @@ impl ServerEntity { velocity: e.velocity, meta: e.meta.clone(), equipment: e.equipment.clone(), + attributes: e.attributes.clone(), was_on_ground: e.on_ground, tick: 0, teleport_delay: 0, @@ -190,6 +212,13 @@ impl ServerEntity { values: self.meta.clone(), })); } + // getSyncableAttributes: the instances as they are now. + if !e.attributes.is_empty() { + out.push(play::Clientbound::UpdateAttributes(UpdateAttributes { + id: e.id, + values: e.attributes.clone(), + })); + } if !self.equipment.is_empty() { out.push(play::Clientbound::SetEquipment(SetEquipment { id: e.id, @@ -342,24 +371,35 @@ impl ServerEntity { self.send_equipment(e, out); } - /// ServerEntity.sendDirtyEntityData. + /// ServerEntity.sendDirtyEntityData: the changed entity data, then the + /// attribute instances that changed since they were last sent + /// (`AttributeMap.getAttributesToSync`). fn send_dirty(&mut self, e: &EntityState, dirty: bool, out: &mut Vec<play::Clientbound>) { - if !dirty { - return; + if dirty { + let changed: Vec<_> = e + .meta + .iter() + .filter(|m| !self.meta.contains(m)) + .cloned() + .collect(); + if !changed.is_empty() { + out.push(play::Clientbound::SetEntityData(SetEntityData { + id: e.id, + values: changed, + })); + } + self.meta.clone_from(&e.meta); } - let changed: Vec<_> = e - .meta - .iter() - .filter(|m| !self.meta.contains(m)) - .cloned() - .collect(); - if !changed.is_empty() { - out.push(play::Clientbound::SetEntityData(SetEntityData { - id: e.id, - values: changed, - })); + if e.attributes != self.attributes { + let changed = changed_attributes(&e.attributes, &self.attributes); + if !changed.is_empty() { + out.push(play::Clientbound::UpdateAttributes(UpdateAttributes { + id: e.id, + values: changed, + })); + } + self.attributes.clone_from(&e.attributes); } - self.meta.clone_from(&e.meta); } fn send_head(&mut self, e: &EntityState, out: &mut Vec<play::Clientbound>) { @@ -601,6 +641,7 @@ mod tests { data: 0, meta: Vec::new(), equipment: Vec::new(), + attributes: Vec::new(), precise: false, } } @@ -697,6 +738,42 @@ mod tests { )); } + #[test] + fn attributes_pair_whole_then_send_the_changed_instances_when_due() { + let speed = |base| AttributeSnapshot { + attribute: 26, + base, + modifiers: Vec::new(), + }; + let armor = AttributeSnapshot { + attribute: 1, + base: 0.0, + modifiers: Vec::new(), + }; + let mut e = state(0.0); + e.attributes = vec![speed(0.23), armor]; + let mut s = added(&e); + let mut spawn = Vec::new(); + s.pairing(&e, 100, &Riding::default(), &mut spawn); + let Some(play::Clientbound::UpdateAttributes(p)) = spawn.get(1) else { + panic!("expected the attributes after the add"); + }; + assert_eq!(p.values, e.attributes); + changes(&mut s, &e); + e.attributes[0] = speed(0.3); + // Not due (a zombie's interval is 3): sendDirtyEntityData waits for the update. + assert!(changes(&mut s, &e).is_empty()); + assert!(changes(&mut s, &e).is_empty()); + let out = changes(&mut s, &e); + let Some(play::Clientbound::UpdateAttributes(p)) = out + .iter() + .find(|p| matches!(p, play::Clientbound::UpdateAttributes(_))) + else { + panic!("expected the changed attribute"); + }; + assert_eq!(p.values, vec![speed(0.3)]); + } + #[test] fn metadata_and_equipment_send_only_the_changes() { let mut e = state(0.0); diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index 5d593be2d..854b554ef 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -80,6 +80,8 @@ pub struct HostState { pub sprinting: bool, pub equipment: [Option<ItemStack>; 6], pub health: f32, + /// The host player's client-syncable attribute instances. + pub attributes: Vec<play::AttributeSnapshot>, } /// Everything the hub needs from the game for one tick. @@ -1378,6 +1380,7 @@ impl Hub { skin: u8, health: f32, equipment: Vec<(u8, Option<horizon_protocol::item::Stack>)>, + attributes: Vec<play::AttributeSnapshot>, ) -> EntityState { let (sneaking, sprinting, gliding, sleeping) = flags; let mut shared = 0i8; @@ -1425,6 +1428,7 @@ impl Hub { data: 0, meta, equipment, + attributes, precise: false, } } @@ -1472,6 +1476,7 @@ impl Hub { 0x7F, h.health, equipment, + h.attributes.clone(), )); } let placed: Vec<usize> = (0..self.guests.len()) @@ -1501,6 +1506,10 @@ impl Hub { g.info.model_customisation, g.health, equipment, + g.motion + .as_ref() + .map(|m| super::attributes::syncable(&m.attributes)) + .unwrap_or_default(), ) }) .collect(); @@ -1611,6 +1620,19 @@ impl Hub { self.flush_advancements(i, true); } } + // ServerEntity.sendDirtyEntityData: the player's changed attribute + // instances go to the player too (its trackers get them from + // track_entities). + let g = &mut self.guests[i]; + if let Some(m) = g.motion.as_mut() { + let values = super::attributes::take_dirty(&mut m.attributes); + if !values.is_empty() { + g.send(&C::UpdateAttributes(play::UpdateAttributes { + id: g.entity_id, + values, + })); + } + } // Sent when the health or the food level changes, or the saturation // reaches or leaves zero; a dead player's health of 0 too. let g = &mut self.guests[i]; diff --git a/crates/horizon-client/src/lan/mod.rs b/crates/horizon-client/src/lan/mod.rs index afe188699..c2f35bc8e 100644 --- a/crates/horizon-client/src/lan/mod.rs +++ b/crates/horizon-client/src/lan/mod.rs @@ -5,6 +5,7 @@ //! ever exchanges decoded packets with these threads through channels, so a //! world that is not open to the network pays nothing. mod advancements; +pub mod attributes; pub mod chunks; mod command_order; pub mod command_suggestions; diff --git a/crates/horizon-client/src/mobs/cube.rs b/crates/horizon-client/src/mobs/cube.rs index 3986ffb93..ea8a05392 100644 --- a/crates/horizon-client/src/mobs/cube.rs +++ b/crates/horizon-client/src/mobs/cube.rs @@ -47,14 +47,24 @@ pub fn register(m: &mut Mob) { m.extra.vector[0] = f64::from(180.0 * m.yaw / std::f32::consts::PI); set_size(m, 1); } -/// AbstractCubeMob.setSize: health size^2, speed 0.2 + 0.1 * size, damage size. +/// AbstractCubeMob.setSize(size, true): the max health (size^2), movement +/// speed (0.2 + 0.1 * size, in floats) and attack damage (size) bases, a +/// magma cube's armor (size * 3), then the health back to the max. pub fn set_size(m: &mut Mob, size: i32) { + use super::finalize::{Attr, set_base}; let size = size.clamp(1, 127); m.extra.size = size; - m.attrs.max_health = (size * size) as f32; - m.attrs.speed = 0.2 + 0.1 * f64::from(size); - m.attrs.attack_damage = size as f32; - m.health = m.attrs.max_health; + set_base(m, Attr::MaxHealth, f64::from(size * size)); + set_base( + m, + Attr::MovementSpeed, + f64::from(0.2f32 + 0.1f32 * size as f32), + ); + set_base(m, Attr::AttackDamage, f64::from(size)); + if m.species() == super::Species::MagmaCube { + set_base(m, Attr::Armor, f64::from(size * 3)); + } + m.health = super::finalize::max_health(m); } /// AbstractCubeMob.setSpawnSize: 1, 2 or 4 (normal difficulty special multiplier 0). pub fn finalize(m: &mut Mob) { diff --git a/crates/horizon-client/src/mobs/finalize.rs b/crates/horizon-client/src/mobs/finalize.rs index a3db1ee52..ae6a864cc 100644 --- a/crates/horizon-client/src/mobs/finalize.rs +++ b/crates/horizon-client/src/mobs/finalize.rs @@ -483,7 +483,7 @@ pub fn base_value(m: &Mob, a: Attr) -> f64 { .unwrap_or(if a == Attr::BurningTime { 1.0 } else { 0.0 }) } /// The transient modifiers of the mob's state (`SPEED_MODIFIER_BABY`). -fn transient(m: &Mob, a: Attr) -> Option<(f64, Op)> { +pub fn transient(m: &Mob, a: Attr) -> Option<(f64, Op)> { if a != Attr::MovementSpeed || !m.is_baby() { return None; } @@ -1961,19 +1961,7 @@ fn sulfur_size(m: &mut Mob, size: i32) { m.health = max_health(m); } fn cube_size(m: &mut Mob, size: i32) { - let size = size.clamp(1, 127); - m.extra.size = size; - set_base(m, Attr::MaxHealth, f64::from(size * size)); - set_base( - m, - Attr::MovementSpeed, - f64::from(0.2f32 + 0.1f32 * size as f32), - ); - set_base(m, Attr::AttackDamage, f64::from(size)); - if m.species() == Species::MagmaCube { - set_base(m, Attr::Armor, f64::from(size * 3)); - } - m.health = max_health(m); + super::cube::set_size(m, size); } /// The index the game keeps for a variant registry entry. pub fn variant_index(s: Species, name: &str) -> u8 { diff --git a/crates/horizon-client/tests/lan_bot.rs b/crates/horizon-client/tests/lan_bot.rs index 7a8209939..db2679f71 100644 --- a/crates/horizon-client/tests/lan_bot.rs +++ b/crates/horizon-client/tests/lan_bot.rs @@ -181,6 +181,7 @@ impl Server { sprinting: false, equipment: Default::default(), health: 20.0, + attributes: Vec::new(), }; let mut ctx = TickCtx { world: &mut self.world, @@ -422,6 +423,7 @@ fn guests_see_each_other_and_the_world_entities() { data: 0, meta: Vec::new(), equipment: Vec::new(), + attributes: Vec::new(), precise: false, }; let first = thread::spawn(move || { diff --git a/crates/horizon-protocol/src/packets/play.rs b/crates/horizon-protocol/src/packets/play.rs index 895db9755..8f1193fc9 100644 --- a/crates/horizon-protocol/src/packets/play.rs +++ b/crates/horizon-protocol/src/packets/play.rs @@ -881,6 +881,24 @@ packet!( UpdateMobEffect { id: i32 => VarInt, effect: i32 => VarInt, amplifier: i32 => VarInt, duration: i32 => VarInt, flags: i8 => Byte } ); packet!(RemoveMobEffect { id: i32 => VarInt, effect: i32 => VarInt }); +packet!( + /// AttributeModifier.STREAM_CODEC: id, amount and operation (0 add_value, + /// 1 add_multiplied_base, 2 add_multiplied_total). + AttributeModifier { id: String => Ident, amount: f64 => Double, operation: i32 => VarInt } +); +packet!( + /// ClientboundUpdateAttributesPacket.AttributeSnapshot: the attribute's + /// registry id, its base value and every modifier. + AttributeSnapshot { + attribute: i32 => VarInt, + base: f64 => Double, + modifiers: Vec<AttributeModifier> => List<AttributeModifier>, + } +); +packet!( + /// ClientboundUpdateAttributesPacket: an entity's synced attribute instances. + UpdateAttributes { id: i32 => VarInt, values: Vec<AttributeSnapshot> => List<AttributeSnapshot> } +); packet!( /// ClientboundSwingAnimationPacket: hand (0 main, 1 off) and the swing /// type (0 none, 1 whack, 2 stab) with its duration in ticks. @@ -1455,6 +1473,7 @@ packet_enum!(Clientbound, crate::ids::play::clientbound { TickingState(TickingState) = TICKING_STATE, TickingStep(TickingStep) = TICKING_STEP, UpdateAdvancements(UpdateAdvancements) = UPDATE_ADVANCEMENTS, + UpdateAttributes(UpdateAttributes) = UPDATE_ATTRIBUTES, UpdateMobEffect(UpdateMobEffect) = UPDATE_MOB_EFFECT, UpdateTags(UpdateTags) = UPDATE_TAGS, TrackedWaypoint(TrackedWaypoint) = WAYPOINT, @@ -2110,6 +2129,18 @@ mod tests { id: 2, slots: vec![(0, None), (5, Some(Stack::new(1, 1)))], }), + Clientbound::UpdateAttributes(UpdateAttributes { + id: 2, + values: vec![AttributeSnapshot { + attribute: 26, + base: 0.23, + modifiers: vec![AttributeModifier { + id: "minecraft:baby".into(), + amount: 0.5, + operation: 1, + }], + }], + }), Clientbound::SetHealth(SetHealth { health: 17.5, food: 18, @@ -2347,4 +2378,31 @@ mod tests { ); assert_eq!(p.encode()[1..], [1, 2, 3]); } + + #[test] + fn update_attributes_encode_like_vanilla() { + let p = Clientbound::UpdateAttributes(UpdateAttributes { + id: 5, + values: vec![AttributeSnapshot { + attribute: 1, + base: 0.0, + modifiers: vec![AttributeModifier { + id: "minecraft:armor.helmet".into(), + amount: 3.0, + operation: 0, + }], + }], + }); + let body = p.encode(); + // The packet id (134) is a two-byte VarInt. + let mut expected = vec![134, 1, 5, 1, 1]; + expected.extend(0.0f64.to_be_bytes()); + expected.extend([1, 22]); + expected.extend(b"minecraft:armor.helmet"); + expected.extend(3.0f64.to_be_bytes()); + expected.push(0); + assert_eq!(body, expected); + assert_eq!(crate::ids::play::clientbound::UPDATE_ATTRIBUTES, 134); + assert_eq!(Clientbound::decode(134, &body[2..]).unwrap(), p); + } } diff --git a/crates/horizon-world/src/attributes/entity.rs b/crates/horizon-world/src/attributes/entity.rs index 1bdf94aaf..b7ffd3925 100644 --- a/crates/horizon-world/src/attributes/entity.rs +++ b/crates/horizon-world/src/attributes/entity.rs @@ -11,6 +11,11 @@ impl AttributeId { pub(super) fn index(self) -> usize { self.0 } + /// The attribute's id in the `minecraft:attribute` registry: the catalog + /// export lists `BuiltInRegistries.ATTRIBUTE` in order. + pub fn registry_id(self) -> i32 { + self.0 as i32 + } } #[derive(Debug)] pub struct RegisteredAttribute { @@ -100,6 +105,10 @@ impl Catalog { defaults, }) } + /// The entity type's supplier base of an attribute, if the type has it. + pub fn default_base(&self, entity: &str, id: AttributeId) -> Option<f64> { + self.defaults.get(entity).and_then(|b| b[id.0]) + } pub fn id(&self, name: &str) -> Option<AttributeId> { self.ids.get(name).copied() } diff --git a/mods/horizon/src/test/java/dev/horizonlab/parity/EntityTranscript.java b/mods/horizon/src/test/java/dev/horizonlab/parity/EntityTranscript.java index ffac86a59..09c343f16 100644 --- a/mods/horizon/src/test/java/dev/horizonlab/parity/EntityTranscript.java +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/EntityTranscript.java @@ -30,7 +30,8 @@ import net.minecraft.world.phys.Vec3; * equipment, attributes and passengers, and where the position syncs leave * it (VecDeltaCodec, as handleMoveEntity and handleEntityPositionSync). * Entity ids differ between servers: an entity is named by its type and the - * block it was added in, passengers by those names. Players are left out. + * block it was added in, passengers by those names. Players are left out, but + * for the attributes the player itself is sent from its login on. */ final class EntityTranscript { private static final class Tracked { @@ -67,6 +68,21 @@ final class EntityTranscript { private final Map<Integer, Tracked> byId = new HashMap<>(); private final List<Tracked> all = new ArrayList<>(); + private int self = Integer.MIN_VALUE; + private final Map<String, String> selfAttributes = new TreeMap<>(); + + /** The player's own id (login) and attribute instances; false for any other packet. */ + boolean acceptSelf(Packet<?> packet) { + if (packet instanceof net.minecraft.network.protocol.game.ClientboundLoginPacket p) { + self = p.playerId(); + return true; + } + if (packet instanceof ClientboundUpdateAttributesPacket p && p.getEntityId() == self) { + p.getValues().forEach(a -> selfAttributes.put(a.attribute().getRegisteredName(), a.base() + " " + a.modifiers())); + return true; + } + return false; + } private int unknown; /** Applies one packet; false when it isn't about a tracked entity. */ @@ -158,6 +174,7 @@ final class EntityTranscript { + " | attributes " + t.attributes + " | passengers " + riders + " | now " + t.codec.getBase() + " rot " + t.xRot + "," + t.yRot + " head " + t.headRot + " ground " + t.onGround + " motion " + t.motion + t.power + (t.removed ? " | removed" : "")); } + out.add("self attributes " + selfAttributes); out.sort(null); return out; } diff --git a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaProtocolClient.java b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaProtocolClient.java index ca366705b..b15720848 100644 --- a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaProtocolClient.java +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaProtocolClient.java @@ -476,7 +476,7 @@ public final class VanillaProtocolClient { if (r != null) { Packet<?> packet = r.packet; counts.merge(r.type, 1, Integer::sum); - if (entities != null && step >= ENTITIES) entities.accept(packet); + if (entities != null && !entities.acceptSelf(packet) && step >= ENTITIES) entities.accept(packet); if (r.type.equals("minecraft:chunk_batch_start")) ordered = false; if (respawning && !respawned) { String line = respawnLine(r); diff --git a/tools/test_server_entities_parity.py b/tools/test_server_entities_parity.py index e512239e8..500497275 100644 --- a/tools/test_server_entities_parity.py +++ b/tools/test_server_entities_parity.py @@ -6,13 +6,17 @@ world vanilla generated first, with the same server.properties (offline, view di client (VanillaProtocolClient in its entity mode) joins, and once its chunks are in it asks for the scene: the console freezes the ticks, builds a wall and a rail and summons, around the spawn, every kind of minecart (one set rolling along the rail), boats and a raft (one falling onto the ground), armor stands (posed, small, with -arms, wearing a helmet, one falling), a chicken jockey, item frames (one holding a turned diamond), paintings, -primed TNT (one falling), a floating falling block, an arrow that lands and an end crystal. The client records -for 20 seconds, the ticks running for 200 more after 3, what ClientPacketListener would make of the packets (EntityTranscript): each entity's spawn +arms, wearing a helmet, one falling), a chicken jockey, a slime, a pig whose scale `/attribute` sets, item +frames (one holding a turned diamond), paintings, primed TNT (one falling), a floating falling block, an arrow +that lands and an end crystal. The client records for 20 seconds, the ticks running for 200 more after 3, what +ClientPacketListener would make of the packets (EntityTranscript): each entity's spawn packet (position, rotations, data, motion), the entity data it was paired with and all it was sent since, its -equipment and passengers, and where its position syncs leave it. Both transcripts must match exactly, -entity by entity (named by type and the block it was added in). Attributes are recorded but not compared yet: -Horizon sends no ClientboundUpdateAttributesPacket, for mobs either. +equipment, its attribute instances (ClientboundUpdateAttributesPacket: the ones its first tick creates, the +type's set by finalizeSpawn, the baby speed modifier, effects', equipment's and /attribute's) and passengers, and +where its position syncs leave it; and the attribute instances the player itself is sent from its login on. Both +transcripts must match exactly, entity by entity (named by type and the block it was added in), once the amounts +of vanilla's random spawn modifiers are normalised (only client-syncable attributes are sent, so follow range and +knockback resistance never show). """ import os from pathlib import Path @@ -63,6 +67,10 @@ SCENE = [ 'Pose:{Head:[10f,20f,0f],RightArm:[-30f,0f,15f]},equipment:{head:{id:"minecraft:diamond_helmet",count:1}}}', # A chicken jockey (passengers). 'summon minecraft:chicken -6.5 -60 -2.5 {NoAI:1b,Passengers:[{id:"minecraft:husk",IsBaby:1b,NoAI:1b}]}', + # Attributes: a slime's size sets its bases, /attribute a pig's scale. + 'summon minecraft:slime 2.5 -60 1.5 {Size:1,NoAI:1b}', + 'summon minecraft:pig -0.5 -60 1.5 {NoAI:1b}', + 'attribute @e[type=minecraft:pig,limit=1,x=-0.5,y=-60,z=1.5,distance=..1] minecraft:scale base set 1.5', # Frames and paintings on the wall's south face. 'summon minecraft:item_frame -3.5 -59 -4.97 {block_pos:[I;-4,-59,-5],Facing:3b,' 'Item:{id:"minecraft:diamond",count:1},ItemRotation:3b}', @@ -78,14 +86,19 @@ SCENE = [ ] +# finalizeSpawn's random modifiers on client-syncable attributes (a leader zombie's max health); their amounts +# differ from one server to the other. +RANDOM_MODIFIERS = re.compile(r'(id=minecraft:(?:random_spawn_bonus|leader_zombie_bonus), amount=)[^,]+') + + def scene_lines(lines): - """The transcript's entities in the scene's area (the world's own animals and slimes wander elsewhere), - without their attributes: ClientboundUpdateAttributesPacket isn't sent by Horizon yet, for mobs either.""" + """The transcript's entities in the scene's area (the world's own animals and slimes wander elsewhere), the + amounts of random spawn modifiers normalised.""" out = [] for line in lines: m = re.match(r'play-entities entity \S+ (-?\d+),-?\d+,(-?\d+)', line) - if m and -8 <= int(m.group(1)) <= 8 and -7 <= int(m.group(2)) <= 10: - out.append(re.sub(r' \| attributes \{[^|]*\}', '', line)) + if m and -8 <= int(m.group(1)) <= 8 and -7 <= int(m.group(2)) <= 10 or line.startswith('play-entities self '): + out.append(RANDOM_MODIFIERS.sub(r'\1~', line)) return out @@ -171,10 +184,10 @@ def main(): schema=1, minecraft=lock['minecraft']['version'], platform=platform.platform(), java=subprocess.check_output(['java', '--version'], text=True).splitlines()[0], entities=len(vanilla), output_sha256=lab.digest(build / 'horizon.txt', 'sha256'), - scope='Minecarts (one rolling), boats (one falling), armor stands, a chicken jockey, item frames, paintings, primed ' - 'TNT, a falling block, an arrow and an end crystal tracked to a ' - 'vanilla-codec client by a dedicated server: spawn packets, entity data, equipment, passengers and the ' - 'positions the syncs leave them at.')) + scope='Minecarts (one rolling), boats (one falling), armor stands, a chicken jockey, a slime, a pig with a ' + 'scale, item frames, paintings, primed TNT, a falling block, an arrow and an end crystal ' + 'tracked to a vanilla-codec client by a dedicated server: spawn packets, entity data, equipment, ' + 'attributes, passengers and the positions the syncs leave them at.')) print(f'server entities: {len(vanilla)} entities identical') From 3e825eaa408fd6c8a7f4319913140bf43b0ec387 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 13:49:06 +0200 Subject: [PATCH 102/163] Prepare: find native jars where Prism Launcher keeps them (#849) Prism's metadata moves a native jar's classifier into its artifact name (com.mojang:jtracy:1.14.38:natives-windows becomes com.mojang:jtracy-natives-windows:1.14.38) and Prism stores libraries at their name's path, so every native jar of a Prism 26.3 install is in com/mojang/jtracy-natives-windows/1.14.38/jtracy-natives-windows-1.14.38.jar, not at the version JSON's path. The bytes and sha1 are Mojang's. Preparing from a linked Prism folder stopped on the first one (jtracy on Windows). horizon-prepare now looks there when the version JSON's path is missing; the copy is still checked against the version JSON's sha1. The missing-file hints no longer tell players of other launchers to install the official one. Reported by famescare on Discord. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-prepare/src/artifacts.rs | 87 ++++++++++++++++++++++--- crates/horizon-prepare/src/sounds.rs | 2 +- launcher/src/sources_tests.rs | 34 +++++++++- 3 files changed, 112 insertions(+), 11 deletions(-) diff --git a/crates/horizon-prepare/src/artifacts.rs b/crates/horizon-prepare/src/artifacts.rs index c9b1947ed..80b3bcf05 100644 --- a/crates/horizon-prepare/src/artifacts.rs +++ b/crates/horizon-prepare/src/artifacts.rs @@ -11,9 +11,10 @@ use std::fs; use std::path::{Component, Path, PathBuf}; const LAUNCHER_HINT: &str = - "Horizon does not download the game: install Minecraft Java Edition with the official \ -launcher, play {version} once, then rerun. If the launcher uses another game directory, \ -pass --minecraft-dir or set HORIZON_MINECRAFT_DIR."; + "Horizon does not download the game: play {version} once in the launcher you play \ +Minecraft Java Edition with (the official launcher, Prism Launcher, MultiMC...) so it downloads \ +the game's files, then rerun. If that launcher keeps them in another folder, pass \ +--minecraft-dir or set HORIZON_MINECRAFT_DIR."; const SERVER_HINT: &str = "Horizon does not download the game: download the {version} server jar yourself (minecraft.net/download/server \ while {version} is the current release, otherwise the downloads.server.url in your launcher's \ versions/{version}/{version}.json), then pass --server-jar PATH or set HORIZON_SERVER_JAR."; @@ -337,8 +338,9 @@ fn native_library_matches(library: &Value, names: &[&str]) -> bool { true } -/// The client libraries the official launcher installs on this OS and architecture. -fn client_library_artifacts(manifest: &Value) -> Result<Vec<&Value>, String> { +/// The client libraries the official launcher installs on this OS and architecture: each +/// library's Maven name and its download. +fn client_library_artifacts(manifest: &Value) -> Result<Vec<(&str, &Value)>, String> { let libraries = manifest .get("libraries") .and_then(Value::as_array) @@ -353,7 +355,8 @@ fn client_library_artifacts(manifest: &Value) -> Result<Vec<&Value>, String> { continue; }; if library_allowed(library)? && native_library_matches(library, &names) { - artifacts.push(artifact); + let name = library.get("name").and_then(Value::as_str).unwrap_or(""); + artifacts.push((name, artifact)); } } Ok(artifacts) @@ -374,6 +377,35 @@ pub(crate) fn safe_relative(path: &str) -> Option<PathBuf> { Some(parts.iter().collect()) } +/// A launcher's copy of the library `name`, whose path in the version JSON is `relative`, under +/// its game folder `minecraft`: at that path, else where Prism Launcher keeps it (#849). Prism's +/// metadata moves a native jar's classifier into its artifact name +/// (`com.mojang:jtracy:1.14.38:natives-windows` is its `com.mojang:jtracy-natives-windows:1.14.38`) +/// and Prism keeps libraries at their name's path, so the same jar, with the same sha1, is in +/// `com/mojang/jtracy-natives-windows/1.14.38/jtracy-natives-windows-1.14.38.jar`. The path the +/// version JSON gives is returned when neither exists, for the error to name. +pub fn launcher_library(minecraft: &Path, name: &str, relative: &Path) -> PathBuf { + let libraries = minecraft.join("libraries"); + let official = libraries.join(relative); + if official.is_file() { + return official; + } + if let [group, artifact, version, classifier] = name.split(':').collect::<Vec<_>>()[..] { + let artifact = format!("{artifact}-{classifier}"); + let path = format!( + "{}/{artifact}/{version}/{artifact}-{version}.jar", + group.replace('.', "/") + ); + if let Some(prism) = safe_relative(&path) + .map(|p| libraries.join(p)) + .filter(|p| p.is_file()) + { + return prism; + } + } + official +} + fn artifact_fields(artifact: &Value) -> Result<(&str, &str), String> { let path = artifact.get("path").and_then(Value::as_str); let sha1 = artifact.get("sha1").and_then(Value::as_str); @@ -502,11 +534,11 @@ pub fn import( let server = import_server(lock, server_jar)?; let (server, server_libraries) = unpack_server(server, &lock.directory, id)?; let mut client_libraries = Vec::new(); - for artifact in client_library_artifacts(&manifest)? { + for (name, artifact) in client_library_artifacts(&manifest)? { let (path, sha1) = artifact_fields(artifact)?; let relative = safe_relative(path).ok_or("Unsafe library path")?; client_libraries.push(import_copy( - &minecraft.join("libraries").join(&relative), + &launcher_library(&minecraft, name, &relative), &lock.directory.join("libraries/client").join(&relative), sha1, "sha1", @@ -744,7 +776,7 @@ pub fn verify(lock: &Lock) -> Result<Artifacts, String> { /// `client_libraries`); the client-side exporters compile against them. pub fn client_libraries(lock: &Lock, manifest: &Value) -> Result<Vec<PathBuf>, String> { let mut libraries = Vec::new(); - for artifact in client_library_artifacts(manifest)? { + for (_, artifact) in client_library_artifacts(manifest)? { let (path, sha1) = artifact_fields(artifact)?; let relative = safe_relative(path).ok_or("Unsafe client library path")?; let library = lock.directory.join("libraries/client").join(&relative); @@ -992,6 +1024,43 @@ mod tests { ); } + /// A native jar is found where the official launcher keeps it, else under the name Prism + /// Launcher's metadata gives it (#849); a plain library only at the version JSON's path. + #[test] + fn libraries_are_found_where_prism_launcher_keeps_them() { + let fixture = Imports::new(); + let minecraft = &fixture.directory; + let official = Path::new("com/mojang/jtracy/1.14.38/jtracy-1.14.38-natives-windows.jar"); + let name = "com.mojang:jtracy:1.14.38:natives-windows"; + let prism = minecraft.join( + "libraries/com/mojang/jtracy-natives-windows/1.14.38/jtracy-natives-windows-1.14.38.jar", + ); + assert_eq!( + launcher_library(minecraft, name, official), + minecraft.join("libraries").join(official) + ); + fs::create_dir_all(prism.parent().unwrap()).unwrap(); + fs::write(&prism, b"natives").unwrap(); + assert_eq!(launcher_library(minecraft, name, official), prism); + let mojang = minecraft.join("libraries").join(official); + fs::create_dir_all(mojang.parent().unwrap()).unwrap(); + fs::write(&mojang, b"natives").unwrap(); + assert_eq!(launcher_library(minecraft, name, official), mojang); + let plain = Path::new("com/mojang/jtracy/1.14.38/jtracy-1.14.38.jar"); + assert_eq!( + launcher_library(minecraft, "com.mojang:jtracy:1.14.38", plain), + minecraft.join("libraries").join(plain) + ); + for unsafe_name in ["a:..:1:x", "a:b\\c:1:x"] { + let path = launcher_library(minecraft, unsafe_name, plain); + assert_eq!( + path, + minecraft.join("libraries").join(plain), + "{unsafe_name}" + ); + } + } + #[test] fn natives_follow_the_architecture() { let names = ["a:b:1:natives-macos", "a:b:1:natives-macos-arm64"]; diff --git a/crates/horizon-prepare/src/sounds.rs b/crates/horizon-prepare/src/sounds.rs index b18ed3426..f6ff0b714 100644 --- a/crates/horizon-prepare/src/sounds.rs +++ b/crates/horizon-prepare/src/sounds.rs @@ -53,7 +53,7 @@ fn launcher_object(assets: &Path, checksum: &str) -> Result<PathBuf, String> { let path = object_path(assets, checksum)?; if !path.is_file() { return Err(format!( - "Missing asset object {}. Play the pinned version once in the official launcher.", + "Missing asset object {}. Play the pinned version once in your launcher.", path.display() )); } diff --git a/launcher/src/sources_tests.rs b/launcher/src/sources_tests.rs index b273fa4ba..6d882f032 100644 --- a/launcher/src/sources_tests.rs +++ b/launcher/src/sources_tests.rs @@ -203,6 +203,35 @@ fn prism_launcher_and_multimc_are_read_through_their_metadata() { assert_eq!(mojang.urls.lock().unwrap().len(), 1); } +/// famescare's Prism Launcher 26.3 install on Windows (#849): Prism keeps a native jar under +/// the name its metadata gives it, not at the version JSON's path, and preparing found it. +#[test] +fn prism_native_jars_are_found_through_the_linked_folder() { + let s = Scratch::new("prism-natives"); + let jar = "libraries/com/mojang/minecraft/26.3/minecraft-26.3-client.jar"; + let dir = s.launcher("PrismLauncher", "", jar); + s.write( + "PrismLauncher/meta/net.minecraft/26.3.json", + br#"{"mainJar": {"name": "com.mojang:minecraft:26.3:client"}}"#, + ); + let prism = + "libraries/com/mojang/jtracy-natives-windows/1.14.38/jtracy-natives-windows-1.14.38.jar"; + s.write(&format!("PrismLauncher/{prism}"), b"jtracy natives"); + let linked = s.0.join("linked"); + assert_eq!( + resolve_with(&dir, &[], &linked, &Mojang::new(MANIFEST)).unwrap(), + linked + ); + let official = Path::new("com/mojang/jtracy/1.14.38/jtracy-1.14.38-natives-windows.jar"); + assert!(!linked.join("libraries").join(official).exists()); + let found = horizon_prepare::artifacts::launcher_library( + &linked, + "com.mojang:jtracy:1.14.38:natives-windows", + official, + ); + assert!(same_file(&found, &dir.join(prism))); +} + #[test] fn a_main_jar_elsewhere_is_found_from_the_metadata() { let s = Scratch::new("meta-jar"); @@ -388,7 +417,10 @@ fn relinking_follows_the_launcher_the_files_now_come_from() { s.write("ModrinthApp/meta/versions/26.3/26.3.jar", CLIENT); resolve_with(&modrinth, &[], &linked, &mojang).unwrap(); let jar = linked.join("versions/26.3/26.3.jar"); - assert!(same_file(&jar, &modrinth.join("meta/versions/26.3/26.3.jar"))); + assert!(same_file( + &jar, + &modrinth.join("meta/versions/26.3/26.3.jar") + )); assert!(!same_file(&jar, &prism.join(prism_jar))); // The Modrinth App folder has no libraries or assets: the old links are gone, and the // folders they pointed at are untouched. From 6bbcf8e3d6d33d0bc7294c44e336921d91d6304e Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 14:39:34 +0200 Subject: [PATCH 103/163] streaming_meshes test: remote columns arrive lit since #824 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/tests/streaming_meshes.rs | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/crates/horizon-client/tests/streaming_meshes.rs b/crates/horizon-client/tests/streaming_meshes.rs index 6804d197e..3c76b3e89 100644 --- a/crates/horizon-client/tests/streaming_meshes.rs +++ b/crates/horizon-client/tests/streaming_meshes.rs @@ -149,8 +149,9 @@ fn relit_columns_keep_every_mesh_current() { state("minecraft:glowstone"), state("minecraft:torch"), ); - // Columns from a server, one of them never sent: its neighbours stay - // unlit, next to lit columns within the render distance. + // Columns from a server, one of them not sent yet. They keep the light + // the server sent (#824, as vanilla's `enableChunkLight`), so its + // neighbours are lit too. let mut streaming = Streaming::new(Arc::new(Saved), context.clone(), 3); streaming.radius = 4; streaming.remote = true; @@ -176,7 +177,7 @@ fn relit_columns_keep_every_mesh_current() { } }; settle(&mut streaming, &mut world); - assert!(!streaming.is_lit(1, 0) && streaming.is_lit(0, 0)); + assert!(streaming.is_lit(1, 0) && streaming.is_lit(0, 0)); // Open the roof and put torches in the cave on a ring two blocks inside // the unlit (1, 0): its lit neighbours are relit, and their meshes change // only through light (no edit is next to them). From dd9f8a908804b0fbd9c20f8dd7550476a71f245f Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 14:43:55 +0200 Subject: [PATCH 104/163] Server: send a player standing up again, and draw other players' crouch A value back at its default is left out of an entity's state, so the tracker never told clients that a player stopped crouching or a mob stopped burning: Entity's shared flags and pose now go back to 0. On a client of a server (the host window on the server thread), another player's crouch flag now reaches their model and name tag. From #731's server-thread list; lan_e2e's walls check passed in-frame and failed with --server-thread. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game/remote.rs | 14 ++++++++ crates/horizon-client/src/lan/entity.rs | 46 ++++++++++++++++++++++-- 2 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 680360c93..feeb1750c 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -1490,6 +1490,20 @@ impl Game<'_> { } } } + // Entity.DATA_SHARED_FLAGS_ID's crouching bit: another + // player's crouch (their model and Entity.isDiscrete's name tag). + if self + .remote + .as_ref() + .is_some_and(|r| r.level_players.contains_key(&p.id)) + && let Some(m) = self.mobs.iter_mut().find(|m| m.id == p.id as u32) + { + for (index, _, value) in &p.values { + if let (0, Value::Byte(flags)) = (index, value) { + m.extra.crouching = flags & 2 != 0; + } + } + } for (index, _, value) in &p.values { if *index == ITEM_ENTITY_ITEM && let Value::Item(stack) = value diff --git a/crates/horizon-client/src/lan/entity.rs b/crates/horizon-client/src/lan/entity.rs index 3d8090267..d63a76b89 100644 --- a/crates/horizon-client/src/lan/entity.rs +++ b/crates/horizon-client/src/lan/entity.rs @@ -8,7 +8,7 @@ use super::tracking; use horizon_protocol::{ buf::pack_degrees, - entity_data::Value, + entity_data::{Value, serializer}, item::Stack, packets::play::{ self, AddEntity, EntityPositionSync, MoveEntity, MoveEntityPos, MoveEntityPosRot, @@ -347,12 +347,25 @@ impl ServerEntity { if !dirty { return; } - let changed: Vec<_> = e + let mut changed: Vec<_> = e .meta .iter() .filter(|m| !self.meta.contains(m)) .cloned() .collect(); + // A value back at its default is left out of the state, but the + // clients still hold the old one: Entity's shared flags and pose go + // back to 0 (a player standing up again, a mob no longer on fire). + for (index, kind, _) in &self.meta { + let default = match (*index, *kind) { + (0, serializer::BYTE) => Value::Byte(0), + (6, serializer::POSE) => Value::Id(0), + _ => continue, + }; + if !e.meta.iter().any(|m| m.0 == *index) { + changed.push((*index, *kind, default)); + } + } if !changed.is_empty() { out.push(play::Clientbound::SetEntityData(SetEntityData { id: e.id, @@ -697,6 +710,35 @@ mod tests { )); } + #[test] + fn cleared_flags_and_pose_go_back_to_their_default() { + let mut e = state(0.0); + let mut s = added(&e); + changes(&mut s, &e); + // A crouching player: the crouch flag and the crouching pose. + e.meta = vec![ + (0, serializer::BYTE, Value::Byte(2)), + (6, serializer::POSE, Value::Id(5)), + ]; + changes(&mut s, &e); + e.meta.clear(); + let data = changes(&mut s, &e) + .into_iter() + .find_map(|p| match p { + play::Clientbound::SetEntityData(d) => Some(d), + _ => None, + }) + .expect("standing up is sent"); + assert_eq!( + data.values, + vec![ + (0, serializer::BYTE, Value::Byte(0)), + (6, serializer::POSE, Value::Id(0)), + ] + ); + assert!(changes(&mut s, &e).is_empty()); + } + #[test] fn metadata_and_equipment_send_only_the_changes() { let mut e = state(0.0); From b171508c0f5e0211f023aac37c4f27be80bcf1d2 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 13:53:52 +0200 Subject: [PATCH 105/163] Server: check each entity's range for every client from one compact pass Entity tracking still asks every client about every entity each tick (vanilla re-checks each pair whenever the player sends a move, so for moving players it does the same), but the check is cheaper: - each entity's position, id, range and chunk are read once a tick into a compact list, not from its EntityState once per client; - each client looks up each of the tick's chunks once in the chunks it holds, not once per entity in it; - an entity with no changes and no client starting to track it skips the loop over the clients. The decisions and the packets are the same, in the same order. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/lan/entity.rs | 120 +++++++++++++++++++----- 1 file changed, 97 insertions(+), 23 deletions(-) diff --git a/crates/horizon-client/src/lan/entity.rs b/crates/horizon-client/src/lan/entity.rs index 3d8090267..4578423dd 100644 --- a/crates/horizon-client/src/lan/entity.rs +++ b/crates/horizon-client/src/lan/entity.rs @@ -436,22 +436,32 @@ pub struct Viewer<'a> { pub out: &'a mut Vec<Vec<u8>>, } -/// TrackedEntity.updatePlayer: within the type's range (capped by the view -/// distance) horizontally, in a chunk the client has. -fn sees( - position: [f64; 3], - view_distance: i32, - chunks: &crate::fast_hash::FxHashSet<(i32, i32)>, - e: &EntityState, +/// One entity as this tick's range checks read it: where it is +/// horizontally, its id, its type's tracking range in chunks and the chunk +/// it is in (an index into the tick's chunks). +#[derive(Clone, Copy)] +struct Probe { + x: f64, + z: f64, + id: i32, range: i32, -) -> bool { - let range = f64::from(range.min(view_distance) * 16); - let (dx, dz) = (position[0] - e.position[0], position[2] - e.position[2]); - let chunk = ( - (e.position[0].floor() as i32) >> 4, - (e.position[2].floor() as i32) >> 4, - ); - dx * dx + dz * dz <= range * range && chunks.contains(&chunk) + chunk: u32, +} + +/// TrackedEntity.updatePlayer: within the type's range (capped by the view +/// distance) horizontally, in a chunk the client has. `held` remembers for +/// each of the tick's chunks whether the client has it (0: not looked up +/// yet, 1: no, 2: yes), so each chunk is looked up once per client. +fn sees(v: &Viewer, p: &Probe, chunks: &[(i32, i32)], held: &mut [u8]) -> bool { + let range = f64::from(p.range.min(v.view_distance) * 16); + let (dx, dz) = (v.position[0] - p.x, v.position[2] - p.z); + dx * dx + dz * dz <= range * range && { + let held = &mut held[p.chunk as usize]; + if *held == 0 { + *held = 1 + u8::from(v.chunks.contains(&chunks[p.chunk as usize])); + } + *held == 2 + } } /// One level's tracked entities (ChunkMap.entityMap). @@ -460,10 +470,17 @@ pub struct Entities { states: crate::fast_hash::FxHashMap<i32, ServerEntity>, /// The level tick, stamped on every entity still in the level. tick: u32, - /// This tick's tracking range of each entity, and what each client - /// makes of each entity ([`SEES`], [`TRACKS`]), kept between ticks. - ranges: Vec<i32>, + /// This tick's entities as the range checks read them, the chunks they + /// are in (and each one's index), whether the client being checked has + /// each chunk, and what each client makes of each entity ([`SEES`], + /// [`TRACKS`]), kept between ticks. + probes: Vec<Probe>, + chunks: Vec<(i32, i32)>, + chunk_index: crate::fast_hash::FxHashMap<(i32, i32), u32>, + held: Vec<u8>, flags: Vec<Vec<u8>>, + /// Whether a client starts tracking each entity this tick. + pairs: Vec<bool>, /// One entity's packets and their bodies, kept between entities. packets: Vec<play::Clientbound>, bodies: Vec<Vec<u8>>, @@ -501,7 +518,9 @@ impl Entities { ) { self.tick = self.tick.wrapping_add(1); let now = self.tick; - self.ranges.clear(); + self.probes.clear(); + self.chunks.clear(); + self.chunk_index.clear(); for (index, e) in entities.iter().enumerate() { let s = self .states @@ -509,19 +528,40 @@ impl Entities { .or_insert_with(|| ServerEntity::new(e, kind(&e.kind), riding)); s.seen = now; s.index = index; - self.ranges.push(s.range); + let at = ( + (e.position[0].floor() as i32) >> 4, + (e.position[2].floor() as i32) >> 4, + ); + let next = self.chunks.len() as u32; + let chunk = *self.chunk_index.entry(at).or_insert(next); + if chunk == next { + self.chunks.push(at); + } + self.probes.push(Probe { + x: e.position[0], + z: e.position[2], + id: e.id, + range: s.range, + chunk, + }); } self.flags.resize_with(viewers.len(), Vec::new); + self.pairs.clear(); + self.pairs.resize(entities.len(), false); for (v, flags) in viewers.iter_mut().zip(&mut self.flags) { flags.clear(); + self.held.clear(); + self.held.resize(self.chunks.len(), 0); + let (chunks, held, pairs) = (&self.chunks, &mut self.held, &mut self.pairs); let mut kept = 0; - flags.extend(entities.iter().zip(&self.ranges).map(|(e, &range)| { - if e.id == v.entity_id || !sees(v.position, v.view_distance, v.chunks, e, range) { + flags.extend(self.probes.iter().zip(pairs.iter_mut()).map(|(p, pairs)| { + if p.id == v.entity_id || !sees(v, p, chunks, held) { 0 - } else if v.tracker.seen.contains(&e.id) { + } else if v.tracker.seen.contains(&p.id) { kept += 1; SEES | TRACKS } else { + *pairs = true; SEES } })); @@ -553,6 +593,10 @@ impl Entities { s.send_changes(e, riding, &mut self.packets); } s.added = false; + // Nothing to send: no changes, and nobody starts tracking it. + if self.packets.is_empty() && !self.pairs[index] { + continue; + } let mut encoded = false; let mut pairing: Option<Vec<Vec<u8>>> = None; for (v, flags) in viewers.iter_mut().zip(&self.flags) { @@ -828,4 +872,34 @@ mod tests { assert_eq!(c.out[0].first(), Some(&removed)); assert_eq!(level.len(), 1); } + + #[test] + fn entities_in_chunks_a_client_lacks_wait_for_them() { + let mut level = Entities::default(); + let mut c = Clients::new(); + // Two zombies in range in chunk (4, 0), which the clients don't have + // yet, and one in chunk (0, 0). + let mut far = state(70.0); + let mut near = state(66.0); + near.id = 8; + let mut home = state(1.0); + home.id = 9; + c.tick(&mut level, &[&far, &near, &home]); + for t in &c.trackers { + assert!(!t.is_tracking(7) && !t.is_tracking(8) && t.is_tracking(9)); + } + // The chunk arrives: both are paired, in order. + c.chunks.insert((4, 0)); + c.tick(&mut level, &[&far, &near, &home]); + for t in &c.trackers { + assert!(t.is_tracking(7) && t.is_tracking(8) && t.is_tracking(9)); + } + // One walks back into chunk (3, 0) and the other out of range. + far.position[0] = 200.0; + near.position[0] = 60.0; + c.tick(&mut level, &[&far, &near, &home]); + for t in &c.trackers { + assert!(!t.is_tracking(7) && t.is_tracking(8) && t.is_tracking(9)); + } + } } From 8bf73f89d4aa89cb4f16617a2201c4e8f497a7d5 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 14:20:26 +0200 Subject: [PATCH 106/163] Locator bar: look up each connection and its two players once A moving player updates its connection with every other player, three times a tick (updateWaypoint, then updatePlayer at the position change and at ServerChunkCache.move), so with 40 players there are about 4800 updates a tick. Each looked the connection up twice and both players up four to six times. Now an update finds the connection's place once and resolves the two players once, then checks, updates or remakes it there. The same packets go out, in the same order. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/lan/waypoints.rs | 96 ++++++++++------------ 1 file changed, 42 insertions(+), 54 deletions(-) diff --git a/crates/horizon-client/src/lan/waypoints.rs b/crates/horizon-client/src/lan/waypoints.rs index e3067871c..852cfc4fb 100644 --- a/crates/horizon-client/src/lan/waypoints.rs +++ b/crates/horizon-client/src/lan/waypoints.rs @@ -160,7 +160,7 @@ struct Tick<'a> { out: Vec<(u32, C)>, } -impl Tick<'_> { +impl<'a> Tick<'a> { fn send( &mut self, receiver: u128, @@ -172,16 +172,8 @@ impl Tick<'_> { let Some(conn) = self.players.get(&receiver).and_then(|p| p.conn) else { return; }; - self.out.push(( - conn, - C::TrackedWaypoint(TrackedWaypoint { - operation, - id: WaypointId::Uuid(source), - style: icon.style.clone(), - color: icon.color, - target, - }), - )); + self.out + .push((conn, waypoint(source, operation, icon, target))); } fn connect(&mut self, receiver: u128, source: u128, c: &Connection) { let target = match c.kind { @@ -230,11 +222,13 @@ impl Tick<'_> { let d = [0, 1, 2].map(|k| receiver.position[k] - source.position[k]); horizon_core::geometry::trig::atan2(d[0], -d[2]) as f32 } + /// The source and the receiver, if both are in the level this tick. + fn pair(&self, source: u128, receiver: u128) -> Option<(&'a Player, &'a Player)> { + Some((*self.players.get(&source)?, *self.players.get(&receiver)?)) + } /// `LivingEntity.makeWaypointConnectionWith`. - fn make(&self, source: u128, receiver: u128) -> Option<Connection> { - let (s, r) = (self.players.get(&source)?, self.players.get(&receiver)?); - if s.first_tick || self.fresh.contains(&source) || source == receiver || self.ignores(s, r) - { + fn make(&self, (s, r): (&Player, &Player)) -> Option<Connection> { + if s.first_tick || self.fresh.contains(&s.uuid) || s.uuid == r.uuid || self.ignores(s, r) { return None; } // Waypoint.Icon.cloneAndAssignStyle: the icon's colour, else the team's. @@ -244,7 +238,7 @@ impl Tick<'_> { } let kind = if Self::really_far(s, r) { Kind::Azimuth(Self::azimuth(s, r)) - } else if !self.chunk_visible(s.chunk(), receiver) { + } else if !self.chunk_visible(s.chunk(), r.uuid) { Kind::Chunk(s.chunk()) } else { Kind::Block(s.block()) @@ -252,10 +246,8 @@ impl Tick<'_> { Some(Connection { kind, icon }) } /// `Connection.isBroken` for each kind. - fn broken(&self, c: &Connection, source: u128, receiver: u128) -> bool { - let (Some(s), Some(r)) = (self.players.get(&source), self.players.get(&receiver)) else { - return true; - }; + fn broken(&self, c: &Connection, (s, r): (&Player, &Player)) -> bool { + let receiver = r.uuid; match c.kind { Kind::Block(last) => { let now = s.block(); @@ -274,10 +266,7 @@ impl Tick<'_> { } } /// `Connection.update`: the packet when the waypoint moved. - fn update(&mut self, c: &mut Connection, source: u128, receiver: u128) { - let (Some(s), Some(r)) = (self.players.get(&source), self.players.get(&receiver)) else { - return; - }; + fn update(&mut self, c: &mut Connection, (s, r): (&Player, &Player)) { let target = match &mut c.kind { Kind::Block(last) => { let now = s.block(); @@ -304,24 +293,26 @@ impl Tick<'_> { WaypointTarget::Azimuth(now) } }; - self.send( - receiver, - source, - waypoint_operation::UPDATE, - &c.icon, - target, - ); + if let Some(conn) = r.conn { + self.out.push(( + conn, + waypoint(s.uuid, waypoint_operation::UPDATE, &c.icon, target), + )); + } } } +fn waypoint(source: u128, operation: i32, icon: &Icon, target: WaypointTarget) -> C { + C::TrackedWaypoint(TrackedWaypoint { + operation, + id: WaypointId::Uuid(source), + style: icon.style.clone(), + color: icon.color, + target, + }) +} + impl Waypoints { - fn connection(&mut self, receiver: u128, source: u128) -> Option<&mut Connection> { - self.connections - .get_mut(&receiver)? - .iter_mut() - .find(|(s, _)| *s == source) - .map(|(_, c)| c) - } fn put(&mut self, receiver: u128, source: u128, c: Connection) { let row = self.connections.entry(receiver).or_default(); match row.iter_mut().find(|(s, _)| *s == source) { @@ -340,7 +331,7 @@ impl Waypoints { if receiver == source || !t.enabled { return; } - match t.make(source, receiver) { + match t.pair(source, receiver).and_then(|pair| t.make(pair)) { Some(c) => { t.connect(receiver, source, &c); self.put(receiver, source, c); @@ -352,23 +343,28 @@ impl Waypoints { } } } - /// `updateConnection`, on the connection in its place. - fn update_connection(&mut self, t: &mut Tick, receiver: u128, source: u128) { + /// The receiver's connection to the source updated in its place + /// (`updateConnection`), or made if it has none (`createConnection`). + fn update_or_create(&mut self, t: &mut Tick, receiver: u128, source: u128) { if receiver == source || !t.enabled { return; } let Some(row) = self.connections.get_mut(&receiver) else { - return; + return self.create_connection(t, receiver, source); }; let Some(i) = row.iter().position(|(s, _)| *s == source) else { - return; + return self.create_connection(t, receiver, source); }; let c = &mut row[i].1; - if !t.broken(c, source, receiver) { - t.update(c, source, receiver); + // A connection to a player who isn't in the level is broken. + let pair = t.pair(source, receiver); + if let Some(pair) = pair + && !t.broken(c, pair) + { + t.update(c, pair); return; } - match t.make(source, receiver) { + match pair.and_then(|pair| t.make(pair)) { Some(new) => { t.connect(receiver, source, &new); *c = new; @@ -379,14 +375,6 @@ impl Waypoints { } } } - /// The receiver's connection to the source updated, or made if it has none. - fn update_or_create(&mut self, t: &mut Tick, receiver: u128, source: u128) { - if self.connection(receiver, source).is_some() { - self.update_connection(t, receiver, source); - } else { - self.create_connection(t, receiver, source); - } - } /// `trackWaypoint`. fn track(&mut self, t: &mut Tick, source: u128) { if !self.waypoints.contains(&source) { From 43223c34e208e546a47395a2b85b09126d80d681 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 15:11:04 +0200 Subject: [PATCH 107/163] Structure starts: a sharded cache, so the server thread stops waiting on workers The generator's structure-start cache was one Mutex<HashMap>. Each generated chunk reads the 289 start chunks around it for its references, and the server thread reads the starts of the chunks its mobs and spawn attempts are in (`structures_reaching`). While workers generated, the server thread spent most of its start lookups waiting for that lock. The cache is now 64 RwLock shards keyed by a hash of the chunk: a lookup read-locks one shard. Vanilla keeps the starts on each chunk (`StructureManager.getStartForStructure` -> `chunk.getStartForStructure`), so its lookups share no lock either. The first starts built for a chunk are still the ones everyone keeps. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../src/worldgen/generator_structures.rs | 92 ++++++++++++++++--- 1 file changed, 79 insertions(+), 13 deletions(-) diff --git a/crates/horizon-world/src/worldgen/generator_structures.rs b/crates/horizon-world/src/worldgen/generator_structures.rs index e78ce0772..3b6d058ae 100644 --- a/crates/horizon-world/src/worldgen/generator_structures.rs +++ b/crates/horizon-world/src/worldgen/generator_structures.rs @@ -17,7 +17,7 @@ use std::collections::BTreeMap; use std::{ collections::{BTreeSet, HashMap}, sync::{ - Arc, Condvar, Mutex, OnceLock, + Arc, Condvar, Mutex, OnceLock, RwLock, atomic::{AtomicUsize, Ordering}, }, }; @@ -30,7 +30,7 @@ pub(super) struct StructureState { possible_sets: Vec<usize>, /// Structure indices of each decoration step, in registry order. pub(super) by_step: Vec<Vec<usize>>, - starts: Mutex<HashMap<(i32, i32), Starts>>, + starts: StartCache, /// Concentric ring positions, computed on first use and shared with /// later generators of the same seed and dimension. rings: Arc<OnceLock<Rings>>, @@ -108,6 +108,45 @@ impl RingWork { } } const START_CACHE_LIMIT: usize = 65536; +const START_SHARDS: usize = 64; + +/// The built starts by chunk, in shards: a lookup locks one shard for +/// reading. Each generated chunk reads the 289 start chunks around it +/// (`references`) and the server thread reads the starts of the chunks its +/// mobs and players are in; with one lock for all, the server thread waited +/// on the workers. +struct StartCache { + shards: Box<[RwLock<HashMap<(i32, i32), Starts>>]>, +} +impl StartCache { + fn new() -> Self { + Self { + shards: (0..START_SHARDS).map(|_| RwLock::default()).collect(), + } + } + fn shard(&self, key: (i32, i32)) -> &RwLock<HashMap<(i32, i32), Starts>> { + let hash = + (key.0 as u32).wrapping_mul(0x9E37_79B9) ^ (key.1 as u32).wrapping_mul(0x85EB_CA6B); + &self.shards[(hash >> (32 - START_SHARDS.trailing_zeros())) as usize] + } + fn get(&self, key: (i32, i32)) -> Option<Starts> { + self.shard(key).read().unwrap().get(&key).cloned() + } + /// Keeps `starts` unless another thread built the same chunk's first: + /// everyone keeps the first, so placement state on its pieces is shared. + fn insert_first(&self, key: (i32, i32), starts: Starts) -> Starts { + let mut shard = self.shard(key).write().unwrap(); + if shard.len() >= START_CACHE_LIMIT / START_SHARDS { + shard.clear(); + } + shard.entry(key).or_insert(starts).clone() + } + fn clear(&self) { + for shard in &self.shards { + shard.write().unwrap().clear(); + } + } +} fn biome_set(data: &GeneratorData, value: &Value) -> Result<BTreeSet<BiomeId>, super::DecodeError> { let names: Vec<&str> = match value { @@ -167,7 +206,7 @@ impl StructureState { bindings, possible_sets, by_step, - starts: Mutex::new(HashMap::new()), + starts: StartCache::new(), rings, ring_work: OnceLock::new(), })) @@ -199,7 +238,7 @@ impl StructureState { /// Drop the cached starts, so that later chunks build fresh pieces (the /// pieces keep per-start placement state such as a shipwreck's height). pub(super) fn forget_starts(&self) { - self.starts.lock().unwrap().clear(); + self.starts.clear(); } /// The (cached) structure starts owned by a chunk. pub(super) fn starts_at( @@ -207,8 +246,8 @@ impl StructureState { context: &mut impl super::structure::start::StartContext, chunk: ChunkPos, ) -> Starts { - if let Some(found) = self.starts.lock().unwrap().get(&(chunk.x, chunk.z)) { - return found.clone(); + if let Some(found) = self.starts.get((chunk.x, chunk.z)) { + return found; } let rings = self.rings(context); let starts: Starts = Arc::new( @@ -225,13 +264,7 @@ impl StructureState { .map(Arc::new) .collect(), ); - let mut cache = self.starts.lock().unwrap(); - if cache.len() >= START_CACHE_LIMIT { - cache.clear(); - } - // Another thread may have built the same starts meanwhile: everyone - // keeps the first, so placement state on its pieces is shared. - cache.entry((chunk.x, chunk.z)).or_insert(starts).clone() + self.starts.insert_first((chunk.x, chunk.z), starts) } /// ChunkGenerator.findNearestMapStructure: the nearest start of one of /// `names` from block `from` (rings: every ring chunk; random spreads: @@ -385,6 +418,39 @@ mod tests { use super::*; use crate::worldgen::structure::stronghold::{ring_positions, ring_searches}; + /// The start cache keeps the first starts built for a chunk, spreads a + /// chunk's 289 reference lookups over the shards, and forgets on clear. + #[test] + fn start_cache_keeps_first_and_spreads_neighbours() { + let cache = StartCache::new(); + let first: Starts = Arc::new(Vec::new()); + let second: Starts = Arc::new(Vec::new()); + assert!(cache.get((3, -4)).is_none()); + assert!(Arc::ptr_eq( + &cache.insert_first((3, -4), first.clone()), + &first + )); + assert!(Arc::ptr_eq(&cache.insert_first((3, -4), second), &first)); + assert!(Arc::ptr_eq(&cache.get((3, -4)).unwrap(), &first)); + for (cx, cz) in [(0, 0), (-1000, 77), (i32::MAX - 8, i32::MIN + 8)] { + let mut used = vec![0; START_SHARDS]; + for x in cx - 8..=cx + 8 { + for z in cz - 8..=cz + 8 { + let shard = cache.shard((x, z)) as *const _; + let i = cache + .shards + .iter() + .position(|s| std::ptr::eq(s, shard)) + .unwrap(); + used[i] += 1; + } + } + assert!(used.iter().all(|&n| n > 0 && n < 20), "{used:?}"); + } + cache.clear(); + assert!(cache.get((3, -4)).is_none()); + } + /// Searches shared between threads give the positions of one thread /// running them in order, set by set. #[test] From 62cacfa6074f9a34832bef070d43445341ef712d Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 14:40:56 +0200 Subject: [PATCH 108/163] Mining: the block-removal harness mines blocks as a survival player test_block_removal_parity gains a "mine" removal: VanillaDispenserOracle calls the real ServerPlayerGameMode.destroyBlock for a survival player holding a pickaxe, axe, shovel, sword, shears, a mace or nothing, and Horizon's dispense fixture calls break_block, the path every player's mining takes (the single player game, the server thread and LAN guests). It compares the drops, the spilled contents, experience, sounds, events, statistics and the held stack. On main it shows every mined container losing its contents (#844, fixed by #855) and three gaps of Horizon's own, fixed here: - ItemStack.mineBlock: an item with a tool component counts as used, and wears its damage_per_block (2 for swords, the mace and the trident), also the mace and trident, whose tool component has no rules. Shears wear on every block but fire (ShearsItem.mineBlock). - DecoratedPotBlock.playerWillDestroy: a pot mined with an item in breaks_decorated_pots, unless an enchantment prevents it, cracks first and shatters. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game.rs | 89 +++++++++++++++---- .../src/game/dispense_fixture.rs | 61 ++++++++++++- crates/horizon-client/src/items.rs | 10 +++ .../parity/VanillaDispenserOracle.java | 74 ++++++++++++++- tools/test_block_removal_parity.py | 15 +++- 5 files changed, 221 insertions(+), 28 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 68058cbeb..85a191832 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -2505,6 +2505,75 @@ impl Game<'_> { } Ok(()) } + /// `DecoratedPotBlock.playerWillDestroy`: a pot mined with an item in + /// `breaks_decorated_pots`, unless an enchantment prevents shattering, is + /// cracked first (flags 260), so it shatters into its sherds. + fn crack_mined_pot(&mut self, pos: [i32; 3], state: BlockStateId) -> BlockStateId { + let registry = &self.pack.assets.registry; + let Some(mut pot) = registry + .state(state) + .filter(|s| s.name == "minecraft:decorated_pot") + .cloned() + else { + return state; + }; + let Some(held) = self.held() else { + return state; + }; + let breaks = self + .res + .items + .item_tags + .get("minecraft:breaks_decorated_pots") + .is_some_and(|t| t.contains(&*held.item)); + let enchantments = &self.res.stations.enchantments; + let kept = held + .enchantments() + .iter() + .any(|(e, _)| enchantments.in_tag("minecraft:prevents_decorated_pot_shattering", e)); + if !breaks || kept { + return state; + } + pot.properties.insert("cracked".into(), "true".into()); + let Ok(cracked) = registry.resolve(&pot) else { + return state; + }; + let at = BlockPos::new(pos[0], pos[1], pos[2]); + self.with_level(|b, level, ticks| b.set_block(level, ticks, at, cracked, 260)); + cracked + } + /// `ItemStack.mineBlock` for the held stack once a survival player has + /// mined the block `name`: an item with a `tool` component counts as used + /// and loses its `damage_per_block` on a block that doesn't break + /// instantly (`ShearsItem`: on any block but fire). + fn mine_block_with_held(&mut self, name: &str, hardness: f32) { + let Some(stack) = self.inventory[self.selected].clone() else { + return; + }; + let Some((per_block, max)) = self + .res + .items + .get(&stack.item) + .and_then(|i| Some((i.tool_damage_per_block?, i.max_damage))) + else { + return; + }; + let wears = if &*stack.item == "minecraft:shears" { + !self.res.items.block_in_tag("minecraft:fire", name) + } else { + hardness != 0.0 + }; + if wears && per_block > 0 && max > 0 { + let loss = self.durability_loss(&stack, per_block); + if let Some(held) = self.inventory[self.selected].as_mut() { + held.damage += loss; + if held.damage >= max { + self.inventory[self.selected] = None; + } + } + } + self.stats.add("used", &stack.item, 1); + } fn break_block(&mut self, pos: [i32; 3]) -> Result<()> { self.with_player_actor(|game| game.break_block_as_player(pos)) } @@ -2513,6 +2582,7 @@ impl Game<'_> { // ServerPlayerGameMode.destroyBlock. let state = self.world.block(pos[0], pos[1], pos[2]); let facts = self.res.facts.get(state).clone(); + let state = self.crack_mined_pot(pos, state); // Block.playerWillDestroy: mining their gold angers all nearby piglins. if self.guarded_by_piglins(&facts.name) { self.anger_piglins(false); @@ -2544,24 +2614,7 @@ impl Game<'_> { }); if removed && !creative { let held = self.held().cloned(); - // ItemStack.mineBlock: tools lose durability on blocks with nonzero hardness. - if facts.hardness > 0.0 - && let Some(stack) = self.inventory[self.selected].clone() - && let Some(max) = self - .res - .items - .get(&stack.item) - .filter(|i| i.max_damage > 0 && !i.tool.is_empty()) - .map(|i| i.max_damage) - { - let loss = self.durability_loss(&stack, 1); - if let Some(stack) = self.inventory[self.selected].as_mut() { - stack.damage += loss; - if stack.damage >= max { - self.inventory[self.selected] = None; - } - } - } + self.mine_block_with_held(&facts.name, facts.hardness); let harvest = !facts.requires_tool || self.res.items.correct_for_drops(held.as_ref(), &facts.name); if harvest { diff --git a/crates/horizon-client/src/game/dispense_fixture.rs b/crates/horizon-client/src/game/dispense_fixture.rs index fbad3cfc7..211dff57c 100644 --- a/crates/horizon-client/src/game/dispense_fixture.rs +++ b/crates/horizon-client/src/game/dispense_fixture.rs @@ -284,7 +284,7 @@ impl Game<'_> { let state = self.world.block(origin.x, origin.y, origin.z); let mut used = Vec::new(); if let Some(op) = case.get("remove") { - self.fixture_remove(origin, op)?; + used = self.fixture_remove(origin, op)?; } else if let Some(op) = case.get("use") { used = self.fixture_use(origin, op)?; } else if let Some(op) = case.get("use_item") { @@ -788,8 +788,9 @@ impl Game<'_> { other => *other = Tag::List(vec![item]), } } - /// `Level.setBlock`, `destroyBlock` or `removeBlock` on the case's block. - fn fixture_remove(&mut self, origin: BlockPos, op: &Value) -> Result<()> { + /// `Level.setBlock`, `destroyBlock` or `removeBlock` on the case's block, or + /// a player mining it (`fixture_mine`). + fn fixture_remove(&mut self, origin: BlockPos, op: &Value) -> Result<Vec<String>> { match op["op"].as_str().unwrap_or("") { "set" => { let state = BlockStateId(op["state"].as_u64().unwrap_or(0) as u32); @@ -803,9 +804,61 @@ impl Game<'_> { "remove" => { self.with_level(|b, level, ticks| b.remove_block(level, ticks, origin, false)); } + "mine" => return self.fixture_mine(origin, op), other => return Err(format!("unknown removal {other}").into()), } - self.process_level_events() + self.process_level_events()?; + Ok(Vec::new()) + } + + /// A survival player three blocks south of `pos` mines it holding the + /// case's item (`break_block`, which every player's mining goes through): + /// the statistics and the held stack, as `VanillaDispenserOracle.mine` + /// prints them. + fn fixture_mine(&mut self, pos: BlockPos, op: &Value) -> Result<Vec<String>> { + let stack = parse_stack(op["item"].as_str().unwrap_or("-"))?; + self.mode = GameMode::Survival; + self.creative = false; + self.player = Some(PlayerMotion::new( + self.motion, + horizon_core::geometry::Vec3::new( + f64::from(pos.x) + 0.5, + f64::from(pos.y) + 1.0, + f64::from(pos.z) + 3.5, + ), + )?); + self.yaw = 0.0; + self.pitch = 90.0; + self.keys.clear(); + self.inventory[self.selected] = stack.clone(); + self.offhand = None; + let state = self.world.block(pos.x, pos.y, pos.z); + let block = self.res.facts.get(state).name.clone(); + let item = stack.as_ref().map(|s| s.item.clone()); + let before = |game: &Self| { + let used = item.as_ref().map_or(0, |i| game.stats.get("used", i)); + (used, game.stats.get("mined", &block)) + }; + let (used, mined) = before(self); + self.break_block([pos.x, pos.y, pos.z])?; + let (used_after, mined_after) = before(self); + let mut out = Vec::new(); + if let Some(item) = &item + && used_after != used + { + out.push(format!("stat {item} minecraft:used {}", used_after - used)); + } + if mined_after != mined { + out.push(format!( + "stat {block} minecraft:mined {}", + mined_after - mined + )); + } + out.push(format!( + "mine held {}", + canon_stack(self.inventory[self.selected].as_ref()) + )); + Ok(out) } /// `EntityType.create` and `snapTo` for one target: no spawn finalization. diff --git a/crates/horizon-client/src/items.rs b/crates/horizon-client/src/items.rs index 2782d254f..5783eb698 100644 --- a/crates/horizon-client/src/items.rs +++ b/crates/horizon-client/src/items.rs @@ -67,6 +67,9 @@ pub struct ItemInfo { pub block: Option<BlockStateId>, pub tool: Vec<ToolRule>, pub tool_default_speed: f32, + /// The `tool` component's `damage_per_block`, when the item has the + /// component (a mace or trident has one without rules). + pub tool_damage_per_block: Option<u32>, pub food: Option<(u32, f32)>, pub can_always_eat: bool, pub consumable: bool, @@ -528,6 +531,9 @@ impl Items { tool_default_speed: c["minecraft:tool"]["default_mining_speed"] .as_f64() .unwrap_or(1.0) as f32, + tool_damage_per_block: c + .get("minecraft:tool") + .map(|t| t["damage_per_block"].as_u64().unwrap_or(1) as u32), food, can_always_eat, consumable: c.get("minecraft:consumable").is_some(), @@ -694,6 +700,10 @@ impl Items { songs: HashMap::new(), } } + /// Whether `block` is in the block tag `tag` (`minecraft:fire`, no `#`). + pub fn block_in_tag(&self, tag: &str, block: &str) -> bool { + self.block_tags.get(tag).is_some_and(|s| s.contains(block)) + } fn block_matches(&self, spec: &str, block: &str) -> bool { match spec.strip_prefix('#') { Some(tag) => self.block_tags.get(tag).is_some_and(|s| s.contains(block)), diff --git a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaDispenserOracle.java b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaDispenserOracle.java index 19779739b..2002285e3 100644 --- a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaDispenserOracle.java +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaDispenserOracle.java @@ -170,14 +170,82 @@ public final class VanillaDispenserOracle { throw new IllegalStateException("no slots in " + be); } - /** The removal a "remove" case runs on the block at its origin. */ - static void remove(VanillaBlockUpdateOracle.World w, BlockPos origin, JsonObject op) { + /** The removal a "remove" case runs on the block at its origin; a player's mining prints its statistics and held stack. */ + static List<String> remove(VanillaBlockUpdateOracle.World w, BlockPos origin, JsonObject op) throws Exception { switch (op.get("op").getAsString()) { case "set" -> w.setBlock(origin, Block.stateById(op.get("state").getAsInt()), op.get("flags").getAsInt()); case "destroy" -> w.destroyBlock(origin, op.get("drop").getAsBoolean()); case "remove" -> w.removeBlock(origin, false); + case "mine" -> { + return mine(w, origin, op); + } default -> throw new IllegalStateException(op.toString()); } + return new ArrayList<>(); + } + + /** + * A survival player three blocks south of `pos` mines it holding the case's + * item: the real `ServerPlayerGameMode.destroyBlock` (playerWillDestroy, + * removeBlock with the block entity's side effects, mineBlock, playerDestroy's + * statistic, exhaustion and drops). The statistics and the held stack follow. + */ + static List<String> mine(VanillaBlockUpdateOracle.World w, BlockPos pos, JsonObject op) throws Exception { + Miner player = (Miner) VanillaBlockUpdateOracle.allocate.invoke(VanillaBlockUpdateOracle.unsafe, Miner.class); + player.world = w; + player.hand = stack(op.get("item").getAsString()); + player.offhand = ItemStack.EMPTY; + player.stats = new ArrayList<>(); + VanillaBlockUpdateOracle.set(net.minecraft.world.entity.player.Player.class, player, "abilities", new net.minecraft.world.entity.player.Abilities()); + VanillaBlockUpdateOracle.set(net.minecraft.world.entity.player.Player.class, player, "foodData", new net.minecraft.world.food.FoodData()); + var advancements = (net.minecraft.server.PlayerAdvancements) VanillaBlockUpdateOracle.allocate.invoke(VanillaBlockUpdateOracle.unsafe, net.minecraft.server.PlayerAdvancements.class); + VanillaBlockUpdateOracle.set(net.minecraft.server.PlayerAdvancements.class, advancements, "activeTriggers", new HashMap<>()); + VanillaBlockUpdateOracle.set(net.minecraft.server.level.ServerPlayer.class, player, "advancements", advancements); + var at = net.minecraft.world.phys.Vec3.atBottomCenterOf(pos).add(0, 1, 3); + VanillaBlockUpdateOracle.set(Entity.class, player, "position", at); + VanillaBlockUpdateOracle.set(Entity.class, player, "blockPosition", BlockPos.containing(at)); + // PiglinAi.angerNearbyPiglins looks around the player's box (gold, chests, barrels...). + player.setBoundingBox(EntityTypes.PLAYER.getDimensions().makeBoundingBox(at)); + var gameMode = new net.minecraft.server.level.ServerPlayerGameMode(player); + VanillaBlockUpdateOracle.set(net.minecraft.server.level.ServerPlayerGameMode.class, gameMode, "gameModeForPlayer", + net.minecraft.world.level.GameType.SURVIVAL); + gameMode.destroyBlock(pos); + List<String> out = new ArrayList<>(player.stats); + out.add("mine held " + ParityData.canon(player.hand)); + return out; + } + + /** The player of a "mine" case: a survival `Clicker` whose selected inventory slot is its main hand. */ + static final class Miner extends net.minecraft.server.level.ServerPlayer { + VanillaBlockUpdateOracle.World world; + ItemStack hand, offhand; + List<String> stats; + Miner() { + super(null, null, null, null); + } + @Override public ServerLevel level() { return world; } + @Override public boolean hasInfiniteMaterials() { return false; } + @Override public boolean isCreative() { return false; } + @Override public boolean isSpectator() { return false; } + @Override public EntityType<?> getType() { return EntityTypes.PLAYER; } + @Override public net.minecraft.core.Holder<EntityType<?>> typeHolder() { return EntityTypes.PLAYER.builtInRegistryHolder(); } + @Override public ItemStack getItemBySlot(EquipmentSlot slot) { + return slot == EquipmentSlot.MAINHAND ? hand : slot == EquipmentSlot.OFFHAND ? offhand : ItemStack.EMPTY; + } + @Override public void setItemSlot(EquipmentSlot slot, ItemStack stack) { + if (slot == EquipmentSlot.MAINHAND) hand = stack; else if (slot == EquipmentSlot.OFFHAND) offhand = stack; + } + @Override public ItemStack getItemInHand(net.minecraft.world.InteractionHand h) { + return h == net.minecraft.world.InteractionHand.MAIN_HAND ? hand : offhand; + } + // Player.hasCorrectToolForDrops asks the inventory's selected slot: the main hand. + @Override public boolean hasCorrectToolForDrops(BlockState state) { + return !state.requiresCorrectToolForDrops() || hand.isCorrectToolForDrops(state); + } + @Override public void awardStat(net.minecraft.stats.Stat<?> stat, int count) { + stats.add("stat " + User.key(stat) + " " + BuiltInRegistries.STAT_TYPE.getKey(stat.getType()) + " " + count); + } + @Override public net.minecraft.server.players.NameAndId nameAndId() { return new net.minecraft.server.players.NameAndId(new UUID(0L, 0L), "Player"); } } static boolean hasList(Object be) { @@ -324,7 +392,7 @@ public final class VanillaDispenserOracle { BlockState state = w.getBlockState(origin); List<String> used = new ArrayList<>(); if (f.has("remove")) { - remove(w, origin, f.getAsJsonObject("remove")); + used = remove(w, origin, f.getAsJsonObject("remove")); } else if (f.has("use")) { used = use(w, origin, f.getAsJsonObject("use")); } else if (f.has("use_item")) { diff --git a/tools/test_block_removal_parity.py b/tools/test_block_removal_parity.py index 35b0fdd2b..6ebbbf1d3 100755 --- a/tools/test_block_removal_parity.py +++ b/tools/test_block_removal_parity.py @@ -5,8 +5,9 @@ A container, jukebox, lectern, campfire, decorated pot, chiseled bookshelf, shelf, shulker box or another block entity holder at the origin holds random contents; the case then replaces it with `Level.setBlock` (another block, the same block in another state, with or without UPDATE_SKIP_BLOCK_ENTITY_SIDEEFFECTS), -destroys it with `Level.destroyBlock` (with or without drops) or removes it with -`Level.removeBlock`. Vanilla runs over the headless level of the dispenser oracle +destroys it with `Level.destroyBlock` (with or without drops), removes it with +`Level.removeBlock`, or a survival player mines it (`ServerPlayerGameMode.destroyBlock`, +holding a tool or nothing, #844). Vanilla runs over the headless level of the dispenser oracle (`VanillaDispenserOracle`, "remove" cases), which replays `LevelChunk.setBlockState`'s `BlockEntity.preRemoveSideEffects`; Horizon runs its game glue in a headless game (`HORIZON_DISPENSE_FIXTURE`). Both print the block changes, the contents left, @@ -63,6 +64,10 @@ LISTED = {'chest', 'trapped_chest', 'barrel', 'hopper', 'dispenser', 'dropper', REPLACEMENTS = ['air', 'stone', 'glass', 'water', 'oak_planks', 'barrel', 'chest', 'hopper', 'blue_shulker_box', 'dirt', 'tnt', 'copper_chest', 'oxidized_copper_chest', 'lectern', 'jukebox'] FLAGS = [3, 3, 3, 2, 18, 2 | 256, 816, 3 | 64, 1] +# What a mining player holds: the right tool, a tool too weak or of another kind (swords and maces +# wear 2 a block, shears any block but fire), or nothing. +TOOLS = [plain('diamond_pickaxe'), plain('wooden_pickaxe'), plain('stone_axe'), plain('iron_shovel'), plain('iron_sword'), + plain('shears'), plain('mace'), '-'] def contents(rng, name, slots, pool): @@ -135,8 +140,12 @@ def cases(facts, count, seed, only): op = {'op': 'destroy', 'drop': True} elif roll < 0.85: op = {'op': 'destroy', 'drop': False} - else: + elif roll < 0.92: op = {'op': 'remove'} + else: + # ServerPlayerGameMode.destroyBlock: a survival player mines it (#844). The tool comes + # from the roll, not another draw, so the cases after this one stay the same. + op = {'op': 'mine', 'item': TOOLS[int(roll * 1000) % len(TOOLS)]} case = {**h.environment(rng), 'mode': 'remove', 'pos': [0, 0, 0], 'cells': cells, 'items': items, 'remove': op} case.pop('raining', None) case.pop('thundering', None) From 20d9c4c9844e5ab618e650c6d16a46958bafe46f Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 15:55:40 +0200 Subject: [PATCH 109/163] Pair a respawned player again for the other players ServerLevel.removePlayerImmediately and addRespawnedPlayer: when a player respawns, every other player tracking it gets RemoveEntities and the next tick pairs it again as a new entity. The hub only cleared the respawned player's own tracker, so the others kept the dead body, lying down, wherever the player went (the host window too, on the server thread). The in-frame LAN host's death now reaches its guests (LivingEntity.die's EntityEvent DEATH), and its respawn goes through the same path. lan_e2e gets a `respawn` check: the host dies and respawns (and on the server thread the guest too), and the other side's client draws it dead, then alive. `status` lists the other players a client draws dead. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game.rs | 4 ++ crates/horizon-client/src/game/remote.rs | 7 ++++ crates/horizon-client/src/game/screens.rs | 5 +++ crates/horizon-client/src/lan/entity.rs | 29 +++++++++++++++ crates/horizon-client/src/lan/hub.rs | 15 ++++++++ tools/lan_e2e.py | 45 ++++++++++++++++++++++- 6 files changed, 104 insertions(+), 1 deletion(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 68058cbeb..89aacb7e5 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -3679,6 +3679,10 @@ impl Game<'_> { } self.audio .play("minecraft:entity.player.death", Some(at), 1.0, 1.0); + // LivingEntity.die: the LAN guests see the host's death animation. + if let Some(host) = &self.lan { + host.hub.entity_event(host.host_entity, 3, feet); + } self.screen = Screen::Dead; self.capture(false); } diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 680360c93..2b8b99066 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -3740,6 +3740,13 @@ impl Game<'_> { .filter(|t| t.kind == "minecraft:player") .map(|t| t.position) .collect::<Vec<_>>(), + // The other players this client draws dead (lying down, after EntityEvent DEATH). + "dead_players": self + .mobs + .iter() + .filter(|m| r.level_players.contains_key(&(m.id as i32)) && !m.alive()) + .map(|m| m.id) + .collect::<Vec<_>>(), // The player's own model exists (third person and the inventory draw it). "player_model": self.player_model.is_some(), "health": r.health.0, diff --git a/crates/horizon-client/src/game/screens.rs b/crates/horizon-client/src/game/screens.rs index 365dd5992..b6f17d70e 100644 --- a/crates/horizon-client/src/game/screens.rs +++ b/crates/horizon-client/src/game/screens.rs @@ -288,6 +288,11 @@ impl Game<'_> { if hit == Some(0) && self.remote.is_none() { let keep = self.ui.rules.bool("keep_inventory") || self.spectator(); self.experience.respawn(keep); + // The guests are sent the respawned host as a new entity, not the dead body. + if let Some(host) = self.lan.as_mut() { + let id = host.host_entity; + host.hub.respawned(id); + } // Autosaves keep a login position; death must resolve the respawn point instead. self.level.position = None; } diff --git a/crates/horizon-client/src/lan/entity.rs b/crates/horizon-client/src/lan/entity.rs index 4578423dd..ca951e53a 100644 --- a/crates/horizon-client/src/lan/entity.rs +++ b/crates/horizon-client/src/lan/entity.rs @@ -416,6 +416,11 @@ impl Tracker { pub fn clear(&mut self) { self.seen.clear(); } + /// Stop tracking `id` without a packet: the caller removes it from the + /// client, and the next tick pairs it again if it is still in range. + pub fn forget(&mut self, id: i32) -> bool { + self.seen.remove(&id) + } pub fn len(&self) -> usize { self.seen.len() } @@ -902,4 +907,28 @@ mod tests { assert!(!t.is_tracking(7) && t.is_tracking(8) && t.is_tracking(9)); } } + + #[test] + fn a_forgotten_entity_is_paired_again_at_the_next_tick() { + // A respawned player: the hub removes it from the other clients and + // forgets it, and the next tick pairs it again as a new entity. + let mut level = Entities::default(); + let mut c = Clients::new(); + let mut player = state(0.0); + player.id = 1; + player.kind = "minecraft:player".into(); + c.tick(&mut level, &[&player]); + c.tick(&mut level, &[&player]); + assert!(c.trackers[1].forget(1)); + assert!(!c.trackers[1].forget(1)); + c.tick(&mut level, &[&player]); + assert!(c.trackers[1].is_tracking(1)); + let paired = c.out[1] + .first() + .and_then(|p| play::Clientbound::decode(i32::from(p[0]), &p[1..]).ok()); + assert!( + matches!(paired, Some(play::Clientbound::AddEntity(ref a)) if a.id == 1), + "{paired:?}" + ); + } } diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index 5d593be2d..2f1459750 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -2106,6 +2106,18 @@ impl Hub { .map(str::to_owned) } + /// ServerLevel.removePlayerImmediately, then addRespawnedPlayer: the other players + /// lose the dead player's entity (ServerEntity.removePairing) and are sent the + /// respawned one as a new entity at the next tick. Their clients would otherwise keep + /// the dead body, lying down, wherever the player goes. + pub fn respawned(&mut self, id: i32) { + for g in &mut self.guests { + if g.entity_id != id && g.tracker.forget(id) { + g.send(&C::RemoveEntities(play::RemoveEntities { ids: vec![id] })); + } + } + } + /// PlayerList.respawn: back to `at` with a fresh start. The vanilla client waits on its /// level loading screen from the Respawn packet until the level info's "level chunks load /// start" event and the chunk under the player, so the packets follow vanilla's order. @@ -2132,6 +2144,9 @@ impl Hub { g.tracker.clear(); g.sent_chunks.clear(); g.chunk_queue.clear(); + let id = g.entity_id; + self.respawned(id); + let g = &mut self.guests[i]; // ServerPlayer.restoreFrom: the game mode again (onUpdateAbilities). g.send(&C::PlayerAbilities(play::PlayerAbilities { flags: g.ability_flags(), diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 4d13b1c22..44f974a0a 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -19,6 +19,9 @@ address. The script then checks, from both sides, what a guest's game used to ge - hazards: a guest in survival gets hungry sprint-jumping and is hurt by lava, a block at the eyes, drowning and the void (then respawns); - pvp: the guest and the host hit each other with a sword; with the pvp game rule off, nothing; +- respawn: a player killed is drawn dead by the other side, and alive again once it respawns (the + respawned player is a new entity to the others); the host dies, and on the server thread + the guest too; - containers: the guest's ender chest holds the guest's items, not the host's, and a double chest opens as 9x6 with the right half first; - feedback: the guest's command feedback names the guest and shows the numbers; @@ -84,7 +87,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', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'objects', 'projectiles', 'light', 'effects', 'portals', 'distance'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'respawn', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'objects', 'projectiles', 'light', 'effects', 'portals', 'distance'] class Game: @@ -575,6 +578,45 @@ def check_pvp(host, guest, out): return hits +def dead_players(game, want, ticks=60): + """The other players `game`'s client draws dead, once that is `want` (empty or not) or after `ticks`.""" + for _ in range(ticks // 5): + dead = remote(game)['dead_players'] + if bool(dead) == want: + return dead + game.wait(5) + return dead + + +def check_respawn(host, guest, out): + # ServerLevel.removePlayerImmediately and addRespawnedPlayer: a respawned player is removed + # from the other players and paired again as a new entity, so their clients drop the body. + # The host window only has a client's view of the guest on the server thread. + for g in (host, guest): + back_to_game(g) + results = {} + sides = [('host', host, guest)] + ([('guest', guest, host)] if SERVER_THREAD else []) + for name, dying, watching in sides: + face_each_other(host, guest) + dying('command', command='kill @s') + dying.wait(30) + dead = dead_players(watching, True) + watching.shot(out, f'respawn-{name}-dead') + dying.raw('respawn') + dying.wait(40) + back_to_game(dying) + # Back within tracking range of the other player, wherever the respawn point is. + x, y, z = pos_of(dying) + watching('command', command=f'tp @s {x + 3:.2f} {y:.2f} {z:.2f}') + watching.wait(40) + alive = dead_players(watching, False) + watching.shot(out, f'respawn-{name}-alive') + results[name] = {'dead': dead, 'after_respawn': alive} + assert dead, f'the {name} was not drawn dead: {results}' + assert not alive, f'the {name} still lies dead after respawning: {results}' + return results + + def container_items(game): """The open container's stacks by slot (Horizon's container slots are 300 and up) and its size.""" slots = [s for s in game('screen').get('slots', []) if s.get('slot', 0) >= 300] @@ -1272,6 +1314,7 @@ def check_light(host, guest, out): CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'nametags': check_nametags, 'chest': check_chest, 'crafting': check_crafting, 'sign': check_sign, 'damage': check_damage, 'mobs': check_mobs, 'hazards': check_hazards, 'pvp': check_pvp, + 'respawn': check_respawn, 'containers': check_containers, 'feedback': check_feedback, 'titles': check_titles, 'commands': check_commands, 'recipes': check_recipes, 'trials': check_trials, 'walls': check_walls, From e8247df5f0f659ebecd675f18e29679a3c8b349e Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 15:11:04 +0200 Subject: [PATCH 110/163] Natural spawning reads a kept WORLD_SURFACE heightmap Every spawn attempt (`NaturalSpawner.getRandomPosWithin`) asks for the WORLD_SURFACE height of a column. Horizon scanned the column down for it each time, a chunk-map lookup and a block-name compare per block. Vanilla reads the chunk's heightmap. Chunks now keep WORLD_SURFACE: built on the first read, and dropped by a `set` that can move a column's surface (`Heightmap.update` leaves writes two or more below it alone). Natural spawning, the spawn rules' bat check and beacons read it. The unused `heights` field (never written after `Chunk::empty`) is gone. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../examples/save_batch_bench.rs | 1 - crates/horizon-client/src/chunk.rs | 107 +++++++++++++++++- crates/horizon-client/src/game/beacon.rs | 7 +- .../src/game/natural_spawning.rs | 8 +- crates/horizon-client/src/mobs/spawn_rules.rs | 6 +- crates/horizon-client/src/world.rs | 7 ++ 6 files changed, 118 insertions(+), 18 deletions(-) diff --git a/crates/horizon-client/examples/save_batch_bench.rs b/crates/horizon-client/examples/save_batch_bench.rs index 4ee5103de..d35ca8bbb 100644 --- a/crates/horizon-client/examples/save_batch_bench.rs +++ b/crates/horizon-client/examples/save_batch_bench.rs @@ -66,7 +66,6 @@ fn fixture(per_chunk: usize) -> (Vec<Arc<Chunk>>, Entities, Names) { for s in &mut template.sections[..8] { Arc::make_mut(s).blocks = PalettedContainer::new(block_strategy(), 1); } - template.heights = Arc::new([64; 256]); for i in 0..256 { let x = i % 16 - 8; let z = i / 16 - 8; diff --git a/crates/horizon-client/src/chunk.rs b/crates/horizon-client/src/chunk.rs index ce2c4ea71..857372045 100644 --- a/crates/horizon-client/src/chunk.rs +++ b/crates/horizon-client/src/chunk.rs @@ -3,7 +3,7 @@ //! (copy-on-write through `Arc::make_mut`). use horizon_core::paletted::{PalettedContainer, Strategy}; use horizon_world::registry::BlockStateId; -use std::sync::Arc; +use std::sync::{Arc, OnceLock}; pub const MIN_Y: i32 = -64; pub const HEIGHT: i32 = 384; @@ -45,6 +45,10 @@ impl Light { } } #[inline] +fn column(x: i32, z: i32) -> usize { + ((z & 15) << 4 | (x & 15)) as usize +} +#[inline] pub fn index(x: i32, y: i32, z: i32) -> usize { ((y & 15) << 8 | (z & 15) << 4 | (x & 15)) as usize } @@ -118,8 +122,10 @@ pub struct Chunk { pub x: i32, pub z: i32, pub sections: Vec<Arc<Section>>, - /// Highest non-air, light-blocking-or-fluid Y per column (MOTION_BLOCKING-like), for rain/sky. - pub heights: Arc<[i16; 256]>, + /// `Heightmap.Types.WORLD_SURFACE` per column (`z << 4 | x`): one above + /// the highest non-air block, or `MIN_Y`. Built on the first read; a + /// `set` that can move a column's surface drops it. + surface: OnceLock<Box<[i16; 256]>>, pub lit: bool, /// Light read from a save with `isLightOn`: no light job is needed. pub light_loaded: bool, @@ -148,7 +154,7 @@ impl Chunk { sections: (0..SECTIONS) .map(|_| Arc::new(Section::default())) .collect(), - heights: Arc::new([MIN_Y as i16; 256]), + surface: OnceLock::new(), lit: false, light_loaded: false, fresh: false, @@ -190,7 +196,52 @@ impl Chunk { if !(0..SECTIONS as i32).contains(&s) { return v; } - Arc::make_mut(&mut self.sections[s as usize]).set(index(x, y, z), v) + let previous = Arc::make_mut(&mut self.sections[s as usize]).set(index(x, y, z), v); + // `Heightmap.update`: a write two or more below the surface can't + // move it. Any other change rebuilds the map on the next read. + if previous != v + && let Some(surface) = self.surface.get() + && y >= i32::from(surface[column(x, z)]) - 1 + { + self.surface = OnceLock::new(); + } + previous + } + /// `getHeight(Heightmap.Types.WORLD_SURFACE, x, z)` (`x`, `z` within the + /// chunk): one above the highest block that isn't `air`, or `MIN_Y`. + /// Sections must change only through `set` once this has been read. + pub fn world_surface(&self, x: i32, z: i32, air: impl Fn(u32) -> bool) -> i32 { + let surface = self.surface.get_or_init(|| self.prime_surface(air)); + i32::from(surface[column(x, z)]) + } + /// `Heightmap.primeHeightmaps` for WORLD_SURFACE: each section from the + /// top, skipping those of one air state, until every column is found. + fn prime_surface(&self, air: impl Fn(u32) -> bool) -> Box<[i16; 256]> { + let mut surface = Box::new([MIN_Y as i16; 256]); + let mut found = [false; 256]; + let mut left = 256; + let mut values = [0u32; 4096]; + for (s, section) in self.sections.iter().enumerate().rev() { + if left == 0 { + break; + } + if section.blocks.uniform().is_some_and(&air) { + continue; + } + section.unpack(&mut values); + let base = MIN_Y + s as i32 * 16; + for i in 0..256 { + if found[i] { + continue; + } + if let Some(dy) = (0..16).rev().find(|&dy| !air(values[dy << 8 | i])) { + surface[i] = (base + dy as i32 + 1) as i16; + found[i] = true; + left -= 1; + } + } + } + surface } #[inline] pub fn light(&self, x: i32, y: i32, z: i32) -> u8 { @@ -261,4 +312,50 @@ mod tests { ); assert_eq!(Chunk::empty(0, 0).highest(air, |_| unreachable!()), None); } + /// The kept WORLD_SURFACE heights match a scan of every column after + /// each of a few thousand writes (air, cave air, stone, whole sections). + #[test] + fn world_surface_follows_writes() { + let (air, cave_air, stone) = (0, 7, 1); + let is_air = |v: u32| v == air || v == cave_air; + let scan = |c: &Chunk, x: i32, z: i32| { + (MIN_Y..MIN_Y + HEIGHT) + .rev() + .find(|&y| !is_air(c.get(x, y, z))) + .map_or(MIN_Y, |y| y + 1) + }; + let mut chunk = Chunk::empty(0, 0); + assert_eq!(chunk.world_surface(5, 5, is_air), MIN_Y); + for y in MIN_Y..MIN_Y + 70 { + for i in 0..256 { + chunk.set(i & 15, y, i >> 4, stone); + } + } + for i in 0..4096 { + Arc::make_mut(&mut chunk.sections[8]).set(i, cave_air); + } + let mut random = horizon_core::random::LegacyRandom::new(9); + use horizon_core::random::RandomSource; + for step in 0..4000 { + let x = random.next_int_bound(16).unwrap(); + let z = random.next_int_bound(16).unwrap(); + let y = MIN_Y + 40 + random.next_int_bound(120).unwrap(); + let v = [air, cave_air, stone][random.next_int_bound(3).unwrap() as usize]; + chunk.set(x, y, z, v); + if step % 7 == 0 { + for i in 0..256 { + assert_eq!( + chunk.world_surface(i & 15, i >> 4, is_air), + scan(&chunk, i & 15, i >> 4) + ); + } + } + } + // Out-of-range writes and unchanged states keep the map. + let before = chunk.world_surface(3, 3, is_air); + chunk.set(3, MIN_Y + HEIGHT, 3, stone); + chunk.set(3, before - 1, 3, chunk.get(3, before - 1, 3)); + assert!(chunk.surface.get().is_some()); + assert_eq!(chunk.world_surface(3, 3, |_| unreachable!()), before); + } } diff --git a/crates/horizon-client/src/game/beacon.rs b/crates/horizon-client/src/game/beacon.rs index 73cdd15a4..a6b8e84f3 100644 --- a/crates/horizon-client/src/game/beacon.rs +++ b/crates/horizon-client/src/game/beacon.rs @@ -99,11 +99,8 @@ impl Game<'_> { } /// `getHeight(WORLD_SURFACE)`: above the highest non-air block. pub(super) fn world_surface(&self, x: i32, z: i32) -> i32 { - let (min, max) = (super::MIN_Y, super::MIN_Y + super::HEIGHT); - (min..max) - .rev() - .find(|&y| !self.res.facts.is_air(self.world.block(x, y, z))) - .map_or(min, |y| y + 1) + self.world + .world_surface(x, z, |id| self.res.facts.is_air(id)) } /// `BeaconBlockEntity.tick` of the beacon at `key`. pub(super) fn tick_beacon_at(&mut self, key: (i32, i32, i32)) { diff --git a/crates/horizon-client/src/game/natural_spawning.rs b/crates/horizon-client/src/game/natural_spawning.rs index 80d26a823..846120eac 100644 --- a/crates/horizon-client/src/game/natural_spawning.rs +++ b/crates/horizon-client/src/game/natural_spawning.rs @@ -198,10 +198,14 @@ impl NaturalLevel for GameLevel<'_, '_> { fn spawn_mobs(&self) -> bool { self.game.ui.rules.bool("spawn_mobs") } - /// Scanned down the column: sections of air alone are skipped (air counts - /// for no heightmap), and an unloaded column reads as air. + /// WORLD_SURFACE (every spawn attempt's) is the chunk's kept heightmap. + /// The others are scanned down the column: sections of air alone are + /// skipped (air counts for no heightmap). An unloaded column reads as air. fn heightmap(&self, kind: Heightmap, x: i32, z: i32) -> i32 { let world = self.w.world; + if kind == Heightmap::WorldSurface { + return self.w.world_surface(x, z); + } world .chunks .get(&(x >> 4, z >> 4)) diff --git a/crates/horizon-client/src/mobs/spawn_rules.rs b/crates/horizon-client/src/mobs/spawn_rules.rs index 22f9206af..1cdca41b9 100644 --- a/crates/horizon-client/src/mobs/spawn_rules.rs +++ b/crates/horizon-client/src/mobs/spawn_rules.rs @@ -589,11 +589,7 @@ impl SpawnLevel for super::MobWorld<'_> { self.sea_level } fn world_surface(&self, x: i32, z: i32) -> i32 { - let top = crate::chunk::MIN_Y + crate::chunk::HEIGHT; - (crate::chunk::MIN_Y..top) - .rev() - .find(|&y| !self.facts.is_air(self.world.block(x, y, z))) - .map_or(crate::chunk::MIN_Y, |y| y + 1) + self.world.world_surface(x, z, |id| self.facts.is_air(id)) } fn peaceful(&self) -> bool { self.difficulty.effective == 0.0 diff --git a/crates/horizon-client/src/world.rs b/crates/horizon-client/src/world.rs index 350201e5e..49e621f48 100644 --- a/crates/horizon-client/src/world.rs +++ b/crates/horizon-client/src/world.rs @@ -283,6 +283,13 @@ impl World { } Ok(()) } + /// `getHeight(Heightmap.Types.WORLD_SURFACE, x, z)`: one above the highest + /// block that isn't `air`, or `MIN_Y` (also where the chunk isn't loaded). + pub fn world_surface(&self, x: i32, z: i32, air: impl Fn(BlockStateId) -> bool) -> i32 { + self.chunks.get(&(x >> 4, z >> 4)).map_or(MIN_Y, |chunk| { + chunk.world_surface(x, z, |v| air(BlockStateId(v))) + }) + } pub fn block(&self, x: i32, y: i32, z: i32) -> BlockStateId { self.chunks .get(&(x >> 4, z >> 4)) From be03fec7fcaebafb811ee713a7073bb9f6730bd9 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 15:10:32 +0200 Subject: [PATCH 111/163] Server ticks: HORIZON_SPIKES logs slow ticks with their CPU time and spans With HORIZON_SPIKES=MS, a dedicated or integrated server tick longer than MS ms is logged with the server thread's CPU time over the tick and the tick's spans (tick_mobs, streaming, ...). A tick with much more wall time than CPU time waited for a lock or for a core. The spans recorded on a server thread were never taken before, so they grew for as long as the server ran with HORIZON_SPIKES set. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- Cargo.lock | 1 + crates/horizon-client/Cargo.toml | 4 +++ crates/horizon-client/src/game/dedicated.rs | 2 +- crates/horizon-client/src/game/integrated.rs | 4 +-- crates/horizon-client/src/game/levels.rs | 33 +++++++++++++++++++- crates/horizon-client/src/spans.rs | 19 +++++++++-- 6 files changed, 56 insertions(+), 7 deletions(-) diff --git a/Cargo.lock b/Cargo.lock index b4081e7af..aa41f656f 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -1435,6 +1435,7 @@ dependencies = [ "naga", "png", "pollster", + "rustix 1.1.5", "serde", "serde_json", "sha2", diff --git a/crates/horizon-client/Cargo.toml b/crates/horizon-client/Cargo.toml index ffccb88e8..8713bc1b7 100644 --- a/crates/horizon-client/Cargo.toml +++ b/crates/horizon-client/Cargo.toml @@ -51,6 +51,10 @@ horizon-dualsense = { path = "../horizon-dualsense" } # HTTPS to the Minecraft services (online-mode session join). ureq = { version = "2", default-features = false, features = ["tls"] } +[target.'cfg(unix)'.dependencies] +# The server thread's CPU time per tick (`HORIZON_SPIKES`, spans.rs). +rustix = { version = "1", default-features = false, features = ["std", "time"] } + [target.'cfg(windows)'.build-dependencies] # The icon resource in the .exe (build.rs). winresource = "0.1" diff --git a/crates/horizon-client/src/game/dedicated.rs b/crates/horizon-client/src/game/dedicated.rs index 8a8ed63f9..59f0cf6f3 100644 --- a/crates/horizon-client/src/game/dedicated.rs +++ b/crates/horizon-client/src/game/dedicated.rs @@ -683,7 +683,7 @@ impl Game<'_> { self.ticks = self.ticks.max(1); } // MinecraftServer.tickServer: while paused only the connections run. - self.tick_server(paused)?; + self.tick_server_timed(paused)?; if idle_timeout > 0 { self.kick_idle(idle_timeout); } diff --git a/crates/horizon-client/src/game/integrated.rs b/crates/horizon-client/src/game/integrated.rs index b2c0a2e7f..b4b41801f 100644 --- a/crates/horizon-client/src/game/integrated.rs +++ b/crates/horizon-client/src/game/integrated.rs @@ -335,11 +335,11 @@ impl Game<'_> { self.run_tasks(); if flags.paused.load(Ordering::Relaxed) { // Only the connections run. - self.tick_server(true)?; + self.tick_server_timed(true)?; } else { self.follow_distances(&flags); let started = Instant::now(); - self.tick_server(false)?; + self.tick_server_timed(false)?; self.debug_charts.log_tick(started, started.elapsed()); flags.smoothed_tick_ms.store( self.debug_charts.smoothed_tick_ms.to_bits(), diff --git a/crates/horizon-client/src/game/levels.rs b/crates/horizon-client/src/game/levels.rs index 3a84e2f78..b4ad1c31a 100644 --- a/crates/horizon-client/src/game/levels.rs +++ b/crates/horizon-client/src/game/levels.rs @@ -23,7 +23,7 @@ use horizon_client::{ save::SaveDir, streaming::Streaming, tick_chunk_membership::TickChunkMembership, world::World, }; use horizon_world::level::{LevelEvent, Ticks}; -use std::{collections::HashMap, sync::Arc}; +use std::{collections::HashMap, sync::Arc, time::Instant}; /// Server ticks a level other than the Overworld stays loaded with no player /// in it, before it is saved and closed (vanilla unloads a level's chunks @@ -287,6 +287,37 @@ impl Game<'_> { self.close_idle_levels() } + /// `tick_server` as a server thread runs it. With `HORIZON_SPIKES=MS`, a + /// tick longer than MS is logged with its thread CPU time and spans. + pub(super) fn tick_server_timed(&mut self, paused: bool) -> Result<()> { + let Some(threshold) = self.options.spikes else { + return self.tick_server(paused); + }; + let (started, cpu) = (Instant::now(), horizon_client::spans::thread_cpu()); + let result = self.tick_server(paused); + let wall = started.elapsed().as_secs_f32() * 1000.0; + // Taken every tick: nothing else takes this thread's spans. + let spans = horizon_client::spans::take(); + if wall > threshold { + let cpu = horizon_client::spans::thread_cpu() + .zip(cpu) + .map_or_else(String::new, |(end, start)| { + format!(", cpu {:.1} ms", (end - start).as_secs_f32() * 1000.0) + }); + let list: Vec<String> = spans + .iter() + .filter(|(_, ms)| *ms >= 0.5) + .map(|(n, ms)| format!("{n} {ms:.1}")) + .collect(); + log::info!( + "Horizon: slow tick {wall:.1} ms{cpu} ({} mobs): {}", + self.mobs.len(), + list.join(", ") + ); + } + result + } + /// The levels this server tick runs, in `MinecraftServer.levels` order /// (the Overworld, the Nether, the End): every level with a player in /// it, or the Overworld while nobody is online. diff --git a/crates/horizon-client/src/spans.rs b/crates/horizon-client/src/spans.rs index 9fd91b2df..2a9c6d931 100644 --- a/crates/horizon-client/src/spans.rs +++ b/crates/horizon-client/src/spans.rs @@ -1,11 +1,12 @@ //! Named timings within a frame, for finding what makes a frame slow: //! `HORIZON_SPIKES=MS` prints the spans of every frame whose CPU time -//! exceeds MS milliseconds. Costs one clock read per span when enabled and -//! a relaxed load otherwise. +//! exceeds MS milliseconds, and of every server tick (dedicated or +//! integrated) longer than MS. Costs one clock read per span when enabled +//! and a relaxed load otherwise. use std::{ cell::RefCell, sync::atomic::{AtomicBool, Ordering}, - time::Instant, + time::{Duration, Instant}, }; static ENABLED: AtomicBool = AtomicBool::new(false); @@ -28,6 +29,18 @@ pub fn time<T>(name: &'static str, f: impl FnOnce() -> T) -> T { SPANS.with(|s| s.borrow_mut().push((name, ms))); out } +/// The CPU time this thread has used, where the platform tells it: a tick +/// with more wall time than CPU time waited (for a lock, or for a core on a +/// busy machine). +pub fn thread_cpu() -> Option<Duration> { + #[cfg(unix)] + { + let t = rustix::time::clock_gettime(rustix::time::ClockId::ThreadCPUTime); + Some(Duration::new(t.tv_sec as u64, t.tv_nsec as u32)) + } + #[cfg(not(unix))] + None +} /// The frame's spans, summed by name, slowest first; clears them. pub fn take() -> Vec<(&'static str, f32)> { let spans = SPANS.with(|s| std::mem::take(&mut *s.borrow_mut())); From fcf3a3e267bdc93d5637dac71b29b8459bca24b1 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 16:17:14 +0200 Subject: [PATCH 112/163] spans: test that the thread CPU clock counts work, not sleep Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/spans.rs | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/crates/horizon-client/src/spans.rs b/crates/horizon-client/src/spans.rs index 2a9c6d931..5c37f2bfc 100644 --- a/crates/horizon-client/src/spans.rs +++ b/crates/horizon-client/src/spans.rs @@ -54,3 +54,29 @@ pub fn take() -> Vec<(&'static str, f32)> { sums.sort_by(|a, b| b.1.total_cmp(&a.1)); sums } + +#[cfg(test)] +mod tests { + /// The thread's CPU clock moves with work done on it, not with time + /// spent asleep. + #[cfg(unix)] + #[test] + fn thread_cpu_counts_work_not_sleep() { + let start = super::thread_cpu().unwrap(); + std::thread::sleep(std::time::Duration::from_millis(50)); + let slept = super::thread_cpu().unwrap() - start; + // Busy until the clock shows 10 ms of work (a loaded machine gives + // the thread less than its wall time). + let mut x = 0u64; + let busy = std::time::Instant::now(); + let worked = loop { + x = std::hint::black_box(x.wrapping_mul(31).wrapping_add(7)); + let worked = super::thread_cpu().unwrap() - start - slept; + if worked.as_millis() >= 10 || busy.elapsed().as_secs() >= 10 { + break worked; + } + }; + assert!(slept.as_millis() < 25, "{slept:?} while asleep"); + assert!(worked.as_millis() >= 10, "{worked:?} while busy"); + } +} From 55cd4e90f45f2360123669746689d565af6fc849 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sun, 18 Oct 2026 00:20:04 +0100 Subject: [PATCH 113/163] Record startup phase, early-entry and memory verification --- .../loading-before-rest.png | Bin 0 -> 272498 bytes .../video-before-rest.png | Bin 0 -> 66359 bytes .../world-after-rest.png | Bin 0 -> 211784 bytes docs/performance/startup-stage-3.md | 14 ++++++++++++++ 4 files changed, 14 insertions(+) create mode 100644 benchmarks/startup-stage-3-20261018/loading-before-rest.png create mode 100644 benchmarks/startup-stage-3-20261018/video-before-rest.png create mode 100644 benchmarks/startup-stage-3-20261018/world-after-rest.png diff --git a/benchmarks/startup-stage-3-20261018/loading-before-rest.png b/benchmarks/startup-stage-3-20261018/loading-before-rest.png new file mode 100644 index 0000000000000000000000000000000000000000..6175d5283d3ad444e768df7c8ded38a811c79b8a GIT binary patch literal 272498 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⋙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%0DvLsQ+e<!2%?SgWj<H~p-Z|iSDu*Z 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 Ef*lzt1^@s6 literal 0 HcmV?d00001 diff --git a/benchmarks/startup-stage-3-20261018/video-before-rest.png b/benchmarks/startup-stage-3-20261018/video-before-rest.png new file mode 100644 index 0000000000000000000000000000000000000000..0e3a25194a76bd5e47a8d33658a673c8e2dee7e0 GIT binary patch literal 66359 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%0D+cwB3>3xxDAbSjd^ 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 Q;~h~}P?s-}HF^Gj01tI1-T(jq literal 0 HcmV?d00001 diff --git a/benchmarks/startup-stage-3-20261018/world-after-rest.png b/benchmarks/startup-stage-3-20261018/world-after-rest.png new file mode 100644 index 0000000000000000000000000000000000000000..12f71cd317308303028aaf3f0007d7dfa4032bc1 GIT binary patch literal 211784 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�>Qbo})VtPBL0X#1%q^iw}8kW9qlAbzty7ANb z$ziiM&~!GsR__Ht4jWFvr5y1^%oRvB@>@D;JW{?RAg9Y4LZo*ZS%-Y+W<Q}K+bP$K zM!7+AYKEm8#|oykEpt6a13eDL`Q&Xp;|)#KPG>>#rOXwjO%WvwFvBZ~veql{z)VFD z8w^{D&*$rA8}&MMGseE=?VFkl3jM0vqUUlcuw_RXz{~&A5&~Pcm!n_j=Q<!v%$m_R z>e<qS4xqW{M%~RGQ3lXha0#$m+^T4;C2#sL3xMYe!({D-FMMfLwbr6Hy{!bmbGYY- z%A}!~aa0UT>(o5}l}V%B@M5`=Nb%s4FMRsT4|V;p)Z-_e`wXQx3Cs0hz!~+4C~--Z z1WfUagej57YtMiuCno_U^58s7C5-`R9aAZX&FV2=B?SL`Fkk@Kv2#Zs9N5as+=i5Z zX%%b7cI=87aQ?1Fp@9lgHDaRQEIMV8%)69lt|$vOGJCdj52tGw&L8mox=nQe^?JPv zMVaU;Acc&2PzV@3;mK?`VM;+AsHDP&oi>lRq{LrP5E;Dil5JS5RMQl5{ov`319<k~ zQ@YQRdMc2TBY!RcCtvt9fDfJV#FrmB*>kvIX&*iBi(mS}Nl)B$0tlyE_$3T5o;1y9 zF20+O0pxM8q6B~oN}wlxIi=nQW%_BFL|!hwTZF?MJ6r#!g>)3dJYHkjFKKM9^2k`D zvD-A4H)3q$b9m%<q+!QPp5b8ZWn>_Z%z0QdouFKoHYq2jN)d@Ur_h;1!|>=M%HBo; zbY{bYWC)ZQo%DnWQ7TMFx7q+3OP=<qdJ)hJnXCp#Pce}4;Ol1_k&>xf`KaTjj4}h@ zbp(Kg7dsN9nM8mPAfQz3I#w~A08(gKaery`tXW|I=J(nFw!OX@eXrVYE_iO61E|dy zsx{9In5bgF!jm9OZm|>xwVOTw-3Sj~jnuUOz1Cj<C!PCr^!L}F{8&2_ls!jy4i_9& zMf>oXPY1)6`H#i5X26O4ZZ%%&UG8DrORgOQRuZuKHBA>iA_MMgK@P7kvq&AC0V5QG z^EQ<G@ZFdUI70#+nE}r^JF-Tz$|b-vS|<ivbigZMz&X0iPQ9?gEDlATgfpfw&r{UP zfQ!&9Q7i`oWs#mYDEalX4fS=s-iS%S;qcWL%wXJ;!k0`VVvt;>zSr49kg;zhhyV$* zqPcC}Sa1PM%$i1T4h9*@$_nr~K=>kj@bo9Y^6*CyT72W&x668Cbg9PyeE7_#pS<V8 z$}ziZ*`guuLSnL@{?tG@;rgf$GDdP`>bC(8Q&&<icQ2%T$}_-hUOpCfJ6JzmUolvP zkOOTa2jxgnmgHDU3}39Fn`cEW<(lEdvS-iS^wcykPR^KzbB~ujQXv{>Z2e>>7s@l- z!m)EQHJeHXT4XY~SVlk%a)3VOo7zN~xc~jm6}p%p5oNRFK{wSdOCCHAvMtjw98IJU zAOAs#zk_N6W|WvpUb?)`sUL6zm&8z=Hp&xvrKVS>47<(k7BAKGQcYL*k#1YKZL#fj z)orh<&hNDsUbKx8GfJ#6@4oB9pC<+iWoEO?l(;M<?3ND+A*7VxUUzzw_w`55dlDo` zqsF`opwsY#Cwy0Uj(FyCCw=hrCqH=F69}2BO4B5KJaN~FK=9wMKXD2|)pRuMh#9Z^ zeLhq}FV>3mV`uB@00WY5+$$`t%9{_ZHQ$Jvu*g1L`A%Pp{?@;TVqI>u6Ko^XGhUKH z**Bpl7UT|>5L~*p;J%E<7Xctf+>=rw`luqMlu`;VxGz*2!k16pb&75>!({RL>f^hj zx#;??2vD6RB+y#+JX>_?{!{mV)G)P^FMLV}shq74UTbtCxGks$6@RTv8djB|m-~MG zi2#~I)p`8R4`YA_fAz7GR=zJbCO<Bmsbk!vzkas9G3VzOS&BB+8jP>*&pXpSq=2Y$ zy@qR^ac;Her=R=w7G<^V%<t`RUqWK@QKijCl@v=>%-FP8WlCS#Z!hh4l%%UZis;&m zS(`Br?rAT)Xp=_Vm!2)SFAwf%AKcSc?Y#1{*1msfLE^MapJqDg24gxk=3Pj59Z^*# zVF@WDflP}55WZwO0T4a_eEH!Z^I)gx$EiR0qGzK2dX7-q>E@yb;Qb$a3cyFsdWHxm zoc%>2`s!mRDen8k-5&~~VUkLBZHR~wF+%tmtP@*B3O*G7Gqnuvf$mSeAN9ZPH*xY( z3JX7!tcwdb9Ce2V)<bZ@PEG$Q{_Am@>wN=2#)I);G8TNYI_gK3NS<4YmSk{h7%|3T zy$tr7xJ;1{oYY<VCwUC%4-{)Dc_vfa&KzmN1QtEZ@)s80qlN1hdAexrjQ2DjUnw{R z!+=vL*~usNOU7_n(Qy^om^n893kzlJ!;su~jAatd!+~W6-|Hc7QN{qX-{Op;65W&G z*v-v>)1t@8h<3htMx|a*W%j5t0M8bPL2VFVw|yaS*fEvpSCz}Cali#&xBY-nDH&tR zU?6;X*lVf)Uin!oPG+g9fdYP6s_Irn1EEv*6`HgHo)o;xfSC>`e=b6G+KBQJzVGD6 zpSu4<H5}zBru5H>0Ykv7Y6P6{i7%@9iu)=nGWX@Fmpq#{b|n|UMUq!@u6U;*K$7Lo zkC87;0%aO_209!)kSSh{I_jvNt_eRqIF;u?^hRFgJM2~#eKgEH4Vjk6YWw@hZ9L8# z!zvhhM@!~7){-%<M)@tdnvi27Wn5(pn3ToaPnegH!jk0}f^E7F4A3M;Cx%kmEE12D zcgMt@$^#pjFu*)iB@O%ao9Y9V1%SPK_jX}#E0dPWsj%sA3%$%${jKsEDRwxuwG{oj z|M|8QQqxJHZ3vFaqz=HUb-_LA2b}2Dw5q!22(!eLCYcCMTNoB21f0_8a77l=;~rH( ztWjmsc;Cs7f9au*8YX++$&WvB+lM1Q!ZZSf&ecSo&BKg`8VDzT;)?*DeKcUz0h3;E z0i62DuV$T7MREisyI7CJcLxv3a{I@FZBm{%RHDIcnhP+Caxn=aQVh7aar()@T#>=U z{5T4*+oHJHna3F+Y1RN#JKxW9SW&Kw$@xm*_~sEyF%Rd0{pMxB1&`KYyMLTzbkyb1 z0(>(Q=%)QXLO*hJ*X3^Q1Wzlh2*5cfF^MdhiVSu{mYg};s?9;}tA5<OcW<m;Vzn7l z*9lT8b#Y+jjeUfW0Jtv&k1V>uPsB+0QgSH;h((XY48H{KNraZ;z&$E-khaRqbA*&| zT0EX}S@=@;@LlP<5<q3rP+nI6K77WL?>qVNuRU=JB+8R|+C-=XO0FGn^ha<1pbW<x zWMr!903N;V{o{X43ntLbb8d7hZx|n0V=ihx^_Al`*H=#Hx?8P&VL2XGdDE7qRoSzv zygch^(EY`$vC)Vra<->%Uv*mcw4!S|smw)P9!Wv&qt=p3M4G{fFuT11ptIxwuv;8J zd7>-nI&B|7yXgyGNSFXLjQ~u}ngAAGwxgO#0QDUq1ek`?KK0C(zi_hK5uPo~vesPi zN>we$zF?B_f>vHsD!TWv+dnd~*#t1P)$$x(p47Q3LGWYgicdJ}nP(n6!6-5A$rH~B z^v~QCn#mxg5*kiC`%4H}_p^_l@PSjGS>Fvbv~((O=#hh0x{t<L_U_%=CkF#KZgV|R z4jy@C)(+Z`QUR;m<u@xK_|U>xJmd?#D!Urq-$qN}w{c!q+7JUSR$kou;$Wi;NVGI7 zVHQ%zAQV_igs#x&6_Fv~yFzdY38u3^z@@k@fTHi!cPgiX;CSM$lMrStghXwV0f1?w z?7q4g=&M!v(icv$Cc4bna|A$9>f+|22O{6$AUfgfFDm`{<9B_CK&M^uEI`~1bR{x2 z!vU0Nl21*7yFm_5sKjehvJ(cScx)v#K_I(wJTiR}2I)-mu?fdTeGX(v159wp7$jlu z-WOvo2?1)xaa$TiJY0r2Sg}}tET1RTXr3d3zG;c5lMEDnRHc~bOFl2E6+292o*qQ` zT(bgiAff`FS63-2KNa)i>hlI-NxLilYNZo14#%!sZL*l_RG&Xr!rUc|CC^^X@_QO+ ziuL-I<~x1|&&A>M7e9d#&y(PlPaojxXB&e*y}0*9^!n-sW%H5M@{|Ffv+PAp*ewo7 zqof0v*kmA<tQQp6h8JJ4rIZshW;Dj;k|(*`bYvGbTGgyf>j3KeUEO3La91eKs%+0r z%b(n00q|X+TdY&}Krk&$a4;RdBS4tkY(>z}hNZQ`I3>Y>5XVD(6XA9#F`a2dgi|i~ z$|JXbpj6cn%D#i!@aYFWbmAwzjO^^cxd5$lC8jOt;ni)nZ2x5V{j4xB_0X2m#?tfi z_U%XYyj&4XbPgP=6<T~{&XMM5Y6ydofhD-mH0GV$9AnSTRA_}XjIr$8vEv5^rZ*bX zUE|L3Vsxw+6gty_yIQ_i!yhb|)|W<Vs+gk|<+Tda03|X7(K=E2ymxMI+DMr~!ZJ&2 z>M%<)m}W2{D%bRK&CqpH6^*i1nKpv{B@Bxh7TdbBa@f&T70#j?OgGr{7Hei(N#!h3 zbt+SOFaweR%xtq}wpmtH(+q+H)8N^h=~SP0luR5XLzK`h1_|N8tmsxnuOD;(7?!5g z(b0dEtyghh1zKshxYD1WcFD8R@j^tUs_r>Fp5Wo>&wUs~kKgqH5Iu71`v5%sz=wLJ zmja;$MK4^#<?Ix3(5W1sdR0#lQ8T5$41?34sGcd}C(r;Q&~fTA7{6NfbeuKE8Phm8 zthhYN21YtuE=dvZvQ!r=M-*nZ@L5E(T`h@rRryYwtfU26%TFEx#>{kkH%8vrsEnPN zZw2!mQwdUD_7WD`v_+IU(S#)~P#zkx&WgSv$JKx7bHx(R^z48^qGM+pgD>yiy?Y0b zi0)IfM^p`qsbJi}v`EcmZ}zBi;M1g1DNxVlTDcPkI%EK0@KWd@h4zxKyrw&Kf6LA? z2ny@UX>tI*FO*2V>4>tz=ui)Oj__R}eV8>Se7NmEN(SIMqHl;!n`=7h7CYgrFMjdC zk0=KGv5UU)_+1}V6(TGSg))8O*<X74b03brp;*9`Rn<Rw&a(--Fgj0TWwZX$5S+zW zaL(X)ij?1ovSeuWM?Dd(cQC`!s3s;#m7!&}@UVTy_GqiBZ<g!JSp$?=qwf3Z6>od$ zq@`0OR}edtMpd=_{UngR;g8E4ji;>D29jv=GhkJA?%4Um{nHr>v|0odtiK|>=y6+f zS0jy5VOZlL%QZT|a(Ie}zWUpYxtv`~<npW@Jd(0UlPEeXZ2b67{XVJ#ZR*q8EFkc@ zs%<i%oQHv>mu&!o3qUF#E2q(uA5b$0KyB6p&|2~VRHt<)J{`L=C^PZICZo2=a61CP z#H?baj??72&H#u|)vTL=skk}smTEd_fhAfQdYulp8$N)k!%Cjb&64J{eWsBV(s!lX z;SYWG{naVcENPy@pZVNJ5M#Yg$G6IQ@XsI~i5r#%5ckCypZdm=4}8FB`bq?U^p5wP zdhyp1_->zg1j;_yiPBHcV(A(Bznq+!tk)Z<EfhQqG6RGt{b4!y;EQ|r9(C0A!3Sj8 z00;Pc#*`knrJ)?Vh7GVE@0+q9%#ktesV65TJ(y!G*?uac1%{2cjNH!<;`8OcTsbqQ z6+N4fmuIxjWM(`}zJ<uuKz593ADKj%`#CElM-Ck`4GWz@g#R;i2t5H;{q>LCQeR$9 z$Mo-2_@`}4N+K`b*kF3to=9dYU}}tI2<{&<%UD+lR3?npg4bH`vfm8DWQLjClwmQ? z=7~R9H7!~s38|Susz(WE26Z8wB_Of1&#}rHfXb8sz$j_;gN_80%XE1{uTC3~XfL}6 z`R>Oq3S?Q&;YxEJ{7s55Edq{y=$7{&j9`B9fe!$9^p5voW0%RviS;HSS^c_q?_73O z%GqR6y^#Z)3R99<T6qFnX)P#um6g#ZWKE~>P=J0c0Q$Jfw2pm~AGf7GS|4lwx+R8a z_LYFinI&eH0(RJ3aGMLRaz8dJn)-N-Fl!n!h#6F#)XS5)`rd7Gx6Ny_Ms3z;Eqbj* z&#Y)>S$p}PS}*@|%jx(srUNj`EUv6Z$b+Z0SXNbogl3YeuW1Z`VX^kI-)Z=rhNtM6 z+N#h(xMy>-#7Y(2_vGZ}Ks#NXHa>pY*CIyyl}AqKc2v<31_6KNk&nb7qnXYCD9y88 zVgOFP_-g<jzU7ZL_-VBPcyRLDoXCSmc^Q)Gt(*t1?`xSs$*Z;OdEteXZmEL5uGZG3 z4ZVK~a9moK*;>oduJh95;l4nRCrMD;4(~L40K)DWNo&D#THI;zv;pZB(*v=Uh=D@M z*sv0MY0P_#1rLB`G9{ra&#d|ZcX^);z-a}5R-}<(X|qR_l_$362&K?cY`r=aIB6@l z=SS}NAfVjDGyo@l;!6kxV!Q3D{*`aG5`|TpXMFk_2zjt?3oz14jA`uQTmI<D``@1s zoCE6DKPNyzBg?(M`&_P)u)T<gXliP*>&ubhW|g!P3;C1{b0&)qO9dwF?F(th^f1bD z9UJu2iU*Jt^3li`PLfYb)`RWJTeCu-GMsw)r;LVT_pU_$oYR#j7UMDEXPl>NT7*qL zT<39~?`+5hOZTwr0vxZ>>_s7YsS^_Ua}9<(<(u}LlN@(&%I{p6^)e3ZPA~!m;%|a4 zXwr+HXQY{@)8JULeBk0;zxd*dLnbZChGaK=<rM|MZu<Lv(gwf;+p@E=`IwUWo_mse zGT^2rYc6=r1<x#NW;u|LRW;#D;Y+8*otDp7kJYVy&{^Ie@bkHUtk3;pUHzb9hJ9Bm z<7<1#)Aax_QvE0;gfBT)TIzsb+D&e^c%)bN9Il|U>=x%PU*2y=eLa5n2TnTY%fbD? zV9f<Lo*YT(#!tKCYtc7`#q<*U@<Si|=(%47z%+&pUnVCea$X4!m6CpS4VF9*f>-&9 zyKxY9exa#e>utADm*7xRagV!$LDkpBG~(oxeO1v9&b4Qcs;JS_4?302Ml?30B&<&} z_o}jdz>xw(AdL?0=?EWNjwu6}pX(?nY2`@Ev><J|W-#9o0NG8>G!k4+Y&HSvG(1QM zE||tt=0VLO-;w1B-FJo4;ygsZQarU()tnaBbjJNIoORd9mURcC^v^2clH$HZ^reSB z_~A3Yq8PmT#wan*5tJ|Eda}P&4$t0f->W<i0+^cY^~s8_PkIb)cI@&%cSGNp{s;H& z-MfAJ_RLA6;SKft)cx@do9jQGpGx)Tl7&Z_RC&m^?aEuL?f;!Iz~Rkik3R*FE6IyI zYpzy&8qzr0Si`KiBTRL%ANxy|190AyN))w~r^8|slI{eW?D;(CB%I-=IRwBt!@*Pb zRHh-jH~tmtb#BVSUXMFqN|}FvdB%d6ua>GcH@7!w$f--i;vKjx8H0OHEso8d6u+v( z{$vbOI+%4C{1IuAJzJ;|sBB08$`gi!G)tQAaHwEk3Ec{?tdz}oAqH{@z^ZCMfJg+O zanSKy@z|a3_Z)uW*<U{Ctgq-MQ;b=8atU8P^x5}3^x5}(>7fq-Q2$l=5Ffhv-H5=e z0RUfoXhXYYrP_nn^@=z*H@AxC?0TEKR=vEMgyRhe9DL|b=BuL=+1_uMUEcTunw#5O zbl|l8jne?;pR=cqGy&KRe`3}I;C46wvl{^%<k>|CBssa+L>K|Q=LdDBkwS;oEk*!B z1W5(6rOGQmYbld$Yss5A+-l6bsxM`f1wb0O+YQNWEVzb2W<>|Uxhz#QWoKA=#i`Di zttA(L;Bxk;3IWUe?aGwl+TyfJz6#*cJKhh1@FW1HlVNEeJ@?tC9{7N6GUfcNgk7iQ zfBe(m{L(`obRA(@ti9}4ruC1U@zpQf{H`-E|IXw0yyukjzX9Nxhu#OEz2u*9>9>I3 ziea^Xk|6lzOJ5VKpIRs7%R)F-*?~#JLy&U{zJ*Y$kP)4gIj)^McJ_VqlliGkLQ~q$ z4ks8jL^wH((uikMj$JgYn}PvXV?0=g2Yu!Hd0g}q|52_kWeLGKMTQ`U#i)*Jp3?B1 z@{BOy!Qtaf7RQep;J$n2_8?I<%^6ZGk$+sVpJb5{=gPoXz{V+rRIHbKf_tK;6&dP# zWfqZ&-2$ji8|t4C>s8T2^@Co7iQze1_`-7~_az`zb_Yl}ZO%PeKj0|Kv>Mj(0ULnR z;qd{AP)8ky7U?v7^@nn~`uL~68U5rs0tj$IK7QG^0VwVp(9;nLQ!^?~<v47BGWwl; zqhI*@Z^-Jci<jd@yBELujK>>wd50kpuNsLP-fwv$gbA&SDR<>3*q*sPhk%YN=hzQB zW&(g&)(EK2ySm9LQJNzPW#0u4KxtA}u2P$KlmRs7UBob?qT;&(gi=ihu>7K1+pHr* z?NGAp!iycFq?zSz%3*{InCax%qB3PTEnkVPORw0~854k}gL9NBT4TX=J3`Y5K&h%b z9UlOQCT0u(?YggNWRw{9WnksK_-hZ{@?NIXX_tH*fD(c~e0mr5`3s-@qX~sT;t11X zo+F%=58%wpzY`7WnNa_H!Wmyv-32ogh{8W!M+unH#k?UBaC%nbp^f(uvpN!RGI=|C z?aF}=oC6D5<|Gd*m4LI0%-4FMt_$@+gAfB_K6=J64`a;-T=;}u1qpa~Mq$cN-G~zK z%AvtzPGpiyjAhE*9f0FDE%kk~Cp2uykwLXqNdg|Ks2Cyv%M^<`Ac0QZ?~!i@7<=~% znI#F!(ES*ptCUgFl<8OaGT^K=-7INDm^r-U2R>5}o|xa;aoYkC+z%vUtE}rLGYzH; z*A<0iX$t^M58yr(!p4^#{?L~m{*aXLT|q=o-v5EfHN3Ilf?$@I8bF-&e*UIEM8tQ2 zM6hMIa(rGS;cj43fuNvlT++l7mij_UC}${CKWy&6@+QX^q|rbLfeFYNrIRy&;SHPX zpj@FH@t6&kjh3AW<eT<n{)0FztYPFNNLf)kNsnje$I1UmiVw;gcryf?IbW<#TAh_b zPbZCQgoIIP^PF>~^2hCDph>SJKx=rAAEV?!4m>nGu~JfZZ`fS#BYscJtt9KE%p6X_ zp_Jz+OAPCb{-3^yGY&VVqKVuNcRGCY_VV;$CAY(aPn+8<-){MpNxd?uAO8C4mL26S zJId<U+9tEM$t+Lm<w?V}d8g?sm=3F|Syjzx_)f#GY}U(DMtRCGE4o?H-L~&`{KH>g z+xGfeB>M*L$}#t=#a9B?Dg}^flr<KH4wWZ#reku8shc#l#Z<mrn#Lrg)AHRWmlB*y zgfUURD;~N1y#OjxMtj)<aPm3Ne)OELDu1iT?|mPDGcWsAe7cp|S)p^N^7uXP8M;%Q z${Vn;%ZMtQji>3^GvL@YnuEr;z`538QO4TGA)u1Yms{@;P`R(kbgym?>k2!yXEmKV zS9N~V9-<v@oCe@@IE7fyD!+m%%_R>&xuye{IxI|w(BS|SFr?EFL|EEyN7YnkohApM zTdW#$!g4!4LM-U{y&d(XQPMnzO9>+QuFy@^TJlO&ZDO<4UiJwnPwAb8Z<x%ph46({ z)44AI3Q`3V0Jtq)oi*K-uj#B^_duvj8cGGNs!eXO6azL&%(OHBtz}Pvf1P~Z*FS&r zyAax>PdWb^58m{Ln$7?ym#fd;^oLeWKjr*yCMl46R={fin0oO#64s&bi+l+UWA#&8 z80>~}YBGoLpY*2W@TPL&8|S&6$7}D{u_OM|PYzCH4KQQ+QYy=##3P5AbS3dfX=x-z zIWY26qS1!9QsRaUP_BGzs-4yGs~So`?gS5Vg*3>5Ss4<)9eI{1ciMxD?)oYpx4GwH zy=Tv!z6WK|krv9?AY(01p7!O?wH=&|Kmu0(P@=8+n|qS`vRu>4HJ#}c1rY&=Khjum z>hq3eX_lo4Pey)EQ(LX6tyXo)u-pE==UQ>R4yVJNPB)4vP)AEh3C&=Ts7@R01_xk< z!f`n?ODn-N3}OnBHwa%EB?c+YsxE=aE!N}~3o=ka>tWQg5nyc+fY!2Slr-1jcFT|E zR=Hm(c~=D!KXmK6Ln1|<ZS7Rvu<=FVF&{tcBy@D&#?>F$dIdYJHN^48TH)k5-U#yg zM)RLqm)-yBM=~!mypd;s^*kT%ECmoChW?eR(dsD@q6fS(0glUV_)-LRW6u?kFicVo zUy*`Z%I@Flx}uu|1diEKqP5_Wl!i&3BOu|leZ`vrSXHflz(K@=31&$nK#9T+-ux~A zXJ7Fh0Cvmw9C7v)f2@TnXbMfpkKgl03DA<!P-4Zc9zQhmZXPRd&#a~+pXD*lrT`qK zXQ_;AX`$I>NK@!HrKILLPBY<U?Ef4Fo?JMY*`vs`B4-^peSmq4NMod>nsRdz-@k$> zaH46Se4vd9E0|%=TaB`I$LSbp&gVB!u;0+qoVK7Caz>27X+Z5;EjdZ{P>!23>vhfp zq2Kfyzi=lcKF>8Rg${%v6Wa>~I>aetz|!0;wV9Gx)@sv6<nvsM#R1z*AAsx?|E3S? zW-wG`X`c;1xlb!sXSeMKtgfsBXfC?GE2g)V5Jna2CTrKdAV7!$9<N)>Y4fSAmecYz zo#__y9idpPYx9T=D5`XeaaUGnjn;zaw0tETSEqE(ksvrNzcy>SEe^n{X`Q-1wZ&3? z&aTY^petJ_rmMIwfXD8BkLL*WQ}o|xn5SLv?cf5CBblJp`f<huX{?&(JmI`~?n()I z$f9Agl<AY5w{jnK>D3}d^iSufbIn@D6peg~9dIhnR@WDpv>bh>wLMPW7QyBGqNKe( z<I`_vp*xMb3<-K*8eYHGBr|H)h5V?KRM1k&;p(n@O6mTtDN`w3(A7L4LvXrUJ1Pu- zGL9ye){@^^^oGu|=ZFZzF|jzU1mvtrWF8L5D%EtA@5rj^iaY8SYcKl%ycUm=F$9$- z^y;hufH5LQQc6gvnVN19q?|sy1PRiJ=>!?ZL0Rl0AAj~^7knf1zGeW<zT!KN-Q9Jw zQeS@j)8CH%KJ|ic0q|_`)aT#R>-d&+A9SieN4n@-_S;oZS4D5;`f9`0U0=OH0y<y) zyZq1%A3qed${S}Juh~54DgZY!&_-qXfD=U})epLwLCT$qfaQHoRE-%#z?K~qs9+wz ztN@`L+{GsWB!^YjB0)p>Dywi|yXosO(8oyXZO*&3SyM{coOcP(OcGLp5D&QWZ2_QE z)dd%wCifi<f^IQLwCjFlQV$rm#KOzA(px-!&wGs$JMqk~J^lIjee8m7JpK9if$-Qp z@A=pT-~8Bx-+b)uKZ;v?JzG3__q)xK=G&qlhc_NLJK&!s0jGMr)&6mB{oV)Tb2PXK zhF}sGiNPJR+j2N<#Ud*bJL>yhCOnu$4CNgE0G*-wl+v1#<Cb?bh)FCmv0CbU4PUUK zJr2Q>Ub%3bNqnL^+r})Z0jUG%#6@?-kdiLuW-c!Eke9vVC|{dW=GkB}--8)vOX8&W zyN@NEu6y?E>EBTa0)2SM49K{>XjB8^iq51Abm+v;+<{*cCb=7REYmg|1E3qJ+K$S! zp$4pAmWS=C)VIwjv5e&!l%D<Yo7TJwE(36C8T@2bwRmgg5TL4D(`4jzC822mq+u~B z(XRV5hnIX;KK+IFBXp`#JQ$%P*kgD95kmauryqQ;5`2{qe9~FpK&X}<@*an`CiQ=} z@&>oZE$in+jwpPY9d%X$A$Y^z>&HD`tF{m;>|^82e=%YX-58-mL`zXXR|M>NVb3Z} z!UmZwUF8jY`JY>6iOn8W2C(>2M*>q@Ek#&)!Z^6M?b*Vp1wyLp3IJ1Etf&=b@txgX z2Jqb9F9A66*dRB+@_t7R*Ra^Zy&b3NA9?%)0F`ps>2Ry8F)eVpLJa_v>9;(k`;Ks$ zJ^)5Q2t}#H--%78nzbOg!nE!=!fE=x!wr+^CR^NR8z!?`yj0cOb<Zd<NNnCwhJ@>I z<$k5^O<{^dUy0)<o%M}J?|!!u>Q1}x+mGD!E>%;H8H0z5p}qg|YR8+c9}iUPyY6Lf zmklHM(lA03d!d0UGVQ@Umg(Ma=Jw2?HXS{iB;BUU$9aYT<TI%j6oUw<h*ZRKBs?0a z>mh=7LE|wM?_gNAr&T%ei~gKA35BT5H02iDDjC8V4X@ri;j$Pd8R8vfisM=G@o+3Z zMW^DvSu!+XfQG@dLMH4=*?*EqDl+!iuQFXwj>*ue^RFXJPZT}gT=axMZN`kxhtgE% znO@V<;xS86(2yh|3D*gP$mW8pK#^KYT^qB~IU~&X0Kls0iU%VkKx1lPQcCh1VaE8P zW@_ByttD@Aiy4iyz3hP?xRd}%crJ&8-SR(o;~#$F%0E_hDpN*d-nE<l=Wh6ePh9z* z;yHuk#m^Uvlvv#A8_d>^^PL2TjK|AS+jk6(;hz?!hMi@(a51x5D5~+J4LYww*<tQV zt4YAPI*@DBJB^{nYWBX$t*@{2o9k7}xA2|Xo0ES?cYr!}0F!5K&kGywwU3o<b^*5@ za2M{&@?=le0qKIwzWK_SVQE;}AUA2uJCz9|nmWNH2$c!Fwd^rQX4wEixS}=hR>PbP z#7GJW2E)=ko4Xw@I5Z6)_@2~Fil+-y#j5F@r9d37?{@%lZO#}~W^_m?iKIkj((qjF zH2DKJ{K3SmX;=)P$QrFY%1=7$8xdsgX%~G5LEfjx)>#zkf&jR+<E;T6oC8Kf=IpU3 z8b%(*mM!@1o!g^$aJ<^Fv-Lh6oHDM|VGRE!b6lzQld`>JdyLCMbmk;4eM+;=rL@Hz z#<g-vv`KTbI%jh<oUsbWMXcguOBR&z6H&3$STX|yW0;UyAca}BV{ab$co0fr=mw+A z0VW<hGLyWN7w6d7<vug{+}xfNlz7=Unhf*s5HtCpC_FG%gQ9SE_9RfMYNeXy`u_9( zu>8^wTSvcj>ab&~Zil-azf<=*b#G#eQJXTFOP=cr*Abix0Iemrwd5*L4uv$ST2wiO z+_vwweYef04l7L^RtnN6wP7&rxxZiD_p{dI7He{|1z^+RB^B3{usI|e3$E`<3CT3p zUh<g+y`(9bI6%UR9+c2cf`nPt>}DWmS0=PeZvGRiq5-g5KBNqIwuJ8qNE{3SxlX&_ zTL8|v@;@Q8_}+j0J0H0IoxUv|x$_SR_~=>RT=@~?R*xU)#oxGwoxO8=R=bOzTbRc6 zb*^4hm(=3Dudg+CeNDL=eOs;v+-8F8yZT4d$_ulq+VXxUu+#$PL{@@Ax6LJ_0=RJ6 zJn>G$z<jUYS!rpX1Hj>4X-2DUGNT8hVB*%2*J%X0=+?Xoz;}d{Qq!5Pliv{lCT2}d zV=6a8#Dk^8(mrSD6({i2k`O{liRFEc0+)X5?mvQrrZEZFEe;7O<??>l_oM>kl0f62 zgOCTSa{p(3|D3D8i{5lkW|^%Vi^r`VKN1^W{X=EcGRT8pziD~wz5D_;`PIyi3(ox7 zpZmYyxUXh_>-8)8ro&5{4llj%{W^f1Z=OVm1#On~NNzqj*Wp|oc62rV<iblGx5M}T zs1D$$H%<b0@y89%5i{E?08yr1w+#TVdHXbg=l@|D5?gkb0nG2UD^ofF3gOu-u};&s z0<=i9=3Rw9RhiUPazMca(-?r(vR@5T9x2x<&ckfMq0_k(fx^RX@lsVQPiowknigPY zxi-J}rau92&o%D^VfhvN{M~>0$X)L`?ZR&ZAfnIR^!vI_0M5DkyZ2xJPTvuIK2Ve% z^wNh`71rsm<<;J3wtm$6T&C+#p6Hi!&2vtzZ!S-(L|ydWz1w@U1RgtE|7n^rSR9>W zbX;v4g(tR?#%i22w$a$OZQD*`+fI`-wrw<-*tQxw-@M<CS@Y+dHEYc|kM6zqb(_y8 zDD291D;%ocD;1J_pUBZglz5#v|I4PVi)v;)nH(}AuF^A~P+wcqz*7u?x9+IE=39su zm}zgo(tVyn9-fllMT+lCqDh$#RId>#>l%~_$U`@z53Y?{*S*eeY;Py=r16=j2BRwZ zYD!G8k+w3_^%6-1@2<ye;IS*4Nl6&E{!)HUa=q2<*L*T$m(iM&PNg9;odW#TdL-kb zl`Ga?rstB&Kb@jxo{tn7KruZ${gVdn^=OM$Lbw21xNj*Mt!2ECJOoa3(ZmfLqqd4> zTnAirojt*}orDX1Y{&&TJ{|`6f?kX5O6!T;RV!!F--uvUWiN4_dqE!g?~x9<zK^XE zT;lWYnL7ME@i6h%8*8Xn;-mK3pH@Z8o>;yP>YJICgFvBkiM=du=Ra=*HS(SK{Vwnk zlt@x>8WDlFT3CAHoe~5((e_a4VlakjxI%AvHm@~&w@4U(th=BrZRWYNCa^v`7t(`h z!Agjreb>%ih!tN|Ej4vi;@A*|z|%k9j1iUV6^e&)$^cB<CM+Rv3K?pIkgbPgh%0Iw zh7X2Acw|TPzJ;eTfMw*IA}EkauHVc}q*Z6bP1H=eRY&)^h~+mOyiN90#FZyDxqt@{ zRH_l8^J8$0g)<QUR5zmi>AmN2&2xyceY(l6B{FLWDR1EC0r*YUgQX&*tI`?AKkKa{ zd3TK?b|dHVBP%<5y~ocde;Ze3$W#)3_3X4mFfKS8ncE2(25N|p8s?|Ayv{!Y!+?ez zYUL-Pe^0(`g3D2>lyh9ASIsnoF1UyHD-(rrXEy0k$tjmBsoRrMaN$2WbR0zUr$qEi z_;li-Efd5nc!xEjg`A}HoVIOO^4U&M4(?_}%A(cN0+tF8*8lz~&DOfJNn@{?KWCvQ z^{UacNy%`YX|V24S^{|1prYrR)iz#esp$<ri;t)O7coK<D!-!h|Lw^H#4#2>`~^ez zJg%(9N)KJ2icoSl5vrff%%4p*^u*<`>@i(Q2{wDQfguYM2pUE+|9w~)kh!h~J>G@u za!lAotNVy_Pja*n&c`?EY;(PkxT_3rR$-|<&Mil^C0Msep@-_N<s42H4g6l!OJ9Oo zkfByvEht@6fArI`qCWC3LxaptY5<tyg>CjwSjA>78UC6EnyKCuuwa|1g(c;MuAN{s z!i{yK7)Wdh0!}a?Fsn>Zq|k4+wJqY*E)9HJu?`=7p4ui&{4%^2+<kG1HV&chDfE>$ zB@$$pH?o`}uqX5^gy{Rh%&96})n~?ui1}!1l)`3Ql0DVfZh?UMyNoOS>FSfes!~U7 zy7A?p`j9*4bf;(Gp2Q@4u3S65Vbqn1T}5b0c57#G3%1Yplln7R)`lb^k`2hWK~*4g z5GyeO^^LpL!~RXk(b2$8TB126lCWMirnUct;MHu;Q8_k-ElDe#T0s*<Cc>8BBeW>B zvdGHN!9wn@<mfCcP`~0HPMHoQCPfQ@BMm22k+UmR9Jl$({<H{JDy)&HJ1vtbU<t_P zpDv>gp@z4Lj<9tLQfx?YXjG&JP7hK??Vy1<k&7sahxxGB7ZZNYOTjWgUPqLZe2a-` zf`nUtDw$}(FSL8^sRMbW-~p*{n?G#CwN$ii0QwT1gu?Y{6UiNWCrSi2X~lF=4<lZ6 zz#{;k&Pf_{Un4}nt`krhq~zH%mnEh=KU4KW&>+bq3zd%}$%H^YQGgNiKJotR2`6SE z+q~ac`?qgt9(w0Em0LaZ7SJsUQe(g0LOZ$WWy2XP%Jpc=Xeo}@>r*U8H%@eBs~681 znax6@2izsiRI@Zr*j`D*ru(n0b#-@n`K(?#whpcrW??f^)X^d^dVJHrVv3b4UyI>p zHgQ%E%|HE98mT2S(KpZZH24}VXkYP7|5fU4IG=-)SZ&MORV=bMnsGHZyjIiCjZ!ks zR1-8ILhTdOcSoY;l1-pkMjUv>-PpxxDkgU<GsS)ntp(IOi-2TnfE)~9`a6_;>3grh z=eQtriN&3qL<)e3Fv0WWQBaZG?_%TH_af&SbIU@E=w!d&<}*D05(!TOa_iT728h)X z<1B0coNSW%@{g1aTd>utNIiE`xxVJ9+GXMT*WFy|*(=`+d+hg>v7Wuo?|}ZXl*CN= z30&IG(wKH0&|yG_0KF7Wk9lCM9#`nV4J*^%Ph$wmb<^}eVeNrhMOTL@mMz39u0r-S z3ItpMfaY)MKd7Xh6*7U>k*9V`o6GMELLK9-(ZUlW!E_YN{7ly%zY;?0mwy1B1*%Fu z^_$mh5qYVfIe&gn$+i7uY@|(AN+JIR&pUZ(7c%keR4Tuuqk_K|6F5Er1{w>x?)4_G z1kGy8{!hs<<J?3xe156A)w+wL`emc%$=qCTe!3uEp8jselO4&#S6p$Td4ZRaR6#Ev z6g{ilhAoso&yDkgjtl-Sh^CTdZ_ILUJJjKVl7oU;Qv1>Nrx%&yS%p`HOQpfeRIy0D z&^kHmo#pxZ69Q7okuwB_U8Og<I4gAHqyB3?yzT9XJ9Wi$By2}|fPwP{_0c0h3y~hw z&AbAhw6f}#s*3y03kMpdNhEF?73$=JPQC}3w0S%&MzDU0p|@cTe|NKL-WiJ_K)U=g zqDx(BBz#!)Gn`}<O(^Cf+@R7rai{8{CpX+6?{9wrKFA=SZs1hO8qR`)PqD;xVg-#T zV?*ziC0{d*WprsaYya=81T0v|IGT|cBU{!@vXU(tl;C`e`)_QldsK?6<a9~QxhNG@ zTQ2)^?u3^3NX1$#j^7i{usI(6G@pUJoEFw+CK<m-ME0tD(#Wix-WWQNPG{n?<?0?I zg=W>VtWh6WaemUNo99Wzf`%QhkG1=YlZi2>{jG?UKZV0*r`=mhc754~i_k3El-m%S z99l~b=|Ei8{>}~FtfKXU-{+C?J}Jam?^)?qQkp>QKAL5<gK%r#cPQKrjfO%J*KePY znz~9^t1;W(OL|#ms#VNP8wQl?0y}~B%3Ek+*l9e51xHMN$pcCJ05wirZyLkCRI8u- znxH_mP=PKGOqSTbIi0U~C<a|;>(~+xgUApp@aB+$)BpM(%oY|U))JpYO1Uc_e0b({ z!GpN#FxSHWtP^A-yhZ{1ZetH`<E4-#D;5^d7~f_2?g9^{j;NaUbLNCk2&g5Gq$G=M z=7ocWOgAAmX!v$|iu7usfNbL;8Bg=^Z5lTbV_5rfnRwI8+U$b6(_kP_a9P}NL`!nK zVWsHLkKan$^C<C=w6I=@2SzEc4X6z(E;ah-g9wMHl}Wmv-V#~JnfkB>Jn}J!n}saz zY8W4l`kaj$*W`3&Id9+R1nG{_7MJt=pU<lR8-VjUk&`>$oiGj(_T-?OTZL>|CvZSj zwOblLAgdn$I){@Qe%;xjwp>*M9M|{>x$NX);`myig@grZZE6~ZM}l~Zd;{PiCaqqB z5#$hPo6dXiT5J%E3(NB%1F1=sLEc?MPOlQ6qB3LPh_HikBUqqIp_Q!kZ}7zHtp{Ee z&_3Cyj*(~b^JV!x)B2`b!H-iLq!BOD_&p#8b-nzww0k2|;XF4Znw-qE+z_s>;u-hL z7Ot_o7IR+?FNjf>eXMfoup}I5v~S#eDvA*wJU35+d2u6tqUX`%Co?KdQM_da;;_^n z$zFd~gW4YH?tdEyjzo1@O+x`Gvbh@@@q=P9(rSJ$fk0j7cuzkhX6|{W)q8cDm%ys* zgU&7)7%-CA-59q^_&j=Ap!i+EGT(_6UUGtWWC<iJhK}rF$=*jQ&7eo<=7Go6>t%G! z*PZ3?FG*<}%4C+Ir7@~!WNBO6Q>PVFG#5_<++fD}C9Vdfhn}M_7%s`5uOX3RSncS* zZ*tLWe=(8RQa2ppe56TJogIisCIS+UqP?YyI0)(48EvV=7Zpk{xl?YNCnO}>BYq&z zX0oz%w8w%uH$flNtrYIk9`+N`1I<(>ilisN>&2zcJSMW{W4K0|*rvL9#4;hl=eOM) zFlw{4uI9=xz*ZV9>;YZm7*ooWhY<3cF`@vj^bWYZ$UlV_J&|IZS|hc(rPvpCoy{j| z7Km6#w%S=Kmh?U>Lj#yb?xB4WvLYzMC$C@{NLo_IzuIMW*yW65lbnZ=Q2qbbuJ1Y# zJ8Y6~p?T<ktgGlutIWRbce;N(iY@zH-y?hi2R*(7mfjk=%$0AoVQKwdE8Udkzo90M za*|cmL=-q7dR>-#n@%h#j_?oo3hXbZMv%nYsxx?MBosGiHm28U&q7}8^Ddj)#CnaZ zOn@SFsUGMz<(>s|{p~aJbc9$KeC?|_+*6gZXBe#FomZ`A{#94$<uSJ@Mrv$TMcj5* zO)rlISsR}+$!`Xhz3;R14<CDUkMH_EpJLfo%nUdo)7k<%Adf`PWG-?%m#fX(e^a8c z`=mzCQnOYgj~(?NE|5zIvadPJ1_749v#`;Z1QuK0w|>wMs~r=OJc=CIyVfcT41{-> zeO(9uC-EKU$3?kG4NPe}dA)YqhKPi*|I`zeN>CwCUk+!kwMJF_G+#2eZQ}Td<1mWQ zT>w^IC#r#J@Ud>ex!(I}he%w>_-$iq!O++F$LyJ}o>eYBM<XJBMUX!(TObQ$zFlj> zj<Y36ig_C0F~@#4inRhj#Z619s|Y<OoesIe-;$#Ls^BXGRprsMgnQ^S<khuMh)8G` z!E37q<Nwfi+qy9LML>{4nj<rURS-K)B=exPt?Rul6(N8sQBw&68oNUM3LB~3ApK9n zJItl#U4=buL^xh3m4>hng7d3JX?~{dS>cr``IY?}<|G@#-AOEveKw?Se%z->WA{fy z+fS4xMi(@U+Mf`r6g&}#ao?9eWuIWr&sza;=!Y(6@&V`Q;?gv==GFQ$^(r0NQWN)a zDf~3CINT*`XHjD>A7fF!9whnf)%mR0P_fgs4dSSc<6;ukrts+~ww32v$x8qA!_Z*( zb5~9GQ&(i*@v&p)5**#8@!a0@3pCQHq>+KYwmEQQxe}K=?u@JEF@X_0gi8T@{1xN< zS02}BVeQu?I9m-BwcSwqKoA}P*pJeQwz~U<*uOf`57cc3J#5l3fc`_JQ3ddfH=}Nc zD>@AE&Qmbz)MocV4PVTlayC-gzJfguy5tTbm(8qgd=g{(Eq(Q|6j1IML)f#SWfgK~ z6{P+I7i8lh)Dq;;g94z`YV6Y`pu)P@+Kryqm0E!JwuL`7;3@b=D7@%vwagcrh9wdO z!4#UtOoMCOP@qp-9cCVt%2uoC-eH0X36+{N7LH>8VWzKtOgb3I;=$U!*XN|WlS1r& z5StE$LTL3!+C7kj5s!-FZH;1Mj2PPMG<iFJyNA=6Os1rEU%1gdhL$x^o3b?;Kf_9d zXPbQcL@kk{Nz+L6<d&U=wXd<k+3Xi}XgG#;UmA_G0u6NTWs&M@#*CIxIYnU4&5!~G z$SjS%k<pJ`31x{NO8I%^Lx`9S07!h5GXLh58C0GM!D`Zqbk;(`f_4%RS3kT!iz?9a z=tg<RVR4rPheGb3Ja`riM1O0?IOI-K+xM8$I@+vjXwSK;A{3D8BNOWbp|zW}0BBfg z&^a!{e))+X5aHtWS#wS50coe~p17hw+L=Hj7Ym@v^^`?x2oC=10f$35g~VMjX#FFC zB-K-^Kf#(`;U0k+q7^2y@%NTG0^wbZbDuO7w1An4(n%}UHj{Jicna#DHfDlM7a|?H z%XDx4`v$$5TQqiEV+LA^NngoRsaW7&zXYfI;cV%9*mJ=!Q)*@8Aw~-CP*W~<q%!lU zMX3VXeWaw*JIR7}eiy%fw@d-!K@7Unb$u16n}Mg!me@gqa&)F=z*JP6;*_4ijwB7K zFrxC~SdWXKEi5VAUqp7ttQ;irY3E;KK^dWcPTA^LPky`s%8(ns-_vzY%U~e|ZXU=| zm5)pP{EY`mS0!`+I|?u4GhSr}zfry(o%i}v3}+N=Jh!Yir-na5;+t`3(I1=WHOjjw z1^=f<I)Az-%cyVF|Bd|`Knq~QWs?^Zg=oEy1(jdADxd-hZ{c9Yy7mY+%SXD?pt{{b zLm#GU@%}8Sij8PZh*ZI*#kZHbig&Q-h(AvI=;&x9&zb*#GX;RSB+;It%$W&ZbQW-4 zqWbr54;{aTv!EIu6*w?N=ckwS6A$UH)LLa4OA$ykX+T*^*4b6T#gHEv=fnqir_z#Y z5!5$rPrZoFI6!}6`?2G+p{xeH-TX8_TZUN=-0ybeE5=h~kcpyh57;4$t$&9Nx#6?P z+W~O~o*`!Gr^RFomtgv@{Z!1LnCQo_t7l{A)oY}bek=~N-=N`YTPm~cm;gx&0g0bg zpRLrq_$LS~S^9C#2K#H-t`R_P>W|u=l5B*U=71?Wj;PpY6rmy<I%c%R;8dU}9wBrZ z!addJL2%zk3+c*zD}p&(_XF~u7LFhbaRyzqG-7c&^xnVMNBc({XF}M_t(-9Vasl1> z_HGw$<oW|8)9J6>+Dswp)2o2OVH~?HrAU8uWBZT5V%5H^eiEnWa~oK{n0-?5%8;X^ z(RT8L9rVysddh(|lExym-NOLuAn*v9;lNlH6=OO;=X80Cwv%$UOy0n`qI2Cqn7g)a zp&qorRAMW3pdzfhZH?ygQ1$650VHr<Hv*zW)3$sUqfiy7r=wc_0G#<yK-qfqQ6h6s zhDZ=eqk0HrPG^@qT@8L~Pz4J7I~61rZNcm4;7?wBW3gyvvXq+&vTk=aMu#1HXNg~A zjZekS{MSGxWNfw=)y#IUpUp{VR1;^lqIyU)Ip%GS*9u6A%xbR>s@rp=RD2zoo&@Ci z?6#x55iY{gM*!Gs#O{@pDxrOvsvL0b)?hlPem&rcdv%0mILij7cu{^g!enXQ-f|7C ziD|62p9@~ET}P9bFjXj$?kmtO!=O8<ugj<2WCZ?XtBPvrnpFybA(=(DkC2$y?MwU7 z`2v=Utbq*`#t8?ADM&P8E-v|fk0LI`s-`R=k>l}@UpX>~;ho?I2DlmX>m|NUKP?I0 zSrgd=$VUIx|L)`N`?5q0Yb0d4R$xW|tbf!3k6aRbw1P?%zwn+4(b|<<HuJtq71?;g zCY9<2)+K&x8XIq@q^p2Y--<)oIcb$Al}#&<HtAn<t(2!$JnZAva_WqnrZjF#RW|mn zf-*GMf$Q6&Lk5h1<JawB$VZd8=I4Rjlvnu2{kdfhscf6Z2#l*b1}bX*dVmq>$UT46 z?R7WOCyMo0rOf0U*L?kJOj1_Ta)WlZK&gTdFlq%H5H+DGeG_Cc?;+FGk+o~SYI`MI zlp-St*!j7?IsoeeS5?l?cI4w>@P<4M+d%&tzmJOH%|&v<Z_`0+)rhF$&10r*XEq6o zY_nG!-M2BBnFNSmg+G$>=vlUt4MgZjC|@*u4i`NFBp(?SI41?z62<?U!e$W1Dt*?r zkTsF6@=BKdE41Hk>>MtJLAw0Q#K-)heMItce^;Fg55kDXd&X$SiOyqEL^!<)(Y4%n zPNMy$)P*ZpDg6Fawu=G`k(Ll3LmB+r0<dQBW`UH$=S9+VyB9|x3;8OZ2)4;iu)(!h zfKOLL9|QJ8fvBS5xvP>#&m&i>%i2c8)1&$V36?=BvC-AY(p#>QxsZB7Q<@^=(ht%J zNYLuHUcn-MvBg?vBZju8mT_derEd1aYiF++zr_6#Jp=7d4;^ldwNg_qeEOTWJKxqk zBuS(P3(T4EE`EA^AqPfWeQw4ZJX?_EaM?JvC|%fU4%$aA&xAcR6RBhc&T?J=bj;8X zXh9_yx^?K_3GIJGTmzo|P>?g#>*rlT(!0XE7!F#0%0`zbv>DA-^6k~wAkmqAo5EE> zYC%!C0-|eIhNzPQQ;!?1jdm$?q}#2svG|KTk6V`2!B9ct-Cl|&-hYxU1yVMsi4csv ziX$u@ghI3;7oD}6L_9Q^2~%3?LI#~yH8Qa*cS~o=$R_lEq!vO_a%M+0`*2|Ef>H?N z-}IX}3ANzg|G<KNO<Fl#dgBQmlI9>+14L5Hf0?DlEdtrkOM)Cn7kl9fRDm<?7mNci z?OOBKU60F*Yai(!#}XZx96y(0LTg+deto`LbqAt<w@#XBf`Z)cDpK=anKyJEIp{AX zSC`Hkk;Nkqk7LBPci)2-{cbIvZU0X<>VraK2iR8vgkNy`i2ajvNJjVU!gQMmuZRfn z+)pb#EX7ik@1L^x<t;|VP4<i8jybdY=bO8BnWJoGvL*?>G6%IQdTt6w&5)I>{IqB{ z#1!<9Jh2<JuFE4@Vg?(Hr$Xm1*^i>SivhobbuU^B$30r4yZaylV|EZ>h<@4i3T_)) zd2E`OHdsb5=1ENq3Lf9=Px}tew-8Y;ktag9K2Xuq1t6a-0X&u{l#|=OdX6zV#p+yN zO93+kX--0|8MnFac1pP%!KL2-H({ON`9Fp?LCC7q-ItAox5~XWfxz{e_vZgTTfcGV zyzBIj4v4Uy)#!%BJtS9>ma#-xH9Sm8t(wI-r+Rrd!93{8-olRaN2}`oR(jWo?lJz! zzjT)~80=|_Ga@`^d@o=KQ;nPEAKB!9sk?4ZyN=8pl!gteLB$J6ZR2whh3o6dZ!Q@E z=}oYDxvA~gh1BmGU)tciWBb;Mwk$vDZHFr4vYV%m_GAbFI`O|>kzouq*WP7vSIH(w zT=De11`+}f8oDpisbc?(s(#1ixh;k^Ov$+ZHPJL-f1qH`;-?`rK+Rm*Mwz;l;Ap5| z;hi1kDL<H1_MWdsp6r|tT_|wPk~{wQB{~qs;mfWp5ya2P)+m>oedLvklP#!#eA?{a zs2M*x_#W&mV8yNlPgS5WlElAR+9c)$JG0VRu#1~XEq9w}HJ+t>I*tBa!yZVe$f3xX zGwkX62N;PfWyb#s#@^J4)-N=Fky`BITkc8!?OuU_Er&GYmlqRTwDdR&N|C965ktf@ zmmC9mU#2I5%(dAKcV>a^1bXy7i&G^WU7U5M{rZehv}}VK8T{DPJOg6aXNU+NnGjGp zT?IHsi!?fl{)t+O349Bvl|4;8?Zc>4W({5t@0&t1dx%&@gCC6w3~?bmyj-+;rG=-q z&#aNful((-7LU9%)~Xd`Emp9jT-1&#WFv3aOj4LV<>L9(k)-;ISeh$N@<Gq(Q!M~& zr=`kY@4F%*&Mu~&_n-mVO&G6#XJ4)j)KiliMvBIlxYmVy&t9aa4O*uD^mmp&Ex+EQ zlb&L=c(E_~8Sb+Eqpz~riAa$oTTL!f(eRhNddx#{=H)RhF&Rs<$_yFWsCWxu&(}9l zxQ+J<Y%=hGeZh_fC(tH%a-lCFCU7ti5e*?eJW6kW%uoVBIp884HNRa7-agZ#pqp+p zi*~2Ke~2Apl>vK&f4NIS%UH3_t9uw1*)~Z4tp*?Xl}=ZY&#~tllV6Rm`%}?h1bu#- zpCi9~%%I-R)uxjEotclHS2pVlm;Q5mie{N;uM<e-3BS_lvtRbMtXi$FS!<rq&JXSF z+D=T!qbp6>3uI*HuBU;e){etfNu6BWt*rw0Jf)H=OP=S}QTyYdDgxU$ADbT=U3b}` zk;%rF?qL%`3k*Mo?L38G`XMI`3gnH9Ra(Z1VKZI8vhes;Y~DmZ*wCKAY@(86S2r-U zrGUqJc^EIL%Fii_!2edH1wl=e+w+tH;G<jwKDs+=zv$&)o+!}%dk&i(KnG`qKpc~j z42D2n_m4G-<&TFy8t>M>%eH;?9ROU{QC|xAN9`!c&>wiqDeu<xuVX_K1s9?8iQ*+V z)vjyqm&LR{UI_A`JLS*F;%zhoT0a)U&*sB_pS!RnAP|vLd6BEQ3+-Z1ET=M>Sn54D zUi`!6-XEDm6vtT}Q(-I77M{%&W|45em?$ln!CqrKX<7`knd#ID-jnTVF1MM;N@!E& z`Td~Ub`e@vdeJu~On_JvWL0uMK8e-9&Q)`=LcAb$ZWX<54|!X0kd%7YLxxLLdH@&u z<I<&#QPKo}$hx!IvA7tSZvFbc<?hA<yNsm_zS7kV9{4t3^`g$c(~rQoZrwnB@UCm& z?&D=t!`i-R&FDiS$sk1q04alq2j75|kXA^X4vfT}g@gqGsB(79V4iUa33K2+9KDxk z22=@U$z?#o<@eX&&aVdGL6*E(NUoPspI_>N&s)tGtdJhzo<?ZST^i@RiJ9~Ob8hM2 z+sSIavm45W@y}xBC$TD+ftb+uXd8~$rU}O-lY`M!nb&tbFD1e?k)9%bngkbNV<f4E z<{<MZ7Vp$5;Bs9N#t!!$$ix8dIJI65HuYiB&0|OOxn{jE($8-<b|rP@1&*HlpX=zb zzLY57Ghp!ny@iNy=;+F)=Q2#VN${;x3^?ENHBTOh-D9xr>?#I7-c)0)jq7Jq=)G$H zQd()Rsoi;{MuoHsXS|^On9`yJ%-lim`#fHk7DfSws>5CR(v{(44@I7J2WmJ1Wli8K z5QNy9F3`z_!&@(?TmP&6rj%nnnVD><on1N0wPx$WU1iC8=wYjfVxXOD;RldqJ<2$| zXZtw3BXyp3a!?hm*L*H2_#gG&|4_)A>V$YOYnjBlg-etQb|4Cj7VfA}L?=4)C@K;S z!fhu%GD==9C8h6HVVE%MaVqU~V;R*Yon1+!j>L?Yz#FHaCH5Wkly52=?+nj#axTq; zk*L$e^d(QvSFLd}D}|Js&0hE8qc4)`<~<$Ha+V-A+q=GRAz>Y?GOe#Gg}h}UsAjR0 zj69MK8=MMe#&w*WkE~BBT+PFFsBYg`D(lpW;gcA7+s`8yGLDG?9Q&u2vq)#k4}2bL zgA5NeQ`JiibmWv}(>>E_f;$;z(;iSjE9dA%O~*`ekYZkWDofTnNE(v4>8fe<537^M z4jg2J)}YiXDRU<*3?zrbmNn_2)6UD-Dg(2m_p)|HD~Om7#8E2z(GQyE#HR;0ejV1$ z{5So)XnazLbRqA`lm;`%o!CcgyX@COv|Uzyk@&v+&i*=IBSNI(Qcf~BU8D_peQI8i ztqDqztzxbaNb8dS<c=rX6k9>rGGCKrxFcE2p5a8@APaZoYuft<{*OGNHR%3}HN) z0mIJMx!-YB7!;8SyydN-qKHXqd6I~2CthkL7Hr>_OP0^>wA<2p<eA*MS9kHQTGYPP zmdQJo3T$J<HfS+;ml~`DWr|xXwN3BUUOsa;H1g?r=|G4%aM7|-5QWe2WdP;OMbO%I zRZGcIg>}6;bC8|}42>*lhr391PA?ln5y=Hl-j)Tcj~p<21o@+Dg*3G@f^^~^z|h-9 z%4+Vi?Ajgj2~<RuUi+q7s&?Yei6wn^Nij>!ih7|=a^cPK^s^v7y7o;b)Nr9g3UshL zSo<zeYp$gdnLX2c#<(cBiQIc1{$-rT4tUzQvC&#h@Qx)JKedPUH-i-zr^!TTaSx3X zgwQe!za%^hppIM!@?|lSPMCUU3K{=}epgUp=7F2GK(Ux?!bE}mFfjMfIu0!m!kQ|N zXjUqOm#1kZ>7KoHXk@EdnV%S+Xv7_+`8o8{tMOm;udaeoqc~Y^!F{gbyTiPR`q~C( z$U+}3QHdc%>9TT*23UEi`5|wW*m~bu>%GYgj+%<!_Q)-cj7T+ddrjnBPTUPs!_Zg( zk>R}YNIh5~cjGbWbeZDgY|d8%t%nhLMj#`6Bq5!{uIF6e-l@Z)Cx{l>R=<IwZAouO z;F|h3^6y48wJ{FBaM86i%-yc%r2_sbG$n((`rwh0^Pne2wvKgO`bQlY2s9*_!LBFl zf<y6b7>y?XY>X3MnI%`xe{`GL=&1)kK;@rdSmN(&SunSDj)0rEZE(XhHY|n*&<ltV zh*0xNmpZ)b()vMJFi%qRd)+ZeXMN(mMkDvtEh>aobW7azPOtZ-oP7kE+f>~Y={QH+ z-~Y!s@1yV^5zN2da(?N*9Rl_b&>Y|m$>MqZjo%pMXg@8~*cyw{%cpKr+FkqX*x#pl ztFk@RIj*azGu7Dd2cFUmo<AG3mZlp7o{C>(1np#HvlnTSJC*%X2z>9?sakuTz#+?k zahwW7ZttQ#G>YDxEp_-^EM_S_tL>ZjST`jmcO%A}f}sO5kcQ#9$yUN?#sDWGK4v=r z^`h%AC5X%Fj&n-hrYao;OGF14i-CHOMyp`15!g>hgD6wy!wIy1lywQk{urNqmwWf2 zc++=WG#Kvn-B~hF*wnXa{%JXdV#?kq9U>)1*+t2?mgUy!{btzx?8K19=X`F{2)EoB zBlrzABQI;Kz@&Kb(n!r}vVurD7ec7&pLY1~(08KdjvJRDseA3d*ESi8an?!MQb_Z9 zMVP~RGc`8U?=TEy$)EtvT6_HoOKhb|xYp7}++U=!z3^!k7v6y%tgRTZ{b)yx##1>6 z!!ehXoU$YQ!lL3*F4~{B{^hFs$vX58bZBkFqWW+K3n<>%akT9%&+ml2o7%TiNo6Zv zpo{p7+Bh`2R-4;Xl788D+;3L_<qpxI9gmy8=6={<>whc*h}s@F0UO?jwT{H;+qbQL zE+d-30ciw~Qxk~|ob+C9OS3dG83fVjGMy<)2&9V`v<`8Uc=}ZG_(+~Un75%5xCB@} zO7r~7^F+iPR;v!*4*TY59kYfcDXR6Z!Uoh$GyRqjd85^1Z!cJ0U6pw{G6`tH&<<lQ zCz6q9;8Fyt{EclfOW!GdFiI)-RzXq50Ckpc_kCKzzmvns6`IIrt9K*oEDilnZkFZ0 zW718NFozhM<AK5GTXx2Qyt#PBR`6=`P>WfckBgk>6>^z?H6#UiTy8ckEJC4=f)FMy zu4nV!{nhVNVv_D;Q-6haddLe{%&4!bM3rZc=7^&n&ze9y+e^>^0=dtlW6gHhUT3nV zArVyIwgM@pm8`<qv^pW1w_sTr?3Zb^KRU&wYzSN_Ido_hS5Q_1J_<TdD;kLB>%PKT zf{#^CGNPPY2g4X6h2b6JGVQ(vt0LhAzJeV$=zL~dUk2#}{5<rpAa)J%C(5}bAyhD+ zju2}=HtXY_$#T86F=fV?*v*dp$FkF(PWw@wQ<p{OrZ+Q7W43iQU->7+!5pgHSZ`vb zku()Apf^!M$xzfwH>RSF^Lb%G)jOi$ucpf|<G3nSHEE$79K-5|O1i8Nj~a{Vo>s~v z<m_=p&s5`rk{RwW7*(~GtSKqZQo+BT0H0qtNo2<?5bG@ZF)ToOIk;MoCo^k?dZ`=j zXaBv3Jaht9ndCfunJ2wcpKB`WMurEaIXz8DC?pK1>hMj!AyP4$87)}f4R347q>|L+ z$QqBzTn<nJ0!K}<$KtRbZz`*4jM^Pwmg!_^nb**7AlFXgJV4Y;>@hV?D_1XHIyROx z<LBW`c5{C5py7~-DYTbKJR7{c*nefN;&UX&6v?I>SI9v)mIWnin>WRmbhZ$Tu&b~< z9En;HB~_%d1ja`fT3~i79E4SrfdwPvZT#NboA`qlwjVumP?55AX-RnCah>G+P8;r& zcEM)cAOv4rA*-NZp-M-KF?u%H^crMizNf&iUFuqbMq{;-y$pOdlyB@8qLj`H_3wJ^ z&y<oR$dmS3NFYl01Gyhbq1@l+L0CEsTS*YjSvWyJSl$--qDOumrtUrpLg-l;92lXc zR8@HjI=z%&l<@66V4S4-J^A(`58SKMl?Z`yAE$_+%4!~K8>i137(HaF74;TR0CtIL zwxmcHGlRkToU~fcLi>78ge+n6NL-4g3=g$}n=&#P*gHbpQtB{F-)xPt*b!lk(<-pv z2X46XJ;2?G#Lnz7Baq?6KlJK%^}qu}oHe(xE~p|Pzc2mX{k3Gk`=k=UpSGL}?X^NH z$rQ=iV7u@#x2LSmk7qp%_VZSLaALqy9nHp!-ca}UDpaIY#Ybm`!4!w?Gh9wa6ACgu zReqP&@u9S|v;>>JmW!)ti6s4ja=Sr1gtA&mLhSVW$xm1*X_mqsAR>5Qw?9VyL}$SP z({|#x=C45gv#4=*VE&3NEmo`ATy>PYV-4Y9x5kBwwa)M66Rkt80Sb2Hw!}oNz#AxF z=H~r0`kgLm(4c|F&loi_$W2waZ(3tCWNM9@2lCM-GOh8>83a<7`6FFbCmwe8sq9jY zcDtS5Z^3_N_|N^Ys+qQ7Ewgdy9Ost+U(mjtV5c9b?Xg_mu2|&*{R48M9v7ca*amk7 z7^F1fGG3TtwNm1mtGy&YvqZ``c&GnHPi@pY_4-ci>_X7jUF>4wLX}Pyvl+@WWU<kd zj}15cySpV=ryI!@y|v*vi&W$Lo~b_i#e}iP{ILCxbMNIi-=Od$=Xf`Ur{QGiAh>8M z6^VunOes%4Ax?Q;z6UCEj~%PXNC<{7xsS#s5P}|6xfx-6z%{&w6q+y7T%*|J>(U(H zB3PY`ML(sa06_j!k+3v=%cg`mzAp{1CUF&6f>HiqNeN~-)tN^YgPsh&k<Po#2e*?N zU<Jou5l;)Y<DYOO`M}v(jEEJE?>rHf&Kp6fA|}hBw{;xYakl-z*ksX?8l#91%k)|S zyq{zz>=XUbp;5}J?O9)(r95#Qsf8hW2**FcUp<h|r(?@Q`-@5)v~q+U|Dv=1V9W<4 znfrqi4wdB$)+``0w$znH99_oAz&$Abiov_s`Onq#wx6o>I=|3=#s0e5_#gb@>m z`I7!KWWo4#sIYw>u<d!u2*N`H{{IYG2H<gS{{AG<Xa==(I1Y(qP~z^&y}gAlay2Ld zH7C)K7@Qubt3NH1TT75i132RN5YaJ+R?)$AT@ZIeZw{kOqoFhP7`gvWc*Z{_D4y}@ zFP)W8pKF)ijv$*D`bVrs@m9t-jhYe<iD$}CbU-~c=}Pat7sA$8#~PlTg)j~=JCi)m zcfuY0{Y{7j6_}*pvAwHb!IQVC6gU6s%@NP?cI8upML`-Tc+F$HYo;SsC~5^$#p-P( z5-|{isDkXnp#ko?UjXDfsZcKoy?!wLw)nHgpvEe18mzsJQ}VZ};0ebOKO8KBL-&~= zxLzM>s|IJ!bCO9K+t}x(>)c`hk`T~o5~~-y0C=G2qzH+MDfoGD*z0?E`PB`)Nrl;% zPXBQJ_vDHg=4|w{x-Fd@ZbA1!e~E*K`&tt@7j<Q^tUiEJ-NJn2oA=utW&__|fd*<> zS5(B5BOtXJ{lp<NZO3j<)S1$7oPuOJD@{mVQ&lsr4C6TIRF4<`337NZ=a<_{rbRR; zwzC%k5;Sv}gh079AZc5wJxkz593bQX9Xx#aSBJV0pcJm#>F=WJZC74sKZr9IdMpoI zMpE9R1oP8M_0<S0xI%(C=IIz$Wub73HsYbtu&Ao+B<y)OnF!*~J?g5;v^|2IYz|YJ z-*LQ}cm=a?jxMb$aCl#+1^jj0@LsGHY8Qtf>9||_Dku{!v<GEkTL-UKKCZzwd{-F} z4D`K5zgn;DIWtZz|7w(0?8v;ZE{`VDV2#+#L>}bOY9S{+96I8$q;wBDX1JVqYFSHD zw>!hdhfg|iV=bGssmDUeM?YL0r0!alP0zrW=f3WqVLBBb2}nn~(Xg>$=2!T7<=lE| zW2s1!k(!QW``T2t(^O75pT?Ro{5Yv@ClIxofmOr1albTJD9ko;{P8;P4`QGv@3suj z3#?ZmSV`WFnP$;_fCih8;eskfl(2FvZ*C1Hb*SnpT88*UG)^G0C65Y`4t%}yH3~lZ zU)k^CS;B>btSTaoAZgqd4X$4aw9iPAF-IkrjRpmi1a3rN0<Ya8Tpb-O?v%_>5tC`4 z322(IqSb^5Kqv}(r%*|}iLiA$m&PLc9^+*3<*hpd55GMP<f}{6LY`8H16N<*d?;h4 zyet(BdEi>ioGzl<5jtQ4nR8OR{0gQ}0%lWL4s=K~=)PU*?cSXSZTyeNV1>2m<!>Yh zdv}upH1hspS&ts(e_Xd3ywSN2_I_l2ohNMuWZ&={Nu}0Vw@swn>&I^{(v5o=X5=qR zk2C}W11!(^^PH-Vc2ltxd~&-gUMKL))BX7bbHx`Gb<ff6$BX4owZZF9=$E&ig=>NQ zaSm;tRe&r1gJJ*!*QFGIbK6a%>(dNd0K)L;f%sR?Kf*|+-RW{hUrPO#D+vYYy8EO} zj~e~fH#*Qw7nl#T2m+5>fjU>*%-Y#9jGpj)Zuu{cY)1)l1uf$M$I};u$^h?VhmVcT zFTB2a8Dx@=t(01g%})pb%GO5!fa^T?i#V{;-qWY)5nK1g10dk@qO-R?@B|sSMv2h} zrSU#{k`8nI(F#a2P}WxPeJ$%{Y;o1{h;-`t)8T-yovJKdOYuN!rN%ND#APWQ-KZ~? zY|pZ3YCq<ICG(V}%miBFr7NIvIIsydRS*MjxB;`f07;WW+>pOyEtTl)lwj10_e)6# zASrF!>SYp!0FatR8ti6P`MF0Ihv|IIjKxkMR~+KQtK7$wX_ORoqK3pk>{!;K{m0C~ zd1+7AQK2b4lm*KM4?t~G69w7%aAuI7!M;A3r?z-W$++lRRn2*%H)ss+AL=vj!GGt7 zAY`VTj;@}`p3aAQL8*aJ!Pg7=Ld`zwJ<M9Nx^<Rwu`6_p#~NL9-RpTjX#Tp)%MNI6 zKiPU)H4uZ<!<GLO%0W?D!&k^GS5Y@Ey+`6&P>N0h2QQJ0WyJF@DjWTVIKGxbzdCt9 zGjY{c$0cA}5OV5IK0=}ez2%sa<w>7PVG$O9Wy0WPq|kunzPgH|5xI#>P(Mq77w7_+ zWJbJBb}S%$m8Q-_(e4MQ;_!)i*>Un@8i5tC_h*54jvC`v;X$+cYQF{;TksFAB|{qL z$N?#@`EbwB2LUeFp+YiL$nm<r`a4UIQ1S}j&hafc8=c2EzH`_v!2Vq*m4b(r#LC~N zmoeBc&5}1t3MWZL?Qag-yrr^`1LStVkOUXGYWqu>y&xgk45T+(CF9C6?~I+(_5j}U zZKetId6<?HMc`>x0f-)cy;b1_R<_Pd+5#u8Spq_bSw}5iO`{-2n{<GFCJSb#8jtlh zhPs-{HjY_YTX9xI1s%onnw<YI{TEW-1NMir-H4-||LE0M;9o}V*0CQpHS|~AFB+-O zRb~Iq*1z%#5*wg*k~_a1M-)Et=TNWPPq*^}ysl)Wxl7vFMU-Q5>l5?uXe0N%R!5(U z3P*Uuo23NVJNC4{T^Uco<7hwp#(6Pn7bl1KkM-r~CF|LJvp@x=>-F%qzlfNO3O}^0 z`|+b=puQY74p?St+1U@Weky?%BqR#>3Ad&r$oqi@rZ_LN6UX$ZN{dn;U3c70&TZ#< z3$A`1=n%J^8-O|D2?U;!Ri9iV)PBOSYedoK`t^SWrYsx0m-Xmhb?sgP7<ymcD%bQl z-|0f7r#-!HwgMpftQ-L<5}F^A^@-INpi4RUxv+IYqpEG^^|I+A6<-*v>YL!R`n99= zwOGxxge?G~!3bjjj!b4_Xg9L3N>tsf!b~km)IK$3{ak=1mYh|c+fRtUx;KCY4&07m zUxO2KRK_7aS$hUJgJ%X9#Y{F#h^>akuCI0upp}2kpcm?OlbH{$kjWf|t~fU-U$%lh zGYHO4$$^`LAZG%g<jAxp#iC9HA%L*5MSL1*bJGM}G^I)(a#z)z?Y2^-DZUxFSF(y@ zLJ}CMAdp5nPA-0tetwv7e*7^W4DU}vY0HwIh>&sGo)mlwsG4vZWoWGSbAH+eZ#zEv z0_>E59;C*`?bm(xdU4=)Mdlat3*7tpWaqdS+i3(6C9VqY2U|T(|5Y7y6P}0%(J%>S z*Qj|n92Te-qlXDgm|E6<E$=8)4v_@eZ!4=5+F_RasekmH|50vdy#g0>e6p`+BJw{m zmqMxLE48TMWo;cU&l$b(J0vw1uT+9%NK5RQ02|3C;qOt(a_3DOET@3BD%A;+&^0hP zaBjkyQ(0y~3K*F1-3<O8TR#BX=N5zEVxUTTcZ(?xM4u}qUk$WU?wn4vfDlNCo4G~; z&uk&k11(n4jf9)7Dc7mDaa#?=)ip9;D3mExw53TPbCgvE9=LyXI|p`;D%Qe2$nJ7A zwQB~&ZI#A;75VE8G>c7QbZ8mJLR~+u=WjN@X}IOKF`mP0j!&1_+`ZYqu!qjm8{>Ii zO|Cn9tx=@Eck*66zg}ev7M<z3tYR~^KW}gOk1hvwS7z-2ff>bn6T3Y~k`Ob~2rD%l z^2YmGcn1X5D}4XN{8lFhlIcc+@?x90|KggN)=^D(>QKX+vBTd@D*d~o;pgEt#aD;y z)O^1fckI-8>Bn`j&VKZr8-0p28MtJ24+zYFZ#wxAHe^dL@Esru{Hf>3(D}~KxqXiW z(9pdfw!By#iRqjm@>QutTCws3ElT&Gm8|y$7k8pR{XsiGjYiJ(!&=a97rVH3pVAc2 zdG!hh>!G`xs+ijL-lyjP<2bjt4dZzH;Giz3=eqcHl`U^mbpFqKZt)BC>$FUvmpkik z)%81RAg|zEOOL*Q$I};D%X@E0iZpW1No8-e93EI5WmC!Fgir;M&<vjAc9Imb4O>BU z9I_@&a$;Rg=gl89Uyz*pW}YdwlUO#qhtlq5wIJC}L&Gmb0q7~HIcDm&dx0mO@DTf5 zDO_qz;%Lx8Xq1wXqOA36pFt*MC0$8eq`#kSPxpJwl^IX6F8B$XZ?UPm#r;x|MlN$3 zBgn5Gt9@(R@7M1qEDBqy*12oL!#Yu2za!^Rk9lGCyQn$s<1D3So?u+)6>(w5TuNob z+pCw=Edy#8oC1(xCT9o5-ktl+;le{GW6hYMXAgDvRYzWxD@8?T>Zr&fRCc+!-MBAY z46qRgg1S$_Y{)Qp5d(((Hjy=Aw?VJKK7vIWdt<ec+r*p-$eLr2r%eih+i1@nxn2`a zEV_jjPkvWZGpG{I?bT&dUs<e~>qc-rD9A~Jq``yTq<+^@8M&|SaHr>C6weY!$&s2N zo`CwD2_Lb?aPGGS=ldC@iQ&7R08AkB2}SI1N?;FFY07*$$r&^KC}Ddfpy@oXOvy|- z9woXnXgK|J%7qJP=^PDL(0l>{<_U8cP<+xt6Y!rmaie9Lm96xOM2S-ewxs!i)2ejX zM1wk<3VGo`GtF=~Om&|9-G1z-+<Ss~axH6t=9-OWbQ5v~p`y)U=N5JE%|V_><_(GV zGWKu$o5qKg=4nkMMHZ>656k{9x08a3nJjwioH89Yck-Z3+GDNW(<(-aR9nw>ka1tA z41@RerH4OZ-&M8%_|6(#4`%i~c(6kYaCE^HF!1?)t7@=6J}0VWB}naO@GaD4hP7tu zoj>eOsN_By+uWwk{c3me-DFmR6;S;7#4R6>C4PE<<MFCkZebqv_zW-T-MwN*WOi$G zitaeF&k6+2nw{jAc3s>)0oq>59CTd<VcZQ~egtM;y~2Xtey|&3qDfBwBb%Ve`?+}V zlLc;2OJV4pJ{Q8!;M*N*UDvJ7IRACbKm>W8+XlKVpSxHCn48s3d4M4&-~Fo?#ERRK z0&LsYOsg1G?>r`vZx4jwvYsFj!DzX>7ZNP*HVf2F4#L+J2(Z%mxs?xS+kfq=ZwK!D z@=^rddMpUu_Ei(G35<pe3}JKyTy)&QL?*xYZGJ(6j6}}?5r48|-@Z%vPwP&XR3rMq z;kz5G)J9pvppmyFpwGL7ox{&Zx+?$U06DOvv(S5|8p^V#tUyH*5P5JrZC65)v^1f# zQoYg|l);i{g7npRt(jm&8#~Aw<d3Kt$rPR<DK5e_o2F(i9+Hi=;%QF*I0`=J(e-Of z;Ufq%vPwmTv-um37pP>MXgSl)COy^cWhH_FWN?eEwwF*XcilApmx8isV5cv50$n#- z(g6fK*Jy$c>{A`hTIY2pv;dHD2T0W%IETFG0x>-MNq*kdA#RL<8t2F_FZsM(8mNfW zorzrT%P{!YzCKLo5f9O(Q!9RCj34ScVUvlq*XoPDTT5(U<6lKl9itAL;6TxumgtYj z1KTLSR#r>hvfiA|$&yI()$33rW5?LlimM-Waz2Kx5Vm>7{J>615+T{d;c>KBRXcQv z13|ouQ=pXxZg@j#<v0RCt}15rG`k8=HmbU70{RDOX{fyw?88cKnSy8({YwpCXLv92 zL6a|uMXZ?fF~vuD4mYxQZd-T@3S8*2qufewyF&4u0!_!Wap>%gaN1PKHP^-k%KZ1d znl&Yv2;_oVE=wq+YOq)lXr}RP1Gr`h=ZTVyxt5R)b%QJBdz1#20T-A3CBY%B(p&+Y z7oSl@tv%aHtG^uDuIK;^9}924PU1RyoQ4;P+nkqS9J)SN9f{OwpUnj%Mr9ZC4f3Qh zeIr8mO7iU6iz15%Qw?sW@x<3A4N#+4inYts(-bS*<JhFNp0j8$eN-Gc)4zIdxY-4c zdY7Wk)zm3bHfb?kY7-J(hyy-fuvv&M5Xco99Lmw634Z$k+^=7)yT}gbs|#)!`5q#B zC{sbz2~it><BE-qi(tjJ|8eVr;C_RH)d0Y7P(@JBZC#<L`~n)LBnfw>o!Y4JvS)`2 z(5wZ~_n*-!$7Sv-3cAG9fZ`dPTEP;)g9K>1O{=jyA0oeSVR+AHp)9TZGVqwoF49+R zf1c>Y&v`V}P5fjkS$K%r^(PMuBH5(P8S_>%f@BIrV+*l@R#}NH&C;(t6_F$jrc{j! zg=dutvAL5}zVEhYYF3&rx`#&Rhnr{rzDd4GzWhx-JDn;<SuQ<F2u_k(NyqWDeZbBI z>k=Z+=X+UV!W`X2)BCRnBF~<WTR~1TJk>OV@1V-*ma8dl=qng!C7)kgX;I5QcoQy0 za2O+0I_QXFJW@xymX>=6>Q)7aL03UGhyk%WB77Rqy)i`bE|jM;w($)uDs_9af^;1G z++Pe6$`o;j1zj%F1zn~!K%@I2ldkrK#Q2-Rp{?7v*frG6xXd;}pZ#+Uz51Q#8KZ;( zJu!cK&dM5fgUFSIy54PZ>fQ(z;Rz$;p;}3RUFkZhYBiocUEn0cSMka9riPze-9TFn zyT`^0J$ugV)_v?^C#@Lc=EKvM>&Fvu>__CM^Cgs)RKDfiBdEP12oIMG_{(#G%U<SM z=wxC|fG;~f3U(oWfp|w~B*a?wMsvaD*Go@@!YX7*a1W5R=MY9CVWkeeR^&`tDzeFt z9dA>1^$0$Og|p=;f=sw}tg5VnfAe3OM{F^(INZs5JR(dT3FfUIhjhEcA@VGA8FFF= zD9wj06=73gJ?dIz{OC}o-rBZ$Ijj_@AHD|#V>NB&FnaC@3NvE>orh9E<A2nLLWFO4 zjIDYh3_;N3z)}r@O;gdf+o%YKwtt9MGR7e1{-KZCE;kBz+xcgsT5o>OLE+}IKjJPu zV_g}3)A`w`eb0j{g{gu2=^%B+S0H+_7Lw|AkIAS|HssFBt7`Q)_~!_BY*}Q`rKXd8 zq{!pu5CLVFA*ZtbdbKjhI*NdS8nL5e0O#41<af`T>_F_dHR=>t?&eZ0t^2&;(oY@b z$mDTmw;2wT*L9X-vV3_r2>=8Fq(p^P7fL{#qK*L@9dFN9b89ywP7jw~n0_wXg#Avv z_r@^YM@DMy+rU4*(=W9e0o2#THUj|1o3JGdV!x}UO@}Dx%7dM@9fX}8-mNI|mFmFr z4WP=)+Fkt5iceLEjUfKZY@*j=-kNhGd1=g^+a+T0<bvv68Ak43tKnw0wL^A&(#Xi( zzfS=SJ+If^E$ZSUVFX%i=)|*3&;~C3*%1ug$dL(~(6mCeG}A1kF$kdK#sowr4q5@A zBt==9P+fYlT8EsJ2MG>jmWfJomXko*NS2l`QD>)!#-W4|E;UsI|IRE_#AEke8Vx5K z>#&bqaJim#ZRnc}>^RP)PYt_|Dt9GN*O3fUwwA1o5%cJ7Pv&t7t<*BTO8tp{Tj1h^ zRw?0Rx!KEY<i^&B^W9mkb^Q}kwxBA2<HwSfH$X}%l_o^>s5C=^|0$(C`|;XJ!J$3} zIlbV#hF1?L1(bpWq)`IEH(&a+3II_o*8TR+rEni>=S00%ukm1QFH69}TO^fG3D)2v zuU`y~_V&nqahJTW1y*r+x;30<FPchElVY~z8>Bxs2f}@P&>GeV@HMeyWEVMFO!A#c z?95&pj9B>veK9MiWEtrh4l_R&cQwdHw9I6YgT!;52*fD$)vT~07%2Y7(NzYu)osy> zySqEZ-QC?CiWMzTytt)Ep*R$$Kyi0>cXxMpDDE%co5^G{ll-`oeb2f3ti7bIxKX|1 zlSjrw+Udp1@|G`73khrkGCvdE{*+PYPIJNce29GnV`%C-9*HB_uNNqPhQ#s|)ab1> z5}!?*h+8LoG%NN~{xDPFW+8SNVJ?&v6h$hP1P=bh5M<ol{JaKCxf?QwN6fP`t`9tM zSm^8Fph!8ij+*(b#EeQ;2TMX?Vg@SqnmI>~oqYfMY_f5Q{>5EZI<6eQ>bZFKN<J6N zi74p>N16V5ZnI0QA7(CafZ;LC9TWOIht?vs)uB~Wh8c)sj%r}{ypNEpH4B}bkG|@) zIk}S7jU4ntEOLY!hmyqblq+Kml~vVtKW*9Y`#1;ZsJCmkG@UC{ll#N&qOmI?r`(e% z96V{Vi0`1EH4k3<FM{2jn+`TiC{mX$ilMDY5<&OdH{(h?tFBp1%}Hj}gIn9A<3knO zzS=RL37VDiP*wH!U8QIji9-Pv&QomDt}co}u%D#h^}TjBm!2v=hpwpmtOoV_0c$vf zb!U-ohF_gSjosz@a)oPj^F>FNk;m|94nwQMhc(bT;fDfZ9@N5Mn4BtAY`skjfOdML zsf;0QJ88&*Y;t>G?HAM%@12!R0%u1qDNB0Xor@;ME@t|Ct9py3r>bKwo%(Y3@Tu|* z0yJspV%Rob>hQu2T6KSbLs2DBmq0GnPh@m_q5!Sqk)oNpTN7m8>4u<|cCs$x1fvEV z%<xJ(ZY4Ip16}8f?d6rp$GwUr1I>8vo%A=Xq5i-Bos4$yioTnwTp)>g*sF6Y*8yFY zB8HINr%oa9*`O@2q)SB`ldX)L6i*CCXY?L;+)MuCCQb}C^|Yy`?!IXIPIBz+pKtN} z6Kw)t{D+%V6r(89x&@PfDT0bDKJIRXsX)Xa@hN-o9yng^Sg~*)3Y?AEjE0%bVgAT- z87!#bA}{7T9ff?EE;*grDp76xA8w@0n<{0I@|D=>Q$q@doSW-(#)_>o*&5EcSD|6) zS3-Vf2km+&9|15#o39Wv<X5~_If9k8eyhM8^fJR_mjTPFdYhIticH?RZQ`@O8}`Hh ztmU~n-BED;{OZ4V1{>@{G5SHnq^@Ky5t->zS681#$IWPpk`)S}m@s3`bx#K`7rx(e zeYL2~w3exNHSq<s)R8%Bk3_wyClvnHF5sbJc16T<F^bB{*x1<2%+5&DtU>KXqH)a6 zjBFbTuBeMu!JM)q)y@nJ-uSlHx(s;EvQn3G=}JrX<%1O@ll0RGHc<8Jv1SZx70u7T zvFa6kr`)_EkDPn8AGe8$qTa~xq3s1cbLg;J;k7X^ruzCIxUBXAW@xSh?LF%l;b@L{ zcXS$u$lyK&gbi&3Xsmd$w&yhyhB}C)KH4B#jVE-yo~rNb;O0BKTau_;e*rAnbEfRt z`5FHmqHgOiwa}wRkAth=?c;t2GR_K{^>CV{Oq5rPqbIET-#|?#f|Bczgltf<ym=mb zeQr6XIa3OI>v1El(Vg%^OO&HP8&_+)VaYK$7ix=G?A8*U%{q1`mcRphbAQ^J?fHv- zY4gz!a$gEha$?rDCH|&Ds4lwdH&MI%_HDTPI=gfxAT7GMmnpZ*Ep4ryAHMQc@w2DK zql>p9AiPomM;hcH%NCV@XfWM*r2z+0So*tX3M^ju8``8NW-r!1kvwGlQsZ>K_A==b zd*0S&aCLQ6pla`N8Pj@8DSi$+yoB#S(^^`!OZ0X9%5BsxL+!SH-g0X2mE7@kN!PDW z`d7T1HFoN92r+w-><Bj^WIS-_@^}^ho+$oGE=V?MrV(Fibukd(Vgi5@bb1$aNt^m1 zs$!2z)rjvZXCh@lyPng%naoNv+A=0IxOVpK_JRj_uwA;pf_$gfg}Jk-q?4!;Xx+Z= z#?d_r&iNxz5Z$PN<7Gk-9srQ*GL5SIaPWN%UO%FTL7U-xj|~llTKa-?QL+xppptc< zVxsNT!`?zJBanu~La<(1V2xyXc;F8#YL^@<piG1zM|ef2pxBSCCAWx=<ZqmZ6_+pk zpQ8eAvcN;&&M24s{hB|kbN8JSgCP|>06INRHhQkoUYNTzbUx1IUH2|YD}$G?xY9C8 z-CBK6yaFequ7T+O5Xn#_;U1@?4j_&Gu8~6`(171ZiavQC(Ws@^m#_SM`*oa)|I^+t zhB*mV<$hHnh57~*!MnY$lE#&od;9t*Ej4;ch~j4YtDiazNgMQ1XYzyXZcZ<}P=VQ? z(IDuiSz#2z&-nYMm4ika)KzVpKas!BmC&iCfeGjkXK&6y>}z-Z%{~qRND_Kzt<&vC zjF$|(Qx*J|cNL?K&##lfn$O^8Ac3~k<)pCUjRItJ=%&5qO;_*eV~^66zxckTSx8#@ zmQ0Jm5K5)ZPfkU~Qkq9mbp|{8McF-c*9#K5a022;KvP72ME9ZLbOR9#5x+xpwR^a$ z3qEUd-?r%V8Et?e@zlyL?ZY<bVBvnlP(~id-ui8ZzsTMBJMulre-ztuk4eV$ckVH> zW*F9fuO+S}N^J$&#oKbqxQ!I45cm)C7IL$J#68^Pg=eb5ox^!qnr@Txwq{P9HV=A| z75?25v-lPtEAi^P4HQk_gUPDH%(%0^xG1B<uD($S9k*&A>fso{$U2+An{XYjAAmir z*izRIeiBF>DNm#+ncFTa)Pv+5H`MQqu17lSOr8#tT#{hbRxSRE3EBmf3N>2CF!ACM z18Z<VW$!4ra;gm&p68Zmq)PB!W;z{xAqnmtTuZh}5tGMhJzn=+wE<W}9&W;4WFRZz zJ#t;1@?&y%)okrY^uTLPu<#^^5<W^5THjpX>zl7xqIu4arMGR1p4i;glR>)b#k|RH zzeJ-<pNprQmys;*&+hAgI7$+Z8Lqy`d+5QrY>~lit$D*SMFeXo@KbhsnKV{+jOu3G z3`{q%0$`717NJ>QE?u}T6te6k!W0)8;@(DI$!VcY8_HX?sBfX}v!61`;&HzyxU#&( zlhMk+Q%2vi6+`u;BT?%qD<gVEgL;2KKo_`OR%MP;WTPkMo}u;)mDxI^OTxadDhv`8 zcmY4K(R8@H!GBHcqBs)uE4+>-BC(h6T|XH&M3Es<{*p8%STvcRMr(;z?rpa4joD|u z7=Tg?QKY{pJ=QXDLf~s!6xng(ZrpY7u|LmI74m$uR)Lu^zF!%A2Ok*Mqc7b9k<#M( z&wmD-S7^GMd<5gvd~U>2jqa;zuyk->VK<SOd5`A*qO5xN*5X?7F7XvJI!pW-FKy>t zn^7kkXY^+<<l$xst@ubPtgn}s%^v@-^wWxkw}znaKYMA^gZU9USw?^I@nl=*DiuKY zPxH;dWT(@4hA5QNILsi>^cqPbqfaHnDVs!*ZTOk+29+8c_2S2&0lZN)=x@*57aAaI z<&6qxW%VbKE+Rxh>jDdtfu{WxUhqU7p_r-u2eFW!1p(Oc2nq~@><YFCSQ=yfc81a| z6M%CXt?z^eDHbb*!u$LZXt_({wHIy?cnA^z_7RBq<oh+qO3ZPgH*vwn@s~h~aLZ}9 zC0!CbMiHnjS_-c<h$<n7wf%q$SgUy{KZ>i>EsY!lpNlob5c$S_(@-b|+C<v)aiwuE zU}?<=D?f0V?WJ|F4@V+cX}gt{fN2{NDO%0`ZW;7n8fX7mf`h}G7=ytG&(Hi+%W)<c zX3nUvIEg3tclo?@uwYe}_Rd9F_lpYR1}0?M1XmCYW-aSFs>kOwdsq5Abu+6F0&sdq zN=+>TA4coNDzgcMalA|%gT|x8ah9Jf9UTEs4&w-(6auoOCU(r;+a1@6V7{B{vSwhV z^-Z}T<B2X!3?VKjq%0ut?~Xg4(p@meziZlU#*IS>5+?E{%}zx<;0RYUjIDxsXC?C& zK`mFY>=aY-pNFXmBQlu3byMJvYW@^_+bSfj@6t5)<{!L9)0CQgioQ;hVEc8S12Yti zAJLh%7D6gtM47Y}Fn{1nlNG7zbf#+Eq5h#0*HDO+%Pn<@|AXnM6enM;pG&;MjFOO- zAE_#NbzSJfRxX9%;}jN@V{AZ>XMTP+c}l$w%Tu;dZLO-IF>3z%Wj8hHCdDOpJy8+= zBES*YgO5k~N+1z6yDe#|`Lj}F|Jp0pc(ZtJ*KF%<%tHuv|HO5(N#ZWCqQ@6PO5R7S zWet@WfaL{_GGYHRw?rSOb(fJhg;C}<?bs7i#XKo6;QR?P)w%uZewSjpZ1B%d7BCet z-|ylo)Q<$kLoS2k!F<%i^axBo?bi|W%W>ukB6O7hXC3hUHvxN=!2T9ECF;AC_V1_E ze?A(zpIGv+$#Y!r?ds|#DW<^41)UO|vG-VAUI#*jDMQnDuTIIde{c78oK}9FuHY3% z+i0MUzjSe$8Rohv=MylLD9n1cT<toDkGApn!Y|{@Ki$VXc-=)99=FRxq^U-F=``@K z>ttP|g3r!+?%mS*jEnJXMzi4*mY>-e)jsDX%W?gB&lp%Vyd?x2LQ98KY2Z9mg(4sx z&nkF<ru&J2IE@XL@#`@8BK7MG|9Ucz>gD?&<AisV0~`Gp58qx3%qecztu5D#qO_Vv z6-RmqFvWdvHO3>arZf2&3npj%YW|Bu5_b-|rE8BE9b9O8)t0k7P|@@j0M&H2(ny{V zv`eGl-K6kx4Xy%Tk~=<9;(&3ePli}75xxVB(5xmIkXC8eL299Y6?}<EPjwR%oWP{C zO-_>{lP04?ML%rgT-YxkNZnNVtq2;Niw*X^R@lQLneih5Jc7Xy%orR^-hhSz*cLl& zcy2(q9Xev=HlqMd%roBS$DzBWL8a0uqQ8cIy|yJw7tGwV`VpVKP95FU5EEQLGVQI- zdguL$>^LT8xdUY=)ux(ea|-qYm=cvj5hh!en$&(0c`Rr)8Xd0DkYecvwsJPTwk+hZ z*P%rTHlDI&ow&3wwPx+S#kd>1I8}jlT6a@T`j4UF*!h4A{I^EBd}pASzjr4Oe0nU9 z`}UTBH4V1wupmD&E^Z|2XAK>~cN-4FKYc>aC0)Dv(x|Brh(Vm7p!c&*Asa;M7hmxh zWM)zJriH;Bb>>ge6egU?p-5Oej8@G*Ww!81zJjzJ+ktui2hO-yx4g=X!d_Qn!n$al z(mv;$k9pfs@cHn(UN|eM`c%UhksS@E=Z4d$LkFGVNHE#)@2|U+dIPkql!%{PHm9Y& zWY~NgV1l~xMeS<f2fjE5JB;CcNresi;XW8=<$;mXJ!kP0&GrRIDNBiHLy5)w$1wAq z*~AeOD3J#`K8cxPn@Y%2WLSPl{RtG-+-}3^{}^Wx;xUg5Yhq2f$=Yd6>xRD~rf6c) z=0<<Y3{$b(mIDvh3)9msNBIWi_R<S)53S@~(+umqz}8NnV|yC96jX`kf=%zkRIn3z zzV6vTVC(Tv{7y~1es28{jKPtHYLeuIB227TUp05)+u}KV>vqvJHQ|S#vdMBH+E~3~ z%U#_ltDnVUMT~oIlEfYp(75R%(-nl40Zy#V1RsveEMshrq+JY|4;^_hqR-|j87t+~ zlFYxR4oKhX8B8n(bQiD+=Du8jXHibe|2-Nv%3~(h+fJL(JxJjG3fVAS)}lnv3uO_J zdK%An+UVk;OAaS^Y(5t(w)s70eGKljPj-0T%sT>C;CykI<TRBuRD{>F0G1Ql)$0R# z0MGE*56D_~d%gW4?lic=n2}EQN&qUI@FD?Cu6;}b4jl(k6o8iLh48DJHu%^7I#~s5 z3eo?CEh+<GJ7OBX1QyrHhto#k>owuVcAPGltk=-dN&ofR1r6Vf%Jw&FphDz<&rOID z`azq9V|Cr{WtGDDxZa3g@2z~~3GYJ{tdO{_9P9|w&2W9i|E%dbA-oaPv)9cn69^CP z1aUJgry<0^LX>VpI-in*uU092{scU;DFtx_>NvRlkzdyp<?sV#pbON!eoxqHn5V^3 zO9%$JRO6zYjJ<^Oteduw`kwu)JfVL@ng8l*&M03bU~hnfqCkt#o~-5Fw-B$J$(EB| zpl+riC!MWsHtwZrlvL1|8vdASpHEKpMLuG^C=jEV3lji$pk5MGUG^{8@2QJC1n~QX z>5e`t9?(Un#GQ4M&HEG94lQ@7iW4t^`ZMtVK~U&Oc{(gp<I)cWpH<H}r}`%&vI8A2 zV;C`g;ZRHcyBjN4z}B?Q&BDJZG2*|Hek+MR%cRYh3jCH;$H`Txai5s#lCDlAAcHLc z7c3v}eC|cdZ0(VX{L95(&!T@aE6zzv>9q$9dw4-j>z~RpNwLAN$O0BoJ6Xcwxbgf! zK?+$l$5-?V+EA3wv&uN5pSXWR-kI(MhYa`a0r(^|%9k0c?NfeSa%YIMGr+LMX6ui6 zLLRp8>QwQ@n7NEU<x_;Th-mFr`*<NX&s8H_j8IOA&}S~dZ*9Bo(-q8}ttM?7h@&PE zAQ^^5v4Cw(6G)P7RSXM0_!^7(dmZ84F#2n5ZH36ReFW%}tr7cA;)ByRVoF6>k=Ql7 zj25sd3By}e8ZDUC-qU|=2FZ5V0hKk~R|e7ZY8Z;IY+nuF)3`gS%I1qwO4v>Bii~jE zze|H9O-kQTgQpjAtdo{sBkm7!M-ZP!YMXmvzAgG)j4o3thC`%Vj-NZZ+1au9)YD5A zXMn{TA7-DKOX8>JVH$+8S<hV=ehWP0gQqQxA2HyG^{B!>p3#+l-8YXs2(J5@s0&PL z_QdSXJuk#3Ad4QZo1bj#)uyj3kYJElCd6W7LOqUGM*HAg1((=#f^z?HRf%{x{ItCD ztDsCszooT<?m4^639ds@>Xs>TMnS-;xzA<GT@*M^^bEK%pY9r`A&YClZ#o?Hfmm}p zWu^FTrE|Y4ELsGmaXdeg{lk6JRXM~-ELbpWg)zVFbb%L2&$}3^%hg*(SM&&IdSEn? z9c^{+i8u-AdE5$kB8zzN_qupRyIiU(51ztoyR;q`%<|vfiMeRo9mWF;-8N3=<x4pP z{_+<0-aSY+$M1bo^<oB{JEn<^RqN|}u{P}mKr~&%^HQ>*Jq&dVzcg9byO66D{M9;0 z2Hh0R5>O|3TL1Fc!O%cbL4rJ?@;&yE@M~f{Y12F;2^9(za=QVym(wtNrme@zJ+&bT z3>>m9qcNN7>(Q*u(8=+No4-4#gmfP>Z;gtDlEi;})MC%r!-iY7_MhW=2&|#@x^QL8 z^Q6MF5*mlL+M6KKH*1+y*dZ<Ab};(t7NvX5m0kYpVog)qJjAD+b<=pCG-kTaT11FP zc25(Mxc|!1R4$DN-AIL<d}oA_ZPbtq<?;0FkH;Q-Zs#F7f!uOlVO`OFfzThB(ZJe- z-BA>ht>!)ox8?qL`vuW4qKUO|e`8%&q%>{CZ(p}?Z^MRv@nJbGLEs9{a<9f)eY7;8 z(kT(tuEVOq&)Urhk8dnoRjZwrL?LwmO&3k{ZPpIuo$ht(7r0dEg?RZr)IDBgE14-X zN^dw{=m!E4UH<;l(_5zSUKu0SDVM_noj=3p>n$QZ8s?q@DH$b@PQv@b(g2}7QI}M{ zMH(S!zW~a##0tX62o;fOL<1HNY4K3&7}n*qp`arH7!y1G0^h#t9h*{=AT%oJd5rdt z6q39yNf^{LI$m<&=IJGo{KcuNWX<@#EIiu59S(A<*>HBqHMl^tPr)rWebxUOM^NF) zG^xJ0oEE60igbz1%bwjkZ+Tc=&3Ya~`4O%+JIquYl1vO~<&nT0Wc-xeV1p6%JqUxX znHxR%L3EKt+sz7H>l+Rn=MYmZ_*r&V@LBXAWMEg8^sUsD^^y5*2y6iT%vL&kHH!7D zob@!o&D-|T@<ZrvoFNB4KZ2>MAA{r-bAl3Et4fIoPrgCs83uo`fp)hC*P2yoLOs3A zTG3LEmW5%nY9UUcKJn&tiV03!Vf8$PM_YV=P==4e)81f%9WCGlCzFZ|MFo4&UBV$( zm-IS34hx#GSZr+qXL%7<9}l_s?tm{I7xYU%xBZO1_9ByvNixUqyhY$N+vj*J&JvjX z=#94?UHnKV0Kf!>sng!J%jN|m)k_Gc*?A+3t9~-x?^N&@Yfnk^faptB1VGEHf9(w8 zFaySmg&sT<6A5m>b8L7`k=teqvOjiEV6`u%pQh*$^mXc7J=`K%lkWO!uhC&U#R3u( zn_Do<)@#HEYL{^12jkuBQ}V0P{fum5e0I)NVwPtwz6pB4XC{Z(+&-t_l%2N8$_gTu z)V+1Y*i%<<@o}%mx09Ppc4lJP@(5cFLN`jGvs~*448+eWdnRq?+ZSBA5=%J?zSN8) zh!aX1ua#&OAdi#p_mr~)Wu8mQP2?B+-ue;Lc$L43;qdu8VcYC2#6M#F)EP$276%Qx zVJOqv0wuL|sRjKD#YQS<Jl^&9gc8jP8?4%cK3YkF!bJ2l@Jiu90)d0WHgWP1#+ldw zUEk;6DraycVd49VpT|dtw-gMqtiN7s<tqbdw8GbMfbcTK@I8dC?cOr6Z{K8S1fSJx zL55I5N4qa(_z{7WE$r904CRB|J_GyB)fC-&Yu0kQK9zcMX~+4<nk34M25Rf);e_hj z;fqSd;uI^?N}Z4pHOS10MDee6_L{T6+$s;Kobxw8c#aB4E&_9(c|gMo!(87fnYir% zoZ41?LsGe}=urr*(VvH|x({YzeMXd&^P<hrT~lt{t%mS2V~c*uXbpvdp<2wPb=}<? zQSEZ-*8=L0*2BU!30!i={FuS<kYT8fFbrbK-EPVQ4W4c*U&nl)k7ybmYlQjjz?elk z*wFPn?1Xl=>&CvI+hZS$QQ$bu&oHXcyN@#|e~t1|4Iz>Js$(p>q#VEjcI|cdEIh{g za-)v3FVg-pQfcfm+&Wg%(Y6U&Wog}i9+vL-`22T>gPS{K<JZz`3ZnHcI<7D0u_13a zuWq`WY8%~+irmD7MK(l*n9hW}lY1`F_82i#k`88Qwiz}u4?V=0z{l6YgP+BI2OWp3 zqIPf(c|H5A^SAqcEFkco?KLA7_T;<ulmrbXK}pAJ<BJuJQ*77q!_THG19vd03dCN9 zDB0S4-a7I*`|`pPD;n)!$#;g$_dRDU@qLKitEjA(<Qvf%BMNPpM`<@a&?>IrCfBbn zW5(To6&yH><mK=>&mo;AuvItZn(!#S&ZSkxX5@6Av-KAe4wvp8-k`gzE4{ElGr=sq z*r6ly18Gz9nMl-IV>oB4c{Vv$DKw^=xPFd0WLv5u3pr}<=TFv^F-{*;1&(Q%7rc4f z$CeJiaDU+*N2`!h#U$ooY>{JFNDqZi*~VH{5amTSb$rs|s`|oFo5yJG3St`1-_sD6 zZ#?xc>=s1Xd<eNjpr96$(dSecW3rpKX%{Gm>zxxL42FK#vv%-q)B2K+=(-AqFt#Nh z!Q*Z6>|{OjjdGP#KnoPRvOiCdTfc=6o!UDZO7Bz}T}5QrPb+<TxU%yzJqz+Lv`HgX zSv;!g&3(Apl0&FT?dfp3<I|3E)|;8oew_Y-W5@Psmd{Zu81zdal^l)!WfImyR6#v5 za_dUNSV{5fHu-~R0bvl{#Xh<uOT=8TpJX%sM9G02wy8h1RYUhAu{TxRo2s``MMI82 zpBN*okD<^$E>p*FTa7XD_{Yl9L-Xa0)v8THMn&#D2+;s%c1l_DQ_g-;?V8K;Z(nKK zqgWiyfhKfA`1*Q*23cqZMFz#m+xir*6zx36=Xk|o8aFPhQ}=Wv2#UW1O1voroHP1i zj}*<H)_JT6<8Zq`37_s}f^|?YMQovt35R2~TS>ORH?3kwh#|8597*tBcPnJiV9z)% zIPif4t^Z3wEeP_dQT>QS_rvZgpkfMfSU0?aWcnIq)cWF#E|gpvu{7S8*#aKMV~j3< z&|4*)P29BB{5Ox`xo7Z<uR_85O0{>paV4Dmn{E1-OuM>C1zeW5q~HC8pYzrD279#- zB+&%U)$i}Vs0i#QK2BG~Z7Ltd)_NCPvBcYOsZe9RI*8Z7k7fPaQixxKt-2Jk4@Mx8 z<S4nUMPonh@7KbB_`oW6T%Fuv3S_S9Y+_R;g7FgWw(Sl)WW`gNxhe<7kuH9{XTyXS zLhZjYGR+a(c?3q0KbW4)%AXwmQYrc1OnzLsQ@W5~2p0=|@gd;tZw%Nu8@nh1zix9w zgZI-`{e8#nMR}O45>i&TmxCWL1h^K!BIW`TjDE!dH_ZoO@s+DXELk~z*hzl4DQCkR z@+!U(t7lkplJR7KQ4vjKHpouJ)S3nj85#RnTk9(;P{65CTn}F^Jze}lQO1??R`L&8 zmIpCWk#8x4aM#e2M;6|yI8(Di1B<4%eGlp@tB;!8A}y9-k&*&9lb~Cnonimzawgb) z`4d_5tL7&epD`x(Mch`8EHmwtlG?h>ieM3J+q_oy46gcl3H;{U;Ty8!^r15)WS@r% z;gh0VWBcUZtlfC{Pc;%p<7Q4|j6*8ojJR4qY4i0^rc-tDZ7W)mGdqN>?ZEm-mj>^P z%cRou@A<wuCuaL{IMNnp0Tm?WD|2NSCQ=AzZ|YE8ryu8$&lRP<u*P5s_4?M}+dtYn z-iJNA_xbO639xLgQjJve(N;j$*>=8oAX?j$E$^fAhXWRnFQmII>C@5qEverA|5hf0 z$~46!{(nYbyD_}K6?Z11@u>$D<U^=UbgDnyUXTGzFAa?p6~3rJ2|O-ep!Eu@QpIQ1 z)ap=JfS(lvEmndZ=a0@xtdgI!M{oQlA9nR1Xf#<<)65<VD(>tD!kFn(@yR2I+GyUa zVn&1|>b0(&;tCUI4^$!;*K95rg_yMpqfR2b@t-QLgfSkyntME?d2coNwTQ57q`9K# z=j>XK!H0e?Sa?-LRfWGo<*H+8C+w5kBjN^5V8CP`CzdIy2Dkew<F?yk#c!~q99R== z26lcZW(5mTdFSpKw@@2<wYfGbj6NB8tZTx%k}+R;RCJt3X=}c*55>TZg5$>ji(&2d zSY;hS<nLQbT&fd5oS&aEjZt@Qw~}O0IR2!H!gsx&wY0sw4(06CS^A!WoDC0f9fmID z<(=_g=j3Y7%5#S04|QL=E;%?&PK<y_XlCAlyNNR-5;;Z>Se51)Blq!mnI|1Jp9)Yd zl>by#G#{bp-Q*;{f1JH}{GrkHqKy_k)aq!S{r-oTi;4n0KDKLMpltEIyd4#swhZwZ zB!!MSVk5&zs7y+uh6@jkziPT`gnVDY>t`R-Eh8rZiA@_C%{hB~AC)-y^yXZ0ve54L z;{E_lQ7w>Fs_r)LBau-eaOpLBQ(#HK!*DHx5J%hnK%_$00@+mzeTdb92p!pA>jQk( zjyAxG{S8>iBc_E@Wk8CUL#_~k4j99gj3yh6L@kSe5g|Dv08*cpk_A4vi3e*Lxp^|M z519uG(<v4$4hp(PqQ5r>Q;2sd1q<3UsYbytqWjaY$g|czFR|P^%R-Q~bqXwr#bt6r zR;h8)om;`^^MAuB*t0Z$DG^t?m&*Y~xb23Gw0brzlJu%b$q<A)qp?wq{%$W7j5$)M zG6p>6{IweACFUHpdk)L5aU_Btm|Yh>A`Qp)m5@z$EtO+0eBe$=uP6#;y7BgpLBi<# zj#015rmT&BP5;FFP9K>|TCTy^c^#(ClLXwX*+A}Rk=_L4h`_wI8%{>x%=`6G^1-3$ zy}{3?u?)s(Fk14nqaH$+t7nU3v-uzefVSTH#d{2ML!kVa_ks_4s~i9AVlYP3^YSN= z!)l}Tr~yFaLE3WqjQ=(v36Qo~_ui(|zh#><I|j3!Ob-%FmuKk-wEi@*ED>+-+L9)H zI#`Md;OT0X%RcD$jS1qWF5&ZUV;JTFrViz-Ec-Z@oh(*xfZ0#>PQ<?6X<o0x0epAO zJ`-?GSI0K!OzW}YVe1$Ho^gXobmnlQ)AdTNh+Pr%y)f^vpx=Wf!B@xZSi}<UqPM#? z{eRmTHG#AEt9g`cZ-_qM8uS8pbcEOj!&Zm;h}!c46rjQ1fedu&_(U(kuSbk@2nN&E z-^^Zne=#3JcP$W2+WiCUnoXwkPQN1+!#!%C7zE`+URJ7i&VIA11BaPo-mKcTNG6{? z3hbQmYE%uPP=qrD#WK{F&J|$h*r(aC(@;p$rX2A@=QM~*7o|>mcHMcAL(i&pGto=w zggxq_uWFm<$R`N#c>kco`T0d#b%YW{A5@CdkSfPmJtk!F&r|!awGuKcoO(%jhR=Hr z*FKlf&=4ur$o+YM^P*8eI6k;m83ABsouK=BzP^jc=1p~o(`Fc4Ck0}s`h>LaoIW1$ zXSIAmYzRBwH~W{1*Rk-K1iPfR_Rk9rK36GmNmObNp%?3>Np1HcMpIZ@KfRyN?{3is zjyy!2iJ^JdIvh3SI<0S3&e7&)H?gL&NYp#@52A|J?uXMT4W@VA;hHQPqSJP(JB8U> z;U=xjM9JwBrug9)5y%K(fh?~8lQ}B}-NVDX{>wkH2UWtN&*gElo!mWmw6Q8E>HTU^ zua5!t$nF{_@;WwLhi)Fj5T=({viBm+d&GY9pB;rR=RbtBsn}%WCw^!Z{(&?VBn5?^ zL(18f6evKaFr@CN0ywJ>Q>ls&bV((^41!;Y77aOqGK89&A#iRJ6fCYBc`Y#y`?s{_ z&<n88uQ>zGYs~lo3kAj`6!Pp+%7Nl<0`ihDTg{od&pSAEr5#hZ@oH7kB<KLOuWHV3 zt?V&#tpc%F1`KF}99%xb;Z|FX8B7hKsJ~)Y<dl+f=N4k*-zGgAKLkL`9`D6`sbet3 z=n=c_hyQ}Bc5w$Y)Rt9dNEG<VhPFy5egvY^g+p&0oMu8gEhfbP=vG^wD|~E64`Spv zAi5jM1Dd^VLTN(2tv)B$PqIILyyg&1winOaIvE5y3M1bU$S1k_7>qYYXEbd2v_Oa= zVfs#Hw)s3i;zyLxUDz30uk_>kC&^v5e4zoIqmg1^mTZMcbVc>)i+lCjzZ~RrZr}U) z@Ki?iErZ_g{ea-MR`Bxl;aNO#Z1dZ^7`Nj+7lPipp?HgGyzI3Z`?em%(>edS!jOR! zNDRAl;iiDNGCD|6%FD;t;3S?xR-kt_|AA@M4_9@jOaMr-;u?kCRVog&60GYMaM+(# z&{u?T{W;NshzzBN;cv38<xXB8=iAv<>Tg3bz3b<{KAg_N1#T-UAS{tP4I#;$Xr!-u zPjYg9%R-r&FIw2KI>N<@enIr26~WmLR0QET4nsC=FJwV2xh}#?&sRf91LuA+ZQ=OV zC7Mud!a6uN{+GXHNn0+Nfq$PMV@F#>8_C9{mRcS3@IG8u57EYmvg?j#Pbc<f)glFI z%g*#f<j1}3<?<LR<o{5Uipxq^ceT_Frucm;a(PUQdtBLRGS2HrprK#*1bAjv4q=KF zNjnBSX1TB55?%ic5jyc1^GHcb=-1rqh&4-HszIRF%<IkLph$y;Y~4vNBpHvD4(!P= z@wIvx@7xhI3`=h~e&Lzb;NX)o#FENUPCWB{<p;pHTPXfjrjH0Ld0ZTXRz&8~nq~4= zGnWwZ(n1<^J(`ana2>9r<(Ck}&7kw;dwbxsho9+c#^y@Xe$4&Z>wOT~+Z)Q_2Lv!^ z(R%rW52?!<KWr6Qx1+aF;UnTbdEvO|w}`au<l6+JONC_030>Y*D94ELHM5{*dCZhP zly}7LFPEEwFjj@HPCOzK?Fql{thEk!3f<&+XsvUG>iWLsv?`J<>5vz&<Jo7&Yt(M` zfJO0k{sP|HgSHA<c|&h?E0=EiuEQ1`+PwQSW8Vi>AN)k}275N|`jcNeIb1#$MYuDI z{_|FM)5y4{N#!f3B(U8TLa-!5(<!0FPatOc9+4{Ct23;PEMJxy919X17bkXR)%7GF z^xMg6##nA@q8cEuNR(43OXlBT5qBDgOM=AL%Zi>rx;-xEEweL#>uNU<K-@}-DR0|1 zXN2R)+m$rPq{l`K@r=o8zvi{(ogD~$f|LkWZRK(@0cuL*X=Y_|QTRN|u~R9>X36t3 zCI|rSI0#Uz#aTuer{1;Wd>xEyJ&CHW<>CXzN+P#*v}Yre`s5)wUAoF#^eId#&i&fG z1H*5b02XL<`3j?(@IW*Pa{R)}8s@Bz#thz0te)AFu37@?KN^&!S~~Rb?(6rZ@nMGt z<j`pp-LU|s)LJ}1nC7+Qy>7Wm>VGitlDXl(yAQqQ3;_++55m)U8@SukmeyqoVsKMn zNCf{f&?vrS8@z42c<yQ#4`{W&*>qUHg8+zlI~^}89HHnUSAod7e^*o=PP@thz}CI; zCDh-O8gnm<4ZYpN%@d^?A?661>}rG4d8;qVFnCGUh(Z0|MiV_d3UHl@pM)FnuOzbH zCg(W(R&J39dQ)9P`I|X#M^f;<lxEI9fVYIPct;D1+M`R)M|`06jKJmzTw<ias4Qa^ z(`=q|A>=XnfLW3k>E9l~w;mTl$fmlH{?<k>5S8nmcj4bdzkaB_!m6Y%vfPUcJtpV! z2KWNx)7XhO4lPFV^`*c-=om=T8Tq~KNMC7>o>c`FmKB0?xl;tj^h^y#Y;z@T^gBvt zI23Uy%LwI|YwYPf#sNemfw%LO?Cg%%lE>(8R0)K_03*b%tBx7GkBhzu<<p##B6|$- zVT*m~W&>7X0rb5PLFYW;j&FVS%iGpgVzH+)V8IA6AW^VV`{WC(k_y3ZJ)^On>Zk4i ztUh7<(d+-FL3iP7>OUm-UT|K|P&)Z96$R6=vW8{scusLbC~==jQrvcnD-J+=U%#{! z3!<76_tQ(qb4g<|5xDVRk&imNvhDoZF`V@{410$B`&A1gtbmyOFQPUVeVXh<lhXub zXpY8wEc_2`_fqM`FG#p>a+)am+!juBgxbi2Q30pcn=<fX(tSjA!FdE65Wb<h)@v^p zZ-T%+L8H(vq*KY*1Jod-bZ)#7ylLJ(U1#N1NA$6*iXNKq>jOYM8u7>i@^KINtcS#N z`AGFTleq8LW!+IRqR-3Rs3#v8iS0Z)d1>T``*yv1Fi@K8*yha-5;nnSQf{%D-fZ_$ z{^NhxJ17_V9<9pSxjQ=wafWj2VQ=hu4(GFb3yA321@sS;>Vixs@uHD>ufVs*t}(}9 zj?h(N+N_LWFVkP2z`R{~dUzOId_0b9jzsDa0=^(8g>uHWdn9rWK0<%!E2gZesi@S! zDMtRTZhU}}F}_UBKp~D>ej(43$gLd1Wjx?GYh5umrTftJF5Xu2_qjodGN*=1f#$h! z;+b*kw;9DUi`LtpKG1_v0WCQ;tSEo#U><~JEm<y*K(}QhbT|arYU!-nKwbXto>cu5 z7ZTMyn<<R6aOr8SX02+7qVQn0kRb9}Vmz^8TSm-%(7tC2Ly)9)p2R#vQ^k-3whEzl ze;ptfuT{LVBc@BkZj(8wbkGNpm8+|)1K)#UG|t8V6Fs7ZnA4s*nLE06=pp=g85~=l z<>xbJioLBu-DAkoXF}OF3r~Sbo!UgJ2=*x>C&(F!gm)cSy_vgNb!-~Du^m8`E*G~S zVxXZ8^L;Q(8lo#<NxX@+l`El0EF_ta?PG?&@EOdw#PVCKeOYaE^v*K(Dq$&wWj+Ld zdAWY)(aDABge;B~)PF{Vd1X^w=}HHYh2pNP^4X^GsU;C`7x6s<7to}phix=7E`Gd* zm;2i<UxtR`!xnA8YTEH~wqWqA;C5HG^jJmNaHZZ$8A^EfPjj1$$-e>_<}U^-Pgm7O z9t+65yzAAM#L6?{x~M`|bMSDT=U9q<$w(%+3>dXX`2yHL^l;OpWmFms>v}f!CldX9 z39>Y$MV<Rsdbq82yZGyYkfzl0X$a!CVPw8%-aOzBpW!~p@uf%FYQBH@r#i{ga3tSf zO#8~zSOn0qCJ$(Xo13W0$!g->7C;r{gfiWF?W*8^RY?759$7Y|PT-&axMhM8bW_e- zo=(WU+F}>i7lMF9zFunEXpYlfga?FZ-ZxB=Eww*E0_pA@zBf3G{lJU4fgSnQ8ru2O zqC_?u>#5(P>xW7C264+#Y2`Z_Qa}^4o+Dek`@Cbgu>K(oNt39#j@3hpft&xFdL9M^ zw3DBxEv=G+lo0IXp|f$e9mh_b!VW2ye0=evGp=c?8bYM=KvPn}ZC)OY1v3Ss07|R? zJl}4l^X4ukJ7pp;fY2RH6kz#+atV%tm8XUt_$N(=0YM!?&7nY<i%%Z{7${&$)Mh66 zWxa@aFdeK!$^~mcW)a!gyr4MlZb9Z~<OzN^I`E1dl2RQGY(;`Ems0s9ODx?lH~Qat zcb>x;MEnkJD}ziAlRgRvU3vpoF(pgX8Ei6e+WJ#NYGYx<zH)~vV2p=<bCzzXx*EU} z*n-(Bjo~cm-_~PxXG6m84ScpIKx_S~S2627f;6eQDP-&QCFmcq`(R=6<y#LqKt%&Z zr@~i4fshqr*yw#Y(Yw>8<~dQ2MOYmfNeT8KGS*CSB0NeRg;|Q`>-2i~qMa-h3T3f) zP+u_`RfmjTd&Z1zd(IWEw#Drk4=Lvc{Y`b6KKlnbBc)3p;gOCnDkc_IbD6vl?Y*>w zW0$(#D<<5b7GhG_a;}-kgV9CnTK%hlKB2h#pJ!vwSbFg~CA(yJdzPPw3rBjdX`+Np z2T+QiWXFm~u6-WUd(i@1i=6w4hOdRx5?mntXK@&%ZqR(s@d?2p>RZ9FA@Cj6mh6!u z<}q)ZUN#o;Gz`fQ3Cwugg>f8Q+o?)&b(h7f3P`0@*)Z;glF1NFnRqiWy|~8XLa*4l z)Q92FlMl$+JS3G6Zc2+5*|`TG2F)0D`tOm2m^dr=rF-fUr2c0ChJN#x!EVh?t=9hb zm@r_bF8iu@UzHOFH2Em?h)12xWlY1m6TeuFhx$U%)d1$345LKVE)p{_^pwVrb3=`y zBmk)0gS0qJs@!b8?%j!?1QLrhuluKhABjl#3QU+1-7njBCImbD4@pcqFSBF#aU0G& zKQcUg{T4Swq15OS0lorVro^-k#_3G^3Pq$_UI%)!36YY|4~LE=?@HNfh8@28uS!He z(>%u0_p<nm$9AIr2{0i+KiOW+j@9rAn<2o|plfg%+2(JlO9bD0E*^0A%YT|JM$BGd z^7(|OyK_qd^*lx|%SkPsb*`aGTzt@CcZ)SRCZ$6l>VWv1;Zf0i7!l;*@1FmcmqWvO z1!u7G9}|Cpqm;pZY+~S#AlCu@P`N|vM89AHq+okRKI%~hBWHD<G>vMuF!G3MD9ec; z><Z%}TyO9pUt##9u^ya1{mr<{CRk!g^E@7|3n_W_-Wa9psDlGEpL{@=l-1yX()CLc zXRcKP3n4Uf97{sSBp%9X?}>m}T>8<`gs%Sc_5gerNtOXjtnDzw(98{ISn6-61my_( z*V{Cgjp(H0&`y5%t%4|4NKezr5P)>~Mbi0NRn&V}qM%)kZVcB~wfDhxGSe}F#=%$t z5qG%p?xH+zxPd#c74e!|J!SywcaS8W&FpnBsUQ~{mUKKeJrKpEmFmh;@-=+#1wt=> z-?L#CW?4nQ%Hsy+IdPIEF>s4B>oLQit{U@i!3am3C8Tlfy8`AkX1v)HNzBKR+-MHB zlPAjq@kPpiS<w%C=1ODrc^cKOHH@VB)C%|Hdsh9i7Eu?^JvYB1a|kgXnyED>nyg<c z&K);y4+9s!ZQO3-vlK|t^zdUFag1hebu=1&;5b(uM~ilTWXC|EpW%WPCJBO<j{<>B z>|P!9=V!U=gBu`P6rS!0`ybUpr+rgXYNLtXDg@E!H5{LXP`W+T+qtr4^zB)6u8h{& z8voqa(p|DB{T0ST=7()1f^vqXfb5f@Qy+{;?+HvFV+e6ZBA1bY9THYWC9>%s8X~uF znSxeJtJ%G6c3=+Zfewp{1DqzJ5}2Y@Ns6CIvA_W@Zxe!xXWo1GfH+ii*t?<9iZa=G zO!Vc8#?956>E`5@J!~g7+^a3MuJTg}o#HaJ35jBMbVxhQqC<{N^NMpH7A$!OXn3zC zsGZ1poprf|Z<HMaQiscs6?QKjy=JVAySR#Tmc+{{_2R}c)|X}?X}6fQ$eO7Nh>6(G zLndh4wC{+5pUEFGP6dtT2J5XS8(|)dOym4wFmM3Kt70eQ6q=K{M><=M>Qm0(o#=uQ zV1PE9{Aegl8HJr|85>?d4bf@TovJssKp}b;OAJ?Jo}9ezp_y`C!X8`x-}Yj{c7m8* zfcXLq<Rd8-D;eaF{G9I)JVe$0kAO}8o64|obvulq{fW<;6dU}IP9wsh7^bValNT-L z=Q(knTmlpptCEx1Ja|`UX@a*6_5md)@rN9g7?3+JN^Q{qhmk=YjYZ_;hEIsC+<&$1 z_9Gd^b5>|H{+NFueNG{d;2>Xj@6EbgyD2Pe?i%+`dNu5BW^O=6L1F&faCUoAF@(Jl z8x){F+83K@t2-TCOo7z}uHE?>HB-~ZNaKOSMpM9H0k@{)Jdx<k!<I?3aFzAjRD?8y zw8xHG^AG>Ke0yHUwNBUBlV7_Bk^$U^TR((PW7^e@^wXiMycV}tMeEmY^uWolT};nt zXZoVfV`m072?gsunfTbZhtK|wZ+&8YAhO4iqdT%=dvZ2K7QPuH+lLWqKD?UB%sc?v z%JMyrz<*t=$$5H~1Js?Y07zxJsIT~-0L2Y0!f)Wt9v&ipt83;)vs#84&?)ju$LF!j zWoQMY?&qOYRb>z9X=+&5vyisREkX&)7Y753W3h8+XeOW@Y#6oZ5cT{ceBiIM5W1-X zgxhwb?*J*8#a&Tm_`xgLPMm(dooLnaj$O@C&GUNWj@!qWD!B!p155QX-V{2(8I*L? z*#rm)!oe3Wd*(i~V>8diV?y>#VdoE+NqR$qib~F!{HcwJ(!PD=_;t<?Ns)qtz$aI; z&A;X$`EW3m`i^AsZW6Bm&UFe{(%xiGeeD0jXlv^P%f^<Bq#16_xoO!GMzp2vQc*|^ zcx=4X8C?q{FXOO!`-McCt)e7jN(7G69YRu!*82|rGYb86o_xs8{?Ev#v)S&F*Rk`- zE?m4++QWP755EnBlak4pTrg7m(*)Wt_D%2JMIOgzETHxNJ#}dldWb%PJ#0c;3EkeW zfA&wJPhrT`s*uf?8T96|5FZO-Bd#xzw|*)!3q#0spwz&E%mR!YPef9%!CKEUmh0rN z?>=eEKMxkCzB6-<<>;n;p9}sz`CHP%u>ISs9=KhBM89qkJ?4%u9;^wrt34H+6MQst zUJfA;&$87N4qd;selv$t#CRJgBVmj1UkvYaBRgrm=zRlk=#_1J*0^soc|I?NNkLt; zOT|?4aw+~t>E>3`s*R<MChf$*Yi-9}HjKX~oK_Tnt5A~@>i5^Dvf02wvQX6TPVML) z5{`BA3#G%1;#DF&e09<;(5S+0(iUZz<AHDbBby5M^ex%y$A&7r(CQ(DzdE15M0c@N z@QkMFP)^3zx0p{{*xvtS->sm7rAQFzpQ<}a<m-z)d~Mx&4f}ogl`mRB^SL(d?GLZ( z8||AF?bCs8(@$BIOv7$k#leUaPf*ZRMrfb{2A}}Z5+GUD>XJiHTBUOCFz6f@WR2xZ zgF`sriy!wC?y^7*`VC0M(*u*19`-N)7L>_08(tV!8;xni=7P6MPcRd&m+b=Zx=?su zje{dw><%0Igf_nS`f$EN!>6F>^HB?qxi0sr`r>sdFShgADo^K^XMJ3Qca&|PC9l&} znpFHRD>+d<{?w!cMvKM_GKbAd@pSMFYaeAzb=M^k)QMqYdl@lszxdqOT#g&;$sovw zv9V=zAe;_24grfNxgkRuK*j(U@i6S=nZ-j5D{%7sJ&MZ*qyNzFLa{Gs7&10%mvoMi z69yREKo1FM9=R=|@jQH-9+^<K)39fFcslCP`1pBSjb|0lKku5Nf2(8kNAREFe|rbU z+Yn>_j~h;aHne0gKu7O7>1^BjCRIgwiZ#I1{c(S1Wpst=xu+?^C?{WVE){Fx@%khl z=ht>}cw>MI0Z@Cyte?5$vOBVdd43S}GPyp!@%+nxp%$)#103}8#$EvlgsWtf4EnOP zRjXCb;0%r({($6lsKZXRF_fWKcN^g^E79HUzB6ffoT5ox(q{dZI_Qm1L{+x=Ga#h5 z*zQGrVqxgAkYa0=-X~lIiAFUzY0eS@_2ZWKK=AR_=NUtWO;)$^Jr|-{q3$}{v)_}o zvf!-sVdHWxORq0bULd(Z@GGX+@OK~&MY~HkH9C~-NbV@95D~|T>GB*PhYSUjCbWRE zqf<bw!l2rn3n)03IZ;uLgO6hp48!seHUW7qMISzQP=e9+L}elnlcI!OhO$lc>1rAg zSv66Q%trlgamFgR&yu0Z$<GTVeZB-Lo^CJ0OI3xQIu-gkKv6`ZQ#<!mB$at;5MsH7 zd&)im(55d@$+F+U$Ja=(V#uMntwO|h;j$$mHPVjWYxHeW`j7eP9bUw)Jz8kwQ$a+o zPCP$O*FD(CORQLHrR7etW7OmP=@dMTm}76(Y9(~uln&WpT6(a(C^!h8DLx!Q>a8+d zB5JOhLy~YN5#>yW%d!faCZJMaG5AZp$7N++z5fT_c{1(`{!+6|R9q4qxa{vqXW)D0 z?5}&jE0gGYcH)i7<w`<a5)2s*fpTP>@73|Ko1<gQ5y5Uhg5Y8~9_`r=l;h=F@Pp^0 zEAtM+uYL=lj??DbO{FpT^Zws`(64ek!1z2DOuZ(3`7$#!PIjq_QXKDr5E7@ZfW^aC zmq1-y$8}6ygGhm{u9pMvIAuG{tw;)o9m3Me2H!*f#|7QBHe7-K6688*`6svh6UZ$A z2bhZI0A25DFIfzGarenm2;<2Fy6FX{S9Ay={q-DyMW>A_O58!f0}Tpq(^2n4NNp9R zA$n6l8;xRJ8|=7;Yobz^iokczAk6@Xh2Q@Eq{g@YuIhhnk|QemRO|tzcFXB`+VHl1 zR!Dq?)}#A&zxvMBqBZDkSL0J2(%Rtn*Da>zk|SqcXP=JyyDR#Lci0HN_@6S=F3CJO zg|9u|M#Z+gI+zs6yMwUPtQH@F62bs@^*jTrwZqsdo89CbNB`BN7+G_5WClj)KPCa| z0ahY-?A9?N@1ij0<Gk<ck3Z)ln;wL(Hgk4~D*VtumA-FTqHgm6T5j^tOXnSLBps9T z_`bf2hnW~~pDQqG9GPd5)xLRc@v~cc_&-wutsPgh<%>p4rSV4B?rYCH?5u0%36Nb2 za8MVmPbZDgP@43hojeld^#kPqOjXJxTiwxFREoWgNfYPQsDO^xkoskf)*;ZAm%c9Y z<yjfiG}2z{baD3f7hu%<em5~SaI4!o?lKb#I9x<(6}BF8qX0i!3Zu1>I%&Y;tb6}; zCNIriTKE-j6d+z{05w6!WQDeAH=9hgvc2u?=!WxjV}o=W$=vC1Cit(Yb5YyL&Y!=c zSGmPE8`I8bA*pcpWidyEvf$iW`1fKZ!G7n@U#q}Z-i4qq^xK`8R)<+4EJsoOZKnxG z_JlU)+B-_?`|X^lir<N_(e=Am#PuBXtXynneW}BO;(AngfV`2lD+_O%I~Gz31E#JN zZ>idi6e5r;;i=fqx62z7|8q4HiRd)br!%6d<p-C*BP+E}JaV*_2Ao>WpP~jE9|R+r zqCk}+2^b?H<)SpygmwuRlpSAeLXyQngosaK=n}%eO&^`v;{ik6yqZtn$%A9b9rrWa zvmy;<k>&SZR(%&WTRn{EXFfThO8+MHz3Mc%Io@nOnC+xug40M*I^KAB*CAf3zJ_Yt zeD@EAcl4HMP)6&*>wNw2d)DmSf9X!3Cu}!=hyl);uK%6$8q!*6o^4(D)5Y3(tho?? zNE+Lek&RSgf59{gzrIF)-Yhu5e82~_ihN*6(1Xes+ucsx9C2cFj^@d{_c|jA96FvJ zAlAO$T>cX6H)hS4__pzg_aNd410rb^%^Am=eM_TrHB-sL629M>Qu_nfxt(-3szpdm z+Ik`_!##naYE49qUoIQu!rUpdiGIQ$mFA6=VfO+lg$63qd`EK8DmyUJ&y}Fn`5kX+ z=#2Jd+n+|kd8Q!Y2#i@Xf=Py7Lw=dnDr!0DX`^)w_u_!+?v8*OBSKKBChno!-pQXT zsrCHBLX4jOadcHdaWzZ$EN(%AOK_Lq?h@SHo#5`a5Q0N+cemi~5ZqmYL$DCs{qBFa zI6P2WJWQYI>FG~;H&T_iPk&nO9wy;lBoHaTG2?g+J#u6Zo(WhLf)#NPfnlx0qM!yv zH>WKaUI7pw8csR-7HS(A;^Ys%b$=(H36=MAOXMh*%BPN=1bo#fj$oc04C*ZvzIFhV z1n#DLSGT*7*Ibd7d_9)NtBa4Zk5K`dl1N}K0<ePAjR3m^mI$*2fG3m;Ut3Uv)vKN_ z4=AWmTgn3ME*K98ErMuZ>L?-<^Lk}a+yb^jJa6miQ}y9D@p$WeQ_u*tJBCIUTch8q zDy<B@?r0+@hmB+S)^X*j?5odkbLBvq<Ssp?-hw10Q9;!g0N9a+70K%YR=TeB0FjYN z?oRH9xsP>^RrcmD+QFzM6J^ME$%QjJpP)%Y?Ai`~?#kcX!ZE-A=*x)R@CV$n^jB5g zj^~~r^f=p^$BiRm(j;jl?~A^`_4?PY=40eD!c=e|Yw)>#fd*D%C2Xb5q4qIO(GncM zsMjsfTut7eDkRu<&-e$=fps}5tDxa?C_CN`i=BFJY)mEcp62vlK-t=5ghQ@62SG?& zr}$9~$I1^<FnnXdNv)Cw@HUKeuba6<o&M0UXI<Kr;>;?=WJr)#vWyb@o0NDeAc5l| zVEbm|B*oC1Sjra|+ik@DLPnL4G(<Ocdf)G`cNJTnKPr4Wfew!YLvH1Te0yUA*lBkH zexvEr-xHHA5+f^8VW1U9f#2{jEGQ`~OfrSSU+%C)!<FH}Rq<MQzD!r}eW*3=U1i1= zG3k$((o$kuzE#}-VcDN7qnCteC91j!IFCTZooU(Rl7Hqk#msx}RCl}fkPHba10o?# z34WKz5Es0~VTc#9UJq(e3))vix(e+n{t$G@LT9ymT#|QOAh+#}d&()d$M)GXL*jKv z(Qfl;Gkfg~b+Ty968kZwV{5DZ%j!K;(U80tv~m?6z=o*dC(%w0U28{nzVv7np(Q@w z_*9d26gl@0<VyN6W3T<&Y9%*FU`RA?tp3ECvSfO*?p0Qlh5<wW<667mNJ5A0Ve;<w z*{PB3SNG+qAILfF-s4(w#hBoZ^QW>_0{e90@xZ^f@078^uMt~Fo1vv|h$7|MkvK_u z4go)Eu>~)BJ^O|M{Xl!t2Kow0hxxkKFC@?BfJ4`wV9q3r(*Xpu{6;Eg#Rf>prrUEH zGKwWMJ3dR5YePX!s83&_BsnOGRWF+f-(Mi7LXgkdvz&%*$ThP(5<US@wAW`bzvDh` ziJfIvI;9m%vf)6Xh8KlZ@#zEjrBW;%Z*!wMTT)PO!)wmsC|1~5SnhaDHxD<vr8nxh zM_E`-wxO%cTF@s2c>E_rdJh(~qvt8P7!pQADAC+0x-S6<Mz>4reV>$&%fjOQi>pD< zVB2SV|ECAzrl;%vdTxs=v!zOpy?QC^n0799@t%G44jWv3C}|l;uSeZeOfYVQ*0eF_ z7tb<KhDgBt27C_al%*oK>oUdv*vwRCk<RmVb%H`j(=bDlRu3N2qYC$D_E+VxQhf~O z^(7j<1oC>U=SqN0kRI6D0g99xae}1G!swGsk2Bd2Bo9SY4~g=#zQx^E(D6RqeD|#2 z;gTaE%L^feyA;Jn+HTK$->ba%%H`;Pz8bh5?ost2bX`ZPyPdtsEhPN!)L0;*6XpS? zM`8w)h#J*0vUY18x7*~;v~4GSmhL<HNC8&0siJ6zAe<7+qz7%-;i}hb+v4zE!P9!U zSs6l=Jb4AX(sZ(?qPn@!A<V4ku!iAO|I^ce%rGyz<9&Bv1rKb{AxvE#E^xQ<ZvFLd ziryv`-1BbA+8cWB>wUoe&X;$7@JaQnKX+2*C-0X)iF+0)_jms-`?O#7+;C@FN!w@k zpWvMCH?~$>r&|EK_SYT+lAh-r$3?1>YUiz0p6Q0Rg<zt*sqfnzabh@U`w|Dzz;`Kc z@~Ll<$PD#^ePTGs>EW=^HqPdUA{YLPY%sZrtc=~1zZZ8ye*T^NnTfXPu_)p_7LWbA zM~J<>XQ4-EQjX;Cf~fhR{?2B0{N_k=m2krd>hp_id6yRMjU3Aegp#1|BPuoXjB4cT z9rHGj?^3V8dp9qp*Fw^qE96|Z-ob_4)N@s!-*jZ*dsA}X&BMu=J})31+*o=W?rU;^ z1}~6$9IAeJGhyZbGC71Pd7c*(J#ARE_ZeRRHJ`I`_TYXwIL&plRvX=L+;deqexY>8 z`l}rdt7A8Lwj?xE-$BPF|8fg@7xb*>q?OJOy=ckq<CL(T>xJgfMUL`H?D3d4MLZ-P zYRfU8q8YB&86PnCARUPfFXH$GNo3K*_8NgJRhOgw6Bel~CoPvy$bw%t(Aum-yV|rT zJD~l~U=8Z5!~bNsAhao|@i3<nu<Lv+H%>-f9L4w+B5~IJTo_JQ*>e7b>|DD)1ssbh zjV|jyuZ0JBZ@QRmKjPp=AP&ZGzXbeZN3UlAPX`<bN3G4Ox(xgrEM^dXIuVtE=N?Ir zr#)N05e-io0>Faz0dhp^&L@EpXAZ+>KkQa-QYVe#4&ZCB8)IBmExWYI<E*VGC_4r8 zzV?6HqOA#Yxst{gsg_%NI4+L9bc0a4=-VrqM~Po$x&sY-%#Gq%r+AkWFc1BXilM+% z<Cs8+lD5CCT5!Omg?(7=D9c71NkH4k3!jfzc!g?{8k0QV1_Nerz@X%6A8wQ&17>Ng zhF8_A*69#-j1MYSu%mN77lfO^t?GhqAtBQ)Cs~%6O~4Af-B~qvtb#0}XS5B&h!B!l zH$uNM>qx3jfDCFhQxJi;u&7ujJgDi9xzRTn#;!zP{z(vNqPx;=ytM)TRlw)@W|NHo zMLre-=z-rcbc@3AUc5231uGN#yiwz6D3B!S<at7R>3z3@%C-MUeRSZ{rC0aFTK7E{ zUiUaThgOC<ZG;z@n;OMRpY)$LjaQMIrhkjEy8W=s7w09xvipc>8NuMr?`Jq}gV$6u zW>UI?zkCgA(|F<oP|8v~GlRIcZq@zz?9oYKXktfQ+_ktJAL%1ZoF#tQw1=M~@Lv8a zIeYiZUKAvP&XuD^cX67JQu04Fvbtweosd{))E@7szwdUG9Cmfu!m+?W)DE;ByO>eV z=6m`;^76zO5uM<m^)rFyDmsRU_Gdc}4Q8b|UsJwTWY!+TyX)WibA$Sq$#jb8Npvx| zrBYb`c5%TsQ<IIgHCX>@J^nXS5V&fVznSEBgZpIur^A@W^(IELBP@JxFC**QV$tW( zXaS$Hmp`5~4$lK3-g7d|41_JjLZ#d%1LSyuVTh?avYVW9^>L;8nKGhtzEfs%Hl%SJ z?uN11>TZ8K{5<|RWDV^YzEI{e(Jr5hkq_@3Afq^5mG-WSpeVX{Py`7x<u;^d&<YO6 zWDU9~>eSG(MKn&{j=Dx_goT8f^bv3<NJ8sEOLOIa%TvavHEHsY;1iQffij}QH0P@q z`-i%AtHCRM@dZI(>&GD?TwkZR8Ug0>0vsn~jmE7k*hnRgiudmMD?8eLS5rjMr^xMh z2feMPra)@AP&s@+z&F6D{6RL6HMe?Rx#2NF>G!JlcU)YBg{Qwn%v#r)pGXLFe*=y( zQ=4VFJ>keXF^?I3P1sX^a0%QvI*ME(b#88w2FBBfII(nA>3wWuh2G|al@prWZS@@W zXS>KDSDE1RYYW0TjMs^9=v<ha=_I0MHEgO43L4k3B|@#}F4dh7PgFb%f0H>)H~J%Z zBgSA+rLh*jDx+SBXkyyj(V|HPLE($0I!L3ADON7Ad1QQm7n66f;iZ*r$+N8pj&E7* z3qugOg0_c+3E|*G8uq!;L!KKdB_NNg)i;|iO`4=ks6J2r>Xdbx!=tPMjV`WEEg%^W z(DFi&2KGA~75f*%8C%Z4<}st;T(@H25@o^QKkXVQ#p))AA&~tLyc8C89&}uT0c0$x z0Ct+6M|YAerhhy)Z*!i{-r-T#y_bE_$NHil6>y>?neAq|8FYmTo18#YDQ_$e2-NNg z4rcBBI&=yM1WH3dTfcT)TwNq0E5~T#I{FKLBQw0HvSM7gvdWYR&OhG6lYb4xUigIg zurobw#&^ZV$K>F67t*@AiAUfoF<}6<!~4YM*0PlK|MOC1KYn9~c}nMQQsLJ|UyXXN zF=nNX@+_o0p3|f&RI9j;a}8|XyVAS`(`ai+bBn2mP)}5Bq^ZMQFJDErI>>lCYesk* ziy;4?oHY@>ez%}1PpJeOh}}!I)E8wb@HFfqJdAf6x7leTs>hM8Q$T5F>Q*OH82;vS zxQTv&hptg+51m_h0Oja(=Zs+U7{L(0Z>evu%Dzh0cDVV;A-?K9`XTXUv1X$<lSm}r z2KvZe2~?I=9p^uMO$9LctbxoWLlQ)uJVF{8b3U7s#(_`1wZo=s)vXs*OCTbRHz&@) znsYe|plydN6tt*II_syR_Z78~W2lZRtqasV>!TE;A3SncRw;7N*!1v+q54&`@v+gP z!ok52&?9jP=#Rm$9;_lO*QDlj6uR#CN**4Cv{bLSWHGU1S8uN=+q56)#D-i8Txk(2 z?J<&DWltJTwPwj=C0~HJq72EITJ8xoSI6C~H5VD8*L+l`+-(ynO6v4+lEzskkp8`; zoA7V^95|*y)lCneny-;ZTa{v#hU<LV<q{PZw6x@JBJdyN_imh9Dm;m_)3T#r!0Ki6 z<>#v2tUnyFRumhzhFDYo+Z9xb_B;5|j$UDTqW0|M)Edh|ceNnB$mmUe9YV`a!!&Ff zk%W?`>IQO(ow8_hUo3wDe7=icy|MN3r&0k~e7dZZi)2B|Q%8MlWJd<6P={F0Ol!C8 z%T$F@)To)x5d-NvK>av`oDj6=-37P3z(5Uz`I6i3{)wZbuL$+q6-if}>!Jp2FT_Wl z*RCjI1Bt&lNuIZVy(1X!9S8$?crair)2pqnXMe!M5i-I$M(@pOGr0}6A$%-Y+Yw!0 z^?|ARV#tPUQW-T(hHa8qSQJo}NuV5c*&slog)hb|PS|fxIT>OTU37aWP?s+?<tvkn zfp^-#9zPu+AWxwK&sFr*Vy#^Y{_r;3t}dn*r7qN=!#vE{TJ2d@!YBUklkFd1-OdwN zQJiR={(-S!r-{Rf?f$$;m0(VwQ^io}yX&-Nq|{{nFpt)U2<IGOlTo%?JGiOmr4p(8 zWOZ?<L(5gHn{q1I<0Qh_+}}nDZnDAMhn)ihq76Yp^ZAqVE0Da@n(d$l>%Uw-@NijS zC%vst3Cp*<&;IFX4l_ZUgLu4#?6WJgtvX|)<>)n0HO+o|(sf@5C%F#ixV%wd^5S|V z-H$%`Yw8$|Mxr;BXU^mAi~DSpNlv-nzA0mB^!+nxFie86_Azq*#nXV<GSFiqNzEGQ zu|-PLMGuPqJ1=sTrqexppg{gA`YImz%JLgQyE%0(*{}R}ieg;cGF%kzOxeW&`k5|p ze0-dKYDtAUG<NK@_!}^lT0;3N-<IrB9MmdvG!BJqZGlaVT=I#Sm<s0gHOA*SNZq+8 zE8-2ZYz>?oOjV_>GmOFA*2p?S>y0O-ao~1XS*l?jY`>G+37B4EGFP7!f>Nf3ZrM;n zm)PRJ-y0w4&#G04D-3QK*sF8mt|>IDl^QAoJR&^)er@`xr-m}h?Avvs`ilj(BZcN) zed-xR3?S?dk>k=~_%G`gI<0fIm*t&n|IGEP%g`&Ax}o`@UQetmk$bF86RXu=kYOtA zF?gbH`El5uiEb6U=D6#c-SAfCt52fF(*^gi<HNi|U98ZX5skycJPFyjQ*T4MIr`Rq zNS>_)rijHHX!{w3D1#YvA#lJuao<{{+W&Y{h8UaERQ{Wfkz-8=z7;%mWS9&U7s|(~ zjmXxCndMVVuQKPH1IlCcx#R(xTh;2XL0rs>KZ?AyLK~0z6b30s3|6xN#L#eH8j|<E zPp^k^=ILxh5Kx$H$ajenlvE1EgF351PC)^8?7n;^te(KxQ9=L(HN=mkB8rgf*-p5` z34m>%w5yJ01`1nrj8(fbJUrg(&)LDsvIRuASxz)E2A^e8KCAV3guXAUYlJ*zrO}&l z$z<_FH({7`_ZQ`|X!thC%W92@)~XqB6;<qen4<tCSYCG70^X|nr^m;<*N*(ziqN#l zat*lyt48%1xz?K}M@I<gX21TpTLw*<vy-7Y2$EUZ6X)8W800W@gZeJzlzGH0hTQE_ zMn-Z5uL^MhnS41-N(i`-EhWZEIo0b|{WoER1QNI_Kf~;+Xb-xAX+|~bA8FZ@A4Jhe z3xvH}`*|lKOKEIwvd1x#@wHefMbG&dH}YMYk1n@-EDXf9o^$v>+nd>yp!H_n8B50w ze{XV{|9%gvnjI9qrlYxmM%*d@t^mtk>GAGKpr{?DilWm@WBF?EX|si_7XfSbOU~pj zD-U}qBXIaCO9)PP{-Unpj&zaiI0>W?)M50Vr~**VjAAX)o^*g+;@~_oW6x)3W1k7x zCWf5J{wA4TXD2}H=Z8EV2M}H>Exyt5nA%yc{~zM6%EU`+j65Q!8yla6NcOm<)Fx1? zt!JS_`ZEzoR(RUuFPh(ulEd2#H}A}5jh5xVd9V5Pd2GLXzq4<%mqUc_QbcweZ(nAo zdOh*t53NI_>L!ygWn~n20YLh;_*T(uqI$tX7safM@FPOQB5~F)cLQ#9{o$ACZ$`3O zKx;LF=6+Fr<VP9Tat@`?{fV9nH~MVF;`!qn7O}A36+dQYG5R8meo!S&n%Ae#XD809 z*rK6*_^^DEu4Nwej^<KjRL{n$%{d1l95N|&Wc|8t%ZbPS_8Ys#)4;~1b&NNcfVEsA z)R38;kJ!I%y;<x;_b2o=QL;>pRG?`6=Od@7VKgmJmRDQBk=s%6ZbEXznFiuitMnZ1 z?4eKNF>92oVUCADW^xI!WNFQJUS}qwrK0a;dOCi?pHp3zI&;+gOw1=6w-n0hy-VFa zKlmK&Hm(*3Z{~#x#yoQP-{a<cRO{WQFdYNEY(e@pWtjN`bpq&R8Dc<?C8M7+-k!A* zL><A5z#*AFk}48jO^@JQl-Les+-?q~ObKy-lK_6r43JmQ&&ih~#l2CrrK@Vtrd!Es z0QTu2)pRMRn({3adWqng)t9du;byw)IXNWx!8xbeAGPoivE3?3$;HORNFA1-tYLW< zbzuc<)tQ{q_HO&-USD5-6}#C!;n06&`*Oi?fHw(sS?r3JbL}7LuFi;q%QHpIz14Wh zyI4UK!l>6Q5b)QF%oT@Yx`$S&(kQF{QU562@mWF`?AycP^M2;uV#n8NwkHed-4U(1 zovH#klXKaBQv`>B^&Veh@G+~Jw3+3qQGki1S72Sk7GRv&9qxy%Av=FIL1(*Raf;!u zzQ5gbklM`&o5yjAbfK$a@$XP$%jzVc>t}wH__QKg6&hD;^YNh1>=1nA55K)XuN}*h z8m8R!NWCe7Uj}1<3!;>>ndX1IKKG~N0FOoYNu3l+2;7eL_Wp6Yh$g)v-?o6Xu=34r zs?=R_bdrEm009_3qge9E_0r0EE<%$IqgUJl6J!d%Vf_(|(ag(h2X&-h0sT1&#LdQr z2_7|(<19LxSsQ2U0HPu22qSEOp7?Ys2qAoIs)-LWVaB6f$)UC5i1}Y6gegJfrAFF4 z>{!dOAD+*m6Az<|)aLlB;3N!CDVBN84|_knU4DzjfV#!<&OuRBaju+vtgZ)#aIaG| z9IBxu&LFFJO&<y)^fLOm$E!?+Vyh#!GLlwemZy93!s8u=fJ5pes8+Q&@nx{ROH(*1 zs-wJ654VjpQY41Hdre88uH=-Cx+t(6=xgmq9wW&!Lh)2jtJ-E(bB4s#T?Kc)lRp77 zSNSP+mLR09l1`U1S^ro6hG9lji4jNJoZ+AyOv7&$aB`rT{&A})EJnR{4n7h_PA$^; z^i*9TJT?xF#(yz0h0Ep<4<}5Ss7RKKwr;~i$sM1FH|v~>BfzPUfM;v3u05kP{K26i z7NjD6xpZ@g(9Cc%k0G#Lt$6TJ#nkv0*>YCz(eOv=26!P?B(D6EQc)n=Zh-IC-T1QG zST@(KYkM-gr!nSzxKJnCtj3`5+tgS}7hhOYr=HEaA9kDf4HEuzs+z9p&vKiP_*-p^ zRBZe}MYgm{SwF_&#KnrAvvRg@NS~J;zoz|VhE0_YUN%m_RV^MZ{w|Y(Np;PEZ9DJ& z%Kn$R2m{eeQT!%5>iJC!$v%9{l=)ge7w2_kQKvWJKcW%c*`EXI;>a;}=ybb4YWp&4 zaVE`wrh_<t5ftJ%C1as8(4ADjy~7-m>XQavJwTUDL*u8~=_TWM;>})6c<*vQV+MbM z%|})Z2-QF!lQ=q+nRMs3akF!?vvaGmhL)Qj405YG=F!`dWOzD~nv${3LQm-eTd<^g zULbo*k++?%6JtU3yW%!`p^Ng1|M!_~&>7L2t(fF(B%p)~7Mf0C`iK4V#2KXIq;eh@ zrT6uTAGc;IrE6Gpq{KGWq21%S%ZNnIvs_AwOK$VkcgcR$cYS0e7=V$IVr4@@K*EZZ zmYZo?sI3T4FaD_|?A~Z&{--}AafGfwRzjHb>%Jy^q*SFOOGW(~_wV5VLrylAra#Fg zS!J?Ke>U#->oz$@!QE;Ko)r+GqukjQw-qv0bG#;XXvJt&r1H$ib?(-9mY5QLPKuvt zRQGQiCy))=ZZWMw@pD0N&ay%9Q=s+n@5Q;v5mx_(KRQ&?^xl#55ifQ>pXHkAM!AZQ zbxV)tvfA(CG{<Fhnd1nC(K7bn73d@nWMyT+E}Ph>It@_;v(IPG!~Z=?CyFNP%!(`X zW+{~MC)JPHkRG;ClxbHD@fl?J#b}n)l-_UTJR5$PTKBRH6!1p@U}O|9i3as~*LlyP zz=F-%NhMUMfPnDIe~N1x_H+<TAIdm-Uk(QxQXNi&5=ow(f(+4~_2KJO{ALDWwwso* ziIhYx7UdIE*zx6@JT7m&zvri;ul`PNj_CKs>H0V}@U>jTq2xQ2EAP!z@xRmalT3wa z5ES`K7B2E=Bk56DLwRtHt5@R%8?RtlxlU>dlL4O|lmngsQ|Cef?Cf5B@pvpQdsN2s zlKs@RpHg8e?7i31WKN785C8W#VnVGnNfzau0PlZq8@7`PwnfR8g~`4>`fEj-J-$p} zJuc$*y}xhfiV+nLLgxmVky?*`K6y0WA6F0hESKE9uBk7xi33`a8kV8i?&mg96-h&# z|6B%}(hBCMiX*-W=iC`|?=q!_3k8l@Mms(v$L5XIA!&r?Z9PAXKsFz-x5+_75Ajx= zbFz-hUi;UEKls+(FWRtVX=jH$9!OwiwW#OzJ$C<D!83n9`HL0%mgQ(_G5n|*isKbz zSe;^W5s#OzlB|@Kf67A#c#V8S6LEcQ7AmG%5y;NwS(~mG!s%{e$noQ8Emt7KC^+MX zVm9#9KIo5h(@{qXn#gQ%Y&SIzr8rCKZn`5|er6i&AmT6++fK;hjG0~!C{}HF%+!^X zV`tX5M2Zors;%k+E4G_o6O6LJK6QgT;=PCc`?H?o^K?2h(^&|oZ*D#MQU^NrP4y{= z@$#$}F$y{yYSG1?4@_9|!~pmT-S^4%<@lo!%h|G1e7pYq3d4c*x$6iTn~t}r01fOm zTrc2Khx!COVA7Q-03z1QmSynhoa&-99L0ZIFEK8Dzn^H_5hY5ptM+6-H6~o6C_*_4 z{9HZK|M>v3GnqbPX4H-YvmCHn7mEFveB68vkQ%o}otX=wKGCk?pIhkSwR|GxXNAk_ zsR_I@uJ?1Re$H4l_@`*q*2B#&uFJI5Kvvh*dO6|bjS)M*=-ao8_c`5F{af+lBg}Yr z`R!5=^l+3_7zBd%=)mjtJs8?>?RUWCrSJ2PiMGS(+V~Lzpv#}7DD<H|G*>=J#0D|> z#zwIRKS$E%3`3fQ6-534aJ^RVUNY5kSVZ^xf!TH^voKxS^OFVK0V72r5*n20=;#Mm z`aj@|{~03^1wSJ_jhZBmNyL}wc*I1rJzNK$d=`^#SCBbKBF@xA?bcT3Xg8aupDjW3 zyf6F(z}&~+oyL4Rg+pHr)e}y_X(;=;P^Wz(B>Zrzmh0mP5ARtq={{4vPg5VsljhG^ zpD?BIM`Z2;9EbmajS&?}yQUgk)&yPbK6Dy>Giww`t-PrlK9XADLuSsnmVOe*>94lN zQSD+;)~WhoHT=NUi3C;RsQ)GMyT?h&`;2)T439Ckeu#9+VSC&Y-o_A`$(kq0%T?IP z(KO+aC@ts<Rle;m<@BiA5HzXh2`~})0i7vdI?1P09%z(<4l-~DjYOh=RmBj(KT=X$ zK}vItH94Eez2^!>>@jMv-55G%Z3PS>l7>$83aC=?xX;W<;Jh0Ct%45TCKgt(Mf!Jb z%H$yUlkZiAt?(m{7#vaZtP24KjbTwLR(dfH!4aXzLzzU1shBRCaXkX#(UPex`%@?` zA3|{q$|BPcCrhsOM`%OZLmmT>f82N%I=YrPlVA`;in6RQ&X)Zf;v#K7#^t}Y9}&%H zs~#><8mrl%MJ0i~YyqK#Z(e;$9jHvYu1-n%m>fxu(N)IQS+l@vd{d(|T-l16Nx<%_ zNhz6}pDH)bEX_Rw9j?Xe-U*e*U&ZE8yWYY~Rl$P;Ejm4BzW$D!4^u^3UrWV)CRr%P zIQ1pzIhPOdzq<~gev(~59jgISmt+0`60L-DuaN&o#+L#Yxn6EEU*{(lUZqk;5z&5q z(!pLy!job^>(?q4SlI|;{8EMpribZW2$wPV-K+}nP#PfTOQq}&;!JG@@i@2k<1J$* z*s=m`B-r`)n!h%%rHI134|^)rUaXV#0Uuq^XJ^LGiE8Pj(M1XBvb3XawAGUpur;=l z*XvUC^k04ld;L%nxcoKkcc*1FpZOhJ$`}G-8AG(aKRX8=UQ&fZd~$hE<w+``AP^dV zW(%B&I{(?5q5;J=n*SpO00m!mC$CynJ3q))&a3L2;F)aq2{>Fp^o}4|yz|G|aX}}M zo{gjr>TMFFSHT<^(EmGQk!}NXH(Eiiq7jd+<Izb_ADv$wYa7WbS=V3S?7|FfQu8=a z7!voT$L#~q=UjMol$Z;uJx*!=BmG*A2^2j+GJ>v9>ybrmcXVtF=;-9+mu;&=URuq* zXt#>tv*g7$$TnX0(AY}QkZJhSd{1aO$`s9Cp=c44Qer>`LLP%iaTR}Ls3f<%3{$Bj zi%<W7fUmBC8MRlCzzc#$e`%gqn0Ka@W5_vqI!S0u`TBO0LEs#!0(jDjECJO~59`;% zV&Y6m4Napt>WYs;r{@2aV))*ckZX|+nI$hm0|tR{!ylV+_TR4)Q^G~Xl*6XU!C0)u zJChY<Zf`4;o+Ocw_H$@aQEK?dAQYfc>I;odVeGMM>=hy|8MK4$0+B|3^Vw`&n$@yb z(0T1#W2TK-!NQ2u+fw#;eO_3H>zb$Dw&S=-WEsJNG?Nm<o(_Iuh2LV7JTuAgo9~?+ zS_rMhK}lKJFW$6i+GH`$?mSmvy7Km2P$!IJO5cu;eu_*sLB{gvMFss@wN|<M=O60B zGL<~J?N*P6Tk8nHKi)<+d2S1p0uBm4wSOTxLBs}Y*rVt?ukUF^eiQEAb@aCM=lJ6! z?<(s~S<>x5N=QhUDc+b($ZF%zYlRt<#4MkYg-petI5}jUVj=qhB-xNTS;Q`W>*u3F z{ntCJy$lD(%YBM#TE%bnL~&EFa?>wo(xIbbx(*-MDObnyqz$rS*C~|K#DiR*dIIlt z>%Jlx(pDrPpC#0eMf^(6NtRJ5HWLxPk$;=)X&Yelfdp+`)!lMMr=A`%`ZudyBPNpG zmc=%c*W$ifX0Xx?6>pyAXE;gkj+Irr7Ntb8T`FIPEL-J+5Imwn8a7(AuZKO=wZ4=^ zNwM?*^zP6Ui_l%+1;eL_#C^+E=s1KuZ8#(PAXl-=5pEix>mWs$d>`7BVzFDh>M#6v z{n14;5`48N)N3CHP)0A$koMdyrOBQNOgzKh+=q5@!e3ONR}h%TKZ>-=Vao&#jz;8X zsBkS(m;RQ(73zni34KZkk&f&)`A0vDvF^lQi<f2^I{C+noTgoE4j)9?)nY6^ua<Zz zy53o1chNG-tvg!(_I{Xs*I=AlIAfji!Nq;!?ip$Ez4z3cIQ)?NAmwKLym^1RerEt= za`$k1`PB`bw_Z8|%5|n%_8m5BB^DHLVyp2oO;)P)oK$*h;jIjZ)hE8OpQdX-B6REr z>^pVXl4|U^5k`!3@Je@-s)C4Za);a1!@P$WUT$Jqm>CH(Nf-a11m_PWAU<72TmQW> z50Ga?dB=9ElfsJ$MdO74;U>gqcOdPd>Fn87>7{Qu=iyt8;N`O`#>I^{V^_c|^074q zQ)1hio;E%{FEL)6#qn<a4Iu)aV-j_7*Os(rd0cqK>}4S~U^zO;tRk3;d|It@<6)=o zJYFI$C500hNnec5ovcwn50UBRXjRtV)i=KiXGG4Ib}Z}`CF)g3X}E0Ys)T&DfJlG$ z+negX?RzEf7R_%KBKxRVOs=`m{Lt9dFnrpS=#=#yN~XkgHz}fo6y1v%rE=EHFo-~J za;~4R+si7NC#U`*raGxu;1$~MzC#%fx81Lg1GDu7O$oSi^Qg(vH@2-d?5VB+f3>|| zyr??#6__;i8`{!&gLNu$GQQLoVVW@G_Jqn|4Obd4L^lU8F+b#(TpFyq&7W^V9yq1i z2OGe%g?SAER6@cwDJ}s(@#c7ZgKjTDkBgPJsZfr^Pn7ZHf{iPxM$OH@B+3YnCho_s zOrZ!1&$Fvx{);<t2ywZmL)d;6+nhozGFYn#6);l!Q*k<qxg)aZ0XnK!-@UE;F`B;j z_V*12%<yKeq*iE+JeyC4_VybKBDglwdWTN;RlhVrB#}qRAAG$QNS)`fVm2;i(;Dm3 zc@~PVvd+_)8dzdmx{^l}$>w;eK<?IFxncU-t$59v-DcsFbLf3{xI>hD)p(-rFIfnK zUM08mRquxfq}2Fq04)2r`sz#!dj1p9S^8@ITc)M5iN5Q1T`rEMVG_1RbP|zFb#RXI z1j@2kZPo1Chw`1naXA*n2>L<RFKI5I=ub76k;hn?zK${Q$U5GClCOFn%MohH|L*^Z zk1S9dww$#TTRKY6h=|zRhjn!Ej;i6(z3jfZf3$rsa;=6{RxN8yI$k)KK!6wdT6)Ng zD9J7uR;P?&b6M>Sd`7N5ZZEy9h610vUSw$dEk)w3>6mm~Q<;89SXiVAF1y~@Xuj{_ z{QIbWEP7=nt|l4US1Yrbqo9b(5N?%AK}00i!5^xqFo*z6YDH3EkF7vPiI-b223!s+ zSVxc?NClrqq0Fgjf07OB!)NbP2|jezsBWsJy-Jrq$bEJ0b$CDM@btexYYD@W2mDSm zTcFdJp1G2Sdz{2CU@bXBb9c;UtNczQwtCL~vPdz&nJO;dqOmudmaqe3#SP4i36^v* zdfl>LSyf3telHA(a7^MJv&NmuKUye%((THPI$tnU>`*=IW1w4TN)wRlOoRx%o3x?3 zw00WztHm4>cNc#~F1z89gL5r$r+2zfN;}jSkRv0q$geJ&?y0V5Dt8Jn7>$CtlS+tW zr~#q3i1EJJF1EUxmz$e3NM8zru?K3QUwW)Xf7Q%9iIg1^ASseUZ`o=R02z-)LQoM| zlQ|jpvTzei#0|UuU|PBc39OP6<acpgu^*)_D+cXaieXOj{pY&VBShhLe`jAx`PG3% zd~WP0D5T_RA@D3T6=3flTBI`d`k!?Mx+i=d$1&812Yo}EqxX>S?&!PkiG2@NU^m3U zG3{1<60uVEPCp6*k;r(nl3=^T?EG1c7^xp9x+?l0GCgzZd`6gJ(9r|EJ*99CLQikG z4><b<lxer{wpP=(myo8|D<?%-XfZJWfw8P_v33;{nX*T^V)J6Xs7|Qz{C>Yp0@jmI z0@v^Kw_N>6SR<dZR11E&1+s1An$uNyeihpn<q<0j8YJVK9-@87Jm0+K-s)lq-k?34 zbm@*L8DS&7JUKmu{6PP0Z<7DwSM4LVh*gm@qv-hgSe`n2)c8^xi3x+3pp>>#HH^7_ zh2)ErROFy39pj*C-5qk2bj1n*cG2jFULh7^-gj6<l}avLM3FjWm>+GI9ExaCdyHU9 z4%kgEjj^AeB#NH2>58{Ij?vJhY>3Kik(+<zTxn1>fb}L%<;CO6TwGM)Ozyd{e5<RC zO3c?2HS$#Z;v*@IC4)_&`WlpN$j&N?6Q5p~W$B^(=_v~^&ev#oYpvB;MHNKaHsq&9 z70A9nE&P>pA%73Dc)B#)e94qkBq;~*R<)+wtZQD3=cF0JawpO3q;G4K5Cwmp)P)C# zZWgeX`NclsHnjRzGq+N`0lWfhj<X@!#<vJHb&@TtjqjR;6q77}>kGzZksrQR&JiL1 z=6o%dQ$qd~3k{~cbnW*)H07aGhaaf^i(g^&HR{pk0jZE&4^fd0GMecX=rmmee$S7V zn-<?OqpLF#iioLIHdB}eO2&kgfXX!OxkbN)$O6}G!VY99K)CAzDl&BVK5h9oa<yd> zg#D+_XcGNy_-@BpC0}ag;a$tF?gTEZKE2Keie11uZItGqv)}(&u6h2GE9j@`qf|Oy zaH9H%8^zlu9X+{vivUDN$D-WykTLhD5RChGEFpA8>DBymXDp#EhMYNFY+#BDK?j_! zQ%}ag8%OHu=L^i`{#jhhCBr3Z@?aM^j)q;82uP-5?)gmkQ_6DoL?@d_*l<6K*k33Q zetT7(o3ddSg!dw2{p#2VFK4cZsS#>K=gqZt@2Ex?&?N4LG24Md=u_^t$sbG)5lkpS z1|4=l6RJW&&NG~ERkCcj#9UEEU;(b0!3v|-O=!HQif&}}$;&(9xS*)i3ft^B4BYa% zc0|<5rcxPDABCRTEQLm|)&>-bf4WRH7&K-3Cmpa5Be%r-HhMc?1mY*@=#vYONz+vT zx1aLi2n@5?z*Bg?C8}^L{7et?hhBv52Fq8RBjry=o4um11&m^>eDs6Pgd!fKc@S_S zNcsB=Nhk(d7sveWhsV<`ZKirA*cOyVr+yc^PhfktUvY*OeYm}cIWK0w@f7Kqz5`vb z{eM_;v;8ZVsgT<)>L5kj;3r8*K<hHALN}Ih|A*Z)WoZ-<<h1*s5P@SUt_E9KrRyQK zTu`iAUf*h?-)MG30BSu(pEqmk6`XSQ0}_mf3{>MjW?%wtLuNYZVW<db>z<tOv{c+1 zF9SMR!?rcvFulv&&U(lhkZkO)=Se`88!J2TZ5jt5fDd~-?m?HXXg_yy^?Kw80j$qA zum38vmEQI=Zr<>1kh>t?u*Sk?;p5m!IYy;fIcnbL9h4qbeV>4XC4Mvr_*G-Y-f*<h zVjE-2N}s6VI4P+CXT%s;?ETO9aYX5=lEoS#$$_+psVg9OmG2*#M-ANNqmv4reF|a5 zssO7y$ajvpG}LuGy`TF^OJVQrkDz)lbFtBc1iQ{oPvLWOy7!L)p^S05G;j|M-<D<i z{3VlL5cRwee7T_0;x!eCkif@;{U(Rcrj{zsLeFZp@-0Gv49L{x3d7*YJz(@ZSHGT& z%uk(j>m*X?WcJFjiztR1UmW=<m-Uc|zUu_0QYu^$9?TgVDMP1ukAm;4B>8$x|Jtz= z0dViMYJ)#utQ0CV6Efk2r~s=B7qy8c8*#o2n>8C8ra0=VBjEGYHysEEKEKX%^oBx? zowHVfRNM&NFHM<)qe_1NT#a7FVk!*7JW2>{%Jp#sbv42O2v(i{)6vft3yk(Yn`24L zxoeK`yR3%igYp*dxvfxHOxqN*RHe+*^K+rFY_ZEqe;d-eVG12)Tt07b0&eEQkzKof zHndXZa+K#Hl;haQ$bY?aL*f;5u$gji^~09{HrJEnu0gueK>smmhWSFv^WWy3V{d_( zx}V0%kGVJl$M|0Cgjyt`v@l3Cf=PP&&JUM+Dm9BovR=0`9gH-!ERJE1%f`mHayz#T zvN7JIzT^tAn@pcsEb29=Btv?KhMwM}NDTDu2AXNLR1pZ*hV62bxpoqft;Z!><UplW zfyzH5aD=FuDuP&@hWf|5WdtjmgQO24MGG;M#&Y3PMb-Q!Ut8q28g#T8&LFuP7ru)j z5rK@qNEvF%!*<od{^AgJG<E6CN3qJlBt)Bd8AA{WK+kmsu)b-KfucHPkaxPF2+gn0 zD71QdzRVs$h`>NnNk#+rv`O_N@|`QQg3ixXq`#@pg1OHuz}@<55AWfc@V)OPJdNuR zPkgXXXZ2>?7zdzi?$6mw>cl&b2GuZgL`YOtsF94oZK;}yUrv#kL!V@G5$25s&Ny+m z94dG<ATr_zC-LwXEO$nozU;5b7QWf$B&wyqD`8UN%nq)3cSpBy8_ZpwcRG$AuEv@~ zKwNPb03w%;{@&K1Z9F$Qu2&yjcYqPQk%Q5?96g-`-V6JVA7r|Q#*U6?!90Z2hi}Xh zMQU~0+8>8?t1dR4Rwv_%YdXSiE0Vc{IG&5*H9Z`k4i!4y#bILOg-t3$lWf!=v}WrY z5${QeU=K_1>1CoK$~7z}-SEAVSS2~$pNbwMf6k3D(A>!S)Z(;YEFNMZWt7E#Gr<9d zw1j_XT?%%a+d~0|FDng$*YDzCWmjWpG}D1rhmai0;-zIJfo6O$SWqBmzd-<OnL%WL z>lah8JX^#*ZLMcly10qIsFSz(<(JA1S%JY(UaiAvfA^O=rF*WfKdb*{dvdy;ULl6h zU<J+9y{Pza7Rem2g|MWRNv>b7_oJ5ii@tl(gi>>%7ck1+b-hu%PFSR{|4_Eom}-W< zHI1}=`q_4F8buVC6V0h~q0Xu8#<?%uKgNLYK?5`sukb@&emMt*^k#7}9ZR=4Y*{dm zfS~b6e)5iwMu`@jS#bFQeCXve=$ZI&`_iB5nkN;iePgXgog<w!;CYDVP@m`f3c=sF zn54)IegJVRKnd0R;@1yDhBt*0PRw7vv0TrZqdAo|kTBf~RK8?kiX(4@^VSP7k}CA; zv$Iv6&&w8*vWdmUaBdF!#juFz?tfr1Z)lq*-0VMh3vz`u_AdFXJ&}WK95avWHyzaJ zi{pxtNp+u?>;2^rO!jc{z&bxNQZFC!k~Bs)ukqgdqh#9m%X3{WHUu|&>5tZN5lp3s ze#c)mf+Jf+)lfgyNfvPLr03a{+sf4Tmr<N?)vRQD(3eq6ydz;kw||Zq#kjsevs`-7 zJsS+n(Y|iZ(s9|q`#f?nPDPJJAMd7!q0yc~rASgq<mL0!+0xQ;^BS>;dpMDx$JDBl ze9S7BKzA5G>cb4yn<PH@#rjEqw_yH!GJ92dy;Ug-MMamh_mLb2e@bt2TVT-h(4;E| zcKT8BC<}3hJoVSQiQES@O-Ae>DFfPLy+t}15K&lK@DY_$m2pje8QTwDk<xlTk&u7V zVA8A9-urZL0OoN5!Zu{K!*2B9gFAjGLfOYE-UP~sa|0N<a@`BvB;=sN`W$u1OvXkw z{uKD$3Z7_Jr=t3HpdSVySsL9@J`bNBL4O>UtfCqn6NQ2Z3?q_4hj8gH6~ZB}JeC>K zD_uq!!YT!<-4LyHy~eT#zYSP{^j&WYP4S!&TTNDN`oN?3-}vGQ3Uv|q+$sm3<nb;9 zST?NLwhx#jKq~PtFUTgnt9Ed`#&n)b-YYC1Xa{<bk^AC4Ku_hlujc}vlY`mUEzW}7 zkwQg!wdq-22tSr(cDnW(9ojr6y>Z!Ksrx)Ek-TL8VH&C5T}~Z;Qwyq=*)1B=pQ#yg ze=sC0gm?N^`aMVEXT`_TY)HHF^!>hkAJ>vPR*N#(i>nZ6784Vw{P*oT=-M_w325GA zM}b(Wc@CFKdYN(3x(}l!ff{fBrX@2<ztHt(r&g7j7@4KeEJLoJ3A}^SONgxo44H1+ ztlF?~4wX@+k#o8Lk8|w=qCgZ=$7i*ZYNJ*Xj9J})2`JL#bCQ%Qc}8U@#ikPkm2yxt zah20hYE?y)xU47M_UG}lKgRnvn^rP8@BW&Y3U|sMs<=6|+QTgg(R8r$Wuf5p;A$@q zdSHR6?}izeVgf%dLqmCbMaxIr34?gA(xP~Oxa;ms^{IFj9K>PsEPPqfBr|!Dx9ib7 z2_62p*NKWRrJl#8p)RvXHS8gd8%VPFqaE>AkqyP4OS1*VA^*#hsc+D&=bK9EvMDEZ z(w0pXTmdHgC_sZ@n1#9dpBv@&DM_6ix))W&D=}HZPZ=l6NkSXNJ|s$($(MVJ%~U?t z{j5=&kaGcoRfdXK!wF>m^w-POary4Sy-_?RzcR58A1JUfYZXq<u$ds}UZq;OTkD?M zG<;0+LvMQpQimc}v9a2@#A*e6raO{MPR4DjP|a}mPyOWO)86&vN3iFiK{&4ALF{e> z)3l%HX;$)?$RTdmp`$tLpr>{x_jIr)S8{h0ZH?I5w(<C$FN#2t|F7d%Gk;~IWz@o7 zJiuq1G+c8H)DX8YSY}<--nxA{?y@<CZ!mCLKzS9}6n_ar^KW%15PZ-%8@jY=ZEo@} zd*lz4=DS0f+>-LT|CUZG#DPI&gnUxt<}dy0+H*zlP@6U2Urqk#MJ{k4yLnhpG9Bnr zKNtOh4VF{}21dOArWVpfbwZu$MHDekKArY|ORPQ>d>DC$ArtG#R-BeK*PDi)KW<zZ zk4{k|$}9fHLm_EoJ6bQ<-S8+Ljg!4~uaDII0kZby-6gfH)!*{Ezl-tV$_-k`rMfUS zr{e4hK3gZ@2!=K+TjtNSa^edr!=V*5j$+szKZ+6*{3qtz{-QR%nZ)~cZE8G+1S*Z~ zRu(yO;$T(Bj^(wSUAvf?f~<AhRlz^Vs|>Ru@|BAj0EbKk!GP6<>BS0Sw0N%)@n^l1 z_rF6S@WG=15Ve3-C)LHdt;+t25;73tXP1(F*9{ZjX7&_GCdoT%(M4UK#izQTrIx;a zVI}u58#6-PavkB$`{ip>GkO@RGUS>FK)8{h8!M>y`lps;=uYd<K1kzykkX1zqw*iF zeb}Qw3nfAl27XHLnHUcOnGAAW2MZPuvUrQvemUUZ+Rqsh6**D!Odx@>_)zy3D)CsN z{`}v$mWqYs&+JbdT1%LR%I)EBetdqO4hD^zJnl`2Zkm>cwVl6847g6EWFLL#8t+J8 zFwIC6hyHB(czqb4+Sqm;f(n3+;Kc0oX2c<K_G_di=~8UYq3ZhPI)!f)&5DEd^*aZl z$DrAvx4iN}e(jX_jSUGr{!TslX#K~@s}H%a8|e{Oe~u;&*1Fp+Xclwn?@PzJy8Ict zP<ztE-i#7+rj5BWCMISsF5Z0`+@AL3j9zoLA@ng9gWuaxk`zC~HM)Q52|tMiJ+9wB z<j-*4Cx4R1gxc}?w^{}H`;DDY#oVeRQ2^ID#H!%9J1`UJhz?>JVBqeoTwFN)wan#c zwNuPoCLg{#7yja^N0BY}i-FtCF~l=s`b<)l*2-%iJ`q3_5@f1$+m{r@4tZ&nj3`IO zwfeN5hJ`<Oe}F6XsB<6chn+3KD}tSH_IZwYs8TpuOZ0CHF2ti(K(Y@cOYz<1)T9Fi zpb8mIn(7>7(Bx+#5hlBo3%6yJ(4%}{;lToXhO3zbi<6XCA<++?E*IT#@a)yogPa6# z8u5#~psW~?jt=rywV6JPZI}AViqKKPRG(s^YiNmVLx^HLbm&kKs$zNat-zR!qLsi+ z2$&6%%=<?R-7c47=bPu?=;_*f$tV<y{ANQ)^qYEm(K7(qF^z6zJJ=M+<C$yGmSm;6 z2!^H8p|~^;%$OhBE!23r+H@~s;zJ!m!@k5#?rN~#<aGIx{aM^J+vvK#pD3U~FRZGV z_G6y=-ShG)BUxH6yO#15%3`<pT!FTI03WizF%>B140Ht8kOuEtNbC2reMA+D_Z}tI zAuXe<D8^LFSqR6PoS}{$rCx09X)!PLTuE7WNk1d19sQ<yGMN6IP1K@4DAv$G-TTsr zx-q2j=B2TW&A$K%%$j2}A8j$Vk`L%;l2Y(#Y*k-$+@Wsz>k%_g-lQdujLg!UX?LGo z<)EjEe{{x$KoHQMAFj#a+qK|e5`S6Nia8Oz>hyW0Rm~+sI$Asrd!6y|l0VDjA*}0~ z;{Ku!#>V1&-6P1_!w_dE^dahFx;C?3;B$MA1OfsTK*P-Y^n#MF?X7~^JHkLUZ2>$@ z$w{96=v0OiiOxITP5OC^yg(1?jrfKwhIq|O6#_sgl5zwFj|Wv>9n6hJT~{Ez(}?*d z(6_iHLM%=)UaQPohxW%FsFl~==RxNfZ%mgxns)+nR31ERv$van4;2|0nn>}wU5#iW z%rJooMf6F(x(_4QP+Z6n9~i}y_xu8Y(QMNoG<Ec6S^Z&LD|G|7@a<qyC)K_L$?v+E zA~`7fzg~!9cr?+g<wMl)KnPY)x?F7o`v3q2WF$n@<wU&t#%21yMJY$74e~*4Au)AP zqJ+?JGO+Q8UR(@7oa<^;<2uKEDVHy?HE>wwHrC$KAU5Pad+thHRXN3~>F9H7Ym}&> zPP?-%^Z{(&5}CB7AFnW{Dl`Q6fd%vK%9@5a`kgh-_21=@FT!PbX$>C<`g?IMAfwn^ z4Wz)=fj?b+78n(H4CFol5Hvy90XmMe{V9P63;}snk}vxzC=<)Z5{eN4EQ*5#L^*XG z2x0H2nB0_E&Ma&U*t{V$xTII3sY)CUUPr8CnL^yrfV5(u5h@s!03PqE1Yzu(`h&Uk z3x+0@h)kdPj$mfXt(xAujHZkwvioV|nptDt7}Z)=uy<8Jx&tO;V5hlDgY6*PHh=WM z{B4%#_%+U!MF<?C4b^w9&1YUct%Z;fBjtFjtt1j3(qA4#_8=o|uq{C<*tRp$)$smL z!Too1RjgKVX57v^fs`CPck<6Qh`rSpt2obqLUo`4Z*j<hAaE4_m(n@+@f3-yHVOx! zk(>sm$^f+eK}$rM%LEV^rG%kf1K37kKx2==DTKy;NHAHhTUOfw=r_C{6`+D_ACoXI zS^duPl{BMLN-A46pZ0ma2srPCXir1u9cv#e!8+l5$ihS3>$pyl=c{#@9E_M=zghdo zs3ZN;C}~?xMCyxF=7E2PtqXU64J^1z2^9h<TQiA?cuZUR<`BVL^lpAg{89<r4OowX zCO277L0-n^J|>A+foJQDC9wyiCIH$$!SjLqt5>C%oKf5W=0650U2!;uS?8Q(*nM@> zUncZZmmtDM*x6VT+Lrsj_8YoyNyPhI@J^c$-B$IV(Zb}Z0JG5wb9IY{WYt6PYzH5& zOWsEf-g9DNl`C-K7Y4Z$s$C6K!OTxQEE`?qto1#bl1?{pK0v|PcGMu%I2QEDd?JOV zx+K^U_)mw;2y2|OZZms^Cw-ul5pEHBVIbsMks%zB!|86U`XPdf<n>^I=8bgObd$1} zxlsty${<RGK-W-wal#IDf|o^+cl5KT*t+W4OYydQ7x<TFTW=aoOgTm?_(M5=F&nU6 zV{6~NF4iDqMM4=tlfUJX_8~m=8a0lm5Vxf{5h2u7QTyEVOb1S690ib@)A7TsxVVT3 z@}FL{%;Q3pB*m0X+L4@#Ymo`hjL}blDFShS7?}CI8%oiQjb&pKJ2M~o(9Ix|Po5pJ z;S4wtDXG{79A$}fegx!A+{X5@zO<iwoiVi{)n-In#66S20wY~We1;jmOHMeaNvBj% zS-Z!-45x&B>_2Ne+^Z+waydyQq-Gp*;mO3hFCGIBWPU(W{mOP_(@0+7cc%Cn2OWeE zooigCXbE!h;v0SB(E_(l)4NcdLV}g+!9Aea&tpIKOKb#tTfpl9{~e;#Gvsvu?gV(f zHgazUt$#n=WS+0E;GIJIE<=~47!1`uwqx^u655PD5OBUqVSqmi{M)qqOpKk<<)m`c z|HQCs9wM&xR+Me6CAs<B-84!uJ>7Y1U_iE>z)<0KN0>-)0O1FySR56b>a{ReRQc<z z%^o7-c2>^+A5adZr+AhVWJnNA9{(Mh!;*Vn-RzYNc@c&UX(4!W!PwmOJmd?uTT3K0 z1q6M_Tme;#bmle-1q~^e|0C%f!y<p*Ha^+5ZQFL6ZEV_VYqK$Nv%T52ZJV3zHk;4< z{?BprYC3w+%>BLR!g+p9=t*-nZq;Z<qim<1dlZg6E|OJk@lt2|el$-e#4>k9^xn~K zHFG_;^3MSOoD>Z&(Al(dx1uyROBNK?iKaosc6x8G6%ZESB0m;q+3X=>Ix-j)vX564 zNAdNSK8Nis&nJe8)3TTAEwWP5mDC&Lp-rHBs7BysFoU6|oRv!GOATake)+@x4t^jr z)$jn`lc81vE3pQ;=E1sej=u1XZ+>99O44^HoF%9mHgwhpS{2Ym6w|in&swJ{b=cUK zJ$srJ^H{c<6|3DQC)8m2t~?q{I5V;MgpewFyR1d}q?c25=rvbZ{K;t?jD3lEnS4s; zQF{ojI1P@MqhyC0D0L_R??Pn13^S&-Hcyo1wvOw>Nl&F<q2IR3ryE@43NZV#PnS{n z!>QB@*`Vs(O;@YT%u5r(YlJ>8^77x$^Q)f{Cs4zDSK}6x&Vmt+w?A`6j7^cZ&63b( zZlqGXXG$gEkZ@l<o($V;N3guz4B6gpGI`mSIS*NZpBil~HL(`c8`|ft$F560r4$qe zpr4-WzJJ}$M8N1A1Ha=-334wrLWtIv7~eqY;GALW%jd=VsScF?UisJ?I@L{&nkI<m zgvr0OfARRTy~Sf{3<D51>=DrMjhk&R7kCQC-fn?>`R)fap78{K8NI~J=UO-UOe8f^ zy68BBHKNNa+j+e~xF25M_HSAIrb88omCCUs90l|f%u4^hj0}@`yGrYCt5(P6^pXP} zPE)&i&}z^(Q(*}-IdlC;Doga4E~}>+3tgsQ1gc+51okr<01*CeW!T^wvAR*|&d6MJ zFTylQjiDv1?CfTlY|Mf3ROypgXbjArN{L-Hm8w5X=*{SD!zk@<Pn$1_Ziv4{TWW(K zg9E*$sX~3M?+p<>dHDC52i=9~(zR}C)eGyPTcdj#-01*T^|EQNS2B>py&*=zy7`D1 z3&U7$l7m%)A7io5oDG$12YTEtVm5$b{6Ok9JL8;2G#3vV=To1QTs}hL+E5cZwj1@5 z0~$4b81le@)Pft5D5{Q==X>|I;00b*8zL|%kA&@R4?ODzlDRm35wf$XQtlH@{fw=b zkM~B1+GjABw##`vr@VcSf9r_JpG??*jn0e=<?_n5eob1C_kPI+y3^^kTl+3-1tinH z;TRBq&6L6>!30Y;OLLC0VOzV(<51FbT>Cp69B24vS&vFtdBR=T2^Oe%f4Sj%5{mM) z?J^`P(*tJW)Jp#&s!>pr8!k-qUWt$y;`t)y9)8&8OsB}(VxHdHOFo-f7ciOcex?%w zXz{g4myOe&UcuhhuOV#x1?I%+S+!P<u-|N>0y-6PbpJaQ(U&YwR)L*Q*#i`8n4l*d z-R%9~Mt&v&^j-5n)wVCfQ0ehaOT)BMOA4SYPs|k4p6*wqby$CKqRjAtGnOBbR0<`4 z)U9)G$Stg4SkH)dW1?HYz%owkMco5ZH;|J4UMyFL)dU%4x%IuyuSGe3hLO@M@KztX zGgmoZ68W_a1`NzhkJ3Z6hGp|VE`al{wYv_YX77LMf*=w>LGtFC>rgIoiI>C3DPXXb z7omwT{+TeObmpKS0|1NfuLQO&jH42CLc`HMRr^wiFJYvePGf7BIFhD8ccQDCXJ;vZ zQy?rVIv{amq9HZyIWU(-QwVP(7tbaSv^YfGndR`5O4SOMV=o?Ibg(x+aQeJ=#L)=q z9<TW*j_$!B(suw8d_I5~%30aIRR?Gkf+1gYJH{TVAWu_cM4L+O3Qk+#923_4?B(+J z+5&E?UYP=QiYIkhNko~F=!k_d-~VMdZeXOS?K#mc+y2e9^|nc;qY^pFC5iJSzVkh5 zfZjkQyt53IOLwI`4HlkV6`ozvVylX<mT8f;+L$&d=12`U|K9NZ4o={9=2kf)d%vR^ z2inGQy0ua^peggN%Uh(~{Yu8&{!8`(iwb}zfR=QW<K~t1+?B!p@9#<4a~C(xlXe?y z<W*J&icqclK((UnLzK?~7R0F=mw2Dzp@tZTQ|+R^krxOvDJ|`Hp-;2!bx%8G(EJSp zdwVXZ=<`l3@F>1VIQ?{fQN@&YWdgOu;KfVv!Q(vZcf+?vgBB1<N;L<?V`_a(Qh29e z2K3$$`<fo@EG$Ut@qqwOAXFG=?gc8sRMMRC=?S)0={l>WA5*D9h@a;)GW|}6=rX{8 zPI)OC?o%~~(Ee)JnrSn!-K-S<t&tjD6AZ{JU|&60etk|+QM^q6LXGID*~b|~GCAi# zn~t1_6gjE*g2QSts7;geXnBjZI)>;>eMQ;s3E$WuqO#{sv~Qi7GWo68f0zg(x#Gry z$Ad={WA5-6(~&}&`eU>>G^SL}n8U`}xHq)X`bI}bYe4K{SuzGMep`mff8euACPZ@@ zQi7@9+xo!_;ilbNEWkAWnS7#q)fN{<@9dm}hsUu~G#_YAR3AE0)BbUFHg?{IniJ3h zNOCEMAy`Y`^e_HBh{{!<i2}SNI0B^10lXn|rM@CK2Ptv4!hjw{aMD9x@L6Iaz#X2M zfhr|xYYd90rp3Aw*pJYDT#POFdU7zZW-7ATiBdf`D`tve0bN>n>%aAc0IUf&HAyCC z7Md|Ak)m@zacR{Ve3qN%?|wdBvk2;rn3B_S0ZTQo=Swg0RdTZX_>oT*aWc!sOg++a zi;F?)Jt>yyCwk#>DN~_rwpYuFV(jKqUW`5-{;k{9<bXCdL{c<n?Rx2|@|6Z|E)GjF zOoR4*T=ZQhD%-_M4-oF*g;(+KwB%o8n6<Zu_fiYZE>ST_SQywoUt?n39msCCanLqd zk~b!ML^H@KrrH7y?aujm)yF#r^nld`SxBW;*3*ocKTz4JCd-%J8N8%amOAa6o>muy z#>XoYSMe9KjG0drHTm?aV)cx!yz4Qa9Jcv**MR;S)Z!#4_@u(ERPp*!U5&$|;gLo) zI_=0T7)~HkP{b0`b~M-gNQlqdQNdh&5WG|`cQ|6#E!er<0Mu_a>5?-<LW-ez48<Q? zqDsGU>ext)<uon^WAddJ*Ms(piP*`b^D4QRRa~$gdxa_pGMoS2b~%AaS3h$qI`%ZO zj@^nSq|&7Ry0^hHqgP3#hlb!$Z5iGlgBF@#mEPW@3^Jjn6=#!2=iSQayINfS^Psev zr!&1rN?21IR(7@bLe^daYm2%uBmz?fy_Aq(vMD&J)yki%&ZxcF9n7L(JmkVY|H)oO z(GoEU%rzz)nMT6BSF%DGJj`vX@*FvvSXb;m_O6p$<MukYPA2%wZPl7-1R73p+b#Z5 zlj_v$4BosIB(+wPgrE%Bs*0zN1a&H)vBRp!v2GP(B5K1<z$r$a!|~=O@xdJ6iP$Jr z1S)jM8DeOjL@Cofbitk^1UZ}jLk;RUI@|8NT-)|CWGwq)Nj2!nKGS#-<fDDA*1QK* zwY0Vx$`ft&AAj#Sq~-0;7u1Q$b#EZIxgxXe-s+_vk~WsBNW7?PN)DR+gqF&VMwt5C zr}B?^6&lS75BqYk?;GE}OzWy5WefgXs`=)$JlKq7f(L?51w|F1A9c<tEc-)sci|MH zXM{A=6PD&JO;xsLc(x|o(H*D`4y%;3GZo$eO(DkVu{N~-#_ns%q8H3)NVQY$URz*y z-ED16`!Kiug7`T5Rv&c(T4Ex5og#bbI$INvflgGwzFPY?P0lqo)MrA+P*2Wz1loEf z+lYZQbN*iufo;p1p1l;d^x|89T?hPCOl;&2)wKJ)q;fLdWangkl}?nJ8)XUTxNlSd z)a%3rWJ{@%)tCx8c;HWZuw0cg?){wnxK$Krasa>RI`EpIy3aoDHI@868e4@}Fy$<L z<b4i8H+7Lu#r<HO&X9t1L|N(C&M8p=3es|jJ0bcFM=JRvvG@;Z1bN8i>@I;^ucQZN z&FKI_=s7<zB5o8$U_G51XP?>_7}E-hEqnD6*#a?dV>1{@;*J<%&bdcDx%0GzrkkB| zalrOtvi5sMIo+g{KFQ~pII-zDXcA9+g09!pdu&5S%xm=Lp9?>dNnz%2|1i%L5XZ}v zE$~-NEO*)H@nuZQ1*@Cu2xwoiEU?YwlP&X<%>NqAlw+8FzA_T4X*fX>97RM2ablQt zrk6si%m-4;JmsV+Std0L`#vWps6W8<odhHl#$_*+6&+iRCr*Q&wb$h$bnCV%V-f)! zza55x75~;2UQ;t{zh0*Q@(q&b2uZSSCu^L>EI~Si$@g!jdU#%Ctrv>vvL}rUTRSrd z=}JvW?r+OfQfr$QIEDL~dt+V;d_}C*B)+E9D@Dl&_E#CX^4n{a-(P?*{u=yO+Wh(S zhk+c=6e1vMK?Q6&yR5}?qK_m>Zo_t(u<6vL#Y;%~Tu?x=(?POYvkcwv!h8ryKl7W0 z^`}y~G{XpqRHDJeF=3$`>v%qbmCAhzzBV#QK|fDwueD4lL4l{Gg<mkwZd093tK z^)q-$gQ=w5mrL<PM6rJ(Hp~@R{C*7;Rq2G>+dC~6Z(E6SVn5-Ot5VJF`yR+<g)U8{ z(hhxPERLe1H-_jlnCQjiqXRjvrGVfX9tZB0GXJ1cibE@FeTEC5%8S(5bNXvJ4C{mR z*0DC&-{F5E2{93y)|m7JaA~rjzLg@r0<bc~=<Nb@w6N0%=c?MOWeWc$5JapK8Z1*< zj$ncj0xVrtoP8S^2uT-+k7dv3!OAA1#@j)mTuegQEVsCepoWPa$RKuq!Jn;XD%dx; zJn)1|mTStpaD3@UBWkb?1x|>5#KDw@jymE7my2J1?6sSO9$>&khkl1grossYIaEeZ zCR@lEUol?pRsC=4t@lf3RD0v~R<v9aR+pCGlZsyd@`b75z?0j1FY?Q6=r;?_rN&<L z=>?B8auO^R2pV@d!Z>5efx&(EGCLs^4<5$0<!)pHnph=|f)LoZ1z<?LAmI?RkO)LC z+v>Dp#fQ$Nw)pv;*so8IFLh<1kM=)2LR3p%ctF%bfuqT=)X`-*)_QrV7;!86@Wkb- zd7oGY-I%tPT=Ntd5KF3#zKT*Wj|eFnmMR}dE<6P~P=&|)Ob3hb&{~EzC*-KP%Q*Hg z3J|ncXQB&orpIuQGy>m?1_#YU!SBSV>OZyD(atm|?CwAd48hcJMm3OdEP?~@9_a2m zy_6-|65|H3d5&I(B8<uns#vS)-TP|X$y3PX?mgbEpehck{H=cTdY+^UiucsYvM_mZ ze#_><r4E>){oaf(*dGRYboXBgC4t@o^g6uTJ-*dbYaY*T^*TxSv1R;0QPBy#{Vvel z1-X;=wjHQ)7o|eMG$NR@KM4hBoSo=(+dQ$`LC`5B(5K+)u^N={4w9DOu~I96kIBq~ z>WHR?*=-|Ruhc_^MO2hRttC+I3!XNR{#y>GQg;EEr~mPXBgdm8<EL3sAWUyTqZ|Js zf~q_(Y*yVzrNJHU@s1sO(O^O@jwfu76n!yMxm!~auL>8<_w+b2tWMcfC0fA|9Nl`p zV^FXAFqFlf6C^rEDZaz1L<a>%<PJyXQ?{2z3@g`yXKIO{k`AB5EAA^!I+g^GB+nLw z+ac`z*YZhx*Jep8;O={jxLqaMAJbj>*O5OFnpJQ5J%Mc}UG<ytgzP@(QtC37+Uqv_ zsz1!$=6`%wXjkN#*ve>WBKp!L6R|v{!=o$Y*8qj0;Y3II>};2;d%IQ~WIZwblga)w z_WK`fMM5qgNEWl6r%UzgP-+$9_XOn;$xVh7F2djq_QZERx~TPUT8q7G;~dOSt=UNc z58@nL_Ef`MNwo{m*ZfLX*T=Q<3uvJ`q$+R^vLhvcjlvTNsTet1|0yMRf+O)`p7H4h z37S-sK`xBB(zq6%*c^T>!<!>eg>#aA3NqzKM)jk0nWWc?3%t4jG{|p^9P*iAL97$C z1BfBA){O77X9|iXdf9Hh@jq>cuq2Iwq4o9O^I$|n{O(3(`X~T#A>Vw-U4xBs<^rB2 z<1K0+tuJYfruiOh3FvzGl~bjQm%1=SO<rbP-Nl<@6dGJE16-MuQ>-#q=GfWaZxI2j zP8;Ruk^++UT8gXX)*XNq&7xgBjub%#6*}O`5Ay*w52Qd`b8M9OCh(ZCAlCd0wTzMP z!I0mMB*TvS=_+kj>rg2iNXu-K<#*nPY%fS4Wl!;gjnj<2h@F|IJODpx(7XKe`K*Wc zzfo>KQ0j^wU`(49^P$%lp?39xQM$Ow>3jJUoByDPxtc6aY<GKKl=NXS(=uop_tb*^ zEn@n{Zy<iAW(pIR4!#kb_yY#*8=e?1+!yRD4_Z#?H6;x0eg?fj_C(*Wju#Pi`R1P= z=ffxz-IqLm9EAqV5Fks9?YKL^xF~-Z9zI=Gb)}CUvo=Rz4yri98}?tzMDLu)?fdf< zBT$rDwg(BI;>35a-2FtZtxAUFIID<(gB*$&2qI@eIw{W;u#d&+{zs3HnF4)k=~BuD z{P+8y53mIRe;U+X^1nu@ZRs|%o27Jaag`;?&^sfhV@B45`-BaBXG=`CinU1DxNS@{ z%!m8b%XHu+osj(DYZ2|mE%5*P9hz8>jgF~{)GoyUjD)Nlq@wgfR$nhGo!=@^j@J8+ zi0CV~4$_LGbd^aPSKKBP$*SdZRL)l%E9(`&$b)P=GAK#V+=WvK4D8SFue+eCSo|TW zkX9^N;kQjn7pPLI1mPFGa%Zmrm=Y1Zzq3=)jjcqG2E~v8_9q`2IV!LqzK<0G4yrw6 z;5SF@vP&$n!Hhyw-J;+A>}J~U2!34<z1<{AU^|Em+ZoaA1?V@1*p6kPm(nOnXkn-) zCtQ~9D=lQG$~4Hj!F$)rmIf2s*A+y2!jB&&@MOKR3o1LIm!UZ<Ej1eWDX`ns-?AIb zrO<nyZ{T^6KRwpm`9L-G1)%n7yEs8tN;KS+d1<O%U}e4OLXi)d@cF4Mrs&l+dcwZT zkqBs)BLce<s_#F|*K=s*3Mjg1RNrvP#E-QGx*=*iEj*;S9RW<JTQ!>SH^-8jvHFVM z9UbEqH36IdTz4LVcNSe#PfES{2dP{jAP){)$gZI|!HHapY~YGq^5{7a3OW8jv*IBG zSHP0V^C~jUQli_iv*Zy>6GBzMVSt?oq!vE_@}1B|0|P=7PXTG4;m#h_zbLr?+2<oi zQTljk7Qcg7c6TzhnL2D%;S@29t!23F*0_&L*ZML!hCAU_W;qGC0c8i?x+uU*cd)oZ zaB;y@DBT%e-kr2;t!uDnYiePpym~EHC?Jmx88DFyK$%Xz&kS2>9*hYuU&eV@$80gu zEK-bK#J=e<V$A%$iBCWP5hu^0(TkP&e7|~ajg_*=N`oT2`5nu)VrH^+%Ck12Xl>C< zgsHNV)*I9oO)!tfsVL!YX-guO$ice3`LQ<bF|Gbc<!bMNbP!9lS63#af2vj_^7W%; zYmsM49P5_$xb8f3_V#-&Q#LkAtF5ZXSs`}LJ1i63!AI`K-I#v9p(m4^D=J`_JfT~4 z#?1qvzZn-$>T@&$)291y5R#Tp#t?}FG_dP<C?Qa?t;oyCD;Ay8PAuL%H0P*REI}(M ztuc)5UjUz2nNxigFn}%@2r7F}TwPOF)owE@zXesZU`?~G>2SF=MO0=GIYy5K`MQA{ z863I?zpu)OlniUt*|()Ycd`*6XC&8JHQnP~BzKvP%6(c|8t2;#OBJQ;Ymx_VdgOfR zC@vf9KsRR2-D=r%V%cG1$Ly_M{YX1atu?aB!sG9vd-uD8GIfj+X;3HmuoW!`^IcNY zeB?nx>VSY0!q5&tZ5iP#gv4duYd;E<I<=pW?vFGX*k6E(7s)HRL|0P68H!U2r9Rk? zu!gci56yM-l?H~VI~kD5|0uWq9SUPeMVc6beiX{4<qQG9^v<_gn?vTo8=obdb%J=D z4BIHso<IiUlmOd_T?f2Z4*EcgvYM>8l`(={8yGK{Bd1vq5SBAX+Bp>qf%Vn}b=lk> zfw7{~!%EU(l1bj9Q<cJQ%gU7|k<BuT0ZK!~f&CgGz!N&n4KTAPpoauCSh+QTRSjS0 z6g4;Lz-2uCEzxpS-rVKapbI-?I+x%`3Hz>as^&|~`d7YV#@UgbDJ%YNx~xhJJvSFY z&QNYavEtlbcd;TE*^hsLAJM-$4n@Fdu?QWuTBwnF5!o`Ws2KsE9fGi9C%mZW3&ME~ z-kwxsB8c+MOjro|9csOcFTM1@H%}PIimePG&sO$z*)hIsud|W6n7gKd?3$0sjsi0# zx(fcL3gKi}vcYOE$50J#BQ}eIeDxVqt)UfkwRax_ugJGs+V%rJg);i0atp>XjES>~ zK|)SC-rra3(|JQC34?K%L6US^y?uC#kPn8JItpr_z0S`9b_~`XNi9qJ&9fg`f&dW1 z41nuXcG8iVi%jQrkc<uhg@lRy@@YhSTrM+9md&9_ASH`>xjFOnaa;qdJ(?#3`if+t z>)FS{$R+jRK>TKpcgr_*l8mK6S!ra^8p6nTn9W)!6o{9F=$-iDl*9aQBtFhKi%2im zK=S+Ka&fnvQwA*MSjP-8SrabBeFfRe=MY960CEmlR|gtJ@uZm5d!FK8g_>jOa_$sM zVQ=6}eXl!j7LiYC4v3vuBs*pv;~E#WxRZRQf<%TAmlaB838NB18*ieTz$Ou+yFY*j z)QMBMj5QARr?GQN8Uw&9k4GU1d}WINjkXo-Zsx#$oKfTv01`5wbIJG8B$A!1m?dDT zZ-?3~(t{vCUPnH*%CJ}I&3>j--d^7<)$l>4?QRxHHT>^Bknm@?wVZJ2wx#yRT!{Zp zz#PzfRbjYPTaYDb3UtFh`nr@>n+(OvRCj1sS2Y3whh=z8zIgkIf-b{ak(pM!cX;uX zGY?dnYn`Vb<@9tJosRp)SucAGkQS2x*AL}bDXXkB5W{=8*IO(|;H`HVSPL{v!+gM> zEpE@N@4cb-_i)bt4*x~njLnr7&Q62vAJoB{flYx%eR?-X7YDKroyMmo!YoSb-6H~T z(dr`%<o-I%`Z)h475;+y2sV+hbz58lGFoh$KqKE~@wDm1=l7HSFQ;{)9=qf&my&Tl zOC`Ojj$PSiIu4pjNhPr3?12ysdem>2(d;=R(IM3X^F%hgNm-L)fKI%8clBUdy6!z% zU3@DnIPJuBpN!PZV2IwPHisYe<HTtu1Hprw!+`t7i`Adgc%|C)bnTR(hUt#c=0y9k zB}^?7iuWzuBNoy57S+Zh-^p3!=8pQ3evBpv<7iRYh5!Ber&~6IVob938p@64wB&AY zHRY;<5VBl&W|I%QrU#+Z@|*1?LckR+9;@97(tFi+V<W-gFiF+Ux@~fGQH(x+aK#@w zY~lfMss+8aeZ8uMPMAuF$ik|$ikR|94tipm4#;UKW_n6$D>io5_&f?WHfk%G{XY&M zu_L?p2|F25!|hql`s;*7kWuB)CK4unlwfZRb4Hv)9hK<vlEN0{0LPT@&M_?n;7Twl zTdW@Vbsg1Y0XJ(uS0MbBSO<9F-j{fL+tQ_|hG<-9eulJymTu-ThfuJF!jbQw91ltm zdBlAi6z#G3Aa-*ASNhDw%A~5t4o2>0W@d)QVP7gNQ(jbiR#}|SVeEIYS#yg+1zr2m zyp&0?S)9$UH-{MhCb(Xth^WN}f{c5D#@+Luu5{C$GC6Gb3kfN4y!%AH!)2)z@CP4X z{6ly!zjLjxxMIF4Nq^M;PvayGl3#Kd04eH*p)NI94krEGmLR08*XWLkwh!l&=O~XH zg{UUzHC@iq{K%uo;x+d4x@}*w2l8_?Zw(e&#)SbwbZsd)qoYv)&a%41vmK1DO$&uK z6LQANukA$wF{k?N6ekwRt<6_!-B<M|#~D#CnW(h*$yj@<e(IMDlxExefD70zGQ_f_ zh1;K>`1|LQ$_(Pknr2(jhne4ODwN0E(^zj_w*;?()F1ZK&^O2u#I5}GtF{@Aoby&5 zgpAJX@MekYXzOhLam4btw8ZuMFw;pU$QimLEnIqdsVyb2TX89S$Q2_cuKM74Duymj zDEj^($gGUO;>cn>vJakdwN&a6f?cWLkHL|Khnd!*%#MYvgOr065;xNidi+VB`4iK_ zP-KTP&(;txUJxdzgxdCj7v?ty2l=@k6)WY+@D$(Gqy_ylB$%8PM`8&1UW^$aEBso> z264_ky-<bQ8e*re6=B$8k&)Nj5IbtHF8!}3hIk<y3o9RsI_!=fG3>k@oTFLuDIj<P zGxIH*Md_6otA-RUPaYD|p|X}}SPV`)IDt(~6&n3^aZEwq@_YMe0g@mL?-QZ&oVowx z9^V*<bO&@)>2KM1@dMBQF@N-CoHiA$*Y!k}8l6K-ms6pw%er4t{gUeZG4->{BH8e< zF{$(TM(pNzi~{Q>05p|?{*O=JWvgyEx1i?q>47EMbdv2g<RZwDSGIY44u}ylybu;K z#TH_sibhGMQUb*_nH#68ltN>9jmCda1)wnYOYCus)gO=imPDw@93mjZ#l@x1ve<r@ z`Fbg1;$dQlSwBTiZflAYUbzJ&7fs@Sy=q95PqvO_?(z4l;QI)P|E2@uY9s{oq6^va z87(=ja|{O?48Z5OjK`Tc;sCzGt9G1OwQJ0n*2`0cNH-HRN1~J{kyPWFlQHDvf6H_h z_iWmEtds{&Bjo1$U8zRF)WI$AzJbU)!!!pt38h4bL*O0jZVG@{1flk)AuO77D-)CX z_7lXRc<(OKNL00dz?Le&lD&P|;fu-`*Sd^!M9$-Z`eZPm1HsP|rO}ad3C16$R@PSw zLv=d0ke?h&Kvc%HC!LjgNZ@UugymTA{s;pgrH5}eXT&>d@CKysL`L3qrD}&@^&(Yy zIgoe=r(DqX<2~$9Xf02sHoVo7+59mK+(d-xExyo`-hOre_THnxwZuwa#*{3I7{NX- zOLLAj9hRpNAx&RQG@&F5a5<W%1Yv&%Eai4e709`LoV=g|H2<O=v={62ZxD=Jk;hG{ zi<_&1d$Xb}AVFj@8qf3TGJ>6q7t_EOp=$7lVPivFj#~`xW7|*jJ>Om`0YFpLSKTtx zy4rGPK+$-7^4{dOyDxy4D!R_754g9A-?uLf5;NQ4?s6r&9zZKfCcu*cM=)mt?xWfr z80F$2-(p?hl}a>R73QntOERhcrQi6}=`}B*KRGAlJ59HpKZnAdp!23$q`!2h6@a2P z@Cet5UtVmFAG*#m{KKE^$%}?qK9*KK{Q<)7b6-TY$1?u=<+eTUTKrs*%s{&*lFcU1 zXv2r5U`hr_Q55)i@|7yMjJc1Y<kW+U2$p_k0c~8^E-7}12pwM#<4ntta2AwX$IT~Z zR%kwQD+brw2MbH%TsURAdS`u8d9xEghh{!4a*i^=<;z4CE=kwaP={F6J)uq%apkma zkv(A^jSjC_qSd-F0zuW=W?QF_s+H~5n4}<A8(CDSBpUVW%L_wy;)ZZ#W?fUa2o!&i z80;q?dx?Ih9Ir`FH|YNIlPx}YFC{z0B6;zmCi6{v3iE6%#Ni^1nAhi*7_GV_xw(Ca z`}v^ET(onu%4~nz7OjaGseu7{2Jl+Q+-hy}LNFBV9O){a?8r&#^qhcR>7b6Lv7p&Q zRX&P+SG3MX>K(>WdX2TDWXTaXRfA<E5J(|zN?wO>^I33nl0olrZC<ySF84dtBMDv) z#kZasp=kOiKXnZ{vWq3hC^%$d;3hQMFl29nf#vsN*q8_l8rSGSmy5<7cXM?Ro?V@b zXpvE@Uv!9VpWBC9Z4Bo3pBsSe0x_VTQ>Dm@nF4s#(EIug7VPH)6)*)wFcV^jMIJWH z_6<_SRZ1aIL<h{I1VY=&aeF)%p;vx*b~A+CXZ+CDDcFbZ!Nzkn*%gWAr|KM0gIZ{4 z#1x#tNa`)|sXFhm+Sa~Mf|Yjyxn0i<`L<QP!qw}>Ohy-y)w>Ym<Y9ThRRSNRJ?!$^ z>J^OFJ#`loqGY>pV$)UqAK|s_<qCv>!jw3{-*WI-cr6_%c$RcJD(qSKcWwFVM|Xn> zK+ChZO=r_+>UGTm>#HTGslR=<AY#`fIxmb4ECP*i1mEz)G}we-2i1;rGmGsa^BWop zhTitb*ZCkQ;?GSHTM(<?BE$n3BMPrhR`;l`<df}d?8)T^-D<U0gpzOS>SWEDkrlTo zpV9A(@znAzBD{$kz`?hrW|#c$ZSidq-{c`{6;Vj{ATZAntqhiFi{doLeWs<p3$H!* zU-Mnq#SB4;>>!3Xc5og_61F(!7K<?+8=^TAhUbNi1(K^@F^HsrNVC8y)LFcwWu_)1 zHjzMRASKAaQf<NY#2o(#if?w6a6k7iBI=F&Vh^9SM(CY8wzAyLLPNmE-lU6bg8}%S zpYL!f5z;~Eyex10q^Sg5OJF;PSBd~qOwhCf!r>wW51>KKdHY1oIzRsR^E+`g9FR}q zYOVcJDdLiOJUffm1brQSx(<7C2wwR&n2h)M-vKJi2#DDRen1hxfn$p*C$VJOzxYNx zm-2}0{E)1NCLV<w?hc(Cc!-cZpLc5z<x{W2&WQ!I76>gKW@;B-6;h?8;^b<MSQd}v zi<<=niP_0egyEO!H0PCJP3+yUQUD0y3=aY2Zi1Y6Ad4>_FXL|rgG0rVVqrOrRx-FD z9U~Sb8OcCaaSAvGK8iN&9iPxd@|kB&ywfyW!;a?EQM_)9!ruvAoVtk&P~U9z$EzHX z3tg(%Eh43TV^tkS&|_H9@A&R;Q%_QCnE^88Qw~3KP*uX8g=v7<DzIeDho_;4s4GZ~ zhY5^unr$<!#d4&Dyqa9|_<*B3o4NM$ySs_y|H?4&F~-l2TeB;BR39l%hvUPtOw-`h z?)Q_9>h{MstH}650gaBcE3fD0X#eG$^M$PPr?#5tEvG}EjmlE)084Va7B0gwlZc<g z^<o{p6)NW=CP#{FxzZAr%X5g@3ciHmxYB>1X!Kc)&UD9)E^TeswJvtHceOIxwq3|P z(mI?#)LT7;^Ln7?xkfq)_+QP~w!XI$KExf3{w9(O8x^rP;u3TNfl)Wq&OJnfc;Sz3 zC3#!&4B0CQfNsi0c@>@002@d^9CMC9x9Z+niN3vGkKT#{#m}2ZeFxPDh4aQNL|4a0 zDWGc?23{VSt=v?RxiZEAcE`|m=QTMBAMHVDMF<%@j}4eny+<Y+eDd6v=h&8R5F5uC z{ArI+SBQEBy(TRDZAS2FlWqDiZK;`>HQX1PwYi6v<vdI~2VrEt$@l<YpK9vY(pdi} z_4_r}fqJ#|Dj-UwOHh+`DkCGeYAn5dunNwwB6dPb%0mnWmx!`_Z6T!$jtH!SDJ&>B z4^H{?rZcRbl&ct5*mJ=RK>qBg*pDougQb#Dj0Dz)_6r<R6cjGxV!4nQq823vor&dI z$@)_ls2?&`WOj-!2A`c*mKmhf4rqMD0$jxJ2dY6f@zo<hVq<{ICfeT<X+-of&(pG_ z?zxYWUMoSf+j6Iq0$4HtvUItVMd$#!J15BTUGFH4P>(>1Y2Vl}wN1B~g%P3<mN|}O zQb^k}F7CqMl|yth>7BnrKG^Qd(7kwK8;*?EGzg-79tT!5izlS<9Yg`BbkEHM%m-21 zAEOgYTPy$7X}{iI{K2pD7(Q{ncMR8vypRx;SSrhd>^_!5&}52y_tvo8s-W=9_~;cz z|J!)u?d#?xk+;4+g;ck@5twD;&a*=+<PL5MOpKtT!P(CkzXDs`e#UkhKO<}XvQtB~ zazi5TvPxNWDwm_QeL73;oH}!<dB*l25f+ykg=W|DGPehi05{QJ<Rx6>BvaUw4xcIs z624`&7obJ3l!(%Em$>p#YZ~nTlDz#sI`U;*UC~oYe%m{#mnG5inSlWdcxG-;1d)X! zq=^<{D{=?QNOug>!YgI9hA4ttv$bi{Ig^|ziW-Z{9gRigVaWoTm)&)9JK=p@WbK6D zk^e=ItODW6_^Nq}f6;Q~)$(30=6><Xt0RAp7YY0WZ_zY*i(qnnJVcxKO9IVp4>Vo_ zQj8{0-p)IBKF?qTC-8ho#|>Q`e+kC_Q|kj0*Xrcs=;*jS4B%vBXYV@Q%xdVsNC$=p z>6{SY?gs-^Zb7z;h^eVpW4LQJbX_Rq8%h+?3YHlz7Z{T<P<2N!bLg$b6Kj77_uB;| z%;4PZ9-)&eR=3{iMsm0Sb<!C_Ch15C;Y^AE-p7XTE4ME|-lJrDeQYkr$B(MA<5zO~ zrlX~ed75vhb6v<|=W)ZH7Ma?6_H!lLHr9S<&Q3AMr#oRa7h!@$V8|!s`4th?0;<oy zG}wg4G}o)w+&U@xNWP^QHvimZpR$b^6k`G9bBe1cX6RwnGk!ONP?#vwQyOye*!<_f zx5)&%#!fd_sBDz8TsG~U$zzfooXI3ljin?(i41l#%SQZ51hy;VcJa|-s}yfx-Ff7e za6vP&DO7OfNhk+S#17d(IMHE3E>ua1TUlyKo+G=K{H>a$jQvlo?ZAH;L>Rx=U^Q{t z_+i7{!Sjsl6ctX18$;^y=NOhPez{_ed=2!i{l1UO*3<r~9K%v>E)iAsiDunu>-O&3 zza2f~jSDM&SD*s#E4t?M@wf1!zwmwC7sL*M@yEZ0+o=uLJNb^iuJ`+0Wxq$`?OWS( zEju0NesP08MeCY?UvE_ppimOGp^E8N9E0xRyVWuYED(IHP?kj#*NX7O2ya#cp1J5? zaV|nd(s}1m83`EVnRzG5A1)5TTaj3{_x>>UdmHb#uZHdtVJH4qOb}2772jQvin10t zE=^w$mdZ=*yRa4F<UTnd{N+9Ti+jxAGvte#j!tr!7UUbFuHY<V0B~wzPuY~KHD&JT z<f*#L8In=r15en5iP0g&6HFv^T2(D>np2lmMf+%`14k!kg*O{1z`;lEk4VUL0b>8O z6T?akXf_18d3v;O`m0nSgUMSYr(Cjy6YkpX9JMeKp0gr{tqWB&xpd#tX3}PY)03`Q zHIaXzQ%&*>>uO%A4b3R=Sk)lBaMkYWuqNyvP^N^%t#DN7QE0BS+3_^nhOv`DQx^Zz zuqzQtw4W*TWV)u=c`N>Rl2L98%D1m^{jR69)O@%BOdtS!PwoHyBO;GJuaSsU_jrD6 z^-tRBRdjD^)ITnKg5w7^wK`I!!3H5|h{!h=&w^q#6R~@Z#q1f_qU?WUnJ=v0LG&dB z)@AAnUoR_Wrq|kWZUpw<&S&gn7S;O`3)zB)XyLEScZS<{X;&P`_S#=xiyv0COx9l5 z@WQ`dCl6QFE<My;$K5JAmedIFAj3?;($ZS}r6&P60hDq0WRZjkda~l;;;@5AeE3tP zZ!soeaFUa;>8%(Wu*^8s1`~}unk7m^{?pC2EPuAT?)Jak9qQTU@Glusxp0&#*JLqp z^thaRZ{7(j6TXDAP0dqI%x7vu3{b+U4J;=L*n6!+zEdJ6&?+<*465lF7>oGbb{N0P zY(LD4yjG`XPqy7ih#103w?&fPp2Mpo`#g3@W1Ve(#QMLSz7<d7dwHVwTyI%THop#R zJC-f6eO<bL#aPlSt!rpnT)kgDYK~a{nMl;(z-p)h$2H=@QsY$T^P{STwmGm6m=OS^ z?0^5$$7k!&r=~lnaClSkZ9<iTWxef)7JrG!6LA{hT%SxOc<3YA_>=#}lxn%=GYRP~ zCpl!<@-x&EwTsp><-jw+HZ-3g!jd+l?ET|wqS>Co|EtDc;!<fc9kX7cpx<;zj$GJX zzgcI&Re?o8mTY1+@<b=T^5={4&Ef=ZTHzzsOO<YV%!+z$d3k4^uj0b{7&hBX#7{IX zWl`Zoauu5SD3%rRQITl=mQ*;KAL6GJSV7(Kd?h6gP>^^N4l}qH_|FRl+4*dzNEggP zArg0(k<^NBi$0HS`K6*#Ls6l4!V&{av{TW=49B<2t?x#&(q5*N+1ss<O2(_3_8H{u z{x0Aqbex~^TFBt{yIghgJZ%&xn?MW4ELoas^WBu<xk{dbcKb<Do#81Bv;GK)%&<j% zp1f2*niTpvv+6Q?e7jx7=iV%Ll+8AM@aFm%#Pz!b;6oK`@QR-ss2__Ab`kx$7qLlN z>F3l5d;ZQB@0I~zZOOsv0X&ifI5>Jk_807{JL2uJyF(kY2u7I4mIVXlh=y4eKr}Xz zThXd0uj~eE8{LesXyqhPkzXZ_mQe+b5-*NF^ew|0<IQPr$A&sU>(27E(sWg|1X(g7 zIm4Zwstlys;~1>CBA-v$R>L#C2S?+PZ!`Y46@d3ykxxm&<+zrfJHxNTf}Tg5J=*B; z<jY2YW0;CZ!Rg1`uO9H7WB+|&V9rM!fd)HYq2m@Y9?56h%Gc0L59=n%0&mY}Oa(w1 z=ih$N2f<Y*wcFP!iTAKjv}$=q&+{cgH^HjVzr!ct<BqwHKPZS2o9#AjC3ReC%v~Eo zZRaIoTRoOh%zyK}2aPG=f4B_Q>*-mU8+f$|_!1V13G-S-GyioL;aKll7VbU{zh1jM z>o}hN8fNj|>=(LhcBhwkBj|Z|-5X%}xc6R%=&0}hdMwy}wxUHg(!^w-NmTqiO`H#I z>SK(s>K|nODBVwsDe4Fila$Lq_%mORB%%=UomDktsE7tXI-wys+l35hPao-cAv@nt z6|l9=MrN8N>8AJ2w~C?})LW~c(W5XVpb}7S|8avEH9HYz;_hO3nGCxcfsW8S6{{RZ z8|^gh=|_m=CHW^*p#6Nv6d4l|hhf0?NF)mY^^*E*Y7@%7(V!IyalQI=Sa?maXMm`U zM212mJ;|{ZrqTKWQ}P}21~#nl@9SxbNj#Q~hG;DSIIv!w-<{mQinV>5)1QCyD$q1G z2tO?aXp;wEO2yluR}lx}{?!&dW01=P_duOtA?TthxQ60RufX2H!qk$&7&2)0mFkrN zTHphqHy>Sg?K~`1&9$!?j9wmisDp1dh+Nk-YRU=2+*D`munU;&k;*Bum<>478-r-U zoK2&6rUVJD0F<P9>LcPtGs%-0n+udgU5I}?I<~3ASL*CvOKyW6Hb-6XB(f0fnJ68L zOCz`yJ(U>(_v$URw%g*ZOC|sAo;1oTW)2>m@QdySt&{s>TEm5LT3QfB^7Q?Ig4Br= zT%Ql8Z99KlXF{#LuR{d8U$1hEj}uKfl216yQ0w5D6!|K+f=2yamX8jmI~>?~XXSTI zRBT7-NKcq*{Cw>lCcBg*IN^Uo(zR0Cbh!AIPU7)<f$fg*tL(}*-1&2)=k;vd4yX8u zru%Je=6&3-&eCD)HGstT!OH(a*VMOyi{$gN0$}t!PVi*EnMKS3BR~Xzsp){c-TdLu zXVZjGdp>dHdwE&av0`sPU{GuHVoammQ-0o^4ZHPz=m$?ja-p*@k~iz6F8bTOtK#a6 zsN1MDDhT0mb7s;@|LDMxbZ>Kd7T2hj#K&)UD&b~eou%gr55ObhTT<Vlw0^${E9!01 zvCwP%Cm-?M$|kRVqr+yAoBSJ(JXejrEjSnlPpwNA{YOS9eu;IBMS$}<>j5=Y$jRgu z7QZv0XW$Cc(jV&j08eL9((;W^BsLw@O=dD|E4-9`F&xZQ`&a1}BIO1!5l1tu^5TT$ zyl8nu<qz=AK3d~7)$N3Ww5l)YB)yEwBY;!M>{`Y46Bc@9alq8A0qtT$7ky{u;Dw44 zV+!@IX*&?v@_?_PW`S|_Ix^8tV{Aay;(PMhN{e}c!HXw*DEZ+xz)sGf?ePpPsUBdI z+f~<DHuL$kA4`^Dojs5>G?NOZVvY?r!!+!~GX&b{uN|04BQ=7uB`=<v-lW5aiew8w zPic3F`5jR7F5%fA%L$a5ACwd=p+urGalCDRw#JW<2oAvkobboAMtl>HAosbv+}}%Q zP1DUP6d1@B?P?Q4!?ogD5Nl<hqLM3~qUS)gq+LjIKNlHGAELHyFH*kSR2{i{0>h7b z6&e9^xa$*!J#K;ijtM?>9FV5f=m_4s=9wKNV`8v|C(N52mab&{?6_V%4rZNE@N;|* z9X8{*%@j{^bRbECJkTrcS~G7f>~c2z9THNih?2Pw7ewHT%cob3gN687*nU$>Ir@5D z!MA({9WiJi$;TsuY8u?mq{w^BME=*o9K%E;i`%8I+h>EwBO{P=I^4v)X>#P=18!&2 z_-n(;{|g(ybqdSi@#g%r_0o4-v)StQv~1W>@DbAU2pSEzi}+tP+*KIQITu_HYa<Rw zWemUcF+II%Ka#oZJO!1*-8z50v<h(o%-P&uhx^Vi+pN|Bl_}U>W#v0}B>o@1{-=jQ zE5>NYK+DfIp;}*_*A|kG;jiW+w=UR^iLc9(j<45gXq+T&ysm}};+5Te14@|!-r|%p zT5|#~+!DKy>%cVF2ysbPS4|%ey|+QD=}XN;w3qb!xN`bFa*VSfCsDP&dP$cPB{R#D z;si-P+!;St5~_~d`pn993JhSFSL#9<UgUz#B`LN7eyS1kwbmQYCVj3k-sMSls#TM< z=O@I#!|t?U4M9rri0K2_1O5P5>t{DJ@MFcGZAvf3SDE+~fSLdf#ou$yHE<KO<WLHp z8~(?`V`U<t<Vb~4CP~6hO?Ix7i<P-+R@n38<7)ICyG7e?DfphTY+UzhZ`c@0`z2T$ z4K^ZQ<48v9*zRI!#Z|(0@*Cizw7N?mMXXm2E@$f!0h&Rc`e_iKC2X*uRuMxKm#R1~ z=uZ%9siYV}0j<n%^6q1Sjt`;RdSb|kng?T`!^EPLs;=a)rn6ep>S@14l2*^E;vmrO zY?4r#?hg9mc=!)vZ*DTX8=rv2bHiFlW#o|SidK`qDSa2KeL6KPf=J~l3mnsWFS%ur zTl!ivoJb&vHdv#$1}#hSQZwiDMNE1yUDDpOGZ%8cXG~|u5<KlH%CKavGd3D=5pk1A zGa?WbSAmr<2*@cf(N1y(h_8S;v(R7Ch!rifKzFbFd|#vx@39CZea+}6WxiRkKygop zH4UG4eh8Yi!Yq34JmSIn`W$o@M%l6Q`zWsMo@3_{`0viFBKdmL4zhUN&GG*5{u=hQ zd>^=K6>R@Ovhj!+(r;no${C-9oKm(4_xQ;CVvqTI48hnF3utc(*svz$*Z1M67g*cc zD%yU_5q@g=8gaigvIT2>JAH|+Ar6gPJhRy)N9y9#DRz@t_n*?#uz9+FOmTc#aEAUT zv;d9Dm@p<L3%^SAZ>!|ETuJNOd6LWZOwZfvl=3E8Kr5`j|7po~hjSUq&hxH<js+Tw zcI!#Y%%E0IMICo>xBuZbQ4bNus>q8z&ykU&WLHdsLr}ffH%ZK4xplVn7(A*nox6&! z8XkA#?XMR1W!ah}#%VA~drSAGv!_aZdBW@|X)&qW2yWM`pN)JPQ0(`GcGLLL+4(SK zj&8}Oyz7)@R){(!R5R#8V_GZa?YD>bi$#viwD#B|WEowf$`<ZfUymO?YtYVm-8R;G z4dFJ$8Ir4s3hYazIf65FPR2#(cNu};!<gW-qL9?-2q}q07JVvCe&-UXz|y2&xBY2= zbxwF&jRx^}>k~+Y6k;I4deAtrc1=_5f=+E%R1mARRytWLz100rJZWn%IAE{ro2q$e zhFJ!ed}VF=g$!G-_ER%}e+RD+S0kz>HXCXuyPJ8r$?gyEPTyCS3GHnk4;H5x8h{3! zFZ%gxJ|3(zK{-2*FchL}NP@220-LMfOgC(|T5LiDkjSz;x<&^hB-Bp%OC)o2?KDiY zcP2HUie6O2WNCR|ouc~DURmoRXYH_PeZOW_nl^(=y7$U<ga6XRt8p?SS(sHkt_eXJ zaE2}+>GxBKLv)NkJs&k}kCe@hNOH`M<pK>XqWElt&Q%}HGp;j_<Sm9EQ=&l)Aadhe z^A(xn-*<ZICi9lv<7b5FQa}n}vU=8LrMK{LeNw%0b_PIf!eC7OD?vydS~Ozn^mP>E ztUWz7Y@bkQo%v>epcq7|Q1^Q``(d2MKK!S%|2n2kC`xxN?xo(!)@F-<Uai7!Z)zax zDB!*&+V<*Fkr*a1sFsI4=c8P#Rw2kDgTwtzno$l)AvX2u<rOF7G<x8m!|xfz{~@Q# z_;WS9CRpm?_7e}|nSiC|d14!K=XdvUi}v!@tozrS@%v%TTi(^@Q~%$maWb#YugIQT z?IGyfM`!*oZbftWxm>#`!7$1O9gN^`wc;!=-eO1hFPC4>TD3pf0h2NL<hHT^2^@Ox zNkG*szY<D+ucDOy^z=hMpUi=i1+yFg^lv~mm^fqJ?A^1Pqq0p%t)4xLqsb07E!BTz z*fwgYj{Dv^popA?>N?%LAX7HS4G3gQpUETXM727$?!O5G*a(4Hw#bmK7U}bU+c(fD zwq6z|8<!%8?lw4>0DZTLs6QYhUFt~yVL^ex^@PkXzs$U>r%1cYp4=8HmVV08$5#9) zw=Z9HOd^qaalD6|*o?Com3jx$TnTm)dY(kDOiL0H7!e&1-S2jb>P0aViD-HISLJ8b zvC`&cf4<iC&-S>P3aBoDNFMfGB<h3pvPIwE&)INkkiG4!9g;VbNE8*V>ng-hE#qeF zcaaDtG^3SvG)5jstU;pr%lvIQ`z)KwSC?7`(*t_BP(91Md25qXiE#WH)$PfhEWZ{D zJR@9BQ(8FHUIu|0`o*?ZmX08M-#=-IAEL(QYwQ)-QO%PL^38bwB?ifeI6rhG4$o}c z&~m&C4=$__S*izK)mSq}aL2e|)9<|PySTauR@TEsl}_kZx(OBK`8MVG^yTG+aw)~S z7OVx?d((l>*|rLIqssZDrnOF)Vc(3V``=XuQ3e>N_63Zb*3X;%EoWx&F}$g6I}SEk z>Q)zeh7iFtShzEG+$C<m<$LE-W_Jtb-)XlXZJxTkt$S0*+pV8UI(IGnGxogPaIkuQ ze*D{bFUW~<nGJ2vDWpd%lIaQ)RCod5c?^@2L(H;Ii8a|0D15zJl7e+h6@9l`eb^DM z<NUPHz==(mvYe$1%8VrOrdV*t0JzD3x|F6jY5Y59W5<8jpp3X5eycuMzr(K~{B{Sf zB7$7F-M}d2&XgeB@!$J@Z$E@K{I0D@uB!TcZ;JhRQm!8d9psQrERw-n^{?kIN~KBb zKMcz_y&;eF6L05VT~G_T;)S!hW*k<9DoK>h7KDm8g{Wxnw5ph5ZQbcej{CYoyZ0{N z<`AXG>euK216r;fQFt@3Jo;TFXLY7?b=y9&lE12L=yTD3EeHCX@_hXiy;(k7PLZ5= z*lxbH<&OY8f0o!)5v=3toM)V8())UT3VW4a4`4sqUkByo!~2&O1#8?Z0d-5z=kuuF z7}PP_38v(zSgX&3;=dz<Cak1NfWM(J84GP*!h$Efi6Jn(?DwJ15{}Z4y|LdJ7Rdr~ zwOJKYOche9E1zf>h@n&|nN4P`>o%Aulald@^Xx9FQ<Ot^T2-0^HFnK7I8>+W1>+>G z$pVc7gV&Gf6L&)5g<H=Quf_&*0z20K2sc8fs#LJdUFM!cjU@LZNYb(WNYP6F%_*lT zF%c_qNsk31|4)wXOi;h57q(n<ZYOz0;UW5XZ7$9yU(jknt%1`_rMsZSvAA9XH8%pg z(kJT-v9a<%XXMCQFLd`%Hv-%_vuJNhBL=-YKZp)K@v@gJL|jCRv#6RmQWztjHmtWZ z^BM4p16Rwi@H~yOb-gLefmu;u=%swTOrpfxy@*A26*M#R+nXC`l5XVfE@D8brHz6U zP74PUY3|YI_YZ~UgXsLZy2p8HwQE@~TRMN$>uU9}Ks$xS_d%(`7VP9#6Buj<1FFs* zq#N@C$u=Iu^=9b=Om&B#E%x(li=PJWCW`NbOeD#slkTdCKVJC5(s=B9?Dk_`&&MB< z*Y%#4|8B;t=F>*Sn<b~VpGZFeJ&$!gbf524U)NdN@BW_;Ho0ykcW#s44Y#ym)p_t6 z6$2cZKcOB3rp0Uft=q-J?R4RHnOI-)`&g#Huz(`U>jVAW)TWlz57o5%LKeY|_BLJC z<T_>BNseCf2Dk)m0ZR=_y5Ev`0vgq3MA=(lj>d5^@+6Jiis?Y^d4+rfRXJaq=lfgA ze^==l;Vf+OzWPWGT&oBg9tR`s+9oKs)#bF~#oE6Hl1t>E1OE@=Kpnp_FVg&}N+RCn zCZ@V^oC0J6Wu5`xZFR#I@*`pZxSz}gEtj^X^SDSmn1)^$JYj1a2CQC;&JF-CbOAU; zrW&%<*Lvpx3Kox7PGW`DW4d%1sNl_V!kK|6N}8%l#m9rmthx<*gT8!aOYac?!zyw( zBHev(Is?#l3L)f05CCX<CK|Ln4A8<03Fx$}vSQ3298DJhb_-#Ng3Y>R831+%y*mdd zmAev7A8MBA1!0x#XU0yy+p#SMzwS?~yBNBW?lJnBu#st;DIj%`rM(P*cA5fE+9n7> zuPIBjvNFW69|L4ga{yU414vO65CqAkY3oEt?s!obAgHPWf_@kS6n65`Fq3+k;+)E& z%mGAw+Kw$z23yQR;aaFCskQSQ2<$z+v@;;kgX2lgthvEC+i}Cl)iUwQt4Rhz9Hm6i z#;J1EOp}ZVS(-CA3}OPAlPqiJP@pIj2Z`zE0Fv8o)Pt%Li1foG>J?9U@*wBj9qe=l zJDutAG7gjJ^rSl&0En|CbJ70s=+z~F*-2E+O0=9MR#&&WI+`@U^OLBzZ64qCHG?`M zb9q|ql4mTU-pbf}i#jV9hsj{4BZtTU{`JTH&Ubvv{~f@;`R%{|H^1rE{`JSc?K{5Z zH$U>xZxsf(dK;aNx$=W`I>jsZk&k|>*z!Z)@|(Z)+u!-k-}LJO0_L<$5PY`)XME^e ze)A(A`!=U-{?>o^&TsyvUzdN;2M7D@_S<5E`<>Rzjflt(la6DCaoTar1A;;n#;I-U zOD`ZI+jwglR?;K~@Z102SHJCB-^CgCcFYnm(cG-87qmJ$L`CBaKIglio*T9b#$eB? zb`$`ps^{nKr)JD}`5U$%rJ!X@ay8u61slNZI8-#HN<lY<`_x>RLy_f{hXZi&JuLut zJ~dMmdhzQ<#XyU6Ww>fb0UTRADrV!IYe17b8o;A3E>R}cD@lnb%M5S6^HE-9u*Z)A z&RL|O?Y8btS5w)X5`gwVPX(drpS?ws?P{~F6DX%S0<z--E8nf#)n>zNmSha5i>wGU zwl$QHqV;%MwpdA$3Sfb%DGjDaRCuIfV;boew7`p}9O<T}#f_5_7^{BUnJv94RIEG* zKN7vXI)KT-8+09ltny1TA(d_DKm+{*Ac*6#7%VYUH%ONmz})q_Eoapic)}l8kvImb zJ}gwxc~vkKjts<kQ>Ea@H3{~1zYD<g50aW564&;&k7x7kLC-xnsobizW$g^RN0SAl zY&^}9?S97#V?T(v0PE#AN*v1!5!EbBH7jRT&8-xiPzg9SqTzDO+G~&~y2~OzGee!E z%0;6Bqoq-%Tfzyzks5&6_7ng;#}q!@;^;LHjFvNV0|ND0_LbeyXYW2L0O2lkmM1+$ z5{RTai(g79b6(^a>a;#H=b|20H8C@TEwls0<-8~qy#ATTy^#}#slNyn)%3H_YMDB< zFFa#ro{_}q<r_NyshXncYL?{$Y@gTXW6$YWM9BQS)6&CbeEp^Kib`pkJ8e@ad!N5N zoE<MswR7=$C-UPo&V-|5Sb7{JPRCqMye!Sz16vr~!A{3%o3pX|<3I6NE?(bmx4YuW ze&nOy`h(x|ALKW#u)EUo&wuH!wfnYMFYNUCHb43!|NbK%`?ku`|BGMx>)V(50K91+ zjI^-R@-CYL@uxP*T|U^jUQuY+wWrH)(6JPS9Lw;+#IY>qtfaUC0LR))`0#}E!1@yT zsUX?-wr_pcdQ4^5XX2L(NA>5MOO=|T&>IKIZ_ahdG8U-V^+j+;r%%*7BG8+X^^GZg zvdcnmwQ><DwJegnY+q{K`r|2p-j?}i(CBV9z#A6H&Q?~XRlLE3AObkD*7u>6UB#cO zTD)JvRa8}F)ncs#tPI^OPA`s90GhJ${c5{Z+EoZx<_Umy-xi6<08F+K10a|bfRI9| z*wrn&1(2<v<Z~FCwyqC50Ma-GkOCkWu!ZlSstN#ypp`H|Q2`}_Vd~<7^NBCMvfBnq zHW8s+$^<-)031x_<^42KguK+U8zHqD1dzJ2cZNMGAA}o(By(po82tETB8Ka=Y!GbA z@CCnSc}&|f1&?<P#AICC+XiqlTR4{C2L&JJGK?%!U-)6sAH@K}woLXzsY1a<0QiY* znaW8Fz}$KUK=j}?00RUd(Gn0;Ffr7Vq&it|9sscC%s{rS1E9MufqHF+=RN^gga8R1 zvE|8BxEEQ<3d_0q!u4Q4y=W0I2~*K?f{vDFe2Um?83c~PWV|@AE?KiEL08kE8H#w6 zr0EJkS(a1JGAu2LQ-BOpqh~u=mV?O4Ia&tHux6a@=yb;wiA~IX%tIpTcUog+FqAY; z6)KsrWx#e_WGSokRD6?{7Co=a@eTe_rskjAWHXfyT-Qe)+&sGc{H`D&iNi#Y6nbv> z&wu5cyjj@pTf*f0>yLfghrab=06y~3Zz+u{$#cCs3!IMm&ENEq-}>zjt=oX#`t9%h z=5P8}Vu)Y<SKs_SfA8P?^1u3<(l+F~(YJrk@8(Z24V`6HpK@_smvbSsfL_a7`msXP zag2lU+zXN@$y*jpmcf<X-qMf7_Fs-|i#&mRhBry_oSC`XoamWXu};VLe7mDjj#gJc zzEjK(A~qG<TzaYSK_1_9nK3$VVU6HI^pU^%`x8y43okTSrdNjBf6Yz8e00tRuyMFr z5BSq_0K3;)SnFaE!@d3|GiFYsT-FR0!&OHU2N7X6faAM9WGI$6`FHmq=&v=ZwiL+3 zz<m=Stj@M^|1-tpDMDd+xa~`=z)b=-x%grmz}-*H6_rd|>+P<*-e)Nt(Hqi4zolYG zP#n{6Ohfl!l>coo#Jp)8gBeBuOcG2JnkF<&T9&m^G3I7;TP<0Zb1wd?Vl8gU1FbVM z79R^OZeHseY_dShn5P;HRYx=Owa61#6=*fDqC`4DnoH$d#PaS9`BG*{L@69lIH0AI zE$!^=w#QXS8#hjYna`x|W=NdY;N#i+cs6&#P$JjH@oeq}p&N$FAdndS0AT3{+rw@J zAb0)Hu}m<$Fs$&&>O3=g=W0ew<_%}vAOVvAUlK=VgC>+4943;Y0|PLJmy<_<cyw`; z>dQP!WQye4G|42}Qj1cZT9==;3}fR>8&pqT(-j75$Fa5ZytVrrGhf;rRoiL{zwweY zm^sfl&vQ*z0nvv_%2C41agat~BFM3sIgPU<PSYe)R8mw@6eW!_E`J=lp%S1dr0z%R ze#AM4er!3q<>+aWan4DUCQ+KknW`#+Of-p8Fz&x{2o(Il?SXyqnQej9YWFRGKJ=|0 z`>o&pklo$@3-Xtdzl?+nD>N;t<(t3hBOm$Lw|?Yf-&&Z8J7Zye4NEsH{pWw-o01@% zjosh+?Y|c%Y2JCxX`4@mfPG1}cDeo^N*YDcc{E*y;xEUtq;{lY3F73-IRW`sPlQ%a zYY!SxbrNPtuo`zdT|J4O#ua%(hQy*-^vO$}@l(<{X{Pez+$_->`zCLAkZMtN`tp^F zR6_wZl!HSre(?F(_NCU!mUde=Z4G~h7fm8_Tx-%QMJKZE8{J$9#OzomK>jq`wADt7 zQ|z3^nOLWLoU{m7mmH{t_8_=oSmqCDo=Rg7DX~c+hg&2_SBOK<v?W3(k>ozBN(rzg z=Hg1wL$<WU4XNWQH!OP?Zi|;3<XH|A-AFqs!(y?tEDKWmuUB*~kxW-|ZZx2(f$y~3 z(KZ1boR&uuv?O6{3-QD{pAAMq3<BA%Gg_7<>d=m0#s<K}36y~~0~qw$ler7v+-Lw` z8SDcXjs^g_EgQhA5B3Q-w>2ctG6)JDSzs{>s%Tg}P6%Y}Jx3sT4=?SG06aW8t$LPr zhutZ_%=#h&piGPRBv11~NvG6V5_6Mb=|qTwlt@TJKsio`z?bzTOhD8bIs`;P3?d<- zoFo|ms-_6RL{Wi`qKqnqX-3p1fGo}hh%7Hh6%3mf^42~tDri|8rRr%)09`eO@&pkv zIP_v;k`W>8<fKp(CZ=r=A-&^8U7_eq`e71XP_%;>06lLdah4{998loJ*0`v+D+)zb zP5PD__6l-;{V)mI%#5Rl)7?vhI7kKZJPuOB)||HW_rCSt{Hu?NP!%8f=(qgf_x^{9 z&7%TI{qtY?zwTV>3u9b`zj^05r)`K2z8kf=*3bXKH(j{CH5<Ezr2}XU>^MxS-Y4<l zX*3}gbWT~m_T@}u3on{1gR6V}g%=Gv)}!O;i&u9C9gCU$FccrE*Zj+zG_A6_nZ&t; zRlu>~sIgznoQJP_V6?Xk0aHklTsIYzhPaANA=O`n2Jqo+4_t(#c6Z%`(25?gSPowI zic&NIMD9Gv(!64_+&G+|oe`jfi{0YsuZ}2q7tR>5+F<%12Eaxx`jJFnx-#O$7dy;& z@cD&E)bDK?2zXL}dH=Huu_XbK*9e{E5yfzOH;VfAz0WKzyx4ksF<2W<zU2Bp(*Um; zIT>PGeo_{>(K}ac7@a=Fxzytsy$i*DM<w#Gt(5kok#ufoE_peC+%9z26jJg$myxzW z?TZ%nu_WfolcZtkCEl!3im&WXrAkCs>SnH~E>SabRc08qCs3;#mOpKh+mxvuhNQG% zjqh#ZzQZ2Wo)t%_ZfM!jCikVV#HD&B*JsPc)fIT@Dw4D<^K|akcC<VVH;Nb-_1YD; zB?EpCJC?z+fCa+~W37M5n?0!YFBrCI`11q1Iwr4hLQ4;)N=T4&ttHN!OS118{mjU# z5;9fPThRT(-mrT#S;%mCafg*8Cqf)$1Za~DD6rB-BlcrsmIKH-84(F8w>V5eFs&K_ zMg+m1r5`2$(3KnAcpBbf@E$vJ*YC9)09STIb(u96ZNr!vAsBQVn_Jfj6yCdI0Fjmu zpfc3sL=e2WGvA(bwyh`oE(imWdtXEV`kmJFv1gxq8GwKD3nma~vCs`w4<ZH@6CZ#* z&C^|-ZiN5_?H12H%nM%6IlJO9`feD9X{%=~r(Tw^-7?1e^B?&Bzi2x8#b*jxx?lh3 z-%!+|p7I0V_ZQDy8&;3f>6itfN5=&4Z$J7MtFJ`hEAq_VBCH@_RWFvvKR<m0oOho4 z(x<-VtwR4&QT;F$1UT|%@$K9#^bq+=ZHEzW=`a8K?|<)ieGP!#j+r+F6_PL~wWv1% z$Wk^ORpd2wTV2-%K5Oyk$ytH$6GCJnXw9l^?B^K0@o?G`YQ2O!1<oYj001r40EAis z08bI;6V<oqO+RZAZ|0lhuHqbjHWw`j<C-TKD=EaLVQ(&@UR!)Qp1bm`d4e$(e`(9& zW~6EcK;-CFHW&LS)eH_Mh0-(=bGBxvX`HQPwn=WiX;_53h+0is$V-%3(}V)%O+tc~ z0N|o7=6^A#i*H3PjzCcmi%V4%27!qxRq#v`%JW4~1w!#bh=oZsCRFmC3k6_a^Fh>I zD^1cRQZPD!cBUB?IG|ESRo3S%DIAMf-w$H~33=m|Y07ba5XLpFJpkZ%x&W}%?|}Ju zz7#W-Z5i9$HUlSfw@Ms`QEZ#~pxaso0RYzz0kka(z`_dwv>mIOwicc*YtAsxYuOdK z%HrrX07lzcxV|U`6L4jBiwK{&{ZL%^_4C_HKlFmoExNbs%N5YC(kPcrNb4vtZYVt# zz6-D5#A;P80xW6=<f6=$2)}V39_QR0I&qku%pNOS>KIXOXaQyYRyzt3>O--|M9>`@ z1P!EW3Uy6YQw7SpZRvCY^RbuiYEH-U0Cmgp7NIo}RmDn$uz2X3TpUqp1|Y)m(vsC_ zd2r5x#a-3aEKf-x^(Y|%Un!E$)8pmzcsbbZi2FG@*ExPTv)iVexN~PgWsiL~2JkO` z`n})(lb`sFU;aA7(kd~GANkqO2-zjW(gh`m_)}KPc$*gP++ao!hWp3U>i*<;aVIRx zWU0ilVg$K!W8IveVSS4afA_zCpVQaeSt8^yWb3=KOJ~cd3G9Sp|8zDuOIg#;^b#r* z@w%~GS)R66=j^SrIDe9USdBw@+D7GCSMkj+S(-atWj&CkryO*{9$%^-@MZ2_8DK8) zz|}z=)2P-+7O_@YIBWQo4D%a*B{0u%CM>Wz&j4gyrGz4{1@6*rnxW<=kvO%?f~u*F z?D1KifRw?m`c6qEe5?Oo>dmTm<mxWe=g5-zqBY$>u|E?wwPOkALli}%*`ZNFUfQY9 zLm-8&YkgtkZ|@(8(#*mNDlR&G^sM+fxTm+O%XJLHi(}c$dr>58aFsBxfO03ZMa#6r z6^d`Sx^2%tQVk=BqN><B>UPlP@xrb9ZlxQ~8!+9ac?3$mrW*Jx67!M;1XegTfn^Zc zW)+>oG0kupr(LzW1{%izS)*$JMGx*!i2{qYga8FhOv*{Z1OnU=0tNvAqs<VoL8k@a zL}(aiOlg*D3bP~u$ui`-7Qd29<8{8G#8*q^A9cfWnMn7#=;wTScQjw#18{kFH0-oK zb?g4+y)6K9HvqsBPuy+oD7N=r1i<ct%e$ldhhs6~PHG(~0dtWFAH2{WKc1&?mL}Qm z2lfCwzSGEK9Y2`$w_Cz?>ZY0|DG_ETZhyO-#Hnr+#`y8=ajRzoXbtRt`P1*!ZOvPR zq8C{#m972NfA)S63b(pe9Hf5=%EXSXGs86WAc}Kl(=?|GUyuNqnv$2yHf_i7!f4&- zKG`I%&*r+RwEDU{Z8mKb72u|48dXVmnt<x|ij#+d)l$zt-{4RbD5tOZ#%%x(zqkaj zb*ZSt@4w~(P<4fKzV(OGEM>z{uD_=b;EVs;sngT;t~Z7|y5q?c&g38jaOEqy>%(1p zR}a9=k52$-nj%i=!50>VAPWJ&olnk4A%Ug3SHhs=5$}Jt;b~2eBLJ6Q?yL_dSg9F! z{g0=4&h7pimuWY4d95td!*Fz=(;CXd6=BbdUpHDzLj2iVv<(Iha7<(6jZ1me2J)(4 zQp2{4L^*-rhhwoxywNIGpUXc)Pq0{`AZCVT>u45d!K;!+X_}K#?5MhV)>hW-Jwcw? z%M^5(3$IhkWl^^tj3fd@$q$k9%0+Wf$vz<yv~sP|OC%$bnv0?m7^;vxK%*>O$xqx# zXL**Zx=K4HAH_2LXGJ$rvS3g(s$&?VZW{pRt`|quT@V6oSf!<9+cNwpKAA1IdTp-n z4UQK}+c1JCuCffKVT4iah4J-sTL2g{R8o=v0AuSp0L$@f06LBZ;KJ6hloZ9|@f3`U zJ3|64ZUdl4<I|2~6KLrN08f@45q1aNWpKj4(hnJM!?<M{3~0UqW=qL@HQ^%kE$Z8q zrI#p5ighf}gP<(*Gh+pEK;_YDhy)``bLQen34@vEOkm44fTE#UQAia%dslP@MPbq% zIz$Nlgi7##nq;EftEvi!6jdQ%y_f+U8sQ_)Yb^;tr)7;7Zm;Et0?c$-Q=0eN4uILg zD**JiGh3D^@!ip@j}AMbF;zp62|v9_ThC+bLhs>gg`%8#91EnCFrVHc>~FULh?UjP zUi`UpssGxiAFGODwe;o07fE}|F}!66!g3mDx{_!73qSrY)7BR=Kh3f{W5d#uC=2~q zQE2>l{x5&#s|4GR<ru<FtC}LH0<ttSEPZz3Ivq1hb90e@->-b`%}!*Tvn5<KfSH3Z z?6*t?IxWkOVrK5Q%;_>{S$fG6@KnpWmg{<@%2|cJXcp_@Fkfjsvbvh8(nj60B+RrT zF^2xGIX{V>F#2*FD=Jk6I1|XzQpQ-fl(gV(hoVuqMsSg(tV`IaH`FH<iRg;)!*sOB zOT~rSWMoLAvbG(1nblsknrfy3V598u)t@5BeIta|)7af=(Jf^$_FBW%pFu<WR0ep} zE=uCe(Y)vr&@8jsZZ)~gSV0cU`oSV)jk59P{?TdE`fg~26)$=iB)ZQ4xT7+lD6}Ck zZW2?gZk~42>KW_Pl6$LVqFI3u2|B9nGorBA(U@n|H+ee;kP}reaT2EDOT#W+wB)`A zKmp=zapM%Nf`^fQoB$wF!d4E3Hp|k!$}(Q7>6-`{N4sq$QBqcVi&GR5Q-Q+(_VZ<) z@kPB0Ml`-9o|#*srG%PO#n-{W<?WFm#yVZNtx_f#z;>?#U_5W2lErcSD7FnlMiYC2 zfU|~^^F}JKdakPesR^S2IUFQGw^w72xfZ7cGg_wM1)-qn2G|WFRZ*&Hx|12BVVeLq zI3Unq*e5FT+pj)6AmIGg0Dv1rB+?zTK)4+QXvYZvd-r(|vG?%O?udW~5(G?N1VO7N z76o&jL5s6QS85n~UNV&xLdde0$aQ2aT@ly018%UEmSO&~onJs}=K284y?4$IKL?=O zwy*9MwcC3~<Ey({mv=|vbFXF3y#T=JvM2!eVr}>9c7bU8is`iLT7WnKVFd+vs;c0g z{Lzti)dA4%+xK2My87a-u*!MHhN%D;o$DTb{E!Iw6+H@*?ywd4v8pOU5wai%Q<Nx( zL=Rz}<)&?BX{;!uK8^tJvw9RHy-_RhB2k7HI+$YL$WL_sQnHgdbGKzq-LTg(9ZR=N zGiMItOxy~`(%m3tK*Ypv+PXLQ5OAa<%qz9_ILK;F2?i0iuh@_{lPii0O;gg6#vBCQ zRBwM`*6QmbvRt=MklK($tJ0%amRuUtEalsun59wv!q*JfhwBUs0Lxh{vuN$#asfQ^ zmHo4Z0~I6gUUN`J;klC~eony6-=6>w!&M`S;d&Pf&t`TKse17v7rU!EJ@cLoBND-A zX&cWZdqR)$S@~Zg0CzvN&<uL+{lho0<Jv(sJoTqv-b{L0ySP07@aSZ^@x@zd>V*_; zm7;!dOml6IHA^gg5|hs5o#BI{iC8=AbpTA}%O{_9p-h}JjUxcIupf+wBYBozq0wCH zjR7-B{EjH)0?J#*QmYr$sG-VakbHls;=d%>8z>nNQ7U@NrN?4mZI&wMbui^=t`uF- zyyi@>ZfK$nT2WZ`bY$P<VKVOyTj*#+h{Ke+1`%R~RG3+oGjK|g=@{m~S%Q-=hE453 z$FOw~i>6UJr38T5HVH^I)r1CuqA37%$jZ{Z1w(+99JB$<C%z8b>X;T<03KyN09-I) zKaRrmMW+CM%)JKyblU{r1tA!Z$5W7~4U<q&Y`H!a4}+L_>G=S4TDDS}z{APBa_+n^ zc1+U?qb4Z|OH7)p##?p+h^v;gA{wqxU{rN3twO-~JUea>Ej7_XU3d{%lE+c1o+bpM zwn>CE$%!D?tx*U_z?|l3HzNq%Y(!x~Ak)#)J1#&H?HB2X3H4e5xm6q4!))0dIRM4e zKT#ZofGo?$^T$@pjDqC+%fl}mpC(aC0D80_PaP?$u7(unj;<3-OFy`C3WBq3J-VF} zpqwOl4gfkYHfF<C*A~I9cGWo_*bk0QvD4W)*A<Lf0A6_SMF3y?qX(_7Wn6E?cf81t z%}JJavJ%U!6A6MaQdLDeOd?GIpdG}@^OoqdD(KVQ$UI5YZl)-TKvbBvk=$Ae6t{L5 zbJzGMKl~1%{hViPw+um-W;%KrWgw`Us_9Ce<sdRGeSYdW9Wx(l{HWj?&zTL4f++4f zW|F3+uIFXHS<d{X=GDWaqhI;;zwzX4Oh*kCDWs&~lLV1~$jub3m|2{j=5)2$QS`>M zxxA)i+EjG~V9k0`mr9nf2yN@x=qzJkC;(RIK=f42tsI1&VJB%0z|W&6-;l0q`9;R_ z4dY<KTSv}Oggt*239nX{U;2MMEbfo^zl+<0>QSFATtdSFooShyCK<q1uPx%j@ob6p z2Gv#O$A)FEuwd1}=SZp@SIxQvOEHAo7iO~GvN_kiiuo>BgQ;pak(8+=oHLj3VxUf7 zVzqW$>ot`yXko5-C1byKmW({j^DGw;P!cDaOdl;<c1D(#atI9y?WzKes>6!vE@7$R zsx&K9pDEV~_6@C8rG_C@YJi2PS~W^l`KA)?{fd98D3s;7W$UBBTz?DXw0zB2EhD8_ zM3q#vSnu>Z3>?pv3|!tBF1*k*v=djbd(kooN!WOxWm*8w+<=JMjzvH&M3f6lU;MAr zwx~pe&5vFqKyN#9*9WNA7P;Il5I%eRp}0Y+3(oVTLtK;_n2uv>>pF<S`?m>X07Qt? zL}ezBdQvD}3lLMmI<lh^5Z{glZHI`k@BqR*BB0-Coq(^rumj-E=MM`)(2D~A4{x1_ zyY$?<FTVEaM|GkgXGm#xR=`|k)SJB8%nZu6>+GwDeap`^mTI>2d!_QUVd-(0RzDkK zn&BD%<jl%(%pi9b*z-Kw){}z>1sL0>dD!o?W{-RT_PLk*n_nz}+yI~+!~)1IP}~6M z(NciGF^~FfXUU1&qFtck^V)cFk^C3@B?X^}_z;9q*D>>)O<fP;#5Oh8kA>IH%!a1q zZ_)yD`<b)8(nX`~CU&PZ&P8ar($91Fx(8tIMk7Z$*$)j{ef9Sy?V--Vr58IWHIW2i zMHM}Z!1Tsf4*=Z$#7wY8iyH98;U0W`p(s>Qe27If4&C`wQN+Feo*sZ#e(zLCl)+^a z0GwjPqCEVyMa}r=PeK5fKF|VMRj4hGD3099%--`_54yY(z@1OeBQJaLYli?Hd|{C$ z44^wSfFj%X<u7~BwgBA!>>Pv#Ut9vXTweQwFE0Cg`V$?Tx3fiw1S6&iU~t|B@GpPy zE584SJ_|tOCat7Q^Rd;f(E+0l06aXItThZ18m6SIpOs%%crLpvy==}m^M-q%`HkpR zU1nKZZPGHY5o47U%`~nN0oLfM_z*t2Cr()}?@FR(VvSOwtd!GO#>@%3<;_E}gS9A5 zKO5=7KG1zn+_`ScDW>*?Ul_M#T-~5vyCsg`j;8?3!R2WBU?twI?m`l!y2}9AVNwXS z(W)6MNKphuLz>7@w^ZIPYM_mVE3CK&sL;=%ib|D&LS+sK>t>#%=wG6}lvy@P(AudL zMNw*6n&kt{3h~}(P#OsG{Xk-2qKC&50(xy5Alo#2A>YJo8@d<8Cv(?OHD(?;nj2;c zQKMd47$s_?vg>-eIAyA-v<j)j0ytfv%JV`cqLE|Q7CEU_u4f=Ap&=cLA+Mm?4J(|O z8kb#JNO3;G4HAjp>+d)R;MS)f6|Y8~>y|*3;kox*^p_!kqmLhISDYwJ3Fr<TkdTWY zfYLYxk*X@9p;=LtC`iPkz5nV_p7YD^zk2*|DopQ+F>X87(hn+oY*<=_g5LVdZBgew z_rY`CXJ-WPEMSm&oLFTJ|MJf0!O@tRFYj&vm@n>K-rX8@TA#Xg@ABR@fVt4hoOldq zhcN(q@1@+me|dN7{^3bpr1Uw@3T+Gl!Bvi9zM@A#(j7UGpQvhajfyH%F_b8bM3+&^ zHkW=_+iB(~PHa=NO-;ZT-c$<uSO3`uzUzlS{(XOIXVauwBbx25Cd<@!Mw`pb|Ih#T z&2RhWmseIMVcy#@0E{07VBkdn2$v}{Ea!>nq&K4M*hq>g&Qk=YRZaJ4;!v5<bK@eC z#!)MgE1P1EaG64>=Q@9$Iu(RXEAc^Z(W0sfz>(W9>am{!I{wrb+j)aQH8gG6#=x<< z?U#0jr*l_)VU+=E7{zOx(9|%E44DDCB$Pni{<O*ZZV(V+D9a3h-rWU&Xxi9&lT}{* zyNNd9W?H7nH;tNKqp^czwHP(QG}XR^%)cRxF6?1_Jacd<+<z#ZLDE)MaOU-x8H<oN zO){Ayth!4LAB4&YhM=1&2zgk-G}IzBqn?zn<`rFBXVD@>=nib4fD09=QGkik5(=TF z1X4t&teE1(MJ7p2Gbu41NS+yE*~tMYeJk4!nhhbPkWp!|8sd#*kbXQ}Sf(M#Ll=~e z;wZcQE)foSK?D&EiymWR^el+n(^~}UIM#)&ftW>zX#ZpaqDxytB4B$+gonqIPRk;q zr5Au$s7D)`R`jzJBx+#5&U7N$8ns>jfPlfMPelEe4Wd`>KR&-bglNjDO3r1@qGTO; zp1p?vF7J*2dT=x@__h{4w{YhRhu2@;6CRM$HUX&Pl&+eqzcNPXC*~yE{lGZ@lf#9g zkfdxu>1{XaK|sCq!-NPyyNHHA`+K+dF4sk}>G84xGkfPrf#WSg0e)U-BAR_+a$#!_ zchjoNOC(Qn&IwdXkBU~P95qr++`$|*IJ|yst8c5DT+o=b%{0lfG!t%R=*7k~OS?HK z6a}g2=mey9+^Ab5z5CDf;xL`7S#D@n%gDndaSVzT3syi-HMM`vN;2+Pt)Kq>mz<87 zXZer(lh3@t1llrx^`CuU<5zKzL1MI!*5_ww4E(kK?zzhFte8?Ttd<sfHFD(*Orj_r z#o3!R3DmTyn<mE1%RCh>vh(C4Z?@3{K$Nt~8{1Jf&ed<hQvUeu?w4nApRO3Z9zl0U z_V`ZpKYZj5zxPA$eZ%8xrwbQ=ZR%Ai_bepMS<gwf2W}Wa<N&z_-K-zB37IPX4Z^rG zXR9!5K0~{J0btN>K>~<Yjdz<aVB^`BFeut^*(_6;5J?bO5Up6kiddq)Ewv4=v;tSI zff<0l%u<yAD1bW4vYxt{UM`QQn_6}pF_2oU=_**Nte3%Ca~zqAi%L~PND1T`p<Oi) zSD{}~m~FIL)uMh9!wIO_grpg29Hk{mS*?KquzKE#RLU~OEUccCxNqmT`@%r(kEa0I zwgtlecvh2qGMG7tVn2)qowlZ_jT*3g-z!{n%~pb3iiD+pAR=(Xd#Dl(RAj&vqtzms zdx2bDF8WN%mptc!W39-VLeB7)zD0Gm1&fww>1Kemm)aw=+h15NgV1SPpZUEz&%NiO z^fEGmd^dDDR)MGjUwCE<&*13e2fH6QR|-flNf{HC={lKYacRNPAw07@%e_Ttw~Q!E z124850|ajw`feyhBLv}jp5=pgj(o!6U~XS9iO9@UcNUC7V{!Bv73vp$*Re0}j0DPZ z?)sgUb-Hl7Yd~(1=Lax9ctvkJ)1}{SIhS`wpFcVf;O*%CT^)$j1O$y)J&u{kodwoB zPq%ft9T8#BZt=pWMcD7OPVz*Ko7JNv7eVu|B~a)hZdO%NRZ>)ngEz2Vzxiw50AN1$ zHhyb5Y865H^Tcdv0GysSKaNr6W-Iond!JbVc;>76Sc6JA9Ss?v7C(=>pPmEgZ<_#4 z4+6WR3oul5G_m{n8;$0rmEm6fy@_Tj&u$v7J2C()PGfNiqM=A|S1tFme%k`zJVPtP z0k|lova8Iq*yiCYO90Q7s!cL7tJT%Tzy30b!~Eo-2VivRZP7?rp2Prp+a`edI0_fZ z>wi20K~<<bdV5tFe(I<G>yLc@UugAptEK(Gcm4nV;XnBL@BPqwoxTm==l<#MeE7p( z1HkU+3{3ZneA3VV#0!w*2;qf=nwa402jCfcB_2X+R`dy8fft3NUPny0V=T|wg_{Oe zHnK(Hx?EwKMi9j-7FljgqP4{K?yyD`dcl#ng#Msd*>ME125vn*6l?ZI{c__-vft(Z zFTw_v3eZkPm`LXKv&A<4zPO4D+d}|E^yqjZQ$Gq5wLRzpn3orUH8EgjD6@hlI`m`9 zF;Mq1Nui}6P*g}=W&qNTKxIQa%?cN=O++YySE4M<CCW?y90iH^+nf}PV_7GsvR#1) zag+*kXjz&#cv_OZ#a#d;(+H7vl!!Z(4wMEDHiHPtIK_D_iBjEAQ8!g_vZJ~4z_g7# z&pS&6kPKvD!;1bP+tkN%mqC`U3yV7Fw3*opLSbGGrwf$)9(#jcfp#Xi-a`OpfdY&6 z#}fc;#|9uU!)?1L42!z<!V5s?IyMoNcC-q8(Q#}BFQdY0yME{fAwVtL0`tuEMb%l{ z-nr{n4%u4C`KHlwKpb7uqR%aQqIgkxHKl*!bWHKt99<9Z-|oLO0^lzr5f+2tv`ycQ znEBo-hX4e%76^356*^!%_lXFLsNZQ3uz*{8F?q$@sm56jB2tv|*G2$N4;RFUL)mmG zAY6E6>)_r*<Ujgb?d8mmf(*<TwgwlshXg!2nRFf7^@G!;cX?+7;6C$g*#vU8>?^xl z0PY`+#Ru$+?jMc2Eqmbwrwf;vcZWUC+aC;jy_R$H;Q@g2+e492z%*bY?KrV^pCh8& zdvs}M^x$ZmGbdrHj_bHNXHNXsoaAXI6A~SQ_%pffhCNa=MLUXr@_SyWpk7g!62Wqe zBu+u3X^N_=d78I-*2&T86qkg#qEenROaN#Nj5N-jzW!y9{3B19sF6G*P_Xz?XiOCC z=|mT4wVL>)A)=mYFM8|HR!_0yDXY5F#`88T;XIeGZg9?897o<H{*mwd^MaPqo5YH) z{OAvVoobwU5ba5-cnm*iq?f7L54XNl9dZp)3_)XCTF^~24eJM5-Ncge)xq)z46Rth zBuNx*^bDTx=F2%y`Lb4dAM2uCT`QNk`enxGQp>PDDdNVx0Rvia3`Td*1<<yvI|s*W z7P;6b@M6Pd5VEeiVy9PbQ5j*C5Gq-^QNmwsxC7LT$59hPm2J?)52&s*%Qvm2ouDL6 z)k#W#a>=MIX?a-F)`itq6h+csU@*cVMPWMkk1ueWi1e-JiLf}iDHEVD^JL+Qm!XPn z4P6hSsMG79VD-Y`bPk|pSqi}mBO<izB4k{8VfC1W%Oxt%UJw+|jtGoL#}g1lTWzB| zNbr!f^ktCM!V(o1HIb}jRDrHnE9zxmxq$YW@9c)3n*+3WVtnrIqwV+Yh+J?tGNjia zXGVKqxzljxQr~x@$G`Wu<m5A@&gSZNOO9PllnS{;YDHm*z*3V^@dETlEdYTx<&q)g z+|}X1y-AH=WM;-EP9HyG4v2^ubI<R#>^$dthegk^Xq1{RZt0E%VCe<-4o^BQd*=FW z$E`-3yMCu-=ggdA8H8>awrq3e`fb}JP@eNlFsTvs9E(7U5;r$<y<W??yfZp{^{%;n zJ-l~E2Zd^)F{{T(4g@6#F5S^--yL)uffVa?T5jeS5wk+-Q4G;u6(rqZD+*#oRgyT9 z6Q{*ASgx?TS|KgKY}kr>S`)O1(D3oA?yvmDAAkRMy<gB@2<@O1DIs^7EXHvb=bE9I zw$|OQW3~RC$-u!aFV9&~==xXouomn-{NgeWGtpLbPw*rI&%J+e)^I|XS1f6q56{&+ zDz-@s4y@RJjL=P<{i*@hgWWGKvy`uvY#w)hZwcV~*LEOjG0D<QVmKk3;Pl?=Dr__V z+u1e%Ohw2}05CXjJ<X0!Z>7za+8GrPMa@V6eE7%z^ACT|H~i#J{CN;MTc%e4CKLdw zp%W0gX?NTFk)Qtjzx;)F$Pdoy=%^!LJkdrq88^gqSOv<qWdI1GWPM_9Rx4M(*ZLQV zL(LzfEC~lu%o}gUCKU&9d@;0b=s}!RNn1YK+%~>%Xd+>S>Z_)alX3tnSpJ$Lt47q6 zCYkFVq&nYQ=Qt}Q6Rz!T-#r)u*y?xuDDs2o3=%NTP9obhz~C?jkeju4z|^ERDFIR_ zRq?1yL8HcfSNI^**l9^qm>?BnWf_PHZPe`k;?f0SMwVt-u92+NAtmh7G*?tbRh3HF zN!+)`<mFjz#IFvG=efwxf&tq!MxEBfLQWAu95bL&VdL`3@KoqCiFz`xI&>v^EtX6o zOZS3gf+|AJ?D`=i&{YkUG%&NGD!aojPnbYUU#dE9-B_O90?@H75H5-uGtuK_$@$UA z1Yq^`h=_(C+&%q+qsh`Uv>G+D`~DpOLeD_+$LB_U0PTSd;L-0rdhV}0Q{D8gV^?Kn z?IZ!n-hFPht(h61ozy&1LU9dolxn9b0OhKgCYflUI{1Tq0`@+59zc5Eb2_HKjEd57 z`NsD~t=_10@_4p=q2C=i_g*<-#<3Fu6jP$8$^vedvAtzPVL}9-r%9ZWPJ*13TBK@f zkVQtjJ-74u*aMMs-psQ+n}-zS4Bi=Zc`CdmnA^`0XmR>l$F?qP4;8}W@$}-(@FIpp zcyu!9IL^`!PM6-^u;+RE=SKZr%X#&|{`u{p8-xTbW?|v=9w*lB^Lc?3J7q>yX)e2@ zDD-2aYOe|s%h8kDt_;kOu~*e3pj3>HYctp1{p;^(kBlc75xLw;tKW&=Bt0=Wtq$;J zgG^fc^VnN<ZS%<ni3o4bYQ0IW%D2QSbIy7CmL1Y;ok=}C8g6r5l$?Sl@{4o+m0$nN zcYWu(=EsqZ$;REa%8nLhS)z&IGdu>`WY&bTeYKOI9Tt38XF{IWf;bRt(-?MIkjjRS z$CHf}U|!3ITZRT;(6O0|juf%DCG5*7Swt3oQGM(<W_>gQfn7gXeYuG$!`yLfl88G1 zEKhEW4~A&oU|xEGc-N|S4iGNw3;~crpTG0iwvA>>FUxQxFgsScfg7_VK2dBXT{z7X z+b{v}I1#@?W9zE;5IwjHi0(upLadfK>N2EM$H@v^mpc!MV9iS^`R$Tp<en!kc+hf+ zix-u=WhllHtc?VC<H<_nlsMlwOpJM+w{xkgU66PvDkX8M>uNKH!H0{_>s>90Qy63g z#dTYzF>E_tl!S3y-8%;RK?H(hnFNey%bISM07fM<)v+y<kZIR%R-g$NMnwgh$DoqP zI*69y33y>>=$fi1ReAp4bSBaPdxO46dJ|#kJ<u(ah(zD>qmxP7v51PM=eBK?paKR# ztlUO-^ugWaGYe)+j@|XiZQ%#{_0~??^4-XH!;W3NSGWG-ooY^e_Ag&Q`Q1a|NG*<T z0%WwEnd=kKYdKf;wg`0d(P1|<rh3R=I*!e)XF!PV-7$a*UwZ+-{)1q}M|C=8{xC>) z>UK^c%&>i-UvDSyRm6GDhNTiA4~v+RKzvn?g9Jp~p%eLuKxHR!Mg&zOp?e{4+6Jg) zTdu!6IGurTZrCFtcX^+Pbj$RD=+Vh($Fb*L&|Z2(B;2F9>v!9Bp7X*F+#qUM=FIgw zwv~&bKndOLwjBZ%hp&p;(rww7cSkdI6y3X{6P3+lP><?LbGEI=uSfk(>&V|olK|W5 zx!x@DGpDBkFddc4?i~^TwFY`?pf69$PLQUc(BoHKRTpY4=<gI0Q7Wkx3i1=7W5|sC zTQ0beOM3j88_bjc+y7_&Q$KvM8ZM1<S?q6RxJR!n0hqa-W_kO(wqdyQ$}U9CBL#5( zbBiR(MIl*?h>{nx3U*UHJ!`o6&2$oYg0NFJm6HGKZS3}$9)th{kZpL*Ub(s_cS~<D zy3QMHKY0`Z`1WskK{F8+H>6>JH6-8p?Joh)Egis*{mB0Y;OBnf&xyP6<3IdgA=QA3 z^ko<&VlrL1S+X+2nXSQV9|gioEW_fkbh=os7-DP^8mc0+^IOBo!X;qPDN=%dG+P_1 zDJA>V51M(^Ggu{(tWwXAv!M-*!YW*@+kEP#9@ODj$r|hju@{B_97_kV3_>AbfTk%% z6CSQEGH%jXviwnYY)bAB8OB!?p=Gdl+10!0?w7%GB~m~uUr4RlC2WhBVU4Z;h#uWD zKxow$BJQoC5C}<}8K&NpH7+zWbW6*#yw)fdgxIZ2>1an;pp;!f{dS9)-5_jmN^+eV zFV4N>o&+kWl~gMz!{t?oRuOs^_pClmMv`W6n$_aaBxlk=Wwb3pym=)dT%zR~o#qh8 zVd<@%9M`GB(K`zEE2nMxZph4{5?tZ_q?n%2Yy%dIBYDnMg1j5)Q&l7q@^x|<E={a_ zGQD97qWs*c6QtumIvR9Z3^}viXw|KFQRH=%$rhln#^y{6&Y4@L5k&F9>8xd&ei(}) zLXnDK><xQ4v+D<yaea7n+G{zxgC2Ok@B<<;x1L*^-YSD;q9Se{UD~0C$EUrPz4U_9 zg{ygs!KmLaBW5CU{g4QYX~0ypSF!)7_IIg4Q(;UqqpQfX{MiuTv%jD>n5?Mm7!-<@ z)yj<renOB*Z@fu8qWDjdv>Z0Zuk?l&_hm>gyy=AqUmmrG>8NkcMR>Za(@iDx!<9Q2 z1Q9k-QLZL$h5ZPt3^P5!@}6-r4Gc4nx^3~NAC%0rrXI!dYBE^1EX}p&Mm+%2r2qu6 zW#|lqrOtM<4|&Brv-~E>9nHLc!bG&Pf~AyhWrj;Lwqnp4W|(SHiAGazIqEVDD!iK) z#Exx9S?b1?Mt2X<DHy|Uiy5LODh^n4Vif(SU|P+V11sXl&9km@zI6tjWsL<!iSLya zq-h1?T?57h&Q=Ahr)krpU<PN8gQQjVM{&daD+;O8l=rkEF<v!y?HKzDSF=<OB9X00 zk}OwD=Df1Rj%k9h)$dTnIz3$g*d6w~Fa+p$ItOs$;+~kn33%<%A&A<ZFYZKDffo5j zmXO5av#IM|7<F5=A4UKjOlAbMY>NOdjM}!vWsJM@B4Ob6hP?{dwe*8^e8|EJvYanJ zvvvQ!oL~p7t`&ue^C%;beo@jUnugle4PXkO?N}GLhWX1j0PU5Kfs0#%LYN-(@Z_}X zI0P*GK(K08K=EFzjfQQ{KN!4s3%J;RkkiBbl?MkGzxF~kP}i~7e~tiVe{j<O;I`8- zFMs3Z#UGBV#vuZ<ajIN30i;QmrMbxDM}A^XGXPm97w%VF$r#^uqaG2UXo`NAaL+t; zqEw+dQl+crSsqbhZ<|q&kOPouMOsXlX&HgkEi=n<!_q;(I7>R(m||+1hNXvo9N?~U z!N}6=upL5x8LwIo;l*K!T{Y1X^t4kgrLGlQ+A(4!v*(>0K-N{m+e-lbmMwA#dfO3C zaNPpA-3CC~Y^luf7j+mUfYxWFpcNujD$$%deOsz{`Mh~u=8L=x!1sOgc7LySiJY#U z#AlLliDEY8Z)~9aMcV4>QIN@7rtzlJ44+^PNl_^BbIl;#e48z>Xmb*U22*)cJ4O<R zw&}bHl|#c;h#=%9!^M;G-5>s^U)+F9vd?Waz?<#sx@2Buo+b;onn!F?w@qCx8p}IM zyiQHlMTV&xVNxKUCreMPA9PyOtR*)IJ9wi95JV9JS9c^C%t>*t{cx2;%@`F-H{NNH zNp9IiFnWH}uXvNH3g5x$OxTI@TLW<e&Z94G#^do+SirW(5E5KJtjzG#6?`4o>35H& zi&c-O$);SjN^iPAIc;6vM1lGyf)^YLquU?#6e^}sBHVmf;Jwdn4MfmanSm<4=S3*7 zW<onDu+7%abA=P(Jrv>frJW%WJrsoAQtR{Xu;=<msk1BD`Z|F2myx+->>AwAqhNKC zCflS=G5~C8EHRO#acXz0C`dF#l|2#lf|UR!T5*^-1X6SWzF_w5X_jNmk;P#m=ri@6 z1K=nQU<2URpsQ%g5rqJRK47QS2N2nX!#_X03Bb8*GDy$#qAIfp^DM_nQaW8FH4`<o zo8)k?Eb*5mb6!bZRHPpO5S`N$XaJ&c2^1|K{zcV(*yxstlT_#2od#lryeY6KYT;B+ ze^jM$NNz;oODz4+4Z`K`JUln*&xj!M^U^Z+{MIrOmRK}Y9R9(<^}l>IFVA@P@sn$N z+Yb(0p?^$(x&2IZ?+yT+5UH`s02Q2B0G6}Bp63KgcQm>kk*HjehPUYe0Du5VL_t){ zeE@<y%jJ}F&NBwFVHt78BJ5L-627W~A(SnOJhn!HM4E^cO;J<=Q4}P)SpcI<Tg}o; zK>F3k5kIQ~h=RDc)v{aW<Y*~sAH@cmqNucUv48)SBasrY-`N8&|F|!tOV?4wagf=% zwq|q~KpbZAK_;25+%IisD3=MTwrcJyc6vH97AFya;d!g5DKa!u5oFF*O9SxurVBx` zVI$9Zvfr?QLVr+f10eEN4MSoiFyPK&-BPQ5Wf8<@IRo(LiQU%nybyAz4keDfGMv3z zpVI1B1jAM!_}U0r&S{ieowt!FGH{EVtQ)GhmSB;n8tIlvYU4)~dD)jd%H5JgtgvO% zWb2}(XgYv@@@uaH_^BU!{-=KN)gSoV*U|)_6u=MvohxS@O|uMRWtOiU-X}uY8`)3E zMg&npfQU*#6t04wxv6W^IL4YOjm0)$6a!>NF#uZ}dDA)bMx~^ua4*ijz=AW0<-Sq^ z$=X8|$w<X8RZ$H~Nokf?s(1R`<M{$890J=k<O^A+6md+wx=;S%&^8Rn^h^~No2bG^ zafvyqU{N)9CO23pQKbZULsGiY@>|FM)y`ESz98Hxnt=VI-muqo?AIS1W<yOj(#(vb zC?9C)<Dg?(0m6!>MSQO)l%=_7Je8yh0Ol;sg<H+sNNI?Sv!n<q{eKBLMx#TxVsNZf z7Al&mBK9YV_8AiNMm=YNna3$J{2+2H6I4{4MS1{)!^yl#Jap`$D{1KmRC{yizjv$k zAQvI{+GM~{n3|RbU~=qwJs1H4n2z1SRvUosK1h3_IgKBWCl}xVn7aPl3)*(k`y{Sr z;rc`*(8WbZcU3sAbHwPqf8;MC{zNF}y=#HtD^``1_LtG{gFBPoKOTO~j<EOd_~6w~ z{nytE$*!`ky7D{FByp|%6$Vo&T}&0!k1Kj@85+jm(2ogJu}>2r4pNy?yW-Q1G(|gz z0VvN~Nt_AkTxJAr48T0e>?<Y!MWHB2MtfZV(?2;0dk`d`+F=s!8X_z6`1aVo+M0z4 zJtb8W0gUdp!3+`Fibi3>R+te7S>$E9scxKnIA^i3P#KcL=rqpHnx?Flin2(oO9f+; zisKt8L4-Peo^qTveLFv6K-HBb+7L!p(!%mU`CI`&oowS+oYzOj+rOw<(F2)hockF7 zQFu<n7(nzEL9lg8;pPLWsJy@bn=gtN{rmpbMF3e^n`ub=&$1QN*58Ft#xp;C-JogJ zm{zm9RXx};i*C6vj!i>HlmAlw{j-b_FN3DSDofjkaboHkpREV{M2z=Z7%kZppe`O# z*^nbu{mMdNfpsqFEULaGk_}vK#8?8LaoO~&^)G`tm_2YT!w+MuiZZNLd&5v*zYQtc z;<_GNOtZAcb}5}naiO#d_Fgx`sOQ&;tcoR=cawrt#*9Omq`SkOi0MyJ%4U=?ndO1J zv}0S#al|V{ZAKC%nw#eiOAvKt0%uhi20_ZNTN;7lED?B7g-AqB1n?D2ypC~@fY2Sb z2nhY6zfSyU(<B2(Q57mz3h6))qA)>eA}S9r?vn;92HQRZa4dsB+x@PH*p7Jtk#h#Q zL3lKs6X?dp-7+IiuRS^(0N!OKeZ>Qyxr9;~5P)-|H`r?5{Gab$`r30VZ>#Ty0EQpf z0r2R~7?-WZtFyr}0<iSMbEAHd;tqmZq?Y;7@u_I3O0$Zcig(MN_@y88#ays;BgTVj ztQRhyTQ*03`Rc_9a(@{Kc-r8DJExyrYUqHmH|hcKynR6m)@#|XJ~$9rBG(VayR?`G z0!&|0SAxAqmv%=466}>+q0Cnc#we@R+^9F_)h5&|Jy#9$G9PyRGnyW|gPr#HU?Cif zN#!V%{@%H(!$+^5R70+}UOIh!alD#Ni~Y=BB<s^n;0j}@?NFbH9*3u-)FgQYr!;6i z&6uu<I&jk*%3LCGP~fj(FDq_}3Pn0^v#l2UujN@cT3oSI`fnAytD+xirIwEbK(cn8 z1#I|DBy`^j1FSbZfHeHlto|FYLkqT7xn(s8H*b0EU8BR-z22_*4}ba#Klu-y|EYiQ zLK^3tk?|ux{rMmK+s|BnM`yYpX`6<j^#@*UG%QsGtBoE<(=$w4-2vJ-oRo}<;)HAH zH8)i6SB`Z?YmxX_g>ho)4G*URzRH8|4Z5{KEM}j_rC(E&QoNwZgdd*PaZJlL%d~9) zot=AC{uZSvF6yRBFD#;;mIacG993c2s>yHWCt;h$R<B)M-FWUc)sJMu%)@Srg${vG zoA)D908rbq7`*U(agJ?!74N-h;Js@xhMr@~AP)lO$FGZxjFuzLf8mCp0$B>+^6p4{ z_}raGZXobw<~r-Wu`CnF)3myBE`2L&c!e3^qx(9*j^uzblR{~n>4ugah3KjqaC<9R zUMcG3+I=f5I8#IZxd19b)xLz%)oxWq4P7^pHSuhfTGGr)@;qk^j$7n=tFADCd&<lB zT_C(@#qB$roq++TV+l}ndtd{6^zozJ5A3dNcID4qtoX@tt~$Y`4zp%foJyl~a4Hhd zML)E0C*FCNKl?a9zzzVMZf6KH?OtqLEs|u@rRUmc_w9x2Z=nl7`-;wIfA<bEi$<(v z5Q<+)g+nHgAUqLqd9P)Q4~wIl01Qd};_~j+7fKE+5D9EHN^uMIBo<Fk$Um^iW8aAe z?G^}_`<RDB=(k(bN4|aTB>?`-FB(9o#Q;=>dJqE`e)SH3!A{%hnAwA3g6_9lJof<j z%c$RO4WDgQSTj;cJxW$8b-Jaxr<;Rfr>kcv16;}FGGlfa0tl8#fN3#<R}c(BT2*aX zw%Ms}D%~xU!R{nZBW?|Kfpe%%ERA!kspS_e69D=daNl&3mCYG>#zMF-I_6==o+))< z+X_uf(L6g`9|eG`1cI1ST?^3CW+^%j@>XBh4CQS_L8nO`x@mvU0+2<yZmU%Y{uZLZ z(l~E-EZq?rJ}@jJT&8K7fY9#Sc1H`A>EUhffB3ie0DSnnZn&rMKmEy<kMDa|-q922 z@$dcXSFgXP7rNQtys2$8YP7*3uM%TcVUArUu|Y7)E~X%go5I&J_H=XYwlXbYyz+8$ z#aah>_Z7|x={|2{oWN5fqtO_Q)<8y*m}`Zlse&V_F<=c=#4`7GEDFE`09)M-6UMVe z!xl;Va<Lx(jJj=R3_F-Cmh${v{YN$ZCr~G1Q8p*n(tBmiQuapbR^J+lCGxV=P-sMx zmxSx+o@8N1fERwyw#<gpA>CYSc!h(by;1M*bS`O3R8D240Lm;~$;dO1CaK}0(tFk> zDFCHw5)h=BIK3>dX@^D0kN|6v0Z6;K5U~)JK!_Qbwhlsi+Y^@;bs;DiLC}xN>RqSK zt4a^3FmdW7dx}JKzS53Pz@yA10$SAF=@alUTmlfhX4cjA(ZeY~)PbrgI9#ZjpdZ7d zc>u!6{%rKl!Rw!W48ZAFv$30Jxqi)gc<Ut3*xy-&zKs9)Sh-@m4?;+;(}k@*mFR?) zZ4tqblbSlDgzJeK=V3d-?Z{y!(KA-cGsw~f_IvxMx5q-8p+ZEL_;6X;7$qHa4Jj}4 zMqE>W*O+hs$n%_;_lAAX-v>y5lZo)k{ko$UL_7<`%Ud?}J|f`K?&!hMsdz9~_O|BB zdjPigwuYV7Ctte<;L5pe_mYymQY7KTnX88}UM}v2d82duaMteI)k~NrIe?4LZr!=# zKFzElg3;<`C8dR4t&EoMv!asS(V2O15)aOqEaFIpW-4ivwFf$Y$WH+nmTFkwteFDK zSWzi1gS@kfnn|1+mLj|XVHAr*@l46u83bX3jwr|gMh6qP$m{9fHzFSq0^o^hWFs>G zjJg(pP@<>y^x{ReI!cyt7G(C@Rs&X4RRP+4y$*ceKz;E`Tr^z?qc|$lAG1UMnfLY& zZ%5bORiu<|e_}Q`XZ_?qcwU@BXJiD+^o0+OzV`<|^G|>B<^5Z(suKXKtpd=5$(*}h zWnx9ke?{4fb%out>{+v=CyWw+%NjFJ1++>S>2;JdZ>HL4Si>?t3F8!JXfN=FCgCR< zTYf`3%v4shh@_%c!`2oV$`w(Ek_tmsCtCR_G8m&?2Y}}v0Z>gN5YM($@M++NrRm=^ zH2`6hcwyw2MkPzk4LRcyq1~(vOR_!KV1`$Sz?fvDHzbPd+6>qBzj5~}twz_6u<3oO zfJ?i>t`{6tWowz(Idmi4=e(n`uACV(a@{!2s~Z)kS$i!cp$<eYz1pg3FcVBB(*3ch z9gv%4xuQsFj}l(2d{K(nxpoAZC9<k!n^*Z{%Co8!EhJu)irlJru#a9pNt68Qi@N|t zVFF<3hdtQ4!yc6>ZUS1aDV%hD>-oj_CRKJ9U?{uq-ve;;hldA~*){YaJr1?B!IR@9 zMliy3cH#o)Z?^%&ajG)|cyxPw@tLhbte+s;>350f2=k>M3h=qHbz^z@I)JugUDz55 zVD{tjl)xp8Mvc>6`oU!BF(U_8oGPUnRo&f$6|R+XeJ*`yd@kLGTvC8I`J<!l_w5P> zF`<IY%<aA{zPj>_mjT@Rk9Tycpb;{Yd9j!+ts;qZdb(yPnxQCa#UEFUwHU{mRP?Ri z>AbehW=pLrzRVl-6_SWsgVh?QH%+o6FXnNBR)P+pd|}$kiW49l3+O=9_=y;aFrqeq z(?tNFW$6GcLpzEW0Ms>Q->MXvsxg40aE<G*nWVSdZ;bhUQ%j!LZ9u}0w7Xg{FK2An zDhU205eas~d215lmSyBQ?_O^OZfdtR)ASEscZu-m)#b$(I{U9Jw=dh>Z8KP=S)3EF zIEe(i*@wUDMzBmp{^RJbzkAI&eBC>f32V@4$@hEzbXNF8dSnaP25L-wD-n{+HC0Tt z#g9q!3pHl{+0sLqh+e68u67{dOc?aS^9$l!Lo;;!Y0T|Y`bOLc3M-Pw!k#rl-c@ZS zZtCADmEo#n?5KH#<$+G-LL|dj>F?#W+roes#pj1T0lqn!&V;EH9gXFcD*D#5;>5hu z*Tt#|^?G4zAl8VfvxIZgh3!FcIokzr`q9ZmTyNKL04#z)T+MVT7?rUz=n8}32Vu*y zAO+}R>6Dpp_w>H*m`$+>24iQ?ZClps2gf_T&hcy^-<Iq+bWD?j$gvFGL_I1y1Qpy& zs@5~fww6my&8oIt5pPMU;!<*{GTNMFtfW~AD5_F5D;MGlc@84O(g+k~1%{jyQIL)a z;H$b^jRp|;aV0!O;3UqdB-vgsMRRRJ`Q8@~ufB9nz6;591Au-fE>q~$$>)uFDzCCm z`pc-@wE(yX0bJZ}qclzc+I`!d1%{=GH5Z@R!ZWz_AMe;Vy8bc}qZ~|TBHG>?7MvtY z_knI1MC1k0qmu~{I*z^Yd=RyZw}qIoaD5PjR0D&Te&7WW2!e;Q>Hwa5L4{cmHXB5X zqt}eK%}nz`!<eq@jP4zcXRZ&R<JhMQSCHZOm(}AxJiPjsuH5@i_jlgEH$7fD9kb%e zsiOQV-*{PE<GE44{nbMNxBln57q<tK*_lCb)#+A~))K&&%N61kN~1HtDo$5pM(C!R zp@@QO5@o8cBtcG_+Hf_UR9(&Um18l^=noO<K<OBYLU}6#cw6lp#fvT+0A8A)*|s}L zJz#}f;z`SeRu4cBrvQ>90}xqB<fnNCRj0R#hceF<5LA^wP!(huJ8jc!E1{cIr0yVO zRN%=0C{J&B>5bE*r;maczJ4@)9Hw#Zj$`5LbcTjzD8Vw#G9H{W#gWF31H)FI`O5yu zJzvx;vW%IzH83<o3Ej+WYuXcNE6!qb^o#Jjcq6n<F$<*2gY|by#?&-kk+s@z7!~ab zmZ8%+KL<9Ut~Y_GnGwawsH77if>(AQ9nFfuaH}M~5MPl*l2t8k5UoF+-BGu?b}_2w zM>V!pqW>k(!FX2Pr><iOV<u7pBFsHmENjtamMyJ3|HF?H0A>`)t--SDA7d@IS0wDD zlii49rkdZoI`b+-=G9Fl5NjRKkqq3DJBZvMG)C6}@+P;}Un;SU=Z9^}*c<i^Co{Rd zN_=jaCIg-qRr$)g1^J|Kx6Q5V0K$8BP|$vX2(gxcpn{1>Jx;1b6f?UeGqBh_+tCR~ z?s!7Ipm3-b9sn%LRv7?<6P8>a0piVaW~fP)>T0b=%q&O4@{^UR!DKPziWs_pT~qlu z*GkbVO@X&Rx1VQuZ>!aMrt2?4e-SETVmfaFShjKyq9CE{mU+Pdfg)7_1ghrraG~jn zeWR15`Sf^cSQ>~zF9K-)?kN$nGzY<(hr^vtyKhfFaiYI>Yp~PymLY*|{FUpEZjS+M zzi%h`g9F<(h{zA4gVWiSZ@dJ+{a<G-+Y&Cr;H$PC{>~$2?2Y=O8QSwh3Fb!+k4}4S zn+bb^-Vx>iDt1qE>$&CWt+s6uaB+KB_4{4g9@6&k;mL%+otC}yLjnsCh{COR3lRta zz<mKj`-<zAUOAo!_u}%-=nx5j_=4W=n6l3yH+SWAIzj?8Icl&-DhyQQH>RT1gm5|G zDXL<3G-g&c1>ji9IipNst6EVM0H9kcxBxVzaa|24vcbIC?O}Cvai}a|fK`>aLQ!!U z2ir&)NMOc#Xk|ULyf6l^)pG!ZQ3{}K832-H3gFyUw^}b2LBJqrkt|aKa60#aCJzPy zKpbYIkm&Ol2?KrmOEJSTx+;$$ELpY2ccZ{vi>r8DY2vL}UikV^xJ(D<t-wtmeqp(N z$sX=mR#yWfT&9;^>`wPX0H^!G)&+a}suL{J_Q-hn#l_Yor?+Fyj>68!01zzG!8vOK z2up6Sc>`<Q{6_7Z3zrA$6YV;@dF|zVf>08exgyy>mB>8<yevhYlBUQ8Tr{ukwt*db z^@M0uq=BRaal_;l_1u!aqvXk2!7>9F&)vc##}OEoKsB#&gfXuXcM7n&X=vh@N7Ff^ z`X4bwLQ?pI1T6hW;yc4K#MI{nkqF`+pUw)bnPU=2fU}4&b$vx<+>waD#5P^Wu9=uh zh?$(MtDJ<EWr$AY<LP{ZwiYuO%P<1qSjNH+WxXqLFO)@Q^v)qV9dz5FB#pHRu~#?1 z)Gc9<QWFLJHOVpsn<4J<5vcYJs*-~^11-stC<Q?sr$nH(Nrbd2NT+#49v1ou2<9Xs zAd{-mag>UUO<M<1dfRQ3q5<tFA%J>qj~Cp`fixiSMHRoIBqxd1x=LqLnZT`oVs*iz z?9r;S2=`w-8trxUXWD1{{Q2Am_ZFX;ls#{azU0c7v6NM=TEm6MSBXS0xP*q$-mohO zMV9UZ!9xkc!;?wJu|zc7cD?GV=UyPf*_`>_;aHqNB?18e3pgL#25|3ij9q20(*f|H z<G1ec(hH0mHN-^tXFKmJSOhw@#haRd;vm~WFX)AeD!14H;Kevz<$|bScy%_ouIQ$# z)EUe`p1|s;^~A(Dcj=t6AKeee0INndrxD78HZ#Y5VI~y?U=qP`malR#^b{w_GC69% z*>uh8>*Y0am(2Ql`Z5gP3Z!}CS-pX6rMHWG+UjUvJpAHvuxqAqt{KXM&n=(-;2>P4 z6(?wK%bcA=+gBaCquu}fVz6svajqK5xo6uCzp%LR{$a38LpLo_&{})Dx{x5MtG~8s zoMmolqebNvgH^|?6((!YcH}pD>Uw;J&Tzvn(`wY)YdH-_F#FQ3w8_|3M<Q%;0#-eT z^~>Ut3QC@!*BB`4GGcT5h6=s3j#n5G!ORG1VlNEZEg=qH16Nk+=4Jg^e5DBTY6%Kk z3o}zw5`q9Jmo6(hNL91aspVDwL#}5EBX>NRi@$e<T>w+5@Ga-$_lCXQ0gk3~$Flq| zV%cw!W8X01hNyIX56^EEdh)Kn4`8@8fJDCi>ix$6o!cG|$SwFr%2eSzkhA{UNeaN) zeVzb#4@If_^6nN9?jMeUIv=1fg0NL%<s_*>RF(^J`<&bt&hpc)yRfU;a8;|Q?>d)- z53VGB3nW6G=FAdprg*%9$kSE<<RJqE#h7{&g9ul22BI(_P<P}22>nFS6awU=w^*Zy zq_-eKVg^`9FAyjW6W!88L$DQIiNhn^(g5_{Gur=ygO+8CXGQPQ<-d683;)xtYu|9$ z0#5(<<nq^F1Tg)RaWyd#aK5Y!Gox*rUXWDIgAi9Hszs>E6i;Q>8wySp0z8-2U=1=5 z>?%!L$2qeiS>GfsY?z3KwXGYA@vWv;2>|XSb`j%f<Gl4GYr${)9f4WVq!uFvfcv)| zoizZjuiZq1V5FL5=wY0Y37NC8XuVTa0C5@tFg3M0we|H)GhC<tqBxT#3woog-Mmzl z+A}d<<<F`<=mwiq)8xM8M)>5OzkSsS-1O2*o%^3z>|S%Mu6FsIo!9?ldg1v_5gaem zyPukGU$(`@J6D{0pPlbsYYB|>rI)+6KRLbdTqjtj+6Lf^bjF2-AdyvQEnr>{K%(Dq z(8L^VcnekyS<}La<Fs2d_8}600D}dUM<eRp_<tKhRc4T>X^aNxRh4iS9E2M){l^V< zDnRPnk%#btsOdOXj19CWn6sq$<zO<aHWWOC01hT|0G4ThF<C4N7pJ}^84Fxb?t@NC z{8e>n^O|c=z5EhLyTM&eXqe#wSq9k*m&wyce{iGMxw*bBZ=*p#U4&eE@ECw@8D1D4 zP3BeasZ^b1W?uNg?x4q$8KhFTtXkw)Ccxf&-!V;YR!ue*)Ff);+FdEMjwCJ>$sghh zrA5qZ1a8Fzo@d7mBW4bwENRvCdk`tdF#vP>83MxlcL3<s#H1w<!k+~7I4Mqt$ejfs zvSvAeO6?%ok5J{k7lI`!0znA+o|JQ~lI5w$sFd}927finc6=ps&NaD8mFSjH47A#> zC0@#d`=>p(1z`JPUu-yuZ{iVdy!!%x+n?K~b4F(C!wWS7UGMoqp<TaT)Pv0DI|R(e z9ub_5`7m{fs5?>g?dKLJH<@6YMi9mz9GuQYN0T4MZO5$on;9(1%z4gU5K^IKzz>g4 zMVnKnWiPz|!2QFq_}qHe0A+cinB2nzfMMw;oh3SIUZTu)F7+SZ9?LJ1=HAyW18xI^ z<<FC%k$2NVn`&&EP0-5RTZNNN#_0-!&>TRDh2-CU=`+e%C^IumT@8`cYYV?zrh1lh zU3D0H)_Ra!d0V}<ViRR8On#!#eVT=orloxf^6R&JIl1S9p&81RcXc0rVR`B04gf_X zNh5M$ch#eN{_a)h<esk@%GIyv36z%DM%4;vx^~99P`YB(B(xbgzyPu;?Od4$f-MkL zEC+T#v$ETS&8{M?OkJOQzF4(4?6M?wyYPJZ1X#i-VPj76Ex!NF{Bud;SgHD<5qj1v zKWNDL6*tu{ctwf}nJm15>Wg_J-fHDh&0Jp)n~ZwxB7qUcA{rLnh9f$d34!QuCbVo* z5)WVogsQx_7J^`qP-+M$lN*N8Z@(4*cswpNwz{RHyknWA>myY~%X_j60$0cu1!1Al zE0s-)s&Ehk&<0oh>HS9fprr2zqj=D5FN08=&(aT2Di_Vl7ef$m7A?!3FA<6sN9z?p z9&u4LFWXYZL^dx(glrI9-Q5zi(5G)ds7aw2`XVRIVn(J1>!&GuFjZy0nF+6YiKQwG zq4txgmbj3}!z(T;Fj$SVOjY72B~Ym?XaJNZ84+b^UOr`neoTNl$v~8KG9gJ6*DY98 z(wk7izC{03*kJ(I-f`~rPd^q0`_ZkFi#N6bTzGct@vRfdPvJE+YX;!7O#suQB>=<L zt8dCX#XiMqo{M+D3nRxei7=imQ3f!Fr$u?CZClJ(`a#9^b$(RG&_rn2*1`=sEepWo zlj({P^p{b^cGBN&%P6xrOyo5Hgi_>m3(iSnT8W>6-eL7^<1^+VI(vGeGmlp7QtvI@ zc4`3mi+PBue+!`nB7l_QHy$SmfZ4*sCUJq)lrkU~7sTiB%-_6MwJ&WphH`-WCh^Hn zm01?s<e9qntOFoeWN{q6$$9=vMvjw*!L@hy0ECP5x%UrV`=hC-0^I!g^!X1AZhvZa z>7_1!{nuRp-ZI&}+6tEGjjtZO_J@;8FLn1{bBS>ObMq_j>}g?=08lZ{^xl_Xg|ImT z4WsNeisA&2d1eqq$vT}RuR^PsSF^z^H43Ky8(JdADXOy#AoIp6`))q@r@6qhR}pP6 z!wvO?+GaA<JJd66?JUrW?@>^F*@j*vSHdVU4Q-`Zz9F++wIMZvydt?-7pF_{cr^Ql z>vrclaHJBARnjrmo>L9il54|UwjUo)7s40|blW<teHjGI@WQAiHsHDus6v-Hrn%K? zGh;koj=F7unBzwIa)Vcb1|3J8vXUM}?H@Ecvg&kqm342jCpOX(#R)r^L4?t;O+>E0 zPrzU_5cXS46|dai2XJ9~SZg4P|IGrF(Xe(>BsT2b7eHX|Au+D(ZUMM|G_K0G`Z5R{ zIj6mf!jpqu3CShh3b|pIB@U@_WuXsU*7d8L%(L&laP(j*a^1qF`fgO+O_As}o_A1c z7&~n<OLMU$fHcm89xy<HHd06s5}+}nlh>AhsI~OU!*EPvt0&|%h-ZtvVUGxI5FJnF zm5Ro#M~5w|095N+&k@n$<faIY0dySe{MKM`v9`Wdf3xTV?moh_jEnXAiEkCw_rfz< z{xX_&W8*MKM=@XS@*f?D>s+T+e&gBuiE|2n+3^9PS!<=b8Y0EJ;*};4sfrTDDFK>F zw2JU(n7Goc)+yz}^sRl~U>L<V%{)PCpnmzBlux$4s-m?9hM*krW^o**4?e$m{sTh* z@fdH(a(q7^!o5!~Ui`XYwes>iI(I)cHyri#Pt2ZuZ-2TUrg7dK7$*;c)=;k^W3#0N z%k=zn?ePPj6uSSpxmJnVs7Zkk4mZ6-^yZ8go&a(J5X6aWbb2kDOVnbwWixmK0<1Pz zj8*l$dPB7}io7uxj!Xkm4&_(^ij19pclEY%k%HbC6kmB^eJ75mOY!Wlo!eP?_3!K- zi?0Mpmh_5{HhQ*7-MHghg+nMCjFpBhY-n>WsJ^14THkLMbW}6fUl$;%ZWT4iFza-2 zH7hsUUaP>IBnr;54;ZyaA)Ddax=YT8MD)QWVX^^<VhmD$FiJj%qlxG^qV0YM%oDB? z(N*Ku#qHtg!Zi)u3u8-H-*9G=Q*}j}y)?rs?O~FsD*MVxGh7xIi5ps0j7D=9N#*$s z!7Y_e3)iYulJI3!7@)ESP{Nlgj??OmKabYZ50_db9;Kc!9mgP8Th9O#-n$Jd(yft} z5J=o6^*BaBtWw~N>{*`e=m3&Co0Hzd_w52$zH(IE+}+Cq01sY0E`CjIv(Y`*d~<y_ zs=gIlUVU-z;NFDf5_d^x8t<qUwc;>ER|!<kGX}J2D<wh{q_m@*I&l(bFyRb3kKw7B zs%c8^rQtHoiC|b7=+S)aIhRZ#Ow)`AiqARcf@)%A5s~iHSbDb>=SO|)z}qFv0>jdj z$FaXtSYkH_4MFw901yY+6Ee?Vf>oCM*SBinwd2*vV<LgCrUD{Ng&gYXoKVKKaZ-C2 zrXhZ|(aJGRt-htPXwZ-*TX9Tr98$>Xy~WHM>)7TzRlsc6s@2s2w!0dDyPuw2dv{-a z_~P%LzVvmY`CDXwpZUrjfZLy(fAM!tU;6sdE5CcXb<qwN=}TWfy7$@n)vxGH_d~0r z0eJN4^4fcP03Li{arx!$7k~G3`=Xu2d9X|`zSMp2`T3Q1_OvIO)H>6_^-~e|nktmg zpzR3TDbIwwaT1i~ad`~czRumiG&J#c>aCIZB8Yurs@7uzcDin0c`~N@&ArP{JVFx! zh81yEB3bjMj)vuP7QnP&w}q1Fc*4s-E`IYWYMQBLW9qeScG=W5X82)T5R+MkcumJM zw?_R+5G}ddEp}<!cFo-ZA+p<`qO6W^zLcyNLp&arM{vpt_vy?w%^-@<z#XB|0NCye zFfDs>+x}XkjusqfhVIAl$=tO~Lu!95ZsmnhU!27LcnZL4&}zciehz?p@*04SQ)C@4 zZVypn!XJ$%!U|s68305(AmHKgM7S-TR>2Oz3?bwPz|b_#Sv6Wo<boS0DiDj%R?u*^ zY!jfFR|IDr$F7((1TSOVpUu>5*|Or+{O~3b^p;a+!rKl3S9Z6E@R{2W#h9uKQjARV zE4uGGYh5O~Ws6_Y$FRgi!fU@uIq6-!fehUK?0%N!&wb@Z0GD5=eb6k)eOD+GgGf+j zqB6SIUfO$b^Z4@fI{>b}v<D!);{u4fBwC+EmYdsp$(&yNN*aZENkW)v{!ng`oK(&E z@-94ceGLV8TeLFQmLp66v~Bb8c)A-Ffv{oeM_$ka;xHNPbg<K@woK1vOXf4p!x`H@ z^?da70HT6(@r)f5LY$;jMZ%1RPN^KqzRAxUzLk#omRnzOXwx>5ICnZ4fH=xjMG5`d zZ?HSs7k}sUrLW(bJPy++-@4#T4ujV}F>8<B8c!!!q-m1xT(;+@@vFZ-*}7<-JPcm? z`q6Yh+`ZlcV0ARRqrLKblNY~sIN1-gIFG~ZmES+zzGzPl!^<ys?T$9t4|lG%AfO=| z{G~TGUsX0%SOTZq(Gdrkx&@S4n3E<g<%$7gNz16QeuY!ABET|q4UCG)SgIyIZAOQm zEQ9o<AI~b6N0WJ~Q6iOM(MqAAw%2QCQylyJXu!-t9CJxga&FY0E_^ib(lwZRg#?7F z#*VtmE^~%7NPU`R1d^JA<rH*%gcWuz$Yxf`ciW~hp1D<!e==LPEJHq7)PU;ZTgNiJ zFa~5s{<^yFN3j`2;?FRO%}t6}>yL@oS4#BAB_ykUY%)P~`IX#uROEG4z2y)ASVmPP zlWJHpRzU46+vz5Xt*(4G6}Qm9pL6{qVW}aFneEH~VQbVOpw501`Yi_{^-Z|2Jp{_s zx0rxuzIe7G?``is4-k6~LAboTMOD%p0I-`{he{wny7k|Y??&=3<LD0#)GN;A=XL;G zetzff7Y+ejdwCCy$4@L_@x&$OITN5;YLw+9bgu~NQA|X9MUR67MBSl7gwRg}bxD$B zC07Zlnxd$R5G5o4JL*B;E4KpxS(=-U;Vlsd2>`>^6Vce(1$E8w!CWB57ZcCC);@kT z6G;No(eo?^aP9faxF3OVGF?1-VOJ<FzyA10;4X<MX<bRiuZ<V3n2v-j^tC^KS*Sk5 zVcOqn19*IA3}CR+Za-l6G69$#yBDr+0eJAAAF5Yv0Lz=Rj$?OhOT?^h5Q=>J!Vh{a zhk!6ijjbE$>FX#PqxZ)%@qvgQpG>+fXXyvMw&O>!7epP$e&yk#YQCzxF-=p1FI_6) ztfrksbW65btrxy*Ja?;YI*y4ldR_!Y8zBHo*8vErhPQSxEM0B_)^tVH$Yj-DBvx0O zJPuFp`7eF_C|IV$3s$g9?|*i#s5Crhzxf*Q=4Eif3YY2q&o32~cCR`R?b?9V)$F!b zgvGye`l2|8^H#7-XD89_)t2}HK73{I-1~-hN3+`6-A~Unaqpred1K?V(LzgRuZow} zC&wsGx-F-)qs3UJq^7yjX0mR68wux4h_KWvQVil+Y^z^=Rk3YUd##gfZ1)QV)=I3` zsZr2m4ho_2Ww>0q2`$SI?_vqD#_pge>|H#*UELHB8-ZY(CIdkfS1N?7VDT03D!`0> z#};c3Cv#JaSLjWct30U`cUKAo&7|}SWLkQ5Z)}F^0&?AfTGW$S8Whc}1{hu#JC;$Q z(*>#-Qe<2ispHwwHgrFZExl0OW2wET3Wpw#XYzwMw>6NT=E8djz_6{#_5gTvG6jiA zgce>Pc5d4~)q)vCQd)GHir7?EdSWTV!px(#&df_cQ&eiavN8$}O+#L$t1B}sC#4Az zbiJ7gXXz+h^&UwQ5^@&3BykkY%XPOiBzY97wHH~^=&FBZ=@*s&Mqjf#0zUhDcNmx+ zH{_9=wrNbWm0zNWhTT~xRf4l;-*w^sf4UFg%3rzy;KBd$0AN~#{dNn4MIOgdMu0X> z0nk-5OL7phG^-#Iksq7W96;911b!$E6A+np&7%_aL>m?9hY5gWPsfVez-t{8-00_% zJg1dL{Gt+J^e@i+g|LV%%RCs*&W-vEj!teagU~h&0(L*Jm%r-q3;<ePD-Kf;c?%^g zu^e_HOkvpCh3i{ledWJg{`!lPKN&Cmpx|^OoZlKKM9f7eMYpZE?gQO2{2+RCGHE;3 z-1A$uDN;K*^W5{hj-BVc^g?6%#^UsKqPlV2)U`CrvYe?Z<6;%td<LFs<=@rqWwp(> z4}q-d%Ir9*v@WccmPA<+WkQ!?>yn)W`JGSBu773!_9v(3Z*;DFMR)(E`z8i>12H7L z_J`BUFLkcGqx0a4#m}L?ZM^nJQvlDsZ*cCJ*2z78>ymxzk0v+XH@x*nlZ!8QtM_fN zYqdwltv{Lqc=oFY{atH=7(-MV$f{`sRErB$>Hby8*g7EGaPm)%SHd`9pxY`^g(6MI zfPw{pOz$*)JWbOBoPm9QlPIjGpt?TuP%I_wsxX&|+F((8lrT`metr~-orN5s_yzXc zEg4T+-(x9}FQ?zt)^_L}gJBy6RlP(6fF08$!d9<MQihX2C$nO9-|cq`0i_@o-yTor z1Uz$L7cvlo@cN@8vE|&hAQidwt>+4nsPWD6N8Tv=*J7~TcuvA4Dk|}_h47lC3TqwY ziAK17r^SUz$5RSzoVitPts3BYT5VXW1LCF{G}o#EGAL_z&?Tb72?~=>bx0xd;mh%@ z()`!Sa0ud0#>Jh1m=G@l1bTRKx{?V$bv*)fkp|b>2q%@x(#(EaV4evXVB4<fIObj; z=Nt*>whPUx`O!@f8D-KNK(FP13JBN~0MHGMJYU5h`EFEQe&@vjO2D(+HBoJ|Vh5?z ztFGOd3iVy%$|T2wo0{K^2T=MDOj46Jz?|o7*&2W-WP$nBP7((Ak|vl>+C3ZKC`d#E zoTa&<61ZrgR#Xx+!n0FX=_z@Z6HTI)5d{em%w5}#^f{#fsY9bphN`JVm>w<6^Lpoe z|KRSa)3E?}^SVBg-w&|UmhWL4rU16zzjOD$JOELvYY82#iqI)9H4!<_K{WS*AdFkK zDG0@wd3V?sZPQ*53gPO9CzD>w-W_(A?gPExav)WqEN4}%t)>{F+cE(x{0KnTF#$NH z2GG(ps<$*w^A*e6vJ3#rAO>I=>t^`vvcUiJUqATazjG-rD*}giT&JsRhDr*?_x+t~ zt<!@5j4%Gqc<X|*Jc%_^Isbh7_MgnQuD&%~n1fw&c^YfFa`~ms?N83Ge`P;hq@3~d z9~=g5(FA<wlQRHc_^;!gD~@{_UwpAEd;&q!k>~u}`-h=hFkv-<u66Hl-S~;6QYb2D zi6ktYy^?Tln93E#s;c_AVp;1g)npNE0$Q7zwqku(Dfqu!>&j2PQi^_v8gxT78CDHW z<W*5ZDW43?mL3D5;H|f|0rn%08MdkO8W*&TMw0@WTA;XoxQzg)>iR_;wsNy$N>&Lj zM=8G&->|GK%*}2v$I`cZozm-AZ1=k-Gbwo>UACB8{W!4=9gOk9UE#@YYzILn9&eYj zn8NUgN^rYmw-zgl+C=%t1WHcK{z7r2x=J?)P!ai-UB3^HPlYuS>++nTHae!H&LFPr zGL;6rOlK1dG27Z9DbZE6>4DT3Mx{ZKz+8j|5e3+>OjFkueulbdNqP!Y!|d{c;972i zVwT>D(t=5REX9so`CwPS@gjivAC5ufZq+}57p|ONuKg4`j?MGHody8f16w4zul}Vg z0A_!1A}6|Qk;Ic2AZzP7K;iw{1^`f`B?Q4I3iUV<x2$3k&9*gwl6@CM13@7$_h}IV zBzmSFN4_>rm8&LzEX}ekuU>^XNX%IdAaCaY6h#pkX~WdgM?Qe01ptbw2(7LDJ9>+W zSDSoMY0g=G2g;lR$-aVIToZ<tnZ*YHhNX!DvsfI<+#U4XAYBIGvln)SUe~S1M=i@F zf;PIbIDL&kL7WiL;bcxg+p%)yr5{jf^Db@;L{hqCnKLi&!>DarhOQ=QPUQ<$#i&iR zv-Iy1*JC{lZfw&C&))LohyKnb0J=frM?p<aOQ4cG%W7-AEfc`xAh_^+2jF0lz2nbs z9p0P2B`0uv&wu8<eE`8Cefb-<KL20F;!l)n6SqG(({x2-r;i`{mtX1z%k<@M*n0I3 zCRg6keei{axJ6|jFmFyPpJ{m3+K;OLt3sea=m|2j$m0QEssih#x!lAR{iKf-D?<HE zoMg;gVQs{(!j~{U6)DG7zaw6b3IQZyuWHJM1du+OEh?WvL(%W(pZ#DQtI!Pg!bnVG zyTfi3ckZGHH(%dBS&8BrurdiET3L0mfe4gEd$gG50A%j5RE1@dn42V=5U7%psEWj^ zxyS<Z+@KMl8q2#`VTlVt1DOs?YVEC`2Q%BIe!B3k>=Z-|_m5Av<R{B$XbUk<7A}O_ zA=iCZbPK<vrLdG`Y};g}EJNP9ykE04x<SYsGB{2$$1<d*TpSA06(Rt8gKjm25z$iQ z!z~j;UJ!!m@meyx?fTOECW-*G@B#ulExS%;bEC(I!K$JN&e21j*KJM$HMad6ftKUf z2oTY51BP}oxwJDP!o_VO!o%YUL>7v$^g<9OOBWy&b-1=H<UNWXS{x>)+Xz0nAi#R5 zZYwARfXhYnWJ|9C=1U)he#<G4W&8UqaeCEGd0jh)gz6X3bIr0+{86_CR@`8y1rRsQ zFH&3CSz<5s?^H9?JWK&73JEq9T+yO1A)q^S!XQCGJ;rI07FrsrqNoZ1aS-j_InA@2 zh^$N2>HZu9%Q2201md(cO;L5#zR{khiJ|Jd@7Z~D>K46H?cTx7>E5s(o!k`Y$n)C+ z1;osI!=4*PC)35V7k3p95#4%xICXs@Xj?ZHC$EJ`N`%AH8P&4nwfQ7qx(rbI`VGh> z0f4Ei0HP#C86|U`p#=1ZZN&O=`O`>2SBt6<DT>|Ek}$J7+T<WK9TmXdwN|i9(<tu_ z%{!l*z5M4!Z|%4{SDgp1ET4N{QS;ip;ynD~Qqf2>0YCV{!gQ32FLc9Yn#TEX*Ao02 z0L)f?cz0$v0C4YfMZr`Pq!v~04M1oW<;<r^;+}P%d6l_i?Y#!VG!s8I1-T4`HFS-b zs<JfJfYfKvcgSABmpny(Idl73n`|8~R@16DHGxeN<X<AoY8g5U--YF-O~^zeYcmMA zEE)7m99$5^G9$DbL@RjaDk*(jdKfL!6h_<VT?Aq2FXR*wm9Sm{j!IFiy-}ZmczjD7 z)D_hEfMc6Msny{IWsh(D;2P*NF`;PvOaAO3DxaWHiR9`=gi#Deuj4Qmt<vjHdV^21 z&OP4D#|SfA-R6cFmOP=#->9ORB+HUCV`fv=lPoK$wp`026{Mt95u2zs4OI1Rl^`%~ zieAV8G$0d=vE1w=6@=x@Dz!dH2CN8br8h^G<CQAGRJKAjQd8C8-B)LVOIi8_uJAk6 zv`y|bP{0By4aw)L8`VI9niNEyzfXk{unnSD@9%>Oy2{eA5C}42LIXkOKLoQ-1+D<+ zbR1h-*TZ{vKrldpk4yyvP{&16pTCFzn2S6gX#moPzVK_=4FJGR3fNJc5>c9D0MevT zX9)eoEET3jep`gImTe@rT>_$>#N&O=hy*{VLdsD>1iqq2VOn9z6ioqB5@%(rG?m6X zX<6pd56_SKf&%Ptx*%Yy-#MJjTefNRFV4M%aH?9Cc`%;tjr!5?&1Dc?*cvKC%!_5{ z3kbBLDqz+%HBYk2E0=4xB#~4$3&He+e~WF_j_|fFW=j>=Z!uRX3YoSVx+&+dJ6eGB z@Q$mf5Tb#v{{EzY{;iQC96t;cmBM9eb+pg_ms3rHYA6?9>;Sm)saYEHrI)&gcW2f1 znhE*Ol|}1Z?&y}DN+9wy&U*bGfLO}o_xpVUNUcj-DM(cn22AKB?MVG|)ydIKRem@; zZA6cD%WO0kXL<DuBY{*rLY#=-2@5Z5tJe`z%6RSqFm%1)xvqPyZ>@FxQp_+`6S=fn z4(HM_ZQ!jKv!%~~iaEf-pqaYf;ErzEmO?Y90#lJhqC|~p84X-*L3>w-5ELLTNo_&~ ztFP6$QIc7rN#-oBpTVM+daKtynJ;bAFgoX$W1x<6D(<N2YAn+jbz97sFb}%z(}gQh zNtF3N<_cOR7()*x8}dsBr;Yc%l3#>`%#wmmTo9^@l@RQBN+rh@0e+Nl1BYJs{l-bs z?R5YM8buKe7v!S^KZrmi&QsjoLh1*MG8tZ(Y$+LD<gp(~ned!*H;6S;tLU&8d~iCi z@_xI54^_x-xDN=V+a?LrA>q-<gn+hV6JhT8ZQCkQHARMe?gm66YelkaE8x4L&drmW z$`OEf$pjDwDS+A71#sj4aJ||^*R_k=!-<^rB6La(;M1iif_o8LFa3yw5TO^K#N3v0 z3o@NqO=Px^D9q-r-)q?fT;1CO=-_lF(Wvl79Lg%2&DtCx{s?X@^eZiijI4~iOIUsN z6_wmAXmFu`^D>~%xgr8%`B-@w^yg(spkTX3G$5;G9#9YmiD?_;=y8-q6l*;@CTeMZ zoGFH-gAkvlz4pM(aw6k~-#eTxh-j<VnR;%{Y#Vx(<)vPq)SM;=Q==FFwQ8wZK|d@o zvn^W(;D@V{g(6H6F|jG+6V_Xj-iF0rq^-UVAWK=dl|19XP1}7vOIYwNAKrE~LwW84 z!^z`td6Epz**W4bb+iU9OEZ-l?;A`Xhs)D=_p0sAeIPr$GXp>>bo)u>c7p+KyqBwr z@hsm<ZjztTrl_Jpzt-d@-fXFw{V*~tSKT#i7@{^KVDfR%R7SmCC(AfKs-|EIHITb_ z`*o>XTqxdCDFP@jZduG%cm)T}l@NuzW0kwUy1OmDyLVV*r(0%$K-nI2#XVaFp{z%= zc5Au8@Fg`P@rH~)!XyzJ86|L?fv#<JZ0lscM6)-#jxiwDe``AE%F1wq9fG+)QkQ>| z^q`t`ZlIP)uFIS9!)4hj7jsTYZ$ge?j_2;E+fHT=Wj8|F9?WbS`fTCujRp)p7|#s7 z>OtDb48D;N>q-6>%RsSai5pc#T+;7gi34jj9);ZcT?3Ds937AwlO#ETIvHMO^NVt_ zq@z{T72<FiCuy8&6(&p`w7P^wRJ{tQmPog&mSHdmt#=JmK)n^#GjzF}bYlQ~`X=1i zBuRxRf&fLc+_F`dNF@nMmUS0uidU(^Qt^1o3@QzMO%dqtj{2UzFZ`Q+%X#&|K7jLE z1EA*2;YES>6t!M!bd7@p0AjC$@l-r@b96ntf2X21(ZFC5Woa<nSs>Icvuzy&x)TlB z4v2W+(;@=U@3c;pv<RS!`+?Ap%}JJZau7;TH%wbkM5}a<gfND76vur<NM<QV318L0 zh{B{hbRs_iK~X7*GeuR1NKr{qDGD<Hk1e0h>rs&8PKJGyO~6%YM0lO6Ojw(0!18|U z+|g_Q(%TyWYo<bsU;picANsqOi+3!{O<Nu8S&BwhTML%yWIx!t=<Hl~f@L~9ZwlSO z?(Ub>lsr8M%M-xe&y3%)%VF94al<awk<3{xP0i&a`IEGkkiv#kwJg<F8{Q}Wv{$|~ zcFTaq(h0Dj$5B!Zo|zf|b)0UPrDe~C&zhTQ<4nG;0I`WByO!RS2@pWF2138%fH{og ziqStvaxj~QQW0^kA<CM5yd;jd)$LTxT>=wFz@XbEkRL_jiP%Qr+qyv{V&ze{EzW2> z7f2e?C<5R$$v4X18vtrGQBLPa12NWK`PgsmABl|mu-o>dSTttvhVp?V>O>rb@vz$w zI@1hzVeFW?oF<j(z8pqz7$=U|0Q!kIb$8fr`l~Yl=Z1apr=X8MJe>i!adA(cN?v<( zNM-S|ntb%F=LEpJI%QMWHC0*q;fh*=;M63LV;KOA=ZorhR1p!0uvpwv(JI=AhGnEW zv&g%m?Dzsv+qMW)R47Up&D3=-47*N8Xz_v}qG3@o5YUIVZB@~%2(N|l+8gzSwf4%G zyCyjUvKyB7=_wH$*90Ial)XjKFeAEJXJc0c!9YR5AtGa8YsGTm`c@3!6VvG+17I)! z7VO-D^G@XdtJs?AN;4VTHwaXr$1iLTspe6cUfdo~!Jt9{F4t)}OFsbPbm57t^)d)W z9%AbGf-6Q`-=ay|Qou(T%kdrEu>rV#$Uxh%&u#U=IG8*>H|qCWHW9sYfB*dUfIz~% zCV*#wm?F!p_zUbk1o-mq=)vI_L^*SO&(jG6inK&y7P1@+EN1}`tQn^}8iA61S0KnR z_c0HNsNZQV5?7FWGdT2P0tw4a3K1a=Qq$4XJ05_j2US(H!-N37Y!OI3iutNeB^h*O zQ!QOf)4c7N0OnrZrP*!U02W?Y&-v9qC9!i66FYkKt@tchjo<bfFayB1|988+9RaV) z2YXf$)eM(uly^s_JBxSV2oA_cUtIQgEJpm4p5tsk#Gg{O6q;;l>pQppu?(fww%QQ- z$SN`QUE5SNZkXY-EbYn>Hf(byYAoAQ(<F~jz8O|IA1Z~W2C1Mie+e(lQxJLZs+%D( z^*5wyB!e17srX>%8h|KC%PKE#_q!Fmh1cjSn{lnwk}5G7lN|6d8fPGNomLzhGJQwg z5iCFZhI7V^Gpp<-!3(2Nw>@5XDkj0YBUa(7rS4}hj0c_8WZ{~IuD5rBf_$n@LCco> ziLbz_Tf`gO$eK{8iXMq7R;9W&EaKgkZJL>$<O=d6Ni(@HEH%Y60#mA@x(ZF+L`qBj zPN*e$S7<nDou(>MY!b6n{$05bq0S{V>8)01a7b$5uAfZnT|;?|FvGJFiP+z2$Ddw6 zB6a=$bNA=KwxnB{AoMMt_q@+^&$&ZP?`6D~m0i|V)m1bgv^Ah~qkxQnjDUoMwSb|a zgNT3`LQ5EC7!pWWTVp_(RdrR@keLzjV!GqGXWX+7dv9L||FnL0Kf}FoBQrAn*}Jii zZ{I%t{(o!u*0<LGZU#{D&yE{+xc^TNZhyD}P(6zPByV@{8w{!{8ZRj#O1&VASos^* zyTaH(A`aoIcZ9`9+-26v|27Act3ekhDJ#)TwnhY<>Kfv5Y>vg!=ODB7UO0kXC`I&M zbVXM%0c!Rtv1%3~Vy33cM6hi?<9*ElcKbRCwM*UAdZC^DZLaq`<9k2<I{3>3I(*hs zy+-OCZ{}MfO0p1O3Ne}{@4j0N50Z-?Hp&Tp@fYKF->n7*&0TFb`^IdL&$sxSU4#^d zEt=3xaXO|lYWyuI$%Ll1X$zj+)}mV0jXq-pctYab8VdK!v-ih6?%EX}6M)@br|1{7 zi;T{&GWh`vouX{p;cZUo#6s`iHNJ6X2Db~NxpCWCGX#T~$NlVbwp7@xGMdG9r|w-~ z<S-_~fo5Y>CfiB`U|rSf&j34L<(ss6rKW?iZMpd6(-U<|e>&Ilzr$Xpo~iOR=bK!# zEc5P#DDiZ5f@y!Cmn=;-RdqZXU_7{9tn;GGlsE}HJuDZQ1ZQzPUv0*NUQulaMkYmS zsw{oa=In3+;H}97t1N7G_yvH)W+t~(Sqz;sCVF}_1*5$DMzz3G_bHA-Hl<hA4hTcq z?sgocszI$f(SDW?=wv#EDE8plf`HS*34vC50m8-20)(%hpPHtsM8LPN&jAcpsqM5H zAO8VF%gb+IyxzR5Sg_ixwh0j~XA8-71wqxTsJ}<O47T!0-z$A~&yNn(`?K`#iA?vZ z&&;fR+}n#~y4hpwxGnMThjz1rC!^borIq7Q8z}bH>dg&^UR~Tw20g_xIJaqRBIOOM z95zf2d!3iBFK-Am>}Nz+tn*u~pkh^Fuvq7+=0d^I*}>#o`O^Rh$?+cuSYCez(5RO^ z)5<Lj;LX+S+3^$%98KR|-$IpB1FKCj-{eYkZ_rCsb+xMeQSlO6c%v$|)#)tWe-jV; z0L^qxn!Y$aq9B+KdIb8bmv42O>bxLeG0W9U5ngPGke&XK*RKG4{^aQ8`zuA_i*NU3 zv?ZdDIlQdY47r@;y?M=`-IIuZC=Z4MkoKD=qX7}Fb~`m86q|~O(j;`+c&;-N0hkUm z05eZ%quE)|WPfEd1^_5UeXz>e{qXi0z}eyWS3;~^UaP=+7zI_ak5V`MRyW(xNpkVi zdbg{qa-XE(#Sa?*Q5qb)2v?UCetSz4+-&hIl9Q%t(Cy6LsjDKW@~w=j1z{+o*Sp<b zNC-o*_+T{pgD{lPr<COM8bVQ2jZA3^=<e#I328$-0KEQ6mZYeAS>4-1{g|VD1|UkJ zbL0ST%YAr~F%Se`Lj$t)OM@(tqJzqvR7xggxn-k3a&|ZYc(&ZYtCVJDj{)6LMD6)N zBH2g2rKHPhwAJlsy~1)QTdOSYr7RV-Rujq0s8wkc?)QP9c5kXZK*T$EOy1U`Fc+AY z)pR(>t16A-O<7Gw{n>JjxW^(j?&ruKe$*|au}h^=T0z3$kTqHs@Jv42$`1>PF42Nm zRCn1*U%k5;Y&FXqWm*(rOEF97T&stxUGUxB`bV|`+~!!}o{Nw(Lz5|On?2XeZJI)3 zje=qMmX&AW?#B%PNM5v>D~j##5_kgmL1_TPe{#6|S2xXsxbgUvqe)&j3tL6)d|Z}c z1jB~1oik)u$YhIa$%*jNIpBsItS?NCVU{W&Cqi=k2OSmfWiL(+oSF*o;>i&a(aGVf z%Nu~lgWhsoF!A+b%{9+f8xW0pnWmMkHm30h#)C{ve)IEhl3|~TXREc9Lpc}?bpre3 zP{B44>9{v>bg|7&|GZwmB0%xL)h$vP;s^*Xw&YwMqIS&E^GxUwYnmYKeg2gZ%epG7 zn~H%X3n&PJ5bN72h$x76<FmkY;IMJ&J$|c8WF}i`H#};RuNvP9_J|;8btH^C<T1pY z-mD!V^2k|20$mzAQkRDU3JCi>-{+RzHCM|<i9ly>yRON|O~(cbsT>19y{{Qavlzev zd+jt3k|Y8!&2>MChTfeG3938_17%eKIGK)Bi8C`6S|ChLTT+EXJruHt>*t-(EcWHD zptO-F5|k{b<0W@$B?laM`z5+U%tQY!OQNFMZK?{ui{pdWSGT=1IT{Tb-Q(G>4QEDJ z%?q>NG>*#c_GCK7{dGw4FXo5Ggs=T!m{80jn4z>PWQ8`noC0S_3?fy1u7tEq$6_7p zJDH9N${(eEF9kR`_>4e{&D_amkxJR(-PNse#927vl*Ew=Eh}`X_H`YkvLB&p{&+GS zb$i}L0gx&({QAWidHL^DordjRus$W+=EH;D`TzIb*?<43y;YW+=<eJdlkRd;42w)5 zH@zwesK)xw(LXuFzq%RrQX*Qcs(zXPl$Rwl&adZ#UP`1(`Bl(`8OuDkCg9oOR6Pd8 zMIbZOUSHh6G=f|erP@+m*J||&gg8ryu+Gajm$#~aFo4CT7-YE|BBH5=vto_?>RugT zD_8|kCclA%8cxbGP%l~C=#@pHv4<e#DI2Y}0cP@I?6S!QYfTW6nlQmt1<<pT!__8V zZ%db1A|g;2P+rw?o<1060P1>g=Wo^Ay_d!S&aW2$&W^?w7gTdIFZkT-M)<2CFaSmn zQJe+!j*Hc<KZ(L57#{r%C2l_{01Lf-lM3=MvdOLTC|Zqj#rC8o1&7&VRI4Fn?Nx`z z+ztEpHc((j5KwR{)bgHcw|-l>m4iu&yIN{LFk+ZH@V8@L=Z;z34VtU4#86>U#6Ukt z2)qhv0P!%Z_w|62-BsCC3J}eLhP|Gu&QkMx6h-RYP2*VI?7XVfO)sj7j7V|-x>4;h z7<pMWvNT%D3|gY-XgpHS>2kJE`#e$tCWKr84D<Wj8Hkkjh?*%Bh-68UmsOS~A}i^k zvZvvtWm2|kGbO`WR24DuZJou$@B|;_yk><{)Q8i<351%8nmQHNMtud~{ALayLII#t z99I2`G*1miElU;l;M>>dv?tmJ%p8RQ%kC3G9|K+rlVr`SVOFzHx<XA%qEO7n1E}SQ z>z<OZiAYbt+1H@Z(=>^O2eQorHInW&k=acY_x_yxM~70sNu7gSW0_g<jh+6}W5C-? zCR5i%3Bn*t0lJzklp&}Fp;kBnTvI7>fo1i-=cY-QtsEoJo;fe7cQ-Qv2EEKu(v<C_ zYS7iCogGfpsjl);zSi%qXCvL{g;fnMftIV6ah4KjT@<e`_2E=FdbrX;txD%brAvsY zW?mU>=j7xM%d78{rKNdfgf~~WFHR0skB3(mHv}3DvgIZR=z6(Y=hd*EDu5SpZ{1~! zi01FVO@=)Hv(;uY=zo5CM1=RZ3xdrKBMO3YyW8#ey)-GSZ4{-{>D@{WvnN=I?)B9A z6`H^L<x3DG6wrRl6zG?uD)xg(41i;<6V!E6f$Nte@h9BXy#Ne9mD@;8QWySl>jcSb z$RG-q8n`Zd0J1<$zoLuWF?C)l-(mbb?ym5iC>p1s?uDYoYXCr{^v%lp!J{-)I;rzm z+~ueFEe2WahXHW*w8y}H83H^*m86kkoCH}iKI{V+07PmoBUQryLsQ)EI6*{&Y>=oV z%uXi`D4F)sECy-PjOGn0$s5w0I#!{JUWZXII2)@wQ=4~cl=anb7FR0(E2?4In**r# zb&7t9K0utu0GBT}FsdVYwS9hk@aC#=mo961L?}Q_%0;<j<|K~FYFkv>lj->4cAmyD z{{oej$1ENjj7ZiY*%$yb%3>2mp#rl(%$uSlA{BT)8V{v6+)GmsFY|&xs>%H2Yylv| z1%cKgr(;PjL)%7zG}Zj+5eW3{>+>Wg(@Mys#<lZZ!Z4WBv5e<E(w?_QI3x!zwC4>X zQ?LB)`W8e_52qF*Z~xu(XaC6y0Hc2}z2|nFOh!c1$z3@;nAqBXwOds#td{ur4~wgB z$wi_a%}Q|D$X79O6fIX;2O%(G?G&LY4I`)Q+ElpOF_un2dt|A<Yvy;?Gu7~5Q<Q^V zN<ht68K+#?YHH`pO=0J|R~Od+O$R*{fdFB(`q_HnuP<+g{hmrE4|_TytxjXU+KdN% zb=AvFt_k7S->K5=7srPRwgGx^a`58h@b%>lgU9{eYExV<R-|e3VCMOHV@S}J$n2FK z%~l0WCRl<GwY0G&qdt7=wJb{jVHg1bRRDTf+BqLSW~nyLHJVJ1d&4YzS0=w70od>B z{l309zlb8@8vCuDqSHZ?FLr4!+~&XCIP*gQjE2|i*XK6aQlhfA!5nJs$A?)t%*hdy z&_H17COgwz+2DsD@_}seUAaV3NUVpT#p$Zr0SIFQnucL0wU=?98c0Kh(p<4e9rpg; z$?|0nw#gYl`u~CC!+9ik+qJOqh6xEtL)&VUcN?0fNEQ?ORcw9%Ef_dSf`Iy*)cZO` zw9NKd++*+}-5nJDV!ORwuCqk<FY}bG;hlhVp2z)OUTqT-9(-~zfoU6Vmu0aB5UAX< z*`Er}Dxk8y^6#IW0{H&zdk87%(}M|-qL@)5^y66PV$Nod;z|u~*yU<SGJA=rgDKr8 z0+v5ln^xN$h{7PKYf%F%R3ZF9MzTP;W_F#d07t|%S!XF?rH-p4ofUjqPNJeit7Z39 zV!w)Gui<X>B9MsNdK0+ejVsyeewv(2M`Q#e_?8KDb~uso^FO>eQ{R90`W&D^Pm3YP z$A2Wk;_@3JTIXfImtM`5_B|uw_ctowZ*{^UMO^@#9ZlWKc%x00`8t=+PBetjmVzfS zCUm!zJx~L-zk+8gz{aCluGi;kh|Q;m6RoL|rD~kNy1W_rZnyfmqM@nJ(b1m~(c<d6 zVJ|DzTOV8r1R`qZapk|DhFRD}(dt<LsAddFKkUR^yY%P4qL>T^Ik4UC!YJGo`^n^B zFv|A(`qlSuE&4<$ZHxWzFyRlE+W4Dsa~}ZUs`OrxWM0ct+Yg;<7zSP~^UhXZDec*w zY?MU1S8Hos20%50G^@gJC!bP$<<6n(yNqiz)9d%s$gl5dQL@F{O&!iMJ%H1E7koE_ zWV`AV7*T8xx~LflLTy!qw>!P>ClSEgY7fA&tXt=gZVis6HDumx_+)YFlFX17VdeGN z4?xH$1xZ5y9o-ArMLPthyAo2bKe4nQd|y8wF%UDj2(%Nw-*XfN5wgK5m@PMXSut~7 zZBGuyd0F`hbJ2$gvRK8tquiy=!Ckt)-2BR5EcwD3us({u5}^vI^&m-<I5$dAj2*#p z&kw?|q(}KiFN4wVcD`NDN97HlOhyE{m@fzjQ4(P#Cs^iTmV#)xDaO#G%Rjt0TNJ-a zRfa<4?d7*RgPVm$(uIv#%i3Kt5*#&Kr~;9vsVQs9)mD;7-%k?|P9|e>cXdX5RTQM* zoW6c>sz(2JZ{GKXkac|cyVdpg0D5V1HCtG3`TRyxhOJhYrD&;to*(PjGG8%)hQ0LN z%}hlaHbprwzUgvP>YD6BQ<J^P4ULswU0xGtGU$y5eU`)ntG?y?^lC`iI}@*75+Tmg zweBcPs$sA?vF)yoqhLDf!+5|lvpec1FqtX!`JDi1wO&#I7OULup_c^r%(fDD?_XY= z9=>{iT{9PdT5QJD8>Z2Dh0}xr+7&xt5@U6{1%Tyl{N&eHp#BvASU=N;3Xja(>I-jp zI#+E}Y&pbU`=d_bjyvjw!ugJ#I_(A3DBFE*QKVFeHBLh50BRSl`&gaMHl*i+mi$-4 z(PeH*Uwi!p%valL-yfz7Y|AZxAPCjhwW@3jl(cEU>e76LEFbs%YEu?DdCx^{fI2&( zn-9aX2&`G6ZR=NCYyc6}5OSDkZ{vh2SwIN<5?5ke@+LlvQx2K&<Y)rm^y$gA*d87q z0HBb1NcO;fUjtOpuGddO>H*N5*nzaK^x|Uxt8ynLMF?pS1rzi^2&3Q@dm<c6R8a~g zSww`D4zusnoT_5%2Tu>psH0+2r9}_~!G2%w-j^1wRW-;)W!VjmuFE}u0DCgrv@A_@ zLY-Jmd0#y}Q9j%c?=IAo&4xg<P>#51jp6(x4}7Gd!+yq?WcjHnGqx|D`0Nv*7tflI z*;u5%t3GeHZZqi<SNSgKMF7;lYHw$U6O~{8_VS`<qv%AYc{Y&?p_9@*Mk9Vs7-T6C zsrs>}N7M51TQc;BAP8!6)uutRZ7|iS+g47e-$BHqhq~_9?xiAbHh$LhJ6HpPO=NwQ zm$uiHYVE4h!0J&g4ek=*+0h|sTLFqDw%FvGq6BEzPt|djd7*}fvPIT;VU6e47dPWU zkANTy$q*9KB&xQ%G>(8BIoeIzl{Fu|a-$Z_sv*#UW+^f73CPg%<z_PIe{p*B(|hK5 zPK#nZ9K6jpK|s;@c30Jl%Sx8y;FBEnZvlX%@lQl83UmkZ*fqA{?H!Vm9WiAO4_w|^ zigr9M9`Fd7Ghtipla+;Ps{8s^fv%8((uV_(7-glZ+_vM>E!79FgdbfMP?CEEG#maj zB@Y09bG<GIi9#YqRn^TXw26L4BJfZbT2ea*ZMp~HrDi$dv&cHQRjILRe9*VgtIz;O zAYCWM#QSRR!XZ(hM!Qm(*Ma&--%Z_TO&Vy-Y6`CRjAkT(y#|Q>ef4xKop)~R1)m|v zR+8Emfnk3m@)RZ6F##D;Zc^GPhEHy3;p*;6Umo#Unq={=+5xl=2|zzdH$Sc*)0-qj zueoVIkw{*`I@aV%l{zhNPsG8NgdL3fO8rXDn9QqkPlSN?))30lm_VwP#il5}dU`@c zKfb$!E|R9x!%6Y$PddeSO9EJnV1rc+wV;L7mKtn5JY!a<%dchYac0pX$@Tk6lXz2T zOGt~t5>BQg01D38!1;VVSJBvEFMWSA18{mUVPJdxz4Fl~!$B`ijwd7SKh78`DxMca zba6ZXv*%}|!@BtH_4`4lyD!JbUxR3I`7JZoda`r`W-n`C$a^){<PrsrFGj@Y*E)Va z>h)A^SjXv2%L)R$;ae45znm>$Fy28dX|qN}a@5DeQ4gjw(!r=_-{5|l09b8YX1Ct& z;R|l4_0osx`y}~~UWWZ_xhbv}E3Wy)lf%~+*Ua3XGtJBKXb@Gmf9J5a8-VW$&oxSn zyyB7;hPni!&yc1rOqKvC5r-{F{w_e}55V91S<~W*n>$R>c=t|+p|-l^F?2~YA)4<1 z>?7?VM)RHi;aPMK`nFKT9J?XW*f<&Q-;U6?m%JrUwYgik$^sQNQoC-Y=MCGh{YV9~ z=Rn&?i03pnIW5eLAPB;nJ%e!;?y8y?y-`{gTNMM?@9HoL*;ly|np_5UjMdlZ7vTjZ z)e7<kpzM?^){wL{+5C#xBPW`2D)Wb|N)}uO>+kOm!mJ+$VNm5;t~t)4<&U`?+A3W9 z`ROqc2qO?KZZ+ZjST%JhD=^M)=879^9oaAlqA*++Wf_Da3)&iSZA}iDif43s!?yPn zLzI#eGjsZKx5`T*)Ssm=POTEqxO_d+MyiS-Z+EaFl=%+8uG+(=I;(G2x4HD88!2{X z&dU;@ys8K|8V@%`NkA`4Nf#Q?@nm#0TY?aw1h6)CqPnFDa#YJ85S<-@h+bXZu<xsq zfOGpnk{`HPXRk+{3h6KNLV=uO(w*PTR24un{cN#Wz(}bKdg<HiTh(*Ay!-~BRbFWP zR&nVWOc=bpyj=j$F>u14Ucc{WxjKpkZ*@2oKR-L1D3<=k?fmN(X9n`m2fdAQSL2gE zEH1yXq3QGM84;2+gzE%swC(KQ!mlMyjzi37cYQ0?f7+$4xvo{}f#<8uxZnHi$<c7# zd;R{pX8u3?m+#tB{Qu^E_5AN10Q+-!2lzHIv{M>dR<9Gd<B70n?=81&N4f8aUEc?y zKGwI9`@VJj7)ZDGfm*PwJ{p&rbr^Zi4cTZ_4VA1+@kzfH%DddMEg1aZIk6|9=_}mH zb-pbnu*6wS&6U<EYof9ZGMjI^62roxYDS)=2BNPB#(>Ez1R+sC`|V!ls&x*Kbn6vp zcVCC=)p>;PD}6#=#MY(Kba7yOr0uD4QwcAhnXofnerQ~LfWpY^R#EVXEVM9CGp9*Z z6|Mmxd?H(8R1Loz?zVMJU`EU#*Zihljt=|UUrl2G6wpRD7K;F6g9M<8bbqj{A1hvZ zP$>dhrtn91pN&Ey^cA0<K&l*wFuz&@sDS<`Bf@@H_mF~ca*6k|xq=f_g9|1L`M+v3 zZ+=_@2wq7wZGiY-G$7OW8Xy_E2Ux`IvCgaCJv{+Ix$ml2=<IMh7vcI%Sruh<I36nM zvdUR1q3PrC=xVOu{8GZXxpu5oZQH@*6k`TnUR)Dd6o=8Igb;}IrBn>Y*X+u7)u9c3 z<NRhm$kJr`0tD4h5Wt|9zPp|ga3;XJ-%H6DQHso^c4&!REJ$8l*UA(-nU07wX1}?; zF`h4qY8Qtg5fQVh`jw07@4Hx+jWusCX8=~43_wxU0Q!RLe7h_Fd~r4buw0j)W{|8m z<3X>knVE<E-fELyFIUTTJ|6TwKRLqRmnDKG3i*r3BIYX>lu8#Kw$_J{*dDvrek1OI zqDmU2;8jj?>t!X<a;gKGUa`4ZxFa6Cu%F9!uif59!Tm7XjjMNSGVnb=Cfw!6cXN}4 z&T_M`%9X^TW>&DR{00DV8iKLAECFmYy_wo3T<!tvCZdYtM*oV2x}q=8X;A>As;U|m zPg(5j9ZzTa=lij{S{Jw`RK-ru<Neqot!mXmKsk2ilm)8z{nkFv#fTNxjN1xc5cF?( zw`>yHCl;G-d4gW%+<jBX3LP4@>;jt`5f+7C0N3>LT?m0a2~9Xz4rhP3YYDHn{5;xL zyWyl)=38bCLkh#dbp~#<T$GNdRC0EnJh8Nm*!H=Dl`wNkDNZFuSY$T7&VGqK8yBB( z9_M@*a?M3u9aM>>Zy)|+t>i47+K*V|5A$`|8#sSjWhK~Cw=y~sRyLcww6zFI>n&^5 zJd-W8m>e<51bC;Tfyu|ys@fAM;GGH-WN8eLs)=70)mLXHMELRD<)D`l;q+hvK&4s% zY>Mh=GF%rW5%tqV@!F0i!>jp{Kp`&H9(R}&im&qGsj42P>6`1B%H#I4WSQp*hA-!f z5G4UCa)K>NFm<)bpB^6&Ks0@OJyX8*@nm#<J6BG2GJRp)?m?EmyPhdBS9$rZinkB4 zj10dzAcO&JxBDmzw!6BKxuupDduJGuyp~B_GvX(6hihgfRtjLT+KdLhy5>PITj#~q za`pEIfV%`Qq;KjeL*FTS!}omem`_a=tPgQ>o9DfBB&=;{+!wJyhgAXO#yU$@06-^6 zXMURPKqBB#z%G^TypN6B&<seo?q3&|*HfIoW6|MNE9ecUXy}3uE`h+_!|+q~qA<)w zm`(7u*}00SLr6`d<hI&}H@o1o1WfxK!#KDMROLQd)nKmsHHGA-!CSS{QY(vu)E7id z0!_!$6oU9-<=n(%;pMye-DP~K8S`j%mUXdcPhEt8AS6dygJ|C<$C;y=i!3j(FfJU~ z!Wjo_tCXzxsL*nEEj3*84~tbk+Uw(Ag~j-@K7gv&UA&qRfdV3;{jMfL)=#eA%>hzz zg0vTJtDUZ-CtSR`C8974KuEHPK*hS+@9HQC(=6UBiuu(Vgyn40AEiMM)cbl{?N+n= zfMcsYlEkr*BB!FNo*y3);byT`jx3B!DS$6j+<r28ulmwYMp`qA*f5P<F|q5&OAWOW z$0b&-rN`2;H`x4QI_fL<1b9{MHJ=WgB?%GovQkXC-#tAcq95K}4tptqP7lUfES;dD zsU-SEiUtaPWuMgut@Y5^6lE_<6}jwqG9=LDd>P_mWl*1>$Y@w?il;}@v%?7yy}Oxf z%)XgZsJ3&{hpr56w_YFuaI?$-9I1RT5rAGVLsydqwaxW1hfmkiVT|nKk?HBt6g(UB zvgIaM<g&@22f}F3uj~5n4*;XlLcyQ>CHJMB(QVJX4N0qJYX)x%|G$o2gS!<aJNeNc zU&F<hRXx!m$K5;U=qn>sHDTAQHX6?Ry%fOu+5q{%XJAybmuMB?+<D?Y&Wr9SK5TpC zQ60s=+;z(>hO*yBlD(p0@>$T0T&nHKA;`{NCf194vw*v9(NgyKRI<p|>ToD;DN4fK zMM1!}2MQ=$>;ddXJ2l8u$5sM@FB7$9zg318DZgJHTE%SDlHMv;jP_&G``I}9%FBml zO%n+hA3!xREH=|yIzHdR`1jhjXqr&Wo(HczPK$(O>yUh6d|fjLNfxRnQRYlmVucW1 zYyqfVumn=4tyEcvs90AjoUWK-idRS~a<1ueWdAHZEh>Qh2GoYUMy|kE1R88Mf?Z?+ z5Q5gmP_V2hpb=egwX;=J?<N5e;(iJO1wls1epe@yZ3h8BqtkI&Y-9AYegYsZcOcBM zR~*3XXrQ9*`(2$<+z7e%N7>P{!~MQaf%AWJ@%;GkcDV+ilu%*Q@K272=y)=`m@NPt zO@?_{sZczTE*yu=p$PSE7Wo~UXs>OvVpBS0@n0pmef&n2#CcgMQ7ub|(`>kd@qDA3 zW7h2WX*L86!P~MiA~r>9WQgAivv1Z*2&ckEaj2zZMM8o@ddBTuzrOx+vl{r9D`Cx6 zo9OuK#nrb@j}C~4G3)ix^`>}zajo3qzb^nR61R83up?TLoRHzuOVNU9-<f7~$xTb3 z2N1ME$#<dagZbWjMgZNTANhe8&H$3>XXRVnRX$c3-_R&+S#r*7FArC)w*VAFyB>#7 zS>$G<mLGF=P1v@fI@1HO<D|Kr;Ai%KZoyjY3eJgR&lff`u`#+xSQt(!!Y}N&=R&xl zzQH6*z}4XdFu0Sltpg=d!PBvTVac}capMk1xeTB7ASF0<yE*{MVw=qC{h$tlAdG|k z>wG&v5K@#x0K9(lO@$kujo`^fk^^sZemb@a7k#zh$G$EKi}nn<NX%MEu;FW)lGn_v zx@Hg)D9R!tD)X(d11NmIC4j$-V2l6&<HG?FtP!BzuHAM|AY%c9+H#5lV;k9kxPW=7 zS8AFwHdHgo#pLZ1viHIE$MB;9gyVm3w8*#7D5W4s&{O8x(O?MRrq}|=dU19%*p~Ye z2q+^%?B7Qr2>V@~pf}9MAk44V1oVajDAjkO>%YAI;`I1<G6d-T?ScqL(~(kaRa|TB z5f;_+lLI2US*+JpMaHN9{PakLqpd@)I+EGCVRgZ)a!){jy}G0<iHovQ)UdCfp8Rxv zHSDDfIy)TC*Be#xyDBsX-ex8U6h~266<L-P+Z{76*A;;4MGoMrr&E~h@6osi;Pu5V zfWP?a%&yV4OHly8xCfIVR(tS3_ZP>Z>za#;Z&rDcr700bM}M}w`tIrR0bkF0S%$wa zi%`O%yLeG;lxk^FGHi3s&ax%RV(o-siN_xVxgUg<_bQ)obGrv1zS~V_{|0p*ri%ks z*Sx<hVbsr27|F(b2Se_sOX1iZ|4w}<U;bbRz4ge-XlFA#p*flGvL%QEtmnD?JDa<T z>iRg=sr?^I3qO<LKwsBl;~wKe#{;ILfnB$}yakXReo?&sS=c4}04;KKyZWjvd_sPA z>9&Q!4GAZ=PT;Q-3~_-4Q+h`%-vdE07x?Ez1<=qOY1TIZ*p<8Jc2|yrU{`}V*w>cC z6;}IQ9JEX=)7-)}>=D6r+y2L9mdR?WxO#AxHD|a40Xv$v^IX{qf{F_l{U041$|4~H z_2iT7h()r(G_KH3&gQQ5EFoGtg6g_971#pui3o_^R{&H?dBuR!c)zKjA`{HJt*-Mn zWV8Sd>?@nz(CK9oRt|a8MV+a!=PwLZCa(ZdRu84m`sdixH3P`b5&*Mun@nQ{cGbS3 zO1(Pc-;I}4hhdOT`|&=D(+I$B7QDkc8zcZYjTm&f%F&0Cj9r(TB#lAfC{ia`Q@9B^ z3<*G8#~I={39qQaQM~I%AiUf!sgHwA%na}rOzW~@@V4Idvp6ryBo5gxiTur0&Mr5_ z)1&Fr!|AuL&(Dsg<;AzFyy#_VboBe>)t~<U0PvH8$+{@@R1FV2Rd!*yESimx%wOT{ zPUhUxqp$4bP5|fcAj~4wfYWaM_Ug6`Lh6HRq^g!pacNI#JaOxX#<T?R!@EoM`S@U> z)?Ci!_hC5QFEb4Y!GpW7oLhj(_ifeKSd@8oodb75b%R{a4;UNH1MV`6M2|Y*-rn7f znVUfkUw0DCr0JcvpP7MRrW+I%>ndK?Dh7b}+kTc37<tM0wx6Z|^Of#uoF4s-0wPfH z^Y?0Ri8<3M+FDaX9bLt2Ap&I#tY%vACz~6p+DW9sH{0)5WEw)a5kBAO4~tU$_h2+o zyIfw}q(@(suYSZN@b0;Hq2^-?+SP{9wzi!@loDL<rOtiqw>8L8>Wook;_B(`UPsim zU}^wc{6k3ly1TOqr<Y@W4-_&fq8x!R8EmAgukj}B84?q-NS#~!@|6R;c!_O1VR;B> za;iL)RXaZ0kS`M!%nbbB|BwGQ1OM~?^?zoaU7cTdac?tF$#siV27m%cm7*^9O8tgl zWBXskWbzTJEMD>C!zf@A(pS#C#`ut6Yz6Oivc=rq6IT~P#IgXap}$7rAK1HRL*69x z>Flpa3dV|h^7&{_0Fs!2Nw2r9_I$qcUP61fMC($e=e#MG@N0SRTHjt4pNRjgmL~_= zo9}1oa-E+YO-~Oei%ni!d}noJ|2_b)lxc1k81cO@*8anriA3~}EV)1wuX^6F)S-He z>hryuoJ=R1qB$A}Sn0l`?y>?C8O{zrbDI_yYMbL}8_`+qU;Q!bL|^%$beyxy>bCE* z^>*%ua`B^kMK;-2J8HwQSI8~>MaLO-G(0I-(Ht{2--nK(ux@RWcIMkx!}g1D0nzY~ z+G^#Zvu-0vP2{Ju<u!X=rWu&rWIxCNzt|G-yk;P{-ZHRRmC2&s0;7J0Re^QIjP&SB zzWxcv>}hGUM*~MA>A=K((U<6GWc09zr5=ax>AD(l`H=j!jkaHbrYcqCo`C3D$A^_E z(6$2@DDw(HdaGCN$9sT$BY@IgY%BmO$M7tG^9rD12xcfIS9G-lfrcrOM!WrPZ>q7G zh?G7|aTo&F?P}#B6QL@01f)F`s-fNYD-g;tU`S!g+NhpHqOUf4X&S57Exy+Jm#(|B z)xh*xNU49qC?G;r*8nL4F}&XKvj{}$>V}h^y)!`=fU)2175uBKP(^gx(sj1ig%7to z)zWQO?EnlW89-IB4MGCxG6%(G2*W_#|7}%UgUqGj+0#I^$bQev@>^JR_X`FypBzjU z>s;xAF{7U)zs+<07y!OQ1X+}1+|PWLtwg{bBy<78Mjio@GDK*$2NunDg-=1~Y6*B} zGPe!T4|$9q{53Pj#fADj)?Pagvkbrw@6>uanGV$;SMo#dmusgR9xnFkCMDyi08m^5 zI2sSt%In1%cL`SCx6;W_G{hyFFx(|pX8A+%F~}wy4Tc>HKqK+I*<&Vi!;h8`XO;*l zqr`T<?2!#@=XL5bH9BEfM{KFn$dJ53*B#JPz9KY|xb1t6mU-c)H{H9SE{rbpFzB89 z8G!sJ9a~F41XPh`8mp$E;l)<6vR5-r(#dAb!2U${qpW^dsjELwy=xYxBhjKDkV+E} z;iAD8RL&w?cUqF6ZYd%r2M3YWc7&+cvTOj6UGHcJX4AK#M$5{N3-8x!T4bGD&ub?% zqT&We301iZuXaSBVG6=-r!n5@o)?>nNShRjsi%NVDZ8b;7{KnwHGpbtW8D<J-x5$C zht^W5_n`vpve=Ok)mK{j6cB)_+z}9`(f)M~U^`TB8-SGQgYD2z=5-$qU*DbByP*)d z5iv~%L?DD$TM+T{s48~^-jo%AcKbRE!quiEqBsiGk2XaC;LXMDBjeFB1^eT>*{_96 zU-T+vgjMkca`X^}K^1TJL!?>!zyII;$MfrTZ<yA524P$7={FlpzyC7%ZoqMLn@(vB zF*lR132Z5~o#K+BM3&$OTKSRb*Sk>i!=$qA{4w8c9&&54?G%q~@0k6IhX)&Id4}BT z{>W^?_-a|@Z`Fsx<EdRa?(5p?zkc~n+aCla4+LPXyS{j3e~U#fug>Nn!Yj=>&Yt{1 z?T7&0yi%Kdc6w|d?yHL{`SjFfogGe?d7ZzX9E`yj^->1@^!DP(bi}|WSLO(>HYI>y zu?G;3pQ5~G;BYd!o@?Ib+2ItrNAEi&r8iZ%3}7<oD<j~qetN4;``O8%mLA*`@)|W9 z&o*YI9%Ip^*5mA*{kh(D{mO#4QmO*z=krS#;+Mkqv%|^l-L3<-m{lGDi#_W59i!E+ zAQC2&(?4mHEDI`zjsvp;IcqzaNTs8%>52Zb0w`0&0;2Ng@0A?@X$LSvFbUM_zMAC( zWOGK-2%zb(Pb4jXk_=H`!7FACE-C=&$?pj$e)<6_tw1Ov%{Eu`1r;b(QW&dw4p47a z1K2-_0c?NJv95#B007T71Yll*FdYpDSn~!hvMvAhUUU{AY-?305}d6Xa4}&ojP8QQ z(spH2cO*39EK$r>Alb@h*kHqcuNpM7@}ZMO4PZa02^0jRN(PcN0%7+$C&G3>VYmYj zUGD(w&qDij%6yy5>&n{AjY@>Z7-ahG<b+i$B#Of_-%bt(0LpwDhQV&TxAguXq$=Na zW%K^-0C4-pd)8)SQX#sh)K?-1J3gYf-)<`OhvBT9>^~T7Ka_NESKPN#&!ZEy{X5gu zh^O^a_BrHIO8Q~Dq+MDp__4m?vC;Q$x0vvpzJ|J``Kc5S@1PueoE=fN;mLe8g3mr? z*&v_;4BJ(JV0bY^-o9K;%d5j`n?PO|1~Q|`GO_KY>cqffAkNRHhm&zXTWku|B#xH_ z1KHsh$lsqHPR?)UXNQy3=KRI;)63a{8Jn`=eZ5m@<IeluIoPO?#WywIa6RwDYs;Rx zh{GCJjG%sm2Jg-IQe+)kH&hfcj6A+P`MtP|^9w=3f{1zueNUt9?B9H|UU+_{y$3s1 ziWJ+l;AgZq^urfJSbcX<X^j6_V?2@O4TQ`DQlSNP-&V5%glxtj?2jWNY=0~Xm<;;_ z(%i#E31BiB5b*lVEr3{Y5yBmS5D0E|Hc+uylptiw8le4Q1n~CNX57yJg6h1qs#Ieo zBCP8ivJ<G`g*p4la^hTM$UGu)1aLPFY?i^BQ}o_crz7>VUYdYN35}^mdAhfYbz@Za zQYW~e7}3%vR=j8<XZG=nD*3CQ2Ve;OFE#>Ww#<tGZ1e5tsQ>Hq?)tR>Sas@<NJt$m zF4Qv2(mSZ;1j6e2M+lZyqPnY^5TEMUWp_U6_oS5Jv*QEXp7O7Lerxx;77tQ3z*2Ix zYUyW5`()Qec@L%zO@*I5{nhPjd-aj|)+UlwMPOr}+=fzrsFOeOcZPZ84D2afHryj_ zx!7HjAa~8;+^}3E40A_#!-L^=qYm~_84au=U*1}#%<e;9;h%{hq-fwH#h9hChL_ZJ z2~n>Ot6^%iVAuf<8RNupqy-D6(Pi0h&e6zgi_p8%-QakgFmoF233PU>d4<c(TL6b9 z!Z8{20sQ69Z`27tJ2?cf^4xmu(A&SGOYJrGPXAoLSL;^{{`~Y<J-wgLuOO)4(P}dZ zlDcN*x~}&}M?(PX^*i<3gX5{{g-1kx_46Bb#OEgmAX35zHk81#+-3!$i>+GSJN+X- zynYG7=ch;N#s2yH%GPwjWT1)sL@ar<F9>G1moYJojR9F_<z5_7dflRkDMN$39_N;i zDAd*D^M$n}*^K~h$g)Y^xz_@no6HVL10gqZ5iR!w+8Q8NYC>vvn`KFabjkHW1OmOu zNwEz8tO{CHAdLGx09Qo?AOsU5xZa67W2=_kB;)lkafZ;}{-R#RVpAnI`~7eaA_}N1 zcWD-He_Rux93u#W=weF%@Atd$-$`|js6)}A<(GOzHSJFCVi==CpQv+tGXjLnzt5NH zz!dH*C2qmSqn_>q%Fo<se+;tZ$#e|h{Y;Bxu8mk-FH3YxwI~4e)6^jmD}$hFp)U8b zM6Bd|aSouD#L!JQiNU=j0dO!L09fTNTx`3D5BtviTx|3Pqh96>Wss7;M=MJ&eTK2A za2NSiEHA&c>ylw#o$q|Tu|O~$_7xTQ^Cu@(pYC7(@JdCP`&kOcGS2}Fl?lbXQl<=R z`$^rU&HP=IB@LZz3mBfB1B|4D*S|};#LaZDoLjo6;Ch-DgVr)|JbS^oXe?&5hLpD< zzBp|x&raYbEBcNxC<dZ-1mRRF$ttC^Xl70p&7QgGoa92U<Vl6t@+9_o%<KnF*sFJP z^<nMgJhPOJ^lqOn2m+XKb~Ghmy?F=1!O@gRrxpI{<y-Zjo}C<!5pY&xJJk$!Fmrgh zC8F%fAN1v~Uoq(O(<2bQJioGsJv*ANH*cZDl|a)$4@7_c^IHJVP7d6wq%LBX8|zNn zG;066eg)8r(<1_2y}!1%<;lSqz^I=Q@cr8h08b7l>%6pY$7)#`vjO4F4nTVJCFk$W z`QY94%oy(U)zg!J=!dtL0G=F<H$~;%$7QK*X?VLMAUpaJAkNQ;@bqZ<?s{g;Vz!Y1 zL&r$tsNC*DqU~;<CDC@b-|g!t(n_()e`P1updXg3_f?CUg*KPYDLR}CVA#>B8d!P2 zYR&8yAk$>nC!*?N!GzU32T^Zc?@!|G+j27M6Nu*<EXwI{0N`T2T+ec(e<uO>u9u&> zVA#eL=}uT}fn%#`Sp3=0S?HL~aQBX>1EW6zjqk$q`#16(SYe8HPNa>`+&R;>?i-_F zfPd)e!bjmomcH>gnA>W}!h__-Y~S=cUG$5D>*CRjx#b1;Zn1VD^0Mru$-#ICxbV!{ z)E*4_shU{kYaOo}^)e!PNSd3r>eL9>FaR14n|8+h{WoerCxf27y7@|Vm{H+J0Qllm zTNwZP`&UXOf4RwF8qlgUS>F5{_p)_f413usFI6WT2)!wCOjKGLgK4oYV7mGMn61=Y zmdP=)aJ}M5QWtG5T>UeD|Bc#6SxfWvMy;O?`XGFHrXAvc^{1cVgxGY`AzR=v=%oP7 z);W=Ov#i+Ce7$MV2nams_eFzPn!o>sfMnPw(0rv&U^46xNZrGiZ<j69*V-e}cw)g= zR`F*UlqQd<EZs_Hb?7d??D8<RG!a-@bb@;!3iJ#kUC4Ne*VAt-?7wM%^O<F5ZP|m; zL|^PrYaIt7OFlEk5|dC0loO7uT4X|SvjgGeV4_7jfz7tG*UKJ_g`L2Xh}--Y>Vwt2 z8TETaSj=*jMF}sq+36p!dCkCQr$;Z}U#X`#?q!R4UOo9c2*7;r9U#7|yK-m0yAG^s z;;vIG_F>o@?ePzuAF<|R_Qm(^h`9p{#mhh)01ANbLf=LJ+s7vHR@_7R`QRIMCkzX6 zYs+}xCYX1?uymDtf-`s2I5(^h_H`ftkpo8azS>x&r<VcIV%QEh|8g8-!{&y`j~_R$ zP6nl2aHM+}w57|q!Fusr;d`sgd@>*#bx`Vf`@Ev=hFXX$+alX)*rnJVt=+C5BJs?; z>^r1dnxGL_4Q&?0N_&rl+A$0IBCj?D5teyLfRb^ZuQ&hO|MUNC*vr&L%T3O#xQBY5 z|Cj&zUs|g|?Ma1g{%8N`e<vCC0a9O02R(qkI6EfLzy0yG>Q6B2r64HdY}C(eiP3z$ zkrNLQ#{J9&6&CNm10f#tz_eK9AgGS_pFcSQ;k!2%M6}qb{s*Z7xuuCt*@5SD3ka+0 zpW=R|vT`6Dta^Gl1>yW=L4-k;s`F9Sr+7(ulx6Dg)%8yVB>fDa)utHrG7z2}PXUyb z<s~T#kAm2H>D;4a5b@zC18}p*0UVBd1dRI${LF4%cK1zEUT^<HT+eFL+|}`Z3ZQrT zhjjCrK$Btb<@@V@fBSRi&!_lT=mWsJ8aRfoWzT>S%JqGXLxv|07cbqv2equOz>KsX zeEH{}egAKN4&wlXa$P4q0x&sF%gsI;M&)KVzpB!H-2opGfW>6hId^+i9WB{t52V`> z=8nQsGov+NSkO(V(*dRrLE;Bt>HgT?Ly^Jz^{tp2D?G2BTL)^o(mpL59yt6m1oodr zHw;s2J>L<%Xu~kKDxDfeixgvMOw+blk;Gl|wH;hRxur{aGWHS%;0?(Z47Vv-%?s>? zVVMKxPBTn0j~$bXorW-*3K}7Y2@x!~^8tE6X$iwJDD6a>$PW&Ck!xSxL6pY|taU}l zf|1oY2f?>=ln2+J!}YolFl?DbLXt_uz*)B!Ae|p2kOp==IF*H=xAam)PR7C|wTwl@ z%tXHNAu7kc@^vF!<2rX3;ZO1n9pP0&+K$d@6#8tI9>`Ak6N2I{^v7iU-^z3NMO`Ee zI5G}23s#yC@z8WV^KP@(F4W_b%0?}p!~<?)ZRaxTXGFAk|7|kt13X)8CWHRF`89r% z%YMuM<bUvozxtPd`s;uBQxwy#s-q;R_q^XCh=_r75EiT5?4o>3V<`HI&!6f~23k)K z#%=|qwh_I*ol6DovxBMV@(f5;6>xq%huDScaA3b(sWgfCzp@aC2%zoWJ+>=Tj&jcu zPd`^5wzF65D?XWyn%7LYnCaa<(cgN%Q_AdQQ@OyVG;FLi1u*QVYV=;*F3|x_98Nz| z6Txo&QifcQCnHG@zFI5+9F0ekqja-a0Z7wWy(4A0WgtyrfWLZrVh{K3YIf&C1>%#h z?VsDr@8rd+OMQMkb&uRUw>L_jj6lGPlf(97eSLYO{uJ#aX|dh}L;yyEp2h8Iw+Hk4 zo4GV2qJuBDw?8SS%E@G;=9tU*@_0N{pReXC0@5@tiYiGHFh4(<s(mVbeCZ9_;hmg( zO(1}(t8b}!q2fZ!b-cd3QJ+40as&}hCE(S?wH@)w(J^iWptw=0E#q!~e&eaFogGd9 zDCV;g0bb|j>EY!3dd5JKjhLCY8}%redAZ5MApH8dj+(s@!f<v;PX4GTvdeGedVNLa zykB445a_cfhY(8pAbNFiZLWd<sH?D-@cw2|)oe*vsx86!&CGAL4uJISC2TLhvm>E( z4z~n+_T*4@<$HChPC!S<m+KtBWY`Drm&?m+8+<-FRGo3jpMu;GufDU-`@i@<{a=~+ zzx*%$7esh{=^ak}@72XMfyRTLITlTZJplWf^&!Okqz<vY`pyoi=ca~@h~8Y@farx< zLm<%W%Nskw)twv<`T$;C+}KwpKKK$uyW5}ikT{sw_viiX+zb*@mkiVNMNvCd_ThTI z0#S1C1rhCLKdZZ|_Csa{R?UvoIqUuOvvpnoH0);t%z`5VcC(+=p-&Gd-@QBE@9SO~ z@9R1U0wR>vzL!Q(7y#&{2@!6V1ypw<!nmJ;@cw3LUw@U;mED5dorBw&(m!o39s_A# zCTE{LIV93Ic{1oPH~BY<*PR<rpJjLX9{2mN$sm02OdjI_|L%`p|GR(wrzlpPWb1So z?zdd7_d$dx4$@vopyh4VAIFEE^)7y#br|SkiTtlvNYA$mkGR>Ju&wPN4A3S;tCd;y zy<u5p@ew}ooyw6e<mF6dx?kF&TjWEm;a0ZS=jb?hrBV0m7w4FJ>M?}<NT_t9@%Tz- zx<^Bk0cp&;GZrn9SOk<Ix)HjVt<=6iqs*a$pbSYzBBR12E=v-KS+;Kw!n+;3DqDbJ zd}Em%gee}?+sVspT%+mlCzIb0y?-E*pw!jjg1zU2_QT^w2#~?8!2Df9m)q;b<)~q! zo7a&Gl1ol5;JHWS3X+Ut?h1}fM&Hf@?0I<Vj@9h$v<(i_LgvK8ckOu?C#)$W?eZRQ zQ;<{#G0&Tb+yG*bY!d9Q)ORAyQLJvZsiPK*GUw46F)`V-(5w+HF}+-`>?7&MHJL8O zkb!^EKuJ6i`C@3-*Uw`s7o1$-vMx{-SqAfLnTev!TLMLCqB=aD-^^UkOq(b+VYzm< zP0~VauGIY3=0(rfo8c-WGpOe4&3Mqm0>90r*i?3AulL~E1c}W1yxZ2jQ8YU*4_`do zG$OiZ9`TCm+)N>9HV_2T77Rnesw3qA-UIbzIofm0huj-}bV2Za+^&w$unj)?5bXc5 z-SM}fx*>=YO>V7Vuga;L9|5)>v#_T{FJah$noE~D7`8!bFAwX##(skU@Ah${Mu%n7 zdWhN(|Bks(G*K4}s|=}a27oq62aUw9P*d`3#ztwe3uwC%WHQ0zrY@VSq!O}DcD7}i zWwm$U&86q~J`<WM02XVV21|64cI|DvzPyFyMnRL&hO3Qr@T?XN1B<n8NvnbuETZxT zE*RkRn;Bg87f+8S&|PC`xq77w3$qkN>%0Kt&E>6bAm7gjw9x0UmM*xuC;ka|F>rfO zFwPDqWPZ3@y&_S{xXud#y*NGqFk5fj;d&ctTrbmnm6JObgYfQpuD(1woHh;-XDP`m zQkO%RuX6%sy^X!2Iw!62$Ag|REa+%5vhDX2ojXnwRR#P0b`H=WOF)|4wn!70_&Nb< z<)D|6xh+TIArUtDI|9Y2ZdQ1HGbhkMkAY&5rJ@9znP`=l!(OVM9eE-z)UJDS7BE;A z8f(t;D6=EEmnH;k%8J0FK}ua}&+1B*e=O^RKWsKq#){?2f$QI}utu>g!<e>39rtK_ zoUUdifFPhSLcQnVQS$mPSG{rAKZtH#Kdf0Dbx+RJ?69sgGExhmg|7`5<}N8+2p_8{ zI_=9+eh8X8@N{91+XAzXd(Ki{q5-|WMcLB55@@t8s=TVeSeIoJ@|la$DDNkcJ<7Z5 zS^H$39v!q-E;ldj=frR%)*JW!yuH%Ob3;QRCNsaN>lo^8Xd*Hw9+PF{l8MDxQ(4*l z7dLZt+E1oqi?6HvU6dy3y}g_-0c3HKm*u*MCGn~#t2Bw#jX1w`mauZpP7kLtoJfS_ z`n6gUn{!qXIR(RSE^pM&Rp~k0$<wUAfgggFG&Hpt0V5McwJx9vt)CuD04(!jQ<U#- z=KU;P<z+uDz`V}OewMz!nS=3UI=;=FbHwZgIzDvVIlyPz&mJ;8YZy=5$PKfsGGt=E zJXTs{GHhUcb#J$1<v|)<1f)UJDp(Tg)lyPLXh|rtvlA=!^0m6dlgw;dv)Em)a-h9q zv9Ar*K7_n8>=F4yOA}8|gvCK^V%aa^f<Qp_Sq~6Wol-)Ru`Wvj71b8NAWPL(>%1~q z0af+H4BA-n24<C@fhs;E<mDDxx`3H^U6$<S!;SCE(iZn-WWO51Qq+GfKUk^eE%QRj zy%6K|#m#RPfOot7KlrD=2lK!E=YN`SinJf@cXgZ*1rz`mKW(0T*(0LM*Ljiz4+C&N zO>KfxEf=Q9Ro(A?FSB>Pp+vFBb$c11+(FcWZ8f?yqtARd>}7sN4|eq5mG?cKj5^n^ z^Y{8<(!}m8HwqqCGq<;%QSr6~cBbw^rncQ;g*bX?Dlh5sb_qX<eKH-%W~}St8~`&# zNupL3WyN51Y0O4c#OK6{sH>ZC8Tg3V`fgz*Z;_T0dr}omE1Ib*Z_xIJ%|F8Tb@dve z4AduMu@z<z6{_6LNp1yTJL$?m+Z(o5YT;Zs?=}S8rud@SJBk~HVfPfLv7n%N=*i6O znl--n&*sJ+63Uc;xlF%qSl8rOkIn^QnbFG<Qtt(6Q;&!gt#^}`>R}Iisgc%l?zlS2 z)1xVoLo8MHt=kBj@$u^7noJV<ph`B_Ssx3~-teH8k$*&6PozBl<tA5$v(tqwju*9A ztn%NJL7xcyG}#mtNO}3Bdi1V~Qi=OpG+YYv^z3kAEf+gQ*x0!8l@&$ccCBc@34pw+ z2-HgxwZn}q{U;nxM)v3WCL7~K5o>h!UvhC6_Ue^HSlIZv_N8ca%Ct?HT-T2PNgVC= zHGu7QAB8~@huhtLG{^|JT^4qPO-6kJX3Gt5hZkm^m&yUF<rk`78R1xZc045l5xu#( zy<GoB0r=|u&G4WPAWDLAyRY&(h`@|}Rrf~G!CAJtsp=gMMiD~7LpkNBP5PzwyxmCj z$|=E<MnH>K+k|1ic2~rs=^mJP%vT?}Fn+;dWN}d|xauczn;W97*zXnQwQGwXL|*=7 zcR{2ETRBuBpGoW~6xyyq!WHw1gPK(?@Iv<jmzwEq7P(<+a+1-GCws*+4Mh%jUQTey zYDkFmwmzr3D863a+#A{KSCQF2FK!nn)6u#pmw8bYB{NsMeH=yAcE>=L#OtCwHJvxr zEdTaeN2C=c$5!PIds%zJvWwD}uotu36gH&6F69ZsaOv3$WdH_o%>V^<(swt6*#-4o zV?j?_M2!!2d1A5^X<jXp?ZbYQ)&Ky207*naR6uM{)7o1KDr}-xk|g{iYUwKhKQLiS z>$SrRqnUO}H8*`(DGudiIc0tqBI+lZ5rPe_PF~ySu3(q1=1c9mWT|E5>&?u|^<*-3 z+9|VzhH%35e60|Om@j8bl>!)KscELnYi*k7=c9t^0B|!0p|5O<vI1*cpMZXruB*}q zQg%%s$)C%;HB6#G2mNaG!Ka540=|3weqgA$@$nz9e)ro1U}o&9{mVbSVdiWQZp*sf zAxfyq>teOz8fiZy!u+B<ILj6{5432E9*I=cO{8kH$?;&=mpJTbEaON$J{I%ifQIgc zAin=<+EDtyP3UIbw864n!rPpo1tR<UBdy(2gT{nAq$VF-hsAdeDL=|=%Sq)l>mN_T zFyICJ4BW~16}++{W=39?>eIn!sJ6(f%5FPbZn7k1@bPq{j<zXEwS)JDemu~;dQyQI zQt31z_68gl8y%;y^T$)0YBk};)w+<JeDbgHwV_5&4EMXACYz$XxScDFQl;(1%*WHw zI(M!ii&QW->Ux<Qh2kC0l)L|I3aW{_PYnab7B5>lEmKb8NiDLlWCZQbJ~y(;%I$(B z0n!aw7x*Q`Ub6!R>j)F|vxJB)XN%^mZCTj_VU92}DQzrBFO6BznAO&Az$%RbqPJHw zrB-`2Us$M7GmsfeL`G3gIj<|fkQYqPkEixb-m={}gj9$#3fWDL<VyomBf#TBzBLqB zG^#Ovu!(4BI+n<okZTPACLD|g1gIG9@np0qt5sF7M<cU?guyf&W|HD#YOdTECdOi2 zx+@SkEbD_+7~n5|JO}XN$-(0xO-nt4)dvE&{_W~Ye)jvPyK<+})KMB#Mcto9#d4=C zyCe&eUU>Z`Kly5~x_USy5Z%LEVo}fE7GaWx5=7S6%QQ6@Tn&xk=A17N*~VGEA5=R5 zvVqtS!mR(>yCJ@#Ft=G2+Vp)H8e@b5aWEP<t~6ltzOrliY_$Q9CJDgDlcC+eo#<s^ zc-WQh9k@DqcY;cq0P;By&JL$&(d||)oM@&zABNvt=!!jC;sT(Tr2wz<>f&|*pqIuB zY>I6!joRv^9`(<|EJzA1n)GJt(Q0p8(#a)L+RaWPMMoYb*mLUHhhY~ZU`H|Q<jQpp zC?}~2D^jUf*+8zUNU@KyvBO5m*{I)>+ZdH~z%Ltnc6{KK_wWr!ai##GO}Uj6Hx>0& zP8(F>h9p>drjLOuE0oQvO)eAZ>I|MAA6P^r0$<)5(iZY^X=itf{p8c01?N}oz==nB zv2>e2VV@B#$;{Gsmt&XRf7zrVItVG`Gn=f@!jz>kL1Uh})NAJB$w+yk1Y9px1enfR zAmHcs*GhszU1fCeIY8^%p8z@-4wMHR5Zx?rJRK5fQ&vQ{p09}T)zc@c?COVi7X(^p zLxkeP-+{2Y{(*obiLHv5CEN!ARonf3Uq@je#j{MEvxmTd=RUEVCVmCI==mmBGA8e? zXGAzVnwDDr_P4kc>oST$W<3A$?Cr~Q3IJeR)?rM{ob<wrAJ<QQH>lRT(Q$J9rg#v5 z@0mbIOpCq~Atq3AK+`RZ)hXZMle8Kz{2@S#4@!*!Kwg%I<5A<cMR{MWKo#u5)B$Vx zVjwRnbul`*3-pr2WPAZ|mLv^4MoS8-IhA*3eA{7KzQ^j|2Uq&m6s#tIn|VZV!(+*H z)|Yijg|mCg-gWt0XdBYxmT6;i#_**p$YslY>~snUQl^8+S3Z?wG0kcg8MQVHqoowq zqQ`rL?UU&k0M8biyzHfka?l&P6J4Tbj~~-rBz}>iHvVga_^qFWr9erkY7=j?U7?)c z?TXNZ@7P_i<W7TSGSb=xEDF)s35hU(L6!h?G96naBf|UJ1)1{M|K<Pme*~lY`Spu4 zGJyZx>vLhm=w}+A{E>jg<u~${t48j}lMy+iU;)DE!Gr*%Pp<66uV0+n)A;W7If!Q2 z#s>D|qpv}<y!sZREJ`Fj1l!ISgD$uL$7^#@a`Si;2}@z{!FX^rTY{*cC16S>&p=pi zR_fbfmI9>C_VjREU4Ku8Yn|0KKnJ4%fv)DuUYdwp7l&a`Zg>4O+3xldgOwk=+wZLU zj>=)HoA&177Qpi-2R3%uW<-DVvexE^PS3A4#nYqd%eU`;n*bby0W&}Q;*^=6es-#c z_TjNZ%;&$KT)w^BmUaIT{UJI+(CebQ3yDvrW5^z>zFOtFC>vZRFT3k|l`6PoHy@df z0_1l++LW%vlq6^M#Wt32rH7h7MM-MFT~$5wp=?wSOT0OhTj<!`ro9b~zA_C1sQq*P zm6`blhZ-C!*Yn^`81{kOwJVU<EGvy#)`JCtgJEA$w0OyB95b-Vb$>MFoDpz2TQpKp z7CX;xW)0?ub-5toF)JIC7Ii!79F)F<-KV|@mwK1OzLMs^o2ywrOD<<iX3b1goK-bv zv6o0>_@rkc&h*%9%VWN!Hd9OpKPe!DEM+$L#Q2G1wU>#xpCzP4Y{)|01usB2JD6Dg zNDwY=<^X;D;?#l~K;ON7XBD~0Kv{hJ2M{eaD6*)`0wBef?Pcn4Zp|Q1_1Wh$oAIeO zGc0J4ie|2DWK}rF<Y`wmawd}LXOAbUEZHlwR&%C$Ne)JXtN9Y3UK)ca9-jhO6)PJd z=x2#yhN|?+_V#BOT4*mzb*Nd$#)(pSU85^g2jtf!+eyhtUOU#kmlJX3anldxJA$6S zo?f&rVHZWLb^Y5dLrQxw2tg1~KtX^YAPPvyo7m;>$w1wuZ~pZIu6)D~z1}PXF=!VH zd0bOjXw?1$zf`n6e}f)Sf_&r*_33xOT@Vbk%X}L+FJ6kabYa_zYL_kPmoJTC2G)fO zXjo!SLy`$-kQX~PfT>t$EGx5rY8X()F?xP9B@deb!ka6-r$OJ!W8v-9Er4E{TrO6U zm!=|e3}k7dcAQt0r^rF<9BVzvLCt|=<IM0CC_SchD<RUwt7=oU+^(G9L$hvJ_8aE* z!)_TgattV_3!()3ts-RALE12{>@$6OIF-A4$1|AbIWS60_OX5d5<%_0{o+j6BKY>z zxw?K2|BSBI;_@3Zy%mKnL}QGSpw4Mmm&C)-2q&tbTsT5@r1ek?jU=R#xnLH3>02GG zST;_uLFo>FbYhlZ=GxLxvLxOVm95lR<}QD%ykR9%HONvBCDRuGEjDwDm+GOMU(W!Q zqv7iEJNP+i76Y{wrUExLX5ds+;kR%A15}h15oKu%rgc#sj0Qw>vse*Ph$|x6Kr51{ z*HEcOuZvQuWxc$-v27TpqyFu3E&6hab1}*M+jT*}!7y`5;*yFbN|L6dKHR*`Y^sOD zP&slXd<E%8E~~u!>gmZ(=a<7?2Jq>@WWLFNvj9wi8{~BjW>C$0s#UhdJ{uxDrf@5I z%pn`#==Jx8oXGet@NLF3xv^&<v+#=$^j_u>eF^~QritL?g&;`K3;?&wmE5eS%Uku! zrwZ-iCw-@*zPFRrhTEa*PcF^T1s>F3sY`L%F8L0ZMT33E8}VfS%p37rd2EKHosq){ zY4Nm!(vTB3b!)WU2g4q5S41V`wNh6!-9=oAvX>VO#M95Ww=Wquo(%J9%Zzlt-`362 zvX6M0_avTWM~g<i7CUVnU*m*Xv9ev|jCmCuQGkd56(3fzj{RP$tf1uJGXgEva|-}u zKue{xpB_!sX_S}W5J*)h#Zk;amZ&nM(lV*6W33*~$z+5kKz;^51EelwPu2Nqj69lx zsJi?Xs?Q)HOH-kb-BI1EZdz^H1zC+P&3W>AQ1}J`A&Fy{0;DX70p675bkrx%?Q#u5 zh#LSK(Pz~L`PAK36-vMmpjVeSj;!dKVG2DsvY7zZ#BifsWiKkP_8<ya)1%Tj-q!o= zZm+VxfFv=nB~h|plZ-B%EI9&+@9(Gi0n6v7NAGXv$CFWBRt%iq%m>+Tx3gexn0DWk zJKx6p0hn9P=-scqYv9}o!+s9%K^Sh$KEB+?z0*&pCZpf6=gu3_8E_U6Q_@@~uaruE zon<kAys$y<SpDW^zV;{oZX2NG^P+*iXhFDSD)EC5%#WST?;jgP-7sujB9bsHg3>LB z@($-|U3v0YqF@PN=5Y9=SiJ{Bm5Q=Z_V1^u8bim^v2}F=0!#uALUh-l2!S+*h)f1i z3UGY;>Rhdui#(#4E=g-L6D=?PS`2UQr|HRLbjdiGj#fo^HD7*ldi--yy67%Cg7LCB z`<>&Y>q+0$5vy}!l2f=zbdxJ2gKs`q1xNXCU2U;&F{OYayKFo;0BAC$<>Pn0qU_}- z2bHVs2DlbIFx+{1-Z0s0v^SiDWwa^EyxbDua6DAC&K3ffc}axh$q+;;EF97$0c$fb zto>nysEFw7a6%v)f`ISeT|(0Qg$#&H^a^!AA$<xb^(mFuB!UtljbkDd)mBwKeQ|n3 zL@(c8Lrdt>lf$uLbqVe?Gl+~FW+Oh$yWKttv~KonRoFRvwJ8A_^%D^CvSOlPKM{3z zOhozyW{K@Ue7kT(yC0#4wag1<UKeFQOVmZ!0=&QXOZ1^Xkb*F67{;Sv_-@#5fRi1z z_aL&~=6bPef7{QJ_7rzN<?4}=mfemB`y8tW$<m$Z%V?%`9!wQ{(#3BdWaW&=RY|~~ zsWqf{R3`Y9vJ5^N4=@K44u}0sxn<_t)%xk-R9)b^o7tv{^aP%`7_O%304~sCyJq<U z9Ksuxl1$BdA6p+{TGO|?Vm2vSP92K9A<Q1T%9Gv@sc)gT?9+3srQeuw7L7{Z!wG<Q zH#7C;Aj<%x2cMgby%dA#dP486X9S!bP1TuKm*0X6Wg3X0kX<rbWJcMm9`-^9qRp<8 z<%G=1I;9fJiL=CJDKe%0Q0$GotUz?6(6KC)mWA5YDle>x#pP@XAfgKZYqa`uFos#G z=57L%FbFUu!e75ScNa>;++;es95WdzqKjxb61WYD$hT3cR;laWY-<1k@749EaSWi` zZea=>o*y3&=*`uwy1*mV@wzBQ`J3Q=I|Im3lbKO70x4WZmgQ|a2G=_R<=d@#62*2G z$AL&Hd*hb;q;AU(=7t8AWDxQvnulyro-0H84NFmey6Xmjs4Y7+u!z+P2{*J(ycU{3 z;Gg8_;n@BaG+HZ>k%2Y)=$kkajE1UOF9}&UUHJOZ_wOE1=X=KrI)bGRT^s3KS<vLj zk1c?f=&Rx|c2zhy22idp0rb<jeUkQh5$N=A+P<#y8@=tBNg@JRY;tw;-`~#c%0GL4 z)_A@|j%5m9t}B{Inq1NGACv>Sy8IT9K@kSHmm~m=#slY>)aql+qOqa8r7Rkw%eblS zcMH+9gGD)!#ZN!XXr^f0t^iHN2GM0iAdZ7!wsKPfSEaPGQB=mNDEe7)JzpM8hTGZ8 zEKN2=RWpYH83=Y{U@x1&_l?1B!L7RntS{i=?w}<=JA0UG5KspMhlK!v4krybWH45F zY2c7770w_cWKpgv|J9_{yifzifg<q3`K1@p;Z|=BCQ({0Dr8&LN1nlGy<r)DXP%A* z^6HqdF82Te>`f&VGSj^PgiT%n`0D8i0Y9E!YE3TY(}M|YWjWd5MXnbn{1gK<>a9hI z9mDXX+?kG*u=XZ5f|RU25aIdpVL+fUDWQ*}@eqWftibeM)uWRZQc2<nhWsB4pQNjc zJ!+@CAv|Ptn$uwl;C5Aja4^hlXj<Kn<)%_$d;)g69f=+dAXRPX6&gr->?4=tcZ0-` z{gl}|roqL({f(+oR>cm4#nrku%80Pv*Sm5TL}3&M0O~y_X-Gu#n@xZC@U4jMgPVJR zs7bkU8bN-%LVj;8W)iag&PlOe#|NFrN2Bk9TY34*yUidk`76-(a5Mz?X0cXl4@P}3 z@@lIF{_Sc5;Ot;3nkQ)&CrP4)atAZ>V^9CX`LlfQAAZ4KhbELDLCJg9)z?^dDe!C- z79XT=IJ4$z!3$bwqOY3S-K1|=`UHA^v#=hLk_Td@^x$)~@nSP4--WWm*XN?B`svYB z&G3~mEUW}oznA7^31D56$CJ_JY}w0_c=D97WMM<V3O+GG{8`sEfI+PFSz$cj)5D4R zvxHF^QPvVn$3p<`Zsq_Y=sJzN%+g_&sy(YqRrp7ksyq12t8)Y)iw-^_Xv{KFEUg)j zx=a!g0bfN64Q(>vK+C>B0H&h>IdlXQt;<?{4z!dX1Jp}&T$F%SUIF;s(-RQ=`0hfT zfpYy%52r+`wA9699o@+VL|k;+HcMi`1+%(aLfDZEo7yQ_7u6P^CkG=1oKQY7GYCbs zQ#DkUAAY@96Ja_WD8E?|60<b1mWT?KCvl`sJRF=7QMP(dq>Uld<(W1`38H?QD87%9 zG}#m-2owZ1dSSg|BHHb0B2?RbKu)#N^k8<TrSAJ~(#p<QGw-n3M3fI(=li3UB#Uex zP5r-LxBb#DLlDv4T>YK&k}9t_3_#dcyC5V2!Y~NJM`%HR=oBssDw{XFF)cS}(~apH z9n5EHg>3o$eu2LbaqllUHs7wxDxN%7EArW!Hg*8WjBk1{8o046H8`Z|0VKpoXp`t< zqn8g9B6XDfQuhWA#&x*6wAf|th01|Y`G;<m))I{L5{!P$iFO6z(eb9*sBP0EUaZy( zj0gSQ>Oy${jjSXIbFWdQ3NOnl=*=#M?xL$+g8?|EwCqIUykY5B8}$jvZ3en|@aoIF ztimv4APT4~izo~m35HKFlJDN$DPb8;Ui7zj4_KX%8od$@(E*2m3QZAAw;YFv>h1sW z-31J(+sY*_lvszL*Sda%Xeg~1T7l$0OF<TRnO;wz+YhD#lq6AJZVAY%t=1<Y+%DH( zY|5=wl~Nb-`ROr$<H?Xzl`Y|TG6EqlDv;`LO@m%)9bElwxg|mzg=(M%gA)*?e4%&i zxBAG-O38Pqv6L5;_GLjy9LWxkvS*@=@>`0QY$+jIV(iBOKp`a{0Q0by>@Ra~hA}V8 zZoen;Ui?8X29bK2%BC9j6A<2B&7r(ups4l$^-`Pb$MrG?@YUJWZu8-=2I->zhVd7> z?VgB&C<sFWQI&7Q7!*)hY>ANe;@yvH0Ogp1@RzcnAHrgPx@YMP%e1dw8p4ef@CRxT z+_#a826r_-vK7O&+|ybWuP$B0BP-(Og|-v99k|sb^-AHLMlAvw#fb3Y*Ns$h6NvGF z(|1?N-iQ5M)SIyEbq8Bn%A%EuzP4VP<YlS8SQn+*{%|}1^YwC_#gWBu@8$^q(G)*w zTc-)bBIjtOCoB!y!L!TlF@&J7RKk)}b{WuawRY&RQiKDqax~malTBG3k4IPYWnNZU z5*wp~xbd9tHGuB@lOO%`jH;J}G2`X3sL>{I1HAyQVY~}C^mM|SGys3DXW0SK^-yAF zPUBdkmmv~AKREz2Iufw1w$|=bK=p+JNE#9FezqV}O-n?Zq9o9{rA(_=mu&VIX!PQ> z$pwK)UK3xi41hxqeH$+TShJiQ5Rz+E=|ytTDC-iz0INO)E_xz7l+czhh(Ub<VM{w5 zq)nk~T|gCWbyZSEAVkxQq>hPMDsR3q)-X5bEaSq8NR*ckw%dqRj%)Y0%HaK0Yg2@= z^A0aw-KxUhte+5}Dt2iv{_O&=##aO(fhc;vt)B%pj>N88%%f)5=odtHxedd<ND`x2 z2hwbGD6L+{J>`yRhQwIur^(@X(7;FlvflN`s5Y)m=#oGdfE$h?KaB3&0lnNpUq+Mh z)5vbRZLMUYOZuvrdcNKO825Ge*4_FF;8JxcOC3AkN>R#XnRnFBogL}Wr7Q@x+_c1S zc>pXot%_mQF~;01o4G$dnphaFuD(@smN`0+k)m{@50A*IKTGK=Ay{F9wFb{E8B8<5 z$iL_0HAMG1@j0dm!%0mrHDs=RF-xhv@3(efp--|Y%EQTUQ<ltpG#*~fml3WTz|6wG zY!`$}I?t1XF?1J2x2y{7aT0IkAXLxJ4gjSD^805`)SutKy-*(%2%Q~{)nzU=xvVL& z;Hb_>RRrm}IOC8#KRF=a#=xQS7abe|3K0oJGy=466-<5YrYMPVexoat2D)-dPTztU z?Ifg{x}z)}hZSv*8fp-I8k|KX>W|e&)yPs2S<)o36F@kAN}!D25IJ3OYaLp_YM6wF z>WHBFE0ldwnQ&5pQvxC0(~Jl~8iTNfD+~=txANUtEiOVt5fKvV!FsiwYBhJwP>-<Y z2G56!mkXBn-1ITiR+nK3XjXGaJ~-9ACPeE=A{>q~sD4VOdRXoA!Oln)i2>YRU8xWA z8vuCn{Oq?Z#9<6L$8}%N@@&ET;~0eP53A|0PXHDhEFTsNiw0?;Oh`K%8$AcFMLWMQ z&W_tgj!mZhe10X@_r3j4BfT3PekGB3ee*+C{?~g9f`Y_tDXYeaZF2SQ9-TltX8R~a zW^^?KHa}M4I0qv|KElm%4RDqu>icMT3`TCEubuoF_Nz}mni$CV6r)+(Ot!v|$8~2f z2GUN9!*YO|EH+ja1|v;kWo?WGy-~lXC~0bTu*Q?3pOBHtBSJ4t6bvgN5hLNGr%|i& zALBxe*0s+cv{@AbJ2^vBMM|dK5CKn*^l1O~^|?^^0(U7&s=IJ79^^%3aknED@`wjV z56lSO-uMnmR<ouEqS#sl(p~>t+ZWF%V7me%XH~Ne6_X5z-qqT{Mv|F5MY*%XDXF)H zkS39(%Ml?QKO<0Y@kW~+E|$h1td+=y5V9tsbzTr?T@(OCQ7H2tHCvO-77nqfBodrG zFAiV{$*>&@0319Sx@nNQ<~xtA-7yn-1;TJiP}|?hkF84#fX}w@8db?!MrKUEnl@ar z*^e^_dUaERqmd7`IxBuY*m_JPfSoNqf7EjE<{ZG;XHPe)5}?tvM?__@P15MikFWpM z0az>EFE&^dL^K@^wzCBj!mBNS?8zT^^O`{~o*ccpxPBObKZ#ACX64R#K_&z}nie<Z z45iu`b<v;r9t7=*vEH+T4@M+r0K56yO;sukP`fXxs=+l{msL}-*#tB_Jo1B5=91gp z`fwNeK3a&Rn@YxA@cbBxmq*I*1Rmg%i<>PNi*lPL(Wa;vd@$(WtTq4#Tor%}6|~V? zitNj`-3Fy?hac+=H%cpUxAc{i(UNs_BEF7BCwZB3k<1ipCG^tda6DYA_DyX0Shfg9 z$E%8JdptIAn!JQ4M*97;Q|NL4pjD)#{#4rlI6VMFrv&9p!*sK@>-$>fP*3tv5bT6F zp^>Aq#l1%IK_(id;E5Zu<}Ef7Pofu=rvojyOD0xl>Vl}D2T4|4!lXY<uV@jx1sdsL ziJeYkDmY7fNQqGDlJUf1VFsNjB_KK&K+C^sTudoe0bUSlXl)}R^e6?;qmgxOyX_`_ z_Tc6=g0<B6FE#2*x@Um4l_eL&0P;n1Jrp1OqfD8!AtwMIa({laezVH~q)&SQ=H(7V zdAuVaJV^;yfI&!xJpg&6NWV3R28Tl;{5V?!=nWGPY869%7=Z4ZaovzK%d@YZZ^~b= z(@%qT48~_q4qsl}*eKSx-%|;$#l^Srpikh%YBTBgE;hFh05IbNT%@}O0SUi{9tp!u zdC|MC_JMKtL0>gj+fa#WqM()=BVTne8mb>{=Wjc~{Vt}jJ9q9<sPqdFEy{E@U{@;H zqh1E^N(U7fLbBUVxBxaLEZOh5VD-XG-=|_rJGsYjlY6@dcH?PU2hn<m1e_h|t~+N( z&WQi+)j5E?+8zx10CL@XM>xG+`l&rtStUPTxI>o{c|mD(@WSATRgX}h?1Ev}Hc6zP zrT(HT-C^b|i3?+U$!BT*v)k{hIvVz}O;Oez(p??H{@!Avu8OvYUI9<c7%sreEL!gp z0D5{f0ccZ}&;m~`%@>WI0hBG?s2gg_SY2v>cwLla!nW4MQ=v7b7$1cZ7{!1A&>#YE zgOZ3SQG$M~Mg1rtqMEKi6!cOessf$hw82}G@uZ!FL!y*oBFbo}5wycx_vKck@QV2l zwKj9xQOB>CfxDk6+Olu#WX#(j+Fg6bU|?~x*_K;qzBB554N%sPVTxp+B#S}2YG<!E zi~;~*6cDiAGXZfHsY_hk<N%Eh`u3}`*g{%gF30WBDP6%gJeQmwlMudlDf4YI+Y@Lv z+7nR_kiN9Lcbg8v_RX)>`%eqNwasNQGpH8*wjf%ZNJZ8A0QfF@t!w&y2$&ni>r(g1 z_jMT_-4uAN8dujq?N|=S!<)rQZR0A58PQNX4Vz;9cr3qTyAJeik(ynIwGA<0wJ5uI zJ&6j#ZZ%>hamcb_;*qw-ub4yea{o-0;X)+dQUHSR;&nW7Oz##YT>UZbXGOJD?|w+6 z2Fi3aP-PgFRtghCS(ke?bgXy~tg@-8?*u3>O9jKKS_8oEo<33A|M2!wUDHt2QvwW} z9Zb|D>pBYCIhXlhG%!7{ItHeiinAo%?)JSj*%YM_@pQcp(2R&Y^bqe)LU4<wz}yCG zSKRC<Rg$i5TMc-B3o-|bl&w`<a(=CZVWIUbiXTj-@ZhV7#4}eIX7L=&n5|JmF+U^m zI}O+_;c9`oQ~K_{`)=0VQ%2GW$pjFByQw7)%wAmcy$@E*Z%>AHFPCrT?CXVDd2SL) z9*+EHdp%fnIiOi1OrU^*n;igt8UfgrI}irrjEJgY3m^;w5ca!0KtWjB+Z6->2-~vy zg$Nv6Z2>UxdR`DATk!rU1_2*P&q@X%KIx(xmap^ipihL)pBx>IhHtNDFHWXJ^c)9o zE^nD=+)r2QhxNQZxD4r$Q?zqr=q?zRRUsWf-dGCbLa8M$D{n08J|siCAMSqD_|a$I zxEURDnZL(o#8rKjms|DsbT9xgTWR1Av1oCpyLRPE>*2wgtoy^s{0Q#GBNy^vSh$TO z%32^2QzB-FO|?y<n2F13Ta;VXzwcr;Pvf}3S`xKJf-Ne`Ooh*SPf!}Nb-J6RL|_?! zl<l**PhH0AX+AWbhFW(x8e+tovdXLN^<t$QM`>fQxG%)5f@t8Yr<zEm3XX+{8v}?B zzfyk;ZhnL)N^UGJ3gQdus`V>FG77`c`fR~rywxBUE3}(oO8_zfW`qDK5twd32nU%0 zJneS^AWA5b5V(i?EfHmu5K$i^5Cy^Avoi_Ur6$Pno<VKo^TE68haWwaQAaNGZXUaM zb>~;>GT*9SD_Gj^YXUMQJ3%P(Er6__ScJ1zW4zUn2>V^Ft}n@A5aw5F0R2&_b~2jw z04#1c${P+ZxBBv5L`+nbI|7CWJ%T=55C#P7wtEnTVXf{`5CsGTApuksTRZN(4z$+( za_=D7B56UJX4@tD7XlqS>Vc!Ae<FzLUOwX|1iYk+`_Bu&xZhuHat3Y|t4+CEtT(e> zN_tXaFczzPG{{igKVA?WPe)1w)f#oZ)Uz?-$us+TRV*6~2j${4P)N0nTe{Z?IGK(l z3~z6Kly<C2YpK68!SyXfJHki20i8j+M|y~NQlH7U9G)K^+8A|S>Ojq8r29`5RRw4j zx)zwX9o`P~ZS*K~FmXo~{Ep0SV@|ts%U^=Oj=>?+p&{fs4u*Z@%c>)8woJSORC6bm z2*lE)Vc#RBMlr4s(DK8^baznN5t|8~8k9(okxZk=rmgJCjYXFj&dcig@xhy`TUG3< zVl7@=#N<#}G@oauY|&+V-7}8)zG3~~fR?*v!#Egx(f8Ui-VI<f6icMtosR8ow=D9| zS7<EIFA*A~s2fXLXX1DCQc``v$NOadIZJKEJ71;g$q>N%m$&d~{vz^ViTP;Nhza#P zwVB)AB<W#wLg1pHBGMuhz^%-x9!P9kQJCDlJu$V#ey7i>Dz^aQMGas-sL9;MZMBEe z&;a(Ya}cTl09E`-(e;i#+*_5)u%D^twp<j-NRF;{0Cvyt>n&<3`-}b;t94F<(V(y5 zZRc0FPfres@!j^dYT7zqZ^r!|5!HsfZ*??lV|>()X~ys?852#|A+L-C&4Q&5+vWWT z(ivRhd-17(=viXamkJI4w(99%H1H{}%)a015gx?O*^@SY7=1^*O#Ps&b~bbuht4!P zF$rB;jv`r@wt@vJFx#4WtbnC#|18U3Oj!$kFFIq}etAz0CU%-zYzp#KaL9?R_zi=| zzZ*^-%GM?_1B*=_M_R4ImWwFyAo=0N@qwCIuNNyd!?vVS^-6VaUz{H4d3rKZ@Aice zJyl(I0OUn!bHkRtr0Qo#sD5NgoL5_hU*YW+eyR#!kLxQGNQe;}#BX=HzdBM7(K5f) zSQYv(mJ$Ia|ExDY3JF*Sd*^Nfpws~#0HVtMNg$*Y6CtBftK5Lvpw$llN-(bXOw|5u z1IXoXT!ZCbf`a}YKW4c;Ul5_pcg8U#5bbxh`ZF6O1S<2bx{9nH17v+ub#xVa1rS9c z8ty63_D~1o49epKRPZ(k^b?ETZvpU^F%c?r(8<vNK(VO+D93cS-TQ8FKqdlAK$%xo zOoN0%nH-RYHDMWTw%w$Fb{&^?dSQZy2X>;YuDqLwSnx~5bkFz&RU2a7VE9s<zqUdL zyROt)@SGh_g2DK+_{G1O|ERb2MV!xg3eiA}L2oW^A7nX4pVXbdJ9*3^?nliyX}fFi zV}KS9=ExY(!ovViR#gN&K^J$O=c8?aCi-?sT6rT$@Q#ustg0OwEO{~=>2%I)0U(KE z7DWWMT=;>D|G@Kq^tShf8VF9<R(ZjJe>XfvGjYSeXYjb+8})mO^#;JO->bG;_+c&~ zc?c)526&ASTTJOr@es?!VshFEvRy5qo1)bUXnV57Hh;D$OJyIZ;Ino8rOmM&Q%tG# z1qFOI-9)mkn~3oefdc!Nhp+aNu159#^!D~kmU_>0mw)^q`u;W+nS}SAqeUn?02~Qi zKO-Yv;s%iE2535wu$7C0W$L&_9{zOENKKH_Epe@#SOj3Knh5Jyk4vQNxBGfuL&&$O zfO9gd0qlo0X^Bc~%N;;T77=0h^G2OQH6oa(Ms&F)An(^9n3;l`oh8j~RwaOR#Q^Gq z2w=K2q6Gx33IMdKKp6FV0A{=8M?WTAwr(0=jQc(H3}z@l(F}LT&zTpi&1ldkLe0F| zXpPvKnYdZ0FPDFR`*X+IEuuKM7l7{$f3=Hi@mS(9Q<pG`r#B?#%X<=+{Ky-vGK-?e z(ZO(_wwW#0AOA4mrr_3Be9zf#wzaW2b`aVTNfO~9q2!K9p(}s=E937&Tl<V7_N9PZ z-R{7^!JvP;-e`eIa9M5vWYbt=xm!tfsR!v4D6Qs@Q+jDIrR7Lti@l;YNyD&HpcGBU zyO`3AfVQ1MH)WZnaX5OK;hj5gSxCmbI}8%^jY>lYB3eLo>I`C~jIP>W3FZ0*a+@8H z$4&}@0Ka%)=J4^1mPQa5ezC;IE=orGqnGK)aCWh>4W6xl3(1C>u3pS1(L0GXC2cK) zrAfjn3l$f=-YIbj9+}2wxcIWde-ahgUSh{+iW5sYYm=X1FTG*~o!!gG`m{ZHJ{N|h zMvbI1PaEoY)`SsK(00mqe6L?<bJ^A*PCJ%9RR`jGM!0%5uP?3%7!UhO=}f^e?r2qT z|FYZOIbx%Tq7R;V=~0_?B~(S*Sn=58MX_}_%r?2m0UwO|_Op#c0$M=o!{OtX;IbaU zlhHsIxmMebNK7YUcl1zdXhaDJ_M_Uewc@(aw%A6*kiR-RQ6Dah`UGshGykM4Rp+ax zC+^u!U7gbTOb1|3WSNr@S9w31*_Hh)m0TwU!&wq54q9GS0G=L9*t;@);oQ{8(kEGM zcja~ma4(73mIM(9th9xt+D;b7jrSrNKeHgvpTAKbS4ByFrKN2RqE+mHo)vR|Lp~+` z0H*?>TSPoPn&wsITp?*coW>bqB1&|nX@giqL<pmx;q_`JtpQ*i-jo~oO=G+&8j>JQ z4(}fk@{Qu~p-E(qu1?;K$?N{tW_F?dp{m%b`=P{gRq2bmv}~Y9c$IHKl=fnE)T-P` zr3+HwSt6*AtO^B#03<!#$zXo9Qun$)(uo^Yt`nzGv8j~dm1H4+y3j{g;qmZ7GkE#S z7>ugWl|19aK7eAQ_-Y8lfQfdM&hLbwJ0E~T#h@l#&!ZSpyIl>aQ#A!h%;ly6D81E! z+xxNN6$ko85v4uNjN5*{CZL)CCOQpJe7+?@lGjzZ1tByE$l!Ws@BDgE0LT^$V1E=5 zVf%6or759m^OiY*m2%T$*axt_o}V0yNtX<mW(~{I*49L~I{?YimjrPBo`}y5r_f?~ z)ETq;pk>fYRbLG?qTk=l&yJ@=nAh`P6@U!{vFl|)B<k5er3J9takMUqqsd4D>(yc@ zp*9vSfBqqR?`N@_??4+1r6jeA^mUy~M|PU}$yd~RBqRz1_tx^`f8F}VrhYe#{=q(< zN@h9rx3V)(Q<p}<xF|veM*SW$s@;}>WnQRRJ&B_3OZf;BgFoc@Kdic`gL2%ebM;D} zrNghb-&VUQ)~VlWyOY~flb+@7nkVTj<TnH%5oq>ea3wKLUfPw$Iu~9GBU|=@jike= zOWDuyXFU*N^cs962rOq$6saZ5>VlbIVl``b;_iM|6B!9X6A%?203ePZmf2A^alhN& z`&=Jb?)kZ0-h6*Goc3HTwn<01M{DH$ye^RtmE$77;#5kF)8}%ZuK9#{f_9%~j5<9T zVe+$Xf<%_V>v~0yR(ZB=s0#m*DbxZrB2})tFkI~qc`Pc?(^q#}B9iKv#yNIM*5<YH zjYpfU6a`2yVIc36g*R-eTdoO|NVph}Q^mSnAsK{Zu#2Bl>rHm5GrtH6&u?a=cqfF# zCLgR*0-^uw;V;gP4#;)F#-Nv7&Xz>@{qr*wiu%)=_Xs}a5kK4mzGrDU$5Nx;MWZa^ z&PmrP*U8&Q*LmF)tLFPQ?YJHSLwRP;j;Csqx1tYS&ycYA5po_)B9%`+^9p|$02b>U z#{L*_2CynKW#%M`{c=v9QOh4$@ym^KyF2VJv=8a=Q?Qdll0qwz)-1hwMv}x~|2W}G zs6;7HH)b%0Yc5P@%Td{dQd~PcBBPDPTGH97J)3d{@>D3ul}GxT8-U+osi96LOaTTX z`)ZI8fP!!+s5%m0p@eN4E6s!Oid^B{eG$QJQGBB~yvyaaJy`B{N$dS1-t))Jp%1oQ zJOAm%g?5>}vN0B6Q?jgGf?sdu#uB-PR)AEJ_9hmmqzF;aVxDJowbem|k!o|RgM{_2 zmT~fOQ-M6+l#FjmgsRvQDDB1S>~`O;)cq<afboMth~ICa>48dR1XZN@RuMCU!pp5> z^{-|*2-%DQ?4QI0R6nfLqdpk*0m5Pp01F+~nvMoUI6a#F>Ge5))1#^GVWsOzR0Gb! z8m{5>mVoT|&p_bKTeVvCz<6_cYa255vsB$W+s@Mb!<LCjgw@T@0ODQ-(s9~hFC$W| zJn`n@!(6H6w8jkRb{CL#$gj4{)*EH$#wTBcX>s*!a`1vci_Jof!$B{*EtjA0h|!~_ z*k7_VWgFn>ai9Z+9|YGnZnPIG9h}B4Y+F`(Wo|z3<DA0oEG&C83W=I3^~;RXd2%rr zg(4Y=iJiS2H1`Ae2l!|N{)k_F_=9Ev!!}ZXb}#{WQ&wO~qquot@?G<9b?-@^2svs! z1NTGaQOr<k)QQ#TsV)2fIu^a7ONUP<2?${nZe`jP08xyda50IQx2<F<2nkdmlu{Zh z8Wey*3vC-93Zu{&HlfsQNP*`mw>Qx5PA!!m?u6%C6XP{CriQcyfS?LXWSF<ibu=~Y zB_h(>ltK){04}(yV&i*t0%@i!c$#0W)YdlM3mx)>EqHM*TCKq#Gfi*mqBcQkjpgA* z1pr^f%91Jz{q)91+5;*!x^F}n2260FU~`gT6o@qh!8C?oMY5#;kWeF$FS&@qSe0Wd zF6tUBnfZ-Pwv?o%iO8o48kcO0DQX41B6<>v&45#Wbuw*W+o1`v9|@5!6>W{2MzF>6 zdYfkswB~1K!;OMuC_{vo_!naev({5n_vy*uxMmQ3O{jv<hO289O18BN9(>{xi1?ui z`6CWUkAPuEd|)$QIY+n)T&X2BWR}fV-yPzeJ#?BRzx-N+LUH>^Ax&b1=q&1$PY=gn z%+?!jt8$3{dTQ#vY?egdIEqv-w%YChK%`^s8GU(nZ0E|QA?fu*w%BeN9e!a~_Mtg@ ztFEp}a-_TdFfDBdeg92jc%7HlPVS|#&rp_(XlAc9gI=4S^(_oVM(48ie~nuLjhc9Q zN5-^!OD)N3>s(vnN)V;S4=!GfP2ioQ|Hp$I6=qNr1>W!dT(bS|&wus4u9<6AdJD4Q zHnUPymVtX0=9SaEi1bR<jbjB0wHy|6G~@xvvW>`r0m0Wr)8fxIph;fy@P=flrHQa> zcx9vcY?1@66M)6KMo3mGOPkn;=!I+xZH)U(@TI$a{+%D$CXvJtl=_w`EuI}60GJMY z0R7d^Z`ARhpB#d)+T`9-o#pnKM3*}Nz0*JHGg!X_=<~B<0)9TfvbF6@yx8PQ#LeF2 z<tA^C&&U1D4x#1c_W<HSPhHDmlf!gidvS6|gmoOQXD<oVPg4+1r(-(~FJ=p3esVY= z;PilqaDFo<qJA&6go*j)gVL4VFMueU;+pwa_I?52-PH_)r$^KB@;d;lyojPL0h_Ka z8lMJ$KMCSK0?E|-=}qpkKZ8}zY=n;$BS8I160bT>mG6C;cb?eYKf7IS)S)wxPGca6 zV}UHb!QdDBdL_di3b%Thn8arsMgFYlS2WRm7s(F~>MkSWgDjGVpR=pfY1|NrxZ|%z zc1RDpC3y)T$9k1MVbJXbwyRFb=RJW?*B;`wH!~pp*xH#7DY5CW=0qs~HGHrA&R)Ct zM_lro@2?@aY(PiiQ(#wjnAfTo!He|z^4a9dMx~;eLAyr0*Syy7g)!M<(#p)PNLPw5 zwY(m8^UTTHx0i(=F-gpp>3r|pvZLRr$5#COJ%Gd*GgY($AvDa4@IrXZjMXd$(3|U# zy+4UTpdVH`6g(X0YhG*sV4><kX*wF1jwPs_yY0&+!{lO})go?^vR7C(tq|`NY%L%} z>k*c@TXzp^w-RfAP@Cm#aL?6ak=MZ3nK(ow(nc&<&>!CoNiFN5RQ)v7d8{|3em#f3 zA^@vn)$DXy)h%2X)t6@{1p4Xy#iwatWC1vDNlghQECN(#P`&tEB>Mcxk^JFH(|yT! zOP&vUJQ>PwS4G)s;e`Mmz&svbyRe2IdCO<34GW|vL%k-t7k2pWc1zrvTFpP1VN@w& zf*Zv=4T%r<qMmnN>EmwF-{`{dJGN$D4%EHv>$|%5G>s(uNi6hyKerjVs*gqlSpMOc zt4d70)6M;W5EDIGP-0i@?;Ny#;gt%X${|Lgaft~N5(pQsXS?m*XCSbQGqIB4AuSL= zggV!;`oIu$b(j~xm$90KZKT(deu+@5x0dLuoK8iGhG8IUp??tpR=2)1IyMR(wv{T$ zLu3fLfsR+xUhR-*zxQf3id^SM(;FRO-j8do`yJ{KiDD@$zBE9)AGAtcIo6Lj40WJi zrDF-$jhKWul(i@t6@Sh6uoIwwB`pYfHF%<{PNdaT&e?uVuK0}`tv*Py$b|7getd$7 zBqf3f>%54Men+6y%@68yRHpXn(bN{Qy}O<f@zbLN5S|@@KyR*Z)ow<8ox~+zw%P!Q z@^zHz7ST-nezvgPHB|jYKTRC9kQqcu5opj$6}y6%M<>bhvii6g<nz;`O;LfMgc`qk z_Cy7<USjp@O<RL31!%P?&W@(UbasFr&o5QXrmp#yX}H}1z<=|Twltm9P_s~1cc9$| zsASzUBhJ<v08bAmYRd_F>KC`BN|+yWfHvxR^}70tVq2w2#O#50&_4pOUte_tXB&OF zIZ^kHdvAAZ3o{gJ*jN^~kWL;zM1c{?QEk-}uvK{NoV=q@Z9m`d1Vm{!F#us4J4`b# zT44c9tPe>?KBwqAYzv5hA=-``WS<!amhN*a;B0>#NNHcyTCSt9udL{mYr33f0MtsI z!YJy&WKXqZZm*x%v$6?P0BJ8#$I>~}cEJq1jx=QV34q9EQtO)Mmn-$#{wTATW|FB` zFA8SV`#Ow*hF-RH1&OI?2>C&2X5SAYG=tKX>P?=^O0&#UHUxx6R3m2pwG_m65`APl zBG_y?0SmQm$(x2DaQT#Gac<s08O`Ej2IBQQb^3?LQ-CIeo-)J!^5-{DkzoKtD;-BQ zDjf4%((<CqEkN1nAJr4*^-DEUzc@RF3K7F~*i}E7uQwX)V23CxR%WB^(qz!He=gpC zt5zn%J{a>=4#H&6SNs3s?3jS-<x6(uxk7VBbmkGg9btp=Z1W68nS_0Hcd3zSeBWku zwDh*U1|GoZ#JOP~1jfuFN&?}Le^4pMhhh^0#7_<;i*>G^=D~PKM2F+y<$M9)a57qM z*7$TwbWeDe9=f^@u?Lui&aNMvu<s1rcV{1=03u`5_S6*b>EY*e?~(4)UI(Ci0<uD1 zv_sHdZb+tmz2a9p?(1=AQ71(NAah!~?gpxlK}cR1r~pWj{xsz)dv0tTMnPjUw8e~k zml1wY7ohO*`hxT@;!2JZ?#=|muMFkd>+VM6l>jwB_uWs|n?(_)QN8Dh;`IpmO!L<J z846~XXl(R9Za#69nI!mHV4`+I*asqP=n2MkBvT<X5{%A9AXcBjF}=xkjuY02XinG> zl=kzla5>V(3Q^%h9vc~wT&XVbvQo#-j(;yBz|cWp5J&}qVRB>P#nz4nb!sXOOoVKv zd0UDqylsbq=No;?L^N1^HCyMJEidklEK1U@Wrz9-HQDjT>S5PNikq*t=4yK^FLJ?N z$pAA^f9?oMTd55vOK$o|KADbJ>o*{ZvsCS2Q&bGRyPgp+=w(D$ZVCeCz0}Ua_7SVb z9;1F{TT*VyvX`b-#!?H`GC(+<jI4#EYVobrN6hbU=hpwm$b0oiCrN3V1LpJX{qw}- zY|+aSVoJu(K(yK{^?gt9>n$4cYui!~$_ppmg-}V=e##{hFhReXVbNu1_$4ud)<^fF zWLa$ioE=Q;$<0=4>NxSP>REo^J9Ozqr*Tvo6jx-c$*|9Shc&`z>&<yu(D2{SgCIdF z1EdXXqs|(YhR^Ded*Nt9)WqN*^n7LeZN2A)rV_k>t#`yQd>C%+79BMz)cpfd>fYcS zb^n$?fukv*{VQsamHzsD5YT>ChjEB@BS2>93rgkkCh<primO-^VaL{NDp0MJMs0Uo z_e4$oWU7z7W;`*PeyLQ85fzy%aGR+;?%fP;UP}i{zF?c#gUiTj<aZHTcOch-!X4Mq z0U!mH+zl2_yP3*#rzJbnwnD+JmR)vF4bRW7C>Ny+qPwEeNbZUc!xhXyFp3Q%fryPn zFcFZP{6SsL^6FbM4Zjuj$y%dtE^nFf*^@(=GkJA!O^nf?55jVttMj;7t_f62txH{# zr*9gIvRwA?pPL%1x*S?RGiGkm${>ZlNJz-}HUT}H1MW?ndQvAC+rGL=a?{kC{klx7 z8ca;@Z|1#TN~Xz$GM;5`&QA%zkFE0jIF!8)N<F<@5jSFH&P*O!I<=*3F3tBU6yJfY z==z=fyD&MbG>PsvMH;Pug_cuG99rOQFkA)0REPyi_yn5FARl@yCI%jGdT8r(480z0 zM*Ywo!fFB&HCx%BD^Xg@PNffVE1cW<AUJp3+a`{RmDEDwS_g;4#?s#n@c!r9ZM9>? zPiC)QLWdP5gPcNN6FytmfQqYLw+^mwoCPV#N+ytlMTlyWcD1XJytdveN$_PKhQn$P zkz_?zo^`j~yNJ3;qO0d$Y;@PW>}GForOmb)dyA|lRN9aAKEKxi^Kz_jzKyZN<Xiz= zv*qfrohK=kP`r5o>`x1hk)(>c1-@EXhVV#*q#lV#yF!h{CRZ0e>}57GY_ZUSiU|(8 z7nF5y*ribX_%IVNUvB_R2P&+hiWKPI{P4=!73`Ea*wNyxk4&z**+mV>b-9;*v%ynd z<;A9`h?Fdy8?7tT8vwwQgE1L{V6`cQDyxR!w^z4hWSjxqEL^s=pQW~RMM>{DUIo+1 z!Kk4%qZH)|JStlIJUvl@SG)excQ^l9tvnnLuNNx<LaGQ@|BVQW_mV^%W|Nl$tcx=J zY^WyB$RyhEX7(uo*w)Jm^~XxianDZ<>5l31YVMUJ9~s>!wN37~rn#DX$#YdF(+R_A z5<e6x=FVn(kBnI7l1*(R)#c8+KJLQY=1DYiOZqqUL1;%yN{IopT+@zPxa-ZoO?UG? z-q0PPW78B|L})c*$e?d~=di65y3jL_E^q5K=<IKE&%3gFgm9AN!aS(+&{!_t%m9?d zHc2DtGP1xmJ?RIuFMST1F*V{|WG|vNWFm7PTq_&Bi7Hn$gdnwUe579o)!9Zp9;;BO z8nUVlEcc4Yl9;U4AV8?{or`;VQ5?;b4y8tjp91%Fk!;)(BI;yg(C{_1**Zpgj<&p4 ziEP|>OBz*6?rA<fny7=WH*eJ*pB^8m^ROAszxw&D`o*)8LmL|PqCc|@{GfDnu?5gO z{d2w9`jtBM&rgrlmOr0gL6j=_b$~3}XgcTB1*m1Fn>spkG~>e_qnM0D*XiNJzSqn3 zOLf(8FC(Z<tn~WoR{dJx-+Yr3aNFCEr<lgfG+*UJ7#lmlRwD~<o(!|ybv^P#rI}bf zY!c7Q^f9!3P=w05GZ38-<Z{E1%@lp9=!cf;`RZsg1Y>*q(+M4H$`YVIE#H7}z!O`w z_946c$i)^rv60=*`f)Sq_DPqhjaZM?ZfwPU`4O|PhgVXP7c#qsPI$c=UpxN{2TuT` zxU^qu%J)OL=0;~7pi|fxU?gXnPf-N=B?*ui9~JG?tQSl3ywX+x8C@l<UD!-bu%%9z zcl&R7y7-Xi26S~(zjsB02K-<{x*&Qi;@V4o`{OkQ0As(e(=680QG+69KGpl06`K04 zFg(32Gr@?u(FT~gbZDap)lONW=vS(J6Srd2<iA0#C4fZ^c&rTOa91<)UYxn-e@l@- zBOIY`nTtn?!?k*p37QRD#@Hjq$XKMzE?ZYm4?p)fh^23DR2^N*Ip+<#lca`X5B#9C zA9Et1$!SGNy(%a9ZgWFE!X&nRGX%}rD~~&7V(%>hHBC@rDeuwHP<5k61a(;i`Ap25 zngvS|^Way_l3-iQDhjh_GWY@~5Js|n4l{5t8USkmN8=%glsBb(;?GZytj+)O{WXAP z>QuL)=@%fZRcoNhqu$~yi8n<>z?12ih(M!&=-=P00o;;Pe*Sv&f`~3q{CWVqKZ}$v zo(2gKdPEeE?P*N`d9lDx1HccGn;zn5{gOpSp9BnlSYb^X$L&oO`Zln&t8j?X**&qf z#AiJy@g<Qz3*dJ$_npzE`k)lXw;&t%z1`g2ykM??(m-Nu7&eaE6}a{-xO>_}cRo_b z*EJhGI11y$6ZenO=)t47eLi|zUA>;~>pD(CQKHdhi>a{0z6L-+xZl?lgt%AO)1^)= zS&3yKiZ@CKE;sD2Z3(%w$h%Ub)3JYTFj`2o%4%u~XusF*iELgMTsZqOJN~^oo#N*o z)YG@*l`_)RIH5VI@N(;b*o?W=Tnj|>W;zzVKhZ63x2DwRV5F<dc(K-_a$edesJ;a- z+b_MewE+UhT=Fa>*X&1hw`~!t8!+tLB%8>Tyj&O1CBiUE)$Lw+9yTQ>UlVj{7NB82 zBM|~rhU@Fg8}-{4Cx-y&M8AEnE^gH08u$BF+5*fs%QeK6+O{I_sCOj1M+?Xz{cPgb z<n*wFJw>KKl<9J|kR=AgUTSSYp{S!9C!QUQrMb>GGcwWU>*Yp0zU##bKrc-I#N#sn zt9)f=lwO*UsT4Y%j=-pHe^SR%Qgx380tQjdtVGK?`v-lud<_5#0GK|_ehmN)!%(N| zG=aubAG6}?pA>*Qg%_KD(%txcH?Dpx4D%hwcw&iH+#$+ww-wQn$#_762sqYpV+*gD z>}liw$BlL(l`bV0r=%zeyYjmNjapu;4gCbZY(GG%wPa_ox~@5(Ry7i^t@gMxW8Rs4 zMd*iorNep`^frd2PB#Jol78HIl+E%^K4I3slj(T<ZlQRvdK(7UT`#lvw5#^LQCbz- z&eZRN#CUePg78_;p1O?C+=rwfNkXz~l+XYZLGQ7r?RB>>TlQ$k;JjXWq%3w(8ET)2 z?`$`(3yp?kjjkFU*;fC3GSNu*-Y`6Bw7MRPb~dm)?4|0&RNj<8HUX)AJ74G2On{Nd z#k$DP;=<)()pMS&6bqWBro>-q#u4aWtzJ^AGY64Z_yQM*mX17pwlg_cl>#6n3#b@O z=QlGbHZq{VNooCC$*$$5kO9u8M^j5kUakvo-nVuD0MpUPi_J)ZBN;q!MQXwnfVetQ zNT#^Jwk?6z6o{HdN>0{87^5FjA%mmIFd$kLrR;xw&oX=G{NPUr#x?=ememv9%_jxm zEK9@jGx-Mg7H{Pio3b0~+Uk5(U|Ac^N!-pClG|-1R~m^A0{QI)xf|B+&~WAta?HcC zw2xH0*R2=bhnE0o$q35OF#v>Jnb#-^9aNL&7+Wbsv|`2ep4-^0eiDR1BO)CI1khFo zd%HaN^v;%ZmCb(x0Hhc~BV25_*&R4-??)JU2a*730%{#7YfD{0&7QAUZx;Y~&j3Q> zTYLJJ@O;xC48R=RY;hK%K|A+>IS43P?5l~p{1$f!0Cu}topY_}OVpV1tX@QR<E}zT zM!0h2ZK3yXgd+f8_x;+H7mxkhNFc#x+D(&Y7Pu|mA_e7$r5ub+^h(7!x&wy&K&-cS z8JG11iW@M@K8dX(-RR{YZJJsBvc;4pb76iXEJOOW-FAWOA5H+2|85Q^(nz}Q3IyQk z!PF2V0MK&%3P92`{&8La{O0mTUC^kXk!hv^!f>^b=CqCU&(}Et<3Z1L`EV7qwnB`o z61B5$jNwHhHtrNS4W${}4DS=EK(V?HOLebKreo4NvZTm5Up+ms)6b9ZE&(hyiM0RY z!{32ub^X0M0mbT?j{2nZ5(p7)0Bi&jsW^5oO$gW&B@vD%V<KPz0=>h<V<DKimJjGd zJU9!+lV6O)Nf!MLD;WtPjysX-mz>has4x3Jy~`i|uoeW_^FGj^%i5-O_RaRQzJw?V zd_4$<Gy84bTB)~<QVX|^ajXur-R>l~8*pU;f-tZxv=z)MtsjzwIW|mfG;sruGRD$H zPKE2)Fog1z$B&CmJ6IxwerwoAnlrNLv}#W0et37rcU$f|AsoQvo4Lh!MSW@_Ze!Fi ztL}ScQ9D^<2_0rtoQAve0u1z+?^f@$7M|oLJG;M8J7lAs_6mf4MPs@Y<+*ZeKOgVH zwZzio^T~gbem|(w!=r)SizYe&herqM$BLIrz+e9SR-MfA;{#0#YRD0*KW4f3g8)RA zI(FSV{i7b3>sOkEW(3J!zQ6MCz0i?#Hi1jiHmE=h9Q;RGUvK}{Ygx?WKMMy!PyUmq z0FHt0|DQjwK)T+4IJM76_uO;dD@-21`maLeQ55W21SA$2TU+DoTL&^XY#d^pYh9`C z-J${r!1>MGPAw|jZEupQ*@efy#IvKRt!UuOTlK(({mg`y$&*E~#4EBjTh5F1tvE-f zG9EnHi)T?s=|}0{DSo&BreJPA8YFHOD}Z`wV(!u3j-nq0L?8-uHsix5!jA*sdlC3P z73F&ih&xZ8yLQYSbKjltOAp{J_dXi}Akw7;>EX~pFEy%J+@Dbrp@ZtHwC=VINkkAU zcQ{Uh_O9&2Ljuc{LX83mQfbt#DkBhjgG6wWJ^IzI+CARVDf6vPkG0~)GL$0yT>|R8 za0ipSo#yIJCUZki5#s0)r`yZL>)RxY0Boxo0@u9ws#t<B*p^ikhaL_#>lOh<U9)<% zw%dLDQ1kf?Bo@*MO?8gerp=%<G5r2Dj<;%wvKFXVN<mAev2DoeU6-9B`ujxGX9}Vd znm(cfKGD&Z?<ifC?;|;BY4L2l{t7aj>%9o-7@7$ToSWO}r(gk4dh#`JtNvK7^HIO2 zzI<_Vxcp3SH+c;Judi+z9K!$Ls}~{{+c6)hbgbZKp&3SI8)=5qt+sgpX8682y9hfP zcR;$Zjh}L>BZnCefbC0d8e`hru#6bH{!1o;z0zTAIvNkvgSwn8q4a>6Vx?t~FYK$Y zWR@>(=W5bXIzrX;4@8=ky+aW2-WnWf9FtPxXI(||;`mV2D}&Ha6EGi7Mg*8M0RfNg z-D`{*$GrHJ>wWK9>OBLD+D{ddC?fpy0Nf7dethNchit|lz9S#K(-%GQ0ulk4cpvws z-6=Ip08nJ7;I4i(t+uSljLdA3M(`hu{j{sLeqdVepGp&=gjZAmBBWX3j-|wGO=Gn< zjv5umLEx}$y}XkRD5A|BgQgKxmVY)J<$B+VmxNaQIgF@#7yeUA{9nEL?gA<pYYKSo zdj29T!a*2-Rh(G@M9288${oP*vgW>n=Z5rHKTGJs#RIaFKT{uypa0}e+kCL}B?tx+ zj9`<t5{zTJnrn%{-pmy%3m((j-mvMg?{3_DZ7NJld%G>0=~Bq<>u0^F5oQSYaH{=I z@x$sqvhDHi+U<$PdyT-cEJ^BuVd=*MQly~KCqUc}mo$YWBoX}HOP(5;6gU)70Lc@k zW=7f?9MPXjd7aYVwRVH@K?l859baW<m2Q*~g1{=zA$ZkiM^h59<<+`yL0pknetmJH zj;`v42U!A;3JcqQA3R$SlwCrryik+C`<n#_U%xoBf$?u&pQ|e$tW#@{$H#xr(TmG( z0NI65JQGtd#l$jIZ6gYnd?5N;+4oFx#hf=xPKr{zOJZorxWOZrG>LURdRYOKR}}$T zEcnwcR)h;cI_S2-P2O9(PfRA6VF&-OSBCUUVfEhMK3Jf{_pUtr<Dn0=7*fx!smg8J zXi^BFLbC8ZS_^o)UG3NZLl(a~SIMxk_PT(TC~T@52BC}M20_r!kx;B)vhJo3Uo=I# z^3?RQ+wbqWL1_S=Kw!Tw?)=<dij9}Wm(^n7T_v^(Ew*=d5or9-b$2JgC_;2T@r&0p z*z9;azQG;iMg6hg)dU1V;EUD5kGW~Pfzcs5<}e%>WGQb-Y<5T!?-U=BkAcu~LMwF& zkKF3Q&xB4zHYrnV+q=T^hRy3QE0ENG;uV;&vp+Vz3nbAAg6L#A#96n}I<WI~-nO0e zRT3Gx6W|z6->4PIps&twzS^kmC&Rwo&6j5<>cda37bcFto^n_VhVAXY`4?A*|LhpR z?Z3PtZUVEJ{;8qGp`c{=j}HLwpNjqOGXOoL`M;To=Cu-|oYbUw8q`q2vX4hfCwm38 zXx082XU^3PGn}}k6~ItAVAmH-<SvAUvzOp-CCj4Pj3_UwUK&GComKhJ^?V7U2-h$@ z_2jJ8H@cPTSEmOP3-I5*d0$jpTVJL~uTPJrM3@eV3_E%{8UQG(Ei+%umqgS{6P6mS zj|2+#w8nmI2e<=_6@A3?6p?SMXM=u9)oB2Tsv%YUPQHCK(d-Z2GYA!S?Q$CZ_dtut zdv&W&sZ&&~dRFzT-L?iHKq};&FhZvGlVp*9-5zxAcQsfLKveYD#C7+(TFU>DjlL4< zT1d^4BT1?KSeLPb<gBZ1yksxeZg|B>44(^aKdu*rn6;X&^ZTD~#)o|f&U96HWy(^3 zg8W!9fL=e5Q>OZ@-G8DS>i`674abVQ{^L|2(4<f)?Pz&W^>oN!^Za@vch(!GHh!Sw zmhAZzc?Id_wxE|=5}`>iu5u+}6$&tIPQ+?Obh8USOTfI}?OhR+?;QcC>w5owJIE4` zymi0z*IY~DpZj1~?%AtC@`Kraf|Hv-&(?_}JA$9{V3`*=O2;NLfl=~xFf8nOj%G7s z%^gf>uUgmj=OqyfC104afog;%$Kw2ECgMv>gww-mqXuueehG}By;5T^5nf;2KL3X= z)QZ{q8k!7608Y(4zg=zQqgt%<0WxcISVA&PQ4J9;Z<j_g%bnQ!o4I`NRFc(#gvytT z8ByN=n^4!6qgcwM)wO2pTqr_&{5DTc)3c1IVX3jNG$~YNY&6}4GHMr@u-s*|H8ku% zGqHD9d&gEM+$*Yf8`z(C>XwcT_gFC6A8X~JgkmBjL`1lFbB@1}MS^kXi_Z^D3cqBD zbUaoRtvUf++w@kD-h6#s(+NP#!bW_;s<F7~Tpb|^1GUM%t%yXH$LmVafu=#EC`*!u zt)gKTu~dG|QwWwJQfg#@b*Za9y)+g#1OOtjdA_b1C}wn>2)Zkddq};3EMB6Qf4VU8 zMb3{Q@iI!ee86N+sgWF%@WYLqw%nPUFeMSzJ0i7q=&K&8A|FZf7A_z)j|lHwL_@>? zO)R=Q7qKnt!6a=|q}l9{WaLJ(-8KyL8P)JLHyonpt14O53}75e9OrxTxt%L*S!yFl zdlwA19}7g^T2KE?G_&&{ki9Y`rg)L_AoC>0rA8sFMz7GL@EuJ#p_7rdraQ)z0STEK zX3xmLoiN-COv5YP6)9N2=}n;ccMAa7KOEcV4qpMu)B-eL3tJ-~?`LBtY{VcHLfD(* z+YN5UkW}u5F0`xFauhAEU<pDy*eF7mLVAu)CL<8Nznw!RWeH$Prk{bZ*eq-&b!Z~w z=hrg;XGc>2)#bP9nXNX3dIp<n52Ao~FccypWJydqsLSiJB0vd*y}Y=#CBIDkWI6`0 z%w4@x5{GK+1cMV0WvdGSo3awgQD&yR+>)+a(LYs^9eKG0p?~ry5OPI6q+KTd^ho!p z<<*Zr+s~hW^##1S9uLd#egpuE$|nyfogYR7t-s$Xw*(~x?m5Y>m@0r3?DabAG1zrf z<*w>ddjyTO4l%vc6OFySJTA5TQ4zt{U&dM7$`E@wU<J1_@-O}Iv=@8*@VxWG`Oi0M zR?Jt0dNpIGN5Nf?>0WqGf5~HJHf<4Ct}k`-&{WVzqlb^A;ChO4ZE@Z%9QBa_O&K*$ z=?>fxC2rEG0t&D80PsBSeEWQ%GHkcIFbG&D+5KT9s$+xO9sHVGDd%i|rQ6Q|0G69K z>cip5fnBL$umJw@r#E&KJU=<GqigB+t<#HP5$hX43?RDHF@WCbAMJ2qtxZU1(TM?1 zWh7p1*!5Ttm%?B&EGLzny_u;KX%U@}p8P>eZCvTvS;=*R2ve#LuP<-Z;Cpd$q=(TH zeU+B+G#;ou&~lwy7`|Dp;Ut=Uy?2Xa#yZ%4odW0~$^Y%VHPJD*%pkN7*iSlO_>T`( z|N2&)oBqm#iKXrb3l&KctUu4@5dPv_Fzn196APD0SP)b#j|t84kP!J=PvuIpxZULo zlR^x9uoUNVs%}!H#?(*Pawi+)b~R3>g@chd_nI+?i?=2n3$+lh%I#5r6@<=R(m~+A zB><MoO9958ef0%A4W3U2z;-$`9&JN?$#=0D<ZLq(ERm;Ew%4m{X+x>pGP<*Kj?%bj z)B-i~rm7)b(`PnkZz)AqRq7s6vDzZ^?nV=(_xqZR4}bY~26m~?Fb=%83SE&6ZUdO- z!4frmEMK2q1Q5}J$`+6}U02^icb$JAy8uuVN4*{=+=O=Dlk(Im+BYCdBBik$1cXkA z^k?5Bi->9WcC#IbiB?Vw=11Fd$Btl!4kiMFfuqUrYPRG%lwbJ1k~dHCm_?rj=?L>( zxnXnTZA&`OZ0VvCH{#@y1Z^XgVGzikcb&W{^3Sph5uLSXOK1djNpEebyv{lF`U^Q# zF9CV1szpIix`SZ0LFqv+9q5XDtn!k89>(&%t#U^>R6gI?(X@Q#QE8Uzyb*#>C-wT` zTHOe1NLkOjpQa$3Oh-aA78kb*bra4GCN{H9fO1tOJ&J&DU!SW_^K~Ys7m81GpWx-? zUxO%1Vwg4t{Y+&^X_*%QPNpM3la`4P;evp*@9n6IQ3777zrs_)1$zpB@b-E(TWuhO z?$xu>jAbR}H69XhIbRZRI360(6BFUWQl`x$za1c;7zCy{2th9)LRGVEh#F8rMm1wA z6o5j?h%llafW4BfdJupEt?m~_p?P=yc39ANE!s0?2JrmL=Wnzj{wV-BN<+`7H6NVr zJoyb(4Zw9u>Py~i7>D<G?7MQ`zR5Bu-E6Akca06gK&I>2o;lrt<wQ|rdkv6G^f%*% zO0Ti5(WEtdcj5f!Yc*>IVH01alrGwB9N3@Voj4aYL8}vD8>^bzqN#AjXhu7QmJ<tf zw9VKgh}sGoG=9_J4vXvZEdcLwYX%Udai<t$<E|)p-c@@Bk~GwodhJn?)LEwoUzBft z1`q@Lg8;3#t{xThT{3yj#ijpT9tc9;pAPnmBptxHLZeO?mP$;{>_R7<*ip2&(TfCN z91r8gW+!urc7#(Wy_v0^Fq4#EXUCNGVA$=-Q{WI99V{I(f^fhfoIEE$0VbUN_s-P! z@Be@2%vk-mv*ACQnv13WNaNWRn&Pxxheco`$^q2P>5nqKlEJ{A{pY_2@TdRB_rB1y zRef|MZW6pIa{cho&dxHL<>0>M#G><|>ulin4AfiHY@7I5K@!i(Az6gxYMQ<7Ni~ZU z2880bs0o%DX)Ky|35jXPd!|6jQE4m)Lqg+!eh*U-%lrT)6$M6omH9W|`aZBQ`1zO5 z6rCmQ$FG0*MPM8mI;(762YA_2DPinxsx1;t(iR2RcTCHoLrW`4L%UfNhRwaV_SM$A zklygl=oQ<ojc6hP2m<&>(nQ}~wQE)f`yg}q`qoEQ3PRz%G^v=KjuiU>>zb?!fw{Gn zT>zjO^2l=J+PjUSLlHq#!e|TP^VnWTCG;)`7$5fJr4^e>+81HurD?TEWWJYX4N1n9 z2_M=0ZgX=!fiMhez6;bO`zV>$^`HhQ2uwHA_HP&fhW%`HT@V-tjd#Rh!yrp}T{d)? z?M%p~<&IiRFd4(XQ`J#IiGb_W20!sRZ~0!*@E98@L`lJ)zyHQb5D$CS#a$>S5n(dy z*#U0p#Q*L0FXe>{vQ%R6yPFw#1DhFmdN^%(Q>q&eh!WK`ov_}NYUY1)b!(rlVh=g( zC(v-UX&CDk($qEtj7(o63%ObbWS?$!mD*U5Z|$<mO8}<^k5B&NQ~9luq>zt8?RvS% z6Ab05r~m15`&r@l`1k;%iQ=O{Pm5g;ZZB@^m}cTtUW(a|PNpOE*ZJ+7fPPPP;_JxH z0yOBQ>f^iXnLdr<DS^t%Z=ll?1qhn8Nd#b3>b{TxTirU+yf7dyD`u^w{MEA)0{!^z zLf`*h3Zk>a3AEO<<GJKzmBf)`x`d-M02!Zyur4Ym;R6OEFDejhOhTQRlCn~6dUV!n z1pk^nT}+*hr_>n2{7E3}AJO&<K$1j_ibwu!Il$gBoMfA26<kyR_>1`Ym(MrL0z~73 z-p}8?`d|Rg`iZq)8nXM;`p8|ef!)>xas|&G5)a6g=hp4pysh{4F!zW*=#8tLiFbGC zT-K(Sj*J+a!ZmXarW2eUl(s*vT5jL3>?FUdc2Wze5yk`<wIA2**2^?TB>>RY3R!y| zDK~Pp?3hv=QWOp9toJ2b@ejZf7R>=$5y=K6%2V|9W8&U%m{FVaC6R0P$XNhtv=qL9 zCY_3nt*`|nbeGsJJ^_Gi4Xn2S&=2AF5V9Mc9E>-4>3OLBL)ny7KTQtD!@Za%K1R8% zslV&(iiA_*XT=+ykgZ{{H(Vwi8BHZx9%NZ<OD|=8v-PT3@MyiBKk5)J-RBDh-$~JG z=1Pe=(xvDiC>e*)rVQ^ezwW%r06R~&6@z);hjPGaXVd2cd!D^*>}R_Zx<}%KG}@i2 zSZGqpYFL(Xp88I?%&X#pS#Q|2ZBPYKB7$bVkrK_;OLqP+i`rg0r!?q!c0=JsyVhCi zaB&jKDU!r_bkKlWYC>&$^uC4kq|F~KxBRO*&i-)antOw|_a7YS+Hs|6&&<qUeEnIG zZ;3g{;+NmQeiQ&RivdV?-5>kG1FCjkod$uc-nHvGJy<ubZ0?5J?XGnQ@2rBZv@!Y7 z<NeO1Gf55?v(fFvN+k}}xh81@pQ_WLCfpidjVduyz{8{{2KTVro05Ib0Q3X79b#ZD ziN2=jShJ4Qo0~+n3hv}NOBnW=^Z|au9*+;(NLV+nTF#7~@he$U%#GP|_ckB(GH8d@ z%K@{XpJ?vYw2>OtlUX%?8!E*+*DCd6-srB<_Pb!XnH%nWyYGQvr?Q~p2sMZCu->h` z8_A|uix0yMc}1(h>eG%Of5+sT7c4RivNXYy*6<2>8w924Hr}F^WwZp${+ny1QT!kN zPyQT!B)NH`sTqP+Kt7!I0NnhGOLe#U|HBuJpYH#n2jJa*^@iYR;^em#a>^1;q(azE z?68z=t*~iRVX@am_MI-a$wXM{lNEK4Ie516Pa1|zRNORR2D~nUt-4`Ykqx)8j#0y~ zuT3bzbz2f6!YggE24kFrKI>M`?xwKQ8{`ca+0D`|j?KyGQ(}PV;=SuQU_}KO9WT{y zZgFouGteI;{ZXPWd$TNqARusAY|oybroH6NPp<*&c6UxEQ4j{Uw5ECO;x0t@2>7)* zN;ZMl;$*e7miT_mk9=i+3AfZXmwYM^Ty3j|`)|I#(m-o#j=3|B+fmQZgkO(-W1`BA z;N8?jgm74`3EVN|v%hl>vPf1ow9k;c;kTK@wJ6ythmmM-N7azjLlz~g@a|^w9OOkP z;+2kXD{^?l%#>N<ea#Gdn*-d)s<YVe^kBl^VU~XX_M(Aq>Sz5lW$>mb(ZS1Vy<Lw+ zU~ZZ|O&ETVqUDutb-}PG*Fh3R&Z%c%fq?pHV&}|FQ7XW&g2RJesvflN#sds`nH;@R zzC*r2PmiY%`n&{Qt_$Y}`7x8%7uWVZpBQSi9G146^x&T!O>y-0|MO0R<zMTDhQXhE z0*1eP_Jjz_T&4*M0=|B6rs7Cvhf^Ya`^uG#&j0xpfXRPX^U0HwKOX(X^7^mF%ZtBO z*S0Zg6^E0N4ZQ-?PZK6y=7qY8$CD8eUCtDfh$6a#>XGZucglxUosJAiik==#4IWKF z_;0@ZnSkfVhalW8*XmYm%F0>;o3fIs+Q*X-6djCkJRPa8^0G2z$~5Su5WaXdG;qn0 z;_2+^h5$NFh)@y;6h;AvVv1a6QgXI3sjomO4Q#n-2dOq}&A8OK9SDf-a^?b3U*qiQ zb2Ws{-@c)MuHVf;Iz(9S>tCVX=aVfexw*L3X{l_OXdu%VP_yG!8nuncT~0%eH>&rX zW?mB4!BQtO5|#M_tpJIdPp<QRHXF^hpH>hw%z=hJHZyxnW^ov+E^+mC;YlCYHMk2+ zJJGjGm4(@}9)iG8x_qSMuBsPiZn!OO_;Rz~q+bB!Q?$4(QBPgqfF{OzZQH5o#d<|a zHnb+G*ImJOG%KOd4s8R7Zp_0PCIH$ylEA%LR_T%f=7Xrcsr}>haLUZ<;)12Th6q@% z^Abw*$A7MBlXX%4{@If@@Y`gt_i8-(ql1BqZ|vt$FH;Zh#mRvb8&bFQ_2rFyjGsNx zbv~b+xLNDf#kF->O+615x)UEU)RaviByq&-hum4mOt;$|_naCc%bpOn8KU*a%;RLQ za>je?Z81yhAB(_@NBU}Ni+BM5cD)N32mkD-X))d*pX3??o8{ymodCGSe&{x6l$!f} zRhR)B{euPm!LxV&)m!pdk}mY>QOQJ?V!xd*HG=S-CoKdngd!sgL(QsOxt`C?b#`a# zyj5byiDQqpF7{8l#Iaeo;zx-Irl{1gm*Hw~P5hTcM^hqdfNRGT-Sr*a2Omo9$2!(8 zzWAJoPCq|XxAo%H{BN@m_z{cOvJ$eqjMs}Yo7Y6NKaK#}{<v=63M<a2|7^o;<93(% zwpshr+G$7mP!nsp{cIW!)^g$Qcy!8q=+N%)c1&1YZ)AVHuGnh_nsz{d?}h>#r?Ji7 z=}tbr%s?A`{oS$k$f9M<z;^6$$Ko5086JG@aaDG^T3)7z+?w31aKy^Ivd%{~^Md0% zs%5@GHp_#S&2sLK6S-8~g@0H{f?hQeqe2Y>v#<EV3qR$<8bH8Zx7m;Nhc|nLz8z1? zgUH5B_tYWOURQ<SUNIV8V=swyPt3=^?flSd>CeRmi(LPlj_|Kkq++jr(ho!Ujr~L+ zFav24uZz+)1=OKu(LbRnj%W{0GA7N9l5c@RHfU+njNLHoJzmK=hL3ZtJ1PaYZZ4Ls zH?-r{E2h<!D|K}$h}|D$4RP?sh+$wlQf;H0->HW8s;mhJu#?k9PsbJ1#=Oc)bxpr} zb^_23?=IA)!(L|Py<kXE_RTswoD#4uDgde0&ePJ$;rKZSz4;qW(b9}C8?5I|QR>zP zSz>o-B_~xMq~4c97X>B&RM&MQi7T?RLhQi)#Oh!;WHv=Gg!^0cepup`vES|e(}Gnd zJ$gC<aP?+^-|C_gn%cuOAIhR~QyDvbum_h&r9T^R755_lsbO2~n~>HDRfm3j*rwLq zHiX)=R<-NmRC9gFbg^6BZW;&DvWwD@-8H)bYOZyshy&d-XSU{7A2XHaB5P~Kp9{Fn z%jNc-)Ze?R4uV=8Q=zZhf`q5qEN5w&JAOL05#BRj*>fYS4MeSkt{`zW6UiN2<r~S= zCQq?ZH$zUFg}UzkT|+apE^=pzUC(6`m{xAGidS9rvM2^w+Tfzg$Mf0g(ba6pck6Kd zlEu<$JQ((+lqBN@wzP<(;pWxJ+45_K=qF)(r`>*E?RIGtqgjUJ3ls~vU177Bp7UbZ zz*QuRy5T#-EZZ>bRf=0_2{3>x)xfhUD(nA#{h$3#eXvyI`oas0IiaXKmiZ<pV3=u| z^k!Ko#i%JXb^PQXI*Cff){f(d9pgzFL(F&QhJE!hG*YoPuk7^!G`Goi0wxm8kHMa( zq}7Kua*uA<lV8**ykYgkJpBeGh7^XTM#$GUw9>aO6(xW$5~%HCvvrHPzB6)3LGVZn z_Eb|s5~Bq~IDS5!-(EjvKY#O!PwDi`_iV0w8$?%I0NKgcxc(Op05E_COST0_)L_{* zrIflPn%oRX-2g`&$7uz7C8D$yn$Qwy;(H$tH<FVb*csgJ0pK*ko!LNcxwy^ZTYHT9 zvIMZpJQ^uFqTLOB3??r~=4QPH<XXLsJ1?4j-@}roy-*>y!~0FCEAh6sNWR@bgm$*L z>wSsmbrtOd^SSF<7~yP}9ex3T^Y<;oM@mAuc}hMd8}>h*44WPmi`pBpJUc#UuUxF0 zIF7F2(cqyolyX-}f0(p0q?e(o?U9i}r?%Lx=Ygk`;eZ!lU|p1P9N8GHN^Qb;OKR4< zoGn_^2tDm8(PKG1k4#~bO^Lu4!SE()=4ZzT)STLHU`E=omub(kD47MB33&DY*42}L z{2%|`AF9m}b@-2u?dRpczMW(8<j><uRyLZp_WmpC?dSFX>kR?RJeNfU)R3kU!5EU< zc@vawv;eMkMBN<Qm-mt+DKM^sf{4&ph-idzhY^UjbU{RP9IM=IZZ!Ldh$zufTOtrD zjj}|9n0o5N0S2I^iml($jcN^<Qk-8)Iz*xuxF5b&d@C=xtN#}U09LacMuJ}D3QbIo zvOz+G&P=7!gtxV?DjvHn_oPyv1Om;j)&zY1hcA@8|LgBRxVGn4U3NdNA%cI(1CB1X z0Jg^KVe);J`v91^F+aCv*A6*D4~AX5iknRfI+Tao3Q62#@iyvhAVOY{owVSwT<$<$ zFBv9hb<GCSgDafvJE=^a=*wtEo;7zrRkI=Xmxb?_GCTnZc?!NhhJSRIS!R)X^=Ulp zZ+-8=9iDe1c-;gxs|`SH`^k5AP_rxgZKI>SVgG;X{<GVXBg+m1_i=gs$|oaUC;$m0 zGE0#~R*}W(W|M2No1E|SXJ^)GwYZAIW)I1#Vv)tlL_#DGI^K(?u5#@*A50xH_xnU3 zGPA}L2}E4s*M+%lJLl}Pcl}}uARb=eI7bQ~ylTK1xh_F&ofi;T7ezKo;WRY~0FzOA zIG=%VcD2;fQC2A-P2zj?{)@Z4ZeZ2Km(Ih)`N+Iy79LaDFRv1u_*Et${kAtI94@@I zMlUJN?=lytp&L}RT&A=mUdSlBc4cQop;?mIXjV8E?O7^blwx;Kv;6A|^Ef1owql;h z^;Ir;(ekjitHP*xz)h4$y<#nrthiAGT&y+#w(4EAS$fpNBM@kzP)RbRq>h!{r<V7c zj2x1bsm`dh5RsqVRsVvY0p@>I-T(GmHZmm;LF@=kgD~jYZZJ>W)Gh7c*isM-popGk zX8RdH?_Xc*q0Z?5x`(P?(bvlpQv@-xmE7gf2*yC*=@(A{yu4di&&S+$_D8r;6Uzq( zfyH=amNCn-Z*ZIWcqF{mP6orCE<6o&sCW%5<j17_MpF3dhJ&$lzYm6Xg3|!5iGkY= zAWDL|v{Z(GNePSHQdZ7Fz@2S_fSRf^FUD~wcEQNd-g^n(-cWbR%Pu#{m0xl%nb_UD z<nCv1ku-3?VmQwBJ5+ZtY19`+ho8y673bd%fxSA;S(dKW<;^HJ8>Ip`Ias{0-ZiX2 z1K1YT*wC`PjwT2J<W)V2<NH2-_rht>dtiOv0>3SYb?*$aoCF}S&I=)Oc$$>Ve@PHq z3_FW0H!1CPn(1Bifqy3qJ9%mlYfC40$O?hHtmKJHtO9Vjn0gotK)fgc;K9ths&c^* z;S4z9uOI(&rQmV;;!=iXijd4U$&`kU;{N;huWdb>$v6x5Arr0+9AkS4hB|!x!K?dL zWXh1Fcml!s593TJG<DfhJz|ufA668rXy+3A2IElzyut-<@Rr9gDAy0*=<x!Ci#JQ5 zW%KMH5<?S#09Y%Q0$Kf&!qOkCR+l`W{cbLg_L6?b<>9^Y7ywqfuCc73#dh9buY}Rm zraMVmM?HYEf?!7Y*$q$!^2Gzfh>Trnr+?9#{(W`Bp=gNQ36c7oBe84Vl)izXazXGI z$UYkG00b9sbl)nc|1n0h3C4RgVK@BFMhOJOdBw3YJ^YM=S@Gi6>@h(CC;eW<j>%x) z76!uijgP<ja&4{)e($m?Zds)r<MpoV?>GDi_orj$*<Ed%rNgo?WhldQk=t6jvmFlR zDeS*y;}ioU()orIPU3fo?{kxv(cY&3>dWs9{26A}MmFaNXE+Q#CgK)sy%nu{1rwg$ zgl``-AZF<_U0dFACxpM;koX&>K+CXG#oyymA}=L(gID{~*=gnCpl#vhyYDX5O!u>= zC+x|y0>}U++tku%B&9<e#RFKKeZ>QMgWSLOuRjOy%m4km!9|V`!}mV@LZNk4)X6Bm zc?l%^RlSoCHi;eKba@FYUt`*HlpqNl+hDVpB5PakNZ*hpb*sXE;5l5V|A!IX#9MY= z<RPz>isV*82BVow-oWM=n+_qeGi{SjJ1c=+VNXzI=MPTiL^ykOEk7*h#_+UmPI@;n zivcS0N?v@KzisMP*$@x_AqDlqFaSwrkD%LPgx}`YuVNYu`}woSuisw+cyfF|1YrOF zx{Xa1nOR|1m;^2{LB0Qahvq@G7s&RNC0uO_47&dG=WH6l6+RCN(Vtj%6=1QWplA^^ z)|{zs>?bV6fce?LtS$tS0w@~!Tr2eLpNeL??BZ^FW`960a2~iQ{ySdExku3wG*Gi0 zC<6CdjycZIV4hL*FRolYoVO>33k9xX81ahB=YWVb*M>K3$iHl)?iITSJpA1jr2x_- z5yGKo<z;om;;@aDrF_k*xf88}xM8A|6JHz=a8)gJe<e<oZoWBS0%?;XKFzuLqZg+a z=1U8`?&);(*J*7LsGC-Z$O)Rcc|1$$nZ^}>n0AC2Uc!o4nfT9BIVLtpT%$wS#Jelf zrk4qPJa{T7lX(VUv&@xtgm#a%Z5nJUlcmS2vo(Od<7pp$Kl|68{P2JL@ag~ZseI*h zT0U5%++Ro@^P__Wh&C$8Ors>`b6+%n3{bXwCI7lE3a&Px^tp;sep*`l8MxeN=Rp~` zkLNS9vQZ)d8f)W(br2CMRyq{|ky6yB9xBV?uD-4UAdIF-T{b304tKzC7zIspGX@WD zGK?M+ZxF!olLdgYSJy)9?Bf+I<zr}ow(kvkSSlA|YePMimzQu^{;mO72r%EU7iSk{ zZ0j|#QR=>Zi-Lf{%bsA#<H(ztYq$T0fXQOyStW7JXEjKqI53-`JAUKk8Zcz@A%RG) zeVl_2BEPm+8`}o?YD<2<!Y*A0Z*CuAomFKG-9BL%%l&=^(f^aP*KwN4ic|k>0k~;b z_bn1M6a+f(+RI<lO>phPma`vtIS3n_^~&)B%3Q;wES9tb?P^f|^4UWGU%z-~51}WJ zG1F;e*;CZ737j0vg%EEqmxALl`~COJRhlIJof1O!*N&2SDAR$#Re%^=8tmZfxlA8N ztkG-N@q{OPLMEP=rS<lc_3SVV<U|af{x!rdvmyd3JPXsm>R_{FN(;uLX8R>w-DTcQ z#Qlc3+?25r_ej_B-1lb_lZythUMi~ErfLD270rET#!5>9eD<$D1@Lfx!OOss3P&t| zCZJsF%|qv~otc=F$xE=S2j139@V$-UxG`WnOF2ckDr%F9=-Q6?*3f8@Sb+qR>bwzL z9~$;o>&V{JZBsT5C!^izDkOu{;VxeD^&M$vO}HNJ0Dkz%zI^-rckBN9ZPO9cv9F4T zWLQk7zuU+!Rx?1#h5*rNt)m4J_}$Q+`)dd|Z67wZbG6w@PX1(*(%sZJBlKdRfnOsU zoL_luXmC14FNo?9Qk;GoGq+G*T!_f4H)E&@Jb=DJC~gAXFrkV8K)&H-i=F7(o)rQZ zrzwUKr0`0~ZV2qB@COa;Su)$}8yd_UIE_vA4H`PXo^u3YD2u^oc|X`5BGUOn3UU5+ zak%L7`TL86sca~M7xdXle6=m6S?Vrk6tIlaB$uLB0$v5+xA_zcHh4J<3$JL}hhg_N z3X7u701Ts4w3XbO^t{tbSQVQAhy+%7;WUG?q_lJ$kklbl4ovr-$?q?>nk=oqJIzM& z4{t86<f|u#dlJ9Ov#-n#NXaUR8Jt|hXRg61hv=qTG~LVASNR<#N&%*Dnf-%>{6qfV zuCX6UA-&7C1c72kVj@9PW%^U$l!$N?$rG=W0H&{pC=?@yA(cd?VhSQ!D+1M&QUaAl zJ)Y|F3ejkiwsp&|Y1?)R<)!(JSvwQjrcKhAx6CSN6a*4&Bhpa}LKw*uF0HR~xascA zs*nOoDtE1w|A{b~ND~N>;Zr(}<<Hh-!+w!Wi>ah*wM{1vFB!!kT)$WPVB=W|P}g=4 zNWYj>+hPz=6dO;M*_q`R6G|5y5zwhQP>)_9-1z`szb*u@_jvRX0QSbYAHZs@M&Nv$ z0eE(N2;lX_6_?<qpJn*ZcK~1)Y5j>%r)<Qo#IrLcdLP(<ll)~rZ;jzP@nBc1xBK1_ zX=l5U5a`;D=Tf|4<jxvoZ<l<XDACu0^r3GH>`34ayfh5MJr36Jmxo~34P(6qhJnL% zNLc<Q*ICaV4EK=x;o;ske+x#P9Yo)iDe(@K3<NOAQV6MOAe=5EKmZRGvsLj{%O*Rw zbbmI1WUJa#(Qip|r`Mh9fW#mSyX#W>46v#PX5*}Ct+Tui>_qQAJ4tD>dfhCZgH{mW zo(&{S{LQ~R&^OF1^SB_mJa73QB|u>)4rOJ`Yxzc^G5EW8JpJnb{VjlPSsnj_BaXoU z>c3k9*p4D-Q4X_hSH-)F>xam84r&2MQC2{hXp-QGT1Y~2*9r;@NNT}kvUYqD;nc^& zAkAV+QYI2WQ#pA=huK6R*2@dih715yR}FEeb0Pp~rgGO^*MTUPt^gXgN8`jSm`2m& z{LNB5uC_=3!<3TJUHs;8LZ6YAASZpS<z6hS*_O=*)$bvjmxxAJin!Vx#{lYImr(o? z0)XWf0(4!0us2i9c&oe+ca!_LdaY3Z$0G4=1h&(XUNA_9jP<sZDg{;t{I)G}*P$j0 z@1UVSw+}*;0Cp9KJ-qGhxsSa)#uYz6!hlAx7)D>FQYTk_!}^y311cQCLq?l8F7qnc z=wqCQ=A?(vw<r3;)(Q{y7hsKdoBW-NSPS0Qx5zRZ&;Y-D@rFITczm?So=#flIe(Y` z3)jWK5$Q)rwvd~zW)HsPccNRrAhP+8PaYofI_C3t=l%OGum8itg_&?@U?HOZu<~la z!hznOK7R1_;#x<}ox5lf5B6rl54P32MN#d~Cqh6tdLm+!#z`Eloyx8XQ{J9m->~We zv!CPJj5P<FZ>jy0dpp<-d3?CXx@pa@zAzu1DbZ%itEJrYG#k}Pr)O}J6=Us0qHl{N zJd+|$!?t>+7Qz|X8Q|Zw$m%`Tg73;zXcaCUythJ~&J|d$#I+z>+12&tp&Ak^w0T|* z<Jm~;UJb=*G$>+BpdcjXjIQhWI@FbXT_X|IbwYHV#$Xj48qjT<mei(xM{%KdZ=R%} zd0-6a@>iOwZCP_s7zJG9veLz1`LFrGga~IZuWWunTQ3M^(#+N*)-2163?Wz%S5-K) zVTCSX=#u~LVoql{MM4;^5F2DnLBNC=lhNq$;R3*4zFqBFRQ-04SRRpT=qD^U1%Ru~ z7Qo)090I6+xt15?E}|sS0F?F;qIdZtcJZ_Z@MkB5Yv60b^V7pF=<cI$aNVjuoD6iF z3bA8vyO%x1wi-lJ>`Y(V&i;e><b1gq4*E=N-*eO9DQQ2TaSzVx8TMMp!1SJXN7Noa z4#V_v-j>RaS9md;*IhNtcLjiHmSBiCXLcwTmHIQHZ^-cWas^I37mniLwy3f+;o2nv z*q=^>5VG%cN76*#mT@8OI1!llcpaB))zs^zRhLw_Zb*7Uf`CYqSeThlt2YVLu}TCu ztv+5-I!jXtr6wtTEam<QXICpWHJr*_ZQwwZT}F_YW~uzW^|p}jJv!X8jG{yJov&ZM zvlG4!Zy)^e@elv;Ro?{3o4uz$TL730UD4`E1lb)hw0-_>KKt%}`yN30`9x@W%jrB5 z4pKscvHDk4HjZ#qU@0k%;)q7&wh`v9unc6Isc!1l@U6PG>)WkbwO0T@xvg)2WaYuC zZ$uae##|Lz={X3TAYQ5E6NJFg<HhoFD{o&}2r#<^Whnk>ETL2~;O2*t{YRyo`Uqhd z2zgTS7sHUqb~#IyR#ntHtDic*Ojd-3Op!`UiAjASLo!g$iHtHo05T;KXN&mb0I+c9 zf3_r%+s5!K|GKyn01s92SXH=}ht%0H-X&<`8fV_^0j+Q(Bs}!MaNc4_DFi!$bV(Kq zuUm2B9NI%)(XR^!*X{7Poo+yezG4u4aWJ0(j#(kcGA1kJ9GoC$B_rHy{S66Y+Hu9a zT5&Ha&8|OBe!5&{M|P!myk3Ep4~Ib-(=sn0c2VKH33;HgdOS*nz}w3ur&l|)Ti6TF zwNv({6Je<`cR|;?W9@AaJOsmRL~$5q3mW~{XaW>h*-&RZiP5(3bKGF%e5V5AM6^sI z!;YDL-!O*!hP}RFzgLH}gtZVth-d%P6Mkr){@IiMRZ5fCieNB!UVn8hR}Wr`a8)$B z{9{i3`~<+;|NCw7xkd1I7uS=$xrH&~ZU_iaoJ4%}N~Dc$nA%hrS^SQYps5;w1&^w0 zM*TmI!?x`VJhx5fncuW^$5$L-9Pre%yw6_VP7<f(O$wvXNZ-ptYJo5c&GQ&ULEChs zv%<6eF%gy*TUc3CGL7dfDPomNNoO{64+XD}2>u`mR~_tGb@C#4>)hPyj#JcRx8&%- z&j=8kmlAkCd2j%t=WoxQ5vv83KNvXkYqhfZkw`3<)Sg8TAppAg&u1Wd@-LqNc=PXG z-KD%0$vUXly&{)CeCAD;e&)8D`k_q_1YVY2JI~vcPO8}iW@}z-4REOB32Q4LM*Ne1 zR~-WH8!v(`CY=XB_ds9w1qQvQQ^URd=*75tAIba?AW&S0+oolwEazN)fFrh9(YWDe zkEUj_j}BH2N}RE!&~4E$JYKZeL4tM}T<}R^b{fqK02!C|b@R*szIgIL&y`pGOD+Vq zMLAY`5Z+U;&dY6C35YC7JTa)Utc6397Jw+LdXmQd8^x2!j}G?+?jK7*n-45mHv8>` z`he-9)eixIwbBBZZd30O01zMl%-olyY^XKY+$ab+Emck?nPm`#pOiMUs)1n(<gVuP z{bAS>pzw?;Z{8%1KKk<$4A}z<Z8FjSqMWbtuU8<9({%fQYhVqSF~mv46fnqSwp0}+ z4tck37)VJdUOI5vdE+#4r5_PSA-6q<5LxvM8t&8GE}ip@5@$&fgn=VG;GR*O4CpQK z(Al~V=|}hI(c<~9PN8YZhGSfAD|rs-Wk*0eZ{?{5VIa>)@|H)Ln#P-NHvq~7|51wH z*6Mo9)BUSG0xtHh*fe2VErr!cvx7}=H!V#y7wm!hk=u_%VtHt*jUt6j$0M_zUKPbp zA3s!c!oPU(tN-;|q_+X^0Ds5nrZi8Q*h$gq9UKkJ=WfW09i6WIx^*8sZ3MA{KD3Me zL>^A4H)QuhILHd_rFw?~BN47zj=sXXrbBWMCO9JwS;Ogh8!Wk5YX4$#qOG^5oxX+a zv}ngIVg16kiCA!T>mf6g{{7kHg_MmPT#Lw;r_$xraU5XRPNkGfk8&sfeR{P5FiH|X zM-2giqO80grEOV-(}(ry9ezXG&KTK$4Ehu;qJe%exQQCgGgC^x%!`4Dus@r~`;r$G zT<qLvDo`L=N7a;&rHR3ryr|@nD9uaY^G6Tl$G&@gCJ$?pr4oiu6q|vTn}UxdYqaS; zPF2yo{p-_{fBc}*?M64dpaLdadE@ogBd3qw`gdyxkm+ia9HmL(!D=#!c-pzlYY$=r zW~fJ+6>OGJLI@U(sIS&l%V9Wi>%rMH^=2C{H4UI}joZ;nP;;|588oZVMPGVm-bxQY z*$1$?*g6&v!iug5M?TE~NUIB@KVkIHi0txD2(jF30fd_rK>I{Jx%2UuTSr`<{t7@c z8Oy78z1{*?OhzF3^yElB0T*9C7r0|@?Qa%|y-<f&OoTuuZY^E;0DRlLF(~K{mi8m^ z<U4r(qM2maLqr}Z(=D*x$9UHxgirH>y*2JNN!BV2QiaWKEv$hqi9y8<gT908Ug408 z6rE&$I+1~aR?pWERq$CudT!gxz1nU$M`x<(LIY+DLaa7iK%Y$&{3;6om`_FyMa#YV z%hPY{i-dTb>G3B3ML@865#zDh)29y)!D71q`rQlf3i32WeE5^i`FA~tQvd0M^#gFS z_<B^1M~O6g^RnVXU|UvMns`P|MOm?x_i&<!zu4{4)N_9B<`FyeqSd1m<XZX(K`Qm4 z7{+FXQ$c~j@Uq-SLFhudFmixmD1`O+)q_cC5-b{an&a#tTfj4(!BT?JNtoDQ$TR0c zbbH~u=a<iZ_TY{aU+^d;Aa6zGwg@MqNWKz3%Rnew2j&4B{^MiQWIWx=rvK_w0Po){ z!9rdSUs+OD#j#2)S;w_q)3IQIf-sQ%Jn$qnnD(RuR4#6H{&uO>1Rwx`ZU$~!#V9xX ztnykhpT{u)RoS}M3kbtd{xyu0tE*fSB%??k!1a6OO*@{cbc<B<i_=Jzy<Jrnu9%^{ zi4`S_z*@R{fsJ6LG9malr|?y}S!^fEu^C8)xkauF0+C5P+m!D{(i&pi3*qjL#MwN$ z<LCJT|JC~|0%qArK%{$5m)q+j%;j5?G}$l)#SQ?z_eu2F!Glcc-JLOh@p$n3dabXt zQ>B<CWQG52Gc4-2xqLD9xW9vUa;Qa707))}zU*SHr^cjT&dYk7CSZNQLiF;(qF>}5 zSoM%s<72wJH`a!SWx73z*3G?U{LeJF0%Ecc#Dnr7b`^kaUc?8V_b!@!VV#%bQQ;gf z`@}}(qPfDB-uuOJ?TDTT0bp-Bd2@c5#IfLMFEMoIZ+$L?Vf8+b6BBF|@bkmANr>ed zgib-5J{op@F3Z?;sdr&m_bT3yl(sG4cCpLJVAjY3JZC}uW+#*5@xrw*44S6hb#1Di z5Qpq`^*VVB1_RjFwc#78!gg<NeCcLri3E2$WqrDO4MV+EZLzIb-w;SzxRTR@Fqw~t z$$>t2x_A2W%AwnFg#_W{`xu2%b^qAn6qmeVPGH2^iZt)f8X>49nOrD@00|MER<Qgi zn3m$vwHny%gP4H&yS4o7z3CVPTyNExFAD<g%_j1|*4unG9!Wrba<mWNudct{%(okC zPntszo*f?mcy@FE!i%#D8GFyCBLXcqIT0>aYg4Hg_&^fYU150HgmC~M$$}g4PdLGf zu$&7agt+GcMq(%fInWy_Zp7T1)iHYW{jTbx*rk-aGr7%?3Lfewdr##b%eOCG_@KdF zm%&MNJhCRhGAXwUeF2D$cS6EIulrNNtxY<j!Tir%&!>=>{GaIcd7)>ULwA5-+z7+B z0MHFE%;;Nv>i0G;{5|yu*Xz8{vd;ruU8mP80FyL<BY`HiRmmu55JH(y?a!x*$l;7! zQPj08CoAE=d_d`LwH=Us;Duq+k|dKBYKlMjRQ_SPz3P8`YHG}cH|JO8hMXMkNklBq zer0BVc>n~&vC>M+t0oEpkCK@tkx4q_m9q4ay|x5A(c*a*%e6e)t!7G_scl=9<{?w& zKL8eLPCmU{%AFtY&E>APMJZ?TciIwTlBK;!TK56FnD^{w52~Vm_3e8pVR$QK%EqL3 zFD~yguX!?-Q)DIxRzTuP`&s95J(jIzpUxae=W<@CZ|YW^C;^}-3cv!~Gz%!;-NfkH z&O~=|S4WQ*ufBb6HE)Dz&G&nR<fF-RAw6Fzr+r*lr81Z<Bi*aU{kDYtUA5A3o70IW zq>Zz&)(&IykzOm<9&(MDLgr@ql=C(^2k=bnn-JT4La??qW2?L_s_7^Ju<7ud-l|;v z#vl@(9PYsvYQ{KA04lD|w(KN>Pc!^*%W#d@+}zX3@T35GO-IxN7I+>BH_KTNZx;0D z=s`)un^Z=D;6fGulf}~>I1ZxpF#1aOZ!t{c+KImA@8$AsmZU?ueDvj?sMq?;(1R)b z^%+$zLD}!MHc~meFTBC(T@6cpIqxAy=3y8X_VzjpscDwpa5ogVUS6AZ4|b(0TuQmn zZn&9FGnfyJ;`nmCSxm=<vLv*zeY-mS;563#g56sdG6T^t9J;#ws{rbzAqqSqcV5-g zQEFwGt%?Ghy8+Qx17QyvUl0mcvIC5wC3;nBC%-+^HyodgIJwst`bKeZdAi;za}|UD z0Du5VL_t)4Fumi|diZSLKxvZPHD{<IIkJH@xhjmJ6JCQ*U#8J#P7x*6<4FBS(Uo;9 zELvofgcH61lzGL9Gvd)_2d}?77n0co0O$&Z(5iw<2v5~l@L4Q`D2rPDrfw6`%}c6H z2oS1MNM;>KN?9rUhX7U%69B@q8ftw;t8LCZ(#3U7&SNg3vl^i6;m_4r*}MSJvxkQg zub;nt&y-t)aNH>dz~Db!egoj2?*EieAHo_Ff;mwAmNav2MPj`IVg3We7Y+9dfup)? z0)BcV2$1T~Hwh6Fl<*3hj?<;73aeMT1Gl(Ms9$c`-w3J(X<h+9&?;Yc7Ft#Am#~;* z9u#kN6yi!l3SW?8ht7j?Mw4?{S=|?X<-DJ--grpiN_mQYw$pF#8k(R7Vc1)x^wm1~ zw0<KD-_Wo`{a<%a%4uM7V3;=o3q0JPdkP$O6{77Nvr(EC<v^#j&NdIBARwIw(|D7Y zhC?a8^5ke=NX;x)LF#(F6$0}~#xmAwS6#oe?M~TfF*LZu4PO^NA>DbE-1H+4YnrCf zY8hnve)L>tWSMOgVq#Ijc^Mv4nk|@l9ONr!F)ss;V$NWAkY$}D;otz5Ej`Q2t+MiE z4Z9z4CRL?Sb^!f;T;H%S97wo1QudGyLM<E+Hi4XarKuXJ*9a!yTvtxF@q=f3r!TIQ zfRuw^oG~LTvRf@~8+Yp44O5&qV~aJ}t5L$*_TiLZ{oCiTEZrt0g*(;=n#~?^2{=yE zO{x6HUcJB4o^BX~;S+HnPiDEv37AbXVy04`J~-GE6$r@j+XiAGs%;A(8HWI_-F#Sd z_yvIV`8V?1w`Gy9ReEnSyL}8tgJIe(hj#Rt(r|gQK2v&!ZJ{&O`%XGNoEU;5d0%LF zM((3;A93Nf8)3mg(^tqeyXI$*C5bbo_0>6s8ii#lTfXz?V9runbb9G55_vk5xNnY} zQx3o25B~c6TRy``ik5shA06&HvcT>>U%$WPxc=;TUwL9Ug)#N5m(o>GpWS?t@gH4T zPL{Y>Z+c6CVfVi{e+?iWCEz9l80xHc7eWFUkCJUs3HS<Thx5t%r9vfJaR>6U8YQvJ z%9?$0?wh&h5BC@BMg2sL>|&939Gx8O$v^N;i5Thwo7)~jnH7*1k}F!6N&T@^w0O%4 zKJuTA5uKP4mR%tUKB_@nFUf+p+xAbqtjm<M$aZnsQU`BX+EG^?WXc1;{6NKU)&1QU zc5PKrd+4iChmFTxCbMaK)#ctX`?45P47s;SDGc6MCMi*hz(FF4L&uen@c8q?^EXRH zeuG)V!hMCcMVcEyfM9*)uA_vNKjRz`!D>W$ku8L6a5J}WASum=2s|sIbpZT4x3gHk z5jo$+7XVJ`12~<QESkP;55MV6!tjgnyQg@-roqnm-iZ5$={s^beXWKe7#{k&#~Ff4 z#n|yvUdj1(Vl;2&CK_~r*g<0c^yJul@`tzY!7#VK2Jrgfd+3XP`)eP4<=;keTvWAi zKWNvrR#3SY>C%lC!!Ae$uC>EX^JEiD^2BRcVt1Y&iojq6Ui3#vKgB>8mcx3mHwUod z+;10hkN0Nq^9E{hB<(KjhxMr*E~dhB9F!~5s^(b``Q~hr&3sqEouI$_#gDUba-x7S znbT4hGME)^GDnEncw}+|Hb7x~f|G+i`EYHEO5VUUiOH=#g!3oz4ra^OW_WG#62APf z8a&%V=^~BO)N4AD2P40rRx^azPZtaw8vyyXk~!XVbbAK~Pc`S8GKzvA2*B)*Zo}io z{EEcpWE795N#ByM+`4@}LS!>v#gN+t0%$wYFGf%>6gs=DPM$+BfW^^db(urfrwIUg z#=Qb4^BO>Uslx7d-f4>@)v0V$sM0KvY$<hWb26F=N&@ViBnMDB9zl;cY35_^r^0e9 zWRH*@9LslKsarE0Ltwei<?DNsF@R4V9?5y-+c#$li3O=u>}`Fq28LgrUI183GWnwy ztDKjmez)68oXS5u!Gr4jJ1DD4oa`?S=aZ_`U8!k!2LQgMvCd4eJ_y>J{!sq3m#1Z{ zD!Ky<4>!YlJTc-h?Ea#I0!NFPbKK+*=Y<==ih+HIZCMSS9`pScZmE*}{wR&$BZ5E8 z+pH1wHOE}7Fea|+C{ztxYyDCuMdW?i1OhR31|wT&2p|C<a8?989spz8I7iaA84x|_ zb!*}F?`xfiR*#%;?vrEyon1+BdDAo@RNdXkVCnEzK*Y0Shz*z)^eB$Xs!pOvh#NTp zcZA)$bEj|KT#g)Xw$qAIrnpW*Aa8>)u}k1&B(=JW^-|!jh+NOdR-QTWnkTe%>9;R^ zHPCd#2B@AvbR(Aub5#g<+qS;SL8>XJmi_us2%YAQ;|PT7^UdOL0&Qq`m)vz#)MY*} z6HWKV{ZD$Y4C*;oW$n$4)H77=N6&E*5u;5LFd8RkudaBemrMbb*rJ&~#jI<Hn<(hu zm=%tAF_q0*!f{vNMJrZB@VpmU1(c{q2s0iW!jZDNmBMVEo;UHuSd59>Ini_`|Gn8> z;Z*v4M0qN$o2aMJa2o*M`msJUX9yN=|1mEG=_^uNCBqxY)I6f18|TQlJhN}4$pCcj zLSIYj(VXW&-3q@HYxn)+=-_<0?wvN^{UrAo>G?km!mu9=^SRGMM&Yz*_f@o*hmj|O zGH70FxR&lfa90doZj-~X5IgRc=$k3~%M*^@5`BA14tV>Mzk9yg0wPUf7a5Qyk=W5r zHW>ek+n%UfKXBKLQ%Su`$0~br-p!lPWp$exu;s9r!l5nx0q*_PB|WXX&pKXMLK}Wk zaF@f9pOgj&B8dEuFbsXwJPCDm)ye@al{A8g;Fd$eFo0{HK$>Hfq%jfds-b`+;j1d@ zWJiQeLsqzb;?-!Jl!XtjLFhwiFqmL>U+h{D#m*Porj2_%GRJw2ITtanYdcli)RfSK zJ5wEi%TKnC6O$b!5D*`INubsHUlB0V9s^H~4zvRW2=wyoLf-FZ4-Wx6)v?lxvvUZV z=~C2clN0D-y^+q+?=G)QC?IM770Nq43iC+{&@>yVqX>fY<$9-Y+wXd74oU&Ek75Aj z-(3}D4Xx>RD*)e33*!zjEbee|gge)WAsF`K;XxQ4@~J)Eo5?Y^EzSnGG(8CHYt$*e zPg!xGrUCTr1AsV~Pk@Q&x!j80^JRYf^m64sr_L!qJXnzbEZfS_YWtG+A||7hAL&-+ zb%hYX>x(OX3c3MCJsL}G+A3eW)}>9qGt!=`?J-$x3VwBFlaY;<oo;OL?&`V+^geVA zDZrT1Dg8GT{i^PX^gw1T4rb%?)rQ}uqN?1Ys1O20RdZtY18w{uJD|Mryee#&Fc1Uz zPu_-P%E@cibM@0FN~!LfSMPdvMBQ}xyUT6vt!9io0YGir3W^++9H5-AMcO1HLJ$Pk zq*R<}92l~myrm(@{wwOlIS~m$I37t%>snEmF+w0h7=<w+<~jfnl}%@?e&h!y+1z|) zs^8kKOVI;1`3FS_Ce;@tQ#EFu4Y)&}vKZnWx)$nnZ>#!PI*$3kHO8Ys6i6af7==kM zmTl^`AEzn_4tML^<ZzruP2Jw*i{1d5KxMzj+NLs>LXE(ud#`?Yr7liX%Lgjd52Cb8 zF!A+TJDX+KN{F{Tmc(qTzg>f{KUE^w;(DvD<Wdbw>COqzmMzc>35?4f0lc)YwK?Ql z!qjKU=w_&dhu}&r_ZD$xLR^MjAn@A+;QO<#-@JJR03&4O_>Kn}g_q5-;hSjo-nQ_B z+&D()Kdy2ghRLUJNj5d#&*<<ocSZrWZ+OxJz~iHR4gn;ILOVKJ4GbIf#cuT5)%P+U zC7y=H@Es5XAaO9Ccvb<d4c@z(!^qEq25;rTbP0Li2XD>etw+3Q>!#~{DkJX^a+flm z&>DAG8gLngzaI0G(&TDw0&ey|7;w$p0*`W2cbU)p5=Q%<K%l;Q?jkZaWy!c#>bC?? zSnFB!)_juXRXwaOdhciTqkYg&QW<@f94!ukQ5tXal7*xKKyp0t_;qd5c3o?GWC#Go zDbpneh!7>dQgKtYL1?9n+1LStTWadoLtiCWVQl^g1d7vWy2w2Eu~LzGgqyIEm>Fpp zl4ISd`~n^NQfD-&$a#m)RY63el@7iU67cKkZJXtQhNV%Yy5SY{jEn|<g4>6yOR+9J zG3N*W^x^4$ddDV_o=B|?d@a?@&1vaqS-1jdj?ao=95Ce$o5@f~Go9&B$rVOLwVL1B zt3tTyjKs`i@2ycG>;phj4|SBpM1&fD|F?Xx1@P@JzP%lQdqqIq%{}ZD2-h-rxPOMF ztZ1ivhc`S~ij}MMIX-v5O)xBOQwMbOnVY<vj8fa1+apumfWA+U_Rm*qT~ic%+7NKE z&Zc-#)^!@kzH`-$Fw7Hz)Q4eP^%;cWfvUO5R>5~#V)=jlun)uV4Gl{e%AZ>Xfk#Cb z@2-~PQR)-kdSo|e+z1F@Em3)7GZ7Bez1K8WR8=4<dsp-==>~54&XzN}5lqG1OUJhg zU$ShuRXSq&d{G#(60Z7g_H;sAT^FdUHb^2*iAkndc?b(l`BAYCfk0gKN#bZaiY?Gu zZ3$L!kT%f*LYl@IamrrI2Ox^Wai82|%cx{b4*G!FwH*`EQ=?0hl^oD@7Y=~b$uXB& zlFp_+DJae2eC<mviymqgo2q{&>mgED=0bHAC4Ihk*ZNGZ!+(7I;3D~j4uu~dAINiC zZ*m^{Uteu`Vgv%wsUl%z4}T8;HZSBL`Q+h|ysSUGea~9HA%J-E0zfiKK{9P4NZ{4k zB?!}Or1E5&Twb)vdP|I$CnIC|E&+4tOrU4(ah5*Zo6Ebm&PxKW?)scaGZHM%eno7# z@H^-QzICB+<GWw{(dPg*%i`_x*Mr}R(4VY_dP93K3=Gcl{SSM^NpT}7y4QKa?PPtV z>6b`%9R`D5$<h=&A{*%W96(<wBqZ3E`*`n#(en6;sxfUa&Xlic4@A3Rn4g0e4YP|f z1jFv-b75GJFLyO?8~JZ~Z|{O(W4zOcVef3-T`iq)$k20BRFhFM2#lMu%8GI@tFbL> zxCLM##Qt<Fgt%O9`KODzPUG1AtN>?MnvNqLe1HDvfjoJm_XM*JaEA+TR{r9#>Q#8S zZ-4%+-ou0aIs4JF{{dH0O2Kdx2AwmMgb+v{k40ygh-#D=1qOpRqH~x*vXdlALXENt z_L`~<wf=(}%UXLhl9G@_T-n$R3GM@Lj^tLLiXuN@%b3G<&aio1CVwF!*Il8PB9@EF zNFE78<-WZER2tm<wh&$GPYHeLt|(5*+z-(DA#ap~bvbYaJeYsCSBmfTRplO(o+<cn ztFGd0Ic*5KZfrjyXK3Ck#HM)Nie~zY2wroVZ2-2OMV5yzNV8l3%MiRfvT>&*)?fAi zpWDeNj{$fv46g<}5MJ(v;bCCD3k(n0ywDBs>4WJ|BGkKa?2NWWIZl(I;8^THU+1-F z4-Q<wW24vuZ8(vda9160*8w}s-&{ENB;i~b?p+iIhP|A$kD%;buMOMNl<vWBFBRhV zfbl5Z@r4#U?ygz;zgMX2XtBxdcyIRoyL10q3ITypngC*3)Sh70wyd%wfv}~hqN<Pg z=0$mJIvDRd6@1Vm_c7M$o}`pDH#Uo8dZ5#nJk%w4rPHnxK}c}@d88NxxjEh-AZ`Ri zL{Sp5bhO6ffV||h9CqXabuz>m9_$GoWJP_1>o@GwrCu~8;SbpEqBsqpE}K4aI!>ed z4t>vu|LExazr5#C&zfsx*~oB{(tfM1p|$G|nEWF1`h|I)Pf4yank%YciFsP=(omhD zu$&-{7jsGeAkcV}-0P7j&%Od^ofq;TnyxFV1_XReftKI+R_D%L{`?O=2at@SU;O2- z<SUUogOdvrI|T>_r<xt^fIH?SE4kNiK@wK&{DvlE{$FyTjs++L>_A^{PnKgiPObj) zAo`N%frwGo^%W&|#n%E-Ka1>X=0(j<_nnsBmH(DKm*!keXO#Twc$C8F6tEA=W@`eh zfvc%RB&c^|B&~7l_#Nqzu^Jxa3R%BAyL6n9<TqtPY?J~*6U)7O1z7a;FWb@H3_u6Y zxK^L4uU>4cYLv#p&N;}-O46Re7}f$PtD4JU31GF!<0yjUjP%C0f7^V`m^&n$#jVhK zrw?#RDX<Vm5Eh?~T<DcP0>XPS(9B_;d$NpQ8?T~kIxP|9RDXpdGf7?3$&xLH<R}h# z9$N;`b=eL9F#3Qr2wel$Wyt%sDO;Bs4Pd}?SDOYpv2s5^M?ZiDf{+G3>1}BiH+9cC zy&bsOVH|pGz66SUysbxn{%G@GFAZ~9rGnv{g^<dC;8h4*zxxV6G9Al_>w3MF@9#}j ztJP;GNAl+V^*7H6m}DbjD|aafV-_$cO8H#noHv_-@j`7>@ap{~fcYeo$C1V{Z~3_C zVHq0#M8Yl`#I9BR$KF0-mV5URfAaaWIE%NdA{uC)rC}Yce#EnzDSbmk+tbE!x-6{j z8vix1OBd7K^R}qup|8tw__x`8@3)Q^fvW!aa0+g`#4A*{lAs+59=#o2ueYi0J(!FV zC*N$v=msyl(*$HL!NH##o&VK)e#glrZ~HN>d+Bz>%C0(a&+G_8e#3D3#5{_Y7#x&& zUtm%g?aAuXlS7ubcUC?174tXL59cV2bCruWZKxuRBhA1P1FN@NTZ?d?5Bvru2renb z3*EC%l0j^v&=z{-#qV0d1q)S2sR>o}B@V-Ym5rg56kB^s^?W<Z604S`|IpN}jL`Jm zCo$C6gP~woCcS0L&~~kc1jnaV$Eij=Bby}Vky{)o`<?SQOK6I9*LF@@lu#94uc(}_ z%ex#Qc4&1CqH@?vr&mLZiN516hL#<pKV0C~r7*N6r^`!|EX<s#^Ce6!)Vlk*s@;Mo zr-jWgGq+3AJ!~|w^h3>cOikKZ*z%<y!kg^$5su}@POnx3$4v0%?c{I)(8+-su3ufW zqt!bA>)nk^kK)5O^*R1NZR5QR!1mQOnEGi|G`0pTjR(9ZzV8Xs_mu4?Hm6zY@gVx6 zczynZx6gPy;!Yd@R(V10XXe?+{x}hUCrA4p<?-*HzrI;i#6e&Emq^<-<X10-&{y=) z*F;+KPopH}$r&03cL*q>X>VfPr5)zQ30(&PO#aXo4#&G48*PG>I5~@fDBS|XodCF= z9gC`&T$YW72|*u*>;z$AW(Ie>Tq>M<gwZHDzgoc)b^wIH`|I`Ld<yqgN{z|=*+kWx z^tZNEZB6<B0LyJY9gnKIF-W$~3$SvmIliAfIyNsFt*$Y9Somm(4t^s4FuC}({Z?Mw z0MPvO2cALq1Dm{%_b-k@c~xeg&m93O7dH5#(RCf?63bVO`47(q>!8+o*1OQtKqH-h zX5lZ;)U9TC!NkN}EBZ)wQ~sF%)tKbtlNmUZxnggvuWT$RaThzt$!5#fWj0N{wP`j@ z`xq=b@o`h)NgDMrxXkN52FGdC$Kd8CY541srIvjd?)7Jr;WK(9J_EzTWi}grgFNl& zIMaMsVKZU2Yg7daj}I35ZUaQGgraUK`6}Rbb_U>ae(cB=-C?t*#F_?)ZvKimi4KV9 zw*bQ*u+na-w$5t+F}vvzZlQWQzehXc-hn=pUCy%ni#ztUQ!dNzY~gj!9nmNEOf~<P z@M+Ljc+y!r&{v1ZE-Li&riB<lUmuiBN|P-ueMOSHx1IND##S+@clA6HmXH7L?dzo{ z{DyItKreO~9XcwWqtqmvg?j@&JvoBz!Sybiw7b|A6~F#MIcNB}jcqMRG-(ur<&TdS zvul~b)5lcR4en43zP(y3#D{$AexKALUjpf86LOZQL;!`<V=SR-yD*B%yaq%VDY*!# z8>JixW!H`D&(YtOViyE5Jvjns>&|?#E*k}wTg|zhBr>%n2$Oj#JDLin>}cd9mls<O zHhrvZZH#NzCB`|}eC6PwmA6}IFy<U6lSWoSJORMrBPGfB?)jxjR)<<2gIBB#7uvW) z0Ju6+0y~Ba*0t@y$;>;orf$uyOo$vOp;Vd#V}@6GJs3lq#x1-3eth+p?`Pu-z*Frk zY0B^~&n{$b_}TG+t^gbWcyW3mpV0YaBu{s>&E=eC)Y@5nfj>pQ42x1jgJaRbSy)yb zTKJW}*V$QgHM&<baK{VLggShWy?}^rkXB!fS}Aq1zySeQmlybZyh%;dh@+D{<KVV= zUeDD|oa>c$>25IW<rb+2>4WrKF3rdrW6@K0V8&M1T6v9uV)Vm5eE{IyU!DqYr$XqC zBdP!Fk+2387#;0oPhm@-w;+H+EgM+S^!y6FtL9t~Q>Y%i@D7o}LbYok%ro8WAk<~q z<s{58p9XmYne=%akf9Qi`D|Ui*qhtD>|bpmaI}~T;QV^cC|LlIR~;bG*>0W1cqFn^ z6PVCJBvAy2vTl436=FA}dYCIPFgQO1s_z5p82@A{n768|O+=~h_M_^ra@HiurU_|z z;jQ*Di$_s1iX>oft_#zdV<0e!L-}IciZE4$WC=(FT%T{^G_);)LP*@&u1fh^pa0P# zxu4S)mj)WsvBKK6?hNnO0NZGi&JUD!gh@g3z94>*8{JH7;3|qkLyY2aZJMdb*u>4_ z`KYNHiC`wToY$2Jd}jw10?%Ko^`d#Vt{M}IU%$7QV1AviGsd&jyen4{NfdRB(FUP7 z9*_jdH-20melc#o*>VDvWi2~K8?LOl^+~XT8=7@Rg8Bb(hNr`4hU1DR9F2JANTdcQ zGxB9;^r!%U&0UwJt8LEBm*tYKPnG9e6o*PRD<mQuJ~#$&etLEfRQxCfV78Cd#TG2< zQ@9auQ?(I1@~E`O5V*lV;pVv3pOyzYUi>L*z|_bkPK)80j?kmv_GifPD3w9d4e09} zwgZ?j=-YdL0DX(Hf#2S&{{MUb<_q)U-~F%O0wRgyyl}c8R6mT)Bc5Ncy(xaTX{tE8 zT>5yR|71!7-bGXtEv=Z}`yK!%V<><pNBdkLrSGr=o5D)XhX{Cmegz%H+Dj$?h@-_E zz}fXuj|TgZO<uCBzJ<oTtPU4bF1Dw}cUcQ}Raew?S=GwaLBEm25d=$(d|0^`AMab@ zuJ7;v;eolz5=#g;IGG!0Dzq;wX|y0xt*CN_Y@1d$vx!EF{_h`8(@_k<c2yeP<{%6- z{~6SDav)Siy*%H@A9(obfxK6jrz?|~ob8XH`=Bn~sWBNb!9@d6CT|Sj@MLa)$KtD& zdE)UgCmsut_UBE5<qx0P_OG`;s9<P*I598sny$e}gQn%Sdhl#dJwYr8Hu>R}(Wi}M zbXC;mSa^(XatX%tFbs`(u#(c0+sUT~=0`8yt-J>;`u$n)i>1>POIBLI^{^5=V{L7b zbW&QgoN%-^Cju@7Ko1V)awR9L9;cU*!;CMUJY=nE`1;j58D?LP3NzjSijRIqfK;^v z2CNsVZ5xkow<v&<f+omB!fn~WFbd?7PWD;`ApjhmJOJ?i?J0g2o1`@;Jyb%ab3#qi z?j22wZ50hX>^&tXx*3KoIb(Np<Vk%vdo`;lx*6s@u}T`KZR*D<P5fQmg1+|c(I_rB z8|!BD6+YgZx!~vj`X@su1^`JM**(+lJiK307I&G!2kwhcuJRg<JP|FQ0q^9sEg!e9 zDNVg-n71(v9IrIV;O)`oJmUFd00JxLatmZ>oHMq$30n83<Gid5NnNUx6ty8_+3>ck zYZ?B^x3a_RRlSBOUPb^RjDmG}X`5W#8H41O=mmO!Qv5(fRoT!)tvQlWv_#8fD+q)% zi(^DYq;k9jfUeHg6)AVv2T%9pSMpVvQL4Tg&=de+d9gJ!bux-m^Hi4&DVz(FEK;_H z`jaZRtf$UU3m+DnO5WqqI5xTBP@C#x)5P5LFb>T3PhVWgyYcj=$9jFm<Sa<3X@PL5 z!2>|5e{?jCO=kGP(>?Qn>k9>YNoujy?3Tx}yfkZ`swA_|`&b92ufDT|z-K>W75&R? zA6DP}a3N2IyDu0z7$-$%lSDp0CZ;ELf~2h@2zdQnX$~>eoysBOIh)<e30i*k+yD03 zT-fn+1m<RF8YW)7m+J|djnxO1o2~rPbiD;DLYRkC)2C^!{e`rZhW!IepK*I}qcBZg zj4X^qr523erSi+SdfNiH6^6Nq2uPVYNf)f0XqQHIMWPS1>jVf7pPnq2@AKtHv%I|H zCWkH&$=o<e7cVx(qMH`qX5y#2!tn0CVMmZ*P*d8K@;BiQCzLpIw9D6p&=Wd<_gAX{ z;;-K&V$nCsPX+b?jM5mx5=R5*yEmD@OIqwyxe`7S3zvB`48z=*;;!vo!}o<F<d1-1 zw(@phSgsgMw|@T^yt|+h&fet{>fXuLUjMSYAMBhnaZg<kiLR*YG>T1>TT~5q0}%q@ zVUkf|1brlQG(`g_+Hjagfo`f%6Ae)q1x9G1u39tMMR6D>A&AD4#I(#_o|y=S(kyQ3 zmWU+s$z7ybJesKFaIq;*UtR&&e=rT>KpxNfGB+PSd^Fb+H{-G`b1A2sO%gLrcb!PH zSRRBtDgfoSGW|(O8pWFMEMry>-u(K)42d8lGgvq8RFsoV5=A5?y!h(WjF00dQp=XE z-mlG=G2tU8Gp{aK7tKr!uCD8hTvR+%g`FQ-lOmI#2Jq?|m0jfX^7-}BV4;EVAAVt# zw~wDL%%87L*JeafU+c~G%rXT>Ie`gBOwREq;tO6T#;7S5w$Z`wD{)7-(ZL{hqVT6M z9oH(b^6ZJ+zG2xKEHlfbDb(w2Nra=l8L^OeoTU(y>^)UVSow<eOVU`<th534$-$od zvGVL!B<Y8@MXR^MFfRo{P!Q6MuC@R`%HczOux9Gwk|CJQBLF`VhVPXQ3&J3Z1MB-4 zs5ri<+hSXdXK57gf4aT=0WKCAwx=0(5BKKqmY%i>rT%n!dF@Fwoa`@pR`LrMh#U`d z`Q3?h<gmYl^|tgN_<FPT+yV^x_F`NbMqeN*P6t3!2mp`%$wLrcOGQ=}Qi`e)27L`a z(S7cXpJm{l*v=ZH?^|&CpHJCYv+%#?fCeu`P9Fh=J#E=O4BIv&S4GQXN%2CfdGT;Q zdw;ze09(yDckhJiDmFkZ_q8`0UoN-8ZH&sRhNqkXfkh+*7bTxa{x6%R$=G=13JF1F zu6Ra72*a>zJ9){%P=$M<6A)4v3QgS>n^JxtiUP?imZd4R!+^#!>7h$?-D=r-v~4Ff znbUD1cSWG-ewK|DoUg8O8FFozSn=X$I??WXDx6aJOm$P^B&-TWm{MW45N+G#jS`!z zist%!D?ctPz5wDRGFTo);bftn$BJcNO;5#mn(A1PPCnT;bHnwy3TioB+3=MBw0ap~ zs7Y{XP==k9uWSTtGR%M_j<t<VTyy%82{pLbGFNOi`QGpT_6?gSxE(!fFcgksHfOr{ zy#iiJNHFFjZ?xCH<w|~YTsN#{k0J%<0pb7;>x0G;(iVmdZbSDZ39ZE|SlFq4m5e$x zcR~>6@fNPkma!Pe-5AgH?u_&%F9@{JMY_=^<68l^ty?0QV;}*<lEFZ3SKdd0;X7`! zVq%ozv{E{fG?EW&baU0&&~7{_$lb~u4ryqooFN-=JD5VWGX*^qV0np33=p5~=uv$v z0-Lh((0B0<_6gYY_N9x9UboS%R#G9m-34|FZhEJwty|gti0Jcw@yuCc0Pi&V61+CR zz8H>sH9ryz+g#NU44a-|-bQEyG<&zh>B%{mPq}Hb`Ogsa0s>sqLueiNysq{{#$i63 z9H*Nz%iIHky|~p9^KILa_S*@Fs=NkavdE11;`*vE>m2nwgB0JG4ELB!o-j!w5TF8O zxzz3ClSX7RjU-W7GMMsBDKyy355~~>>gC1u@|{fNNKXPlDm)w00>b)gtAWjSQmwCZ zdA`=`p0uqHG~ro>2xV(Zs$AkxmpPS3f;_z_38ii&fX#JofL2ABgv--)xvebNo1x2+ z##d(wm7V-EBQe3Xe^T(tP}%AJibD@*0gTvBn{+f^2XOu8cP}pGA0~^DEID&MNJEzC z?Ea;`2LXuQ)%MB!G&aCfYB?QVZ!Wf#Vq7aZObCdk>O3(JtK7+7CscW3p3hidmFM0h zcyhRBo<X@JSZxa17RDZFX><>g+8tm@SC+mdq>7}fE)!F$)asRH!6DEQgy{7BVy?rt zfs_0|wQbwF%NFs_2NWNZKv5i#TX!EoJGpuWKuFUFOi89M2=nn_c<6+iy6svgq8QIc zCa2ZbZFHaA``sv>%;YZC)GaVPOxSf&I0L6CcDfka<T9JH59c$EE+*n!{Db|QPdhJb zas{5*f578s;T_&>*R!naEKcAx^8tJR@L<<>j`UgZu1@yc*()U-@8t^{*;uLZRMEBc zXTNyzfC&-$9pB%)e#h4UlWpP5kd6owqN6Vj{;%JE4fme<{Yd(H^;J{kJ&a15ujEo? z`|~MOOl&WHUNyOL8&s`Tqc{#GM*^HzEl57+LIhDrs^5mPNo-)R*wktQB}%hsx;Fx$ zE<0lG1?K-<+u4ELb#jKAE;3`JT34+m5>wN(UE9e?iio5h^89d;O%wU!7w=Zf3#oKZ zqj5YM%k(&kZ6$-nIEm6s&D1Jy3;<YNZY{ZYmKyF)ZiJ4Rj8{{2pibTtnH-kKKigO8 zMO9I&Ix(TCTFr_g^#=k0M~@fszMj3jzIeBiFODXu85_K6YwY$G43K29T8-*QcJ*M& zuFPBqC1XqRDOj#o<XM|CHlJ!arR(U4%{=Q$w&RqrzRr2)E8uz!u{lfY&G8bCZS6C8 zEl*a5kAJe?0`Km0-N`u{#ICga4U^>c0t>DS&BQl^l`$p34U~icR(VOl@nR+q<?MP1 zP>52^A^P6)=5qmzvy_DF8zcfA9WDp}$$#TlczH*3$**ew9ENQ)O%M>tC{pW*H#>I{ z1cBlhlHwajv1SqOs2%^Nqv0qD5UJZLlSWdRzzo-D2*G#BKe9lLb^dhbRi9xcdg>5^ z;{IMD7S3>o67}v;w78x$Z(9*PTGcT6-hX8ydfh_`0F2cg3t@+UL4KjCYXMi)lGmJu zmQ;dSPLLC}n!bBC8g|wtO!=950ddblf%hGVUh&-(0q|pG$0&^vv>bw(?hMm%p-yuV zfTE}(T=b!LTUJ&jRNv=O5(^>ns^)jbs$c2+UNtu9D5T@q82fZ>CzG^YBTQC5hyo&s zRnn(c4YbK3Rp#r2Fbw4%s-jVltfh}7RIe|#vi=0Ze1ANm1U9H6B1F16ON3%wji;$R zBw4kU`{dDK%DNX!BD!M625}M<TT90^uN&m!VJ`O}P<tjKg`MiLI(RUJO~|XGkCVuZ zTa!))U|N!hxefA#!t!!Eh@)GE)`r=%|6s~yv2gIid`>WFYMu-bJ%)kYCNmoZ+wj__ zWe7+8$<w~@1bfZX=TH#YG{tH&059x<rG&LcGYz!mn}pYDo6p80XR*qfc08@kCrA5m z?J;nsBH*dq2~lyqR%=K=FC)>H)&estB%LbgDPakxIqGH;u^|{X7@U1E&o||S)BvmU zI?3Xj+l0b^!ZflsOJ9h#Zf}<G_|3sE1%c=HEFVnM7Z=^DsNBz&4oKs=&B9(<v=75# zkQ^<1^Vz}tssqD5rN_V7{owV^&<jBP(f{MiZ~pD~91!FbF9w7^Zr!Z~a?i)}HU(k* z6!u`)d)JDpyR0wsaA7cwP99~WFMgu${tyh?C|ro02@~i1{nM7sMHkm=4|)&g)0bx# zY^CLCq1e^YwyKgiVjMP+JsAU-5M;iWKy}#wG@8T&1Ytx#)3jl%lE!T#+NLuNg+Uk) z(RiL{ePfb<-PRolP1%@HnaxJJrc3Lqt(u5Pq@&p2idyXe$tYF<C{eMk)Z`c-iUR%X z7|%xg57gT6>iycZvKabqRn(@sS(mNpkm16`oVB!Faj263OtbyWz@aYO3IL-?vRM{J zPRl%fvXNKbXuXi9C=TjMRnsT)(ZNH7f)|VnZ30%fnch-I13?rR0cZZC^DZ4O?!hH2 zjOoz(*Vjf5i?f&cJeaec)Jkg;`wwQ9rz_`KbEr*v*xLq3w<gAf-&_?Nl}a@atS#cP z^{8c&vdK;eCM*ef;qTzALaZ=N!gKK>9)hd$5Mo`n1O(toS{kJZ2t`rJliuc){QgfK z9Ru|J+fz9KOh+kzlY@o4UCV9m+`8$#5zB<a#kQh=2$W{AY8fE9b-E@tFC`=09G}G? z;N2}hEn&FYwjUFK$tt_C?tPu7Ay)~@|FSz2$wyf3($h;L3l5{ZVc0M7T3YL%Aob|y z>XtV0v437^7$(i%xdnYKPToy@$k`LyM<0E6(yed7_PbLS+>Db8!vmOV9%=^!dr;qh z+of!<*L{r@ABG2gt~i}rU|UrKw@CmHo1&7IDZ;(h`}3(7TH<(2E&)8+pG%Jls~$aG zH5E)@GR<NYed?ZlS@M)L+R->RA!!%|X2h<qihNz06^T&>=sKlwAOwYRpn^_9*NRYe z9gtLjBHN@#AR3Kh6O^<~mrYao&Sq8Atr`ny78@ysFbbHMgH6+Ep=R603b)ba^4-dG z-Ehof9(lr|GQk)T0@iF$z?P6l)5NUl+NM=vRb(ry-X!T97{g2RvB@Gc1~*Y`Kk%M) z2|Gv57~q_b=2V?+^G|4=bN=gGW6RXh0n}v^o!c-d&<Ec%ovEO=l7$CHIKSA|=8Vz{ zB^lPvJ99D3;aL+TvYI5#w;MA7lymhiLAR>`@jIK(DEPEP{*2vAclF%^wG<_Ls)cFY z<F#JF2pxKwGU)&Tt2uAEUTm_UJ56ajVR$iD1F)%EB2Yl$wtdP`9RzCPD)WYTe)Vo! zG7di?3<purlvaq%uszbT8V^yFzm3wwJHTyOdlUcJ<<ir6&PEBDp(3Y`o}|NMTR3_R zJ$NTjAFj4rWwnw0o?8BokXW#|&6KGRa9->yGbP)yD#~iHdoR>SU0>;A07ab7-6-<u zET(xly!&g47{P*Oo_2;qLN+bzddEAYErnB5Ac8NH<zJd!Bbn=AOrE%j`BIi7+o~Lb zUI5q>mEgAuD(4KqtI}UA*8oOo;tF)*(ZQS-38DunXeEPI(Fv0n6J1Aysue7~Oaz1x zZP%q-JOqLD^of!nPD4ExbgGy{NJohwQ)ndSO2|~@H3X`vAz-$j$>w1ISMS%l%#7(g zv)%>3be8cItHQaqGZAXn3RC0cNoMY_%X@MR$Eq$H(!piQVnNsThvaicgkn=ksXUO8 zt^|S3-x`N5SvFR!gN7*$kPMd<w6H3yIpC6cv~e{I?q9^|&|F1%$|zL4!O87kvcqg~ zWTP-6{lQhP42>MX)%(q^HX$B3GG%o1U3rCVy<=F&H8V&jt=ts0^TeCxN*hzF?aQYp ztF2n@829KepPsl=D}DXq4H1@`5r2_@<oIXuP}Zkk$>oE=RN^#fus2}~#+~ShsIxt~ z8oU)(OSl5`H_p*FZf{?_1@Ot2&q$Y!Iw5Yx(U8&oI^j^W<21y5wqzU%-79s=cH=1p zL{>V6k%^3_NOYgQ`cj1bkk@<FlWX=r&*$o4jp5tQeTQO~8|XTr-?r}ouwygJ<WUm) z@$(M!725VLiL0CMnE<M~+1J)!@+|Tm-k4*M7yWg4;pz?AiqGME%B<#acC|F0%SI`& zTM;jw@Qb$EuFUlhdi$1sP39%@z{|HE9xONvm+!weay7=lKyKr7)N7#t1d6g6rHSyw zO+@c%+5TN8Y0l-ixrRWq7ufYcXQ_U&&?}d5)A`7hT1|LLgw3)rztS|Fk&8NhIyc-! z0HA=Ff+L7#`y;;a&!(!QX?c-vmZdBhFAk@Nj~D9o_Z!WarRiQ~jQk9j*aJuoX8TNK zi3f<+?>FWvb=8{G_miI<S+r(&wmjc3tg^{!P8C+2KLj%DWy0m@I^RfUuk9oToYL~H zgXf*N{NOKHi&3$)Y3FBO9uI=?HDhw^9Zv@jp6h{_)@1MX*}lTyPk;X4#p%m_n~)Rj z>ekxf38^O*FL-%LumMeu;!a=xRZo(_&ST_sIqjULIT@AXJuA~{-DbH&XrS#)1#>$k z;Ms#CIi8Q^Gx_VM*DC^!7g8HWhHB#7#Zm(BWR&V%6MjSlY_{iLzX0&*&puHq95?PW zj02M(ksWn+age-WlPyy9kBEjvkGaiT<{SXNF<R@5G3vLoU_itfx52RY^R~z6F1p=< zlOLEBwD&jw0_V%M9B-Mjk98n4bL!;w(2A-u=<5yfXMg_a#sB@roZVuYfjNrYyp_rW z03AfoOATj}(T<0T^Csa5wDyUTL(6M_FJ8_{t6S(^e)uX{-WsAmbM$q%yzynem8D5h zR`99=LTt(^)o<~y?#(6u3b!lia<!HIrbg+im<S@E6(BLOjDM7QLxdoNOlJYAlp89q zTp~i-b_9ykh;(!nrhy(u!PV&oK$1nK*S{=k{YQ*vqpE1hu%mSrHwc4loS5$W^>r>w z&7u=Qpn~kGYOc=LN_L8+QuiKMl-;h1#55oUWb(#*ifQUL*30dtvMolU6Q|ErzYPz6 z3#K+aS!9O5#pj413}i`_fVygp#4#}~fQxrabEo<7a4kk&$2A(0-sgGL8?a2*oA0fv zKKDB^<y*LV(fs)N=lN=bH%FbnwO~9t(vq=6#rNOHJH%&)GE!YeAsgV~Y2BMYNS`tR z$gb3oXpdv_nfhBL!L~OY+uY*y#xkjvO8;PgHqrYgF=QOmxfL}Nh+9DqV%pFGoj}K^ zpTuPe83RmMI#tJ+X(rNDx^tGIB~0}E5q))k_|@}Ie)b977C(1JMb(@_r@9S4J`CUO z?95`<JlB#@Xly#84?HN*C(rs=ihkwT%A0vg&pcIn_jG-az_p{uYtR=Sm)D2hVTi|$ z*!S6=KU)6n6$aFtZofa4Z%Ox9E}Cu!Ctu~eQ@G`K_Itj)0t53NgQIT_A$DAU&Q)=Q zn>`pdfka+b2g*{=FZga0zB(CfnR8Clgjm#D*eZz)io1vLf+WM4R#)3%qqG3Kt}`Ui zIEh532H<2i;`#?hd$MagQ*LS1pTYW4)c>^F6m@M^R}GmM#ngAZ4t1*%XswjCppKA? zVp1)&7){fuUIB2T(Amo?0~k6A2Y@t-g<j_Kn3Weto4SS0tuzd!Sm{@SlZ_O4LYtS` znyO~NW+yUDoCbh{{kbV9@l!BewvbFz1GG%rnd?FB%3V9Bz)q9@mZ7=;P9eH0o12aw z0C33qpiVCZPe6O!7WyHy<4%x2W7%j~P|pc_VEXoKNeAV7`P2R8;%YKd_N?i_r}E3I z++X@nvy?z@&adPbA06(=GpSC$miydnmB3k=M5fg$oIjRln=M}h*p#J)eKW3w05+wn zp^TG+Y!@SK@{;UROws(KVes=`JqPf`AN}Np&qR#<z>TOQgf}-3e>e=^wt04wCL`6h z3ZtSM@Zn}HXm{|qz-wO;-T>7zn5rR&UK_BV=HB^}Zf%B7D@k0G)$u=m0O0hmPZ@2N zcr)H^6@IIN*>5M(eMgo1ieLNW&rH58hku|4h2l<8zhOI&i<E5jqN}Mt`B$HQ|8Jig z=54=E3_Ceken`ubz5M1lKME`5*E=2okZRsFKh&|5b6HlxNP)5`>G9G2<#KIyE!ZvQ z7bSd<uBf9;X@mpAD3HoiL;yk%?Hx`GcCN0r04dpCq9lz-i_KF&VW>K4)|Xq;TBE%U z2s*A(5|WxyOGHMg(ZK?uC<+XzsoXXybRa}=*wjq`0;p+PlfUiS&V+_x81T^W_}RYM z|NA%BgJ{GHqFjiIhkav~r!`$ekU|0W?ux<Lt=Lp%9UaDDt;M#Qy5+m#(QVB97#@CN z%Pj9-51&HB41yd1%N?gsvIWHC4yTZ_R5@RK?0sHeeLHp`w+F*~iMtzyc@u!cLcXb| zptoT58xVV4P(zc7J!m}xcb&{Uqce+meFqJ#O6d4l7_OH7mQl{KEG+?u9?47Gk+S`P z+qZxF>o5QKi?9FY+rf9kkVNNP4+_;$@LPY|1bYh%*LU`l0P8!DY(#^{5{Zc@8oF^m zYU`yQ2L>pQhKEDp`}|n<Spv}Ur?yZuyJ?wVfAr*^KD^5>@YMr{UU>Wk0Kn6K^hi%q z<z2#BFZF)Mqu~Lp?)t~#PY>7?IIt6t@Sbt+j)-0%!D(1>0$F!gOq5`kT8e$kps)Rm z0Dw)^L7QN*3a{9oPxog2P#7gK92sv2pgB<a9oc|y&TMh0d~+$FVpB=Qf3ms?LJD9B z67pL{G{dB(C-Y3UK*)Tx{9jYGO4x`fNh8zk&^Dqf8f)R8uV<2ml5;_X!$)(|&UF4} zX=z+-XV&aITPqRQ{CRVkpFY3r6SXL?-n|^^qBt<kKLwLutjoqs4M`U9kd#~M4n0Hw z@bFW6NXn{D*pu!9KS$ivRc^eAytCj@GG9ZO8m)I08^(g>p$2bN;#-;5F|+ACdTdM4 z=WniE>>>ft>$GG!RxiJ^1BT(yGc8G2aPFm>mGiX|RBFj&c|TxA?n@*H=kXN6NFK2T zwA=D$T?Ped$!lUqrsD#^1^?G))$};|xES2E-4}oO*|-1w`~F+}Ayr!g0i<dCagRX> zS!cJy@N_ZaaOP#CDWHgp8|(s60T@kA+6A=A3&D|o_GBCcXj>G6r06?R#ZUiAX)(^m zBY?)gKfBxT^Uto7(vo-H(l`cu^aT)o;`nAi{WQDd4iD!O2;^l=?8Ni3y7^mqRhj<s zQJNSSe*DiL?fS~mLJBO~aT$RNYh&wbO4~Wz-b5S7PDUv=Hk6)aX6Gjd3;mYA({Em% zI^#xQSRw%caJkw%KHN9cGtW7Xl9+#W`pL94MQZ_oMp=SDvx~W$g=Q&BAx8P0lyxM% zf{|oq0igp~0<gT;noA)Y6OGMZtYkNIO*d5gjg!#Sp0jDH5f^8#mfO{Pc}$C=u~e=g z!gl4{_oF9!7Ou`WOXIKi>4B`65INah9tiRzvzPt~f(Ap^oSV_|Mj&1p<w;t&PJ(>k zEYD3ljneg$+lybFnu)>XU0ZV@!1EW14RhBJuRJ46tKit<jhllqPH^%S8F0%T<g3CQ z6}KCTw^#DTgTp=f%{{H!NWkCy@JjyS$??9aH)vY2i@<CNV#;;VnLU^6;m=hib@SXD z<EJM_<^w;xdvB&r6AnK-SQsv3q?=pUJ0AZ@rjh~cT(Sk}(ZNC=<evP)e_x#u1SSy? z8hRfD1R^?4KvXi$k6bkpQX>6VP@9ID^-my#RRF@AGWqW5tGBDOYW7hvSc;eZ(Vzdk z%IjbK&3F8*WE2V3s$=@gi(U@$<G^r!I}E@2?!D|vFk^BwNk}#VsM)x;(7OfCZiH%= zFUVa%VCP-hA^*&ak}@{>yK8wZ*LmSR@BPZ`z<kg{U*lwVM?tKUgFVRxy!j&BcRQS0 zBL`ENrrjx<m;awv0E)WysO3K0&CAZahuYT;!wyYp`$a~Z^HR-lN>qA|a8<O(-KlT| zIEu3B-9G_Ivl7B@)Mh_o=h;Qr>VBR?<*o%0x>hVNH}Xs;^ASmou?~!^SEwOKGox=A zLpK*&c_x$jXtEe7UCFXF(QTwedeww0)uS|!i>grX9h}U%RuBmgHrM4y_k9YX*}?>J zkdmUrX<c1tL8x+D8+(Inn(iH|rKe1vS`A1hwZY3^TzVp#q$UvTx{hB`#}{EV+}PuU z!k;)jVi)gLV3HM1=Np%GgkP!h6&d+m@8vYfbszw2%G8yHaS}WNel*}}mBafCv14<U zkYTm%i~<ywlH|(h*f}!__FTGkDD{*I&w@dRm3N<fyiXD{5QOZ@lUe0XP+(>GTOpz- zFsnw=Ap%)FEn#}?x=s)fM6zF*k~A`1f96zIXBB{t1;c765(xCuKl;fxfBS3u)~1?h zD-Ht2v&>PTe0h&+b@vb548wvYO&IUTvU#Epy_-YtIczF<%N_Qu+pH?wjwJp#qW6Rf z{D{8p+^rXidtm5*wDXt$;?p0`uy@5IoZbD+|LZFl>LZUN-D$;ImC>C};UmMaf3wVT z!WXk7<2kB-Zht=YV|@W3L{Zj4_>C4@g~v|oMf5bAAd{l_Dr}OH>#QA?NW^KZYb|K% z&P1hQ6iUe|0gR_9w@c|dF_}q?NouNA@o9;s^U)|%AG*HS)Scpx%7v|Q!JQwD&4jgG z7VE20>m(-%eaTXa<R{yvH8seGpB|dyf6g5AxS0=tie-sq_E`Sr>|ku|2iR@jEDJ6@ z;e@$wZ0z*l*}nN0Ck(^QOLIwQUcvq0m+$8LV`oKX75mLF6Mk1ZBT~XwST$wQ0W!X) zkPJuOhpAGzBhuH7Coo|N^BD!B%o@lz(l9<0bE)Y)oBC@vP_$gEh0Rb~-m*JU=t)4} z!$JVzRFEwUOF2n{wbJuID%F@s*F03D*${#yB)YB()e=@Yl!%_R&_@e}$y{&&!cYI` zCm?+D-+nF6aC4m#FkWP;E+{KM0e;h4owou=dN6$Q$^PZ(8bDR37898#i_X*o72O^F z?*vx<@>W+9X(trOaXZu^>_U^ffV|^2N)yjfr@IF`fOqw|9e%*u|9pD#PafP2zI)NW z-qp|km!B}eAP&HSSB*&c3kW?i2>>Fv8R`4o(szMjcn#lofMFwK--ltPX*HYjNyVOz zXuSR+IR>_6<t>-m11T3*%VS?0O%;_l!1d`mj+MHyGM3kA=g}n9iE><DY!n0%vT;(C zwbD;8Ydo1-Yg(&{6^5(p+|+hM9Usj0#wIlfLb<KGPDnWuB4pE%+@Ta<R|)O&E#pZm z+g$~#Mf2iUDp5a~rPDnHrETrzY?;FkUzFyn@{%Qur>t(u8Nxvj)H<5Yrs?4$TL<N> zvAlby*j6UlI~pgPpUhi|_1(0d1RxA_DhOto#r0}@e=hc<h=H}dqY5LuXc){Z53bCN z%P(b$=w^5?w}m`|X_m_GU2k&J88jb{eBE=x^(OBxg?VjQS`Trf69TSJzmk7VCYhPp zmg}vVG4`}hz^4z7%|3ti`kk?hRoX|8b_f9Q#ghl}N56f224Iq@PoC`0<*}NxGsTlM zQvz^Ob4vbB*LIN<XC-Us*LA{FdyEpCP!`lp7>4pBq~uK3n`LDv{3AC>gD0){CJ*>$ zfBd=Z5|;N-3hWT+B1U_wG2Pv!@!Q_4a`k8!ByQVIx>=vSlC=-fbq@0>+AX>9frr(P z>2_Jp_dh-KT{9cIFnka3#vwh)`-H%g&u80jm;JA7uJ2b`c=wm5a*sdxm(T7PL%U03 zSJ~NB(Hh*Y{_<Qen+Lj`ZiZo3X!1@l%x-p1Q@XdTVSjA;XT4R{Mh;xZCz+nU5Jn-$ z@|DtYGTzJN?<loD1%8qFAxS$5r9ld4wx5}Em!xQ&&5i(y64mdUjZ-sSt**8fq1&#^ zudTU4V6WtKkxAuWL8J;%L<E{2W{abVfqC9hlQMzHcQ3AZSL=is+zKHK=5fgjxIE9< zL1u2-`l>M6SY8&13t1eT%=RCuboctY;H{Ivkjf+aTqnIomBq?V*mYw(ifnDTb4XrH z{fZ(ZxJbaKu^F$t20T9)o71rTb0CO9vx?VBDX{i``t-xd+EE0N&CypZk75R)utZVQ zw_zZaT%Fwk7M2tD3x9<nK(6kiYgFTAqzu%H+ot1P)CwlpCCJf?L@TQ#KoC+81mqVK zwWp5It51!}kzV7N<aE~wxftCQcm8;x$2bkS?L@1ct=qOUU2tZUmU+#bFMfNQMB*e1 zqfm{vN1q%3c=N-B*6>tAD7pbp?<&o~=3Yl2!fRN;ZG&e(DSF3`8~NWIMbFVVl{e{{ zsRH{TERg?lIr@_$>{j_U(bxEkIe=(#<Se{*=fx+B^t*rmLb#LDY&^Q*Di~Zc%U)x$ zWKunRDYLCRPZ;N$|MPoJ(K6p1B`LQJ%qyp=y(vmgocr|TkQ*I-|L(nWUZa%5@WXwF zb!BWyJ<V2fo`3tNgV_|o#mZrjgwvBuyz%mE@#8TUV^1eWJk_jo1%&DdGLv9acLt1u zFbMS2Fh3ldFA`{Zu~AybM4}UQ)oS)~OhBPz=xH>GXM1Di_OmICeLeUk08RHsX6NO$ zPDYV@Z@Vfl-mY}`OOrjD6CRC|#<7&QF>ceeP1DHTd*SA>veXp-R*dgcxS_D6Ws#%u zF`6V?F^b<Z?mp!7*8&^XWyBW^ufBb6p9@Ec(HM5=+OWH<^Vs?1Octy*43<JRg<IjY z(-{PFMaYF;wqYD!9<IYyt{KnSk-#GG;p?hXv59E_hIzrr>(UWk#ha@Y>8l_Z(M*Wp zSz6z3ar0beG$(a)FM`0a6_raCvrLo;80{h<n!1%rH8QUm5XqryIFCXg3|0Mj*OrXK z560lO?%KxoIug(cJ3}^Q6OUq#18Sb=-#!e#diDI|(NlAiq>$Y8`P$5d5rFgS)s8(_ z5S*mRFbuM7Ta-ORtR9N?iXsp8=j`d{eyh$!^!8~a60>o7!x~`_efOr5o7#YPEJN~b z>BQ5*f!p2RW3VF|UaRKTAEd$ciJPJO*}r;buIR7+&zFQ|H$}^7Sn6jaoEgELH+QM8 z+R2U4$3#Cj=Uxi)hrFl(ff+o5;Bb1<ziH!7XXYRh<+E)mwT44jDqSZca%3E!n()+I zSy%1qLItwZy)i+|_A)(p2vZ01;>&zn=6Pj^%|<`VOjRmNM^tQU<8?@uA&#eC92v`_ z%Xcd-!N@62#fAxDFcwvsM!Xxi>%^6|?wRamyn~jPd--+9SB3lZ+5@P|#?+y?ycGQ2 z+>j4+-UYNX^zsDNOhe8P3<G^xariZ0uW;*Gs3~I6P>$LNzYVIu2@Z*B4Pk4v4h(b5 zRt|k$1hJzh$){*JZxH(O9!!8*n1Qq@%8e$a{^aokwWB>nQ-6D<2<pfC3jiCfylY;c zj8Y+NshRc4t7GWeE=oc(vV$~G6bgO6+NMp?ST~*_j>AT}@am_p>qHpdf_NW{!9*0r z#Dz5iQcGuf<Eo-2ARfi$M&G>&_&2e=ee)8)$;ngm%HnV;4kwp?^BzESKQhvtJ~kky zB!&{p<UOTE+6+UaTe#&$$>SfVcfAZki9GCc^u6t@uGSmbfHZg+ri=6r3oA9z&Bmjm zYVP!_j-j`mrM#N4|BV|dS}w=jm%-xa#(mRz`l5Xy4nAd&KOg!IlIp~BZHUA%V3Z`5 zGpIkEJR9>_tk_g_*{EI-%^bFAXMLUa9?s2*`1))ECV?b$%OeqzG^+C25Suj{3m{rv zSOfCI$GUBUh=AqA#?Y)xEm{6On<i!=TU~5<D{z{{@82xtyF8=oZAXu7x6kump7FPM z@EXOT$=nv(s$#X<35%XNBN}dp5)ZNgjG3Yq*NOC&*xPl%jv?Z$y22<A4_nrFwP6-; z4(Pf23`Ma+@s`gvzJ`F)x$bfsOjzl7kJztFGo@gvn=c$FO^$yi&t&!fSLUc^*~pys z)8l>q6?twi&o1Pjo;^6QJA0u1`||YMl!IoI%tRmS?N(l_%k{>C=o{u6KBx9Ste<S5 z?dU`h8l4%PS?ENRM4WmRMxi$QB9gXI7S$*WLq?MZD;VE`!MJ}qT4uJRB!KHX0)PVY za-wb93A&%U;%^Fu-@XL!@Zl51t`K<i=Z}FK?Fj9OeaJ5ksV-TUYx$-tSLxcjZysU% zhCgY3xl!DPVitOnm>(1F5&sUHRKNY_X7rWD*PZcE@s56{J(2l62Znb)an9rAAfpSz z{po7}%sKxQPH^A}aj<DYc&_9ehUI^9zmZx+GNUw>N?82zq|Y+w)RyTzkk=+1MdpIk z+5}Ke4YH6a-@JamF^K3XMerWkj7dfVH=^(P#`xVx^flT0O!B;hi@x@^=*OUMl0{}b zM{#KW>;czgG1|3rUT=n5yD_GCH*Zy0@0?s@Ws6161Vrx}YYxIp36&;^9v`~c>}jW= z$SZSpql?ZwEbZKytA|XTzb<Nnc>Ii-Z#VoYV`hI)umQmJ`|B{wYSy%E85awW<ZR2d z!rJ)}XHW_VZRta<0+y58;wdP-7xk=m0-$LBv+?Eka+j-ZvFoO6^AdofYq2?EtD9oi zrA%02dN9{YGObyj)>RWFA+h5~MzLu@l4s2r__kx)OjhCDI&6}0m|x#RCz6lku5J6P z5wG^#wqgf3-3h@y=*^wmyLYbu9PB+b(l-&q#*h7LI|PCKpAyI)-za+N=*VywzO!<p z`wjL7XAjDL^~RFD5Xi<Ukup@c6@57p?mFmv<3uWDr4$TGKIIWTI#}%bB@#_;KWtM3 zs_0wPyu0z~g9E)w=Tzl`bmrD0juum14%ikYQ|iRKt82c8NtX6A-m3jPNyLzn$+oIT zNi2j@2pfGeC8)+BNS;NY4puUX%`$+9%upVUQv%vXUFW)Lk}Q^UU9onIGJ_y6yq;{5 zRC#4)knN^4Ge|m$mWrlCM2;zJT{XNv<LQ^j=C2oTSH>mR_E18}U2z!-rhrKE!?E!> z0FY*O_TqsifPLoB@b38~CmD^W7J%2+Irm*C8DWY7E1wC{UPb_1+XDdE)b2sJljLX+ zww+=vGY4@J&Tf{=7YeYi8;YR6M(2DbN9$2gzt?D}wUH|U2rKaD1_B=ELc_3PW-)y^ z4~ES{?!Yh%oeG{`5V;gBqp{DZir{Tf;>L;Z);X~+o*?<d1O#c+>W7Yit`$)d5T6}b zS%e5p)h1cYVttIpiDfF>Id01qaeiIj@x!A@!kgmck92M&ixbJBkN~vZkJW<yh}*^0 zJ6tIkj_z`^#64qR7TsAl4G)Irf4DDqTI~2HJQp9gfn9hX-_`KbGvV>jcR(bCM+d^e z=&)J}065xpz=OLHJtlU3i!zJVd!_+2-*Lr#60<KXFz|f3IbtiT>3yCx6!q6YewKWf zQl@($gcLccYEPD10O5SqHs*Pb0mPc_)U}rOCfC~LP{TM>D#T<zF9%@Tw2|tgrO{Ng zx5!E<5n~6<Q%Q}b?Yb15&e9P`={bWyb=5?1Wb+C_y!rk@tuw}nZJl(v5Qh&P)wYY% zmEk}M;n?B|Ap)lH#4&rbs#aI(i5bt5kahG<=A))*Oa_n>tghd$c{!Qal2?~o)B6M{ zJrlLVeJ7qa9BBaMwszF*g$oVBg+75^kFM}DEW3zB+7@@9HY^0ka`(rK@Dy&z_n6=4 zDQN71Ve{C)$?DnVrf@0C#4JPviJo7O^(bPE(dsLmSw@S_KC3R++%l1fTY1x3aYg=6 zN|i||fkZ2UI3VVIN1&!@P4{TNF3D}Q10e`V3|As<!e9V*f#IfZ)ngk3{QN8C8qx^? z_XvU@c>Kw;SI=ME1HC@*{rkaigx|_`FR`sY5&+gfDZlmb_x=k4mk1;vWXL$V!y!x- zsq8osL-=~vvllxFP5n>1>NlRc$&L8CqY2EF0uaPkL_NmTP{We53fl$4UUQO5WObGy zCkK0GrZU^~vnjAuSs6l8x21+97Uu~Nk|b74-2fvi*hC;#%9wOZl9U%{yY*#GHV(FV zXWsTogz<bdPnD#G?2a`-PLf7iffBOI#mqap1w!qm+*anYZdS$1Z|$mUJaZ_}{337( zWx&bDOcx^#tDL%37EM*G%}wEn?t_#0!HG?7U%p*(Hg&{=qZ2pO=3HnY1ZR!$J)FN? znqk9C>fFKUIFYi!Ow=cKc#pxrGw1N2286Zvm~_7(yFdIxaDTvZwoeZC%r4B=R+|^{ z#blJ4b=EpB%yRS9`%6U>9gj=`<a(?6$R}C8gK?_X04v>dEOgH?tMv#Wun{k4FNl&5 zMAxO#^p}2F1f+{ZrnbT;0HFrfSB3nQ#bE}bs1D`O-KVkqu1SYX<|6>3X(D+51ROnH z0CfIt2_4|dP9*c>CYo|wY%1BRRpkxH=~ll749}x{c}r$7WQ;1Fj+Sf3#v~^7JDh>_ z*-t-f>h|RiFYxzfiw+ml{;Nmci)7h!W@bLW_Vq_Ud3fl(LgfGP2i?|k7o#evUkV`J z|4je3N=0riz5{4{9|V-!wyH?n)iiKE8DDR<*uiri7(hKzn3*zGc@aku?jnG>L+|tM zz1h@*(Lq`HK^X4grfszl47>+n*wH+|K;ao;_-q7_J)3l`00aV(NFW892&gL^Yz2yo z)CpBb%ti?xU(1WFi9C~01flb{1PHs>l!iYhNZu|B-Z|PfZK-vPM_Hmh2eniXlQ7sU z3)0<DvcbSe7F0zeyEQ-*gp`hBbM==OTka~)*;OXGHL%Cw@cO;YQ7?|i*=%4;5~$4U zj)kY(9QW#-^UThVob@MPyJUuv2EZpgyZjnfxD3uJb6rQrUzm>+KYVK-Cvg{dWmKDc z5i;6gcvkyZOn~cDkzLsiE9J8bfKY$8Hixl48}o@vEH@VZuB}~)G28|4ez}HHf)r%h zNNtH%5bM^pl2z=n5surDmVzUGSIMYok>xm}S8sL-#qyDC>IR@742VP+1x?io5@8g? zqsU0g0BBoLm$ei(RZVe4W8`S$JbG|4mxEgRlr(i4MIi(x^O0-_F7vvonsgM6vc!nZ z5kM43MqaV4<!UmD!!oZ42;*QhP6XZ6V)X+s*lbd4m5;_KjvBW(*wih@;3y71`{`%j zfAjs{7XW6o(*ci!yWv#tV>IxJl|ClZw~3v<Xa=zGT8V|B>E6*oNc8l#^yDN++#@vq z;Xk}$6C*(u9qG2~A;fxH2#$NeEwQk0r1Cys69PW(Q|Gkd2+Zz)VJ~Ip3U=(2?{EX4 zT`C-4@wz;&@KM6YP0AXLYKQ0q)!U%o&8CSNvdfDcumCAFX~Fwb^n5U$rabgmuL|2s z3^Yw^CXRG$_fK%pR|1mBSROyy6S5sbqpz9ftk8r2faT@ZnQmD4yK-Y+v0I~kaqO%- zIonyd<Ne@dddD%-H$f6&cm}A;rca({BbN=O-Yh&Icq-hUoE@~oUd`BjJ_Ziep-{uC zMtLKgTn{3PfvmHM!LTQbL5>PK;QDL>j<csL-(i!xVzAx}INI7E5}59fb%z^>D4jrh za1kL0NiGvtSA{&Dz2gZHZKdsm5Ov+ju|8d7MA$5grf!v5RNVq-s@903z4`UI0*NFn zwzZZPr*ss7kY>qbZ$!GE3xsTz=9^0XEsVn3r>-3-y=)!<*agGer4^Pj{ExZTeKTNe zq-@LsczL=4FkNH-KK<g;rs`h3cyVux`{)2Xzzd@O3wI<u?ZjVKmi=CO;<hzDdvtB~ zK6<owM<^<6ZNR13-Z2!_A3FMjqoYT&_iq$O>G%(iZoeA$QJwD3H4paZ=6s2e@1~)q zaqP*0M04YhL?gUr6P`A<VpAja>NRGP+7=~mr^rSLpHjV!?QLO^VC$+qXKCtMuK_^t z$Z^lrJ-%wEEKDRQbvO0dvTP(`DH`WuG}{{)#4U9EO0EnAq*E+I-_5!(x;@fm#hHf5 zlB2il(p<4H4$X%N$T#KLiz{gQCAZ)4Ix!Z9lR0BNc_!gfvQAyDEa8WJ?J6_#PNBvX zs*IB$8QJyz`noXpYwJd_M^Bw6sAGY0Q+Hf$`s61EoQ?JFhf8zQ&t6^yq2@ge)LhkK zZKw;8HO2L<(00SH$Jt_pd|OE27~RiO?|@;yX-){dIlq!)N(wrXdVHjrn0`^$nhk2N ztaFSFY)=mN7+YEmthLTd>r3R<n_rzNPTYKI;&^O|B8&ogsH15DP@II)drH$4F&f8B z)tWWqWIigkwaiP)F<Ityl13mAhCx--^1P*wa<MLD-sr*8J(+wKLX35Dxx58(xmM;? z6e+&NWG@4dB$1?I)K&W<^{4*$pa1^f{QF-F!1FBi8m!7qdA2D5gh?phn(b%FC|ql$ zLU|<P*{IBGS<DgwVHAG;^Uv$De)0Y9G9w+`fE-?7<sJ|+AW(JB&L4s1+imp4SbH{I z-JH<a#l|YMe_zj#;!dX#eVQG@aTq*$H2a_{0b`2cOU4<=Kr3viCJo1zmu@;}(VMay z*2<vKf@7quJ{}Nm=(iN;N5i`*TK<Lb?|=6wju}nKly)e9DM87%!z3ami9FfM(uqoB z66oUH>RR)M_l_n|)GZ>?2&d0k6;N3Yd2ck42fw~9YZ(dvfUO)uJ2aTLnx+M7h<y6x zg9Ea?kEhQs`AKr8zc`KR(t@1F{+sS)=8Uh-)+^XR*^?1CcrbGu0J(pWTg2rAX|VE` zydD>Cm%F~m4e9}$KEE`7o-8tHEoA_>9|FUZnG(B+1uALcN|4_I!~NV>PutXqsvXkx zkQWmOqGN%npVWa6OgG9<v>bIRj`vRU$6z!ps8jMCgTj-xS63eikFaM4V?dO7Lxj3) zDrM3obK@|YZb=pqQCZfK7&xA$Wmyv_B2~h#tEO!``6wr82%@s6rBr9rRI*QR|9EBw zgIO=iEHr@qhjUrM0Z?q~a#PAX)pbJ9ohHQ_wtQXw{y+H=z%Tyu*WP4jk3_D~iHu#Q zoH~k4z10i}!(j}gkcc+R(zF<iXQMQWfBzr-{1^Y_tKSH^-r+=}8^22T+0|V>wez-A z-)vm*Ec&R|!41BCT(;r;o7K^yJCv|R&p`pG8mXd&wGCo+ow0txd3W?}zvYunO|~8` z4|Au((g2yu>jcIPFw6$Q4PgB2pFNguNLAU((<LCfN*KhIv`o@=LyG>Ri(4yg(3@rn z2+A%Hpn$rzGc#wYCJtSa%%Xf<%9%XhFmr3dcs`2az<e?pMcFhpwd8zLSqaQ6c7VAN z>uaOJPi@_*UP%B%by2siH9q2+j?+aJCpO-F|8`k2@knkXIC04=ZPUtfoj%l<8zu2Z zCb(3urfv;0i$Go5#SGWE+%#M<tS}5X)#a4=5PRcK0FRFL%&1;(-<Z=lP_O&mx*+`B z_pkKjq$dyd4c2Oh-5#6#D)-&j<QiSojER)buBHrco|{Co&~CdPAH^TBLrPX=$g^a) za0@d=Ud!ODC*}qIcZKWZw_<S^W`}2wDPNU>FdD})5uIkSq{eiuP_^E?CXjM8Qj~RB z%Auxd<u9gLES0gNIFK2zd|k=*-%*yp?OW52lF@voIE{p?$LkzVHcQh{Bn`8T9QWy~ z51(esyhc%Hll1rg<fp&<t8X|ko5w_%ourW*`GzMrS&USVvR;D9<-1gaZ|Y9+OSY>* z4)w>+o;Fo``t}We>sz!fN{@#{!29LKn>|OiKS7;jJU{XFwJFxS0N3ow_;_6X_e-AA zVUHS)_GW#<A}c=Nl#XxLtM<)*1pt(FEd<ge?zbo01^M4ALvmqOdbHbVLjH6dg|$Rq z!O^$>X;<AsACeGCeRhY=kdx(eykUelxmYCTA}Ma81sv8Y?SR!D40DRs4ofS1@;^Mb zJ%vP<rz_Sh>ny?K(v_bs|Fa?w>&ve|i$FlJZPdpDi<$=AHK3A*aHP?fA49RNjFd;3 z#mtutZPVG(F;oeSqc3(0-c?^z`3q3_LGGIBa`xs|VnzWpbHFG6SgW4?60I@{cR z`jBdkT4`0dc^9iw(HZa&YQ{D_vJS@d*voJipkgqa?Ye>p3xd4=NBygVwh8f~VNY(_ z?eS%lZQJ`KxUB-$kJG={v15~MsKlPAzFJ%#hRs8yCmJCD*%M!vZC%OoEk=`AK0Q?- z2chUhCmoGs)+dbOWE9DSbiu~I%n~)yJ1C$y3PI>P;mO6MS+cL2=w5&O9zfevCTkMJ zA!G!cSKc!<pf`Ev?h%;=Z|gRQf}j86FTVQgZ}q{%hnm&@;_EX2b=8`Kk?Ep*RTkS? zgRy!LwkvgbUDwr>I?gl;pjFKe9?pLGH^2IA1Mm(Y_|281`~9ju0&#xUNBJ?c=QN4R zs$ulfJDp}WPV#N_fj@29ImCUE@WM&r-SDM+Q+OAx$F=ki$v)>jPK)rHpnMp1o#6&x z*t?H>Qp<ia9RbUW+<r7bpuC9?n|>GqdVaKvqp87H0A16WU(+I4nmIL!qSz?gQZ|YC zMX1U~H4Dj4gpO@qzA3kxQl853<2i^@UC=#!aaC<9^DDE1F@t<sUpa1c<M}9b+HkEH z(*w8iny<<k!{f@;2@gZ!9A@4t3|Z>78y&Dd-R-jAUkrkPbFJI9<1_4qON~DHbf5o~ zdlV88Up<_?zT%^5QO6<^#KrD>B_}gZY0zAhn<)5V(FTUajT9|c!x?@$*iR_2<c&SV zahk||on0+4C}<Bsgm)L$aNtyrjcf!P0;?LhY3P8XP^n&fe6TR1l-TZG;!<9aS!O8? z*THtW7|E#j`u!G!x@>3r84-=fD7Tf2Xsfc3lz2H%>$2HDo`NXZkIvsN<@HI&F@cg% zAPLNM(@y6jiPL7V$rSY4@6RQDVR1AuGU>X#-daRU)4g(A?;THeV({HI$t;`hXYx{h z`Ny9F`1)_YD>jvM{+Jz1<g{R7Vk22&e*N_Ml@wRse>jzE5fl8B+d5xYfCvI*S$6n% zkxoJY<>tf9nm!1C2RK*vf*2+l|I-P8@|(@wzDu|7`<|Q8xbPH+(<Fk!VZ7g#jg$MD z4+4n8$caGjwzO#`1RxzJTNn>{+OA8)$T#I+s9jD4V2#;@KuzZ+HcuaCTxxN%=9h?! zjfuP=QIy)2V3)`mC1C?w?@Y6ZBmDLG7E>#WbGVq<y>b~T1*j8{q74JMdcUbF#jS0t z77if`1S;05V<c2M8BC5t^FaZ`Nyw}2X%=-%>Cjm0Df#HSLv5~@fRUCZ5aImY+FX<A zUbZ-%nlGNcygGk<Z4Pg`$Ycgvp3U-N!!(o0tEc|3F8HwLA{ziW5zLeO(ejGwesG6A z`IR@nzA!I@OveM<gHH!N{6~{fWbX0x`|Wps`^M~ctg7bfN8}fGkZX)(rj~p%2OxYm z1uJnSd^J<%xHsh4z{GTJf?@V6aF_go{b5K2gcpp3EBfInUiE+1tXBnjLLTrOveB2R zv3-Dc(PF7=oQ&PIVtJX5#xW7HSt8ZZ^L5$OoqQgH03ZqiS{zQ~E3!TB>U^!L2}E%c zN<-iAG$BwnPK4(9D^fk#Zf~iu*3?}xjsZ;evdwi4Y4t$_;QZZcG8;jN*<L2sg_~t* zM*fFk@Zx9!-KQX*@Vcx&`SPg{Lbee$RU;pY>E394Rmeq#91!ncUCYl*_cGb#yt>Q{ zuTZW&gMbcBX7WB>o-P5Lzfmiy-zE%4gO8H9LwC;6Py1*&*@dHm20@$i7j}U2jXCCG zcVH?{p(rbW7Sjw|uIJ7uF9sIqh(~ww*5K%Sqk))zhEf#5^qy{3B@LKJIh$-gFh@*U ziY?JTtfU?BTroLEGG47`tw5f#_LP6sVmAO_^ylRNc!VcFGwCF+fl<|;+~>;7zv{aH z0*k(Wtf2ojfWGWjIg*VkV+;>{E%Z8*vf#f){5J^G#R$Smipe#;xo?v_r=t1d>(lw+ z#Er(_)e?QNl3q&>nUOkZNFtao9(mr){OPeFn6oP}Xn(*&(-<^$&d#YP1rENf0fcrh z0D)F{Zq98w9+?BX-sJqQ&c`D+gRBxa@?);8oI4E&EG8Lz0yTkf{q9%R24gaohbw=6 zwceT!E~aC%Ywmdex6faDWXXO~ny@PwF2t~y<xMcml3flA8_g{%MJYtnv>@bbwTPK4 zQoWL{<s&U|ND$h#laH{_<}9<lv0QK~tRkw5CY>a*oLsCc$&_yDmOyb5O%D`PVSTX$ zP*;s~0!_z>Rg4h;a8<0$vQP5)vuX1FOwCA17F7BD#2|xEwi;6ug-z7}B1)q9{`jl^ z`m3Km{8F|ZRz)Lc%QTBsgSZy|lIvHq^jsW{<?2@I{z~mR`7G}rPv`p+09R6X)}%|v zVfkU6iQ*ogiSCgT6#y{$>GVz?_7Fl0AHXhs=)tp)WLN$;E)MT3#UVcADmj3fM)|hN z#>xHef-CybjY&bx&?cQ<i*+TR(a|^-KsHGv&UtpQ{&)=x>JbQa(aL(Ke4Iz)1Ok~P z4-?v2aI2FbwBo5mD7G~P;5lZJ>|X+a`Tp3#3W<DG$zr5g07xkuxvw}5c^15Fy32QK zFisQ0b!wY7NF%!huriTK%(-ioaIefJDSEKB4wTk=roz`$D$rjXPY8$+8m3v2*#TGN zwa$kVfWwm+U+tW}yxy!z^Wm-&BbHkZ!a(RKOAuavch2v=(<<Yr96F|v{U#ZK0krPP zDZ6c~{3#>!#h2Z_Y|-Pyo4xkI*|Sj@`kSsQ3%}D)_z2!>|KZ2x*;!(!Z`k$bG8I!c znF!~~c}L(Cz=j>~^<TzH=7o;;=4>UPErTv?@&06gVXpT|xw7I^e}I6WK6%KOb@D!Z z{qmif*|O9em%dFPAUXcI{J`q$E3+b8JXU?c+jU7AY2+TerUfAg11Zp!Zz@TOij%0= zRx$`acsQ4uR@-$ce`|fIszMJw*_RMbL}xFqK-ga8rj>4{^URX&us9f-fojy;WSe`w zsru7vk_GpgZ<p`oL_sH??8^)C?#0#eY75}2|N1q6hfkjD>G{8@JKf+XG<@nqI^O`; zuDs4Y5d;dJ*Vj3z{Fxt)rsEJmx%~}>!qH6)|3i4i8h(bFjqbHNpnhuBc}TB0tCM_m zcQo(r#1VF?lh6L_(ewX!+CM5msLJ;IZ_i2K@E;s{g|}WYm{}9}7sF{g4iA!kYkFM| zbjt}Kib8E_OCYD@Ie68L>pKCm1t6S+#@!QyPHB--Hc3E4Ds02{x)czGB-yqdF^$H_ zJmq!*lGjjdl}$~WMXd_5r3G(it5;+@TjUPPZOxBa7CU8Q3;`7K<pU@n-VjU>Hi;@% z=uK<K06}R^DNy7R(TJ0<V=7ls91s)N2m_kTQ}g-j^X<DIuJr1Gtt8~55<7`pQ_Yn- z{O|wYAM_$ifO>k2;JW-A16*(%T$XYXPe;Jf@gQJu#|ZDRu_}W(2Y>t+y~pS^JMY|> zT$tP_#Joy6(FmuvjkD`{-4}gky@}KZ#5;Dwu)Q8bh70Jk5q86{?kVcP;(ps))JX!g zO&belXGpAL!LC^0C~&Imx=%n8mQT&yC3L*&6|?2OR+qVQ|Af+;Bw%_lmdBE>WtEEJ zROvH^Q2-$kw*b-RI&T|Q+lrG&5*W*(2I18=XQOc{vnP|iktt8fmY#fFCTS!ud9Eo= z(|HP@shaC^HCL;CLLv4ZOkY3uaX6iXcTDY4NV0tU{8y*xB#}qLn*!dwdKD+1=y^uu zYt{WPKT{Qr>7Hj#uGl|TY_gS>#8H_ufiMaO!?L^DCf+CTHGhf#aQy^1Fc0TbK9&h| zu1#|8BJo)iz0B}#mhd=Dy*!f9a0qZ`yWhK>yDtkZjceXMzqtP9S^%H^v&ZJWvaVrh zu^;w}0sx|;#9V`){iCM<-aNm&;ahQHT+$RG(rwIG`2o?1WRkjf(lQjXiS@fBU?Z1= z8jrfR6Z)wp(mY18z6Hg$;$UnvXiV@*OwNN}G$It+h7W+cs);3+DJ1SJ<e@LzfyjDW zz5Mhr`m)awvo28R%aP~$e9IL^?uEYp<uAUC)5tWu(hdysnq$=vWD&7dc|(sz&V*J( zKL8#8Cx$vMj`nlge!Qq**f}1bo98}P!Z~Q+Lb+2Lc463$XbrDe4EGHWM(!RAI~@W2 zo`OLbW>}|))J!9Uuapc7b2lWZ*=N$pcBREvJ<PArz_41H^oVIfX!QaijSr1_9lA~g zff^2R63Lv_c3GH`kbDsW5;%#JW?!5{UE6^u41=yy>GJ6!1!%k&tuD3znz~VO;Z<I! z{24*YU&u)yAo-w8H5Q)h4m$Z(Q@4{@ik=<yeKB}C&!+QCf@oW{VHgM!t1G9`?&Yta zKYIF9{;vGDapb&sqtg#zAbX8uU%=Yv&gwn_A*8<PE%^DtY_glTXa`a`e4+btk_X~a zH*kCOXD4s|<J;b|<viv)eSAK^(n0@1RW%R(SQUG!vU&8!2l=LwwE^{kvXS6X)ph^a z-9G!_lNMI;6@U0|KL3DQB3X+%ud6P~c3F6f7<nwOzC8yp*&BJYuKA0k`2=B*Z%Qiz zs}<Vh6FX6cxN4%RtHv0$s5?VsoCd-u<ol7VLK9ZXpw`spy{wKrH6u^Kod7_(?+A`n z5r_GFZ66*0sd7+Ia9{+S&2MpEmnaS?x7Ws`ujMz|ri&s=<`SJyc6&r1xy-j2j*HXv zyXTkYoR=3HF8FByLB+#N1ym9U7|vInL(vM2!8jp0b>0%6#T>h&+NF6Q<_BYrist$& zZ-yvfrhsVchK&)@*O^~)(#xHYKX9c<*K0r{Vygk2iIvCr=E5v>tT+_)n*EcbFU`-b z-&@Ir8LJIHJ=%j~aj*XM^8KY5d(V#d&5oZQADCl)adyFJ`tz}QQfRf!&7HYet=TUa zB}mn*XW3!e%8A_Cu(69F!Tf*$Xm?@Ll*M6Km^Fn<Ok=AFLnSk`aLOi$VbV2CtCcrw z3aY7;F~j^|qG%kdOhXcV0fdn%=;Z6FDwT5T@zZ^|hpYE%A{x&}icLZ^V*Z#{=UX`# z9z0n9c<^*#R{52d_z1(B63%zQU{#R?9z0XD{L9mIf6jgV@+E*Te(!S$)#bK2e!2(X z`01X};%Lf7{@X+{5|ZnxRsEd+fW70{_4QdFa5x47sPc9gnC^mzy-!CseSz-t8@soY zKRaPF=`GCX9t{7e?dhLBb|>+HP0KO}J%;YI%vtOYl%KDe((fPq>(4*zm`#7DO5Wxb z0295Py}TwXsg86U?^<cf%^DAA3^T<8B5K->q|zbx8_=_3HchNqn!YkbDknc#jEHEq zpBaGc+72vfv2_n@cHmsG)y0-Ggy)Bu)6BsGYEt<k6NYLFTc-T%OzZUK*XNx26(v!_ z#3klO6B}@=l)D`q_Bq#3y}ByQ<Q#;g<v554Z@xc|B5RA*wVj_{bw{;;%MbR1nONy| z$k$3u_ZsfG(o~P(<440TEr{ET@z~lPJDHL&Pwje2knU3|`+tmMp6CVVZWECA3$7BD z6F&MD_uxT+rmR`9DsJ#4oPeG@+XG%bH@}b<6}t-pz`87*kqH1eUd+vML>Xht!p$g^ zhm`C;CA}hF=GX2B1p(8M$}_#WxHf#VlY_Z|;p*%w`Qg>JFjsN$*}i;EuikHn(01); zoPZF=kqP5X6G5)q>SUJzfnp^xLqUir4nY`=ldJPJfOkKf?>(GLjzwc-*a?KD>Wrms zHc5mMHqQ?pOy%?V_W6|p*HI{M2j|{@00zgSST5h?5`R2N76)Shub&Tm_}gE8x3@Sf z^9I277jN~tLAry3$d-ilqMTB#nNyXjo%-z$7k8SUv(U%jAF)LOA9=g{+lxnkcJkrh z|3K%$AGKxE^ptsMBx!gr{J(Y;_J8DNqF&jZ_IrQ&iMb%pe|4r7aYUq<1r*$}JNYlw z8)K4>T_*@MguC(wvYBI@t7((!&P?W+Aq?x_)e^h5O9y)AE>~`O?q9C?!I*l-?4hsu z>uhh#Kf}?NfY-miAQwKpge6B`^s?4{^yP<RofSYtc>Dc1AGbje0PXNFc1`!-P_%s4 ziat@FHMGL(nc?{uM(uLD!Y!`){skmlX0t0>;e)0aS{e(?%cMbPJnC&db2vxd>%}!1 zQ~hoqICfed4EwF`W=9-`g}0^`J#|P!hBNCM0nn5G@$t)l|Jp>Y1fQsEV^W9q#p>Wv zrGyoG`Q;E^EB;_K47M=Q*KNBh<kLD`sGeO(S_UBqq;MORMV*Zk5JhoVm9@-sq*<bt zXL@<GzRu+rqbQWjkIhvc#(`aB5D4_}*`Ay$e*L#LZ7DOl=Wkb%K@tSI!2wub<^a0( z7E_~}F}N-osR%2&4#4JWdvK%v;MMhcmdpVNmj5@r{a!PIU=JF1-?-D3WJ96whXL>n zAjl@Y0W^}YT>kgV55d>n@J2Vk&9=jBTptX|V|~y8nfoCG1opn%yZric@F--5xPjim zQ1~7{-y>Ch_6H{ery|SAkpewwgs0>bZan3>s*^MZVKU1=nCmd~?3Gz`b4foU^=R3m ztjthFiQ+R$I+dh5k}eMUkJi|VG;Nl}1ru}FJDPGaVcE=JG!*$44Sh(ZtfhKo7${nt zT)pNszXEX*NsR(|m720~pDOCQZgsISp^T!r>C2s_u@RStG+$z0*Xdcc-g*1OxtbK^ z;~OelIfqEp^~Tx&Ma!i`8$=Momo^zN0^($14l)?9pm#Z1J%KYp!f{kkq8G#`f9Dud zn&x8V?1Z(`^ssywh6QsW5IdA0%_a3oOv3Kpgti_GdrWD5P~3G)CXtCyex5x2{7LWe z^x|(FF54bmmbd5xECtS%j{QC8_}_}+u*+<K*cl510NZsbM`=|ws*pq!r;$8>{i7+E zR}u)>BsGF=L8M~C>-TF3vImbB#*bukl>-o+sH;Xke)Ih?2-oMEx@rkDKNx3|*o-Er z0v#k_zNrD6zgfw`4F$y2OmCQZlSx?Zz~Cqjo3;f&L9ll?1t2;#UF-sfyjlXtlDTVg zWilkhy9can-w?0=9x(jl3d8qi7~LCjKL`&8G38(rbAw^=8~9zm?f>k+!`-TArafce zj~o8pylvK{bkm#6M|WIm$U05`irNY*V_L}vSBX4m?`76EjQQcjtQCmp^u?8t#X(R0 zQ1T)7j&0vsnO9{|@noJMa{;J}hEtzpY-;8mX4$L$Yvr7@m4uRsCjzklU}io~K;s%S z0JL2dJbE@>_sVcdo2SaHZ8|Mt&^hwI00e?CfY+8|OL~r|@NSBh2ftpj+G{B7i+DS! zU61VL5Sm<hM(m1f;f0>=)9Lre3lmjAhkCvQ)eacu7YjQCnFXx#t_Q=6cqOAp@?hAb zXgNyFKIz(*=t)y$7s8X$qcoK#xGD;BgN_$d^ZcA@zG{Rsb2eO=h>r)!lAeyN+tPYl zm_vGexGz8S_|RUmUyEzg8bn0KuUdw%RnbUFGXdFjB(qjkS(_7;M!%y;l1@?rx~5%U zsW><tCzAIZC6TmOS}%*yIFU1fjHK&IS5k!l@bD8gNxu8xLV~xPSkh56S!Abo5LZqn z;o<(to0qTp6I2)lCV3{;{Wl1#au}Y^4<$iCKC?Vlv6j`J#Bz{G*JO1w?$5aWk>sps zTeT#d?+;Gwqa^lTDJq}pe1l&edsx-bG1Tkv$nUH@nk&B-TB`%v<`sYql}>h&klyEl z-O@HC@bC|ga!t55kPy2p==F7R=O}wvDLUVjgFLRg=yOe2L07N}&F<yIU>U!sg-0w4 zZ9Mn_=VNo#=b&CceR<`M74n{q$hG2;m25N9^{D`r>oV(*IE3m#w)x*M@RSfJ;4%C# z`m#hWZB~WagPc{Tskjk+`L!j1H{V}s(Pq(!j$>6_wyeh*@p;2XK=^6O?}I%s!0R`I zo2-@-khvYBODDK)=N*?1;f>vZoMP<dNLepC0rj^V=v|j{XPB^68W9k`tNAUj7jY+p z{7!`yZ>2h;QH9ZA+sWRXvp=}n;&Ss6R){+_r?@T(1H-S*ulE1sP=2@h#l~FS)yB%2 zUX4af&&`6H`*_iEYYH)nkYxkf{*%-}6P^XQ<Tbo#*eq;%(J*+kw{YcLT_Y2<sv&Oe zVAfTN$R_}hTp!E!4XH^kk384bKqM(6MB8;SnT-fEo{jQ#Y3fb#_o{8Bl6ge)W2s3Z z@=c{8XJvIjRoTdLX*!C_q86P@@{++_*=rCdVWxS}#ikTYlyGoja^{LOdiKSqFTVYO zzgX7|fb+M@PRr(qK>_2TA6Q<W&*z7BO(@7pnHa4zPZ0(5!K9;``jl?dJiagDi{EB> z)>n$N20tI?7?L!+I#;$65C34;-?uKBANec!w)|L^Ov<m1#<3^Y)U@|rf{9KT_(?NW z?v>BgdYPN)OSPz{k!h-vznoZe4zx{6gi1@X%lVxNB>C5nLMMAs_T<cDp4?2>>+2#2 zZ2fuUSP~J8f}@_imls=UzAgXSwt~;ZW<_NrhmtIAjZ&u4C9rpF|G|`F5`bU-*Ec4V zZJSOj;tBxavc=2^R{ho&o$7SPw9zp1l(+lOuHca1JP5n}C<nzahAPTp_YbS=x?8Un z0uYNlY8fy&a7U)S$|XiQYKxAFBUsJTi-y&N_4||N7aMju_NW~(jbTk`^|uHA{2_qy zudczPbKwljul|qk_GdF_ni{JtvkPph(aujhI_&+Tg4JIeu=Vu(EbN&W7|tfDZ&UUZ z5zuJ;IGL&?tH48LUYA8}{0e1U7=(cV<0MO@lub5GNnkup%R<$RtD=!trYve@Jp!cC zsf@^|sOn|}bvyu)EZJV?cb|)zsugW_^7!%F*RR>+9GmBQvn=jAzb%*N07l8&UR5E8 zUur{b_bTllj3ysc7>;%*LH@X-`S6w@z>#savl#Vfp`LaC28zM<tCCuUy9<Zt$G%_a zH7x{#XL|8^iJr&mkGYCw_lnNPRNFUKIRbJ^r@QvyyhtDf%9V^=7O}Z5xQ4Sw$?jjf zw&}R0zQsZbu6a!k$;os35k>B_2+tW)TJCehQw{>7v4g(4B4x#cuFrGBAHi<)HRqCy zVv8w+^~F~A)&PJpfiXM$_P@Li0v*+8!A3c`Hq232TU&UHCmuuj4mbk67j`{AqW2)M zG%^V>Sl428F~Qqld%(+1SPV4-TEt{Nd-iyknzMo7p41}Qa8a;kS!Vvx@m0gXgDE(t zOmOuJ2ZlM_h6oS-r$^o#M?K!zFaP)N><^Jul-B)Z!e8g;a<ULCv~scEUTnUExebOp zSH45eZ_*sl=+(&luv`UhR)s2UO0F`IY}q%OvaPl(G(EmT!4l;wZHdh~nnu#=5EQ0i z6o(SEw>p>}PZI!DUaOpn(8($w9VeSRW3Ul4TpWM-)!%$=E=9hsjI6rs=D5>b$+n_e z#=#Ul8FRrr7L%*itmTUbKW>^H;7H$sq|tp&=Yt^?A8_sLx`aH9AoFzGa&A@G{CE^J z7<|LK?_OL+QQ&sbe9S9UY)V5xYIK2COVE+A<h<8b*UiZ%2Vip0SLd4mkWx52iO2o; z_#R}tp%J^#DQMy!P?`Y4*p2J6O~~+gaqMV`OR`lqP0WHot}|G|mJI<ZNPDr7lN1@a zjcp>msT$TstR%D~-vopJ2$N{CKi21s^=0n09$vg%GW8;u#tdjRG0o-y4GnG=Ro#O( zA&(yI13DaVO9}%P1wNzKxg*RGsBcH)E)6^l%V8Mipvw#nJp%=ev3-6rYZG!cD_9n` zuWrR)-dk4$zdvn%x#_{M-G%VQ$#fJBkU;z82tfEvu{V`O2ijH@OO~s{+El7c5Qvry zY*P^unW`MClAQd}Z7KC-@%hP-DV2Qp=1h*2X_^=qesHibPu_~vgUx+O7SZBByZyYn zQgtE5&kth)P!@GnD6#Zxno2^4lCiUrdDPZzHXF&iHPf_e0=Ao4t&)@)2$`swh~hW^ zQC+oC9-yh()m3h;ucTARyxLv1d~I`JfAFWj_jiB!OK4@;B#j?@vS;4CI$Pg+qU+WG zGLh=Fr%wKx<~!l6fPefJXCZ+4ZlUmxa6|e?Bq(v~FAw{~_u;n1J!LWPwH-a0Ya3t~ zD%R=C%P0zsw>epHiyw`+Lz^sgN>M5z+68PkY^CmUe)Q>q$zxx=-@sKm;O9VuB#XUM zYO9VXQf1E)d$;v(lY5lcvdf;m#<^N>y@2F4nmF*^HO}*LeZGNvJz^=(sRvBsIQ=Q~ zWq(7cRY45;dIxa%cIj7ibd{-Lj-(b6hlWAlivgbBg6loYX;*%uuS?P5EGDnhSHMeE z`w?>QfirpXn<ghA@K}tOD1?4OvotYRd|OoJUc9|nntL-DrLY4Ho4hiAo@A*LUYj=D zyjcCa7XW?wFP;Ke>*C_0gFW+e@<hVlQ^<7vSLbGYITSFqy?lRZ{{HxXRDuD^P40xV z=&uZnY8WR(+tEN?znL@1+ibQFzHGKi1z6D!;l;@EkgB4Q9rk1eUkL;=3rXs-JeJFM zOZk=A;h2chaiWdIq+)ynLa`~O$8ed~hbJ>R4=mE?^wqWe;cOg(C`qF-uVqM7Rqagm zG6?yoCTVDx&&9U7mw@1QQ$l-@6?y%WpMU<{SKo~$@#eY!@aDU7FuCau+m@^I`RtI> z^T2eK+}z8@+2Sm`3kFAh=LEV1FYjZedspPW<wLet0jy!421GONB2eA`%q@!meWRMD ziK1}Ah|osVNj@Q!0iN4cyqwp{ypnIFSz;`HsrT_Hi9j?p(#NF8O*e4I%c3_32vBWE zGD8(nU}4ueP@Uka*>yIy+h#jFnLAkce%OrCT<tIpM=Vn<18bho@b(}HS-eyn#$Gjn zl2OdhKAR?%kp<eUiXd`2dZkmFxysiUn@VN&oE8pqF|N2ju|U@e8M_OC?zBK=gTmlF zzdn>6{e<6}^7(iC)Kd2}%D7=qri10tS?%3pj<TDpg1?zvIT9J&18410f5*cJ+MluV z%F<+d1VO-Ba1sc6(+Pj9P6u4Ryuf-#G;Fmu?3oziw94+g5|VPl{Ndldm}S|)KRLSi z&+iHSpBtV%c#?Ve0|O5{Z@o53q4H&^ZKXqSg{G#c09!A18o^k{kuBu+6hMV5T4`1n z42DPJxRq`9%I!xTX4lEgIIb_Y<{_21C4lX+98D9Ikq)$dlG4B;08tVWu)NH-*M-m` ztw|bzs4N;OnI0!$l!S(+S>+Xo!Z<WqKx3^0X>!qbL4a6Gc8urhf%v^Y{@Jg;{`Mzd ze!-`OflBawKuB<?>uI2i`$F0s+<jyyeDk*>5^Y|Vw?G!tXEq;tdVKI>;P+szBAz~X z`uy6@Gh}H3^c>jmyWh<Ch@uFDQKaqVZ%cji?j3nnvRc`$ip9~+#^Sa%3|q>k34kQc zWL3s|rYT!(jvL&tn98O}lEn@qny8XmgPJE9kUu$5K;zgJW4fkO4+iVRl?f>Mf~(z1 z01n-5`s??bZS92nVMHTV(%w7vtFW)XJFjbF#(=#CGcWDGyxdk74P?hIQ4}*53>nrn z-PNfzWr{~}7;%XWv`uH1@PzlTmSCF4LI^S7_yqvtH0=Z<Hur>?cOZm`dd055*^P#G z1+;9!b~=xSGP!)$v>UygBk)qxwgfC)Fa;}NieZ5-w-ZbB1(}@;xRsJN=OX~%;GZbU zWc_z5EB)Dr&;jKW_Y8aeS8fBdb3DB6PbRM*tnP`a4GZ>J5?<ZR7>Tj#Z2MLDS&KpW z4tYR~jLL3?t|*PhiL^f|^Lmsej*F8-{eS?>_Q$I$<>FVDO`Jv~#CS2<To>lD%Ow70 zSx)Au5Y$wy#9$#rk|kAM0hG;BiNV|J!eDR|g*UYM4x`Mnlo%`vIue7;eVEKgAHc>k zTV2#fwTOW5y}}(qzqz#O?OWtKi<rT6TW(X_;Vrs>jU{gUA`m^znwPorIKey_T=5;Z z9OWHC;a%Hgo^D)GCx2N-6ej^sb;hG%K2*ib1j|jub*H+ngTRn2l3>sy>rRqhk%9?e zC26$0*l;P0C<(}KK=Om>WE6vOscYFg$cnz614Q2tqHCQjbfh?LcA8yXZuw+=crx>D z3CkM;T4zcyAlyHi@n4j}*Zgeu9!!~7f;5T&6BwbGnJCDqQL#6zZ$#`3&xSP}5#h~u z7g1^}HSs8_b9*b}By6CbWV)(Fns^u8O}7X!e4{lCn|Ygtsx7-=*l8OcqG<7g>VQZW zGb$V!EPg^qa6FV}*a<(O=i96)cyb$Wg!2t6&<O!?{AUjUy#J49{CvE}zUQ#y9(fOj zJ!Ut#4cXZ&T|*S5>iCjw;sBl;nOrwrEG5qXc~$xMQdUoOx%blthp;>f6>pqgEzNh1 z=Bj&mTa*U9-(6bK%1M^?<vTQinbaDQs92Teu``*Q#nIFZyfUu=Dz>#L#1Mcmkd5|x zM-#cnD{btZW>MP;0z@ZdWDKHm+l=QaB<G})<#Q2_V(9}BC!zE-YpS+p60<%A4^6po z8X5KS)n(4R{(k-Sw|k3+(Cp4g#>yWQd!2lC2;lVnJOBCdSCx0bl)K^JT|o0kaFjk0 zQQ98LlZ;P%!;{p<`Ek7Y%Xg3d^kjR7_0(jZR=bUOqlko3TUYHj)^YEKZzYjtps3Q7 zy#J$dd~*e$Yr3{=>#{k1yx<>9G9w$QWpL=0TC_3Zt*Vwl5@Tdj;N~i4Qwjjg<s+&$ z$0kx=CBB@IeG$q#St?p@s|(|rLL||eF-OofUDpWjD)Gdx5Z!p5@Z;(lk*{nb!O$Ab zEjVVLMFhNmz3emo^Qz@9##Wkx0Guk{Ds`jcG}hL)N}|gWUoV^fNEJiT=dRVQ7;q!R zU13<jQ8w&Tw7_`01ET9>gq;S#pIIH**Wy)<QOb{X%WTlbqr`yUna*jMpL4WE^-sQI z2D$*GYs%4|9UmDO?p?I?)?g0~FyjZTv@DMHn5?5CO*Ws{K42s0HXCQ}uGip7nQYxe z%&3_6eer16{5*42(xR0Z5((wz$83k#A;8(xt*rRBb(>@{0m&#*#z*XCHDwb@W+-85 zsD;y{*s9umUDmQg?BaC2cQ^)UzMoxRZ1o_(d_R*1ZQ6y)ydF)JJ-Otm5K-54x@g_1 zDohy2$xz<UTjOA@#&2n!LUc==2EDp|C*$Dt)je99`kSPSKKUOXzxuyk4J>1Y_?@Iw z?+w7>BO!2e9O@$odr!@czb@`XJJRcM<!5sFw`wLWs^;b+?+5Kk8YwjO{66(Fm8v8U zITP#dv!OtjdDs_J1J90gE6WDJ!Nb|`4q42~b)EBdH9N?5e1&AunphmHGCaI5NV{;G zQ(j$c_%W*X0QO4bLK>7$5s#JqQP;V7h5iRb=U+|f<>LGVyY&PdKilIs_3X_OG@$Nz z1NvUcW@0@e>Z*yP=O6%qrf!Wn#3;8-oBqxn*rOqjdjDIBs6612a3c)6WRjhHMdAOJ zN4NG1t6u*f2M=LsLd+0hD7N+)+N_ZW0>FbmI{~o%i|5WUIv2D9=;)t3=*>YL*Z*=x z46{7s-9Bb}_%9y6`-|6JZP>F?{L}yE9{_ms7q12HsdArk2*)eg=|X0}2_sFd>)*_~ zLO6ZH7KR<dy6V2_q*<?ga607xvB;pt1JY4!#@6~eH(+UQXR9S1!&rHuZP%4Cr8oW! zK@bS-__AG<@{`N=8`DGl@RNNxkDR`^QpJmNVE_O+iAh93RA(P3CC+kNsSZY&Z@W=0 zifhFW@=t&L^|zn>^z+Glw7$+i7<R7C)^cK5{L$g~ZD*)_Tm}Ce)%|hsw+q0(qs_}Z z5pK(n%g)`e{_PJ0F&k%k#=r-Z+cDJCn{Uf(oTlRsaV)lQLLeb2#6ENDj;2g<Yip;= zO&ZBjk2wsci6IFTyyNKL!CW@>nQe8MbLx{y6S1R=!mwC7FUD!aI-Ah69o&j|Q#CdZ zMyRW<f2kYy+?kKBoOJxVS5=LdA)oDK#ilaySV2g#vQE0bt&}>z>?Q0JMgU%ZeHLdC zJflI=ZXS|oIyt9~N9iUn)yD)L9_;aZvCiM{?AHF_KG$+vj7Que=a<i|5W(Z412$)3 zojchYa{q<vEk{teg-=c3Qd{=$=in#5eqpfu*~23)C-wa8d)n<Pq3_PLE7xTB*Txpt zpo{t%ftz`Xf#>-1fBDIGfAM^9gdhFWhxYh&v?}Y4Jil(<x&-S0Cf0P@n^yeVu&^l# ziM{}~MP;tQD2{C7k+D^uKQY%cyMCoaCG(P(X{qOKVRkznr4Id3KSA5PR4e1WFhg^G zwAVJRd34LI;%#KQQ?_o}jppzNaY(xHe{nFD``9p>vRG%r!cb90vPmM%!dKUh`)87d z(s86HYFR0G{;RWWlE|v`WIi$lEICnlA>|Di9EQQ!>uWQ*2E&Z+zxnQ`zyGtn<Jqep zJ`h44e{lrh^u-l`?ZY5I*8O_x8j<`CV&Ld5rQAEd`_W6;yRV3Se9boB8xNr}Ywys1 z431OWm?9qB`pRm9T5EUNOr2&tO)Zg^2td9rgDANF4lST-y><1x)<t{MF%ST<Bc3eu zdUw=gjYXc<7!B~w+P3p<M_sl~qj24NAL#ESj2vifTfZTuE*tNjPxmuECWDYXyt*BI zzd5^M^aX({aDky&od>wQ$mE*y^a`T>z_oJ9Zp7@VM>uT)JDAcAS*QPm33zGG{@?tl z+dNqqJ}L}4BlQHZ9m5Eg-}>$^o`3!?Ke=JpXS0+Ml?C?&;Ry(%5q&nVrmN7i4-o_N zh44DGe8EV;PR}+7ktRkn61BsWcG^#!y1d&Mtu&i-Gm<Bo-L;}B8WV<&7bEkyU!Sc_ zCQd5ebagvY{)5OjRoixQ5XGq}{|H5MA<8DIYd%RLDX<fUO7TkSflT%?0OQ4Id9M1c z>#C7V?Df@Fw)4uf`|J-N0eJh?xwcZWvA<oNt>ZY%CaJs(b=mY8Cjh?r#jk!0nyjyK zp_gc~PZGa3&wsged&z#=Ta+aOq@i&3$eZ6Yy!PRz+!?KpOjX06%RRNR<PJuOYAehK zbf+tTzT7*)9rq_6tm7!5$V7d`whFZ|`@nbHX%II&wfEeTEVgZJ<oJxn2jiyccAkc5 z_k@!x*FFJg>INixY&1UY0AQ_wOKsP^m&;GR%@4*2qmo^`TY6ue%zagwVq4X$(RMr= z32l}j4><2-mL7d};2n?GdfQ(ijV69CU|lwnio#{0opEA%{PicMd)fZO8PorwFml3= zZ~xmH$0Ca(k#Hn70ko$D(sUSvjEJy12GKEuQu$`pWa?0~7&Ddzaoz88xrHfBj2PyT zduhi5=>E+&>|s~O`U1gOFsKhrQj2-Vdo%J{w%PAbwKDw4!2$rj&Iz>2i^)IS>kr|4 zRX&pWhTb!}+A0CH$tJHJ@67Wh$0`}{_AkByOTm*e{wo2DXQ{qT)}%==m^G>?LU$LL zo?$LBYOBhQLYCu%=)thLo_rW2W2s)JxEfX2>_42zn|W|D*TzRwR|=$?x;4Hg#udA+ zTO(D!Cv5}?1lq1E`Ga93m**5lfsrWBS7oK09*&;v8{oe>U4bx`K`;>kXD_cp=96u< zXP<rc;`{Ht7pDugVm1`l8w#>@-rmsObHlc}%C(O;qBN9E#=&RV_1|6CQMmYxpzIBB z5$x`u^ZvR06FWcp;|^Wm$Nq*8z=IeMW7%)6BR|B+z>~RmI0jH{E1rJ&SX+`tNg8F7 zR4Qo%L_whb6A*EEjeBjAz0qWEG+B%mM-z^|H*7@Ib%JR*0l?yLyf_?_@@4=LF5j)# z--tjS`WD-|*w(sri2#+1;{Wu~_wi2-iEZnve0`O(eW0ou{#OvPN#gCcsamrK`BD%D z{7c2AvVYO&3pY*Tq3^&Ga@m-PP`c2V$)Pzd7~(iX*8a;Ku>PCYMu?eV>ir49-sVq( z81M`>e-Xm@@W7*FCON$(5KIZ{rnJ*g;4AD|2_alX5p$NptFj8=oQUYY+OWen-*!)k z;ja7#R-<~bqv7_M;^6mJ@*n3;xj(sGl~4YM$L6Zq(-iCn*u^xrlOGz}?a)nhhKt$N zz>U_mVlo4pfGchHN$g!yH6zlz5SgaZzAGkCc6Gibt$;P2B@(MUS=5#qHOe7aKW6|y zXD_cz4Qv1548FCoXJMk@vuvMz_L=wMh0aL%d9~db{9)7Y>T+w$#V5L5YVijLi$6F3 z@H>ft@2rF+Zg}Y<=AP|7vq@5&HTT_hUu5ItA3gLI$jgh33<T<`3FEMB+JlFxIkhSq zxrZPMKP)NXd`oBnY8O^bVO93(fgN%-ORZWm(XLr=utH3?cXQe;o2BG8m#AK3`8T;N zeezQqyGThIo{K(yvNzjvc47iVv+wPuQv7gsKo@V9=0m-fXv!u@&^sAV8_P2so$Y76 zN4*)j64_PJIJ|dq_9=gGd67dq)d8T3hL1|VFz;Fs=(i5$v-9hfumTdE?xX(zd2ce! zeP5x<CLvviK`$B>cWzh`ejY{m`p&)~{Emht00N!DBaXVn#3gh=7@e&R!+TE~=YF+0 zyIlU{-+cD#|LuE0>I<Gt;V{P9$kcrdnJ?i@)0lVMpn6IK{K^0P<(Ab-*QqL(j3!DO zHKtH;kBKHnE7N|^q_H9oYX=eA-A9O!nPqkqhosG+m9i`x{nsR!NbpQBZM0~HnLVO7 z9M2SoV5vKZ031G=n|pNrZUs=+w(40R#BtCm(*z_^EsoF$QLNQmBqd<wQDif9vQeVY zF&!sYrz`pWH@`mD)hpsg+BcxW>5GdX3?j@LvL502syt_Ux>6G7ruI>w%G>0gaj<Ic zATj~HahNba7QTtwNA=C<^dtL@dI0>vxc{*i49Z~3`w99{KmO!TPWXseo^Jp|aReY= zS798+ap<&)T1m^D_dgq_cd7mw?}venBnA^Nb=;yh{xN)++(Y2WPG63Hy65BB>+dc+ z?&tASCtuTF@G9|G_CT_qQD9Q6{VSPGZ_%7H1+bgYw`#rhNabl;y67tp=lXn0%!wgz z(!q$=9me`0d|!!q*c*!CU^ZRn1^?xZOP-pJMjSPlo1B-Yr;07;cjO9Swat5XQ2u9t zDLtQLa77yUwOGFUn!lJ#$Iz_Z<z~whx_gtc9WKD950AiDLRae_w1plCt4MC~-0-e= zZP*$l_h4A=;V1v*Gj-|y@>0Hk!%~<Li3jG0KHswbyA}Rfx@$^V{NtnLU%mg+|M|=Q zyQ7J+-Btb~AZb;?Sj6g5G<9c481X35uUm#eGK$m=j4=@@H5>WA<0pHjGhw?a<)34z ze@7r9Q|>X#i)=oUNn--4qE?fb<f7_<BELmO%#Kjx^?0H>IHDw!uZK}!EL8+a#wb9v zzRu+V7@{Qzo9jFX9q5&ReDG`!<kx`t-0fm8Gqk>Q$aP-~=6U|UU&zm%o-mbH{Gxe| z-^v!<1>8QoKz&0oSXc}658nF?QMml&_0<+kQ*al*sc+lR)Qu?^Y_7}6B4Lw@xFZG+ zTtPkcI-aZnkuCs%VSmL0AMW0H<$svhBm;Y;wkrh;3DZmlP?rr{d32SoAK9@!nT{Z< z%ldmw<wxY5=saTzdwBXYZ7UL2vHj?gLx6n!-MM!@2M=c1*s;{TKHn_ezT_zOAIq-w zNAPGI%cesUjy(U>nbVQuN)^>b6KGr%=M@_a0}qHTnNq*&SM-Bd*Nn&PS|b_Vl#`;K z%+$a>X*dxgdjBRj8n(7lw$kYnrv$5Rj}qGozb#AG$3Pv`x+wXP@U_(O0hTUl(VnA{ zcB<Wlm3;Kjw#o~$w?o*kPcx-B{pS4o=<$&U%KdG*%>gWc`JWt_(yw!^I%PAIjA9ut z6DW+8ArZ(v0!bQ0y1gfxrbaj8@^ob^RZORTu~nAFM3jzVxh_6^acNdLdk?1OD(M)` z&SOp89-i2<e*5bS`4gtUsK~1zQ1s>`jpdC^vuLu&d?79UM>+B}DViw6)tN%dqbGaj zgG(iHM*^bJvBB&>`dDCjv8l^$aMTJtG9xi-0*%3)9J0c*%j}O=@xd7EuLzlkn5q|; z><#T*&93%VJwW_;L8kzKf3^1ygIkg9BW~rkEb>bJ(<jt?#I4wt@*j@AH*eSHj{fj` zf9%9D*Hs_0Km7OtRkI{nwhV{@{X#%h(aL{5%B3Iz1?nGfOGc5WnO^rQuSDJpn8>Ub z`)3G!1-$AjoUe49kkYm0pQA_fqepZ8A%(tdJ9yytCoIpmUWqzRLa$WZb)9#>qe)`^ zBJc9MA1<9IgNQey4&7@t8N~BP1}#TvB3R7D3zJS|cc=;|;CB);`3zMH7Gn3KI`nq0 z7|s8Sn;v|xcxm4jtTa2MOXZ&I@Q!#P)Tww5?@hjHiR*eB&(iTM^=q+1v-N}}Na{!N zc2)A+viDd1`VYT+`}JSH{QAGVguy@}8_SaP;<TZyVJ4e(hjINgj{*^C9up~M156`7 zta*{%$MxBoxcN7MKwT@$0Ka&<GDF=wZEf9}ktl`s08~=pONxhI=Y2$zIY@aI+P3Q_ z5Z=GKG8cEQ;uEI=vAWop@5Jc<xO759Nfahgn1oRp294x@Q4j_}7z9BOh7_Dt!P#B= zaqsTG8^%Ex1z{9~VGxEv7zJ(9nty~Ih(fO@7gw|2976r8y?^+x_WmJ&=mJHM*~m!# zt1Vx`&2fd}z-eY9bg|F_LI5PEIXQ$54G`wOg7p2ilSmLPFSbaCua!rWc#4$owfNAE zpj}(Ot;lt^?U!9WmCCzsvWlZLlY`%^5NSM$s3-ae9qBr&f`Gi3wQC(wMgZwJVI^Av z>C`S;ODEQ~Pz?x9kalJo_8OP7CLoB&(>7^a@&4_Se=klW3fykkb6=t>o2J}a5kT8? z<+kPx(B-z`e4;1`dG5i3f^t*F`qS~^u>p@PO@tMp+M)a`27=Q&HY^RYpuGd+k`22W zmOy=@Ltlw+S2QeKV}K-z^jTR{wd)sGByzAeY$Y_r&W<kgAA`Y9zVIVjS8v%l>s@ON zA9RO4m#^#bECKNRt9M}-2qm`RR7rImkw6HwmTD!Fy+j~v-<IYBQ547v-L<O8h=@kh z)I2N7Qkp~*2Sy;L)()iUB$>*lBO-3h_wKpE#UKp0YmgyiWRuuDN-V)vn`e1EA4#{! zIF2^U+;s9w`gAr;4UMC1y4B^@WHsdLNfH*hdZsqZe8hx_2JWcw+>~saW+Ini#AU?q zvq=oTJrrhYFl3%aJp^B$UlC!FDRH#bwg3=p<41>kuadKmj=ts`BiSn=Z@*MXQS+@# zWrTsfW12Y7ODzhcK`PIt$g7WXpv%kLBL<JgG0({v4YR>o*PS+Yv#-xLDl0AkAkAVg zsK}-xX%KCArcKjC@lH?WUB*g=I`JFYcrN<YH)oKovBEVr-L1sLMg2WNeIFGh1xFjb z_Ke-tWGy;dbM_6b>}yPl+yen&nr6Ksks5k{G+r3K>UK}$BxrT*ktbnA97m!P4q&pP zNwF!-dOuvXm@B%gvMLb(#KZjs<JIBag|pCD=Y=~~o%2bKzBE^Nb^f(el^<v9?%~PN zzFp(^yP;R_FZunIz9}r#d%z3xFU~Fu49~}7o+(*waxyk~pv(1!or@YpRk218m<#3z zHtv97um0<<Gn~6?mLj)3#KMQw-3~~%O#^ldLddn6x&@2Ocm%Dkq-&v|fb3(X1K}Vv z<a`)Mb0SD>NO@CCsW_3zUI9TEjT1xKlD>fis>)`*FWLKa@oueu1yk0KU>fMp-`Z5c zSjP`-?RbWlMXd_4lHLq#m&IhB$upfUvhBJg4g<2!uxQL;cX2#5V@_*9M{Uz8_F36@ z-r@e07Iwu*Ko@U-)R5`KUGB{g4Bw2wf~k)iKA`Hw(k<FXJ=A(l0*|Ys*B=Xmg+gEJ zhSYVP>Bb48$V>~;4_TSNkevZ#I*ycPO6q_g(Z?0kOh=J{2*V9FQ%x9!_>FDZI02z5 zTaQaMp88a&rrwFcztN3zvf>-vH=Pz$!Mw$Ll7KFsN7+{ou4P>rRY&Wg=Qkkw2Dw85 z5reY-{BzhLD#)tbyQNBdrnb&XK)v6AJJWZq==TG&?|LmF0>GxM7L&|gRDr(dFAW@l zHQr-heFGZt*1*n{?;vM4KAT!fL~>(#-f!wDJbUs~zOW*kBV~US5Xj5QJf(SM{Syyo z6LX4QZ8%F41H-Gl<VE1)y*UWc?@ck3f|i@oAOiqQSWs)Y=&~3rv(TH%onpd2dv*dK zn57)W(=2XlLuF86<D@1Zz2<1eXp+d(^m<vChvo2OVW4!Q=u5=<v}kcOF^TBq`?b7z zO;L{*nQ9ptMaJEzE?fB%*(8zYCOx~%2n-_??Cu{=N}InCoEq8G>dyxcXNKvJYc5Dx zR3;#{YfwU{IaWkgb3Wfx*;KVrgqr^xMnP57@{o#c-459ia-S?tlG~OS<MaSOhHnHE z%X&1Ach7@DxQ1Lzt6ey(EW2=1{Sc3;<2OGVga17JA{+TVqEVbiJkckGe2J~B+2c%) ze{%5V*B7H{O0F2PS*z|!s4{<~fjMoEavUe2qV5OeMd9~@-X2fO%pEjf?qEbBb)u$h zt-Q_e&bCTksw!`8K8C}GGkN%b`yal4^pivX<UF{9g<%?mRW>4t4+e83$!(;;fYg9< zyXC|mI5$G8EE#12d4Ro?s0((&qcU-BqpN-I-g*yktTw4|<8Zjr`r&mmC}Apk=qQ}H zojeas^vv@d{IpyY_aUJHULDU4doVokqk84ihhaFnQQD?f49I4q(>t{WLdJK%Cvzzh zo=#_2F>Jn&5WR&6y8+SfPj7k{>^&OpzcV5j<7u*8S8$8Ld|O}Usj%sEBgjfbQ4$&q zb4syRz|Ky3vqiRE=FrJ!LzXt*3j#8-&ztLfx|f-cDNNF;nFNZHsHt03^cBi~ns{1@ z&0kf~n9@%=jy30>1_lmr`EIqZ8!xljNMSG=$`p{n;I{1~Axi*NUL{$g?xs){73nxC zw=y^u$tbE+U?2u(=?BmDO(!l9Nq^NKRv4Uydu)Jz$UK=Z>ud)GmxXF-RU|kdI<?+V z>(Z>=1OX5C7jg>f^mv|M%>Y{NEk9`b#-FEO44zSBfVQn$b;H=)@aQLQ@=ErP_StiR z9h`ki&K)<YO3Jr@s~VBgS^T)b7H3hNH_Z^^Dc_Wn`M?ufY|GI&#owFl;ivn2b@I3W z;rktv6|%84PLNCx{wcbNF>4lv10~L#q{ZQarSA_kWSKi)QtSF>!(AZQq7n_Bxo0yZ z21-;Om8WgGI0@wo;Z@VGQOXzU>o<`UZ(<*CYN(D3<1NuJSCqWjG0ohtK^XRa)R8~z z!LSF{j&FhxZf)4+ADDX*vse($vWI0In3aK-l;#qTyC>b^TNMG1zL<Hp&8&62(K7zo zd~jFq|I<5p_J{xUfe~MGdZX=51VAd&OIFZLQ4#e+r*cuUCaT;mX>*lp<4X-@1Og`e zW7AEPZz_2;lX2YEs&TH!E7Rn&I2fA-;){1{gXn3ND4ZslwgG^0!=1r+1BGq?Br<dC z=4#t%h&2t6$tX7R=^)Y}ED>3XMqM}Y|F666>X9VJuD%SLKC^6B_jLD6&+N*r+-e`B z6$Aki^#1+hPcJgNfEE%2Noz*iW7?F>%1RqPs0WglmkdT`mYETtc$lfKii~8?9bR`% z;ByAaDlc-)(@>Tb9?fVR+Pd<zjJr`L_zyU@4z*c%7YCC^dQn?37*Cws4wi9)Rz~P# z;8Bz*r!)ZY(cSPmn%}oce-VGt_NM?vpS{2bfM>79+XJe+<{UU?(t{3t0P}@3P_Tuf zgZ6ENh}&Y;N!}uW<y|6HJ7uRDpA4GM<y+eBYSnt4MlL?APA}^8qPA3LlJi9g=G{QE ze`EH!#6;<jVoX1tU210IZ+>|d5}!Hea4IGFnB%M4YEuYMHMTVqO?ZQ7g4@8$xqBf1 z2YT8Qabgp5%yXUyg>ZLz2j`A=vVGqz?7qNlDl2L9xG*7H*9ffn;v97Tk$QQBm4<}h zb{OUkjB^Z;Td&>?!(e==@ktAYxydO_;Lr*Ez=1<8f}4CzvOPQ(t1-@qEwN#{?5X{F z{?ixWoUIM-MDKUDkqXL!s9AFQY778Z@8-x9VvKbd05ZUcw${>aPd0fVjR7VUM?~92 zHWMH#yV@Vsd6!j16~>}CnB|F1haRf33uWUn5eLNZ*3q+Jq7(o@1$`N_32MX@cY^~` zGVt;3jrgG|D~uLnwO*Fw*+xGEMID%wQIh8^u4vffI21p0x*<||fT~@j)pyNHoB+b8 zySz(K(Za&u0HXF$gI&YA6@$UZgw#SEbZ#rTDk~C)UlI2_0LV7=J<wORY?G|JUBe3< z;Mx*%apxs$P@2xed`5T5Ek07pUevUAo0o)M6R0M~gYBOxM7r{Rz!t{7LlH$(2D<{Q zn^hLYJ@G>rJXz>BA>pgGh;nZfVecZ*D_-CJ`pU{+*-qS1Bl!mA<Ha_YjhVUu0Dv`x zy0tfj-Pf-}3p=a?awe!V%v8QiZ{>^ucs@vnoO(=I)-<^Z07R;b(HQMAkyFwSG#|D6 zqO4$B*EaK=feC@W`o>--+N5&Sx?!}*bFt}M-Y)dwkPBId-JcyADOy@82LKo>*6*>{ zB<jRKQoL7bN@4iJ^p3v8u-l;zU91z@G4pQMTtjvO7$UW#`%w3dF!M`oMV6!wC%l)2 zej?`w!#)ltjSb@vzxu0}@BZQaI@3W`k5~Icuef9kn8BOpCvBg-dN-%~9M2|W(S*5D z2R?l@hF6XcilA?|AJHHk9u#mwGR#n6EM4clk>pw_5E@k`vzV^F%!TH?ac3<USUD`F z>!=%I&{rTm0~U2Sx~Q|H#CC{`CmIV-8&@UJ@BHgqB&ea(?g6nkC~Ym480AThwoRuW zZ5C2-IZNfjNj4d})zeLJ^n8fqmqKeuymGf6Wt%EC1sEb(d=GIiy!iQrK-$XmGnQw0 zaPin8)nris0EOWmW)UpqL18lJ$=OKByBToct0ckI$&EB8^&&kl--W?{eelDb?F>9m z<Xi1)h{>4*vUm#sYLYt5>lz4Ie}OyigQBOac}jO!kry^S*IxLe=OZwyT<-f#>Kwp| zM#?~L0$3FLO(FURU+B`=(p(N)l0^W>qC=};Y6rc$S{Xu%`v_}U3N>JXCV<213*05G zV?D-9u)@fyVbz)1we~b8)jS5HqHQ_ymYglxE;EGfdQ1J4oP*~v-ms^o*CCEqX-fUH zTSCH)d^hEbr72pL3ERjTHW)g#Si`pW-eUYWW!}ldxqC)Xg<VT<*b?%kG@a%O<fgo^ zH7msbU;Wif0QmMFFU)b(m(0C-mmU1XExYpar=Q5L|9V^H1%`DutK4S$B-iw3*WDkD zK(TNL4^5gB-F}3XzRYxM>FQwoy<$*{dSQ{s%;BgLVl@$>EF*k$NboE%RawS)Rw#X6 z==4I7V8s|zCHDiy8Z+6L=<4B}L5w=PWl<sq&u`Zgg~2B;C)Xe5HqMZz#hp-Mu+%hW zVu+{bOM$^0;Pll5F<6wSWa}#KYYbl9C4)&<;N01tpI!Xi$(04=+0)d~P*d32yQuSy z7`e7OAu}uZ=&ad}!TX>u00dQ0w{q<?wiO&xpU{tq(W<MOsUneFS-Ou-T9RE<78(o1 zW_o-!1XXYM;4k88Ys%8x^FRp`@a`bmLW9{TvNV5kBt6)^Xj=1Xea;Vjj8Meg&}u=R z+T2*P>lHId@!RmXIfgcVaz{S01HSM(*#0oA8`Vf(rZ8-MMsNHrI(?X~$*7t+ILcZ? zezVx*OrJS*l?JmCdLe!&&#N|`n!e=RpadG~=tGkzcoT+=6fGNuRd3XoThziSZNV^C zF?yrg%gHI-gyD9fLp$he%ke=F_+HJ6swSFITJ%Rdqjf<M8DZ79*MIr!n}51&QcfaA zKfH>aKF!TC!@(*)jrL)0?+v1aCxqtAeThWqxEsd(2mor83mpd@7SKm=5UV;LQC}o_ zbvfIhZ$nXv6Ujn=WRZHIEV>UOzpgkICPm7z?2{h%1EwiHm`;seFEccN&pt!)1-QFe zDXguq--6KB%SdNW!}(X5?xv%t30HRsGQxIxA!eC%2hoC*+DB0!UV3qxtmcVwoon~F z_(qDslhXl{%Hj+FPJVKF^@~gA5TNz^$hw+jQFMo)o{)3_&^<|MSsChtE*LhVs67t= znlLQUmpe9JYeNnOlkUB;d*e=IX-wnrJb99ErxyjvQ|&A7;?sT$(xS$$#DQd$J(@3b z_a$TD<i)6xiRfwJ4MVIJx6ZCtjyNUfAbiCwS8G7p%Jb&t6FIZ?|EBBSu)f_K`lJMp z?D)(@0cGQD!;E%gGC)%_p1z0rO8Ytftfc=87gcqjGh_R4jDPCIF`fxto*djPR^q)n zVaRPO5y8)5WNd+9^H4&qVGees5j06Y?H4B{&|6@*UFfjcehS02mO!FSqPgvwVb!D< z0q58-fXy<qI3U~5ar+f^f-NB!&UyFG#y1VBHHzRL-%dNKB^eP-5t+&2<*JhS&sB7W zd5n@Jltn4Jx!VtM1#%*5%?KBk%+zH70HaA4`L*tD)|hKE7<YvE*&D>dcPgkKsn7`S zS}{o%T`x!#mKy1(7xl>&mu?hI^g7Q-1`HKPIXKlpz`JW%8XkAUO8Ml2(6crg#9&@? z4iI(1%|bep4*u|HI(6H@O%L|Nu4Jh&SP!z$Zk9nVPP6yHk&oKO_oDhxo5Fh<zIX+T z*+%r$U>w_9pfibxcv=Vu%Q0QeGXNML2iET9)B|?ZCYk8kUd_GbYBaw67K*#BCUAkl znp@a(w>cfX#8{8p8rA8@ECxYUL#-7Zts#C1ioT+G(~k?T0-T2P8GuXlb+xVBk)Y0L z0T0*}I~?~(X5{(WGlbi-g*Qi@D^n5OL1s;wL&S&Tx5}*5fYFrEbD4L<UR9?^W~T56 zI*w&UQK;XE%!7_}SbuVIh_s5GD5|;A|80k1D@DtKVG}707}ojJZ7_@-WcLK;7*W&+ zpkbJ|C@hg4Hm4ZVqfz5+;s_FJ60|hSv7KqAqoI;Q#9W=9{^c0}{QCdD-Hxxf*DC-x zJlU27a{jaPUMKGS-bfV3H(|K@XX7T8E7a!zaPiHpRolco_QfB+0D#~A`$y`-F{&;Z ziRNoTGr~NTl}K#h`9Ot0@hP27kV%>?&2Fj2#;hHXd2S3vAdHt}dh6(@U34(+uI332 zEjo=h%d9t&n^mVDrE57@aUAAq;CRhFZ34B*u89d;WK|gZ)-24{RowGI<y!WJo%J#W zM`eMH!O<2B-rG7(mc<{O9g4j1cUQNVi-j9XH;x#v>$yzec=P;}Zo&-U?fKP~=L-zp z!|=6#9Wc0`QK`txbTud9E`$HgO4;x2YO-_m$I+eg%(Qhtx*>97%+_@mpN!Q0#h3$n z@!`{t3q{y#Kg08w=X>-dUli4zBg`#}iaGZ9W_*`7s%m)C2i)*bJHm}tGa9^CjWFju zrkYE+&#)GYykaej`gAf<2~dqnBlSa46tPO3>vSTT>y)H9?S3Og3!vADsaJlJ=ICDP zb>c>(TsLB6h%DJEGG~Vqduu28)hi-kpmuX{uMNW=Zf@zFBO#9DD$q8|sMPooYuL!# zcBMTwyIz#~h;90oFfY<8?gXH!Zq9#p-h9k<jvBlK5+DEc^!lH#c;DX3kdsxwFaTV9 zI|IdVBHm4=Qvqkdl9d*mIC(X}pG#T9!GOVft~t?$TBe$H`VoeR7c-G6%!AM$9}(h? z=^6pLKa#{9<D-F3sx-0Oc9oTAX2jiSJx|EGP{qD8y&a8@dUUtfSg3N!rss=^Is=Uk zd-EG<1bd7P4|P6O?(#r*fwx)87Y_oj*rR4O-;Tk1U%$9``;%v%JNVWap_0L0V>;HJ z3Hp26zDcs_c6ATSFh)&CRkm-|ngCgd<U~FI^8@Xo@Vu=>H;-n@GTOP#R^Q{B_^#)- z&55iE0-qX`<D*`ah}iQP=J)$P!&OZS2h|Ga0FacLSyO~k^on8t05>1zTG)q!8FK^X zF%ItH89MD`6n|#%GlSpI0W8bPq&S4S<a7v`1-_gtRAO(%cXpOvJ*)wYj1lG;62L`f zr+LT9ZGczx_1bJN6GTcB|EvyVz@n?d$_7sRHSM(WV}jjxG8qc9wzjK#;AlMH$ZVwS z@3biT-N;C!+Uk_%rs^#avS`a1w!Q2YQwg`~uQ-F2pg0FdEi?_mGgtf=kS)=IYg2_D zxaJfw3}#Lu37j?cd)>>C13-Tm1Hii7EXG6Xwiv~J+m0AcbTXq0>*Wva6l)<T3Jg_) zAnr%f2g@LcHGRkIdWEIBOdYZrgCO*=<+<7r1lcmq)lMfs(3QX`!u(8|X7igRT59yP zF*?*4&a`?HMcx1)CW6_^TM5jYWlnu4mEzCxd@l%n(XpGQ*4&Ib{$?pRuG!`4=!Go5 zZp!Usn`%B?0l>4@2bg1g^=`IvaBK{ID2V*x;_Z*mKDWJMbRH|36i!kXg|ix~>6#N) zmih8~w2n|wR!ydz9hX#-j)KM(3Of%AMOF&`Oc;NMM3UdpMRo4_qu7}gEzX8aPPoE= zIAFPAV`-u<#W_nG5z*HiK<zuM>sooeb_(8X-F=+A830Xl)}qS-m(y6M4q7PCp!;{y zQ@b43wz=GBDr?=*Y3-k#PEF?L$AlaGsIPUF(LOK=Z~y?{ZnciX&@v<GcsXF$5+|VT zYURKJ2i+KN3%b+qke}t8a#YzX)^Ib^$|CDYoDkX@^+<}7iyJ-^`ypE)QG_rp_mA_U z_jG<BD_{BhhfA|a@>RwF;FC8;AHJHl?14-(=IKmk?dLbLrI|j|qh=A6mq|8xZy<}E zg3w3z80Q?5Il?$7@=|<(=QE`Y!J<xxyGoIjq4J_FZZ~6v!9f_HwLtBbJSh=_M@K!B z^<<<HJP5U=QI?gA?*h=%PHz}vV(IjJar}G)Ti592w=;>s98O;yOm8oDj>}Wo!T);k z764AY3C(=Q%_SOtB7U(<mSBVdp%+KuUmGwi`z<6Jdtpj{6vM78XnG9~x&Y=zA{fP5 zOvWt9H4_^av;UvC#)rN6tv14fzy|=qts|x^?T@G%0r0?N^70j;V<0_QWxyd%OFAZt z+cj@bq^s-N`TK`#K5}DZ*0%0ML+clguf9jY5^pB%+OT16{m?EOy6Y7kOw{5<<Ac}P zObc=QcLg6ymzpg3)z+wd&?e1E-x=8)^lc~uqXEOFL)=AKjf9czQv;?WFf%$1ElL~Q zrUPrShTF2UXfJC1QO!z5$UwLe+y>azHUI$l@&Eh%odejptl?zWAis=@qym7jg`Gc9 zXtA25g9Dr0{ovUUSKlXZj+{@ZRr-B@80u~(j91E#WgrYth0&br@JZZNxt74RdM*Zg zWooqE?iIBbFkn$Pz;$}?Y>0D;@^Tb~0Tt;c$Eh<I%eOA`@@{HxV&a;RSUU!fIp>tQ z2&oA>gJ?aMVUgusQWkFCGEy78`^~j5k@sJ}Pldq%a8=*^aQOVy$szXPmmjV;p#tSV zJ<zO4fG(~_qAvghjIp|^w`zVH2~CW!ZZHu%!?`8cY-=v$_9zpow^ej+XEv5~EmU|z zszJbhOjr--9pPtI4-ey@aB*Xa!@fL(66nSEilsgm@jQr$%Q?v}<bq0utUkEAUUSJx zVFM)q@CsaP#LA7<Qb@(kA`qbITV{0&5Z9rTA=0FhYpvR9-Mbw|o5f@WhMB2378$n1 zGzty(CfmB*Yoz1=z@vlLoCw~2{^I2A$1CxGb?U52<m)WMGs~S+3gY&|8*c>`Q#3`t z2C<VK5X{ADc^@N13srcnWFiAD$ycyer!+lC@Y;AFbp`-h!bodHUiI107(bU}nb;R5 zr19rJzW~NQ|J&E}jYQ$8#(>|<89)_By}j436NZzOVIQw%5;g`0on)0=-Ol?H*)K=W z$MjQqS^&WKcmM!LFGiSgHNReCpD0Xae&}P-a2WXu;w@t&*wPUd#tZ_{Fg0_#16^!_ z4695X*~M0yCWV+V$vO)HU$T7o42v_XbwxMc!B_`qZ!fjlyr-FGWK3P+=q$n2OP$-R zIZ3xBerEcd$PcR0VF(<Zjj&3p$V&g7)WZ3uy0>}Ja{rgh^OvWG49kxcskz?y)bX)y zgm?_}y^rVF+@=8l0$%e6_@D8B!#qMIE{4G~s^64rlsys`5p@4|uh4W32SHGl8j_2$ zvR*LmhRt_II~Y4&LofNIO7SN|Xk3q8Rn>uKh`ZsI*>?QgEOqwHepy-MN0a~1kSR2C za(TO3vjqd)7}buMj{I|z0mJh3?uKFOAD_QC;YN9lW{Q1va&$9a0VP1zpXLA}>q=i; z%*hgQg!#%`2)t=sir%}LX~G%f1_mIhuUcVvy~%8aLURq%e?C8+ScF{aBMfegCk%R8 z{fq(I<b~C9oTHc|GZM165Ge+7QffBcG3c=>3b_22OGSR#dRtqZxJW9o>2D{|Lu;71 zvPpAw6nOXLH2@r*4Rtq>q8n<TcpjJ>O59xFjDf+%YW_?I#8eVh39wWVr>g2esS-tT zh}=Y+>y+%xGV7~s=cBVBVlb~c-m_k2eN}uF1gumbS`cQy!KAaglNg+=bF3H+LLUW} zKqnK}@WG7eTkZMxGinFN(dy=DXgdD>xBvM!pZ`cW+&5{?fCX$SgWP1LaME}&5|1~0 zH5OnZKE}-33UcHKEiwiWb)zk)9rr>^D`=b#SYuCj?1qf<Jg<^<&fHtbqhEUuJ*CYu z3&TL)>9Y0)<Bs5s;~f0Z^Fz;#32H71_GXo9CD&UR_+e<!KwiDS^Zd4oNvLX0ZBIs` zb!AaAR?#-x{%Xnrx-a@W(Xcs6&4?qn@{kP?JyKEx27QMkQ@X*ZWVwawnlrB@G}5S} zZ~n;yP0%`tEidielyE5jd2%q~POd8suTPIe-WBJtPBU)hAOXap6qvah)zmtGZ7EvL zH`d+7U7XUEx4*q^*r>_nl<mXhly)))>8EpD25ibnF-8Nz#_wwmO#;Q?@9f~g<yHqa z5W3M{j-`VzECZH}+vMwd-j<-82-e<SEVWHRL<Z}1hTSY#_80)L{<wp;BRv)Xltm@g zYZw5NRfr6ru4<};h^w;5grEWwn;4!07-P3Y378tDG&yv1sNDzDAO^`3%mJV%Dtbc0 zMCBr{X!P)aIH=c3(~vQ(pyRY|XV)tLB&Y`fxNFI8e=G*?XORB=+yDI2XK(a2X4ShB z#V|F8`GXB#AT;<IiGYD0`1_+<+}+L6S!C_1d0W4!c&L)nlOQgL>^`;l#3U~Bx-2XD z@gl9XLxw@R%9-z3g-Olhg((unR3g6L^bB0RztfwSF?av~RbAV}3+jh5uj$}kyt`%d z5&*h!<W24Q8Xtb9TO(vx-hXAaFE&Pv0YDy<mR&`ZALMQuOv~nATUfDKWY$}E<~7Zc z=O+QLja|ARInQEtjR!q@W~~yiOnloaV&g&Av;f)qW=3Gh9!4C8SEom47H{$_roIr) z0U(Y-CA_Dx&mw_xQ-C^QnA@%?3x*xi4!kL`xf_Ogqc#j-xUI%pGly^^>yOe;(oAfj z_`;Cbo<F1*g5oc_rriL%>*@_+0672IdGx!J=C?2=Id0t>n3Ni%%b*dV6H8tQYKg~I zwTBjJFDz0mmQ3VN8BOOR8Mo9aVWfA>E?0-ohvMHy&qrv~Rz)2|68|R0JuH&E{xCm% zDbG5+VN6S|ne~p&-+Nl|{qANtIg!28A9XhhgL%!pU3hZ!{_feU1M&00>F}n7h-1t3 zgm&=1U4Hea&)#r)E^NRsj?j-^zIgmMCPb1U5ShK-U->TQ05Cf2m3akRl2$%t^{^QX z_I-cn!;wKodY%|pp=AaDLF^Z0S(GIw8XZMi2*gd-xm!)hLSKUuo2jn%!3<hoeYkU+ z$hjf~wBC^1RZp|3<9@qt9PwRM7$^%y_HIs=Je`$o@<Qe(TZkek`(vYe*uW*VWp9~8 z(5CgvTgL%ZaFjEfM_GPen!lWLfL<qZ^tj3Hm}Z4l-$O&yP7)~ky4zE<TzSxq+FK`Q z&wZ?6DKq7SVN>nT;*^#d_`vX7l6Gq?Z(4eYFEc;G$yCSE6<wr7xD`H)Za)r1Pvjn> zfnnbA0hIn-&yu$1fAM#peRw+sfQT^deE!#;l1JHj5=BxLMG3$>pOuA<Hw_MYI9=!0 zYn*mRXCw9EY<9K4UKeJf;A4q{NRu1UFlyk1QGf%pUS{H~WCfUJmn+;?a?&%i>lAmJ zg8cs5Uty$K*Ea(|+>6lm$j$t7X>>7QDvL@y;9@hyH}XkX%@4e`9Vdw78-Dd)7jWOe zB;NyrAC!RlZ<k*Iz>DZO%?gnOx6b5~KRrDb&3io@*}KI(K(F=opsx6n!>>pYG;BTw zpepP0tej6bRxtH@zC`j~krmat@_Z8W@fdTd9W<{zE2B6N+~}QtlxJ0*lu<8ari5{t z<c+j2-dCDs6p-Kl_S!L#nx4?c45+7B%k<*{eIL_Ntu;qPCBYer+zG?Zq+Wv^gEzT5 z+FiRXN()>3?V6Md6C%<ph+`ekBn|Dx8jQu_r2c0P(1{{t4KmBkY%RiO{#gqQ+wF9Z zixY<17@l3D!VTq91BROgOAP`|I^w*@N}SO_;Gu-Q<dGHWyRjD3D)uNe5*PYo@4IgZ zB+j>fQC?I45QTo86;bRy6BJ3QAVh*<rypU0EM>QlF;S79HC<z$(p?3>Et*@`yh|P{ zLRu2nZ?qKGCtn;<3PSw$Ad0aJYB1?uy_-pQhLvB3i`OQfRY||xp;aQMk3pO!=7o7H z--=FV*yxe<FoUCLHGLX87yv$IH-|9NM`=7*bN1<I^c^8l0L&<FeUhs*#TWv$X4>R+ zzlX~Ubk!696v&N7r;kZ2#{ecLGQ@IoF?T-JC^YJYR@RFw!6J8|P88n506zTpwcZQW z4vyP*U4aI5!}<aMsBbcGX+j9+Gk>CDYuj=)7E?ROZG&MqdfLm90y1xw9&t-`sYSA2 zHw*(nm|oJ}T_qX5K`)NDxBxa;hA*CpEF{h+gWhbp0ap{OukObN(ecrEz)T0D_{kGV zSi~AWJutR_b(&H+L!Gh3004gQ$um<r51-Ef;L8ux<HvfYb|Ect2#<d#mWcTK>gG29 z7DyYz)|OI)Y!dd*>biV4^8-(iMp@VFY6Spq{^<Ev|8ef5?Gra_zYspdZYzH0MYZLx z?j^wuny+m)Gr{thTayngzX*|NW&l-D`=KZPdh&97^<M5mAAURi<cnj+mviJ<=XMRc z9ad<lW*L8IaK3_5B}FVf$;`?Oe;MD_7aSf`MCiDl7K06e7A{lJKO28n=nDYBaMEqF z^IB?xu;#B-gCXvQl3e1xzJ+aRS*`c9Ju{5_ke)3V1Avtj7-lrD&=4oa%;aTu^=?KV zxmjhp@JXB}Jm?MLs;U7P{Vs8)=@6nBU@T7x<j28IyZHJRY_eUgSWwr{ti}~T1(9E0 z8|aIUS++o3f%_dXcQAItHZqL+!LaFrc5_NMjeSR1TvK018*;n}*Nq-Qcw46_Ml_e3 z3?GQ1zW~P1K=O}J%`h#BZWtQ0y=I&26fGJrCYDJ}87mkx4?hNd2eYRLuO<HjGu4>5 zt=nttmbRc2XU2<4rFdGY%&8Pq^sH;tb&}4f)Ng`Ao|&E*KMI1-CNQ5}E$Li%^P}hD z$4s4`503jE-cEN+<;Jf?;IlW3VCw?OvqIftTqw-Y^>j{nryq$i6XP62KBl)*q3gk< zhtp2bPvSo>znMwV-!$*`V{KbsrFf4@tzrQ1{>y863_5;3LZ{kdx)wKe`*E^X>1JrI zT3#l#Qs|1T4UpD_aSUvQQ0nL5TFSn)SJi4@&I9#6BWUk~0E44&H7)MH+c~boQC~FY z5C)=ApN+@+w5a7}cYh*aPZWTq(F>c}>3h5cQH%4X)^`bj#X`t}7U*qzezMNOKp&Hv zauE)90)sqpnEt4~=}fk&E3R3j8hB(hoBT0K0npP$q$3z}!{S4(MzmIM-uHlEJBQbf z3h!fA@U5x@_?vdEB>Fq*4(5au1B|e*TvL-_9|Px;VNdY5`h$~lbp=?*Z)A5P44Wxh zn8e<IVQx949j!JZ$yQ01Ep%vF!zSX|N~q8%1J>J#DIaODfqBF@maKicB3qx<m73ng z*R!+F4)E9eUkAti?KhNr<Z>c=V)H@;0&x$8;WX7bAL%;p^doTDpw52)K%SS#VzInS z3=9T43&S>VIi#B$9oPL)XT3<7<D*8gezzYdtE}d_Ks=BMqznLxT6^YwPY+UXWoWO# zs}NUGL1Mte!ye8hK>#92ZG%=v!eVhP=L@~1e(bidG5B$pu;az?^Yh8U_W@YIB;NGL zoozdv>lz<-S9j@lO?eC3cHBkoFS2UqJwR$|)k=0SaY%|5vkjU`6Lvta2s>fvn{`oH z1si=C0I)o9%#7;~i^kg1cA#YZFvEu8KSAhovTf3{U_``44D}#@vje-#W3{;?ody7K zK<^QPXkA;X^2_(<)*0sPXadG2%bHyO`tO?DD{0OQipc&=X+5HI@&j{}8LZ#SPbnCF z_3Y4?3jpt~rj0BwgVBQnoE{9h$;6Hwmt+~PfSdVJs{NR?Nt~_|?p`#ss=-XrGTeI< zhQY$rTDPCjNj94!zg%->G+@|nqDk>=z%cd+89ZVPkv`y17dq3Brs{MCanubNrHfL& z=x={{35>n|z0*7?o+J>Kr#pgNal9?<t8g8Z1q`p2sZ1a}((o_&us8sKhC{}*M@?!U zN!A?(kZdxXuuI9K$8;Q!0Ru>rJPZSATX#c0(CKVB*%fJz&8O?0Dn07-LrDb97yx|z z%X4!MH2lO3ax^>No)SV47qVjhvJcgq%QJtnD7vH2xs5*r9qIgQT!W)<ev!fBE=g3& z;RgqY{NWF|$47%aDfXu$De?+WmvJv_Vv-;+PRj=#MhYWaxb+hF!~oK@(c_GW;A#n% zqrRAq2qp9B8UV_oq`p9r5QuYKJVPxcmFWk5p0~c57kJzt0A|TNHCw{~;O4_!NVwcg z=QD&+=&V5%zo?2D`OtTuud9%Bulaq?CDEYh;Jj5n#K`{GnJEn}2eP}pXf>MFIB(`} zant&?d&!{o3Ma4g**DGaI~ex4i9W!=@1JmPyK}*%EY+x0=2+m*Y-na+oCv7@kaL5f z!R{Kj-f)|uX@lpJ(^H;N6m0i~4u+Z>d3w?_8oFgbHyg$P;N7pTp2Q7@=*!?~ym~Dc z+qr0pypmgolM!1@<}eOrG75*XsDjXM7{SKR93YB)#9%-0Fr?K^0?yw2{_|h|;#<8; z+LoNX9huDJ3|%+i5C(z9?`6ik1B1W2t1}AI#iQ)tO_l?PKY4NXT{jggk^Tpd4F;<q So9}}F0000<MNUMnLSTZP|A<Ba literal 0 HcmV?d00001 diff --git a/docs/performance/startup-stage-3.md b/docs/performance/startup-stage-3.md index b6422c191..a728da34b 100644 --- a/docs/performance/startup-stage-3.md +++ b/docs/performance/startup-stage-3.md @@ -27,3 +27,17 @@ A render subset is possible, but the current facts decoder also validates regist Measurements on this machine are warm runs with `HORIZON_NO_AUDIO=1`. Other compilation and parity jobs were running, so elapsed times are diagnostic rather than a controlled benchmark. Before phasing (3a, `42d65465`), `--offscreen --frames 3 --smoke-report` completed successfully with peak RSS 762,536 KiB. The report contained 3 frames, no chunks, no generated or meshed sections, no player, and no error. This is the synchronous harness path; the progressive path is measured separately after 3c. + +After phasing, the same warm three-frame synchronous smoke completed successfully with peak RSS 774,080 KiB, up 11,544 KiB (1.5%) from the 3a measurement. Both reports had 3 frames, no chunks, no generated or meshed sections, no player, and no error. Elapsed time is intentionally excluded from the comparison because the machine was running concurrent builds. + +The progressive checks used an overlay of the prepared resources with `mob-data.json` replaced by a FIFO. This holds WorldRest without a production delay hook. Core and the real renderer became ready, Options → Video opened, and the backdrop logged `title backdrop ready; world rest ready: false` before the FIFO was released. In an unblocked Horizon launch, core was ready at 4,776 ms, the renderer at 5,260 ms, and rest at 6,282 ms under compilation load. Backdrop generation and fade-in still take their own time; these marks measure bundle readiness separately. + +A direct singleplayer launch while the FIFO was held displayed `Loading items` and handled a window resize. Releasing the FIFO resumed entry; the run exited cleanly with a player, 85 chunks, 529 meshed sections and no error. That delayed-entry run peaked at 1,142,560 KiB, including the loaded world. Integrated-server entry also joined after release and rendered a world. Dedicated startup reached `Done`, handled `list` and `stop`, saved and exited with status 0 without constructing a renderer. + +Screenshots from these probes: + +- [Video options before rest was ready](../../benchmarks/startup-stage-3-20261018/video-before-rest.png) +- [Loading screen while entry waited for rest](../../benchmarks/startup-stage-3-20261018/loading-before-rest.png) +- [World after the tail join](../../benchmarks/startup-stage-3-20261018/world-after-rest.png) + +The full parity selection against `origin/main` also includes the unmerged Stage 2 ancestors (313 harnesses). The local run was bounded at 30 minutes; its log recorded passes for `active_effects`, `active_effect_tick` and `anchor`. The remainder needs CI or a longer dedicated run. The client Rust tests, focused startup probes and memory measurements are separate from that incomplete parity run. From 409a014ff0ebc1b66fb87f7a0b3f5b306b26d0e6 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sun, 18 Oct 2026 00:33:48 +0100 Subject: [PATCH 114/163] Report the progressive title RSS comparison and its limits --- docs/performance/startup-stage-3.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/performance/startup-stage-3.md b/docs/performance/startup-stage-3.md index a728da34b..330269889 100644 --- a/docs/performance/startup-stage-3.md +++ b/docs/performance/startup-stage-3.md @@ -41,3 +41,5 @@ Screenshots from these probes: - [World after the tail join](../../benchmarks/startup-stage-3-20261018/world-after-rest.png) The full parity selection against `origin/main` also includes the unmerged Stage 2 ancestors (313 harnesses). The local run was bounded at 30 minutes; its log recorded passes for `active_effects`, `active_effect_tick` and `anchor`. The remainder needs CI or a longer dedicated run. The client Rust tests, focused startup probes and memory measurements are separate from that incomplete parity run. + +Progressive-title RSS was measured separately with audio disabled, render distance 4 and a 30 FPS cap, using separate temporary game directories. The first 30-second pair measured 1,055,132 KiB before and 1,721,772 KiB after. A warm 60-second repeat in reverse order measured 1,031,948 KiB before and 1,145,776 KiB after: an increase of 113,828 KiB (about 111 MiB, 11%). These launches ran during compilation and did not advance through startup/streaming identically. They establish a memory cost to investigate, not a claim of RSS parity; a quiet-machine cold/warm comparison remains needed before merging the stack. From 3a474c2060ecf736ea40a2d370c7e27db12bfda7 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 16:20:32 +0200 Subject: [PATCH 115/163] Launcher: rustfmt modpacks.rs Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- launcher/src/modpacks.rs | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/launcher/src/modpacks.rs b/launcher/src/modpacks.rs index 6ff53e4be..b69ff0976 100644 --- a/launcher/src/modpacks.rs +++ b/launcher/src/modpacks.rs @@ -241,8 +241,14 @@ mod tests { .map(|a| a.to_string_lossy().into_owned()) .collect(); assert_eq!(args.len(), 4); - assert_eq!(Path::new(&args[1]), work.join("mods").join("a").join("carry")); - assert_eq!(Path::new(&args[3]), work.join("mods").join("b").join("carry")); + assert_eq!( + Path::new(&args[1]), + work.join("mods").join("a").join("carry") + ); + assert_eq!( + Path::new(&args[3]), + work.join("mods").join("b").join("carry") + ); assert_eq!(cmd.get_current_dir(), Some(profile_home(&work).as_path())); assert!(profile_home(&work).is_dir()); fs::remove_dir_all(&root).unwrap(); From 60bc15a63ede1a7ca624ea8921eb6d32fc37463e Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 16:28:48 +0200 Subject: [PATCH 116/163] Run the agent's commands, give and time on the server thread With single player on its server thread, the window is a client of the server. The agent's `command` went out as the owner's chat and returned no output, so harnesses that read a command's feedback (lan_e2e trials) failed. Control `give` and `time` changed only the window's copy of the world. The server now runs them as single player's console does without a server thread (`as_console`): as the world's owner, in the owner's level. The feedback goes to the owner's chat and comes back to the agent. `give` runs `give @s`, and `time` sets the server's clock too. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game/agent.rs | 7 +++ crates/horizon-client/src/game/control.rs | 17 +++++- crates/horizon-client/src/game/integrated.rs | 54 ++++++++++++++++++++ 3 files changed, 77 insertions(+), 1 deletion(-) diff --git a/crates/horizon-client/src/game/agent.rs b/crates/horizon-client/src/game/agent.rs index b11fdd552..9f8aa77cf 100644 --- a/crates/horizon-client/src/game/agent.rs +++ b/crates/horizon-client/src/game/agent.rs @@ -1534,6 +1534,13 @@ impl Game<'_> { return Err("command TEXT".into()); } let command = format!("/{text}"); + // Single player's console is its server thread's. + if let Some(server) = &self.integrated { + let chat = server + .call(move |g| g.owner_console_command(&command)) + .ok_or("the integrated server stopped")?; + return ok(json!({ "ok": true, "chat": chat })); + } if self.remote.is_some() { self.send_chat(&command); return ok(json!({ "ok": true })); diff --git a/crates/horizon-client/src/game/control.rs b/crates/horizon-client/src/game/control.rs index 6827d49c9..5f7bf6fb3 100644 --- a/crates/horizon-client/src/game/control.rs +++ b/crates/horizon-client/src/game/control.rs @@ -349,6 +349,14 @@ impl Game<'_> { .get(&item) .ok_or_else(|| format!("unknown item {item}"))?; let count: u32 = words.get(2).map_or(Ok(1), |c| c.parse())?; + // Single player's inventory is its server thread's player's. + if let Some(server) = &self.integrated { + let command = format!("give @s {item} {count}"); + server + .call(move |g| g.owner_console_command(&command)) + .ok_or("the integrated server stopped")?; + return Ok(Some(json!({ "ok": true, "given": count }))); + } let max = info.max_stack; let mut given = 0; // Stop once the inventory is full. @@ -379,7 +387,14 @@ impl Game<'_> { ok() } "time" => { - self.world.day_time = arg(1)?.parse()?; + let time: i64 = arg(1)?.parse()?; + self.world.day_time = time; + // Single player's clock is its server thread's. + if let Some(server) = &self.integrated { + server + .call(move |g| g.world.day_time = time) + .ok_or("the integrated server stopped")?; + } ok() } "summon" => { diff --git a/crates/horizon-client/src/game/integrated.rs b/crates/horizon-client/src/game/integrated.rs index b2c0a2e7f..c2d2a0a76 100644 --- a/crates/horizon-client/src/game/integrated.rs +++ b/crates/horizon-client/src/game/integrated.rs @@ -409,6 +409,60 @@ impl Game<'_> { pub(super) fn serving(&self) -> bool { self.serving.is_some() } + /// The window's agent runs a command as single player's console does + /// (`as_console`, as without a server thread): as the world's owner, in + /// the owner's level, at the owner permission level. The feedback goes to + /// the owner's chat and is returned. + pub(super) fn owner_console_command(&mut self, command: &str) -> Vec<String> { + let Some(owner) = self.serving.as_ref().map(|s| s.owner) else { + return Vec::new(); + }; + let Some(mut host) = self.lan.take() else { + return Vec::new(); + }; + let mut out = Vec::new(); + if let Some(g) = host.hub.guests.iter().find(|g| g.uuid == owner && g.placed) { + let conn = g.conn; + // Commands.performCommand runs in the player's level. + let (back, theirs) = (self.dim, super::Dim::from_id(&g.dimension)); + let entered = theirs == back || self.enter_level(Some(&mut host), theirs).is_ok(); + if entered { + let command = command.trim_start_matches('/').to_owned(); + let lines = self.as_guest(&mut host, conn, |g| { + g.as_console(|g| { + g.chat_capture = Some(Vec::new()); + g.run_command(&command); + g.chat_capture.take().unwrap_or_default() + }) + }); + // A teleport into another level happens before its feedback is sent. + self.run_level_teleports(&mut host); + for line in lines.unwrap_or_default() { + out.push(line.plain()); + host.hub.send_to( + conn, + &horizon_protocol::packets::play::Clientbound::SystemChat( + horizon_protocol::packets::play::SystemChat { + content: horizon_client::lan::data::component_nbt( + &line.component(), + ), + overlay: false, + }, + ), + ); + } + self.send_admin_feedback(&mut host, Some(conn)); + } + if theirs != back + && let Err(e) = self.enter_level(Some(&mut host), back) + { + log::error!("could not reopen {}: {e}", back.id()); + } + } + self.lan = Some(host); + out + } + /// The window's requests, between two ticks. fn run_tasks(&mut self) { let tasks: Vec<Task> = match &self.serving { From ae3622eb92c7b0f7adc10fe5d47c91f1ae419e1e Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 15:06:41 +0200 Subject: [PATCH 117/163] Processors: read rule ids without a namespace, as vanilla does A rule processor's position predicate and block entity modifier types are identifiers: vanilla reads "always_true" as minecraft:always_true. Horizon matched the full string, so a list writing the short form failed, and with it every pool naming the list. ChoiceTheorem's Overhauled Village writes "always_true" in four village pools (plains, plains fortified, halloween), whose houses then never generated. The two decoders move out of Rule's decode into PosRule::decode and Modifier::decode, which normalize the type first. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../src/worldgen/structure/processor.rs | 142 ++++++++++++------ 1 file changed, 93 insertions(+), 49 deletions(-) diff --git a/crates/horizon-world/src/worldgen/structure/processor.rs b/crates/horizon-world/src/worldgen/structure/processor.rs index b5bf2e22f..844ff2248 100644 --- a/crates/horizon-world/src/worldgen/structure/processor.rs +++ b/crates/horizon-world/src/worldgen/structure/processor.rs @@ -57,6 +57,58 @@ enum Modifier { AppendLoot(String), AppendStatic(Compound), } +impl PosRule { + /// A rule's `position_predicate` (always true when missing). Types are + /// identifiers: `"always_true"` is `minecraft:always_true`, as vanilla + /// reads it. + fn decode(value: Option<&Value>) -> Result<Self, DecodeError> { + let Some(p) = value else { + return Ok(Self::Always); + }; + let kind = p["predicate_type"] + .as_str() + .unwrap_or("minecraft:always_true"); + Ok(match super::super::tags::identifier(kind)?.as_str() { + "minecraft:always_true" => Self::Always, + kind @ ("minecraft:linear_pos" | "minecraft:axis_aligned_linear_pos") => Self::Linear { + min_chance: p.get("min_chance").and_then(Value::as_f64).unwrap_or(0.) as f32, + max_chance: p.get("max_chance").and_then(Value::as_f64).unwrap_or(0.) as f32, + min_dist: p.get("min_dist").and_then(Value::as_i64).unwrap_or(0) as i32, + max_dist: p.get("max_dist").and_then(Value::as_i64).unwrap_or(0) as i32, + axis: (kind == "minecraft:axis_aligned_linear_pos").then(|| { + match p.get("axis").and_then(Value::as_str) { + Some("x") => 0, + Some("z") => 2, + _ => 1, + } + }), + }, + _ => return Err(DecodeError::Field("position predicate")), + }) + } +} +impl Modifier { + /// A rule's `block_entity_modifier` (passthrough when missing). + fn decode(value: Option<&Value>) -> Result<Self, DecodeError> { + let Some(m) = value else { + return Ok(Self::Passthrough); + }; + Ok( + match super::super::tags::identifier(m["type"].as_str().unwrap_or(""))?.as_str() { + "minecraft:passthrough" => Self::Passthrough, + "minecraft:clear" => Self::Clear, + "minecraft:append_loot" => { + Self::AppendLoot(m["loot_table"].as_str().unwrap_or_default().to_owned()) + } + "minecraft:append_static" => match json_to_nbt(&m["data"]) { + Tag::Compound(c) => Self::AppendStatic(c), + _ => Self::AppendStatic(Compound::new()), + }, + _ => return Err(DecodeError::Field("block entity modifier")), + }, + ) + } +} #[derive(Clone, Debug)] pub struct Rule { input: RuleTest, @@ -208,55 +260,8 @@ impl Processor { .iter() .map(|rule| { let test = |key| RuleTest::from_json(&rule[key].to_string(), bindings); - let position = match rule.get("position_predicate") { - Some(p) => match p["predicate_type"] - .as_str() - .unwrap_or("minecraft:always_true") - { - "minecraft:always_true" => PosRule::Always, - kind @ ("minecraft:linear_pos" - | "minecraft:axis_aligned_linear_pos") => PosRule::Linear { - min_chance: p - .get("min_chance") - .and_then(Value::as_f64) - .unwrap_or(0.) - as f32, - max_chance: p - .get("max_chance") - .and_then(Value::as_f64) - .unwrap_or(0.) - as f32, - min_dist: p.get("min_dist").and_then(Value::as_i64).unwrap_or(0) - as i32, - max_dist: p.get("max_dist").and_then(Value::as_i64).unwrap_or(0) - as i32, - axis: (kind == "minecraft:axis_aligned_linear_pos").then( - || match p.get("axis").and_then(Value::as_str) { - Some("x") => 0, - Some("z") => 2, - _ => 1, - }, - ), - }, - _ => return Err(DecodeError::Field("position predicate")), - }, - None => PosRule::Always, - }; - let modifier = match rule.get("block_entity_modifier") { - None => Modifier::Passthrough, - Some(m) => match m["type"].as_str().unwrap_or("") { - "minecraft:passthrough" => Modifier::Passthrough, - "minecraft:clear" => Modifier::Clear, - "minecraft:append_loot" => Modifier::AppendLoot( - m["loot_table"].as_str().unwrap_or_default().to_owned(), - ), - "minecraft:append_static" => match json_to_nbt(&m["data"]) { - Tag::Compound(c) => Modifier::AppendStatic(c), - _ => Modifier::AppendStatic(Compound::new()), - }, - _ => return Err(DecodeError::Field("block entity modifier")), - }, - }; + let position = PosRule::decode(rule.get("position_predicate"))?; + let modifier = Modifier::decode(rule.get("block_entity_modifier"))?; Ok(Rule { input: test("input_predicate")?, location: test("location_predicate")?, @@ -1021,3 +1026,42 @@ fn update_shape_at_edge<W: PlacementContext>( } Ok(()) } + +#[cfg(test)] +mod tests { + use super::*; + use serde_json::json; + + #[test] + fn rule_parts_read_ids_without_a_namespace() { + // CTOV writes "always_true"; vanilla reads it as minecraft:always_true. + for kind in ["always_true", "minecraft:always_true"] { + let p = json!({"predicate_type": kind}); + assert!( + matches!(PosRule::decode(Some(&p)), Ok(PosRule::Always)), + "{kind}" + ); + } + let linear = json!({"predicate_type": "axis_aligned_linear_pos", "axis": "z", + "min_chance": 0.1, "max_dist": 8}); + assert!(matches!( + PosRule::decode(Some(&linear)), + Ok(PosRule::Linear { + axis: Some(2), + max_dist: 8, + .. + }) + )); + assert!(PosRule::decode(Some(&json!({"predicate_type": "x:unknown"}))).is_err()); + assert!(matches!(PosRule::decode(None), Ok(PosRule::Always))); + let loot = json!({"type": "append_loot", "loot_table": "minecraft:chests/x"}); + assert!( + matches!(Modifier::decode(Some(&loot)), Ok(Modifier::AppendLoot(t)) if t == "minecraft:chests/x") + ); + assert!(matches!( + Modifier::decode(Some(&json!({"type": "clear"}))), + Ok(Modifier::Clear) + )); + assert!(Modifier::decode(Some(&json!({"type": ""}))).is_err()); + } +} From 2ebc1c44b33c153cc6140b8c353bbff1c00af9d4 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 15:08:48 +0200 Subject: [PATCH 118/163] Structures: horizon:spawner_mobs, the mods' spawner randomizing processors Moog's Structure Lib and Repurposed Structures register a spawner randomizing processor in Java: each spawner of the template gets one mob of a weighted list, picked with settings.getRandom(pos).nextFloat(), and the spawner NBT they write (Delay ... SpawnRange as shorts, the mob as the only potential and the next spawn, optional custom spawn rules). With nothing to pick the spawner becomes the replacement block. horizon:spawner_mobs does the same from data; horizon-port-pack writes it in place of theirs. Without it carry drops the processors, and Moog's templates keep their spawners empty. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../src/worldgen/structure/processor.rs | 218 ++++++++++++++++++ 1 file changed, 218 insertions(+) diff --git a/crates/horizon-world/src/worldgen/structure/processor.rs b/crates/horizon-world/src/worldgen/structure/processor.rs index 844ff2248..76e1a4cd1 100644 --- a/crates/horizon-world/src/worldgen/structure/processor.rs +++ b/crates/horizon-world/src/worldgen/structure/processor.rs @@ -139,10 +139,119 @@ pub enum Processor { BlockAge(f32), LavaSubmerged, BlackstoneReplace, + SpawnerMobs(Box<SpawnerMobs>), } #[derive(Clone, Debug, Default)] pub struct ProcessorList(pub Vec<Processor>); +/// The spawner fields `horizon:spawner_mobs` writes: its JSON key, the NBT +/// key and the default (BaseSpawner's). +const SPAWNER_FIELDS: [(&str, &str, i16); 7] = [ + ("delay", "Delay", 20), + ("min_spawn_delay", "MinSpawnDelay", 200), + ("max_spawn_delay", "MaxSpawnDelay", 800), + ("spawn_count", "SpawnCount", 4), + ("max_nearby_entities", "MaxNearbyEntities", 6), + ("required_player_range", "RequiredPlayerRange", 16), + ("spawn_range", "SpawnRange", 4), +]; + +/// `horizon:spawner_mobs`, which `horizon-port-pack` writes for the spawner +/// randomizing processors of Moog's Structure Lib and Repurposed Structures +/// (Java code in the mods): a spawner gets one mob of a weighted list, +/// picked with `settings.getRandom(pos).nextFloat()` as theirs do, and the +/// spawner NBT they write. With no mob to pick it becomes `replacement`. +#[derive(Clone, Debug)] +pub struct SpawnerMobs { + /// Each mob's entity compound (its `id` and any NBT) and weight. + mobs: Vec<(Compound, f64)>, + /// [`SPAWNER_FIELDS`]' values. + fields: [i16; 7], + /// `custom_spawn_rules`, in `SpawnData` and the potential alike. + rules: Option<Compound>, + replacement: BlockStateId, +} +impl SpawnerMobs { + fn decode( + value: &Value, + replacement: impl FnOnce(Option<&Value>) -> Result<BlockStateId, DecodeError>, + ) -> Result<Self, DecodeError> { + let mobs = value["mobs"] + .as_array() + .ok_or(DecodeError::Field("spawner_mobs mobs"))? + .iter() + .map( + |m| match (json_to_nbt(&m["entity"]), m["weight"].as_f64()) { + (Tag::Compound(entity), Some(weight)) + if entity.contains_key(&JavaString::from("id")) => + { + Ok((entity, weight)) + } + _ => Err(DecodeError::Field("spawner_mobs mob")), + }, + ) + .collect::<Result<_, _>>()?; + let mut fields = [0; 7]; + for (field, (key, _, default)) in fields.iter_mut().zip(SPAWNER_FIELDS) { + // The mods' codecs read ints; the spawner saves them as shorts. + *field = value + .get(key) + .map_or(Some(default), |v| v.as_i64().map(|v| v as i16)) + .ok_or(DecodeError::Field("spawner_mobs field"))?; + } + let rules = match value.get("custom_spawn_rules").map(json_to_nbt) { + None => None, + Some(Tag::Compound(c)) => Some(c), + Some(_) => return Err(DecodeError::Field("spawner_mobs custom_spawn_rules")), + }; + Ok(Self { + mobs, + fields, + rules, + replacement: replacement(value.get("replacement"))?, + }) + } + /// The mob for a spawner, drawing from `random` only when there is one + /// to pick (pickWeightedRandom; Repurposed Structures' getSpawnerMob, + /// whose float product can round differently only on a boundary). + fn pick(&self, random: impl FnOnce() -> f32) -> Option<&Compound> { + let total: f64 = self.mobs.iter().map(|m| m.1).sum(); + if self.mobs.is_empty() || total <= 0. { + return None; + } + let mut pick = f64::from(random()) * total; + for (entity, weight) in &self.mobs { + pick -= weight; + if pick <= 0. { + return Some(entity); + } + } + self.mobs.last().map(|m| &m.0) + } + /// The spawner's NBT with `entity` as its only potential and next spawn. + fn nbt(&self, entity: &Compound) -> Compound { + let mut data = Compound::new(); + data.insert("entity".into(), Tag::Compound(entity.clone())); + if let Some(rules) = &self.rules { + data.insert("custom_spawn_rules".into(), Tag::Compound(rules.clone())); + } + let mut potential = Compound::new(); + potential.insert("data".into(), Tag::Compound(data.clone())); + potential.insert("weight".into(), Tag::Int(1)); + let mut nbt: Compound = SPAWNER_FIELDS + .iter() + .zip(self.fields) + .map(|((_, key, _), v)| (JavaString::from(*key), Tag::Short(v))) + .collect(); + nbt.insert( + "SpawnPotentials".into(), + Tag::List(vec![Tag::Compound(potential)]), + ); + nbt.insert("SpawnData".into(), Tag::Compound(data)); + nbt + } +} + fn holder_set( value: &Value, bindings: &FeatureBlockBindings<'_>, @@ -272,6 +381,12 @@ impl Processor { }) .collect::<Result<_, DecodeError>>()?, ), + "horizon:spawner_mobs" => { + Self::SpawnerMobs(Box::new(SpawnerMobs::decode(value, |v| match v { + Some(v) => state(v), + None => Ok(resources.registry.default_state("minecraft:air").unwrap()), + })?)) + } _ => return Err(DecodeError::Field("structure processor type")), }) } @@ -537,6 +652,24 @@ fn process_block<W: PlacementContext>( Some(info) } Processor::Capped { .. } => Some(info), + Processor::SpawnerMobs(spawner) => { + if name(info.state) != "minecraft:spawner" { + return Ok(Some(info)); + } + let pos = info.pos; + let entity = spawner.pick(|| settings.with_random(pos, |r| r.float())); + Some(match entity { + Some(entity) => BlockInfo { + nbt: Some(spawner.nbt(entity)), + ..info + }, + None => BlockInfo { + pos, + state: spawner.replacement, + nbt: None, + }, + }) + } }) } fn block_age( @@ -1032,6 +1165,91 @@ mod tests { use super::*; use serde_json::json; + fn spawner(value: Value) -> SpawnerMobs { + SpawnerMobs::decode(&value, |v| { + assert_eq!(v, Some(&json!({"id": "minecraft:cobblestone"}))); + Ok(BlockStateId(7)) + }) + .unwrap() + } + fn id(entity: Option<&Compound>) -> Option<String> { + match entity?.get(&JavaString::from("id")) { + Some(Tag::String(s)) => Some(s.to_string_lossy()), + _ => None, + } + } + + #[test] + fn spawner_mobs_pick_by_weight() { + let s = spawner(json!({ + "mobs": [ + {"entity": {"id": "minecraft:zombie"}, "weight": 1}, + {"entity": {"id": "minecraft:husk"}, "weight": 3}], + "replacement": {"id": "minecraft:cobblestone"}})); + // pick = nextFloat * 4, less each weight in turn, until <= 0. + for (r, mob) in [ + (0., "zombie"), + (0.25, "zombie"), + (0.2501, "husk"), + (0.999, "husk"), + ] { + assert_eq!(id(s.pick(|| r)), Some(format!("minecraft:{mob}")), "{r}"); + } + let empty = spawner(json!({"mobs": [], "replacement": {"id": "minecraft:cobblestone"}})); + assert_eq!(empty.pick(|| unreachable!()), None); + assert_eq!(empty.replacement, BlockStateId(7)); + } + + #[test] + fn spawner_mobs_write_the_mods_nbt() { + let s = spawner(json!({ + "mobs": [{"entity": {"id": "minecraft:skeleton", "Health": 30}, "weight": 2}], + "delay": 10, "spawn_count": 2, + "custom_spawn_rules": {"block_light_limit": {"min_inclusive": 0, "max_inclusive": 7}}, + "replacement": {"id": "minecraft:cobblestone"}})); + let nbt = s.nbt(s.pick(|| 0.5).unwrap()); + let short = |k: &str| nbt.get(&JavaString::from(k)).cloned(); + for (k, v) in [ + ("Delay", 10), + ("MinSpawnDelay", 200), + ("MaxSpawnDelay", 800), + ("SpawnCount", 2), + ("MaxNearbyEntities", 6), + ("RequiredPlayerRange", 16), + ("SpawnRange", 4), + ] { + assert_eq!(short(k), Some(Tag::Short(v)), "{k}"); + } + let Some(Tag::Compound(data)) = short("SpawnData") else { + panic!("SpawnData") + }; + assert!(data.contains_key(&JavaString::from("custom_spawn_rules"))); + let Some(Tag::Compound(entity)) = data.get(&JavaString::from("entity")) else { + panic!("entity") + }; + assert_eq!(entity.get(&JavaString::from("Health")), Some(&Tag::Int(30))); + let Some(Tag::List(potentials)) = short("SpawnPotentials") else { + panic!("SpawnPotentials") + }; + let Tag::Compound(potential) = &potentials[0] else { + panic!("potential") + }; + assert_eq!( + potential.get(&JavaString::from("weight")), + Some(&Tag::Int(1)) + ); + assert_eq!( + potential.get(&JavaString::from("data")), + Some(&Tag::Compound(data.clone())) + ); + } + + #[test] + fn spawner_mobs_refuse_a_mob_without_an_id() { + let bad = json!({"mobs": [{"entity": {}, "weight": 1}]}); + assert!(SpawnerMobs::decode(&bad, |_| Ok(BlockStateId(0))).is_err()); + } + #[test] fn rule_parts_read_ids_without_a_namespace() { // CTOV writes "always_true"; vanilla reads it as minecraft:always_true. From db13bd7df5a0805af298a9083b4506c9f4d46273 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 15:44:32 +0200 Subject: [PATCH 119/163] Carry: the structure mods' spawner processors, as data the game runs Carry used to take every processor written in Java out of its list (#822), so spawners kept what the template has: an empty spawner in Moog's templates, a placeholder pig in Better Dungeons'. The new processors module rewrites the ones with a data form before that: - Moog's Structure Lib's and Repurposed Structures' spawner randomizing processors become horizon:spawner_mobs, with Repurposed's rs_spawners list written in (weight-0 entries left out, as its loader does); - YUNG's Better Dungeons and Better Desert Temples spawner processors (a spawner or a placeholder block becomes a spawner of a fixed mob) become vanilla's rule processor with an append_static block entity, the entity in 26.3's shape (equipment, drop_chances); - Moog's vanilla loot swap is a no-op while its "replace vanilla" preset is off, as they ship, and is taken out. Each is counted in carry-report.json's processors_carried. The game's own horizon: types stay in the lists. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/carry.rs | 16 +- crates/horizon-port-pack/src/lib.rs | 1 + crates/horizon-port-pack/src/processors.rs | 505 +++++++++++++++++++++ crates/horizon-port-pack/src/worldgen.rs | 44 +- docs/modpacks.md | 22 +- 5 files changed, 551 insertions(+), 37 deletions(-) create mode 100644 crates/horizon-port-pack/src/processors.rs diff --git a/crates/horizon-port-pack/src/carry.rs b/crates/horizon-port-pack/src/carry.rs index bfd0bcad5..b342f45fd 100644 --- a/crates/horizon-port-pack/src/carry.rs +++ b/crates/horizon-port-pack/src/carry.rs @@ -367,6 +367,7 @@ pub fn carry( let mut biome_conventions = BTreeSet::new(); let set_tags = crate::worldgen::structure_set_tags(&mut zip); let piece_counts = crate::worldgen::piece_counts(&mut zip); + let processor_data = crate::processors::ProcessorData::read(&mut zip); for i in 0..zip.len() { let mut entry = zip.by_index(i).map_err(|e| e.to_string())?; let name = entry.name().to_owned(); @@ -426,12 +427,15 @@ pub fn carry( if kind == "structure" { crate::worldgen::convention_tags(&v["biomes"], &mut biome_conventions); } - let mut changed = crate::worldgen::upgrade( + let types = &mut report.worldgen_types; + let carried = crate::processors::carry( kind, &mut v, - &mut report.worldgen_types, - &set_tags, + &processor_data, + &mut types.processors_carried, ); + let mut changed = + crate::worldgen::upgrade(kind, &mut v, types, &set_tags) || carried; if kind == "structure" { let path = rel.trim_start_matches("worldgen/structure/"); let structure = format!("{id}:{}", path.trim_end_matches(".json")); @@ -453,6 +457,12 @@ pub fn carry( if let Some((kind, mut added)) = modifier.and_then(|v| crate::worldgen::modifier(&v, loaded, types)) { + crate::processors::carry( + kind, + &mut added, + &processor_data, + &mut types.processors_carried, + ); crate::worldgen::upgrade(kind, &mut added, types, &set_tags); let to = format!( "data/{id}/worldgen/{kind}/{}/{path}", diff --git a/crates/horizon-port-pack/src/lib.rs b/crates/horizon-port-pack/src/lib.rs index 0e678fb9a..08f9b273f 100644 --- a/crates/horizon-port-pack/src/lib.rs +++ b/crates/horizon-port-pack/src/lib.rs @@ -14,5 +14,6 @@ pub mod jar; pub mod modrinth; pub mod oracle; pub mod pipeline; +pub mod processors; pub mod report; pub mod worldgen; diff --git a/crates/horizon-port-pack/src/processors.rs b/crates/horizon-port-pack/src/processors.rs new file mode 100644 index 000000000..7fcc0fd94 --- /dev/null +++ b/crates/horizon-port-pack/src/processors.rs @@ -0,0 +1,505 @@ +//! Structure processors the structure libraries write in Java, carried over +//! as data the game runs: the ones that give spawners their mob. +//! +//! - Moog's Structure Lib's and Repurposed Structures' spawner randomizing +//! processors pick a mob from a weighted list for each spawner. They become +//! `horizon:spawner_mobs` (`horizon_world::worldgen::structure::processor`), +//! with Repurposed's `rs_spawners` list written in. +//! - YUNG's Better Dungeons and Better Desert Temples turn a spawner or a +//! placeholder block into a spawner of a fixed mob. That is vanilla's `rule` +//! processor with an `append_static` block entity. +//! - Moog's vanilla loot swap only acts when its mod's "replace vanilla" +//! preset is on; one that ships off is a no-op and is taken out. +//! +//! What is not here is taken out of its list later and counted +//! (`worldgen::upgrade`). The entity NBT is written in 26.3's shape (an +//! `equipment` map, not 1.21.1's `HandItems` and `ArmorItems`). +use serde_json::{Value, json}; +use std::{ + collections::{BTreeMap, BTreeSet}, + io::{Read, Seek}, +}; + +/// What the processors read from the mod's own data files. +#[derive(Debug, Default)] +pub struct ProcessorData { + /// Repurposed Structures' `rs_spawners/<path>.json` by id: each mob and + /// its weight, without the weight-0 entries its loader removes. + pub spawners: BTreeMap<String, Vec<(String, f64)>>, + /// Moog's "replace vanilla" presets that are on by default: + /// `(mod id, vanilla_key)`. + pub replace_vanilla: BTreeSet<(String, String)>, +} + +impl ProcessorData { + pub fn read<R: Read + Seek>(zip: &mut zip::ZipArchive<R>) -> Self { + let mut out = Self::default(); + for i in 0..zip.len() { + let Ok(mut entry) = zip.by_index(i) else { + continue; + }; + let name = entry.name().to_owned(); + let Some((ns, rest)) = name + .strip_prefix("data/") + .and_then(|r| r.strip_suffix(".json")) + .and_then(|r| r.split_once('/')) + else { + continue; + }; + let spawners = rest.strip_prefix("rs_spawners/"); + if spawners.is_none() && rest != "moogs_structures/replace_vanilla" { + continue; + } + let mut text = String::new(); + let Ok(v) = entry + .read_to_string(&mut text) + .map_err(|_| ()) + .and_then(|_| serde_json::from_str::<Value>(&text).map_err(|_| ())) + else { + continue; + }; + if let Some(path) = spawners { + let mobs = v["mobs"] + .as_array() + .into_iter() + .flatten() + .filter_map(|m| Some((m["name"].as_str()?.to_owned(), m["weight"].as_f64()?))) + .filter(|(_, w)| *w != 0.) + .collect(); + out.spawners.insert(format!("{ns}:{path}"), mobs); + continue; + } + for preset in v["presets"].as_array().into_iter().flatten() { + if preset["default_enabled"].as_bool() != Some(true) { + continue; + } + for r in preset["replacements"].as_array().into_iter().flatten() { + if let Some(key) = r["vanilla_key"].as_str() { + out.replace_vanilla.insert((ns.to_owned(), key.to_owned())); + } + } + } + } + out + } +} + +/// Calls `f` on each processor list in a worldgen file: a `processor_list` +/// file, and the inline lists of a template pool's elements (list elements +/// included). Whether any call changed something. +pub fn each_list(kind: &str, v: &mut Value, f: &mut dyn FnMut(&mut Value) -> bool) -> bool { + match kind { + "processor_list" => f(v), + "template_pool" => { + let mut changed = false; + for e in v["elements"].as_array_mut().into_iter().flatten() { + let element = &mut e["element"]; + if let Some(list) = element.get_mut("elements").and_then(Value::as_array_mut) { + for inner in list { + if let Some(p) = inner.get_mut("processors") { + changed |= f(p); + } + } + } else if let Some(p) = element.get_mut("processors") { + changed |= f(p); + } + } + changed + } + _ => false, + } +} + +/// The processors of a list: `{"processors": [...]}` or a bare list (an id +/// names another file and is left alone). +pub fn processors(list: &mut Value) -> Option<&mut Vec<Value>> { + match list { + Value::Array(a) => Some(a), + Value::Object(o) => o.get_mut("processors").and_then(Value::as_array_mut), + _ => None, + } +} + +/// Rewrites the processors of a worldgen file that have a data form; each is +/// counted by type in `carried`. Whether anything changed. +pub fn carry( + kind: &str, + v: &mut Value, + data: &ProcessorData, + carried: &mut BTreeMap<String, usize>, +) -> bool { + each_list(kind, v, &mut |list| { + let Some(list) = processors(list) else { + return false; + }; + let mut changed = false; + let mut out = Vec::with_capacity(list.len()); + for p in list.drain(..) { + let kind = p["processor_type"].as_str().unwrap_or_default().to_owned(); + match as_data(&kind, &p, data) { + Some(replacement) => { + *carried.entry(kind).or_default() += 1; + out.extend(replacement); + changed = true; + } + None => out.push(p), + } + } + *list = out; + changed + }) +} + +/// The data form of a Java processor: the processors to put in its place +/// (none for a no-op), or `None` when it has none. +fn as_data(kind: &str, p: &Value, data: &ProcessorData) -> Option<Vec<Value>> { + let (ns, _) = kind.split_once(':')?; + Some(match kind { + "moogs_structures:spawner_randomizing_processor" => { + let mobs = p["weighted_entities"] + .as_array()? + .iter() + .map(|e| { + // The entry's NBT, then its id over it. + let mut entity = match &e["nbt"] { + Value::Object(o) => o.clone(), + _ => serde_json::Map::new(), + }; + entity.insert("id".into(), e["entity"].as_str()?.into()); + Some(json!({"entity": entity, "weight": e["weight"].as_f64()?})) + }) + .collect::<Option<Vec<_>>>()?; + vec![spawner_mobs(p, mobs, None)] + } + "repurposed_structures:spawner_randomizing_processor" => { + // A list the mod does not ship falls back to a vanilla dungeon + // mob in the mod; left out here. + let list = data + .spawners + .get(p["rs_spawner_resourcelocation"].as_str()?)?; + let mobs = list + .iter() + .map(|(id, weight)| json!({"entity": {"id": id}, "weight": weight})) + .collect(); + vec![spawner_mobs(p, mobs, repurposed_light(p)?)] + } + "moogs_structures:vanilla_loot_swap_processor" => { + let key = ( + p["modid"].as_str()?.to_owned(), + p["vanilla_key"].as_str()?.to_owned(), + ); + if data.replace_vanilla.contains(&key) { + return None; + } + Vec::new() + } + _ if ns == "betterdungeons" || ns == "betterdeserttemples" => vec![yung_spawner(kind, p)?], + _ => return None, + }) +} + +/// [`as_data`]'s `horizon:spawner_mobs` for the mods' spawner randomizing +/// processors, whose fields have the same names and defaults. +fn spawner_mobs(p: &Value, mobs: Vec<Value>, rules: Option<Value>) -> Value { + let mut out = json!({"processor_type": "horizon:spawner_mobs", "mobs": mobs}); + for key in [ + "delay", + "min_spawn_delay", + "max_spawn_delay", + "spawn_count", + "max_nearby_entities", + "required_player_range", + "spawn_range", + ] { + if let Some(n) = p.get(key).filter(|n| n.is_i64()) { + out[key] = n.clone(); + } + } + if let Some(r) = rules { + out["custom_spawn_rules"] = r; + } + if let Some(b) = p.get("spawner_replacement_block") { + out["replacement"] = b.clone(); + } + out +} + +/// Repurposed Structures' `custom_spawn_rules` from its light level ranges: +/// `Some(None)` without either, `None` when one does not read. The sky +/// light's upper bound is written as `max_exclusive`, as the mod does. +fn repurposed_light(p: &Value) -> Option<Option<Value>> { + let range = |key: &str| -> Option<Option<(i64, i64)>> { + match p.get(key) { + None => Some(None), + Some(Value::Number(n)) => n.as_i64().map(|n| Some((n, n))), + Some(v) => Some(Some(( + v["min_inclusive"].as_i64()?, + v["max_inclusive"].as_i64()?, + ))), + } + }; + let (block, sky) = ( + range("valid_block_light_level")?, + range("valid_sky_light_level")?, + ); + if block.is_none() && sky.is_none() { + return Some(None); + } + let mut rules = json!({}); + if let Some((min, max)) = block { + rules["block_light_limit"] = json!({"min_inclusive": min, "max_inclusive": max}); + } + if let Some((min, max)) = sky { + rules["sky_light_limit"] = json!({"min_inclusive": min, "max_exclusive": max}); + } + Some(Some(rules)) +} + +/// An item as 26.3 saves it. +fn item(id: &str) -> Value { + json!({"id": format!("minecraft:{id}"), "count": 1}) +} + +/// YUNG's processors that make a spawner of a fixed mob (YUNG's API's +/// `MobSpawnerData`), as vanilla's `rule`: every `input` block becomes a +/// spawner with that NBT. +fn yung_spawner(kind: &str, p: &Value) -> Option<Value> { + const SPAWNER: &str = "minecraft:spawner"; + // (input block, mob, fields other than the defaults, whether the mob is + // also the only potential, its equipment) + let (input, mob, fields, potential, equipment): (_, _, &[(&str, i64)], _, _) = match kind { + "betterdungeons:mob_spawner_processor" => { + (SPAWNER, p["spawner_mob"].as_str()?, &[], true, None) + } + "betterdungeons:zombie_mob_spawner_processor" => ( + SPAWNER, + "minecraft:zombie", + &[("MaxNearbyEntities", 8)], + true, + None, + ), + "betterdungeons:skeleton_mob_spawner_processor" => ( + SPAWNER, + "minecraft:skeleton", + &[ + ("RequiredPlayerRange", 18), + ("MaxNearbyEntities", 8), + ("MaxSpawnDelay", 650), + ], + true, + None, + ), + "betterdungeons:small_nether_dungeon_mob_spawner_processor" => { + let mob = p["spawner_mob"].as_str()?; + // Wither skeletons get netherite armor that never drops and a + // stone sword (with the mod's default config, they and blazes + // keep their loot). + let armor = (mob == "minecraft:wither_skeleton").then(|| { + json!({ + "equipment": { + "feet": item("netherite_boots"), + "legs": item("netherite_leggings"), + "chest": item("netherite_chestplate"), + "head": item("netherite_helmet"), + "mainhand": item("stone_sword"), + }, + "drop_chances": {"feet": 0.0, "legs": 0.0, "chest": 0.0, "head": 0.0}, + }) + }); + (SPAWNER, mob, &[], true, armor) + } + "betterdungeons:zombie_tombstone_spawner_processor" => ( + "minecraft:black_stained_glass", + "minecraft:skeleton", + &[], + false, + Some(json!({"equipment": {"mainhand": item("iron_sword")}})), + ), + "betterdeserttemples:gravel_processor" => ( + "minecraft:gravel", + "minecraft:husk", + &[("MaxNearbyEntities", 8), ("RequiredPlayerRange", 24)], + false, + None, + ), + // An empty hand list in 1.21.1: the skeletons spawn without a bow, + // since a spawn entry with more than its id is not finalized. + "betterdeserttemples:bone_block_processor" => ( + "minecraft:bone_block", + "minecraft:skeleton", + &[("RequiredPlayerRange", 32)], + false, + Some(json!({"equipment": {}})), + ), + "betterdeserttemples:infested_cracked_stone_bricks_processor" => ( + "minecraft:infested_cracked_stone_bricks", + "minecraft:silverfish", + &[("RequiredPlayerRange", 24)], + false, + None, + ), + // 1.21.1 ignores the items' old `Count` and `tag` (the shield's + // pattern, the boots' dye): plain items. + "betterdeserttemples:yellow_wool_processor" => ( + "minecraft:yellow_wool", + "minecraft:husk", + &[("MaxNearbyEntities", 8), ("RequiredPlayerRange", 24)], + false, + Some(json!({"equipment": { + "mainhand": item("golden_sword"), + "offhand": item("shield"), + "feet": item("leather_boots"), + "legs": item("leather_leggings"), + "chest": item("golden_chestplate"), + "head": item("chainmail_helmet"), + }})), + ), + _ => return None, + }; + let mut entity = json!({"id": mob}); + if let Some(Value::Object(extra)) = equipment { + entity.as_object_mut()?.extend(extra); + } + let potentials = match potential { + true => json!([{"data": {"entity": entity.clone()}, "weight": 1}]), + false => json!([]), + }; + let mut nbt = json!({ + "Delay": 20, "MinSpawnDelay": 200, "MaxSpawnDelay": 800, "SpawnCount": 4, + "MaxNearbyEntities": 6, "RequiredPlayerRange": 16, "SpawnRange": 4, + "SpawnData": {"entity": entity}, + "SpawnPotentials": potentials, + }); + for (key, value) in fields { + nbt[*key] = (*value).into(); + } + Some(json!({ + "processor_type": "minecraft:rule", + "rules": [{ + "input_predicate": {"predicate_type": "minecraft:block_match", "block": input}, + "location_predicate": {"predicate_type": "minecraft:always_true"}, + "output_state": {"Name": SPAWNER}, + "block_entity_modifier": {"type": "minecraft:append_static", "data": nbt}, + }], + })) +} + +#[cfg(test)] +mod tests { + use super::*; + + fn data() -> ProcessorData { + let mut d = ProcessorData::default(); + d.spawners.insert( + "repurposed_structures:dungeons/badlands".into(), + vec![ + ("minecraft:husk".into(), 10.), + ("minecraft:cave_spider".into(), 3.), + ], + ); + d.replace_vanilla.insert(("mvs".into(), "village".into())); + d + } + + #[test] + fn spawner_processors_become_data() { + let mut list = json!({"processors": [ + {"processor_type": "moogs_structures:spawner_randomizing_processor", + "weighted_entities": [{"entity": "minecraft:blaze", "weight": 2, "nbt": {"Health": 5}}], + "spawn_count": 2, "spawner_replacement_block": {"Name": "minecraft:stone"}}, + {"processor_type": "repurposed_structures:spawner_randomizing_processor", + "rs_spawner_resourcelocation": "repurposed_structures:dungeons/badlands", + "valid_block_light_level": {"min_inclusive": 0, "max_inclusive": 7}}, + {"processor_type": "repurposed_structures:spawner_randomizing_processor", + "rs_spawner_resourcelocation": "repurposed_structures:missing"}, + {"processor_type": "minecraft:gravity", "heightmap": "WORLD_SURFACE_WG", "offset": 0}, + {"processor_type": "moogs_structures:vanilla_loot_swap_processor", + "modid": "mns", "vanilla_key": "fortress", "loot_table_mapping": {}}, + {"processor_type": "moogs_structures:vanilla_loot_swap_processor", + "modid": "mvs", "vanilla_key": "village", "loot_table_mapping": {}}]}); + let mut carried = BTreeMap::new(); + assert!(carry("processor_list", &mut list, &data(), &mut carried)); + let p = list["processors"].as_array().unwrap(); + assert_eq!(p.len(), 5, "{p:#?}"); + assert_eq!( + p[0], + json!({"processor_type": "horizon:spawner_mobs", + "mobs": [{"entity": {"Health": 5, "id": "minecraft:blaze"}, "weight": 2.0}], + "spawn_count": 2, "replacement": {"Name": "minecraft:stone"}}) + ); + assert_eq!( + p[1], + json!({"processor_type": "horizon:spawner_mobs", + "mobs": [{"entity": {"id": "minecraft:husk"}, "weight": 10.0}, + {"entity": {"id": "minecraft:cave_spider"}, "weight": 3.0}], + "custom_spawn_rules": {"block_light_limit": {"min_inclusive": 0, "max_inclusive": 7}}}) + ); + // Unknown list, vanilla processor, and a swap whose preset is on: kept + // (the Java ones are dropped later); the swap that is off is gone. + assert_eq!( + p[2]["rs_spawner_resourcelocation"], + "repurposed_structures:missing" + ); + assert_eq!(p[3]["processor_type"], "minecraft:gravity"); + assert_eq!(p[4]["modid"], "mvs"); + assert_eq!( + carried, + BTreeMap::from([ + ("moogs_structures:spawner_randomizing_processor".into(), 1), + ("moogs_structures:vanilla_loot_swap_processor".into(), 1), + ( + "repurposed_structures:spawner_randomizing_processor".into(), + 1 + ), + ]) + ); + } + + #[test] + fn yungs_spawners_become_rules() { + let mut pool = json!({"elements": [{"element": {"processors": {"processors": [ + {"processor_type": "betterdungeons:skeleton_mob_spawner_processor"}, + {"processor_type": "betterdeserttemples:bone_block_processor"}, + {"processor_type": "betterdungeons:small_nether_dungeon_mob_spawner_processor", + "spawner_mob": "minecraft:wither_skeleton"}, + {"processor_type": "betterdungeons:candle_processor"}]}}}]}); + let mut carried = BTreeMap::new(); + assert!(carry("template_pool", &mut pool, &data(), &mut carried)); + let p = &pool["elements"][0]["element"]["processors"]["processors"]; + let rule = |i: usize| &p[i]["rules"][0]; + assert_eq!(rule(0)["input_predicate"]["block"], "minecraft:spawner"); + assert_eq!( + rule(0)["output_state"], + json!({"Name": "minecraft:spawner"}) + ); + let nbt = &rule(0)["block_entity_modifier"]["data"]; + assert_eq!( + ( + nbt["RequiredPlayerRange"].clone(), + nbt["MaxNearbyEntities"].clone() + ), + (json!(18), json!(8)) + ); + assert_eq!(nbt["MaxSpawnDelay"], 650); + assert_eq!( + nbt["SpawnPotentials"], + json!([{"data": {"entity": {"id": "minecraft:skeleton"}}, "weight": 1}]) + ); + // Bone blocks become bowless skeleton spawners with no potentials. + let bone = &rule(1)["block_entity_modifier"]["data"]; + assert_eq!(rule(1)["input_predicate"]["block"], "minecraft:bone_block"); + assert_eq!( + bone["SpawnData"], + json!({"entity": {"id": "minecraft:skeleton", "equipment": {}}}) + ); + assert_eq!(bone["SpawnPotentials"], json!([])); + let wither = &rule(2)["block_entity_modifier"]["data"]["SpawnData"]["entity"]; + assert_eq!( + wither["equipment"]["head"]["id"], + "minecraft:netherite_helmet" + ); + assert_eq!(wither["drop_chances"]["feet"], 0.0); + assert_eq!(p[3]["processor_type"], "betterdungeons:candle_processor"); + assert_eq!(carried.values().sum::<usize>(), 3); + } +} diff --git a/crates/horizon-port-pack/src/worldgen.rs b/crates/horizon-port-pack/src/worldgen.rs index dbd4fb8c6..51d1a0ce5 100644 --- a/crates/horizon-port-pack/src/worldgen.rs +++ b/crates/horizon-port-pack/src/worldgen.rs @@ -118,6 +118,9 @@ pub struct Upgrade { pub rules_lost: BTreeMap<String, usize>, /// Processors written in Java, taken out of their lists, by type. pub processors_dropped: BTreeMap<String, usize>, + /// Processors written in Java carried as data the game runs + /// ([`crate::processors`]), by type. + pub processors_carried: BTreeMap<String, usize>, /// Entries added to other structure sets and template pools /// (`horizon:add_to`), by the set or pool they join. pub added_to: BTreeMap<String, usize>, @@ -332,49 +335,28 @@ pub fn upgrade( ) -> bool { let states = block_states(v); report.block_states += usize::from(states); - let dropped = match kind { - "processor_list" => drop_java_processors(v, &mut report.processors_dropped), - "template_pool" => { - let mut changed = false; - for e in v["elements"].as_array_mut().into_iter().flatten() { - let element = &mut e["element"]; - if let Some(list) = element.get_mut("elements").and_then(Value::as_array_mut) { - for inner in list { - if let Some(p) = inner.get_mut("processors") { - changed |= drop_java_processors(p, &mut report.processors_dropped); - } - } - } else if let Some(p) = element.get_mut("processors") { - changed |= drop_java_processors(p, &mut report.processors_dropped); - } - } - changed - } - _ => false, - }; + let dropped = crate::processors::each_list(kind, v, &mut |list| { + drop_java_processors(list, &mut report.processors_dropped) + }); upgrade_types(kind, v, report, set_tags) || states || dropped } -/// Takes the processors written in Java (any type outside `minecraft:`) -/// out of a processor list: `{"processors": [...]}`, a bare list, or an id -/// (left as it is). The game, like vanilla, refuses a list holding a type it +/// Takes the processors written in Java (any type outside `minecraft:` and +/// the game's own `horizon:`) out of a processor list: `{"processors": +/// [...]}`, a bare list, or an id (left as it is). The ones with a data form +/// were rewritten before ([`crate::processors::carry`]). The game, like vanilla, refuses a list holding a type it /// does not know, and with it every pool that names the list, so without /// this the structure does not generate at all. Without them it generates /// undecorated: no pillars under it, spawners left as the template has /// them, blocks not swapped. Whether anything was taken out. fn drop_java_processors(list: &mut Value, dropped: &mut BTreeMap<String, usize>) -> bool { - let processors = match list { - Value::Array(a) => a, - Value::Object(o) => match o.get_mut("processors") { - Some(Value::Array(a)) => a, - _ => return false, - }, - _ => return false, + let Some(processors) = crate::processors::processors(list) else { + return false; }; let before = processors.len(); processors.retain(|p| { let t = p["processor_type"].as_str().unwrap_or_default(); - let java = !t.starts_with("minecraft:"); + let java = !t.starts_with("minecraft:") && !t.starts_with("horizon:"); if java { *dropped.entry(t.to_owned()).or_default() += 1; } diff --git a/docs/modpacks.md b/docs/modpacks.md index 3dced2eee..cbb63a30f 100644 --- a/docs/modpacks.md +++ b/docs/modpacks.md @@ -438,7 +438,23 @@ Two cases the oracle fills in: list. The structures now generate undecorated (no pillars under them, spawners as the template has them); 1,427 processors of 146 types in ATM10's mods, the most common `lithostitched:block_swap`, Formations' `biome_replacements` and Repurposed Structures' - pillar, fluid and void processors. Porting the common ones is next. + pillar, fluid and void processors. + - **Spawner processors** carried as data (`horizon-port-pack/src/processors.rs`). Most + chests in the mods' templates already name their loot table; what the Java processors add + is the spawners' mobs. Moog's and Repurposed Structures' spawner randomizing processors + become `horizon:spawner_mobs` (a weighted mob per spawner, picked with the placement's + random as theirs do, and the spawner NBT they write; Repurposed's `rs_spawners` lists are + written in). YUNG's Better Dungeons and Better Desert Temples turn a spawner or a + placeholder block (gravel, bone block, yellow wool...) into a spawner of a fixed mob: that + is vanilla's `rule` processor with an `append_static` block entity. Moog's vanilla loot + swap acts only when a "replace vanilla" preset is on, and they ship off. 119 of the 1,427 + processors are carried; 1,308 are still taken out (blocks swapped, aged or propped up, + Moog's trial spawner and vault configs, YUNG's chest caps). + In the 128×128-chunk square (seed 1234), every spawner of a mod structure now has its mob: + in the Overworld 83 Better Dungeons spawners held the template's placeholder pig and 17 of + Moog's were empty (763 spawners with a mob, up from 628); in the Nether the 52 empty ones + in Moog's Nether Structures are filled (162, up from 110). Chests are unchanged: 2,777 + and 1,405 with a loot table. - **Big templates** (#838). Vanilla reads structure templates with no limit on their tag count; Horizon now does too (`nbt::Limits::templates`). Seven of ATM10's 8,962 carried templates are past the old 1,000,000-tag cap: YUNG's monument start, four When Dungeons @@ -487,8 +503,8 @@ Two cases the oracle fills in: - Repurposed's mineshafts, mansions, monuments, Nether cities and shipwrecks, Better Mineshafts and two Better Dungeons types: Java structure types; - YUNG's and Moog's enhanced terrain adaptation, YUNG's piece modifiers and dead-end pools, - and the processors written in Java (YUNG's spawners, chests, banners; 29 in Better Dungeons - alone), so these structures place their template blocks only; + and the block processors written in Java (YUNG's banners, legs and decorations, Repurposed's + pillars and fluid fixes, Lithostitched's block swaps); - MO Structures (38; its library is only on CurseForge). With every structure PR above, the same square (seed 1234, chunks -64..63) holds 362 From f3099e83400977df3b1a4cbaf34d96ef693f0ce0 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 15:55:04 +0200 Subject: [PATCH 120/163] Start checks: Repurposed's Nether city, Nether shipwreck and End stronghold rules Repurposed Structures' city_nether, shipwreck_nether and stronghold_end types are its generic jigsaw with one more start check each. The `repurposed` key of horizon:start_checks names the check: - city_nether: no block from sea level + 20 to sea level + 45 at the corners of the eight chunks around; - shipwreck_nether: no solid, filled block in a 33x30x33 grid above the start; - stronghold_end: land at least 45 above the bottom at 70 and 35 blocks in each direction and at the start. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../src/worldgen/structure/start_checks.rs | 195 +++++++++++++++++- 1 file changed, 190 insertions(+), 5 deletions(-) diff --git a/crates/horizon-world/src/worldgen/structure/start_checks.rs b/crates/horizon-world/src/worldgen/structure/start_checks.rs index 45b991531..f182706a8 100644 --- a/crates/horizon-world/src/worldgen/structure/start_checks.rs +++ b/crates/horizon-world/src/worldgen/structure/start_checks.rs @@ -15,9 +15,15 @@ //! "terrain_radius": 1, // chunks, with terrain_range and/or min_y, max_y //! "terrain_range": 15, //! "min_y": 60, -//! "max_y": 200 +//! "max_y": 200, +//! "repurposed": "city_nether" // or "shipwreck_nether", "stronghold_end": below //! } //! ``` +//! +//! `repurposed` is the extra check of one of Repurposed Structures' jigsaw +//! types, after the others: its Nether city needs open air above the lava sea +//! in the chunks around, its Nether shipwreck open air or lava around the +//! start, and its End stronghold land around the chunk. use crate::{heightmap::HeightmapType, worldgen::biome::BiomeId}; use horizon_core::position::ChunkPos; use serde_json::Value; @@ -33,6 +39,20 @@ pub enum LiquidCheck { Lowest, } +/// The extra start check of a Repurposed Structures jigsaw type. +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub enum Repurposed { + /// CityNetherStructure: air from sea level + 20 to + 45 (or the top of + /// the noise) at the corner of each of the 8 chunks around. + CityNether, + /// ShipwreckNetherStructure: no solid block at 5×5 columns 8 apart + /// around the chunk corner, from the start height up 30 in steps of 5. + ShipwreckNether, + /// StrongholdEndStructure: land at least 45 above the bottom 35 and 70 + /// blocks away in each direction and at the chunk corner. + StrongholdEnd, +} + /// The checks of one structure; all empty for vanilla's. #[derive(Clone, Debug, Default, PartialEq, Eq)] pub struct StartChecks { @@ -42,6 +62,7 @@ pub struct StartChecks { terrain_range: Option<i32>, min_y: Option<i32>, max_y: Option<i32>, + repurposed: Option<Repurposed>, } /// The column and biome queries the checks need. @@ -53,6 +74,9 @@ pub trait CheckQueries { /// and does not block motion is a liquid. fn liquid_column(&mut self, x: i32, z: i32) -> (Vec<bool>, Vec<bool>); fn noise_biome(&mut self, quart: [i32; 3]) -> BiomeId; + fn sea_level(&self) -> i32; + /// The noise's bottom, where the columns start. + fn bottom(&self) -> i32; } impl<T: super::start::StartContext> CheckQueries for T { @@ -71,6 +95,12 @@ impl<T: super::start::StartContext> CheckQueries for T { fn noise_biome(&mut self, quart: [i32; 3]) -> BiomeId { super::start::StartContext::noise_biome(self, quart) } + fn sea_level(&self) -> i32 { + super::start::StartContext::sea_level(self) + } + fn bottom(&self) -> i32 { + self.min_y() + } } impl StartChecks { @@ -91,6 +121,12 @@ impl StartChecks { terrain_range: int("terrain_range"), min_y: int("min_y"), max_y: int("max_y"), + repurposed: match v.get("repurposed").and_then(Value::as_str) { + Some("city_nether") => Some(Repurposed::CityNether), + Some("shipwreck_nether") => Some(Repurposed::ShipwreckNether), + Some("stronghold_end") => Some(Repurposed::StrongholdEnd), + _ => None, + }, } } @@ -155,7 +191,76 @@ impl StartChecks { return false; } } - true + match self.repurposed { + Some(check) => repurposed(check, queries, chunk, y), + None => true, + } + } +} + +/// [`Repurposed`]'s checks. A noise column reads air past its ends; its +/// length is the noise's depth (GeneralUtils.getMaxTerrainLimit). +fn repurposed(check: Repurposed, queries: &mut impl CheckQueries, chunk: ChunkPos, y: i32) -> bool { + let (x0, z0) = (chunk.x * 16, chunk.z * 16); + let bottom = queries.bottom(); + let at = |column: &[bool], y: i32| { + usize::try_from(y - bottom) + .ok() + .and_then(|i| column.get(i).copied()) + .unwrap_or(false) + }; + match check { + Repurposed::CityNether => { + let sea = queries.sea_level(); + for cx in chunk.x - 1..=chunk.x + 1 { + for cz in chunk.z - 1..=chunk.z + 1 { + if (cx, cz) == (chunk.x, chunk.z) { + continue; + } + let (filled, _) = queries.liquid_column(cx << 4, cz << 4); + let top = (bottom + filled.len() as i32).min(sea + 45); + if (sea + 20..top).any(|y| at(&filled, y)) { + return false; + } + } + } + true + } + Repurposed::ShipwreckNether => { + for dx in (-16..=16).step_by(8) { + for dz in (-16..=16).step_by(8) { + let (filled, solid) = queries.liquid_column(x0 + dx, z0 + dz); + // Not air and no fluid: in a noise column, a solid block. + if (0..=30) + .step_by(5) + .any(|dy| at(&filled, y + dy) && at(&solid, y + dy)) + { + return false; + } + } + } + true + } + Repurposed::StrongholdEnd => { + let (filled, _) = queries.liquid_column(x0, z0); + let min_land = (bottom + filled.len() as i32).min(bottom + 45); + // getHeightAt: the lowest height so far, less one at every sample. + let mut land = i32::MAX; + let mut sample = |x: i32, z: i32, land: &mut i32| { + let h = queries.first_free_height(x, z, HeightmapType::WorldSurfaceWg); + *land = (*land).min(h) - 1; + *land >= min_land + }; + for distance in [70, 35] { + // Direction.Plane.HORIZONTAL: north, east, south, west. + for (dx, dz) in [(0, -1), (1, 0), (0, 1), (-1, 0)] { + if !sample(x0 + dx * distance, z0 + dz * distance, &mut land) { + return false; + } + } + } + sample(x0, z0, &mut land) + } } } @@ -172,18 +277,27 @@ mod tests { column: Vec<char>, biomes: BTreeMap<(i32, i32), u32>, asked: Vec<[i32; 3]>, + /// Columns by (x, z), instead of `column`, from y 0. + columns: BTreeMap<(i32, i32), Vec<char>>, } impl CheckQueries for Fake { fn first_free_height(&mut self, x: i32, z: i32, _: HeightmapType) -> i32 { self.heights.get(&(x, z)).copied().unwrap_or(64) } - fn liquid_column(&mut self, _: i32, _: i32) -> (Vec<bool>, Vec<bool>) { + fn liquid_column(&mut self, x: i32, z: i32) -> (Vec<bool>, Vec<bool>) { // '.' air, '#' stone, '~' water, from the bottom up. + let column = self.columns.get(&(x, z)).unwrap_or(&self.column); ( - self.column.iter().map(|&c| c != '.').collect(), - self.column.iter().map(|&c| c == '#').collect(), + column.iter().map(|&c| c != '.').collect(), + column.iter().map(|&c| c == '#').collect(), ) } + fn sea_level(&self) -> i32 { + 32 + } + fn bottom(&self) -> i32 { + 0 + } fn noise_biome(&mut self, quart: [i32; 3]) -> BiomeId { self.asked.push(quart); BiomeId(self.biomes.get(&(quart[0], quart[2])).copied().unwrap_or(1)) @@ -274,4 +388,75 @@ mod tests { assert!(bounds(0, 64).pass(&mut fake, &none, CHUNK, 0, None)); assert!(!bounds(0, 59).pass(&mut fake, &none, CHUNK, 0, None)); } + + /// A column of `n` blocks: `fill` up to `top` (exclusive), air above. + fn column(n: usize, top: usize, fill: char) -> Vec<char> { + (0..n).map(|y| if y < top { fill } else { '.' }).collect() + } + + #[test] + fn repurposed_city_needs_air_above_the_lava_sea_around() { + let none = BTreeSet::new(); + let city = checks(json!({"repurposed": "city_nether"})); + // Sea 32: air needed from 52 to 76 (128 deep), in the 8 chunks around. + let mut fake = Fake { + column: column(128, 52, '#'), + ..Fake::default() + }; + // The chunk itself is not read. + fake.columns.insert((32, -16), column(128, 100, '#')); + assert!(city.pass(&mut fake, &none, CHUNK, 33, None)); + fake.columns.insert((48, 0), column(128, 53, '#')); + assert!(!city.pass(&mut fake, &none, CHUNK, 33, None)); + // Above sea + 45 nothing is read. + fake.columns.insert((48, 0), { + let mut c = column(128, 52, '#'); + c[77] = '#'; + c + }); + assert!(city.pass(&mut fake, &none, CHUNK, 33, None)); + } + + #[test] + fn repurposed_shipwreck_needs_no_solid_block_around() { + let none = BTreeSet::new(); + let wreck = checks(json!({"repurposed": "shipwreck_nether"})); + // Lava up to 40, air above: the samples at 28..=58 meet only lava and air. + let mut fake = Fake { + column: column(128, 40, '~'), + ..Fake::default() + }; + assert!(wreck.pass(&mut fake, &none, CHUNK, 28, None)); + // Netherrack at y 43, between samples (28 + 15, + 20 are 43, 48). + let mut rock = column(128, 40, '~'); + rock[43] = '#'; + fake.columns.insert((32 - 16, -16 + 16), rock.clone()); + assert!(!wreck.pass(&mut fake, &none, CHUNK, 28, None)); + rock[43] = '.'; + rock[44] = '#'; + fake.columns.insert((16, 0), rock); + assert!(wreck.pass(&mut fake, &none, CHUNK, 28, None)); + } + + #[test] + fn repurposed_end_stronghold_needs_land_around() { + let none = BTreeSet::new(); + let end = checks(json!({"repurposed": "stronghold_end"})); + let mut fake = Fake { + column: column(256, 0, '#'), + ..Fake::default() + }; + // Every height 64 by default: 63, 62, ... 55 after the 9 samples. + assert!(end.pass(&mut fake, &none, CHUNK, 0, None)); + // Land at least 45 above the bottom, after the sample's minus one: + // 46 at the corner passes, 45 fails. + fake.heights.insert((32, -16), 46); + assert!(end.pass(&mut fake, &none, CHUNK, 0, None)); + fake.heights.insert((32, -16), 45); + assert!(!end.pass(&mut fake, &none, CHUNK, 0, None)); + // Void 70 blocks north fails at once. + fake.heights.clear(); + fake.heights.insert((32, -86), 0); + assert!(!end.pass(&mut fake, &none, CHUNK, 0, None)); + } } From 7b5a57be7c654ab2a1349991d84fd5b6a67fc391 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 15:55:05 +0200 Subject: [PATCH 121/163] Carry: Repurposed's Nether city, Nether shipwreck and End stronghold They are Repurposed's generic jigsaw with a start check of their own: carried as minecraft:jigsaw with the piece-limited layout and the check named in horizon:start_checks.repurposed. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/worldgen.rs | 38 +++++++++++++++++++++++- docs/modpacks.md | 12 ++++++-- 2 files changed, 47 insertions(+), 3 deletions(-) diff --git a/crates/horizon-port-pack/src/worldgen.rs b/crates/horizon-port-pack/src/worldgen.rs index 51d1a0ce5..7de9f39ce 100644 --- a/crates/horizon-port-pack/src/worldgen.rs +++ b/crates/horizon-port-pack/src/worldgen.rs @@ -32,6 +32,16 @@ const NETHER_JIGSAWS: [&str; 2] = [ "moogs_structures:moogs_structures_generic_nether_jigsaw_structure", "repurposed_structures:generic_nether_jigsaw_structure", ]; +/// Repurposed Structures' generic jigsaws with a start check of their own: the +/// `repurposed` key of `horizon:start_checks` names it. +const REPURPOSED_CHECKED: [(&str, &str); 3] = [ + ("repurposed_structures:city_nether_structure", "city_nether"), + ( + "repurposed_structures:shipwreck_nether_structure", + "shipwreck_nether", + ), + ("repurposed_structures:stronghold_end", "stronghold_end"), +]; /// Layout rules the piece-limited assembler keeps (`horizon:piece_limited`). const PIECE_LIMITED_RULES: [&str; 4] = [ "y_allowance", @@ -408,7 +418,13 @@ fn upgrade_types( yung_structure(v, lost); true } - Some(t) if JIGSAWS.contains(&t) || NETHER_JIGSAWS.contains(&t) => { + Some(t) + if JIGSAWS.contains(&t) + || NETHER_JIGSAWS.contains(&t) + || REPURPOSED_CHECKED.iter().any(|(r, _)| *r == t) => + { + let check = REPURPOSED_CHECKED.iter().find(|(r, _)| *r == t); + let check = check.map(|(_, c)| *c); let library = match t.split_once(':').map(|(ns, _)| ns) { Some("moogs_structures") => Some("moogs"), Some("repurposed_structures") => Some("repurposed"), @@ -421,6 +437,12 @@ fn upgrade_types( }; let limited = library.map(|l| piece_limited(v, l)); start_checks(v, liquid, lost, limited.is_some()); + if let Some(check) = check { + if !v["horizon:start_checks"].is_object() { + v["horizon:start_checks"] = Value::Object(Default::default()); + } + v["horizon:start_checks"]["repurposed"] = check.into(); + } if let Some(limited) = limited { v["horizon:piece_limited"] = limited; } @@ -1084,6 +1106,20 @@ mod tests { "cannot_spawn_in_liquid": true}); assert!(upgrade("structure", &mut rs, &mut report, &NO_TAGS)); assert_eq!(rs["horizon:start_checks"], json!({"liquid": "lowest"})); + // Repurposed's own checks: the Nether city, Nether shipwrecks, the End stronghold. + for (t, check) in [ + ("city_nether_structure", "city_nether"), + ("shipwreck_nether_structure", "shipwreck_nether"), + ("stronghold_end", "stronghold_end"), + ] { + let mut rs = json!({"type": format!("repurposed_structures:{t}"), + "cannot_spawn_in_liquid": false, "size": 7}); + assert!(upgrade("structure", &mut rs, &mut report, &NO_TAGS)); + assert_eq!(rs["type"], "minecraft:jigsaw"); + assert_eq!(rs["horizon:start_checks"], json!({"repurposed": check})); + assert_eq!(rs["horizon:piece_limited"]["library"], "repurposed"); + } + assert!(report.unsupported.is_empty()); // Nothing to check: no key. let mut plain = json!({"type": "lithostitched:jigsaw", "cannot_spawn_in_liquid": false}); assert!(upgrade("structure", &mut plain, &mut report, &NO_TAGS)); diff --git a/docs/modpacks.md b/docs/modpacks.md index cbb63a30f..12e522e24 100644 --- a/docs/modpacks.md +++ b/docs/modpacks.md @@ -500,8 +500,8 @@ Two cases the oracle fills in: - Still lost, written in Java: - Formations' structure and element types (179): their placements read block states in the noise column (solid, water, lava), which the structure context doesn't give yet; - - Repurposed's mineshafts, mansions, monuments, Nether cities and shipwrecks, Better - Mineshafts and two Better Dungeons types: Java structure types; + - Repurposed's mineshafts, mansions and monuments, Better Mineshafts and two Better + Dungeons types: Java structure types; - YUNG's and Moog's enhanced terrain adaptation, YUNG's piece modifiers and dead-end pools, and the block processors written in Java (YUNG's banners, legs and decorations, Repurposed's pillars and fluid fixes, Lithostitched's block swaps); @@ -515,6 +515,14 @@ Two cases the oracle fills in: (vanilla 0), Better Jungle Temples 5, Better Witch Huts 11. Vanilla's own worlds are unchanged: the structure-start oracle still matches 35 of 35. + Repurposed's Nether city, Nether shipwrecks and End stronghold are its generic jigsaw with + one more start check each, carried as `minecraft:jigsaw` with the check named in + `horizon:start_checks.repurposed`: open air from sea level + 20 to + 45 around the city's + chunk, no solid block in a 33×30×33 grid over a shipwreck, and land 45 blocks up at nine + points 35 and 70 blocks apart for the stronghold. Over chunks -320..319 in the Nether there + are 2 cities and 45 shipwrecks (30 and 865 without the checks); the End stronghold keeps + 8,000 blocks from the centre, and chunks 500..1139 × -320..319 hold 2 (43 without). + In a world with the 40 mods, seed 1234, `/locate structure mvs:azelea_house` finds one 27 blocks from spawn and it stands there as the template builds it; When Dungeons Arise's bandit towers and Structory's chapel locate too. From c296578a177b86a06d5ee0a6da21db9f55f25271 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sun, 18 Oct 2026 15:38:01 +0100 Subject: [PATCH 122/163] Remove startup verification screenshots --- .../loading-before-rest.png | Bin 272498 -> 0 bytes .../video-before-rest.png | Bin 66359 -> 0 bytes .../world-after-rest.png | Bin 211784 -> 0 bytes docs/performance/startup-stage-3.md | 6 ------ 4 files changed, 6 deletions(-) delete mode 100644 benchmarks/startup-stage-3-20261018/loading-before-rest.png delete mode 100644 benchmarks/startup-stage-3-20261018/video-before-rest.png delete mode 100644 benchmarks/startup-stage-3-20261018/world-after-rest.png diff --git a/benchmarks/startup-stage-3-20261018/loading-before-rest.png b/benchmarks/startup-stage-3-20261018/loading-before-rest.png deleted file mode 100644 index 6175d5283d3ad444e768df7c8ded38a811c79b8a..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 272498 zcmV)xK$E|TP)<h;3K|Lk000e1NJLTq00Mvj00H0#0ssI2y0c5O0000WV@Og>004R> z004l5008;`004mK004C`008P>0026e000+ooVrmw00006VoOIv0RI600RN!9r;`8x zfB;EEK~#9!?EQJnZCREVh^@8u-e<VeH@z{Y%!rH}t12_AiY$h5H#E>tZj73tv1rNA zvTTrSwS{C0wOgWPw;D_B7RFX%x1n)CV_}N|Om$-@z+j*#YDlUovvQ8i$c)Gs-h1(; zZ@l-OVeh?`|JdiAJACJyJAB`Zh(zA;^x}Kpz2}^L_Fj9<>$mX#@w2}SErW<gqtR$I zisJ~jAI{^~-t9lWFdKfqEH3`R&-}@IZ~o%tkCI_BI2v63{ocXHfAZh@KlBIBA3u8i z?eG5l8{ho@Ji7li_NDhW8JfZ2pz%Sc@12&@vhkze`#=0YfBMJ%z01G1<@k%g@Sog& z_vah0di4|k{*V3EKP^okU7Wr3|NVdePcF{xyWH8rvS$zwslGcn8l<DN@t(qR{^-2S z%C_Y?eBn?T)qJgpD;-GdQvY~y_NtxWZ~k9ieCCh8``usu-mm;OZ@lqEN+VJP07|Q5 zKXs+c&$E1-3yZLXyOE-}7bl}+|GE8+t<0W`^^>ti5P|Tn0&u~8I{QLzzjye;VaFY8 zZqFZ`v*(WQjBbtMe%wt|Pv3cJGpn8Nc|icrSQ3^I0RjjJ01@s#w;%P^Q23)a9!(yP zNfByVT52z4VZ%$tgZTEVx0P1ix0;?!AH4Pe0Cc2Rc90$0!iJyI{q&{JzSMXJW_E@1 zrMJ2D&L2E?09gIk{oKj%WRsKFKj`=NdmEkEX?gbWY?E)2qP^RDI@TL<gGX;XYP<>3 z>PsSFZ?Cs@+2?c4%kh)(=6o#f$Nhu;=HK_uKX~l{PIEBY6OksLS>>HVa83XK!y5<) z2oW)h02blx6cSOCL{yU*R@{ITAra1gQ}Ni++1xHJMKVZ|L6YvLCN`u95o_9D&rjce zx-A<wi5cA*1<tV5ID7A`gMD?3!xs-X-_0e){>^*ElXFCJM+01#u&^K@A_m@At%mUQ zWLmFVG~<4Yi&?GQ?1zr?vX&9Gjjr>+%%`WPr>Cd;`}>38AWf3(ZmndH_{{}y6b}cZ zyNw^Y(k-1sGNdA{Q)5P7`h~yv_IH2f$-S?yERZiLtb4=6j4q*>GA0)fo8QIs`-2zS zW}X+v^|=rc=X380TV9+z{nmqbfARRiy<*zT_}H}y7$oc_`dW%NT#JZ^9bfpqm?u;9 z-JkofpZu-=()+SHpp(L+1`w>Z*1EtZbfj%IKjG{-ALnG&oJP@f0<tfl5QF4KfDtJT zJZ514Z+-V2>I2h7pPk})iGH*yz{g$y00jU9!if?PkWKDGM8d*_rPScU>!U&wX<OQg zrLwHQ)ofe6^((tfij+}-+eS%L?XrM~2#YJ6&8;il%7hz<ylG80J-Gt1=~p+t=XSS! zrbC|j{Y3;oz<WUi03-lLoPAIecA!KAU;w3*Nlm?~!XhHfT&urPFG5;A<Alm69qG6q zhd(AU*S`LnoWzD_v2^gCYkwR7081o-imcWw!i5zl-h1|ph{-TnVW%#4m3Bf%L_xQ! zeuLZ1VbcTHG&WL5Pft%LlSv%Mw{G2{Z5C*d_^oEsDu4?I0LJv=<S^~s8tuKZcle2$ zw|;cA|MEZh8~?K>_rHFb5qRgBSy6)~rHl&9_wtyWHw$1y91LG<n|6^uE%Gzxrg`=> z&mKR0^tI!s-#9&a-Iiwn;9b#nq4!=y+SZeFmz?Vs8;IC(-rfUqUTA?*$Pre0cST0B zr0nTP6H%F!!cyyl<$_3V97-!jJQf)WL=~q&7KjNw!r1v@T6EuGKA&Azpk9Zt*M(L9 zY(x+$`CGH4jqancI^|gjU~s{5B}FDO;jK4eakX|YB0&Z(5`famBt}PC8(mBbZ@n+Q zEiGHFI2wXdyVwV~jRfBGp13>fx%5zB$KE<&k!!r|mB+U4Sh<S?kR_ZZL<AyWzpxk8 z8Vd$p8%e851`sajSgp_Q?f26CR2#j8Z7RFI{`R{ORK^`1w}Yu&J<)q%j{sB8<$1nz z;vz*vP-!hh3XzbR(_yL;ts{+y)6?m08p9P&!KNM|Ypu05%d){>u(vmg<Bcrt)bLib z8H}E5cs)XG^eZ3#Lwg6W4u&s`_Fn1rZ{tj|w#jU7y?AMSKV=jlu{6xB%>o91!LY#} zsC9p||4NeH_}15cdOCS<arV~5`CB4xW&UmVWXHlXWA5A0Vu$ry9q|q-*A$%LI%*~W z_N->&Ke(N}^8i3dfa?!(cq2hP7fAq>0E>7KVeudWV5e(*Q%KFnzOo2GfWehr>dWQD zFBP${_DkB=hMa;_cySaFEF3AUeOySWlmY=H+~f?CBGQU933D)-!z2+A6#{~QFtaV~ z`J?lNi2`#agLf0a@PP|8Y1mDdSzlORSeI9Svm)xnAM{+W@RlNhEF}bB0wEIuuWknd zQ4*n1N)ajwLIMElFvQZ=m+3s}MZrh%tjGIo0Ta<~@=P3qXGXBg>MR*bhDnq}q^SC% zs~_f^Auq2YeV@4nTo3R4+1c6I+1b(2VVd^Rbd6J5tL@%uFuF_1u(x63O=3)JRHR7J zCqDB(8ts3y;gY?(ZO4GQSwtzL@bY;80D#HGqdYrJ(*4UHnP?sdN|K|)8$Wz>>vM-k zpN`W*0Q~h|{<FtVzSc}q?S^a+z|g`@y9IENh#h3n@u||PTk5d$h)6Td010)ZD{t6l zL<xc6BNhk<;(2~0DKfEHf9z*u&CI^^-g(lbwU${_**h-+-KVu?Y5*VzRukjuD{Sh5 z76C<o!hl?Qo#5ilH)lFX*gxnYk<Cl?96Vq_;i#-7obhoMVPP-ATxSm;;R@$ntA%Vr z5-T^{ocnCdAYpMgU16t>&RkZ47jd2)b4|~^D0-FxcxzU>C3g*H1ho?DVD>CQlFJ$h z0>uV{LvHP3a0}*eJuklP7H@wR8Xl*16lTaABimR-Cf2d8-AJfV&AbcUTejnK6}}%9 z@XC1l^jPcjG)-^bywRbLYm#2<r^TiU`(W?x=-~M*e-NdSNlfjL2Y`!<x0(fTiv`@V ztV*l4&6r#~oSZ*w7Qm)I+I!{h^Z&iu&;8beqfd~E6h)*eLDK8rI(`Cek87KucfMoq zyA>;M{f3-(he3)!L_7qWtcv4OkfpP%D(pJ6i*pk~#LD0cpXy`{;W4v#Vb8&yD6`U8 z7bVdmv9V(i>E>Lkd<wy9T;yr8p#WAS06@WM2*P4>8>JEA+##^J+YJdpL>Z-wYTH3! zDK3g?t)-O_hi~r8wyruhdu-Um>G>2+E5(sZH@<%YBKk7-=vYE&o5hF7WgVO}s1?{M z5t0BIQHTImg7;)n6Ah9wvny#XYu|APt7|tgvzvJr7GX!uv(*DjOL?w~LP|IN=$)QY zDdM8w*mSl#v&s#EWgSEBe5G^l;^HF9vi_jIzqc1f4gL_VWSIDAsW#k<;r{b?KlX{o z4;yk6pFaND^DqAPhD-MD_69en<Hwgj>d5rz7QjchKY971y~9_2>JR+wwi_ntQQJp> z$+qoro0(p3ZQHT&&eu|~ww7G!ib+vS3R~ElAH8{XRw7=iB*3t4h@b#ioONyPYXDG) zheT)0T%Q5NkjE6(VM#7Z#h``77Pg$0u5h-nQe{g4BF4Q~CadBti03uzqfIg`2<}Z7 zQ^<B%;*tzDvz3|%!9~28){iqIsoQyuxFKKIlznW@C3cPhSMdP>0r4KKhs2Q4gaiOC zcMEd{*qrN0rGp3vN|UtRiUDqG0B;)u4)3LvCSn8-Km<}mptJx+D&6bF!_*9tc#wo( z<jK9$wE}qM9Y5>>n0Jo>UtaJ!6*2HVUwT{E=;R{JCaDntoT4gwJ&YsVDbjK!3z$9# z3%DN6xwF%=v(vM~!^3{RpCn7ZBTX`h{ll7i*1cvFk9z$(jUPRI{ME+a5BBa3Mt52T zaEpP|=D@MVWHNrZ!#c!Cy8zZ*0=U}(CPki`)d;cPl}<#w^R94ZR@&UwI>%a?AVnKx z5etYHAgIMmxVg8!LjWT|WYj?^7Xl?Na5Ab+X3!M?fE|ZaBUd<AIPV#;!DkTaD^@fr z_Kk7;OB>yka3=t@^}L}4tYa-KmEJSs3*LG~1T4Tzk-1KX1h((Uvgc!~xWGpIXiFI- zEaJR)&(3q{*m|)ZnTgQcKEMdKc)MkWTWglW!k(jEL@~jKdxY&!k=7EC(W)04g}R@Z zNSQQJmru=d^8AMC)Jphc^NDRuhV;I=paW-S$L!gAFJ1t_JI|J#b?il05I~r{_0uTz zN_ivzh*UJV+LrA$x}Do=$5jPzJ&uo$&(F`3G&$JckK?#L?MsQ!xXAySN7}pH`1_}i zn<K1)y}SLryKukZ(~t<=C~H^hFA=MReq~fyp6u}YNqVF0BV`n<I-lmFgZozkcv<Qs zy~Bfp7xvFyKS)PkJwCa}3TNF81f-1WcyvtQq?)p@c*i25G}U6*l|JsMjYLF68gK+~ z!BWs{*Aa-wi}%cvlL-j8(oN5%u5h7j5jt<FBfaPn*yNB0g<2Y-Z!q(u!-j!dB2tk8 z0A@zOpp+n@ct$6v5NWepZR)p$wp{%cwel(swAM#&{#_Ba&K-|^X_o{E01KFwxiu^S zAu5H6#3+}$AbNQgwz$@pdnPepw$7KXEF1_NzIYg=Mk%65>sYT*eJ(o#WOZ``p)cNL zhoHlb0(d8#vcs|0N=2T9B|Fcui_BXe{s>DlOkiec3Nx}OW)>-yeXdv0eXnQ%@BUno zYZJf#;G7#@jElVJ_0qk)y^tv#YhFXs%kSRnHw$3z@)r7_*5aignVKT7+UO7`2zg#Q z)=H^R2ygB24)30%hlom~!CGx}s>~_Xb-AFGRu(J)+&27T#CMOLGr#T6n4=#~F5XI# zy>I=@|H__zyOp3FcjSL5qZUi}SH`UrK6@bl;QKBwt4c%>K!tG{g=nbn_Lw1pR@N7V zXY08H(TS<oKq*Ct_0y9<Qc_t?OC4)kSAdU106af1YXvY-cSY7^3T!)Ofd!~Yktczw zw7>dW00<GUbdsA+N%PDFmi(}rTfm#TwYPl<5wU)|cMoZLT2UNPq|hkR8VHflmVOO@ zgIq16du#dI{4n<H@{)7Qg>}|LVV&o3;rH+C9e(7-Hq%+sBZFEw3sSUli5=w4wnA~| z2f+qPp<L2A%1J3A<+K!$kgKeXRz`)CLnH*}aXfKe9H7@4R#cE(Nn+=UshY!Fg%qz- z0Ec0%Jv*}(7vp}vf8)lHSz9u(?49oQZzGa4`4-uiq#7d4gHf~BnjJH<YLdWFKiboK zp#p3rT%To6c6jR~y^*9x+4NEKE4FJ%-nHjaAsi^Uqxlx`XZHM2BHZWqKJh;g)Nu3) zAesJ6fN!_m*;yCq)<Oksy0*UX@WUhd*zfyy|MEZo>hZ(xg#8gG`J{-_NEzk2ku(sG ztvjFOvxMc!f7rMVh#2={B+M^z9f^+gnhdWx7fjZN5jRN|-NYoSb3=#-RBPa8^CYZ| zzS&^`Z^P{7cf*au&-VE<tyaBUVs@NcUs_+-^!cNC4%)(EqT5AIJj1czxAV?B>s;xw zM`zvxPclQO2)$C|y#sJ|dw+z0v%Z{`?0qPnM8c&g%q;wQ#qh?CVg|40Ss`A-o<rKi z%JE@lKuG$Dj*T{|K5laeDg-BzF$sbIC_)5KAh!)4DH%`7r?_KLR!6<eM$4l<G#2p6 zf}USYPA{_l@Mh2Srgq(fW@0$)-${G7r;`V(pCdkf{I#2Re*E&KZIws>vy|PilZf+@ z4+)9B4VUE8Cq;f1Cwp7HZ;~8!2;dGask;>T1r0AK0RR>y>5&_}D5wDfxDE{WU+9>U zw;s~gPupND!#FPBJMa4a$(R4o=<z=v<C{})Qk|<}nny|G7D8E7piYE6+suY&w4GX5 zu(#NAF)5;66qe#LmkLmDWmd*448pJ`K?!Ih7c>&C5AinDr&cfJ#pX7j<mI$v&)tg# z+XV31Li?NW>y@W$D)j-^Is-zsQ^38sDv!ph{><mrmyV0l7nWy^6C{dnjBsb`;VMS( zCYsLzB9ga$dNy^XV>eIwbCW_8iDwAdG~Nqh@D^|TO5!;`ofZp~@k{EAToZzryss|k zkS)QU*)e<Jg__AmxGoWh(x`XPhxUyPn4KXFj~#=+q2WJv<N)yRU-<V(?Iz52&KJAN z`qbk(1+YK>+f)uBFQ$;RkpBJSp4(i^BlP;Wdi@3g3;-Ph*hD>BPM3I`s?f!1e3_+{ z!dCxYmOaj<kGB@U=}|`_bgL^ED_-Arp^8z)0s!x2YWn&ARDbFZEPgsVSSNtnN4G3- z0#3l6y%iDs?wjiC7yOkoK6d~Bdl3$`-B)Ox%Po7y0g%=eZm~3(G)2A0=GM;)8eu6X zrB1ZcYKg_n%rYHmQj`}~iG<ziI2K4q8^|6~#EzL40@#-xT>GHv)Q^y6=?a&fXSMv+ zkzUL6H_U>*DtM%H{&Tat&HXMo=Ocu~%xi%{TVFrq%Ogs_ej+SRCSYCD1U@iW%EnWV zIA;{3NNJ^v3WyDplSw%)8>+toVb2g~0Z|AMfVO=#fx1Y(21g7(h=}(d<Qfpi1myh` zz~1>{QV0toq9PS*am>secU!C70st98z&a69R{%EfK=keqT32&He<)(W48&rr#HI8K z8G6wUVlQTga~3BDZDHUiEs4;>y}N_a-IFKZ0|cd2sJ~W`Qd*hRwC-yQgU_c=vdQE9 z!&kSOHj(a1gkH({B2-$Drm8}`ohZ{j$rAto_72zrE)m)2;02}QHmFNyyX=^57c>Bz zG3*hLfF}6FfJD<{FQ3@MTRq&5aWBDNetP=)see-P+|3|M02-tyN+Vl3S6UPV1%xDC zM78Sl0i(lPzX?$zp{(;AAz_3#wN8Yq!2hMKQAUlA$5JxoK1c5yi|5soDKi-N?i00n z9q<*{#7bag!-oosx87MtL?PkDq(&*VTHgY=gURKUVnvnc4S&KzZHcphFMN35prJza ztU-~gA7+@qi_6{`1@OMM#91j4VI%;*?dH~^F~HqaSS&#jGkWpY^~Sq6T5(rT17b2r z=FpFb`6Tz&6E#EJ3CLOrTH%X@d=#i01yd^}!?B9`yXq)auHSBNd9@m(E5?A)i}GR| z#Dxs3q=ocYv@CDhX7xu)Bi*_Z>AC$|FBbNJNlZYws*9t$R;T3?=d$VK(GJVeRSK+C zokpvTCQV_6)md$yV~#XJ0D+!?k$VzseB>fM`)cp$FTe8SU;ZNcX&X;m6Q*7BI$tVu z=Gg-rGfe;;peX3~__MbH5G34nIWVRGZvxaF<KPw!XDJ}z>ZpP}sm=^yKvis=mm<!s zw_e9h7H4(%W;|ts3L=AqEXBC=+Q)-9Xg@mEI?+1TT5I-v{_xyR%d`Mx(AJRnhyb7f zG@>DNfa`hTW`w?J;)Xy-1g%k^VHOBjVNB3Y17%j`<J?~4*|cQO04T!3f<!vjS9O7f zq<BQ%l08QhTor(bi*?f1khm>dm;bV7=NuyT5Bl>nh}aEx+$w<=X%A5lf=gj*?MeU< z_xpOvD+MhGD2t?c)dkz$&fB&v!6Jpn3vgyZc47x+g{)t<F#ma4xR(p|fB!u>1qHF* zITl;DdfV+auVMk?wid7eijW6mB`u}LqDo1fBp$Q?ZNlw0dDCA1R^#vU>}jLf8pVSf zFT6a-zuA0xT2h=k;$hkJ@eZrmD1e2foR+q*gQGz!Bv$*POj$vsr0|{rAAc2o<EL*< ze(~1XKNb)Kp^RgaHUZ36OJ?~9N?-6@kMArPTR-<ey*2fJ@I^L+njj|lm=Wdq4N$HM zK!|v8)+trx*T@W4YYPU7;7Z5LCXFs3JuGL?Z@^QgC`=HgQItmgqkcL_t8N^#;hjf9 zL70FWdYvHVs(Q?Rq~qBW#sF&t@P=hbn;u#g@4Pk|!uLZJ@?`<M{7+Z7>De^D$g}gz zJ0Hr>E4Y76-g;jI!sx2-xh{~kRsJpSD<m~DmuHy(c#(h{M?|4<&=#-ImSRQ-Jbxda z*>>9owgbHAAXQnu%8=?9!J>58(Pb*IIj&1+0phJkg`-=eoz{MpM4k1nuu7|D7+R6F zT4~TkL$oWLpeF!N0HVH%6z-gje3dG`t60DyVqgOSJd5n2gQVcTl{A+jgJvNHwe5M@ z#2{|O;vmx6460jPy1v&^JzRN^u$eWqO(2`@ln9+1Rfqx1-g%qZGA~`>LLg*xd$bv? zE{%y0L?nfuIynF8-_iJY;1K0Vg^La&h^~+WU+3ah<ursuq!S&*kxsN4PiZoFQOUl@ z>r4}<z-+&MrXFVayKk~M8EF=jTb`!{yzRl+3bGggJb4qF*5J2vvUo%Y&2gutNz9UN zyS$qL3~LFMLL^{Vvgd#cHaP4jFCBGsq78mB07wmKf&{?;jAz?|3qM@fVct*x3xY7L zbk)3^G~k^trll)wF)qeW#({4Jw`vvpkY+-=JlpxrpPi(v>YHT^kJyrzF*7iTNST*5 zvo^Ch&5MgEvm`h7bU)cKnW_CURBEy9iVy(<;tm$D+)c3XpaC2JBCrpzUknm}>j@Ek z=^eAM0K#s`YfEB#K^|9iP&^my`B@(Pm{An%g7|UCZ_l3XwDi`izG~awaLlpuw&H~y zS6&N3m<6pAshus+XNtlR;#RVdYl48Gs|q4w)ENl$VjM)Cjf1$9o|V)|<iWs|N4G(o z_HL)WTOp%ZsdO-Uq2Iqd7`-&w|ClW&ChA|lzRhTcOGT55Y_~lOyoCkqeVI)jO(&0z zAAhG9b3VCnrCV|Tc4u03d^8aPL&4?i1r>5$%<+#AuOxt@GzzU}D-e=M1#77~GZFP1 z#2W4zxl{TtUC0w452!)1694%<{B#8Gd3@^W#OaI>LC`IgGnQGYV@;RgjzgYvOS4E= zkWcKn%*$nrjwQ)ZwI~2#$KH8weK{@5X<1AQn^|u?X}bN1+ueQOkuV(o{aA+xQvx6& zlV$XjjRY{udfO2<bwP*wSnCXGT*Sy-rWc#rP*iPmONP3;SS}undcyO@56tXDM{1LR zH!SAsZc^Zc%X_#9urmi>OF;n;MsF5(txmKorUg4@$KLwM$pip|Iav?`o7R1`agfG6 zRRq53`W3?7fz@ms0~R=890A`{^3W?qkd-d99h)thh=8A^bRggk2}dEf&Xq3gvaqmY zKnR^QYg8FBgoNoq8ZuN&YBnXOOQ&F!0nXywjVl0~ty=}2k6?PnL<Wf{h+$11hyY%( zfU6VaS-gmdj&*g)WX=`@<}kEKsFx`XSrmg3p<wA+NlNJnP}Ru%y0zj)meT9r-aq`* z{^2M0_Fo<CzcLs;-y7Ubdp8hO+x5M{oo+_cymqaL(CaIateqY|{?^IUZ=IcdZ*p-j zn?4zzJ-9eNZgc$ZCV-tFMkpXoz>A1LQGzYSdr=zHQg8T%+j{F)bI@kxSco{hF$@B@ zk#?h=dT9VXEn2~&bGUiI79bKhAn6mt2pV9I<Sk2C<#|Js7_t-&c{TsSk!Kwnji3=D zL<C^Kvn=OGxB29kXxfX-ZHS#W9LUm7PA8T0ExohO=C+)cbzFx8WL=!N(x#W!AOXZ> zT$K$i;7y#jn`c1>ThUo>5I}$eToiS94%SP;DhE)J&1^9(Rv^cPfi-StEaFC~Tbm?7 ziwHXp)`@3e4g#1E2>=x-qfBb51V*JoA8Qdgd+#h{#@0s(5f}c^F^|pmbXF)hXQKju zh(-f5R~ZjjHPhbK1r3l}24MnmEMio%`$4L7t$FMCb<-}VrOj=bm9B8kx?)m@ucR*# zktUNGlNi!e*Iccfg++~gs})-<Rc{1=Um#oBpr=rPBMn;DOevpZ)FXZX0vHf%ZoTt? z1%>4e8IC&Aecf;5X^SUO3!ngr;4HG+w-R}YokR>;-mi$wq9jhzqc8mAp8-IvQ>D{Q zR<<{|RU6Hli?_CsPoHFyM~wpb;_R)555Dx?yT5XF@}07{aCYk4G{A-gvgQ`d$$6@9 z3(2;<CL_L(_(vrff?*6s!NsW;fjGrf<FL~oQ48Rz5NmdB!{0jA9dY84D2ni;fM0z? z4>FtpdH@7D0@*`Agb49v!+XkqF{3BGI#(eH&gM2a-boQ^B7%LTVnjk@0f%JLbP`Yo zH;4`hi!Ge6nAofwZ0~$_npGy8X9yT)11!cxSa1{}yHU46ti1{|f{6hwvj-sDq+Q&M z*cf0P2VR>n64J!H_2r~gf<P#q(TeUHiglY&(jk6Bv*D1JURSwHkEgb<p=5xWgAvJ| z$)wj0Z`nTBa|QP6oVOlJ2YDIHWYddGFOK(mQ9seCL0v&KEK*2l>9}gLUrMa1QNVU+ zom2zri5Jv!qaR~~S>csJ78I_wVEZI2Z~bKU4+0ozFdAMtz{427@|fS7dSQT>RKo<R z*^U%fIGfwa$)uPR<)mcKEWt$tN|Q1w>O}!?S7`+Z^TlklQgD|>Q^KnfI6%m~G{A{g z#SScbHiv*eUpqglG&)5}@6;i?-rS9)lp;lj!UB?^>@+(+KVR$>v2e!M>tRT!r+mOd zR#GdegV;*^!FKKr&+dR$ZXCVA?X=%4fIEvxn?KF6$J6QKy~9^UyohIZj~@K`d++|@ zqldqGasGW*y2h&(D{vZQVSD@DZu*;)G&G{nB?c0M5Xv6_yay3Dh#Oui{1-y7DpGCg zVYg;873BnvVm^rEJ7cml`SdLz&+gMHCnP6@vW%Zk_*>T9D|J{;(i9J35g}4l?Fqn% z$N@kPkpKuJQltgPSt)4*n;^;wxYCPAlte2m;WAfMN+rXj7#HlA1vaT_4I6iP8$9zx z;SSSyQ%1xaDSS&V=-Ga0qfKITqD^c9Lz$jUr>E1|4UyR^>0*~{!=$FMa|RNUCK1Wb zGcH5mQ8Xelybl7nm=^5WmwqLc9hphw*5^MO57Q0(pOs3nVs+Kstgpb(X6>CS#|AT_ zAR=-w%8iDs5JdotAt4J9)YeH@i~n?md-+fi!9h>oio6o<EiXcaAs}fADB0fnVp_Pu z+pM&O1pxM(oo5xe1kPQZqZ^}m5I1w%j)mRHvb<~o4~1Vg{Ci&3Kl=!dos_OJi0hC| z^HXL4_>j_}BOUdkP&~F3E9;(WLq$fNcZZ;i(neE6+UU#vfQg&56=JAO1TdmL_0Ktp z1?c_GQ0$&rwf>uqw0E=DyLH?_4K0?|Wxtt-*kbzV{;zvKJv;gC$<uE>dhgemi+XE1 z0ChVon*iO?yui}6_8AcX5Q1NvtAO{AmCz5NqM#BIktQAKfNotYi5=VDv7{4Glc{JW zUpU}{2!8pAdRn3YFu-?Mi*ujv`67q06X)fC{9`AjHW)DCV4>H+?0=^smU)1v2?Dp& zLMM|_Qa$(D)u?-f!7sX~pL**{DU)H^KpMCz;o^Q=PD^oKLfhc(-hYGuzzeDTK{r!` zlhQHEjbWlx$a-CKo;MP}nslU5RV_e5<@#ms+{)geQ9zffX=Oo3z@}i6Vdz*Rq06my z5|hfjM+N}FEt|Pk{Hn$DZp*jIFY*=&L;y(kdRv*2Tv%ETQi!QE!a33iZX|Us%YaI{ zW7QK8u!{TQ>~AJg-lGq0pR4w3dg#?H^pA2pV(}hGs|p)LkuoY7C8X&7H}AXBMQKzk za5dqX*aTrbCnUrjaVmDkp<Lecg5{BezxRFrQ!khAoch1_4u<$>@G1vup>k8tns8J} z2~xofAYnR8TS#Je6)Uh8(o`p+)(8!ucC?#GwhDrk1s72)C>+oM$+Pl|!Z1v<mGnxB z{Vc~;#Y<^h9+tG`VXfrT&au-RzxLI?t`li!u7F+jOI?tYm-2O2=GaC=IjV4kd}#Eo zKq(-Fh2VGZ!=zBd{aCaLfD$XX3f;nBP5vH0RzN=z72zvA-n%2;yr6HKtHJ{Ve7n%^ zSxT%w$=t+?6#!sTR>!&l`2;JWF%e;r0g@GQ08T^@T;^1y1S?gEnMEL^O|jz@$i}Yb zQOk-EDT?~B%}Vxuo&2qQaefg;5CIW15+G#GKb;h#!TQ>j))J8gTLb}#2ydY>YXWRY zxG2CDs%R^6k{MpeWuU<-y9%VP2WzE&7VTLOJwb>_`OVv@W5X_l&}{e{COMSv2ez}6 zPKcJQPpwcXVRz+QSBsB;H6F`cv&31gl>jjV5^SA>wYt<Ll8^LLo!m+|zKgfW=t${U z2VD&SCMT20$s|gnfX)_li|i~DX^%kcl%uqBCx(@mnzBqvcyKH)9pank<gK%Xtrn9o z;Ev_vJjmlfeZfgyuMc&{bvB-6Fs4JOrGleLOk$GD7%aQ(-Hf527VZ}XFe8f>VP<80 z%7UKz;zz_v_>H@V&k76rdPjTnr1?nu+gBn1I_q5Ned(C1)V09Kvgzp{9&AgL9cpIP zbYVl#`h}4rW$6v&9J-U<9+C=fTyzDTPJs{yd#P*bcyUEXqDN!~5nz!+4ZrIazcPe> z@_<e)0>By5DWNl9ovn%6W|lqIrGAy|AsitZK!X?x*9w*?%<NqRu?`yj3Rlw!k<j#v zcmbAfwix!*GiU&$8UaDnY_F%K<0-034)ZS7vyksrn_sgO9?`5fnLi?UmXJplGN*$7 z&E|GyoY5jZGK&vMaI>{lJ=K1!5CDYGDI_mK2nrJhmhGT(kT5jetJ0Ej-mB5&&tCk7 z*)pSbve>Kzf%-9@RsvW;c1-RiF&!A`>p3n9C=fuIfu#xnF#`aJz%FG-K#EKnMX8C> zDC$LVqOGD>skanHhZHsOnH6)e&Vj%hB#IWuZ|9!1*VTz(_M3ltPlPKNvRZXOM0Q*u zkPEOdB8KR7MTY{6y!QMyu5ImP78aY?d{W5FycQM}sr|kE-P{9}t^ieCLr4q^e**|) z`2?}5CqrO>=dv;t29S|v4Nyh~0Ddq8a3e{qY;u2ayW`X}<DZFSr&&N-U0qzqTW@xI z`}c6e-4da*{g+SwjXyj1=Fgh1{a-*6sp|HMAksj&C+Xx(R~ToGFoRL)0U+s9FM=OE zkdOBKUwcD6E~{iN9T}xmF)eDG8do^>9LGip5Q}0liiU}XnGX*H_LWlJU*N(tn^vI9 zx49v;AhHjtPv;;&!0z6&rSnN=hI8mD9sXPuqi*qrkye_5K@k39&lOJ*LA9h^ikH=x z_XewH2{j7<ID{&vcVpE}DJ4phLGl6f1pz26Bummt_Y$$*PKx4mBG&0astCbuXA{p0 zqw9apN=fExD*{ph9dA-&=B+EoMRAd5(^5oU{=&<!&;cSmO||wA2WWC%)eunt5E@s{ zkvw)y627ipgrrCtRr6I942ER~WH~LFS)2&UV&^mj3>Cnz0jgouM%q`^bueop6~15# zXLF0oFL)IY>2#O|ow)LE&79%vIV)x$83X`uBg+zD0Z2(g2)m3T_(2rFD~n!lb+3Qh zL<3unFE3LYH>nVj+T`Uj07AoVUuNTq0?=;rhIK>`rIn7e{4{svU~t!aaZZ#%nUzPz zTF5g91E^=Q!tYt_r)8p~XD}i`!RZ;3l|T6+|NOcBwPVUXAOa|g`?1Y!$VUzCM_|!j zG#~&93ofo53IU9i(#*%*jDA+%vYQmfs*578MLrC?kEJsWVgU}iuGT<A9cvRC6B`vN zB2uB5+BK1QGiH;3Ei8LR!KfcCWgfKUvaEZMRR{v8sEo9sHEn~dGsWP&2LzN4GI}K- z;u#RZt!hw6m>iAr$7fvFFl~w>*tNrac+EP+R~D&<1z2R}^Qh0eu*j_Fwisu2oZD$x zObRI-i=fe7sos8XTY_okB)q!&SBEm&xfRkSf?0EkcRX)y5&X|J1DIu@FHUB$j|eFW zr~~sYX|snf<y&0^NRo)6G-{*C@Ph&Y0p)q*eMwXz7LmS>>f8xH-1~tRz>7;Q0KLKO zUhno<Iflw1BjVY6&yJ&Bqz3CtPM3(;Gy4{#h)w~Fgl&k0txQb>nL()04eRWr$WQRb zr~FI5%f|Pj;*HYsgHssi0FFmm@M^uZI#{hXv>!oC`20<kBxp;yIA;M6hTn6CU+l@x zkDtH)^u0jGQ5r31oxlJYLgXQm%jGc`bfR?a@oub!WWkkOsqS;KfkQQr0k2C#R7RP^ zD5aE9WU7YY*8<tN9fK1Imc(VrdU-Nk@m#FVPVn_faMOCPSY2kRb%A4DH5AGp*RJdi zM|wN9$Wk0%pi#8f<HeiQ7#0hR8I3}twp!{MEl%d$tpxzYI;eog1cJYm5Ea_omXm^= zFLKM%QVQ#{vdGGCC!HA7N+$*tQDji7WVE&OV57<zncE(_RTFjdy6#20{HwLs%nz)d zrH;=00mhgpjjB|sS&~60qY8!K#khd=PY~wy=jBSTIU7b~AFLKmfiDU?G3K3K&r#K+ zguP6&>A~R-rVF}_PWpq}NqY0i!`A{JPT&_6G9p6UkK0P2n-8_)P5QsCjP5Z0ie;>r zd)^Pd-(y!2y{iYl#d%faC-~~`ryKv}^x|v1ulz^q;@%sNz%vXrXabTQD~w^C05*|2 zWKj#e6bXbu1PI~Ndjk76zIpWWH^1{srOX>G%yS?SOAVeSS?t>e;90zvih$Q(My<M_ z0~Wz{3|iKo|KKrR2iO6<y<R#@QQ`X|bX)oCVi-o&z5Cj;gHX4?!^&NONEndCy!GDs z3S_`@+pM|?speL*GIY4cluu!HlRP>YpjH$b<}A!)hW|H9m0C&E+JJcKW4nM=A^;$z zgCqhZ6alS7BM@oAlY1vpST0@3K+c&eOo*rz5ynSDW%MEe?^x&4a-2i$fGupLcnN?2 znQdMfTmP}?;EgGHVV#liQ++rt_{3-(X)+X&&XiWDu+B+tIQzU2or_3q0oSM?S8`Uh zKlDh-PwS~6n3nPlm6lpVt&0j2<02$~!M`2?_~iKYhxfmD^5pC9z4N6SmSOP=p`}b? zjgT@b!1!I>tu{|`U{7r%)v=@O7({NMeLiw`(4Ib$2t<Ksk&@^=?zIWvJU<50L(?lv z?0PT6*}bs)PB0-(*k_$&*LA|FE6|h?c|;Pi4w3*^L*N;Xz4}g`zUR%+^gI7%WNwe_ z&tK@AXAmDWm%$1lHY!zfIT`|7EITII0)TAia^EP59MtNigxO#^i4Y>sY8LAps2!N& zHI7Ad<`Uw;dNvVgI~cN12MB{pk1zzA&mW!#Nw(<KsB&kv<55zFs{sS5F+S6kAw$0O zi^M~UL=o0~{<bU=VqXP!tD;pv_N-$~u@<fTAOXbCiV*-%#9PlS!~!gJ5<A5PVgra& zx7Jvoy{$PvH*D(2$XKXyQB-*V2myj)r2}`z%gzuhed(R^w_04RYd3v)YU>Y$fW(P0 z&yD(Vl4xC{25n-yudDs5V)pFW70x>jc-_xy|4QT^Mf!ACV(WP5P;*})dl{GN*n~9{ z@*Fc;7StF=@ei;7b}qB!`1r{;?!Eml9^U_Amc3W~-cK9*+y#TUQ8ae6#ci#4>8wP; zrqhKAO>91y_&*dq8X0jZF~YAsoNELzGqo#;MScPzY^V0*-sHl$Q;(nstLoMx@+VzK zstcH@`|xL^Ef4}vESwkmo{#QF@x3^<qyfThPhQTR{!j|BFaF8c<e&h7kWxc2LV{?j z`daZ$wrgv!u-F2!hWmtFc3xO6W8w%lYfH69k(rBWQ2}l<kc25$UsG5mXRQ<^zYha< ziF+?Kt_a;@P!S^9!aD2Na=>P(7nL*x|6ZL-0sx_H@HM={BJ*8a4TgY#Dv9Ew!LCaN zN~=l$L;Zq^3kSQ#M8yjbEGD-DK;WK@)U1qR&y|{4bA#Z1q$c9u32N#RF~eCQ06yp# zQ5q?uNGoLs5j#+T0vXuCh9XQvEGETVe($C%U2giZP5|#|D6~2o40NQol}VQc@En>- z<{=pN96+o9!GL^%iayF?x_%270TT3pP)>!3K1taC{Oj+PQ!CzJvA1uc%6|?&paS^o zU;c~VeeG}6;286h)?$5juuc`JHgmRvYP%DmgCn}Cou4%TMnooSXj<iK5bnpEIV?RI z1)f2*x5zE>V-SA&5B{U#wVzE!&ZKyE=pzuv_|}DvVoxC41|ij53f%M}bs_vI%WKKd z>ga+@ZVlkF<%uvQ%^nC~kL1T7zZVVIM6p5<V4k}Wa2dR0F(j<k_4w->ZLQB2s)3nX z{cmMna>Ux`B{b<-?;Q~l$Kn~hfb+I=nf0!)6}yq(9!Ei5RH77NomRYa<L;fs$qs|P zREa`?`#A5cpN8(tgjILKAPhnlDA4=*3c(f)CeFM*dQOd`6>Z0aLqxE8Qt(wSk-hA` zssciq7Abj?YXXu<K*(97Z*0;5uEhmibFh#Sxbmi#q0U!UCMd7fOyo*)yF9&3`X}yb zcxra+XcRK21FRdYb_`$I%6b)UicNq8z|-{;zXD0b3qaJP7txErYmePYE@=dLuMf0T zW$*(jfTMVHS^7e^`?rO4hKi9!`six*j;nh+QvR0lcVd5^<u%=_z~Yzb=|ofs*aJ8{ zM?v}69hj8B0=)>{Jx0|oDf9fKv=b!NkNv>`D1}EL&cZYU7Kpu9B8*oMzyejs+_Cq* zZs*6I-+FGpxql}B0Axxj!N@=&L>D|F$W(w->#{Z$Pc^L*z=XIL#oCr*??SpzM`RQc zec{D}iRWQ9L2%>3W+hk#=g=}Z7AGPg1ia8uv+=%Bq>EVz*@nq48;uPe<BdR42y^s& z!1`wq0lyHloIzvNPtr!4p4r_Ayqo=xfJ&hvG>WuBt&k8DsYwaf<WN`?FCk2@3I6D& zFTF!dff+=Qa6v7ug&}qvhfSx{U;#@|Xy$k?h^R1lq^e4s&HPXG&5<_lo5@n+T6oVZ zsd?*N&<N8gj*@6M0bFL~<YbZz6QfMm8`hAbEVt0I0uSWr`s+ssI0kkM&VyqpN^u3e zJfL%>Pk?-0E*gYCkOKJV=8rVLxgw=iqvhI`uG!J<gB>$-qa&_rX23jfZr{5-=UzSF zAHL0fC0|GN&PigMu9^r<Jw^;^1P6Q6OTtM3MNm3P&-_`-`xg0ek)QPTZe(0#6p;c! zj7auM$=E9qi<_R+71GbgxwB4!*>p))?Y=xyx}Tsn*jJK0RGvGVye<|A%>JnWZ6_NR z0EIY=BID__EEy{Nr{+xwMR?Aa%qFRt7@{I|k%g9a2!IG)&<X-T!hj%!x}112pOP^u z>PMl&(sfzDRl3vq1a54Da*TU%$OT<Y85J+yF$FYG1b-QW6XA*>*yfaiOZsTl@Xj;F zQQV6mgnlVZtnOfApHaNr#HK+2BT8__ZuLyrTI~=J@G__KkY#~g414QcSUIF#geC6B z0aB_e8DGYJ!L_fsu*EeyZKD=%y)CTEU744@^g7l`t2$wzArZfmjUZq~I*rusRZkma z&a>nEA_sxHntQ4D0{1h>_OIUp7BBZsSi7KkK#Fo;Fk|?32ALE=52!;J|9S~vO{A$& z0C#A_t%=Z{**6Ga5i#t4^x|yfT^-X&O1WVG0B)xeJ!RYC*?2TX5V+NYz5dce2MHu6 zt<2p`-g)U)|Hvod!7nMto~nFR5T)V8n|yrg)D=pB^NYNj;dXpF1*Hg(AT@{xZmHwb zicFi!8wAjbh(IZ{j&tYNas~uQm8OV}%S_r`(2Hl%W>zPfv_e8nxX4KtXBIP}NN(or z@)CCdrB&36%4yl%(rV6sHyN8X&<)uJq3+0AA2Rb1F&<P|{iI08+GbWn1O*Xwq-!MZ z)w8g<EZI`(%$q6kk^!V+P4P8!5Z`LLN-L#QmH#Cmkp`nsksx~Ox0U*`wFDLf0na!K zg$PkcG<6556XLbSq_DYlg^PMo)QkH2{cEcl3Lr4ylmY;NEo_;U<+Louh0X0EJ4M3& zL4WyZt+Y#7M^0FA@7)A2d)}lCbMWwq$R}=yR>+9&oI*-Fw-IjTjRnw~5Wi4N0U#zJ zEdub}oW_1ms3!eE7Qk9JL&*h$pqXStB6QPgw<Vhdh61L6Mm4~Q{i4JR;OC6dp)UL2 zCoKzG00Dq=t2;MLA@!bGJjt2oGCRi9D}o}I0@yQPRORRp0?gW_t(>c>JKj|on_uI> z4hs`&Pzbm}kyxF*%eROkM8wSc+`8`En0W#&h#@+l<N{pK%|p~j8=akH!3DR1gKcxG zWAKKgv$i4<BrBPcS>@=`7Xr4K(kf14cz*{G+1%zAd3d|v;E8&XiA~&(b)*CIhw!W+ z?((ZCqgHAk1)hn;DIzwr*XH%zW{$!l-V0)=7YgEEM3hk=GryOj74V~HHy;2Xfsg^c zL~jUf+UyQe$7Yt9v(t>35z(MTR{)f#;U25`hknBfNz>_jr{4N<T6P&QxV~dSu#4w0 zlYm;P=kSdINMOh5hlUCj8*iV9=ZN4SLD4h@oH&%efnEC;wn<+RA@<J~(?qcXQ3zge z;^oXkN}v%E0)>FXq!uMVkOPq#U6E~#Awwc`Bd~^w6fD&7Xp;;^cSi>=jSfC?G5O|X z`u&ExA!bSqTvfKB4n8VJ&p&$Z`5gDNU;V%L+rygYs6fE_Ro7soAZ1U?+*0Oo!2|#Y zH)wjnwh$m7Q^^}es9=uQUx#mN!11`VivVfrfK%Y^ZuS@=9AYgD6SycOv~1$g$;4OP zO<Dm+K+ZE8^`dU(AON5d6rm=A(V<b2szn62{5-FlnyqvSvbjZ3qL)h0E}u~?m^#Ra zFY`lMSg4Jv1~-oZcitq(5|bEZl#aEDOvtZMO`f_XSm2O<8~lE<&<cpQM%}9_v7`!5 z07KM|THfY;LL(6tUpik}w%(VHOYd?EY2*MPD>q%<XF5X=0PqVgDM1qJzycD&UT;+w z+;ysCh=7RbE_qaZzWqvuo%P<=Ef7E|7)wMHFZnnRrQvHR8CyRJ%@gB(TsQFzKU}Ua z+8LB8^ix`U`5yU~`tm65eZ#5(5D?W+;m&oyA;=&C%)W9`fe54Lqas6v6EqINAu+?y z7oXpUSW91_QSg>CkNR=gf*(`?e01}(Page715tKbz>Ob;#PmbrJA={Q7yiS88?W{T zH`D%6I=K0*ul@A5zWP@h?uO`$+E-<or1@|9)AHO;P<r_N!J&6vzWS@l**Dv!eU1tM z*h@BL5D<pmFyu}^>RGY47KLo=2>@b))6f&o1I|P^YJl984g+RFjWb@$J#T#nqKGnT zcL5A=no~aZUgWR`&hT4>t1vc#5zy)GBj`kL2yrZ<Wt5Up0cMD(DU-DG=#_;#Pofbn z#oAUvtAr9G7(~#b5f(cz(WO(j(cxT=@pY-ZD)^b54+v9%T!%+PlbSVxbD0CW+=jLy zRkSHJCNXt6+@?&e@_5$}Syftf)N5%+fn9v+DkCh5v(8&zoKEa{#-YU|3p+-w&?wl- zc-k@xdbdf3m=H1xq996P!SiCn#Cb}=PESC@Iy=&cw;Q}w@DNl9Q^7gEQs+Ip^L*=M zeGc=Y`*+r#agK@%0GgCi>Dpb`y{GSH#es*4A<{XS`sr86hZu5k$DX6eTZLiE%Ciyf zi$6nsYRqxm_lO=40B%hthkd*;1O}XVd~ET}QmJXl0wVwV3E=G$p>M?MkKJ}J#f}Hb zgCG0D(z{htN1EPjyu>4pM)*naUdI3GOMhLBK6CWkk9z>1682tBCQral8!vP{{lcLh z8kwB3b3z1350yql=o5EfT8)_iATO$9MnpJe^%RqLBtA~!r;{w7WNpICS=S+ewb3@S z9f!69$^#KEKq(1$4lsyB73_E(2$EI?1wrjtIXvO)5>n{p0syE9duCHbwdFt+04D+m zGiizo$kbsmjjnJMjz#**?tEGn1{-qiO>qx=C0fFty7OH%JwhO$%{qI}*%9+%;Gn|R z=v<!$3b%f(?zPB*ukmOL2oe_4!j;Yy&XsN^4WM{(;R~yhNGA~`hQhXq6pOa+_0Cpy zc>$<<eDe$hE|dWqWzVOsuu@oNQNtb?b@fcN!+|<Y)J5k@PtT?@?<29{i&Ubwxx*o0 z=$mU|6PhIAPK6kYH{69<L~5jzjzJ=Z<PAyzK(W`JBWA+gS3WQK8xws4>`VCt2@pc6 z;LO8YaaxkDPq(se%J3~`P97rw3Lpcp2p&(=Ed>C2tDd_b?2vN8`3a97yZ64*zyH<d zg;qqWp&h~u>bGGyts};i!23yj@%_9v@2ZsaZnRD21hhg>2<qguU;9gc;PB(W{bT?3 zpB}yNIsH?AA$|Sl;Gh1l8?QP8trIfDNI|;<??7olfI-q+3XA{|@WkU2r{3}U%NI)T z#g8y9)m(W(U3O5pFFo{HSG5~%Gn5vzT22UK)O%180s|-%jZ&;*Z~-w(2vMuJXKKis z#uHej?5lN0*LU$&5%EM%SoTD8;3`6^QwsEhcn;7*iDt>1v^<&XV%cS0PL3yQZYY~- z_tnyc_}a2<-Bl5L<+r%X2z4@H_eqgSj7dz?j{-w~_`Qc!FFDV)u-<xCxc)(ZaC`p} zg>3uaXa8b^WE2{$36#-MY)GRr+T}LC_rx&}&Kp?lV24E@h+;!nf#~Z_Yp=VbnN@ec z-Ck&h0jZ6yW4Cqc%+9Tru4P}?^Jb}$017@{PA3;k0EoZ>lf>-YEc)C52=+@0fDV8K z&K%wsJ+UlhSwkQLKt>wuDm$uIOxOOh8mbpRtissd`_;+6_%HnNccq-9L~!fY<?n=$ zel36%NFU+I$n8kZ&_02NXlOxn?g;?Mj?MXZ^V`3<{wPgv#>sw>pI*M|WEMW(j}ZW# ze&^@U-~RPGKm6}}<O_c!)`>Pf*JK1gu~aYu0TBjA6?*|d78t~0X0Bia=!qYKAA%o& zyJb8n_)AX?o`Qj+hL!1P>ja${;IN4RZWrwcI9B?_AsUSn7HdJbG)EKwAQVMHBnrhS zF-jEOx-~kvf7*3&Hh|F~HLLr?PVyx@7wCD30cJgx!XxHB<50ysC1U18R>NCW9pSaG zn+=3(@c(Vd^P%nqt5Bf=1a^#sq0-%zF3eo3XW;bOIFK3i<M1a+A{D6$@Apz*`{MCM zfK*&urS}2m^Xh{lWs+e`RJW9en!V2A9*A?EySe2jEZ%zY{?k<G7=I0-s)@)ZH@U*f z_4d-PrX$y+(Cp?%5icPVZOwE<_Rtq7=|GW2i<DXAu8>yAj-j;oymF!npj>8-wK|;F z`8IW^R4;E%^&WWDEqf*dqk%trTgnLlL@oYg(xgokm;R7=4`qmulDw44XZHP9#Qx)! zmpYN&>8pRZ-2YT@_}RtZr@fm=db3dgmw*6JdWaR>?qQ-Zclmo?`WbrrAH#D$Vgwp> zD=S!VXc`KLKpHM`dHvWunh-j9J}zR5x6nSX>>l_&a36dRIVPO;qF-q*7YfzPZR}}{ z0M_d*;EqFcL27>=BaJfU3&-k`SI0-%$4ayUMN-M&1(kU%NbCjxkc-Ornqz}7QRKa} zRmOxH2|`ZfnfuE{jbSov{(vg+O*m1BT9;k95!)5mB#FI-UkLw*d$H0gobcd(X69m2 zh=|%e=kuDl>Y^=f5))eQg@%>gn^jIrcs64@{b_q9NJ^<lci(Lh8@*#bRpTkg>^M8i zoOSFNy#HatPYc!1p6^-!r$AW0hs<WEwZ0NPTuWMF+Y&Le=c*C=%42<K-NwvvK<>S$ z@Ai~KV#HF=qasB+Yop%!!od{OZj-NBmTq4vT=Y(V7|ddQ<C7E(eb$V89E*SP;JMMO z|Nj1sACq7GukF|WwwmSL!~h212D(VNz=nw0sdG<%;(x~~0$SqCY41kbyLoo<`sGU| zOkX?Gg#$16Tpti&Qu@c4E5=Xoji0BZ+YmLYS7m^J=ws4XNciM}f9YNSPKg%+ul6Rt zb2RB|xuI7=k1$l+M?P*@nQklgDi-is`8Pow+zpzL5Hv2?D^|ewW9b=aS5Z4UTh#Yi zb8;1Sv!SK-I0%_SE0X%9o(2oev#YO_ikP|Q7of71&2bT#w+xyEO%X9lqP3!KL!{-6 zY(4}QwuNP86B!d5Sk8h0TXieCdKpq%czdn+5(sJMQj;H~u`a)TUJoB~mKId8nwDJY zoON?RV}QxiaWM5XNQN@;{LD*O1Xc;@*{#{Ge(V53f(C^pC@8-4LDw|Ged2*)gM22@ zQ$1LANZ?g4Sg+)akyQ)0ZTV-5Gn?}VD}yl}s$@tPKq!UB{j$u7QtOUv@jIR?KRNQQ zKlsM0|8^PQ$v^Uw7vK2X^@XK}+`}Q+2$}`(RBJZ<%fDAhX>!mwnF8pcH$8R$Rd*9Y zWB|vQFl*l`^X})^W4SkmuRN7+pUT@~s87;?6=KF2a1PFLHw5AFu}I<DwkxFdx3SkN zI__F~pRpiF!RP^*Vulh>)XbwB;DDTE2+h)4nH7>E&;Ba3UJJ9sG#WEcOTT;tUXCI= zjZ=`+<6`6mE};@xqA|0GP-v$^=u7WP7ZT3dHu&cSH}V^A4)V9*;h5tU6Shi)>pH-T ze0c?tVBw>XjdAwy%$MF<Ke{zKc>VxB@bQeZpgZK1urMMMSVSRG03tFynX+e_TLICg z&DO-ad8ZTjmnTvp_ZQZ(#+0owz(pi1yLcZD)7=h!l}`UY?8&Y*NQjsW6J|bra9TCV z7P+J4wi2!6)*dMZ$E+WSR&{R%0Ph%B+G^@HTA3^KWzh)n%<S1jiIPUz`ap#7a|iu_ z^@);Sd#pcwdP*XZ2ml-kXaqfdQ@IO>@0jO)6af@UtRT^lDw&iZ>?z?!t!Ju~J-=s0 z&xbeD<#AL#inDj({NC;2dv7+)#3N3%>iM~+Sy2_~-0$H%-x}TjTi>VSr(ALa!JRnB z7{K8zgOLGkP-##aE#sG7$5Jtju7|B`M{PAWEJzHjoGYddoui`clZ(pY{*B(~h2MYd zh8jxv(%)R2(Yj>Xc?5Ue1X^Ex*6vUco*Shn)AD3$7ld##6LAD%;glhowK1-Wvu9|! zq=}Rwg*xE;8AX~VPba<;x(fuZQvh$q{wh45Hpn4dKF!;cN?pWhB14)g6ih`(SWZe? zSkk0Hhjgmy%S3=MJ)f4-awWTa!zVtY-c!%kpzFLh1K63@GY|lKK7Vo%E;8#N!|GlM zW&QK4h$zq`GgsQ7^&vG032!9gu(!jjxZG`&3BN(Rz)iM$HwzdEb);=>Yi(EqBm!fm zUWBI%*5i9#=fLQuA)ppsDpV)$$P)dPP-%}ec%y=Z*t+%8Wwf#PQxf-YzdAbor2sdY zEG$9Y(ig=6fI9m4VdOQ+FoMGrG{Nyyat70~YE!L?@Bg#t=ws&eJI}$_WA`K~9>w{) z+8)0<j-g5JdBo`qG()4L25u<%$gOCQz%YTYz0tZV6H%o!liI1nGmD}i9$-JEnjqOj zKLS(w&cnF|jHcrY-OO&_%A3}Yz}<)(IevUxy!#|K?1d%m6C%9+aNNVMzxdn#<Nc5S z?$^HcYcPFlaZ=*eKzS&oEZD0Y;9#B#Na)PHpGJ|Q$K%4*FV!NJJi=57ffzs#K%-Qw zd$HD$4kZ?K#?WjdcoV_7iR9SS1--El@|HnFnTA66#USy9B~pl}W37zRkq+>}6=;#6 z8MyxvKd74UVDqDQu%eJK7<0IcWql3f*~;Ip)on+l0o-h2LEHxA#^$!p(<4<vouxJF zHXkN5DaAa?cfJ;d<|;+NRV9)_LPA8X;EYfZjuAOSE5LwoDJO@JHZO}`J!{@yMLUcM z&qGh7oq#x2@qV%8vu82Ny-xxX01qQMFK4PiJUlu4arLn;oFDvT-g_nda;O;q6oMuU zKL9|l#nqW<&HwU0OCv>`5AGDh-uylGRIB_b4ULRXNDdPj#_-g_eWqW21ox(JqNq)| z3i*VMEGZX2lvsf*H%(Cly;w}%CCQXlZFZ!Hc<Xi4y4TuhTiC_#?<4m?Mk0NX7qUX- zP&mm1L7>bXmJT%{VOfYaK;Xysf8(ux{-4JOuYevd5(fgxS_^n>i~Eg}uz~<4gnp#s zJ$i7SWqwT;BL=ttVS&CPb!SiY0!n5xS3$x}x#R|XYoo&^n<7iQ!a~)jR<%BBZU3cN zNmz1_B*SD@AJ+NS-IxXlRdYbuIuz0Xmh}DuTy22Yt@J#XTf7vLVw2sx{4U*Z$90Rt zS>j}kpChwsg?R;efW8C~mcsenz_>4CbnJGM=GS2kUDre;9d>3}H*vEHb=-1xk(F5) z0B2_1CuYEgvWC=m?s$Dg&wOso^lTb#a>Y3QVuKr5$=iAsquBqHH$yDWMiC>>U@$Cy z@;`;o{Lup7-pb5+w{ZGs-d3G}2oAu#-E>=rnA<7(LI8@KhQ0a5jFcY`2ONxgkO+x5 zq*C~M8Qed|dnFt%G$e}qyhZ@GtWZFSc5ad2Km<|)NoPi^GE0D(E2CQg#}Q#J5%Vqb zca1wDp8yoB&a4uEv+0szk3dQ(01pD}p=2;Ikiz4)zx4P2vmZ;77<z*$T_9Aa@Ot}o z4Uui^f@T3>@eCr&EH{$qq_7j`S63SWWS)sCfMWzFvJap-C$nLy$Tfz|HdM5ONd(*m zH{9F@e%{KELe2p$vZswwrZ*FamBzW{s;oDir2;<P_O@GZL*2F*F;sSGqw5-~#TypW zqSFL!{r%e2=}y6^!=K@>2l+GuNrwJT1R1t${c3H{->`<?3i!B-IDG+7wj$ug)tH4X zs#I{#Y%8Gel@|}Mx$U-wj?}xI%BxtwB9iwKe>@5Q)Yp`qv54orWENi+D>B8Sbn<#! zygqj1rZQ6U;-LUdA4b>+0mFBGT)puRy%{h}3AmSFe-A$<{u_n3CX$)XkQwr###IJH z*i$@GJZ91Yy}ggBv+wJ2JS?T}T$$UyeA;XsRGpNXxOr$8-Ub(aYK1%uFC>a#TnGwG z3LNJ!&G@diuZ#E=I_qYa-9gruW4S?-iNgfomhu3=0#xHm1AqXb#N<mMLLfzHB;tS> z2{H74M}WhaChS32fVf7vdmjYwY)!mCX?<0StcVgi?8Qb{i~@jFz^~<nEC34c*T%}O zO#ol31&oAksDX&6l!|*XGl!mWi=y}H2eaF5BSZ?JX}kvCFEiW1R$)BPMi>GsOcS{F z5qbt_N`^`0f!CEQzH8k&L+sUV&eoqj&pHJO07xoVS($p)p>nBy3jw@}Mi^`A-ncb} zyXWjY>xd->okpN?o>$VEdEOvZqysB=cXW{}5dS97AD!3Ff7A`^;Hp(ei)Qh)IjDP+ z@4WJ@KON`qem5@*55%w!09;0=-){WA{oJ2)&;KMPd*!$PugU4RVuPat^-;&k6CO*0 ztePqf01CmCl8xD0(GmJYT{yg5X1xnZDL(x1KUjX_uj#Y5bs3@Hg|vp#g38t=S~~Xr zodODQPu`L59mBYgeFLR801y)nVvgBQTYwZgJlg=kWf$a&H~K~_BQ3c@76`rj2ty|Y zWB@{70Zm>5E5KA?sx?PAb_xL|>@snP*wfG_eAoJ%y$G-f;d(=AtpE<Xe7Cw<@wA8_ zF<=x%3N(RMNVI1N5ho`To7okVs6|9*5%HU(oNVH?x}L7VTbvmps=}qS9)%TR(X8S& z-Als)j-QOzB#~`<R&mX0MWH<(f`VNl!HaJ2Vq9crSumtfU@uWdA#CeNY{9Z#?9~G^ z2RIULRRz0p07J7TcHTL0&bz{qp<4f0k}KDPB{fgbF(eUzK_~%XCjpFrf&fjPvszLL z3lVjk&0xZ=aH`P6Ohqa*FpiR_%*$e2?4T&@tXtp}`bV+5(g|N&5Zy|k*I*gT3UOWK zmR|Le>}>!D?7CL;+XS$G{<p$&zZnpV(=R2b-|}9(mpjJCDC4FXaHNhjC;~$G`iXiE zqK7Je_bl>2pSI^OW(7ia`U`(KIXog{Kn777VL&kE<{j!%`r7yY%)uQE<6I^sqo7J5 z*43h=z=?Mq0(eDjN`a5aACbSUypa8k_7v)=HUJPQAdqPZu>oDx$cX?<O1~fDp%ITD zAd!;7N(>4V<_s)Y7flJE2Jp_6wa1=71s{563fLMlVv$B&N5DJptn;N$57M|7W9aza z)Ucr{)t5~VM(b>^$pYRmoVkhLmOb0jru%8!i%n`wT(w@fY~!-y_c@A+2sGpWY8zgu zB2{O5)d7$)EB!1LQ2?^in{?|SS_MKC9PbNqw{dgV#J`(p)fd(Qc;{W=eO^W&B9aG1 zw$riSPFfoz%`JTGxfF&9K!5-N;ZcFR8EnZYA)??lseH(O9=HvAfP{5#`L>se(nu%T z#74)J$G%o>>R09oclhVKj>oP7c;^5xw6_)5^zt<VxN+;RPZIBTOFzr*i6fk3LIfp4 z;o<b1uU`D!|G9nZ7vdlPpZ0&-pIVqX0TKX|dmje?_P`7gN{qZf97HPCzEr-<5q}<r zPbGR6q5>7b+>UXxexm&3+wP_R@$Db|W8;7I7u?xfSe_3wjZ4~=n=9R#_d8*nI$#zB zKnRv40TDnJOn~F2Br+615u>1|Bq4vp_|dJ;J@?r^TKu#B&B#q63SqLMV{NC()G>S( z7#E-j9_239WC*>$lUzzKhY1h@Avl4Dx$kSi059(Gc#5M`41&TX_d?}ia|}l9PCYE* zS%M-jB87+2N$#LzE1Vk?gk+R-BZ`DLarbfE#Iy81$AIUDWaeQO5oRu@Wic&^i=vno z#kf$B`pD-$vXSt?>nwlTOgb!5!=^(u_T^l@LGGl-(&j)}GG_@xyjDkA$NIY5?@c7c z_UVOB;{d?K)(1@%6=_A!=%Mp%KmdS5fk9wFE8tv6E7{)nfN0W4DRS0NPNp6G2J6hk zpeI#zXaO%;(dOCyttdL}liviVwu>QLfg|mFt<q{60o-`ZuG>4k$^E<@=DnAb>6?2a zG=`!GzxFPkWB_mskN!IV;EM;17Z!V;C_I!NqY|PRV&D<^k@CH0z;}OYaPWy6kG^{J zwZB>r{X=~-YibxgX4(e;fSU;o-u#)pdw+BA$v=GlZ~mFnFaDp>^IvJ3aEF%EAu4j+ z*Dw6g{{C(M?iX?Lo<dM0Jtc<V!V%Uf+04fKh<)swaXxkBt;p`*@Fgejos5qzzI5j| zz9b{IC4zu01v*8G%t*g79R*n6xdXCJin5ZpXBH=(_9N+=s)%apI592;6~~~^5TZeG z-maoiih%DFz}S5LtG=OxMCeZowq6Pb>$Rc!q6knGlAFykrExJ!p=rym%L3lGgTfjJ zFcxQBcAkaGPMcd>Sex6>+}h<Xa3A*KtcQ&r`79WJcZ3iH5fB8o_Z4q2riJg%>TT-M z<lup?1GnMt#bt+QHx>%tf_=w`!3qSzj;5$<?z&dYEP%B!tDN+im0X08oWf*>GBAZv zVvul!v`AG|;9;GWQ6@2A*+W9Ox`L{`MrbrH%dW!cgR+2EdIjy21$_->v2>i_#=AN_ zn)W}DOy3;zY0w7&81>;~A@8?M08iE4ch6MGz&#ud;rH*4Gog|4BX#!r=l@vQe}#@d znSSl3Q)UC4HMQM2aq0yC05AjxH~|ZC{&w=w-<9IPefjsbZj$Q~z-{r`64mp+_dmJu z!snBJ`X>et|50MlXRKKW@%1y67WOtx_jGx3QsxtTTk`?9;Mp7Y@t{vrhT`_er92fm z4Q|*dMIDJPH{B{C00sf*MU)O<nzKKHvm5}xF+Rz0Vx_M*5I+HHB_ue|+5?F&EEmC4 z%J*8q7SfUxR(URJu0Ds;UcP-MnQNpB1(;eOyB_Xi9srh0&kkF*i2&XZ!+C>4bXfpb zwHeI96$p`cetI$u2R^X5P@C(W&oA<AlR>tC6}&<W*jvxei}PZ=FD)AlfP%p0`mqyB z53%6zu&=bLs3njMz3&A})w0P93T~EOM1-=LX9YX&+j)<={1*|Q807^ent9rHf^7=( z5fP;+?#D`#HkvdosKwNX!2EtM_s%Y8wQCL1)nKqllV3n|xZ07pwi4h5%XsB}ta{VI zrw$+gqxyRXeR%81!WS;?(|f<N#}9mR`~2{?%}LV?&#VIBP@ea4GWY!&KQ00I*5?60 zMjz3DAPvb%xl$!!Br*@66{i58l6`coo$|U|&>aG}oQR(mum7D-n%58RXhJxD>dPEh zBv$f#UW&6%vvOY?2vaEshiW<n=fQgbfj&)By!ZA*E@BuY!9{~gBPrC-oc>+S7BR4i z{Si%bxtNOgf{6W8J{rT*F+4a0&maO*heLxAN^UFUB@g1f6;y}{0X41)6>v-~r0hyp zPRrh?r(+!eHJjmQ7x?MrfHDH0TQ7h&sh3z!@^o!3Xd?3BL%KkKlCCs*Su$wiVO)bM zz=8>mh=N;M0C=6T=f&Ylmz`&>aISF742TBAfC!<)(Q=cQO$9*PGAaZ`s0mdFA`<oY z`X8_)SSFzg9wWrR6@uR=E4~ZEa$PxAD09$>(Xr-bY0i#|X|Z7+j@oapBOUi+B7)(< z^sZczw9Asp^}C>vaAz0v<x;4vhEmG$T*_RZPI{fu;${c+bnwagd!AvKf<hsXVFbfS zQvT|}ulylT@YUj_uf)IO)<=Kx6QBM406_6T9evzC`F3tAEs`l>Jz$k0+prtc|KQhT z^pg4qe*zx<`sF#5N)<$r_blK9Gy)Z;@$~y?@vYzb@f&Zyan`y|ExEf&E1=a}**Ys^ z`pz$^cYm(zf1ic~70RFxLZXBKKtu_8gx&zXlO(}|Jvuw*q6B783Xm-@eD^)v>&cxx zjApwt6nlcL*rylDj9du-gmAD=X)5JRQBedpM=(s_?I$oU006u|-=HR`^W_o5vlHQx zg#ZXD)(8NFv$}N16{viLmRHVN&;yjya_{b5N0~CfTmV<@Ou(w6FNzQKV{QYqtV`Zw z4d52Tta5EJ;I(Pn08nQ0%uiRi5I?JprzL7>s^SF%R48s6e8*>C0f#%5({ge$sgr8} zzyYdd;IQ>VeFkFOrU@mwk}R}<qM+zmf?I9N&1Nc;FpxqdWTiIBEm#Ag)lgklD`YYg zz}OVqZYISAWv&*wD^y3%HfX)cTCO3Pt7Ks9Yyq!n5V!Wx%eX_&ra9=&<hy#=k|fUK z=cnl_W%|PSov)0~&c-?1j@=Urk34*TiuX?7>;b<$fs(%u@ZWsFjDi5hXsC}~m8Y*| zIlOy}o}sw?1^)D(m<&H-lRMS(MlS)taPK3JTLiEpjD-z>2m(r!z4Osu_?@ZB_ixJ2 zywUs)p%O_o1(j>cuFFM2>?Hho_|BIP(wD5i4`2ZxB!nSBq$P9gMZCzQgsFo;LJXh? z4))1f@m3HK35*62IGNyi2A_T&LY88;0Dj;jC~Z$yB%Q>lNQ#V2gs2b%VgrXmn3Ny_ zjuAi<VN4h)$h^$_xcv5oL!-4eKnNN^k=7azvy+JjVcU=#j)Z<)2$K{l4Oq2t6qxn$ z6#zyN!GON81~uT)hbbZmPoS#GzAg;s*0k+QT%ekj0L*H&FNdZ&U_=oSG>DgH+VO3Z zdj`+s$|sh{tXrtiPA=ruhCjBjljF$`MC;$nd`qNKB9>gnHB$E#wnk~Hin3<z-zpZX z&}O#G%FA~NSQCbfh#*zYrKLKnF6!JRPi@DZzAQB{ETDFXcxK1(AZ`<uI}5@J`eUbY z6#*RDx-9<Y8F#e0s##oJR($6l+6TWeEzjr+f8NHopT7OSoj&+S2=I{}yi?*YT;OGt z#_`#GWScztSMk%YrS9D_@+k0~dn$9NNbT+Y7K~TRaz=YEw@t!Cc*A>zv!mo37a8=h zr|}??ld^fA*mFZl0s<oT_Iof>GgsQ9K7Hqlr##7DGJc@F6C&vElTvuD{o8M5goH={ z2$or(C;?Ic0Hbj-6<e^5LC<K*Gg>cN!IKL}Mi$zee@s;LaGLeB+%^&=fkwgR;;iTh zqnH4|C?JGIZm$&V#nfl<o{w`WwDtpI)1DgiF(S}}ii|>^mE~K<94W7xB3%f+TqA(B z!6?ES9H-9foZrg{Fo0Tf>Q?s%pa-Z#E<oI7>?Sb5h9*cXRqIyf$VZp^FEy~ZMO_#H zf(+J6(J2IMl;w+#XjB+&%uTL83%Xr?Frr)D6Ysq%oXxB&9T5pg9rLa=Gxj_aCk-d@ z!{KS}ShwmG7FR_mq&9ZxNh|xZSV$HmW;#lP^t~J{X68^4q+=cTqL6^5j0zGO0467s zjoK<~PbZs@!P?=ipBzsDR90PHJi{!3s28;!rJYeYuHu6BJG!7TfFjJ8Sc(vVJnNQ{ zmo{dnB`e?fr`gy3CiQQg{pSBrrO)Hd&%(F=kpMWsTSoGx&O#Sw4@zfW`KNyz*-rBE zTnPZ2J7Gb1`du!^szCsMRGYrDlZFWpnT45qhSEwOFx7Co2aN(aD0KDfhs2P&2Clc) zYg40c9>u?DSRO@m_SlPnNpN(i03a?fb4~z6XcX)H2ngUJlcUk>u%LJ=&VfPh#WX1p z0M0TwnP4{c*5`1$b%kAI1YqLuG>5%mAeTUGP-bFc0l-K@%@#DEn|TT~;k!pS9;u|% z8UdmJ2eG&(MC2vPoYUwNv(kzJ5uJ721duEABI(R=21}T_0HOKzTB8%2&aZ$0+y@-9 z*kHMKvYtAddI`0Mg*}&(vU0Px>0V27!A8B_J1-!5u~Ya4aKsj#LDkT;+)$}_n8brP zN+J<?=PU2jJ#N$ebi=^pd~s?V6s<7QXcQT(o@I~Wt+Q-{a_9vW&hZq9u%ieaK`EtU zt+Wcoa!Z(?!Q~Eg*;WeGK1!=7jrQ;EYon{m-{pAiZsywi>3nvjE2hPzdE#0Ey9x@& z&M&y3Dicz~wV8J`L51x2Q`0A=C;J9^G4u_*Ujq2@aouL=^xe<FSN@+;T)4;IR-@<j z%}=1|0lOj^JvU6@$^FZhjL+|1oZTlo1^_*KSWrLs;(-)n7_MG2-2138y+#3?ky-(d zEK6W7F~IE@UR$8r+D)W%1sK~1Alv~5o%Ev@Z$!%TS>{Em3TC2tAy47_Bj;UA2QlSi zIGMr=M{v-e-_wwM<~cc@z=Kn`cZ@7B(h!wh9fw?`1BWO*dKN{1vy!BGmcarB0LuY& z3Q-{U;svHXlSfepxmWw>B+ev@gcnkx5OJ*q3`D00R-_NuZ0iLV^je;>%mx`NqY43r zh&h9J#s#TRLl6Y6S{7wFEsIHEGaCSX7VlQG197q*D+ian*^8<JTL!ZMmsxn1%{kGg zPC|jTx=4M)fOc88kcxUyJcy$-ihHq+=TOP{IA2;8>6|3a?;fJ#qzU`6R)j_^E*<IX zu6x;a%)HOQ%!_r*!eX5j5oHu9MOCNEIa*mD&dMXQZpo8TvK|q0Wn#Pw2HE?zZr=J< z<)jmR{eywQ^1OnZ7WS?RBhLPAd;}r?&gXar1q00QzW`ojAM4IxJ<Ri8001e+{=Ki_ z;YT84(jWOF*uUlXUr;wc0k8d@%a@E#AB@i)*!~M<@@^e#OSPbqSP8m|%a0ulpVzt% z@c8oGrleRT_n-*w98hF1)^dI<-pLI@73ttio`-VlS{m9Kjq<6ZQgEOV5o88s4unQw zq)CD7NAxt~#~GiOe2_q->CH#@IFY+U)C9~R3<7Xt1j8P@@d%!d!3p-tvSWo^Y*NKJ zqx0w)6af+@eJTravoxO|l>wk+Ac9yy;pJB!y3<1P7Yex9+VmR{HC2ke^DfH7Y4Q=t zEV*~B1ste(5@fJ|Sz=RyfZ%y8AvJ_oS6CYWI`%Bi`p{R^mChB;7M2v%u<sJQ$Jp?i zRbejkCY6GuDCEj^v)#7-3M-!Q4(QY7bGNgY33k8C!*%Iin(n3h&+VJUT&WB+q;L_L z)CAW$Q5B$pACMtj?b(dH1erO+5fGDMq9b!f+tQ@bwl~<N9pwAzf_A=bhHJKd=OSR- z8osm&oCBJ~)cTWBDpbC0xLo_n*U}dOa{B=a;I=($T2p=F6V-RW`q!d&e-6tF{HebT zH+~2Z+xVPw`S|pHe)GrS{2k|Elz=8U003l-@~C_`X}U_AW;Fiuc>mr@|NXPC{I`jm z{@ABdrJ&6C{FnjYZeQ)Gy^tBPqV;sqeLDd>v8rGks%mA}!$k&}hw}`7_lt2%5)u6R zL-%OPk1~I5{gE<=aFJs_mgo1W$i)>R44@#=aL|LZDL6sPotWuFeZ?`M1@yCTYJ;TF zSvkq%Fhzm61#DRk5=6oW6TYw<Pm1_v`wkPDNCS(ASkC~U9TPJ|y3mNQJ_)Oiyp{+K zAZ6)8bs&g<0^3__0jq`>aOm2Ev4KcIq}}5Sw(fCO+T3vf`WFCzco45N3tHK0oOf56 z=}c=0Utv(K)<JQ$F$4?^>VlhVlc@6+EIYV90tJR9HVdt67SolLQG=tw_NTtG9p-B{ z`%y@C?v(z4kFv0Jpt|ZN<fUqcic7U{s8A_YCor$sj;o}k?R4pGHsWqcSRLTx-M->y z0fV)as#Ztfp@tg6bd>I#gmpl(WOexP2;fT#&_Ogjd8pid03cuTY-8?z<i{Vp)sVfM zzV?4K$@$|65W-;(BQ>YT=<M}I0UXEsjn6Ge$*2FoM}PN!e(_6xuE>762YF4PLz31K zn(my7mZ(rEn0uHyHVH)$=m@{`7QT0e2>9wq-AEV!Zl)9w-tN);sSi-g0AM|6gUX;w z=J$;>C<HG!@eS-5olnc+$Q7e92LO$tK<+)I=Z-K$))2u&_{BGhpSYXu4{OLQc$|qB zxsj4qm}N+rjXMuBY9-4JA&4RI(kDFKK;0&yxqS&RAuL#KPzaB~ynR*YFi6=fPOKws zQez^mQllar$WEBc`)7{pN)lPxN?gZ#W+8wLOZ906YcANNhGH|93F!9hcyKt-vDQW} z7XPe2UYmH836Zdv79p){4P4je-fzUH7X@b>5-Qc~rbGFGv3DC7lw(Fzp`tsq$zv8G zBuoZLx|f>Bs7RT}R8F0fNoKP--+KmQN3f{(aT7XJkfk<-mtXAaK+rQEa-H4w41?bS z`(!}`XV!FHeh3Bd%J$a{eMisx^Lu`FIC1(A0FbTE&+p#;WTOC{oV+!B0geG!z<G%l zw4Uhfb@V0pLdbxg_c9yqee~h|UrLc<l$d=gzHgmOe9u4aJ^n6!<hLLEw*Q6w>Q~|T z7l?oqfIt$8N!v-JaYw^$x1EjG-txEDzw(lfQv`rWSLKEIj8OXq&k8YwFZK1Yg^~dP ztOw6P1bP7rBhsJ<tOo~RvH}4j?+(e{)OILkRNALcJqpAICbPvZO8EADI2yq1JqX}M ziN@nGP75U9pf<3;Ss~-X-|o{SV9s{$rY0z>xN?1JSfqz|1Yn~zwi_x$!o|vI+qBv% z|72zn34P6c=?voj&5=rsj&!rQA}mww5U_A2(PYt;72M-uhF9H2xPwV;lBqEd6Uyr3 z1?G=q#{u1<hQ|u@laA8GJnBuEQEh<{uB0r4sCI~+c;~05(~UI!jd>txS~6{aAmprU z`n7=3t&CEm6j;n4QHhDQ()~y$QJZI8;6qw%^?oK{t+9Yx2xTn_$Gnx+0+Ev@WmGaq zbgXxK&7GybfFzkKLDF7jW`8Ix;1+&iUieM^oA+2CcyxMi|NS&NjwWw@`}O;K55L)X z>2VHeQe9sse^`dxL;m&`jrwz#J?5LAwLkR7VOFjC;zxeh$L{~tBgzKi<I|#tJO=z` zsR6(pe-8k>8a&mnWM{unmbjNv65%0J{}E4`u$~tEcw3E32ms2NH>)<Vb6?%7Zx)hJ zW<Qh;ODD-J7i#L@)WT_j_ZY^ErNEv0Px{P;c^Jvw0S;4f3W&fu@FgS$tOv)HjC^td znuQGaQaVh@i{us!$Ut*GYq{$MK60pzM)c;1A9t}{gi2H_sU4wOQX%$|HHoZ^ity^v ziiq=4ddutsywpM;Zx9&`;^b)1u^o#U9{~&q5M1FF`-gAHvo>@=&tFgz`2~>Jg?9@e zS!)@=T3G2&af^t_AgLf571j93O($<NoULn@AU_C#c@Z=;xaGsohc6yhDX+L`vfFij z?fS0W#hHw|mm#&@l3FLS0@G2^^X$(mg{!5)-z_$%^U!U(5qsi@=8Kz^sIQ^x;QKO? z7r&ss^Rw~HwCla|_g>(CqW$>ZyKvYHMFmd_IVlkUw1z0bbV$a)YY*|gQ{a>PH;?}- zEhXQ6&As~XN_rSBxpDh*KlIY4_fCF^y&Ru22q**<rTXrVnuCu7ig?$5EPo3<!)ITj zy%YuxZW;e(L5(ZEXv#FuYs<QyqXsF88Gv)5!`B4>;uN*P1B2NUPN;&r3wJ6keEShn zAI>a3$RYPwGL(#kuS~~-(vMIW;H<#$V;H4ycfUf~5&%UQX(*jcX2+rQFwOn<PW?;! zYG`0Dh4B=goQX!S33#Sm+#1qeD*v+UWFqQHW(S2<5o$$BRf%S_E{CWg6olXb6o3^e zSsXy}-dRNGN*)t1EhH$-{%;jUu%=XLMHB^RsW1E-qOCn$b15-w0|C6$AplUv+7+(K zxL#LMHAft7;j`?x$O>1u(7ZuJ;z0}oQ5vOt>00h{8JI~#eCY!i^(u}3>pm)I2*=+0 z@HcQJ0G8}9geZ-+f>>I|&_6h3WEc6n<7}G_%d9<22TwqZhjE1-uW1WU@)i8dR}sJ> zvImZ4IUk5nxS0ifZJ^H2Y$PxIru}HHDA_EB(xS$LK0Is@z>lWz>+iz9^@@%o5I_cC zfhVNCMS9P>BVPako_q)G7%BlQ2r?Odc69tp%#id+DTwz!cKAE~<>CtQ-YdBU00`jH zv67qGzgd_zPPqe#U!W3zynw8Pvkb~oKC|x!M&cNUhYA30CUEX}f-+ECm%<3Z!wkPQ zrZ#<Yp>+i~565FX9>d)s5CJo=fI)~g-tF^~9M4LcT6p!y+&EM?Lm&acr{_QbMnR-7 zvl6m>qjh<z6e$xCY3c=Acved5oFD)Ju1(^t&rBU*eJt!3z^_!{v?7;AT-e5Q63{T$ zHSf99NSKIHk`1z&qckd^4C?$QS<p)`jUq_c+wW!P+4`caMbesy%8*K0X65OF(@-dd zgoDF@ij*rI;=FI`hTMlem(#M!123(!4g`98z2S}FrWC$*{vUc{x0n>u^XZ07FRG-S zt+@HNtM`7b*lr?fM<lFvsn!UhS&7<+qF%J)BzIm$xe~!gTHZP1lUz=w{xp*>+-S-k z`fv(kzWKw8|I7>V9*l;=0kow+O&Pv^PKRTiD|%3>N2R`R)r1N9@Nz!&QUCy!7kKt2 z*oi7m_VK+qe>;BouTCF1_AuC2aSuzHq?7Mu{a5STQhHF`zW@LrfkWkXp{@2(;HO|7 zl;*)x_{I}tfsuii_hEwSsaGeZzNOs2FaS8gQ>P;2h{Q55U<{%FS_QDoS}rV%IHuvA zoR39(wcmtrGnIkyV~f^dKzIz?GL29x41rNX=tYPu-U6)?z&g=s&x8_5_Ofu6Km=51 z9u=)QrQZ3)zM%q3(31>+0IU@_4^8q<SY$&B_>!fY5@~=*C&NU-beI-d;c~ZIo}|)h z@Alrs<BP@17w0^8vT2HXQItlcNhw8|vhyrE&ung|r_)ewD=gEqX>Y%`WSVcL!h7eB z-#xCOMF0S3RyVaVh5u_Xy!YF+oZ6DJ*Q?h}mLZrTEU-O(;?Av*wjR5>pzA}m7_SX~ z>)3?U@yqa;S1C^0-B`a;2SAaOe*OFTSteefWW*cmV!+qaVd1(5A{Y&}5U~<F`P@g; zoeOv`o0Cr6ROh=CKR8M4rK+z?Dd#FK8-4M=0AJ$t(JL>VkT_e)nF~ZO0I2*poql&w z0Ao}YU7SwgJMY1?z)9hE088u8F)vVEFfl-(^_0}xk@_}Jf$D;lJ*GdfcmDY_U%b;$ zdncHA6h=aUmORo$3phe41p&Y_L<SEJuq=g3u|+lIR6|VST;LJa4U-6yMCW5+@s(iq zkWWQvhz72tR&tVg0H(o>O8{<N)>80RcPttMpa_WQNZX>kyz;z3t#EzLSLBLgh#3=> zLJ3ndry)f;);iH`NQ!HjwSbVK!Hq$7p4FHY%IMxG4R|_aDsj8g<95C>%kDLA{q%Gi z58~$j_T6(^$uecAnlJ5Yx#IPiZ;SOyYtz3&dQ=TJU3&tyk`3EUYzvlLyRW)b!(v*5 z*o2Pswu`t!^V+KbMeQ)6G?D~}Dwyj^0Ed5S)dt0}J2@d-$pYSWXpr1W;lKkFjKOQD zH=px$%;8GIKlfW?^g=W`eC6?9F&d_4JT0UYI6Ke>Lwa0tjl@<DD`1;yt~0IF>^11Y zuU7BK8nDjC0%rvPl%J;4?;!xXiMszQ^7M7}*3T;)dskd!_?-v93>h-)wI2S>&#H*9 zV{d)t{FjD%5F18hKo0%PXMFJ7QI<<ThDiYeRj;#{BqC9kRJ;GOvVa8<AW_^0x$r79 z(nWyCplCF)<WmUX8^JuarC1RHNcw~X#vmhkLNYEiZxjJnN@86Z>$L<_zlQ*nEK~0- zLjhvSHCP;L!P7%Gh9H1RV>vBXbpN`jxAQU8)~tM$LA*yL7%}9Uq0w88RaiG2q?<U$ zuo)W@lvXA-g)74E;$C#{!oeDzI4eV1wOtUzOPQ6)Ald5lHrhZTpM0$s;TlJc_Zc#t zOk%XrfL-UP0xxqMYN&$kSmi?s2*|1n{ev4KVsl$e3h`okCJL2*P5Mnu$+&$FpAR_- zhe#;<#<m;awLb3ZTekDH2jofMcC6m8-V5C9q0mlQ&>xgpT>N|gopagb^tH3|pZ(t1 z^sQXIk?Y4|IL91wRMX3sv{i$gp|(gf+?r~XR^n&|Q-Z(@Cu2Cxpg8?&ANlfMH)r2F z%VAQ27tpLdpv-`8^qQtwt&|m#JG}GGI<{PQ)dqm^C^aos%bSm3zi^*>9v)BO-U;L- zh8|4_ph&t8sKP3FN(8l%ee%A<+)`j`h(H=mAD=vtK5=C5){)B283c$R?gIe?A<KeM zLMT$?;ynOB>@37d!@CEz$6{G5bM85_-m>JL7tcAZ#o}1!apI6m7QE<0aX+@1^?m{6 zPS$&n+8V`pfD5)RR9ssi7BaL5zOi&3I#ukDQyrQ&v>opyt4=m;9v(V8k|Ih7XZFMj z($<DPv=s=zPz`d`e5(!ff<<g@>m1|7k94f(ee`Dkks_O0?|dzBuZ=OuvvshCe%PA; zam<g&_V^gPL_^lLLYm`T&p9m#sqJAwxAX8{$G{IL_26RazC7_I@W+PAD7bk*l3c9} z>HU|)@4frQU;m{)KfZ`X)Z!%CpfG~^+~}mTi+NQ79^mPz^kT6N1|w1i3lIP7TL=Jq z(K|N|JwR1TqYyMov2eK-P$IsGWJ71N#w|z0>DkogcH3i<hYp1dM?=`_!P7D17Z3!E zLg@CdJ=f=p5-)6(sD%JU39sFUqX8WBp%+7V&8f%ZjP@fK41^FwYK*-q;?9gBpbe%P zYzelI#8odso>kRaPQZC|tXPEk`{((h3wY&(chmyTSkGDuc!?MT?1Qt;6)qfd*+lvX zc<UPp#(~t^NM49Nq|_E(UHsWwAMCL3gD<=*owLrBZmBKwVt&WM;%o^1ZZms)?-&G{ ztDNhS^o=dx3QJWH5}L$>^*5=xBLAv#=mgNTMjBnQjM<_H6)LUbUThK*nh=EY64Jz; zPw$^T3vMINI>mbd>;*S&#<lfBc8US7)YR3$XW@@`K3EGTF(MTPj!DdR?)^aC%q!9a zn*V)ymb)(dRp|E$8CYji`}o}5jT8YW0?#lhuBi_AeREI?$i?|vmw(@;c~yOBnws(! zfQ84Bu@rEO446OSeZws9(HB)3BU{h}j-gi3YS;sV0l`oJPyjSQ&$|n4F4Gn}4j9pG z%&3(v+u3d&(AzzL0ZnjgBx8Xrhs=T%NZVt;0Kf=0QyE2mY%A7J0L=LC3{EF7>dCDU zL<Tg0XFSdU9`l}oVT4A(!?8cl<RX`mRtl@vM?@7tW(=`^F+1&vg<Q%Eo_d-9c>#x5 zDD(t^UBt1rd%;E)@Fn`wMiY@MoGaZX3{_Yzo?gUhyn0IU(lK-%L^qyh_UsCmU*zMH zaWO7LL}?`~RYmWD?SP0tv;M&ge(x0vcvIHQ8!(rRI|ql5cHE0m5h7ISZ-_g)poOKF z6fn#Fjj6TIt4U0#rq!|5u@0D7A>HgU2<TP1qkphNK(?JcJ$n~)2zKP-JXDQ?K=3Yj z=h;?;SYg`AsJ%P$*xPQ7>uviaE>P$X5@MQwNa+Vi!O`d$ADkfzUOy1WGZn`D!JV{s zBbz?ie0RO`jW9H)sI~LCU+BGRX{Z<gvRsCJR0M+*PAA|PtDZRsUZ7wEggdc|NX{&s zIi)~)-d|_~Qgu9a*7>r+PZ;S@n*i=0*$#^^LscS~1;QnQNMWQP@-*-U3g7m)bB}!` zu>y^7mV*EgN)V-mgGc9hJchgbRhI+-$Vvb&lTto%NB@m4k3GY_q2Kj<GA1>_^vpzK z6`fFmgnE+Se(#Cer>78~#Ad9tM{={sZtz2NxSQ6piA6NZ=Dh~69^uj>NRdfQ!0JRV z-7W$o^wwLnCN=9$R7eV|CXa~hIj}7NP+EzX@sn{7IXco&8ntm-q?utV4TQ0w6-M=* zwM;jJLN<3nhd#~T_}J)xsVFS6E4vJHSX8qX{q5RlimLW)+GyB05%=2praZ$G=pAZW zuH6C-t_5wh(uxczqX?;(7WsLO3X5@3Oo~Qc6x!`w>Gju657*>9>^64KFS|-eLIA9f z6%mGhEfuQLvqi$Xc46Ef-02VQGzwr+)Tm6gnN}yLZ$h#7n}Vy7n>-iK;5_Ul;!8-4 zsFeCC<R0I7i~yJ@P7F+uF0?vDeWCQ!$;J4h5jeL)>L{byT+kgBp)=~>wmCBHd*_uS zx%SS+iZy2lQQIR=J>Fg33Wbm=nR*NpcMR_wW2!hNC>dE0Kpew3<Kc~=8}?N{`Q={Z zv|gdE+(h3wxKYuzy0qmXOUT2{BcM@sM~oOR8>#>z$wi^82LLKPbb84`XT3GY41qL) z(X~9Q*<wwB!DCk+^#G@3VzZh+M2Lv&IJ9^KORGErH$6GEZPW<jv9&LCmQ7t|Whi_K z8G-?cx^9Qeo?Yn<Up(yQuptTASr_#pQlulTBOUc39qZPPVIKzb<{6vTi<sdXyP&s3 z`49*Wm;fn7M0MR-g&0N6(J^II2vIjCQ4ciSiA7?#SiWk9Md(P<UIV_4SIC0iksPjs z!ok*aj0K?p7DQ80LiqkcQEt%mX#I$jgWli{Jo@_O&CpSE`A3_J;}o?liv**gVDtjx zQ#|#Um5=~`>cATX{Zz#%79|z~^T=zjNemUF&QRw_OjJ%wf8GoT(&1z2$XTdrUYm|b zhD3e6A2Cz{c<ypWfF3b{_!cTVaaAGkBK6)#xnwvmapG{s5M*E^Sd3v57H-`coQ@8l z4f+}zepB15p|s#C^b;)L?(evsqF7xzDJb=$*A_bwlBT)#(<J{85jKIclhukK1k}m= z#E~MC8bWfJ^;64{a=~G<+)Q*srF(7Twn{K>69ZO81<_mPWmSiY;H={+#?K9yAyU=O z*54^6MMyP5!kaJOR9gKY`3|3TL~Topsv`-DnFBsoo#hv_r2u_g74~cikf|f>t@pgT z%eNAF-pHw@i*63E$)kK%U+Aun-ghe61vq74Nm;9Rdx<CVfR4x#0pJIQ1-)|uSATG~ z@%JiHONFjAUA7BgAm~Rh>dRga_Il8Z;9q=G37`l($pHZNBYZvukg6sa6+YM>yj4cB zSQiuyhHlkNJDkY@lC&AN$uV<t^g3f2FGEkCS$XTky)@LR#vXNblR5XuGx+ErT&AQl zZN^cQkv_jD4=<()NdyrjqWR3ub4JruDb!Z1S8s547FA#w9YVV5$Iv-AqIp;IrkrH) zt&8JIS7v2?o`)6=vrC&&e>bRw6&73C71~?OHxU5w44HL~x#aqQXXkl3N|vfkwzPmZ zVj>$buc~pvtVi$kd>WQzDQlMi1*a!dTUZ@y?|juRLgwbz^sE8~(XqZ#x8M(AJZqrM zxx;KTaZ+2rA;=Z73Us9Bh?p|l<r(uy2FbR|USF;vg;~SQrexkRrih~T9AMqpp-dSn z2%lZ6(XZfwz6v3Eqt8sdvfUqiGluOXaXIcs%`JP|5~15RI790Hp8xnK9{pFwop}K# z=mAuZ9_Oe42HpcyU4{U_I}w3Ca#G<iTzZQRfC$fRJ&}T~)2IUm3%Ko`<5@d|z{_KU zPYSs|E$<E~QAq79_FU)!^;GFoicWjcg))B8nN0RVn<$Q6I6LigF>i1SP+EBBVcFkr zmywO~w=J=#X?W*b8#@LInARJe&A+Y}-+ADGqbz0Vib+{!Wj@aHi+r(4`06MG!ctrm z-4!O{nL_}AVFvXL?0I@R?d|s$kM1T<41UG7$i<@azF`*CT;mZ?M#cTOm=*|#8VN~7 zDm)Ph-~9DAwb3_Ux%q)Jlj|MNIt#kFpARk)VMU21G0G?t8_tW1v#~8~Rx$trfr(82 zpx@E6k7)P2Et}g$1LmBf(nMzYm|TAn)-$kxuYyClt-E4TC1S@R;1arxh0r?^eu%mu zZ6b;3={FC4<$n))|MEwzl}KLL@g)ltqj+==kG@?Fv#dCE^w8;JrylfmHc+?n{4?k0 zB*Fqp0}-;olVdKeDBqIbH0v1OKw*x>3pOFxbT{Sb5Ww%{_#3D0!G#|slxpZjs0j)O zk4rf+&{GgxgG=a02nbjb{^IDM^`XW<pGttpAQnp-p%8v}2yZb9wQAGd2XMXpx(<zU z?FnyNvDyVK<ASXd>&5!V)53CP(ycvOi0GY1LLF&RbiJ)q2&<;R_1C7SlhB)C&3Ray zp~A+9MujV+sK%+^&;p*nBSGlmU=o9B)$$M#h4?|XWRPcg=VuGFSp|bCZ@)4MRRzHq z+W3SXKBQ=LdlattT=C=%`;!a&dl!`*GEct4W|G?_Z)?_qvzQc@&lDo`#2w}y2k}Xr z(}>rQgjH!IvlbUR(m<`Z-C0Y%_UyiD+6*il^!U1YXw@%^Sx5TlrK8K&ei+*kc0`N$ z?oSNFr@|R-s@Ab*?>%WkRQ=&|`-iWN_CB(I^zkG;eDn3c_l-v~b$j!gU<3dtW33EI zDS{Y}RBRwG;jOnk0O;63+)NG1DAxq%<eg_`YC>^E!VYlP4gvi7nY{D1ouW$(9;Wp2 zp^73Li?XqPn#7U=VXf;e5h|`tEJOeSzaV8<AY|zp?@7dW@ax59zn2cl+5@w;6nHHw zafPdjzE+a4>PK5I)~%2kY1#-30V^9l9i_IgYsx3Ei6yPJFT$|45M=Pe$HI~flL8By z+fXgK_T9tsQc$an3QW9)^h2yP?#<cOQrI55I9Jb5F4*Sg`Tvh4BDcQw9=pOFzIYhY z&{U-Ao$6S|A35Md53l8LLoqo2c<eAX5StF!unT5#9RqgW;c83^0kpLS)gl(c8phJO zAZ&Rax?YH1sC~7mkl1`&A$VNXLeDx;vaf!qLhrLu=|;Ux^_t)1L*EbhQY!TTd>?$) zD9<k2pa{ySAENw)pZHS;pZX(lJgfn~0r2UgufFq^zq}#ms1Nq=_%V2a%wsPF%@Tx5 zuT20Uv<cvlEZWUC8%M`gk8=7UB{}0$Fb{n4mGfBc#-$3oiN%w1Vt17_ce5siB5>}| z5Tr^X?~%LwMGfwBoWIN3O5gRRz?aqv5mlsgq)lveq|0epW~JA@LiMY+pt;{|HA2;C zF)6xJjzdjkNGVE&$!4V6?Gu39bE=y~D-tH71U34?x7D&Yjwm%teeYLZSl0JC+?L1n zVx?u{?4A!+M(<E5bcLHc>jJo}cfJ@GlhX;5K6KVXt)gDE|NQ<|)A^fk;)Ag{GV&kX zDF4+%n}~BnC!O=(!38}Rz@D8Zm}~RZ89dYRSWzTOFVgx>0=S%%)xpPxBe3JidNyNv zIt^8YJ2+k1!tg%;0(gbOiTWw?O7jB}G3jAC^hG`)BBfPu=>#9|NA<<0)bzMFFP7ko z2gSGkZglU91jMk)_Zc8gszwDD85|8j5ylbbh4i?!#I|DMO`}7UcI3`f7NH1u*1|m{ zS{RG+^sMlu`{s??SroN}mRGQZ<|j*JZR0-xU`3js^neHin0YK%Qj!h<98_SrbWWyc z(~y|6)=SxC0V5!wi4A)uT@{Sh`#a}%r2_!(*p)7nlP-~tEd9%9C5lK9vw)Ixl$Kf9 z(F(9;2f=pH@%pnvhLorda6|@}I!*}HCFemHaT+`2Hgbe6gmCKMlYrFfIRFTYGAbRV zuz@t+oS!<Gl`^l7(aQ&0-n;G7yNI?%mu3NGK!k!X9-axJFRUw_vmWxY6r|F+!Xe14 z9f;_}P%p;qfgA5nkp&-?@PB(P|HQuj(YwjFoaqq2ySdQox0Zte=4HdFCX|^<8vfh8 zZhJQ$|NCDAyjeGww%N87yyy>U!=v_ba_hI^{V#%oi2V?J>{)y1vA_9y{@lCY|Ap_p z_TOIivpqie;aAh83=y6@nSAjtn*2l^>~j<3auC2GaFL^pZ|1{0gW}$B{1}xCN<Wr{ zOFB{wyGntZHYP!d0S?MyGzKin<BKd2|M@%EBfjs{sU?mgt92VOb);kiKmg}jv&x$G z5}a7bN(t?iSa9r-JIiqKa(ofj+qLyr6u?Vet!DVly@OsdN;;0vVlC{YnO)lAG*YPv zMlCZSLDY+!a;|XAX8||k%gd+T#0H66VJ}@#X#^}X^%84E%ajnpZ=v$1LxBq}O%N!? zg^E=0?|AE5<Co7Mv*@hwsO50Mu&!YXnYpev?Z~iu|Hf9$iWW21X4Q1;xy(vsR2?C* zxud+mG=i+0KAli6qO25!f<#5>j4{@U^F-I6c`$QOMjwKCa0+lH=@65S?h;o?+!blN z1A7Jrn_EXNs34o@quWmJT3Rwy;aIN1u>oOi#|7CHa}5DEuz+VCs?BTvKaioH|H2F3 z{}(rH`B7tI<lNy|NebZT@Z(W5c=PqYd-;;5{g*F3_D2?fL&Li?yxX5VRxGw@Wlll$ zKKlpttxr$xe&!no&$CKzzxkK$y#1H@Ec;J+Y_}7@-gi|Z0e})2kQ@^1p^OOnA!00c zlJT%8r)Oiw5+B7#>O$iD<_G{qTD^W%5VU0zz4INXCAjfRAfsTPU=$JLP-IZiUN@=^ zb>kGa&MAO1gjCPD#Jyy$5K;GOEBr<P0Du5VL_t&;2(3de0}RdEB?yQhi!cMzDpL+! z>y=S9vzNoJOWa@+i?r%Ig*sBC&}O#ds?vKSibQH%AwSOp2Mln>HBWT8bJlt5ed)(f z$3aei{Dz)Rp$7WsSfwrG@5ane02EOG`wX?eA)XgLi~BJds>t#KcR_E*alsWXNL-OB zr^c0z9ryNo%uJ+6Arj0woB(?ch4!K}Fng)1f<hk;fyGh)hd_A0?48Xx&!`n4AYoYB z);HKKiA*Xg3i{vTNen-`(jlNDhqKn4I@$%L%e&6}N8Exqs}QW00G3(Np_e+LEWA{@ zm+rRaRUQ0}8@9O%da-xPhf)}u7rrp?ehAQ4zNaOMk}|zRw|_*klbd%w*LcZv`Xskm ztmc6+>fcbqJMO)&surK>iRjz^&Y!PXApihmdp|-5BgG@-!J0;f+q!w}R^ST>{?M?z zMf|YT8RHb`EQ%fyosyms0l-iB)1SN(9YiFI4>L_75MwwVZK6(T)zQ0VO~MfZfjGn| zDnhV=c4W$de&`HGMk3RZr;LOP5~TSHVUVH_yVa2n1ufOSberbu4tU+P=W;55s~97C z&moLZyCo2psGNx6UK~<?+xB-;zE;T_BqEcVDlSkzZK;t1kfvmi6yvgHdBL2G(r9`z z%}%m1x7qo$YK@=>1Z-{t_{{4Mtd5L{%qCOX6xm~A`EdB+p|BL=qMJj>hk%uAWm5@@ zEi4hSXJ=hGDXUGHy$^fFkP?rTmt~G9DhwiCpiWC!NLX5E>#^l{)sH`MfIoD{{FU#S z#{~jFcc<s8WO1`+=X`SrSyqF-yR{JRa*wU_CtOSeL<shGg$Cn%_+cZpcvnBfl>~76 z(Chi#hs;MEz3_#*2ass!BSv1JKZM`+H~ikq9hXcd52urdak38pRGe^p008OUokaT> zc+zyqBdec3|CSqly8ca(JRg48Bi{UMNAb`oo$xs_OA{%dk$$aIzgFU@hZ7HEu-}Up zy;T#U7b2xmScDK_&uh1XG<93R9cy(1?el7?NWKhvW7HYWj<<n^81Lm3kOqnmgo}v1 zy)^1Yp%U&{aL+{-^kP!3z#_}5mIei8pkSBNKdPYS;*s07K>{jNq-x`ph)iNG?@Peo z)kY_yq_@{ghba(fqgAAoRyxwc^7QSeHnRet6T?m0XBmWLlTI{Sp!why`y%*(afkH{ zHoOFrJQOr<apwhe3j_>cw>^UdfCwzW?3EB)QdUB%7WB-3YMHD6L1v4!gT(sw6PvOA zuA`GuWD_Xq?YE`&UaXfl2+gNs<1tT<z$NxYM9L@~DVmkfE&dG%!S}Pn6L;f0FoSd0 z?b?ow)>|M%zHdE`)-0j^+)H2-<WroSB9u=^%I+ePZ1TAH=Fc4Tqv+x-ApP*)_zM8g z+rJ$}d_(LpG-R|sbXuQ&Wl;dz_{RDEZ<&mKSj>I+{+F932FfV0?m$DrG9);-`SIJo z_s`1NgC{@tr_PLj=o|LlY5k2tdAqR9b!`d&09=p~0YD%Gg`yWZX~%xIABXOsY+vyY zQI-q6A!#PM)tTEwpssYQL0|->tK@JIAw?$Mx?$NW5q4-E)a-%=KtV(iiwlCd@(Z@C zl~e{Oi&SZ=TQ*1tIF9ACT*UiDLZy|~nhb@K;!s?xbOq1bstr^xh!~=e>e9j9_()#6 z1-u1wmuH)VHE${<U~{V@4OqE+0vPgk7O)6AR!Rv7BC1GBZev11a8M<<Ev{GH=88j? zv=De&?ih`Tff#pt!7<RcPNl!-5hkpeb7;R-Iba<JFy|fCu=-&$gO5Fn=e0G24G&`R z*6XCorqo80p{f9ys*?guqJ0rVdpqWVcqIY6a}2m$JJFZ<+eRn)0~N+Pijd2?E`!SR znk(M8^}|mtAw>f~@zuZDi?Y;!>p!paCqB6WgS!B*FU<t{#3_CH6?o~7*1ySnuYB_h z|1SV=__Of+FV7Nt1OZZZccpld${RQHPsBd+__e41KkEK8)|Mqp55v}45s||l&T#L! z)0<xnT~*DlDt0%!+uhAcGHenisTLrRwjs;3ED)wm8!{k6f?@rzO+(@j!xAhRlz&Jh zAwYy6iE2|4*`&lK+3aSwz#eL@dNsVNH{a=ud&<m+Sj#^mckbMKXXehm@4c^z*@fHZ z?Xyp2WW<WKVol$tFG1bF?9oTR_1c}!C%N;;k6K=bi2M?hdX+p|UK3Ikg^vQ!*t7&q z+Oy3_bT_b0Km$Nb97Ds`LUcE%4`#LtYcp$eYcm__hsSr0Hs7u$@%$`YI#7BLUB(YL zmB{MzfObKcMW7ZCIY4QMq;21j5Cw@nS54AAWgZbjL4IVEj<rdRHhP<nVQ2M92<^$D z5N2@9P6SZh9d2|q_H}G!kJ;|6N`Dw_Ap#;|bDK@GVqSzGq)ALPh!BuH+suaU{7{>= zEsed@E-wp_5KOFXW-UvsmL==Bnp6aI0)ikQ4nP3}1iX#;EC(XOxrOMEYM}a5lO|WV za8Q_E&o>s2)Ik93vi|NZm-qhq(RI}|utSWcg!T)l4C2KVe)428yfwW0$-8?GkmW!C zOTt5%vYuIYbzuJM{u@x9^?T3lnx6dZ(Z#P5p-*nH87EJ_L~dqo-kCr7{=MvJBURxP zsPK{+Bs+;N-&#C4lhI3{;uCR3*fzm>eB&!$dF>1J1+aO3UF6pw`0{IibTD{uH<Hi4 z|L@<`F3J7uni0W9Fn9Q0x})!pVhaeofG_>km&twMRQ|gOL)xlgH^i&{pSf1VrQ$y| z-YEVu`#Gs@m3J`p&_s0MzzZnmDhE-5JRk{(UD&GMe0nk6U~}5`u7b)7&fiYgs~gOr z7l0yQI3lmP;s`>3!7l;usmd*DUpizv-I4O(Tr>aDhBs16-$sLIcx!m@hF{yIgpgZY z>ijT*O|mwDK2R9V@P~c&b^F&!+mCI!_dtyh^mSFm>YcB8YC{=X)jujC-to5T@zy^R zWnL{`j!;%{JC;}>dS7SV_AJC~rIhw%=~X!(hrmP@iFFVmAnR3bA=$ff_~_12=&`JF zu8YY+MB3UD4&)D(21T^JI>Gu@@ix1#5WH~D>^X#^0&GRY<`n<{b&x+=R)_6>A>kpg zB⋙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%0DvLsQ+e<!2%?SgWj<H~p-Z|iSDu*Z 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 Ef*lzt1^@s6 diff --git a/benchmarks/startup-stage-3-20261018/video-before-rest.png b/benchmarks/startup-stage-3-20261018/video-before-rest.png deleted file mode 100644 index 0e3a25194a76bd5e47a8d33658a673c8e2dee7e0..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 66359 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%0D+cwB3>3xxDAbSjd^ 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 Q;~h~}P?s-}HF^Gj01tI1-T(jq diff --git a/benchmarks/startup-stage-3-20261018/world-after-rest.png b/benchmarks/startup-stage-3-20261018/world-after-rest.png deleted file mode 100644 index 12f71cd317308303028aaf3f0007d7dfa4032bc1..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 211784 zcmV*yKs~>SP)<h;3K|Lk000e1NJLTq00Mvj00H0#0ssI2y0c5O0000WV@Og>004R> z004l5008;`004mK004C`008P>0026e000+ooVrmw00006VoOIv0RI600RN!9r;`8x zfB;EEK~#9!?EQDRB*%Fl3jf~fH0h*0yNgBGU4Q`~C`S9a_O-5TS&0giM2eXNK!6AY zKxBX*5f@m12t>{ViJTa~OqmLlKLy*mzTf?9Su#m6NFsnei?HFOiJhwI`=h#hdS<$N zy64OZ3$mVhfU`5zRd0o^x8C%7>7y4vfZjqx(Vqj~^!zPz)Q=uZXbQutB{VhoR1yt? zZ4OrM5|A>$RPvD8W^YqSFFga4iR8tfm%|%P98Tt3<(R#M{xj!luyG8Z&tzgG3hjZu zX&g4vT*PFq9~EjL>RJw+;(V(%dKtZ`@zF3a<Z%u#-h-4_m4<VySteQI9ANH+qMVPX z(<zG%IlcYCuGKd=mTNdw$>Yi(W^i0Gv&~#9D6>ZjKwr^|j6<N%7+#k(C30iVbsvkC zYuu$Q_QavG*7A^}ey#WY#%uXdo6JM*lwR?RwB~Q_O4>a7Ei<h}4}jp^Hh=%aw*&Z_ zzqlO0e|*QyMD)GyTpIoQjz7E=z<0lLaYPsQB!Kdy4&b-nbw@<sU;X)|095;b@R56v zCJ&7y`1aHp5EgSal~pH+yj&uFu0_luFV>yRBC20f%o2`=i1;}kOqW)B#P=fdE@ex= zY2-=ddn$?M)f96_mf;4cap-tQ7!DOY<r0Up76;u*`dEE#lih<XDB2biC<hzQ$8_bW z0(aJft05dGb=O0~a1C7+<uYH7(QtB2qm(%&Ih8!NdfT**`ma5F4%Vhn?<Ysa4O?;z zh1Pi_Yu*0}`a4wCdPA-6TE8+y$Gax;vw_Zvl<{t)Z8FxiTHArG@ifvA$4;6h4S;8J z089Iw_nmfk@EZ|;KmOvyQEg2p07h8@@Q!!g2H<<&{$%v5S=JCrz<>GYmqy<kC5?dj z7j4zZ`%iyhfQqq7z<o_2wW)0JE`hu?mw@w7mGw=M8FlOuaBo92(E0E+8un!l4Lwo9 z{d-uCLvQSBDFLUIEXjDyCE#Kdj<LuQHpPk$#}UX}RS9_Tm0BIDay^(^0;c?pN8eCU z;#VXAQ@*8H4GCDM-iacKuRnaj`_8zh=MAK+_nBy*M(?Yuezz(NfYTO(hhQGQOZn7^ z*$!3%O%-DR8Qdu4uu8ucWHgnJ?+$vyW%ZKpwaw{0my6Wi2V?=4s8Ps^KbN1=P^_{X zww9SRkD+qfBv9H*Okw+L=Dn3oE0J9FKGvf29#6%_M5Ed`^7v9Ev8Ti$N26+xhKvVg z=4n7V*mK6~EPGx@N?VH<!8s4){;5sm(y7M?Wz9pTgIg+jbo5(h)L*~)j+?&y<i+p$ z=pA2w=z{W;5k2(I58eSHCF!c-bvS_Pi~-=+e*0D;`txsJj8OJf&Hv?}eX{QqX)d?` z-gUzLS-W<P8E}%Dah6oKQ5kS*oivNP%zb>UfB~m9E{D9{qcY%}6F9Uo<ukpn!f~8u z65?}6={k>b&`^}*V%mibRnqy)8jV8^<E~UdkX;3NH%H~{i%TI{Ke@7$MF<|Xg+iXv z@fL<QP6@r}@fY>oC*KL+{b%0$-7jC9_Fi=xQj%|y9++ZmFe-hl_q$&`|Mx#|Z(0|5 zcwXWuLwOvm61$_`rX&)_)z?7wt(9`{{+v9FifKN(1ZQZ4GTgXm)N4T&RRfzswJGzD zt0+~2P33b~E9CB2oWreHiJi3@ijWSB7Lr5--S#&oGtRkn2EUV|4Jd<KP_CuVkOdP* zR+K+w$-61SG39QZ(p5Q0ygX^zb4a9pLMM&TLi)m`$TR(0C88nWdfdHcg@@tMZ<+az z@3;x!Vf`21`4mDKm&g2~|L}yn0Q~ize+qzW3xpQm`hEw%yHC2Or_u0_zx=aH0Q~yz z+%dSc-~H<OM0n@>?@gpMk&ot)OGanF8M`nP8EKfISN5*yMqt1hdn?aK^Pagy7;r|L za>Xs=ouWc&fQ*-Ooft5R7CFAAikp*%Qn8k0<qCoEFyNKYkxx`DEFk7<ibm*~vWU+q zdFKq(r4_eOXtrfWP;!nyXTAH{XTJS$&Ow6)Uq+CrwpF5@XTJLAS?@pf!QcPDz2E)n zc_8}MQ)j>Xq|f!g*vY^hsb@#lgE^2ZhWm5T(47}txZ;Y|5gn}Z1xICAvMF03o~`|k z?**Af-jE&(GRwgWwHz<IO<B{t$5G~eKW(P-EK2qk&D-D5kfE6PLF?xyJ2>TQry(Do zGI_)ar0yXi(<8u>2$!R6m`sT|TS_isMV2YTbe5Dd<ZVf$D&f99;G~q@R7ML~#AJ?| z23wV><Rv`*u}eR%{`y`__Emn)>hIRFr(2AG_k8T$KmXPxL@-JkfM5TeTl;pyx1T%@ zKxv|@*8bi1+|##y-+KBJo+|*n|I`OT^z7%)G%E~%;=#G(*W^91$_#k;dy=cE^<}^r z?aPb_88|YBtwqW-BIj@tT98E!zPt=L^+3s*w7f@j9;!xc9K{+R)O>(4kCwG9hadwk zKE}Zn$qD(S2$!oj_M8kjZ{sx5a7L1eX=I6ZU?B>(K*Oh$vi+zFAz}HB&`tLBN6)Km zGDqHd-+KBJ@n63B=vnGVw=K*Hi_5`d-Rf)mj>(NmUOw`N41x-bbREbWZ)aGCVXpOn zeh#s>)@9NUg%bcHzhdj<puRB{bcICHk;hHF<6XA`_};g>SXWB+ZPz^jA3XE^FMsab zt*@yd#I)j`K<~}<-5<RV;aA^!;#>fl(Ty1Xz4zV&;9F090)X#|c=zu+?eoum{!9?e zGW(;G9xN#MCYVSQ1>ZCYAO*mghEHfd&+2YRney&%(`?ZIt#mq(9U)C4$>p+`yqgoX zsu+kg6%;yG{B~0g#e>W_w;8?UR5p%uG!4PtT4lL>bn;fXav43YP}WQlj8;fqPLuP9 z#Ah2#R}OcDm3mgM)KNKSKycOoQ(K@>L#1;eVabqJYF5ruAlFvYO$I>t5Iz7X6?DXy zzxwdUG47HZ8f(=GZEW&ZxVRezp=o1I+J;@$4UWAvl!Og2w}&P!Rbld8y;xNJeXlKf zv~@>KMf57^R`p=FIRL|804BFuh+$eqe=qHGK6KXSzVpTNqqg3C;(Y-A<QwNlv_%oa z1T+@hc*kyAs9I*3fyj4+vNU^+0Puk`9tvp5C;1h!`1T2NGTYUwr-@?lRoQNB!|Nm( zxicCs1_xFQ)G1N%Acu}rjw5(ChXr?t^jYW)E7(!Dvx3l3lxMGw;T11zIF}hj|DvSt zqhvs(oPy~X^CP7rQWcYu2_xh(Dn@CJ*HW%R@a~}9x{x3nC%)J`4E&UA0~VfO`f!-& zFF$y8Wzxtw*-FOMP3F5oHyP6bKydugM<4v=Q)lZ|(A@_<{?M~uIOExe&iKH`A6m0l ziPrv*DVSYoJq)kK1|c`l<o3VP`FlRn+S}8}Xt13*DI5$q&vPIZo`<{)c(1dguk&9R zjPtDg2FG4r<p<V~wl(Z~%{Du2-BAmCo^1|*`;nVgAO~+fy3$A4umA4t0KWC)dC`}B z7GDDW=kHzspt<NFj2Lb$xr4ob;EXRQ0rZ<soEgZzAAbnIvtKwvaQWf0AL+lp%M_f& zJQl=Uh||f3Q-A&R?(!Nq^MGAv3ez%!yulX6mmxT(i*?qx(qnLQ&Q)$!H$0zDUsFd~ zdr{O|yU=7Le_Pb+W&C*503rsQSn}q)TD!Az-EILAat+2`TqY|xh@^29qOTC~`Evb^ zXzk7=6A!_cmMa|KXfiR&n1>IYb^nLXN<fbM`eQ4~YxMrpzo7p6fiu2<P)5>CW>^fs zAAjj=0P62AeeSexJbp(1B(AxMU_A{IG@Po9pZ{b-QNNKUO@^OCpd1pLZ9TX2FUm&S zIl~T_jj*NZ$m6Es*v_ski16F*z5~Fwo($}}M3~spwFIm3yYIRCD_=OfRMm-Klo<f8 zBLEm>jey^K@4W#2<m=}Fa624;=Wqam<AY~@0l-&2|M3r<)iv~f=SyctI%)vEE0jQN zSnNHg^ys2f<kwY{fD_=W((~YsQvx0|a%YC9CV(w(013EnA>{CBUtI|}qba#Y67b3o zmQ|5}Cnu-=@xau$CU!NC)xK@M_GL}-KaE`irXekiQ34(n?rOynFbyG((pp$g2{^b0 zP=s>zr3XHN;EOJP3k|&LA3F2F7)Heqw2JbCUY^haeC6{WSKWO1!83^HkG~v*Cn?se zT6%Ac>8hp~5u=`xc!TNw%BVYlU}*g%?Fj3yHrN7)KrHr2ZZlWc;p}IYZe2#*PjBNr z3mN+jxksANRQ9CNz$7Pp)l*okbtG12u}}7F#AYw$lVha4l;&NCWZJ_|NPq9Qc@k7- zG|8e*9`dq!$+7P7Pw$dsEle`)Lz*i3iEpJ9ebVMTM@ed`*k{CL3i^wcA)6ts&*Xt8 zZ`|HZoZQ0Dose(Sj`}(e?2hEFGg=rNX~Is<WD_|~^1<7HZkBqq(Dj3XrS?k?d_r;b z%A^jUe!z*IVmcx4c1EY+A+-J~TW`F?8y8#vFe{qd=3jpBj1Qgl(3c-P<2zqE8^CwI zbhhUR-DHs~7D6p_#vP7^-j`nWZX;B<)`psf6a=@z1KjZC=f!7fxcAluerq;3NX}|L zuvUa^*cn?t+LZ9tFC%^AoX<hxgmWJ};oJwqr~2iVKB+g$)Q5PkR($yEhXD|g`onjF zc%;^n2jE>F{ycy$K5**$KK3wx_kHZ)=z{X?FP{1BFP<5{iw)j7QZHORm!knP6E7(# zf^YWaDDhgBJ~g?oOX(tJhU_><RiY@7B=n?9R7K?7#Q99C8&H+=(w(vC^4!NGc`~nF zWKgb4mlL{dsB7ZQBi)WH+U676f_~Bn32XHiDqhlr<#jW=CH0$6+mdr?i%!}Q(K&hl zXDofvNb*X_dA57_=~4TolUHc_<)SL_jqCo{uWQPyp~)aPTP98)a>7z3aG~&<{m-?H zl4g{&-}s$dmtL_aH=C22%|H9*MVpQ+#ankezUT4MgjSl=j50II%<FKk!#D4!Y}rxy zz4zX$jJ^Pt_uGvH_vw322k@KkyyrLHd5>9UktqD0lRppO!)HJIrO%xnHSRm2JgFm$ zMOHjmao?!Ux1agA=W+mFeDIWlFWRtrtA7@(gUeBoE)Pl1nhos~bjY|?t>;3m_6i<q z5E-L`W6%a8?C0VgUoqhX5U4t7ZGBA@z=7x60H(KDQH6yUZ2&6L*Yh|eCN`UiARE8+ z&btA8_v_~YSlVv`BzysYF$Q4kF=c?>@dx*Q{fRRv<iUyoE6*>5!r?o@X>%a3ew!5? zg!iBNi0ba!U;Mao<MJFKxIFQkClc`^DZ{xbN$`#S>iMBB`CtxLCK}?{MR~jKtrUAc zJp!sIY-c{ds=l0-wBiH<R3xT0qj5RB&L~b>YJf*rbJ?R9)`BcLoE25hJ+3@ua%u{| zKklDG5kf~kq*e>=BR51waf(;-QkA1|DP_KqtO)%vK4ZnOHAZ#p%IQLtooW!d2woYc zNBRIM=Y!P$jjmfvvED65chQ~|`&6vAU3ZPLrYLV5bh$74B7>u%yq%}FmH;&79oG?% z5=8r->zsK0Bj5Sb*^pfdG=sP&TZ>+G#)wS6Rz-8#JT2e7VQHSjE0acZ(S7><lTSSN z$&p{o0><N4Um0$C-OzKes=45om+L((jSoz^Q0(kj8F1dB81TBRqg>(Itsc`oG<N)< z(#dEq&Y`>}!|E{!=qBlAW<@#Vjd<d&(+8h0ET)w-?hEb*IM2$j>Kjj-`Sg9KdA1O| zr#<EQY(#!r5&)jL?-T&vdgcsuWiTuafK|}|Jbm9sS2BGC)Eny*w7L$;>Xp`7hu46H z;#3!*xK;Y4F_H6&V9^z?WA<Donsr|_v%lu*<)6#ZuMSm3sMkqi=EyQa+1D&9{>K0; zz3c$kbW}NNseaHo;hZl#dDrPyRi8bg1YrIp8$fl+_}XJ<t6EA9-h5OUz`~36$rnHN zy+1zhdw+ahr{R|;bk7ln#VQkeyWz*wqvSc9h&Y#Fd=Eio2_k&$vC|O72S>%K=x*Cj zQv4389|z`VK>f=GVpWl$C8k~hMfMTUw-hPA=D~aFRk9BU5Y898n<ZVb0o*YpW_iL0 z!&!NJEoDM*=Mn4&7cQZxAyLZtvo<AT1Lqnt4KW^#?MxZm7;A%2onv(QU8&dVsyc{9 zC-YM^L_0d%-72<NLqb%uek``r(tAwGlACle$kY{*Ql`DUy}9gU+A1exPa0e!DKmCT zVrsX(+A#%k$^aEc1EsD+#+%ME7V9JDeqQU11rome>SJdEa9Y0l#_jMAef;xjEqv&# zhvWb3G<*Qc&}){M5_VgQUUSg}@U_QI|KRD5c(zbkn0!yZ|FlO>Jm(4ZY&?(Q`%irg zz=`KQrT+QNr%xOE5kRX|d!<xuOi!*uSU4W2(JZ}b4d-+N&D`9c7dFxYjvxRZ3cGGS zhOseSs1D&39N)W3N4;UnENK8-n<I?nedV8<0JgoZhHehvE~ge!w(C9sMyO00AiVF? z2cNj(w9Pxp2x5P!x!?jYD;fZ^q=C?!ca``Xcv=A`ob%W-_kS#E)~ad%oEBFjWEuhZ z$XSm+egDY-tcs=^j2QjViGf>IbglTtQ>VV?q{qT9(}y|;XqD+*MJZC9%$>TYnD<s@ zcHVr_5@l09w1om0g8Tf`Qsmv?Vkio%SHi>&Ya(q0GhZ$OP_=)M@oQen^HGJq_3NAE zLho~)xlOOLWBX3T{IJI6bVM6lCA>24suALJi@7F^OjSXDqS&^}(RE@Al-2%ll|a5B zXP{Q)oV0kgp)XxfnT9o<fv!~)3tBT-c2AlHNC**oL?6Bnl?~XcXv&DIxUb@@2on(s zAx}K_@%U4!vhN50?>?bNq<-f9lK{Nuq(=cf`^d>_^R^Zij@KjDX-zw$jX~15CTatb zyUw!mFAUmao0+whbZK2CVx!_Mk4V*;yms`Ow{JQ)*8#A3dl|s|i#CASBTE2WTL3Ui zjKaSU%yk%nG&<?LhrapLC!$t5O<#Fh363LPUqi1vz5ltkW>9t7@Eu`TOflL{(`Sq{ zoj`#LSOot3{*OHx1^a3`DN$I3Dt+*@$3gV$!zX{>^e3Ku<P;T{biyZ|e(IhRl>iOk zgQq{yGr}B#FXe?w&S8Je%+VBE+~HC<<%E^S@MKLnTPTzvICW-Zj!|S}B^piM&8Nf2 zuG1GQQ0x34=YzS38SVWn><+ymv1#Y_ogn;h|8#aWITo5XaLFUU4Q*mvr*?)sO2cT* zMQ6U@4<)9Ts!_0@lk4PpaF|S-H-0Jetda%is!KyUd92X;rRzi*0rIJPd)%J6FEpJ2 zU|JR(D%_|s?>6RL37mND<1#ja2z&CYkDVI*lWC-!rPZ@vdE^vT=h=r(j_7>mffE5Z zEgq<^H%y_Nm0o2c#vv;lzbc%VR|Y{$h5LAQmklWCuCp@aP<wGUf|#2zi~4W=-W`AP z^$QSsFDp&2Dsd#|g_mt9Bx3}~a@9aQb1+bwHUTu3JV^P{KQ)0s4nDZ24Pg545&=$| z>lS<0314{fu9JOFPR*LnK60w!vYllgKzT}6^08sDkDUGZS06pqu$b=%-;<2NtY}II zjym;Xq@H}i(_eo0WT(YFhi`;zDQO3qEM9f1{!&k^1W(}ppN5Ex>7q6jFi!%&KE8b{ zQ&0@zd#y^V{HAKA5PS%h>@!Bbu;+!HJ9i#c+A~_~X^#4P?H#Y0IU2_U*myk@?s5a( zy>i8n)4Guqm96@VU7<9iZvU|;A-L2GHVEw&4q8S6YoLaZJ>K=cBOblwqq8B%rCHKE zR{$ta>78X?;cNi#91(wqOEt}HbHmbnNBEBT=2NFeEviR^k0<Uv(W+`zRr4JF<%duH z(CJS+b^nPco%;+D)ub!dJZHtjB�>Qbo})VtPBL0X#1%q^iw}8kW9qlAbzty7ANb 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 So9}}F0000<MNUMnLSTZP|A<Ba diff --git a/docs/performance/startup-stage-3.md b/docs/performance/startup-stage-3.md index 330269889..28013e87c 100644 --- a/docs/performance/startup-stage-3.md +++ b/docs/performance/startup-stage-3.md @@ -34,12 +34,6 @@ The progressive checks used an overlay of the prepared resources with `mob-data. A direct singleplayer launch while the FIFO was held displayed `Loading items` and handled a window resize. Releasing the FIFO resumed entry; the run exited cleanly with a player, 85 chunks, 529 meshed sections and no error. That delayed-entry run peaked at 1,142,560 KiB, including the loaded world. Integrated-server entry also joined after release and rendered a world. Dedicated startup reached `Done`, handled `list` and `stop`, saved and exited with status 0 without constructing a renderer. -Screenshots from these probes: - -- [Video options before rest was ready](../../benchmarks/startup-stage-3-20261018/video-before-rest.png) -- [Loading screen while entry waited for rest](../../benchmarks/startup-stage-3-20261018/loading-before-rest.png) -- [World after the tail join](../../benchmarks/startup-stage-3-20261018/world-after-rest.png) - The full parity selection against `origin/main` also includes the unmerged Stage 2 ancestors (313 harnesses). The local run was bounded at 30 minutes; its log recorded passes for `active_effects`, `active_effect_tick` and `anchor`. The remainder needs CI or a longer dedicated run. The client Rust tests, focused startup probes and memory measurements are separate from that incomplete parity run. Progressive-title RSS was measured separately with audio disabled, render distance 4 and a 30 FPS cap, using separate temporary game directories. The first 30-second pair measured 1,055,132 KiB before and 1,721,772 KiB after. A warm 60-second repeat in reverse order measured 1,031,948 KiB before and 1,145,776 KiB after: an increase of 113,828 KiB (about 111 MiB, 11%). These launches ran during compilation and did not advance through startup/streaming identically. They establish a memory cost to investigate, not a claim of RSS parity; a quiet-machine cold/warm comparison remains needed before merging the stack. From 164f1dfd524deaa35cd9698bcf8adde60dd95f1c Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 16:39:37 +0200 Subject: [PATCH 123/163] Feed a remote client's chat lines to the agent's event log A client joined to a server (and the window on the server thread) keeps the server's chat lines in its own list. The event log only counted the local chat's lines, so `wait-for chat` never saw a line from the server. The remote client counts the lines it receives. The event log reads that count and those lines while connected. lan_e2e gets a `chat` check: a line the host sends reaches the guest's event log, and on the server thread the host window's too. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game/events.rs | 21 ++++++++++++++++++--- crates/horizon-client/src/game/remote.rs | 4 ++++ tools/lan_e2e.py | 17 +++++++++++++++-- 3 files changed, 37 insertions(+), 5 deletions(-) diff --git a/crates/horizon-client/src/game/events.rs b/crates/horizon-client/src/game/events.rs index 0ffff1b59..8a4207a7f 100644 --- a/crates/horizon-client/src/game/events.rs +++ b/crates/horizon-client/src/game/events.rs @@ -167,7 +167,11 @@ impl Game<'_> { Snapshot { screen: self.screen_label(), dimension: self.dim.id().to_string(), - chat: self.ui.chat.received, + // A remote client counts the server's lines itself. + chat: self + .remote + .as_ref() + .map_or(self.ui.chat.received, |r| r.chat_received), counts: if world.is_some() { self.inventory_counts() } else { @@ -189,8 +193,19 @@ impl Game<'_> { if let Some(before) = &self.events.last && *before != now { - let new_chat = (now.chat - before.chat).min(100) as usize; - let lines = self.ui.chat.recent_lines(new_chat); + // Joining or leaving a server starts another count. + let new_chat = now.chat.saturating_sub(before.chat).min(100) as usize; + // Newest first; the remote client keeps its lines oldest first. + let lines = match &self.remote { + Some(r) => r + .chat + .iter() + .rev() + .take(new_chat) + .map(|(t, _)| t.clone()) + .collect(), + None => self.ui.chat.recent_lines(new_chat), + }; for event in diff(before, &now, &lines) { self.events.push(self.ticks, event); } diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 680360c93..5f0699e0c 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -125,6 +125,8 @@ pub(super) struct Remote { health: (f32, i32, f32), game_mode: i32, pub chat: Vec<(String, Instant)>, + /// Lines received since joining, for the control socket's events. + pub chat_received: u64, /// The server's command tree (ClientboundCommandsPacket). pub commands: Option<horizon_client::command::Dispatcher>, players: HashMap<u128, String>, @@ -314,6 +316,7 @@ impl Game<'_> { health: (20.0, 20, 5.0), game_mode: 0, chat: Vec::new(), + chat_received: 0, commands: None, players: HashMap::new(), tab_players: HashMap::new(), @@ -487,6 +490,7 @@ impl Game<'_> { log::info!("[chat] {text}"); if let Some(r) = self.remote.as_mut() { r.chat.push((text, Instant::now())); + r.chat_received += 1; if r.chat.len() > 100 { r.chat.remove(0); } diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 4d13b1c22..f8d4c3ebb 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -22,6 +22,8 @@ address. The script then checks, from both sides, what a guest's game used to ge - containers: the guest's ender chest holds the guest's items, not the host's, and a double chest opens as 9x6 with the right half first; - feedback: the guest's command feedback names the guest and shows the numbers; +- chat: a line the host sends reaches the guest's event log (`wait-for chat`), and on the + server thread the host window's too; - effects: a beacon's power reaches every player in range, the host and the guest; - distance: (--server-thread) the server follows the host's render distance, past vanilla's 32 too (IntegratedServer.tickServer), and the guest's chunks follow the server's (#804) @@ -84,7 +86,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', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'objects', 'projectiles', 'light', 'effects', 'portals', 'distance'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'objects', 'projectiles', 'light', 'effects', 'portals', 'distance'] class Game: @@ -853,6 +855,17 @@ def check_titles(host, guest, out): return {'shown': shown, 'cleared': cleared} +def check_chat(host, guest, out): + # The agent's event log follows a remote client's chat: `wait-for chat` sees the line another + # player sends (and on the server thread the host window's own line, back from the server). + line = f'chat check {int(time.time())}' + host.raw('chat', line) + seen = {g.name: g.raw('wait-for', 'chat', line, '--timeout', 10, '--since', 0).get('ok') + for g in ((guest, host) if SERVER_THREAD else (guest,))} + guest.shot(out, 'chat') + return seen + + def png_rows(path): """The rows of an 8-bit RGB or RGBA PNG, unfiltered, as bytes of 4 (or 3) per pixel.""" data = Path(path).read_bytes() @@ -1272,7 +1285,7 @@ def check_light(host, guest, out): CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'nametags': check_nametags, 'chest': check_chest, 'crafting': check_crafting, 'sign': check_sign, 'damage': check_damage, 'mobs': check_mobs, 'hazards': check_hazards, 'pvp': check_pvp, - 'containers': check_containers, 'feedback': check_feedback, 'titles': check_titles, + 'containers': check_containers, 'feedback': check_feedback, 'titles': check_titles, 'chat': check_chat, 'commands': check_commands, 'recipes': check_recipes, 'trials': check_trials, 'walls': check_walls, 'effects': check_effects, 'portals': check_portals, 'distance': check_distance, 'clicks': check_clicks, From 567cc335768b491e6bb0fd7defc3ac3db36d06d8 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 14:14:48 +0200 Subject: [PATCH 124/163] LAN: the guest's clock stops with /time pause and keeps up with the server's game time The host sent the overworld clock's rate even while /time pause held it (ServerClockInstance.packNetworkState sends 0 when paused), so a guest's day kept running. A guest also moved its clock by the rounded rate each client tick and never caught up when the server's game-time sync moved game_time on, so a guest whose game lagged fell behind for good. ClientClockManager.tick advances the clock by the game time passed, with its partial tick; the guest now does the same. lan_e2e.py time: the paused clock and a guest stalled for 4 seconds. Part of #848 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game/chat.rs | 10 ++++++ crates/horizon-client/src/game/lan.rs | 10 +++--- crates/horizon-client/src/game/lan_actions.rs | 7 ++-- crates/horizon-client/src/game/remote.rs | 33 ++++++++++++++++--- .../horizon-client/src/game/server_travel.rs | 7 ++-- tools/lan_e2e.py | 32 ++++++++++++++++-- 6 files changed, 75 insertions(+), 24 deletions(-) diff --git a/crates/horizon-client/src/game/chat.rs b/crates/horizon-client/src/game/chat.rs index cb8a3a0b5..b78b97cb5 100644 --- a/crates/horizon-client/src/game/chat.rs +++ b/crates/horizon-client/src/game/chat.rs @@ -689,6 +689,16 @@ impl Game<'_> { c.partial -= whole; self.world.day_time += whole as i64; } + /// `ServerClockInstance.packNetworkState`: the rate players' clients + /// advance the overworld clock at, 0 while it is paused (`/time pause`) + /// or `advance_time` is off. + pub(super) fn network_clock_rate(&self) -> f32 { + if self.ui.rules.bool("advance_time") && !self.ui.clock.paused { + self.ui.clock.rate + } else { + 0.0 + } + } /// The engine-side rule values (block behaviour and health). pub(super) fn level_rules(&self) -> horizon_world::level::GameRules { let r = &self.ui.rules; diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index d35bf787a..d39422e35 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -814,6 +814,7 @@ impl Game<'_> { }; let spawn = self.spawn.map_or([0.5, 80.0, 0.5], |s| [s.x, s.y, s.z]); let events = { + let clock_rate = self.network_clock_rate(); let mut ctx = TickCtx { world: &mut self.world, host: state.as_ref(), @@ -822,11 +823,7 @@ impl Game<'_> { spawn, difficulty: i32::from(self.ui.difficulty), difficulty_locked: self.level.difficulty_locked, - clock_rate: if self.ui.rules.bool("advance_time") { - self.ui.clock.rate - } else { - 0.0 - }, + clock_rate, tick_rate: self.clock.rate(), tick_frozen: self.clock.frozen(), collision: Some(self.collision), @@ -991,6 +988,7 @@ impl Game<'_> { } else { entities }; + let clock_rate = self.network_clock_rate(); let mut ctx = TickCtx { world: &mut self.world, host: state, @@ -999,7 +997,7 @@ impl Game<'_> { spawn, difficulty: i32::from(self.ui.difficulty), difficulty_locked: self.level.difficulty_locked, - clock_rate: self.ui.clock.rate, + clock_rate, tick_rate: self.clock.rate(), tick_frozen: self.clock.frozen(), collision: Some(self.collision), diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index ced435d8d..42e96becc 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -1072,6 +1072,7 @@ impl Game<'_> { if let Some(play) = host.play.get_mut(&conn) { play.potions = Default::default(); } + let clock_rate = self.network_clock_rate(); let ctx = TickCtx { world: &mut self.world, host: None, @@ -1080,11 +1081,7 @@ impl Game<'_> { spawn, difficulty: i32::from(self.ui.difficulty), difficulty_locked: self.level.difficulty_locked, - clock_rate: if self.ui.rules.bool("advance_time") { - self.ui.clock.rate - } else { - 0.0 - }, + clock_rate, tick_rate: self.clock.rate(), tick_frozen: self.clock.frozen(), collision: Some(self.collision), diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 680360c93..710e507d3 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -149,7 +149,12 @@ pub(super) struct Remote { synced: Vec<Option<ItemStack>>, decode_errors: u32, clock: Option<i32>, + /// `ClientClockManager.ClientClockInstance`'s rate and partial tick for + /// the level's clock (its total is `world.day_time`), and + /// `lastTickGameTime`. clock_rate: f32, + clock_partial: f32, + clock_game_time: i64, /// `ClientChunkCache.Storage`'s view centre (ClientboundSetChunkCacheCenterPacket). chunk_center: (i32, i32), } @@ -331,6 +336,8 @@ impl Game<'_> { decode_errors: 0, clock: None, clock_rate: 1.0, + clock_partial: 0.0, + clock_game_time: 0, chunk_center: (0, 0), }); // The level's TickRateManager follows the server's ticking packets. @@ -1648,8 +1655,12 @@ impl Game<'_> { total: p.total, } } + // ClientPacketListener.handleSetTime: the game time, then + // ClientClockManager.handleUpdates: the clock catches up with the + // game time and takes the server's state. C::SetTime(p) => { self.world.game_time = p.game_time; + self.remote_clock_tick(); let clock = { let r = self.remote.as_ref(); let names = @@ -1670,6 +1681,7 @@ impl Game<'_> { if let Some(r) = self.remote.as_mut() { r.clock = Some(c.clock); r.clock_rate = c.rate; + r.clock_partial = c.partial_tick; } } } @@ -2379,15 +2391,12 @@ impl Game<'_> { horizon_protocol::packets::configuration::ClientInformation::new(view), )); } - // Minecraft.tick: TickRateManager.tick; ClientLevel.tick advances + // Minecraft.tick: TickRateManager.tick; ClientLevel.tickTime advances // the time only while the level runs normally. let running = self.clock.world_runs(); if running { self.world.game_time += 1; - let rate = self.remote.as_ref().map_or(1.0, |r| r.clock_rate); - if rate > 0.0 { - self.world.day_time += rate.round() as i64; - } + self.remote_clock_tick(); } // Weather levels drift toward their targets between server updates. let w = &mut self.world.weather; @@ -3701,6 +3710,20 @@ impl Game<'_> { .filter_map(|(id, uuid)| Some((*id as u32, r.players.get(uuid)?.clone()))) .collect() } + /// `ClientClockManager.tick`: the clock moves on by the game time that + /// passed since its last tick, at its rate. A game time the server sets + /// forward (its sync every second) moves the clock with it. + fn remote_clock_tick(&mut self) { + let Some(r) = self.remote.as_mut() else { + return; + }; + let delta = self.world.game_time - r.clock_game_time; + r.clock_game_time = self.world.game_time; + let partial = f64::from(r.clock_partial) + delta as f64 * f64::from(r.clock_rate); + let full = partial.floor(); + r.clock_partial = (partial - full) as f32; + self.world.day_time += full as i64; + } pub(super) fn remote_status(&self) -> Option<serde_json::Value> { let r = self.remote.as_ref()?; Some(serde_json::json!({ diff --git a/crates/horizon-client/src/game/server_travel.rs b/crates/horizon-client/src/game/server_travel.rs index 6c0ec48e7..56fdbaca5 100644 --- a/crates/horizon-client/src/game/server_travel.rs +++ b/crates/horizon-client/src/game/server_travel.rs @@ -304,6 +304,7 @@ impl Game<'_> { /// The hub's view of the server for packets sent outside its own tick. pub(super) fn server_ctx(&mut self) -> TickCtx<'_> { let spawn = self.spawn.map_or([0.5, 80.0, 0.5], |s| [s.x, s.y, s.z]); + let clock_rate = self.network_clock_rate(); TickCtx { world: &mut self.world, host: None, @@ -312,11 +313,7 @@ impl Game<'_> { spawn, difficulty: i32::from(self.ui.difficulty), difficulty_locked: self.level.difficulty_locked, - clock_rate: if self.ui.rules.bool("advance_time") { - self.ui.clock.rate - } else { - 0.0 - }, + clock_rate, tick_rate: self.clock.rate(), tick_frozen: self.clock.frozen(), collision: Some(self.collision), diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 4d13b1c22..b7d844de9 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -49,6 +49,8 @@ address. The script then checks, from both sides, what a guest's game used to ge guest as the host has them (kind, place, rotation, what they hold or wear, the variant). - projectiles: primed TNT (one falling), an end crystal and an arrow that lands reach the guest where the host has them; a falling block lands on both sides. +- time: the guest's clock is the host's: it stops with `/time pause`, and catches up with the + server's game time after the guest's game stalls for a few seconds (#848). - light: the guest's light matches the host's: around a torch placed near it, under a roof and once a block of the roof is removed under the sky, and in the last chunk it tracks next to glowstone in a chunk it doesn't (only the server's light updates bring that one). @@ -69,6 +71,7 @@ import json import os import re import shutil +import signal import subprocess import sys import tempfile @@ -84,7 +87,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', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'objects', 'projectiles', 'light', 'effects', 'portals', 'distance'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'objects', 'projectiles', 'light', 'time', 'effects', 'portals', 'distance'] class Game: @@ -1122,6 +1125,29 @@ def check_xp(host, guest, out): return {'seen': seen, 'guest': xp, 'host': host_xp} +def check_time(host, guest, out): + def times(): + return host('state')['time']['day_time'], guest('state')['time']['day_time'] + host('command', command='time set 1000') + host('command', command='time pause') + host.wait(60) + paused = times() + host('command', command='time resume') + guest.wait(20) + # A stalled game runs at most 10 missed ticks when it wakes (DeltaTracker); the server's + # game time, sent every second, moves the guest's clock on (ClientClockManager.tick). + os.kill(guest.pid, signal.SIGSTOP) + time.sleep(4) + os.kill(guest.pid, signal.SIGCONT) + guest.wait(60) + stalled = times() + detail = {'paused': paused, 'after_stall': stalled} + assert paused[0] == paused[1] and 1000 <= paused[0] < 1010, f'the clock while paused: {detail}' + # The two reads are a tick or two apart. + assert abs(stalled[0] - stalled[1]) <= 3, f'the guest\'s clock after its game stalled: {detail}' + return detail + + def objects_near(game, centre, key='objects'): """`status`'s objects within 8 blocks of centre, without their ids (each side numbers its own).""" out = [] @@ -1278,7 +1304,7 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'effects': check_effects, 'portals': check_portals, 'distance': check_distance, 'clicks': check_clicks, 'sleep': check_sleep, 'push': check_push, 'eat': check_eat, 'xp': check_xp, 'objects': check_objects, 'projectiles': check_projectiles, - 'light': check_light} + 'light': check_light, 'time': check_time} def run(ctl, out, resources, checks): @@ -1301,7 +1327,7 @@ def run(ctl, out, resources, checks): host('command', command='gamerule spawn_mobs false') port = host.raw('lan', 'open', 0, 'commands')['port'] host.player = host.raw('lan', 'status').get('host', 'Player') # the host's profile name - guest('launch', wait=False, offscreen=sys.platform == 'darwin') + guest.pid = guest('launch', wait=False, offscreen=sys.platform == 'darwin')['pid'] guest.raw('connect', f'127.0.0.1:{port}', GUEST_NAME) guest.raw('wait-for', 'loaded', '--timeout', 300) guest.wait(40) From a49f93f9ef342a246a77cc91565c9cdc2d14f8d0 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 14:14:48 +0200 Subject: [PATCH 125/163] LAN: guests open hoppers, dispensers and droppers The guest's client closed every menu it had no screen for, so hoppers (MenuType.HOPPER) and dispensers and droppers (GENERIC_3x3) did nothing. They open as their 5 and 9 slot screens now, drawn by the menu's type and under the server's title. lan_e2e.py machines: each opens with its slots and keeps a stack the guest shift-clicks in. Part of #848 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game/machines.rs | 12 +++++++- crates/horizon-client/src/game/remote.rs | 25 +++++++++++++--- tools/lan_e2e.py | 35 ++++++++++++++++++++-- 3 files changed, 65 insertions(+), 7 deletions(-) diff --git a/crates/horizon-client/src/game/machines.rs b/crates/horizon-client/src/game/machines.rs index d46928060..d40d6a3e8 100644 --- a/crates/horizon-client/src/game/machines.rs +++ b/crates/horizon-client/src/game/machines.rs @@ -770,6 +770,14 @@ enum Screen { impl Game<'_> { fn machine_screen(&self) -> Option<Screen> { let key = self.container?; + // A server's menu shows by its type, whatever block (or minecart) holds it. + if let Some(menu) = self.remote_menu_type() { + return match menu { + "minecraft:hopper" => Some(Screen::Hopper), + "minecraft:generic_3x3" => Some(Screen::Dispenser), + _ => None, + }; + } if key.1 == super::minecarts::CART_KEY_Y { return (self.open_cart_kind() == Some(super::minecarts::CartKind::Hopper)) .then_some(Screen::Hopper); @@ -852,7 +860,9 @@ impl Game<'_> { batch.rect_uv(ox, oy, 176.0, height, r, u32::MAX); } let grey = horizon_client::hud::rgba(64, 64, 64, 255); - let title = &self.container_title(title.to_owned()); + let title = &self + .remote_menu_title() + .unwrap_or_else(|| self.container_title(title.to_owned())); let title_x = if screen == Screen::Hopper { 8.0 } else { diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 680360c93..3b7d51609 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -1130,14 +1130,16 @@ impl Game<'_> { /// Map a menu slot to Horizon's inventory screen slot ids. fn menu_slot(menu: &str, slot: i32) -> Option<usize> { let s = usize::try_from(slot).ok()?; - let rows = |n: usize| -> Option<usize> { + // A container of `n` slots, then the inventory and the hotbar. + let slots = |n: usize| -> Option<usize> { match s { - _ if s < n * 9 => Some(300 + s), - _ if s < n * 9 + 27 => Some(9 + s - n * 9), - _ if s < n * 9 + 36 => Some(s - n * 9 - 27), + _ if s < n => Some(300 + s), + _ if s < n + 27 => Some(9 + s - n), + _ if s < n + 36 => Some(s - n - 27), _ => None, } }; + let rows = |n: usize| slots(n * 9); match menu { "inventory" => match s { 0 => Some(200), @@ -1175,6 +1177,9 @@ impl Game<'_> { "minecraft:generic_9x4" => rows(4), "minecraft:generic_9x5" => rows(5), "minecraft:generic_9x6" => rows(6), + // HopperMenu; DispenserMenu (dispensers and droppers). + "minecraft:hopper" => slots(5), + "minecraft:generic_3x3" => slots(9), _ => None, } } @@ -3544,6 +3549,10 @@ impl Game<'_> { speed: 1.0, })) } + // HopperMenu, and DispenserMenu (MenuType.GENERIC_3x3: dispensers + // and droppers). + "minecraft:hopper" => Some(BlockEntity::Chest(vec![None; 5])), + "minecraft:generic_3x3" => Some(BlockEntity::Chest(vec![None; 9])), m if m.starts_with("minecraft:generic_9x") || m == "minecraft:shulker_box" => { let rows = m .strip_prefix("minecraft:generic_9x") @@ -3591,6 +3600,14 @@ impl Game<'_> { self.screen = Screen::Inventory; self.capture(false); } + /// 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()) + } + /// The title the server gave the menu it opened. + pub(super) fn remote_menu_title(&self) -> Option<String> { + self.remote.as_ref()?.menu_title.clone() + } /// A server's chest-like menu (`MenuType.GENERIC_9xN`): its rows and title. pub(super) fn remote_chest_menu(&self) -> Option<(usize, String)> { let r = self.remote.as_ref()?; diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 4d13b1c22..a0ae2615e 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -21,6 +21,8 @@ address. The script then checks, from both sides, what a guest's game used to ge - pvp: the guest and the host hit each other with a sword; with the pvp game rule off, nothing; - containers: the guest's ender chest holds the guest's items, not the host's, and a double chest opens as 9x6 with the right half first; +- machines: a hopper, a dispenser and a dropper open on the guest's screen with their 5 and 9 + slots, and keep what the guest shift-clicks into them (#848); - feedback: the guest's command feedback names the guest and shows the numbers; - effects: a beacon's power reaches every player in range, the host and the guest; - distance: (--server-thread) the server follows the host's render distance, past vanilla's 32 too @@ -84,7 +86,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', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'objects', 'projectiles', 'light', 'effects', 'portals', 'distance'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'machines', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'objects', 'projectiles', 'light', 'effects', 'portals', 'distance'] class Game: @@ -637,6 +639,35 @@ def check_containers(host, guest, out): return {'ender': ender, 'double': double, 'taken': taken} +def check_machines(host, guest, out): + # After `recipes`: the stacks given here unlock recipes, which would move the book's first one. + guest('command', command='gamemode survival') + x, y, z = (int(v // 1) for v in pos_of(guest)) + at = (x, y, z + 2) + seen = {} + for block in ('hopper', 'dispenser', 'dropper'): + guest('command', command='clear @s') + guest('command', command='give @s minecraft:cobblestone 4') + guest('command', command=f'setblock {at[0]} {at[1]} {at[2]} minecraft:{block}') + guest.wait(10) + guest.raw('interact', *at) + guest.raw('wait-for', 'screen', 'container', '--timeout', 10) + guest.wait(10) + size = container_items(guest)[1] + guest.shot(out, f'machines-{block}') + guest.raw('click-slot', hotbar_slot(guest, 'minecraft:cobblestone'), 'shift') + guest.wait(10) + guest.raw('key', 'esc', 'tap') + guest.wait(10) + # Opened again, the menu holds what the server has. + seen[block] = (size, open_container(guest, at, out, f'machines-{block}-after')[0]) + guest('command', command=f'setblock {at[0]} {at[1]} {at[2]} minecraft:air') + want = {'hopper': (5, {0: 'minecraft:cobblestone'}), 'dispenser': (9, {0: 'minecraft:cobblestone'}), + 'dropper': (9, {0: 'minecraft:cobblestone'})} + assert seen == want, f'the machines on the guest: {seen}' + return seen + + def slot_point(game, slot): """The GUI point in the middle of slot `slot` of the open screen (`ui`'s slot-N).""" for w in game.raw('ui')['widgets']: @@ -1272,7 +1303,7 @@ def check_light(host, guest, out): CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'nametags': check_nametags, 'chest': check_chest, 'crafting': check_crafting, 'sign': check_sign, 'damage': check_damage, 'mobs': check_mobs, 'hazards': check_hazards, 'pvp': check_pvp, - 'containers': check_containers, 'feedback': check_feedback, 'titles': check_titles, + 'containers': check_containers, 'machines': check_machines, 'feedback': check_feedback, 'titles': check_titles, 'commands': check_commands, 'recipes': check_recipes, 'trials': check_trials, 'walls': check_walls, 'effects': check_effects, 'portals': check_portals, 'distance': check_distance, 'clicks': check_clicks, From 0bc19687aa29e714f03df078b425261329b40688 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 14:14:48 +0200 Subject: [PATCH 126/163] LAN: guests see mobs flash when hit The host told guests of a hurt mob with EntityEvent 2, which 26.3's clients read as a kinetic hit, not a hurt. It now sends ClientboundDamageEventPacket (ServerLevel.broadcastDamageEvent) with the damage type and the attacker, and the guest's client restarts the hurt flash and jolts the walk animation (LivingEntity.handleDamageEvent). lan_e2e.py hurt: a pig the guest hits and one the host hits flash on both sides. Part of #848 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game/agent.rs | 2 +- crates/horizon-client/src/game/creatures.rs | 2 +- crates/horizon-client/src/game/lan.rs | 26 ++++++++++++- crates/horizon-client/src/game/remote.rs | 9 +++++ crates/horizon-client/src/lan/containers.rs | 27 +++++++++++++ crates/horizon-protocol/src/packets/play.rs | 20 ++++++++++ tools/lan_e2e.py | 43 +++++++++++++++++++-- 7 files changed, 121 insertions(+), 8 deletions(-) diff --git a/crates/horizon-client/src/game/agent.rs b/crates/horizon-client/src/game/agent.rs index b11fdd552..5a7894ea2 100644 --- a/crates/horizon-client/src/game/agent.rs +++ b/crates/horizon-client/src/game/agent.rs @@ -579,7 +579,7 @@ impl Game<'_> { push( [m.position.x, m.position.y, m.position.z], m.kind.id.as_ref(), - json!({ "id": m.id, "kind": "mob", "health": m.health, "baby": m.is_baby() }), + json!({ "id": m.id, "kind": "mob", "health": m.health, "baby": m.is_baby(), "hurt_time": m.hurt_time }), ); } for item in &self.dropped { diff --git a/crates/horizon-client/src/game/creatures.rs b/crates/horizon-client/src/game/creatures.rs index 3ef399e62..9f657b816 100644 --- a/crates/horizon-client/src/game/creatures.rs +++ b/crates/horizon-client/src/game/creatures.rs @@ -3016,7 +3016,7 @@ impl Game<'_> { } /// Mob.getBaseExperienceReward /// The damage type id of a Horizon damage kind. -fn damage_type(kind: horizon_client::mobs::DamageKind, player: bool) -> &'static str { +pub(super) fn damage_type(kind: horizon_client::mobs::DamageKind, player: bool) -> &'static str { use horizon_client::mobs::DamageKind as K; match kind { K::PlayerAttack => "minecraft:player_attack", diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index d35bf787a..eaf4672c0 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -1068,8 +1068,30 @@ impl Game<'_> { .and_then(|s| s.get(&m.id)) .copied(); let at = [m.position.x, m.position.y, m.position.z]; - if m.hurt_time > old.map_or(0, |o| o.0) && !dead { - host.hub.entity_event(m.id as i32, 2, at); + // LivingEntity.hurtServer: a hurt that restarted the hurt time. + if m.hurt_time > old.map_or(0, |o| o.0) + && !dead + && let Some((source, _)) = m.last_damage + { + use horizon_client::mobs::{DamageKind as K, Who}; + let player = source.attacker == Some(Who::Player); + let kind = super::creatures::damage_type(source.kind, player); + // The player a mob sees is the guest acting, else the host. + let cause = source.attacker.map(|who| match who { + Who::Player => host + .mob_players + .get(&m.id) + .and_then(|conn| host.hub.guest(*conn)) + .map_or(host.host_entity, |g| g.entity_id), + Who::Mob(id) => id as i32, + }); + // A projectile is the direct entity of its hit: not tracked here. + let melee = matches!( + source.kind, + K::PlayerAttack | K::MaceSmash | K::MobAttack | K::Sting | K::SonicBoom + ); + let direct = cause.filter(|_| melee); + host.hub.damage_event(m.id as i32, kind, cause, direct, at); } if dead && !old.is_some_and(|o| o.1) { host.hub.entity_event(m.id as i32, 3, at); diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 680360c93..b144b55dd 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -1572,6 +1572,15 @@ impl Game<'_> { pl.velocity = Vec3::new(p.velocity[0], p.velocity[1], p.velocity[2]); } } + // ClientPacketListener.handleDamageEvent: LivingEntity.handleDamageEvent + // jolts the walk animation and restarts the hurt flash. Its hurt + // sound comes as a sound from Horizon's host, which plays it itself. + C::DamageEvent(p) => { + if let Some(m) = self.mobs.iter_mut().find(|m| m.id == p.id as u32) { + m.limb_speed = 1.5; + m.hurt_time = 10; + } + } C::HurtAnimation(p) => { if let Some(m) = self.mobs.iter_mut().find(|m| m.id == p.id as u32) { m.hurt_time = 10; diff --git a/crates/horizon-client/src/lan/containers.rs b/crates/horizon-client/src/lan/containers.rs index 3ecd58b80..9f8607bb9 100644 --- a/crates/horizon-client/src/lan/containers.rs +++ b/crates/horizon-client/src/lan/containers.rs @@ -109,6 +109,33 @@ impl Hub { ); } + /// `ServerLevel.broadcastDamageEvent`: the clients around show the hurt + /// entity's flash and hear its hurt sound. + pub fn damage_event( + &self, + id: i32, + kind: &str, + cause: Option<i32>, + direct: Option<i32>, + at: [f64; 3], + ) { + let Some(source_type) = self.sync.id("minecraft:damage_type", kind) else { + return; + }; + self.broadcast_near( + at, + 128.0, + &C::DamageEvent(play::DamageEvent { + id, + source_type, + cause, + direct, + position: None, + }), + None, + ); + } + pub fn swing(&self, id: i32, hand: i32, at: [f64; 3], except: Option<u32>) { self.broadcast_near( at, diff --git a/crates/horizon-protocol/src/packets/play.rs b/crates/horizon-protocol/src/packets/play.rs index 895db9755..349f41ddd 100644 --- a/crates/horizon-protocol/src/packets/play.rs +++ b/crates/horizon-protocol/src/packets/play.rs @@ -244,6 +244,18 @@ packet!(EntityPositionSync { id: i32 => VarInt, path: PositionPath => PositionPa packet!(ForgetLevelChunk { pos: [i32; 2] => ChunkPos }); packet!(GameEvent { event: u8 => UByte, param: f32 => Float }); packet!(HurtAnimation { id: i32 => VarInt, yaw: f32 => Float }); +packet!( + /// ClientboundDamageEventPacket: the hurt entity, the damage type's + /// registry id, the causing and the direct entity (none: -1 on the wire's + /// id + 1) and the source's position. + DamageEvent { + id: i32 => VarInt, + source_type: i32 => VarInt, + cause: Option<i32> => OptVarInt, + direct: Option<i32> => OptVarInt, + position: Option<[f64; 3]> => Opt<Vec3d>, + } +); packet!(LevelChunkWithLight { x: i32 => Int, z: i32 => Int, chunk: ChunkData => ChunkData, light: LightData => LightData }); packet!(LevelEvent { kind: i32 => Int, pos: [i32; 3] => Pos, data: i32 => Int, global: bool => Bool }); packet!(LightUpdate { x: i32 => VarInt, z: i32 => VarInt, light: LightData => LightData }); @@ -1388,6 +1400,7 @@ packet_enum!(Clientbound, crate::ids::play::clientbound { GameEvent(GameEvent) = GAME_EVENT, GameRuleValues(GameRuleValues) = GAME_RULE_VALUES, HurtAnimation(HurtAnimation) = HURT_ANIMATION, + DamageEvent(DamageEvent) = DAMAGE_EVENT, KeepAlive(KeepAlive) = KEEP_ALIVE, InitializeBorder(InitializeBorder) = INITIALIZE_BORDER, LevelChunkWithLight(LevelChunkWithLight) = LEVEL_CHUNK_WITH_LIGHT, @@ -2110,6 +2123,13 @@ mod tests { id: 2, slots: vec![(0, None), (5, Some(Stack::new(1, 1)))], }), + Clientbound::DamageEvent(DamageEvent { + id: 7, + source_type: 31, + cause: Some(0), + direct: None, + position: Some([1.5, -2.0, 3.25]), + }), Clientbound::SetHealth(SetHealth { health: 17.5, food: 18, diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 4d13b1c22..85a4f9e36 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -19,6 +19,8 @@ address. The script then checks, from both sides, what a guest's game used to ge - hazards: a guest in survival gets hungry sprint-jumping and is hurt by lava, a block at the eyes, drowning and the void (then respawns); - pvp: the guest and the host hit each other with a sword; with the pvp game rule off, nothing; +- hurt: a pig the guest hits, and one the host hits, flashes red on the other side too (the + server's damage event) (#848); - containers: the guest's ender chest holds the guest's items, not the host's, and a double chest opens as 9x6 with the right half first; - feedback: the guest's command feedback names the guest and shows the numbers; @@ -84,7 +86,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', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'objects', 'projectiles', 'light', 'effects', 'portals', 'distance'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'hurt', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'objects', 'projectiles', 'light', 'effects', 'portals', 'distance'] class Game: @@ -575,6 +577,33 @@ def check_pvp(host, guest, out): return hits +def check_hurt(host, guest, out): + for g in (host, guest): + g('command', command='gamemode survival') + g('command', command='clear @s') + face_each_other(host, guest) + hx, hy, hz = pos_of(host) + # Between the two, within both players' reach; bare hands leave it alive. + host('command', command=f'summon minecraft:pig {hx + 1.5:.2f} {hy:.2f} {hz + 0.8:.2f} {{NoAI:1b}}') + host.wait(30) + + def pig(game): + return game.raw('entities', 6, 'pig')['entities'][0] + seen = {} + for name, attacker, watcher in (('guest hits', guest, host), ('host hits', host, guest)): + attacker.wait(30) # a full attack charge + attacker.raw('attack', pig(attacker)['id']) + seen[name] = {'attacker': pig(attacker)['hurt_time'], 'watcher': pig(watcher)['hurt_time']} + attacker.shot(out, 'hurt-' + name.replace(' ', '-')) + watcher.shot(out, 'hurt-' + name.replace(' ', '-') + '-seen') + attacker.wait(20) + host('command', command='kill @e[type=minecraft:pig]') + # LivingEntity.hurtTime: 10 when hurt, one less each tick; the reads come a few ticks later. + for name, sides in seen.items(): + assert all(t > 0 for t in sides.values()), f'{name}: the pig\'s hurt flash {seen}' + return seen + + def container_items(game): """The open container's stacks by slot (Horizon's container slots are 300 and up) and its size.""" slots = [s for s in game('screen').get('slots', []) if s.get('slot', 0) >= 300] @@ -1100,7 +1129,13 @@ def check_xp(host, guest, out): g('command', command='gamemode survival') g('command', command='xp set @s 0 levels') g('command', command='xp set @s 0 points') + # Out of the orbs' way wherever an earlier check left the host (ExperienceOrb follows the + # nearest player who isn't a spectator). + host('command', command='gamemode spectator') guest.wait(10) + # `xp set` leaves Player.totalExperience (the score): experience from earlier checks stays in it. + total = guest('state')['player']['xp']['total'] + host_total = host('state')['player']['xp']['total'] x, y, z = pos_of(guest) # Three orbs of 7 points 4 blocks east of the guest (out of reach, within the 8 blocks orbs # follow from): they fly to the guest. @@ -1116,8 +1151,8 @@ def check_xp(host, guest, out): detail = {'seen': seen, 'guest': xp, 'host': host_xp, 'left': left} # ExperienceOrb.scanForMerges: orbs of one value side by side can merge into one. assert 1 <= seen <= 3, f'the guest saw {seen} orbs: {detail}' - assert xp['total'] == 21 and xp['level'] == 2, f'the guest\'s experience after three 7-point orbs: {detail}' - assert host_xp['total'] == 0, f'the host took the orbs: {detail}' + assert xp['total'] - total == 21 and xp['level'] == 2, f'the guest\'s experience after three 7-point orbs: {detail}' + assert host_xp['total'] == host_total, f'the host took the orbs: {detail}' assert left == 0, f'orbs left on the guest\'s screen: {detail}' return {'seen': seen, 'guest': xp, 'host': host_xp} @@ -1271,7 +1306,7 @@ def check_light(host, guest, out): CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'nametags': check_nametags, 'chest': check_chest, 'crafting': check_crafting, 'sign': check_sign, 'damage': check_damage, - 'mobs': check_mobs, 'hazards': check_hazards, 'pvp': check_pvp, + 'mobs': check_mobs, 'hazards': check_hazards, 'pvp': check_pvp, 'hurt': check_hurt, 'containers': check_containers, 'feedback': check_feedback, 'titles': check_titles, 'commands': check_commands, 'recipes': check_recipes, 'trials': check_trials, 'walls': check_walls, From 89cbe03ebe1a6d54f4a494fcc0402f1768cdc710 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 14:14:48 +0200 Subject: [PATCH 127/163] LAN: everyone sees players' arm swings The host ignored ServerboundPunchPacket, so a guest mining or hitting swung only on its own screen; only the first swing a guest's use ever started went out, the host's own swings never did, the host drew no swing on guests' bodies and a guest's client ignored ClientboundSwingAnimationPacket. The host now swings the guest's hand on a punch (handlePunch), sends each tick's guest swings to the players around and the host's own to the guests, and swings and ticks the guests' bodies it draws. A use the server ran that swung goes back to the guest too: Horizon's client does not run uses itself, so it never predicted that swing (the hoe). The guest's client swings itself or the other entity on the packet. lan_e2e.py swings: mining swings seen from each side, and the guest's own hoe swing. Part of #848 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game/agent.rs | 2 + crates/horizon-client/src/game/lan.rs | 8 ++ crates/horizon-client/src/game/lan_actions.rs | 93 ++++++++++++++++--- crates/horizon-client/src/game/remote.rs | 19 ++++ crates/horizon-client/src/mobs/ai.rs | 2 +- tools/lan_e2e.py | 60 +++++++++++- 6 files changed, 167 insertions(+), 17 deletions(-) diff --git a/crates/horizon-client/src/game/agent.rs b/crates/horizon-client/src/game/agent.rs index b11fdd552..71992ec3f 100644 --- a/crates/horizon-client/src/game/agent.rs +++ b/crates/horizon-client/src/game/agent.rs @@ -477,6 +477,8 @@ impl Game<'_> { "sleeping": self.sleeping, // The item in use: its slot and for how many ticks. "using": self.using.map(|(slot, ticks)| json!({ "slot": slot, "ticks": ticks })), + // The arm swings started (LivingEntity.swing). + "swings": self.swings_started, "time": { "day_time": self.world.day_time, "day": self.world.day_time.div_euclid(24000), "time_of_day": self.world.day_time.rem_euclid(24000) }, "weather": { "raining": self.world.weather.raining, "thundering": self.world.weather.thundering }, "paused": self.pause, diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index d35bf787a..491767836 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -42,6 +42,8 @@ pub(super) struct LanHost { pub hub: Hub, pub settings: LanSettings, pub host_entity: i32, + /// The host's swings the guests were told of (`Game::swings_started`). + pub host_swings: u32, pub host_uuid: u128, /// The host's profile name (the account's, or the offline name). pub host_name: String, @@ -395,6 +397,8 @@ impl Game<'_> { [&m.extra.head, &m.extra.chest, &m.extra.legs, &m.extra.feet] .map(|s| s.as_deref()) }), + // The host draws this guest's arm swinging. + "model_swinging": h.models.get(&g.conn).map(|m| m.ai.swinging), })).collect::<Vec<_>>(), }), _ => json!({ "open": false }), @@ -509,6 +513,7 @@ impl Game<'_> { hub, settings: LanSettings { port, ..settings }, host_entity, + host_swings: self.swings_started, host_uuid, host_name: self.options.player_name(), models: HashMap::new(), @@ -1158,6 +1163,9 @@ impl Game<'_> { .each_ref() .map(|s| s.as_ref().map(|s| s.item.clone())); m.extra.crouching = g.sneaking; + // LivingEntity.updateSwingTime: the arm swing lan_swings started. + m.anim.attack_anim_o = m.anim.attack_anim; + horizon_client::mobs::ai::tick_swing(m); } } diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index ced435d8d..e161517dd 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -10,6 +10,7 @@ use horizon_client::{ command::vanilla, containers::BlockEntity, entities::Experience, + first_person::{Hand, SwingAnimation}, items::ItemStack, lan::{ guest::SPECTATOR, @@ -43,8 +44,9 @@ pub(super) struct GuestPlay { /// its progress since `dig_start` is complete (ServerPlayerGameMode.hasDelayedDestroy). delayed: Option<([i32; 3], u64)>, last_progress: i32, - /// Hand movements the client announced and the host animated. - swung: bool, + /// Swings the guest's actions started this tick, for the players around + /// (`LivingEntity.swing` sends ClientboundSwingAnimationPacket). + swings: u32, /// The trading screen the guest has open. pub(super) merchant: Option<super::lan_trading::GuestMerchant>, /// The inventory menu and the crafting table the guest crafts in. @@ -202,7 +204,11 @@ impl Game<'_> { self.lan_acting_name = Some(g.name.clone()); self.lan_acting_uuid = Some(g.uuid); + // The guest's swings are theirs: the host's own count stays the host's. + let swings = self.swings_started; let result = f(self); + play.swings += self.swings_started.wrapping_sub(swings); + self.swings_started = swings; for packet in std::mem::take(&mut self.guest_packets) { host.hub.send_to(conn, &packet); } @@ -542,6 +548,16 @@ impl Game<'_> { } } } + // ServerGamePacketListenerImpl.handlePunch: the main hand swings + // with the held item's attack animation (mining, attacking, a + // click on nothing), seen by the players around, and the attack + // strength starts again. + S::Punch(_) => { + self.as_guest(host, conn, |g| { + g.swing_hand(Hand::Main, SwingAnimation::DEFAULT); + g.reset_attack_strength(); + }); + } S::UseItemOn(p) => { host.hub.ack(conn, p.sequence); if spectator { @@ -557,11 +573,14 @@ impl Game<'_> { f64::from(p.pos[2]) + f64::from(p.cursor[2]), ], }; - self.as_guest(host, conn, |g| { + let swung = self.as_guest(host, conn, |g| { g.forced_hit = Some(hit); + let swings = g.swings_started; let _ = g.use_item(); g.forced_hit = None; + g.swings_started != swings }); + self.lan_swing_back(host, conn, swung); // The client predicted a result: correct it with what really is. for pos in [ p.pos, @@ -579,20 +598,26 @@ impl Game<'_> { } // handleUseItem: the client's rotation, then the item alone. What it // looked at a moment ago (a block, a mob) is UseItemOn's or Interact's. - self.as_guest(host, conn, |g| { + let swung = self.as_guest(host, conn, |g| { (g.yaw, g.pitch) = (p.yaw, p.pitch); g.lan_item_only = true; + let swings = g.swings_started; let _ = g.use_item(); g.lan_item_only = false; + g.swings_started != swings }); + self.lan_swing_back(host, conn, swung); } 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); - self.as_guest(host, conn, |g| { + 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); } } S::SetCreativeModeSlot(p) => { @@ -1619,23 +1644,63 @@ impl Game<'_> { } } - /// Guests' arm swings for everyone else. + /// A use the server ran swung the guest's hand: their own client is told + /// too (`swing(hand, true)` for a SwingSource.SERVER result). Horizon's + /// client does not run uses itself, so it does not predict the swing; a + /// client that did (a block placed) is still in the first half of its + /// swing and ignores it (`SwingState.startIfAble`). + fn lan_swing_back(&mut self, host: &mut LanHost, conn: u32, swung: Option<bool>) { + if swung != Some(true) { + return; + } + let (Some(g), Some(play)) = (host.hub.guest(conn), host.play.get(&conn)) else { + return; + }; + if let Some(c) = play.swing.current { + host.hub + .send_to(conn, &swing_packet(g.entity_id, c.hand, c.animation)); + } + } + + /// The tick's arm swings for the players around (the guests' to everyone + /// else, the host's to the guests), and `LivingEntity.updateSwingTime` + /// for the guests' bodies here. pub(super) fn lan_swings(&mut self, host: &mut LanHost) { let conns: Vec<u32> = host.play.keys().copied().collect(); for conn in conns { let Some(g) = host.hub.guests.iter().find(|g| g.conn == conn) else { continue; }; - if !host.hub.here(g) { - continue; - } - let (id, at) = (g.entity_id, g.position); + let (id, at, here) = (g.entity_id, g.position, host.hub.here(g)); let play = host.play.get_mut(&conn).expect("play"); - let swinging = play.swing.swinging() && play.swing.ticks == 0; - if swinging && !play.swung { - host.hub.swing(id, 0, at, Some(conn)); + let swung = std::mem::take(&mut play.swings) > 0; + if let (true, true, Some(c)) = (swung, here, play.swing.current) { + let packet = swing_packet(id, c.hand, c.animation); + host.hub.broadcast_near(at, 128.0, &packet, Some(conn)); + if let Some(m) = host.models.get_mut(&conn) { + m.swing(); + } + } + play.swing.tick(); + } + if self.swings_started != host.host_swings { + host.host_swings = self.swings_started; + if let (Some(p), Some(c)) = (self.player.as_ref(), self.swing.current) { + let at = [p.position.x, p.position.y, p.position.z]; + let packet = swing_packet(host.host_entity, c.hand, c.animation); + host.hub.broadcast_near(at, 128.0, &packet, None); } - play.swung = swinging; } } } + +/// ClientboundSwingAnimationPacket: the hand and the animation (its type and +/// base duration; each client applies the swinger's haste and fatigue). +fn swing_packet(id: i32, hand: Hand, animation: SwingAnimation) -> C { + C::SwingAnimation(play::SwingAnimation { + id, + hand: i32::from(hand == Hand::Off), + kind: i32::from(animation.kind), + duration: animation.duration, + }) +} diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 680360c93..e5bc9b6b4 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -1599,6 +1599,21 @@ impl Game<'_> { } } C::Animate(p) => self.remote_animate(p.id, p.action), + // ClientPacketListener.handleSwingAnimation: the entity swings + // (LivingEntity.swing, which a swing in its first half ignores). + C::SwingAnimation(p) => { + use horizon_client::first_person::Hand; + let hand = if p.hand == 1 { Hand::Off } else { Hand::Main }; + let animation = horizon_client::first_person::SwingAnimation { + kind: p.kind.clamp(0, 255) as u8, + duration: p.duration, + }; + if self.remote.as_ref().is_some_and(|r| r.entity_id == p.id) { + self.swing_hand(hand, animation); + } else if let Some(m) = self.mobs.iter_mut().find(|m| m.id == p.id as u32) { + m.swing(); + } + } C::UpdateMobEffect(p) => self.remote_effect(&p), C::RemoveMobEffect(p) => { if self.remote.as_ref().is_some_and(|r| r.entity_id == p.id) @@ -2621,6 +2636,9 @@ impl Game<'_> { if !m.alive() { m.death_time += 1; } + // LivingEntity.updateSwingTime. + m.anim.attack_anim_o = m.anim.attack_anim; + horizon_client::mobs::ai::tick_swing(m); // Entity.commonTick: LinearInterpolationHandler.interpolate. if let Some(l) = lerps.get_mut(&(m.id as i32)) && l.steps > 0 @@ -3728,6 +3746,7 @@ impl Game<'_> { let armor = [&e.head, &e.chest, &e.legs, &e.feet].map(|s| s.as_deref()); serde_json::json!({ "id": m.id, + "swinging": m.ai.swinging, "armor": armor, "main_hand": e.main_hand.as_deref(), "off_hand": e.off_hand.as_deref(), diff --git a/crates/horizon-client/src/mobs/ai.rs b/crates/horizon-client/src/mobs/ai.rs index f74a3c7d1..475bd7611 100644 --- a/crates/horizon-client/src/mobs/ai.rs +++ b/crates/horizon-client/src/mobs/ai.rs @@ -429,7 +429,7 @@ pub fn tick( true } /// LivingEntity.updateSwingTime (6-tick swing duration). -fn tick_swing(m: &mut Mob) { +pub fn tick_swing(m: &mut Mob) { if m.ai.swinging { m.ai.swing_time += 1; if m.ai.swing_time >= 6 { diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 4d13b1c22..e0a696c23 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -49,6 +49,8 @@ address. The script then checks, from both sides, what a guest's game used to ge guest as the host has them (kind, place, rotation, what they hold or wear, the variant). - projectiles: primed TNT (one falling), an end crystal and an arrow that lands reach the guest where the host has them; a falling block lands on both sides. +- swings: each side sees the other's arm swing while it mines a block, and the guest sees its own + swing when its hoe tills dirt (the server's use) (#848). - light: the guest's light matches the host's: around a torch placed near it, under a roof and once a block of the roof is removed under the sky, and in the last chunk it tracks next to glowstone in a chunk it doesn't (only the server's light updates bring that one). @@ -84,7 +86,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', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'objects', 'projectiles', 'light', 'effects', 'portals', 'distance'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'objects', 'projectiles', 'light', 'swings', 'effects', 'portals', 'distance'] class Game: @@ -1095,6 +1097,60 @@ def check_eat(host, guest, out): return detail +def watch_mining(miner, pos, seen): + """Mine the block at `pos` (by hand, for seconds) and sample `seen()` meanwhile.""" + dig = threading.Thread(target=miner.raw, args=('break', *pos)) + dig.start() + samples = [] + for _ in range(8): + time.sleep(0.25) + samples.append(seen()) + dig.join() + return samples + + +def check_swings(host, guest, out): + for g in (host, guest): + g('command', command='gamemode survival') + g('command', command='clear @s') + face_each_other(host, guest) + hx, hy, hz = (int(v // 1) for v in pos_of(host)) + gx, gy, gz = (int(v // 1) for v in pos_of(guest)) + # Stone by hand takes 7.5 seconds: ServerboundPunchPacket every tick keeps the arm swinging. + guest('command', command=f'setblock {gx} {gy} {gz + 1} minecraft:stone') + host('command', command=f'setblock {hx} {hy} {hz + 1} minecraft:stone') + host.wait(10) + def swinging(game): + # On its server thread the host's window is a client of its server too. + if game is host and not SERVER_THREAD: + return lan_guest(host).get('model_swinging') + return any(e.get('swinging') for e in remote(game).get('player_equipment', [])) + # Most samples: a swing restarts only past its first half (SwingState.startIfAble), so a sample can + # fall between two. + host_sees = watch_mining(guest, (gx, gy, gz + 1), lambda: swinging(host)) + guest_sees = watch_mining(host, (hx, hy, hz + 1), lambda: swinging(guest)) + # A hoe on dirt: the server tills it and swings the guest's hand, on the guest's screen too. + # Where the guest stands now (an earlier check can leave it on a ledge it then drops from). + gx, gy, gz = (int(v // 1) for v in pos_of(guest)) + soil = (gx, gy - 1, gz + 1) + guest('command', command=f'setblock {soil[0]} {soil[1]} {soil[2]} minecraft:dirt') + # HoeItem.useOn tills only under air. + guest('command', command=f'setblock {soil[0]} {soil[1] + 1} {soil[2]} minecraft:air') + guest('command', command='give @s minecraft:wooden_hoe') + guest.wait(10) + guest.raw('select', 'minecraft:wooden_hoe') + before = guest('state')['swings'] + guest.raw('interact', *soil) + guest.wait(10) + hoe = {'swings': guest('state')['swings'] - before, 'soil': host.raw('block', *soil)['block']} + guest('command', command=f'setblock {soil[0]} {soil[1]} {soil[2]} minecraft:stone') + detail = {'host_sees_guest': host_sees, 'guest_sees_host': guest_sees, 'hoe': hoe} + assert sum(map(bool, host_sees)) >= 4, f'the host does not see the guest mine: {detail}' + assert sum(map(bool, guest_sees)) >= 4, f'the guest does not see the host mine: {detail}' + assert hoe == {'swings': 1, 'soil': 'minecraft:farmland'}, f'the guest\'s hoe: {detail}' + return detail + + def check_xp(host, guest, out): for g in (host, guest): g('command', command='gamemode survival') @@ -1278,7 +1334,7 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'effects': check_effects, 'portals': check_portals, 'distance': check_distance, 'clicks': check_clicks, 'sleep': check_sleep, 'push': check_push, 'eat': check_eat, 'xp': check_xp, 'objects': check_objects, 'projectiles': check_projectiles, - 'light': check_light} + 'light': check_light, 'swings': check_swings} def run(ctl, out, resources, checks): From 76e659c74bfa608e6a83ba1ddebd00fa9a58940f Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 14:19:40 +0200 Subject: [PATCH 128/163] LAN: players see each other use items (eating, bows, shields) Neither side sent LivingEntity.DATA_LIVING_ENTITY_FLAGS for players, so no one saw another player eat, draw a bow or raise a shield. The host now sends the item in use and its hand for itself and every guest (always: the trackers send only the entries that changed, and stopping is a change back to 0), and draws its guests' bodies using their items. A guest's client starts and stops the other players' item use from the flags and drops their eating crumbs at their mouth (Consumable.onConsumeTick); the eating sounds already come from the server. lan_e2e.py eating: the host and the guest each see the other eat bread, and stop. Part of #803 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/examples/lan_flat.rs | 1 + crates/horizon-client/src/game/lan.rs | 17 +++- crates/horizon-client/src/game/lan_actions.rs | 16 ++++ crates/horizon-client/src/game/remote.rs | 84 +++++++++++++++++++ crates/horizon-client/src/lan/guest.rs | 4 + crates/horizon-client/src/lan/hub.rs | 8 ++ crates/horizon-client/tests/lan_bot.rs | 1 + tools/lan_e2e.py | 42 +++++++++- 8 files changed, 170 insertions(+), 3 deletions(-) diff --git a/crates/horizon-client/examples/lan_flat.rs b/crates/horizon-client/examples/lan_flat.rs index 20d87e03c..15e377c48 100644 --- a/crates/horizon-client/examples/lan_flat.rs +++ b/crates/horizon-client/examples/lan_flat.rs @@ -101,6 +101,7 @@ fn main() -> Result<(), Box<dyn std::error::Error>> { sprinting: false, equipment: Default::default(), health: 20.0, + living_flags: 0, }; loop { world.game_time += 1; diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index d35bf787a..a93d37941 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -2,7 +2,7 @@ //! server threads and the play-state hub, feeds it the world's entities each //! tick and turns what the guests do into gameplay. A world that is not open //! costs one `Option` check per tick. -use super::Game; +use super::{Game, shield::OFFHAND_SLOT}; use horizon_client::{ Result, items::ItemStack, @@ -395,6 +395,8 @@ impl Game<'_> { [&m.extra.head, &m.extra.chest, &m.extra.legs, &m.extra.feet] .map(|s| s.as_deref()) }), + // For how many ticks the host draws this guest using an item. + "model_using": h.models.get(&g.conn).map(|m| m.extra.using_item), })).collect::<Vec<_>>(), }), _ => json!({ "open": false }), @@ -722,6 +724,7 @@ impl Game<'_> { sprinting: p.sprinting, equipment, health: p.health.health(), + living_flags: living_flags(self.using), }) } @@ -924,6 +927,7 @@ impl Game<'_> { } self.lan_flush_effects(&mut host); self.tick_guests(&mut host); + self.lan_living_flags(&mut host); self.tick_server_travel(&mut host); self.lan_swings(&mut host); self.lan_update_streaming(&host); @@ -1158,6 +1162,11 @@ impl Game<'_> { .each_ref() .map(|s| s.as_ref().map(|s| s.item.clone())); m.extra.crouching = g.sneaking; + // LivingEntity.onSyncedDataUpdated(DATA_LIVING_ENTITY_FLAGS): the + // item in use and its hand (the arm poses of a bow, a shield...). + let using = host.play.get(&g.conn).and_then(|p| p.using()); + m.extra.using_item = using.map_or(0, |(_, ticks)| ticks as i32 + 1); + m.extra.using_off_hand = using.is_some_and(|(slot, _)| slot == OFFHAND_SLOT); } } @@ -1226,3 +1235,9 @@ impl Game<'_> { } } } + +/// `LivingEntity.DATA_LIVING_ENTITY_FLAGS` for an item in use: 1, and 2 when +/// it is the off hand's. +pub(super) fn living_flags(using: Option<(usize, u32)>) -> i8 { + using.map_or(0, |(slot, _)| if slot == OFFHAND_SLOT { 3 } else { 1 }) +} diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index ced435d8d..2012d080d 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -60,6 +60,13 @@ pub(super) struct GuestPlay { xp_delay: u32, } +impl GuestPlay { + /// The item in use: its slot and for how many ticks. + pub(super) fn using(&self) -> Option<(usize, u32)> { + self.using + } +} + struct ItemRules<'a>(&'a horizon_client::items::Items); impl Rules for ItemRules<'_> { fn max_stack(&self, item: &str) -> u32 { @@ -1619,6 +1626,15 @@ impl Game<'_> { } } + /// The guests' items in use, for the players around (`LivingEntity.startUsingItem` + /// and `stopUsingItem` set DATA_LIVING_ENTITY_FLAGS). + pub(super) fn lan_living_flags(&mut self, host: &mut LanHost) { + for g in &mut host.hub.guests { + let using = host.play.get(&g.conn).and_then(GuestPlay::using); + g.living_flags = super::lan::living_flags(using); + } + } + /// Guests' arm swings for everyone else. pub(super) fn lan_swings(&mut self, host: &mut LanHost) { let conns: Vec<u32> = host.play.keys().copied().collect(); diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 680360c93..e0017fd7c 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -1478,6 +1478,25 @@ impl Game<'_> { } } } + // LivingEntity.onSyncedDataUpdated(DATA_LIVING_ENTITY_FLAGS): + // another player starts using the item in a hand (eating, a + // bow drawn, a shield up), or stops. + let other = self + .remote + .as_ref() + .is_some_and(|r| r.level_players.contains_key(&p.id) && r.entity_id != p.id); + if other && let Some(m) = self.mobs.iter_mut().find(|m| m.id == p.id as u32) { + for (index, _, value) in &p.values { + if let (8, Value::Byte(flags)) = (index, value) { + m.extra.using_off_hand = flags & 2 != 0; + if flags & 1 == 0 { + m.extra.using_item = 0; + } else if m.extra.using_item == 0 { + m.extra.using_item = 1; + } + } + } + } // LivingEntity.onSyncedDataUpdated(SLEEPING_POS_ID): this // player lies down in the bed, or gets up. if self.remote.as_ref().is_some_and(|r| r.entity_id == p.id) { @@ -2597,6 +2616,7 @@ impl Game<'_> { let mut lerps = std::mem::take(&mut r.lerps); let head_lerps = &mut r.head_lerps; let players = &r.level_players; + let mut using = Vec::new(); for m in &mut self.mobs { let player = players.contains_key(&(m.id as i32)); if !running && !player { @@ -2645,6 +2665,28 @@ impl Game<'_> { m.head_yaw += wrap_degrees(*yaw - m.head_yaw) / *steps as f32; *steps -= 1; } + // LivingEntity.updatingUsingItem for another player: the ticks the + // item has been used before this one. + if player && m.extra.using_item > 0 { + let item = if m.extra.using_off_hand { + m.extra.off_hand.clone() + } else { + m.extra.main_hand.clone() + }; + if let Some(item) = item { + let eye = if m.extra.crouching { 1.27 } else { 1.62 }; + let at = [m.position.x, m.position.y, m.position.z]; + using.push(( + item, + m.extra.using_item as u32 - 1, + at, + eye, + m.head_pitch, + m.yaw, + )); + } + m.extra.using_item += 1; + } // LivingEntity.tick's tickHeadTurn: a mob's BodyRotationControl, // a player's body following its walk and look. if player { @@ -2692,6 +2734,9 @@ impl Game<'_> { } } head_lerps.retain(|_, (_, steps)| *steps > 0); + for (item, ticks, at, eye, pitch, yaw) in using { + self.remote_player_eating(&item, ticks, at, eye, pitch, yaw); + } if running { // Boats, minecarts, armor stands, projectiles and the rest // interpolate like mobs. @@ -2717,6 +2762,44 @@ impl Game<'_> { } } } + /// `Consumable.onConsumeTick` for another player eating: the crumbs at + /// their mouth every 4 ticks once 21.875% of the 32 ticks have passed + /// (`shouldEmitParticlesAndSounds`; the sounds come from the server). + fn remote_player_eating( + &mut self, + item: &str, + ticks: u32, + at: [f64; 3], + eye: f64, + pitch: f32, + yaw: f32, + ) { + let food = self + .res + .items + .get(item) + .is_some_and(|i| i.consumable && i.food.is_some()); + let duration = 32; + let remaining = duration - ticks.min(duration); + if !food || duration - remaining <= (duration as f32 * 0.21875) as u32 || remaining % 4 != 0 + { + return; + } + let options = self.item_particle(&ItemStack::new(item, 1)); + let mut spawned = Vec::new(); + horizon_client::particles::item_use_particles( + &mut self.world.random, + pitch, + yaw, + at, + at[1] + eye, + 5, + |p, v| spawned.push((p, v)), + ); + for (p, v) in spawned { + self.particles.add(&options, p, v); + } + } /// LocalPlayer.sendPosition plus input, sprint and held-slot updates. fn remote_send_state(&mut self, input: u8) { let Some(p) = self.player.as_ref() else { @@ -3728,6 +3811,7 @@ impl Game<'_> { let armor = [&e.head, &e.chest, &e.legs, &e.feet].map(|s| s.as_deref()); serde_json::json!({ "id": m.id, + "using": m.extra.using_item, "armor": armor, "main_hand": e.main_hand.as_deref(), "off_hand": e.off_hand.as_deref(), diff --git a/crates/horizon-client/src/lan/guest.rs b/crates/horizon-client/src/lan/guest.rs index 1a699bc45..b39903f4d 100644 --- a/crates/horizon-client/src/lan/guest.rs +++ b/crates/horizon-client/src/lan/guest.rs @@ -75,6 +75,9 @@ pub struct Guest { pub fall_flying: bool, pub flying: bool, pub sleeping: bool, + /// `LivingEntity.DATA_LIVING_ENTITY_FLAGS`: 1 while using an item, 2 if + /// it is in the off hand. + pub living_flags: i8, /// The bed (its head) the player sleeps in (`LivingEntity.getSleepingPos`), /// `Player.sleepCounter`, and the bed last told to the player itself. pub bed: Option<[i32; 3]>, @@ -222,6 +225,7 @@ impl Guest { fall_flying: false, flying: false, sleeping: false, + living_flags: 0, bed: None, sleep_timer: 0, sent_bed: None, diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index 5d593be2d..e4673429d 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -80,6 +80,8 @@ pub struct HostState { pub sprinting: bool, pub equipment: [Option<ItemStack>; 6], pub health: f32, + /// `LivingEntity.DATA_LIVING_ENTITY_FLAGS` (the item in use). + pub living_flags: i8, } /// Everything the hub needs from the game for one tick. @@ -1375,6 +1377,7 @@ impl Hub { rot: (f32, f32, f32), on_ground: bool, flags: (bool, bool, bool, bool), + living_flags: i8, skin: u8, health: f32, equipment: Vec<(u8, Option<horizon_protocol::item::Stack>)>, @@ -1406,6 +1409,9 @@ impl Hub { if pose != 0 { meta.push((6, serializer::POSE, Value::Id(pose))); } + // Always there: the trackers send the entries that changed, and an + // item no longer in use is a change back to 0. + meta.push((8, serializer::BYTE, Value::Byte(living_flags))); if (health - 1.0).abs() > f32::EPSILON && health != 20.0 { meta.push((9, serializer::FLOAT, Value::Float(health))); } @@ -1469,6 +1475,7 @@ impl Hub { (h.yaw, h.pitch, h.head_yaw), h.on_ground, (h.sneaking, h.sprinting, false, false), + h.living_flags, 0x7F, h.health, equipment, @@ -1498,6 +1505,7 @@ impl Hub { (g.yaw, g.pitch, g.head_yaw), g.on_ground, (g.sneaking, g.sprinting, g.fall_flying, g.sleeping), + g.living_flags, g.info.model_customisation, g.health, equipment, diff --git a/crates/horizon-client/tests/lan_bot.rs b/crates/horizon-client/tests/lan_bot.rs index 7a8209939..c723f4a05 100644 --- a/crates/horizon-client/tests/lan_bot.rs +++ b/crates/horizon-client/tests/lan_bot.rs @@ -181,6 +181,7 @@ impl Server { sprinting: false, equipment: Default::default(), health: 20.0, + living_flags: 0, }; let mut ctx = TickCtx { world: &mut self.world, diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 4d13b1c22..247f592d9 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -43,6 +43,8 @@ address. The script then checks, from both sides, what a guest's game used to ge pushes it, as in vanilla), not ever faster across the ground. - eat: holding right click with bread, the guest's own screen plays the eating (the item in use counts up) and the server eats one loaf and feeds the guest. +- eating: each side sees the other player eat: the item in use (LivingEntity's flags) on the + player it draws, and no longer once the bread is eaten (#803); - xp: experience orbs 4 blocks away fly to the guest, show on the guest's screen and give the guest their points (not the host). - objects: boats, minecarts, armor stands, item frames and paintings the host summons reach the @@ -84,7 +86,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', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'objects', 'projectiles', 'light', 'effects', 'portals', 'distance'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'light', 'effects', 'portals', 'distance'] class Game: @@ -1095,6 +1097,42 @@ def check_eat(host, guest, out): return detail +def check_eating(host, guest, out): + for g in (host, guest): + g('command', command='gamemode survival') + g('command', command='clear @s') + # Hungry: Player.canEat. + g('command', command='effect give @s minecraft:hunger 3 255') + host.wait(70) + for g in (host, guest): + g('command', command='effect clear @s') + g('command', command='give @s minecraft:bread 2') + host.wait(5) + face_each_other(host, guest) + + def using(game): + # On its server thread the host's window is a client of its server too. + if game is host and not SERVER_THREAD: + return lan_guest(host).get('model_using') or 0 + return max((e.get('using') or 0 for e in remote(game).get('player_equipment', [])), default=0) + seen = {} + for name, eater, watcher in (('host eats', host, guest), ('guest eats', guest, host)): + eater.raw('select', 'minecraft:bread') + hold = threading.Thread(target=eater.raw, args=('use-item', '--hold', 2.2)) + hold.start() + samples = [] + for _ in range(4): + time.sleep(0.3) + samples.append(using(watcher)) + watcher.shot(out, 'eating-' + name.replace(' ', '-')) + hold.join() + eater.wait(10) + seen[name] = {'during': samples, 'after': using(watcher)} + for name, s in seen.items(): + assert sum(1 for u in s['during'] if u > 0) >= 3 and s['after'] == 0, f'{name}: {seen}' + return seen + + def check_xp(host, guest, out): for g in (host, guest): g('command', command='gamemode survival') @@ -1276,7 +1314,7 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'commands': check_commands, 'recipes': check_recipes, 'trials': check_trials, 'walls': check_walls, 'effects': check_effects, 'portals': check_portals, 'distance': check_distance, 'clicks': check_clicks, - 'sleep': check_sleep, 'push': check_push, 'eat': check_eat, + 'sleep': check_sleep, 'push': check_push, 'eat': check_eat, 'eating': check_eating, 'xp': check_xp, 'objects': check_objects, 'projectiles': check_projectiles, 'light': check_light} From 5b47d53dbf409b55b582212bcab2d26c0b68054d Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 14:32:08 +0200 Subject: [PATCH 129/163] LAN: guests use brewing stands BrewingStandBlock opens BrewingStandMenu for a guest: the host clicks it on the menu engine over the stand's slots (one bottle per slot, ingredient and fuel slots, quick moves by item) and sends its four data slots (BrewingStandBlockEntity.dataAccess). The guest opens minecraft:brewing_stand menus, maps their slots, predicts clicks on Kind::Brewing and shows the times. Reported by Tydragon00. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game.rs | 3 + crates/horizon-client/src/game/lan_actions.rs | 9 ++- .../horizon-client/src/game/lan_crafting.rs | 60 ++++++++++++------- crates/horizon-client/src/game/remote.rs | 25 ++++++-- crates/horizon-client/src/game/stations.rs | 4 +- crates/horizon-client/src/lan/containers.rs | 20 ++++--- tools/lan_e2e.py | 41 ++++++++++++- 7 files changed, 121 insertions(+), 41 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 85a191832..1a295a569 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -4948,6 +4948,9 @@ impl Game<'_> { }; (kind, size) } + // A server's BrewingStandMenu; a local stand's clicks are the + // station screen's. + Some(BlockEntity::Brewing(_)) if self.remote.is_some() => (Kind::Brewing, 5), Some(BlockEntity::Furnace(f)) => ( Kind::Furnace( match f.kind.recipe_type().trim_start_matches("minecraft:") { diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index ced435d8d..8581093dc 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -395,6 +395,13 @@ impl Game<'_> { _ => ("minecraft:furnace", "container.furnace"), }; (menu, title, Slots::Block(pos)) + } else if let Some(BlockEntity::Brewing(_)) = self.world.block_entities.get(&pos) { + // BrewingStandBlock.useWithoutItem: BrewingStandMenu. + ( + "minecraft:brewing_stand", + "container.brewing", + Slots::Block(pos), + ) } else if let Some((other, right)) = self.chest_partner(pos) { // ChestBlock.combine: the right half's slots come first. let halves = if right { @@ -606,7 +613,7 @@ impl Game<'_> { S::ContainerClick(p) if self.lan_merchant_click(host, conn, &p) => {} S::ContainerClick(p) if self.lan_inventory_click(host, conn, &p) => {} S::ContainerClick(p) if self.lan_crafting_click(host, conn, &p) => {} - S::ContainerClick(p) if self.lan_furnace_click(host, conn, &p) => {} + S::ContainerClick(p) if self.lan_machine_click(host, conn, &p) => {} S::SelectTrade(p) => self.lan_select_trade(host, conn, p.item), S::ContainerClose(p) if self.lan_merchant_closed(host, conn, Some(p.container)) => { let g = &mut host.hub.guests[gi]; diff --git a/crates/horizon-client/src/game/lan_crafting.rs b/crates/horizon-client/src/game/lan_crafting.rs index 1f16a9c74..efb7f0a00 100644 --- a/crates/horizon-client/src/game/lan_crafting.rs +++ b/crates/horizon-client/src/game/lan_crafting.rs @@ -21,9 +21,10 @@ pub(super) struct GuestCrafting { inventory: Option<Box<Menu>>, /// The open crafting table: its window, state id and menu. table: Option<(i32, i32, Box<Menu>)>, - /// The open furnace's window and menu (`AbstractFurnaceMenu`); its slots live in - /// the furnace block entity and the hub's container menu keeps the client in sync. - furnace: Option<(i32, Box<Menu>)>, + /// The open furnace's or brewing stand's window and menu (`AbstractFurnaceMenu`, + /// `BrewingStandMenu`); its slots live in the block entity and the hub's + /// container menu keeps the client in sync. + machine: Option<(i32, Box<Menu>)>, } /// ServerboundContainerClickPacket's input. @@ -157,10 +158,11 @@ impl Game<'_> { true } - /// A click on the guest's open furnace, blast furnace or smoker: the host's - /// `AbstractFurnaceMenu` (fuel slot, take-only result, quick moves by recipe and - /// fuel) over the block entity's slots. False for other windows. - pub(super) fn lan_furnace_click( + /// A click on the guest's open furnace, blast furnace, smoker or brewing stand: + /// the host's `AbstractFurnaceMenu` (fuel slot, take-only result, quick moves by + /// recipe and fuel) or `BrewingStandMenu` (one bottle per slot, ingredient and + /// blaze powder slots) over the block entity's slots. False for other windows. + pub(super) fn lan_machine_click( &mut self, host: &mut LanHost, conn: u32, @@ -180,15 +182,18 @@ impl Game<'_> { else { return false; }; - let Some(BlockEntity::Furnace(f)) = self.world.block_entities.get(&pos) else { - return false; + let (kind, items) = match self.world.block_entities.get(&pos) { + Some(BlockEntity::Furnace(f)) => { + let recipe = match f.kind.recipe_type() { + "minecraft:blasting" => "blasting", + "minecraft:smoking" => "smoking", + _ => "smelting", + }; + (Kind::Furnace(recipe), f.items.to_vec()) + } + Some(BlockEntity::Brewing(b)) => (Kind::Brewing, b.items.to_vec()), + _ => return false, }; - let recipe = match f.kind.recipe_type() { - "minecraft:blasting" => "blasting", - "minecraft:smoking" => "smoking", - _ => "smelting", - }; - let items = f.items.clone(); if host.hub.guests[gi].spectator() { return true; } @@ -197,10 +202,10 @@ impl Game<'_> { .entry(conn) .or_default() .crafting - .furnace + .machine .take() .filter(|(window, _)| *window == p.container) - .map_or_else(|| Box::new(Menu::new(Kind::Furnace(recipe))), |(_, m)| m); + .map_or_else(|| Box::new(Menu::new(kind)), |(_, m)| m); let changed = self.guest_menu_op(host, gi, &mut menu, |menu, env| { for (k, s) in items.iter().enumerate() { menu.set_slot(env, k, s.clone()); @@ -213,14 +218,23 @@ impl Game<'_> { .filter(|&s| menu.slot(s) != before[s].as_ref()) .collect::<Vec<_>>() }); - if let Some(BlockEntity::Furnace(f)) = self.world.block_entities.get_mut(&pos) { - for k in 0..3 { - f.items[k] = menu.slot(k).cloned(); + match self.world.block_entities.get_mut(&pos) { + Some(BlockEntity::Furnace(f)) => { + for k in 0..3 { + f.items[k] = menu.slot(k).cloned(); + } + // AbstractFurnaceBlockEntity.setItem: only a new input restarts cooking. + f.input_clicked(&self.res.recipes, items[0].clone()); } - // AbstractFurnaceBlockEntity.setItem: only a new input restarts cooking. - f.input_clicked(&self.res.recipes, items[0].clone()); + // BrewingStandBlockEntity.serverTick notices a new ingredient itself. + Some(BlockEntity::Brewing(b)) => { + for k in 0..5 { + b.items[k] = menu.slot(k).cloned(); + } + } + _ => {} } - host.play.entry(conn).or_default().crafting.furnace = Some((p.container, menu)); + host.play.entry(conn).or_default().crafting.machine = Some((p.container, menu)); host.hub.inventory_clicked(conn, p, &self.world, &changed); true } diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 3b7d51609..e76f2fecb 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -1180,6 +1180,7 @@ impl Game<'_> { // HopperMenu; DispenserMenu (dispensers and droppers). "minecraft:hopper" => slots(5), "minecraft:generic_3x3" => slots(9), + "minecraft:brewing_stand" => slots(5), _ => None, } } @@ -1758,17 +1759,27 @@ impl Game<'_> { self.remote_synced(); } C::ContainerSetData(p) => { - if let Some(key) = self.container - && let Some(BlockEntity::Furnace(f)) = self.world.block_entities.get_mut(&key) + let v = i32::from(p.value); + match self + .container + .and_then(|key| self.world.block_entities.get_mut(&key)) { - let v = i32::from(p.value); - match p.id { + Some(BlockEntity::Furnace(f)) => match p.id { 0 => f.lit_remaining = v, 1 => f.lit_total = v, 2 => f.cooking_timer = v, 3 => f.cooking_total = v, _ => {} - } + }, + // BrewingStandBlockEntity.dataAccess. + Some(BlockEntity::Brewing(b)) => match p.id { + 0 => b.brew_time = v, + 1 => b.fuel = v, + 2 => b.total_brew_time = v, + 3 => b.total_fuel = v, + _ => {} + }, + _ => {} } } C::OpenScreen(p) => self.remote_open_screen(p), @@ -3552,6 +3563,10 @@ impl Game<'_> { // HopperMenu, and DispenserMenu (MenuType.GENERIC_3x3: dispensers // and droppers). "minecraft:hopper" => Some(BlockEntity::Chest(vec![None; 5])), + // BrewingStandMenu: its times come in ContainerSetData. + "minecraft:brewing_stand" => Some(BlockEntity::Brewing(Box::new( + horizon_client::brewing::BrewingStand::new(), + ))), "minecraft:generic_3x3" => Some(BlockEntity::Chest(vec![None; 9])), m if m.starts_with("minecraft:generic_9x") || m == "minecraft:shulker_box" => { let rows = m diff --git a/crates/horizon-client/src/game/stations.rs b/crates/horizon-client/src/game/stations.rs index 7b70cb1f1..db64399dc 100644 --- a/crates/horizon-client/src/game/stations.rs +++ b/crates/horizon-client/src/game/stations.rs @@ -1051,7 +1051,8 @@ impl Game<'_> { } } pub(super) fn station_click(&mut self, right: bool) -> bool { - if self.station.is_none() && !self.brewing_open() { + // A server's brewing stand: its slots are the server's. + if self.station.is_none() && (!self.brewing_open() || self.remote.is_some()) { return false; } let Some(size) = self @@ -1396,6 +1397,7 @@ impl Game<'_> { .as_ref() .and_then(|s| self.world.block_names.get(&(s.pos[0], s.pos[1], s.pos[2]))) .cloned() + .or_else(|| self.remote_menu_title()) .unwrap_or(default); let tw = HudBatch::text_width(atlas, &title); batch.text( diff --git a/crates/horizon-client/src/lan/containers.rs b/crates/horizon-client/src/lan/containers.rs index 3ecd58b80..a807fb82a 100644 --- a/crates/horizon-client/src/lan/containers.rs +++ b/crates/horizon-client/src/lan/containers.rs @@ -428,15 +428,17 @@ impl Hub { let Slots::Block(pos) = m.slots else { return; }; - let Some(BlockEntity::Furnace(f)) = world.block_entities.get(&pos) else { - return; - }; - let data = [ - f.lit_remaining, - f.lit_total, - f.cooking_timer, - f.cooking_total, - ] + // AbstractFurnaceBlockEntity.dataAccess, BrewingStandBlockEntity.dataAccess. + let data = match world.block_entities.get(&pos) { + Some(BlockEntity::Furnace(f)) => [ + f.lit_remaining, + f.lit_total, + f.cooking_timer, + f.cooking_total, + ], + Some(BlockEntity::Brewing(b)) => [b.brew_time, b.fuel, b.total_brew_time, b.total_fuel], + _ => return, + } .map(|v| v as i16); m.sent_data.resize(data.len(), i16::MIN); let window = m.window; diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index a0ae2615e..74176d705 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -23,6 +23,9 @@ address. The script then checks, from both sides, what a guest's game used to ge opens as 9x6 with the right half first; - machines: a hopper, a dispenser and a dropper open on the guest's screen with their 5 and 9 slots, and keep what the guest shift-clicks into them (#848); +- brewing: a brewing stand opens on the guest's screen; blaze powder, nether wart and a bottle the + guest shift-clicks go to the fuel, ingredient and bottle slots, and the stand's fuel shows + (#848); - feedback: the guest's command feedback names the guest and shows the numbers; - effects: a beacon's power reaches every player in range, the host and the guest; - distance: (--server-thread) the server follows the host's render distance, past vanilla's 32 too @@ -86,7 +89,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', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'machines', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'objects', 'projectiles', 'light', 'effects', 'portals', 'distance'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'machines', 'brewing', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'objects', 'projectiles', 'light', 'effects', 'portals', 'distance'] class Game: @@ -668,6 +671,40 @@ def check_machines(host, guest, out): return seen +def check_brewing(host, guest, out): + guest('command', command='gamemode survival') + guest('command', command='clear @s') + loads = ('blaze_powder', 'nether_wart', 'glass_bottle') + for item in loads: + guest('command', command=f'give @s minecraft:{item}') + x, y, z = (int(v // 1) for v in pos_of(guest)) + at = (x, y, z + 2) + guest('command', command=f'setblock {at[0]} {at[1]} {at[2]} minecraft:brewing_stand') + guest.wait(10) + guest.raw('interact', *at) + guest.raw('wait-for', 'screen', 'container', '--timeout', 10) + guest.wait(10) + size = container_items(guest)[1] + # BrewingStandMenu.quickMoveStack: blaze powder to the fuel slot, an ingredient to its slot, + # a bottle to the bottle slots. + for item in loads: + guest.raw('click-slot', hotbar_slot(guest, f'minecraft:{item}'), 'shift') + guest.wait(5) + # BrewingStandBlockEntity.serverTick burns the blaze powder into 20 uses; the guest sees them + # through the menu's data slots. + guest.wait(10) + info = guest.raw('menu')['info'] + guest.shot(out, 'brewing') + guest.raw('key', 'esc', 'tap') + guest.wait(10) + items = open_container(guest, at, out, 'brewing-after')[0] + guest('command', command=f'setblock {at[0]} {at[1]} {at[2]} minecraft:air') + seen = {'size': size, 'items': items, 'fuel': info and info.get('fuel')} + want = {'size': 5, 'items': {0: 'minecraft:glass_bottle', 3: 'minecraft:nether_wart'}, 'fuel': 20} + assert seen == want, f'the brewing stand on the guest: {seen}' + return seen + + def slot_point(game, slot): """The GUI point in the middle of slot `slot` of the open screen (`ui`'s slot-N).""" for w in game.raw('ui')['widgets']: @@ -1303,7 +1340,7 @@ def check_light(host, guest, out): CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'nametags': check_nametags, 'chest': check_chest, 'crafting': check_crafting, 'sign': check_sign, 'damage': check_damage, 'mobs': check_mobs, 'hazards': check_hazards, 'pvp': check_pvp, - 'containers': check_containers, 'machines': check_machines, 'feedback': check_feedback, 'titles': check_titles, + 'containers': check_containers, 'machines': check_machines, 'brewing': check_brewing, 'feedback': check_feedback, 'titles': check_titles, 'commands': check_commands, 'recipes': check_recipes, 'trials': check_trials, 'walls': check_walls, 'effects': check_effects, 'portals': check_portals, 'distance': check_distance, 'clicks': check_clicks, From 7a6a4d92497ab3373f8f6f7178df8e2b3a37b464 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 15:46:35 +0200 Subject: [PATCH 130/163] Server thread: horizon-ctl tp and fly make the server load the new chunks (#861) With the world on its server thread, a horizon-ctl `tp` or `fly` moved the window's player to chunks the server had not sent. The client skips its tick while its own chunk isn't loaded, so it never sent the move, and the server kept streaming the old area: "loading terrain..." forever. - The client sends a move made where nothing is loaded (by horizon-ctl; a player who walks there has already sent it), so the server streams the chunks there. - The integrated server doesn't check its owner's moves, as vanilla's `shouldCheckPlayerMovement` (`isSingleplayerOwner`); a long `tp` was "moved too quickly". - `wait-ready` on a server also waits for the level around the player (`PlayerLoaded`); the status shows it as `server.loaded`. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/bin/horizon-ctl/main.rs | 7 ++++++- crates/horizon-client/src/game/integrated.rs | 1 + crates/horizon-client/src/game/remote.rs | 14 ++++++++++++++ crates/horizon-client/src/lan/hub.rs | 12 +++++++++--- 4 files changed, 30 insertions(+), 4 deletions(-) diff --git a/crates/horizon-client/src/bin/horizon-ctl/main.rs b/crates/horizon-client/src/bin/horizon-ctl/main.rs index 2e1b1bb56..27d9d5ba1 100644 --- a/crates/horizon-client/src/bin/horizon-ctl/main.rs +++ b/crates/horizon-client/src/bin/horizon-ctl/main.rs @@ -215,7 +215,12 @@ impl Session { let deadline = Instant::now() + Duration::from_secs_f64(limit.max(0.0)); loop { let status = self.game("status")?; - if !status["player"].is_null() && status["pending_chunks"] == 0 { + // On a server (single player's server thread too), also the + // level around the player. + if !status["player"].is_null() + && status["pending_chunks"] == 0 + && status["server"]["loaded"] != false + { return Ok(status); } if Instant::now() > deadline { diff --git a/crates/horizon-client/src/game/integrated.rs b/crates/horizon-client/src/game/integrated.rs index b2c0a2e7f..56d71ca96 100644 --- a/crates/horizon-client/src/game/integrated.rs +++ b/crates/horizon-client/src/game/integrated.rs @@ -316,6 +316,7 @@ impl Game<'_> { // The owner is an operator when the world allows commands // (`IntegratedPlayerList`, `MinecraftServer.getProfilePermissions`). host.hub.ops.insert(owner, if commands { 4 } else { 0 }); + host.hub.singleplayer_owner = Some(owner); host.owner = Some(Owner { uuid: owner, saved: Some(saved), diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 680360c93..3be2df388 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -2418,6 +2418,17 @@ impl Game<'_> { (player.position.z.floor() as i32) >> 4, ); if !self.streaming.is_lit(cx, cz) { + // Moved where nothing is loaded by horizon-ctl (`tp`, `fly`): + // the server hears of it, and sends the chunks there. A player + // who walked there has already sent that move. + let pos = [player.position.x, player.position.y, player.position.z]; + if let Some(r) = self.remote.as_ref() + && r.loaded_sent + && r.last_pos != pos + { + let input = r.last_input; + self.remote_send_state(input); + } return Ok(()); } if self.remote.as_ref().is_some_and(|r| !r.loaded_sent) { @@ -3707,6 +3718,9 @@ impl Game<'_> { "address": horizon_client::net::shown_address(&r.session.address), "name": r.session.name, "joined": r.joined, + // ServerboundPlayerLoadedPacket sent: the level around the + // player is ready, and the client ticks and sends its moves. + "loaded": r.loaded_sent, "status": r.status, "entity_id": r.entity_id, "dimension": r.dimension.name, diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index 5d593be2d..ca198b7b6 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -132,6 +132,9 @@ pub struct Hub { /// The `player_movement_check` and `elytra_movement_check` game rules, /// set by the game before each tick. pub movement_checks: (bool, bool), + /// An integrated server's owner (`MinecraftServer.isSingleplayerOwner`), + /// whose moves are never checked. + pub singleplayer_owner: Option<u128>, /// Who rides what, set by the game before each tick. pub riding: super::entity::Riding, last_clock: i64, @@ -265,6 +268,7 @@ impl Hub { sync, ticks: 0, movement_checks: (true, true), + singleplayer_owner: None, riding: Default::default(), last_clock: i64::MIN, last_rate: 0.0, @@ -1893,6 +1897,7 @@ impl Hub { ) { let (frozen, (check, elytra_check)) = (self.ticking.1, self.movement_checks); let g = &mut self.guests[i]; + let owner = self.singleplayer_owner == Some(g.uuid); let to = [ to[0].clamp(-3.0E7, 3.0E7), to[1].clamp(-2.0E7, 2.0E7), @@ -1916,9 +1921,10 @@ impl Hub { if packets > 5 { packets = 1; } - // shouldCheckPlayerMovement. The server holds no velocity for a - // guest (getDeltaMovement), so nothing is expected. - if check && (!g.fall_flying || elytra_check) { + // shouldCheckPlayerMovement (never the single-player owner). + // The server holds no velocity for a guest (getDeltaMovement), + // so nothing is expected. + if !owner && check && (!g.fall_flying || elytra_check) { let limit = if g.fall_flying { 300.0 } else { 100.0 }; if moved > limit * f64::from(packets) { events.push(HostEvent::Warn(format!( From 378739703b2a078c9b2042e8ea14de48748b884a Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sun, 18 Oct 2026 15:45:06 +0100 Subject: [PATCH 131/163] Fix F3 debug overlay toggling in the main menu --- crates/horizon-client/src/game.rs | 1 - crates/horizon-client/src/game/debug_keys.rs | 3 +++ 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 85a191832..7b224a249 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -9558,7 +9558,6 @@ impl ApplicationHandler for Game<'_> { event: key_event, .. } = &event && let PhysicalKey::Code(key) = key_event.physical_key - && self.title.is_none() { use horizon_client::debug_keys::KeyAction; let action = match (key_event.state, key_event.repeat) { diff --git a/crates/horizon-client/src/game/debug_keys.rs b/crates/horizon-client/src/game/debug_keys.rs index 1de6669e7..d90ac907d 100644 --- a/crates/horizon-client/src/game/debug_keys.rs +++ b/crates/horizon-client/src/game/debug_keys.rs @@ -51,6 +51,9 @@ impl DebugHost for Host<'_, '_> { impl Game<'_> { fn open_screen(&self) -> OpenScreen { + if self.title.is_some() { + return OpenScreen::Other; + } match self.screen { Screen::GameModeSwitcher => OpenScreen::GameModeSwitcher, Screen::Playing if self.book.is_none() && self.sign_edit.is_none() => OpenScreen::None, From 159a5dfa5f0c800de5fb8576c808f5e8315e64cd Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 14:14:48 +0200 Subject: [PATCH 132/163] LAN: pressure plates, tripwires and detector rails see the guests Block triggers counted only the host's own player and the minecarts, so a guest stepping on a plate did nothing. The guests in the level, not spectators, now trigger them through Entity.checkInsideBlocks and are counted by the plates' entity queries. On the server thread no block ticks run at all yet (#890). lan_e2e.py plates: a stone plate under the guest, on both sides. Part of #848 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game.rs | 23 ++++++++++++++---- crates/horizon-client/src/game/lan_mobs.rs | 20 ++++++++++++++++ tools/lan_e2e.py | 27 ++++++++++++++++++++-- 3 files changed, 63 insertions(+), 7 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 85a191832..0669ea4de 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -460,6 +460,8 @@ struct GameLevel<'w> { raining: bool, thundering: bool, player_box: Option<([f64; 3], [f64; 3])>, + /// The LAN guests in this level who trigger blocks (not spectators). + guest_boxes: Vec<([f64; 3], [f64; 3])>, player_collision: Option<PlayerCollision>, /// Minecart boxes (detector rails). cart_boxes: Vec<([f64; 3], [f64; 3])>, @@ -673,7 +675,7 @@ impl LevelAccess for GameLevel<'_> { .unwrap_or(false) } /// Entities that trigger pressure plates, tripwires and detector rails: - /// the player (a mob) and the minecarts. + /// the players (the host and the LAN guests, mobs) and the minecarts. fn count_entities(&self, area: Aabb, query: EntityQuery) -> usize { let hit = |(lo, hi): &([f64; 3], [f64; 3])| { area.intersects(Aabb::new( @@ -682,10 +684,17 @@ impl LevelAccess for GameLevel<'_> { )) }; let carts = || self.cart_boxes.iter().filter(|b| hit(b)).count(); + let players = || { + self.player_box + .iter() + .chain(&self.guest_boxes) + .filter(|b| hit(b)) + .count() + }; match query { EntityQuery::Minecart => carts(), - EntityQuery::Mobs => self.player_box.iter().filter(|b| hit(b)).count(), - EntityQuery::Everything => self.player_box.iter().filter(|b| hit(b)).count() + carts(), + EntityQuery::Mobs => players(), + EntityQuery::Everything => players() + carts(), } } fn emit(&mut self, event: LevelEvent) { @@ -1868,6 +1877,7 @@ impl Game<'_> { ) }) .collect(); + let guest_boxes = self.lan_block_trigger_boxes(); let dimension = match self.dim { Dim::Overworld => LevelDimension::Overworld, Dim::Nether => LevelDimension::Nether, @@ -1885,6 +1895,7 @@ impl Game<'_> { raining: rain > 0.2, thundering: thunder > 0.9, player_box, + guest_boxes, player_collision, biomes: &self.res.biomes, seed: self.level.seed, @@ -1963,8 +1974,9 @@ impl Game<'_> { ticking.push((x, z, sections)); } // Entity.checkInsideBlocks for the plates, tripwires and detector rails - // under the player and the minecarts. + // under the players (the host and the LAN guests) and the minecarts. let mut inside = Vec::new(); + let guests = self.lan_block_trigger_boxes(); let boxes = self .player .iter() @@ -1983,7 +1995,8 @@ impl Game<'_> { [p.x - 0.49, p.y, p.z - 0.49], [p.x + 0.49, p.y + 0.7, p.z + 0.49], ) - })); + })) + .chain(guests); for (lo, hi) in boxes { for x in (lo[0] + 1e-7).floor() as i32..=(hi[0] - 1e-7).floor() as i32 { for y in (lo[1] + 1e-7).floor() as i32..=(hi[1] - 1e-7).floor() as i32 { diff --git a/crates/horizon-client/src/game/lan_mobs.rs b/crates/horizon-client/src/game/lan_mobs.rs index 99888058c..0ee991737 100644 --- a/crates/horizon-client/src/game/lan_mobs.rs +++ b/crates/horizon-client/src/game/lan_mobs.rs @@ -131,6 +131,26 @@ impl Game<'_> { self.lan = Some(host); } + /// The guests' boxes for the blocks entities trigger (pressure plates, + /// tripwires, detector rails): `Entity.checkInsideBlocks` and + /// `Level.getEntities` see every player in the level, but not spectators + /// (`Entity.isIgnoringBlockTriggers`). + pub(super) fn lan_block_trigger_boxes(&self) -> Vec<([f64; 3], [f64; 3])> { + let Some(host) = self.lan.as_ref() else { + return Vec::new(); + }; + host.hub + .guests + .iter() + .filter(|g| host.hub.here(g) && g.loaded && !g.dead && !g.spectator()) + .map(|g| { + let [x, y, z] = g.position; + let height = if g.sneaking { 1.5 } else { 1.8 }; + ([x - 0.3, y, z - 0.3], [x + 0.3, y + height, z + 0.3]) + }) + .collect() + } + /// The guests a projectile can hit, under their entity ids. pub(super) fn lan_projectile_targets(&self) -> Vec<(Who, Aabb)> { let Some(host) = self.lan.as_ref() else { diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 4d13b1c22..f59d00b95 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -49,6 +49,8 @@ address. The script then checks, from both sides, what a guest's game used to ge guest as the host has them (kind, place, rotation, what they hold or wear, the variant). - projectiles: primed TNT (one falling), an end crystal and an arrow that lands reach the guest where the host has them; a falling block lands on both sides. +- plates: a stone pressure plate the guest steps on is pressed on both sides, and comes up once + the guest steps off (#848). - light: the guest's light matches the host's: around a torch placed near it, under a roof and once a block of the roof is removed under the sky, and in the last chunk it tracks next to glowstone in a chunk it doesn't (only the server's light updates bring that one). @@ -84,7 +86,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', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'objects', 'projectiles', 'light', 'effects', 'portals', 'distance'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'containers', 'feedback', 'titles', 'commands', 'recipes', 'trials', 'clicks', 'sleep', 'push', 'eat', 'xp', 'objects', 'projectiles', 'light', 'plates', 'effects', 'portals', 'distance'] class Game: @@ -958,6 +960,27 @@ def wait_state(game, pos, key, want, ticks): return state_of(game, pos, key) +def check_plates(host, guest, out): + guest('command', command='gamemode survival') + x, y, z = (int(v // 1) for v in pos_of(guest)) + plate = (x + 2, y, z) + guest('command', command=f'setblock {plate[0]} {plate[1]} {plate[2]} minecraft:stone_pressure_plate') + guest.wait(10) + guest('command', command=f'tp @s {plate[0] + 0.5} {plate[1]} {plate[2] + 0.5}') + pressed = {'host': wait_state(host, plate, 'powered', 'true', 40), + 'guest': wait_state(guest, plate, 'powered', 'true', 40)} + guest.shot(out, 'plate-pressed') + guest('command', command=f'tp @s {x + 0.5} {y} {z + 0.5}') + # PressurePlateBlock.getPressedTime: a stone plate checks again every 20 ticks. + released = {'host': wait_state(host, plate, 'powered', 'false', 60), + 'guest': wait_state(guest, plate, 'powered', 'false', 60)} + guest('command', command=f'setblock {plate[0]} {plate[1]} {plate[2]} minecraft:air') + detail = {'pressed': pressed, 'released': released} + assert pressed == {'host': 'true', 'guest': 'true'}, f'the plate under the guest: {detail}' + assert released == {'host': 'false', 'guest': 'false'}, f'the plate after the guest left: {detail}' + return detail + + def check_trials(host, guest, out): # The host watches as a spectator, whom neither block detects: only the guest can wake them. hx, hy, hz = pos_of(host) @@ -1278,7 +1301,7 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'effects': check_effects, 'portals': check_portals, 'distance': check_distance, 'clicks': check_clicks, 'sleep': check_sleep, 'push': check_push, 'eat': check_eat, 'xp': check_xp, 'objects': check_objects, 'projectiles': check_projectiles, - 'light': check_light} + 'light': check_light, 'plates': check_plates} def run(ctl, out, resources, checks): From be161f100b5eeb565d56db3d1aab7b43095b0bcd Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 17:15:24 +0200 Subject: [PATCH 133/163] Report the world's tick time in flight summaries A `fly` benchmark replied with frame times only. With single player on its server thread, the world's ticks no longer show in the frames, so a flight could not tell how long the server took. The summary now has tick_ms and tick_ms_max: the world's smoothed tick time (the F3 server line) averaged and at its highest over the flight. On the server thread it is the server's. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../src/bin/horizon-ctl/commands.rs | 2 +- crates/horizon-client/src/game/control.rs | 17 ++++++++++++++++- 2 files changed, 17 insertions(+), 2 deletions(-) diff --git a/crates/horizon-client/src/bin/horizon-ctl/commands.rs b/crates/horizon-client/src/bin/horizon-ctl/commands.rs index 3e47a0545..8f64705c6 100644 --- a/crates/horizon-client/src/bin/horizon-ctl/commands.rs +++ b/crates/horizon-client/src/bin/horizon-ctl/commands.rs @@ -343,7 +343,7 @@ pub const COMMANDS: &[Cmd] = &[ 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!("fly", Scripting, "fly X1 Y1 Z1 X2 Y2 Z2 SECONDS [PITCH [raw]]", "fly the camera along a line, then reply with the frame summary", - "With raw, the reply also lists every frame time in milliseconds (frame_ms).", + "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), ]; diff --git a/crates/horizon-client/src/game/control.rs b/crates/horizon-client/src/game/control.rs index 6827d49c9..2f57c9baa 100644 --- a/crates/horizon-client/src/game/control.rs +++ b/crates/horizon-client/src/game/control.rs @@ -54,12 +54,23 @@ pub struct Flight { /// Reply with every frame time too (`fly ... PITCH raw`). raw: bool, reply: Sender<String>, + /// The world's smoothed tick time each frame (the F3 server line): the + /// server thread's when single player runs on one. + tick_ms: Vec<f32>, } impl Game<'_> { /// Move the camera along the running flight; reply when it ends. pub(super) fn advance_flight(&mut self) { - let Some(flight) = &self.flight else { return }; + let tick_ms = self + .integrated + .as_ref() + .map_or(self.debug_charts.smoothed_tick_ms, |s| s.smoothed_tick_ms()); + let Some(flight) = self.flight.as_mut() else { + return; + }; + flight.tick_ms.push(tick_ms); + let flight = &*flight; let t = (flight.started.elapsed().as_secs_f64() / flight.seconds).min(1.0); let (a, b) = (flight.from, flight.to); let d = [b.x - a.x, b.y - a.y, b.z - a.z]; @@ -79,6 +90,9 @@ impl Game<'_> { && let Some(flight) = self.flight.take() { let mut summary = self.frame_stats.summary(); + let n = flight.tick_ms.len().max(1) as f32; + summary["tick_ms"] = (flight.tick_ms.iter().sum::<f32>() / n).into(); + summary["tick_ms_max"] = flight.tick_ms.iter().copied().fold(0.0, f32::max).into(); if flight.raw { summary["frame_ms"] = self.frame_stats.frame_millis().into(); summary["cpu_ms"] = self.frame_stats.cpu_millis().into(); @@ -527,6 +541,7 @@ impl Game<'_> { seconds: n(7)?.max(0.1), raw: words.get(9) == Some(&"raw"), reply: reply.clone(), + tick_ms: Vec::new(), }); Ok(None) } From aea18f245f33cade3403133cde107c3d6be9a6bd Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 17:22:13 +0200 Subject: [PATCH 134/163] Renderer: one command buffer per frame, uploads before the first pass wgpu-core ends its Metal command buffer at every pass: each render or compute pass costs two command buffers (the pass and its barriers), each run of copies between passes one more, and Metal creates and commits every one on its own. The frame made about 18: the section copies in their own encoder, the queue's pending writes for the HUD's fire animation, copies before and after the flatten pass, and the screen effects' and HUD's vertex uploads between later passes. At render distance 32 that cost 2-5 ms of submit per frame, mostly waiting on the command queue's lock. The frame now records after the section copies in their encoder, stages the fire animation and the HUD's glyph patches through the frame's belt instead of Queue::write_texture, and records every upload (screen effects, HUD, flatten inputs, indirect draws) before the first pass. The commands and their order within each pass are unchanged. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/gfx.rs | 165 +++++++++++++----------- crates/horizon-client/src/gfx/upload.rs | 4 +- crates/horizon-client/src/hud.rs | 57 ++++---- 3 files changed, 123 insertions(+), 103 deletions(-) diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index dcc3f417d..d3b71bc60 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -332,7 +332,7 @@ pub struct Renderer { animations: AnimatedSprites, uploads: upload::Uploads, /// Section meshes are staged through their own belt into - /// `section_copies`, which the next submission runs ahead of the frame: + /// `section_copies`, which the next frame records its commands after: /// `Queue::write_buffer` would make a staging buffer per write. section_uploads: upload::Uploads, section_copies: Option<wgpu::CommandEncoder>, @@ -2394,14 +2394,21 @@ impl Renderer { Some(f) => f.texture.clone(), None => self.offscreen.clone().ok_or("no offscreen target")?, }; - let mut encoder = self - .device - .create_command_encoder(&wgpu::CommandEncoderDescriptor { - label: Some("Horizon frame"), - }); + // One command buffer for the frame, after the section copies staged + // since the last one: Metal commits every command buffer wgpu-core + // makes (one per run of copies and two per pass) on its own. + let section_copies = self.section_copies.take(); + let has_section_copies = section_copies.is_some(); + let mut encoder = section_copies.unwrap_or_else(|| { + self.device + .create_command_encoder(&wgpu::CommandEncoderDescriptor { + label: Some("Horizon frame"), + }) + }); if self.animated_textures { self.animate(&mut encoder, frame.ticks); - self.hud.animate_fire(&self.queue, frame.ticks); + self.hud + .animate_fire(&mut self.uploads, &mut encoder, frame.ticks); } self.update_lightmap( &mut encoder, @@ -2661,48 +2668,6 @@ impl Renderer { } else { self.draws.len() }; - let flat_frame = match &mut self.flat { - Some(flat) - if self.flat_on && !self.draws.is_empty() && self.draws.len() >= flat.min_draws => - { - let sections = &self.sections; - let sorted = &self.sorted_indices; - crate::spans::time("flatten", || { - flat.prepare( - &self.device, - &mut encoder, - &mut self.uploads, - &self.draws, - &self.draw_pages, - solid_draws as usize, - visible - .iter() - .filter_map(|v| sections.get(v.slot).flat_id.map(|id| (id, v.origin))), - |page| sorted.buffer(page).clone(), - ) - }) - } - _ => false, - }; - if flat_frame { - self.section_draw_calls = self.flat.as_ref().map_or(0, |f| f.calls.len()); - } else if self.multi_draw && !self.draws.is_empty() { - if self.draws.len() as u64 > self.indirect_capacity { - self.indirect_capacity = (self.draws.len() as u64).next_power_of_two(); - self.indirect = self.device.create_buffer(&wgpu::BufferDescriptor { - label: Some("Section draws"), - size: self.indirect_capacity * 20, - usage: wgpu::BufferUsages::INDIRECT | wgpu::BufferUsages::COPY_DST, - mapped_at_creation: false, - }); - } - self.uploads.buffer( - &mut encoder, - &self.indirect, - 0, - bytemuck::cast_slice(&self.draws), - ); - } let debug_depth = frame.debug_lines.len() as u32; let debug_top = frame.debug_lines_on_top.len() as u32; let crosshair = frame.debug_crosshair.len() as u32; @@ -2839,6 +2804,77 @@ impl Renderer { bytemuck::bytes_of(&uniform), ); } + // Every upload before the frame's first pass: a pass ends wgpu-core's + // command buffer, so copies between passes would need one more. + if !frame.screen.is_empty() { + let vertices: Vec<crate::screen_effects::ScreenVertex> = + frame.screen.iter().flat_map(|q| q.vertices).collect(); + if vertices.len() as u64 > self.screen_capacity { + self.screen_capacity = (vertices.len() as u64).next_power_of_two(); + self.screen_buffer = self.device.create_buffer(&wgpu::BufferDescriptor { + label: Some("Screen effect vertices"), + size: self.screen_capacity + * std::mem::size_of::<crate::screen_effects::ScreenVertex>() as u64, + usage: wgpu::BufferUsages::VERTEX | wgpu::BufferUsages::COPY_DST, + mapped_at_creation: false, + }); + } + self.uploads.buffer( + &mut encoder, + &self.screen_buffer, + 0, + bytemuck::cast_slice(&vertices), + ); + } + self.hud.prepare( + &self.device, + &mut self.uploads, + &mut encoder, + frame.hud, + [self.config.width, self.config.height], + ); + let flat_frame = match &mut self.flat { + Some(flat) + if self.flat_on && !self.draws.is_empty() && self.draws.len() >= flat.min_draws => + { + let sections = &self.sections; + let sorted = &self.sorted_indices; + crate::spans::time("flatten", || { + flat.prepare( + &self.device, + &mut encoder, + &mut self.uploads, + &self.draws, + &self.draw_pages, + solid_draws as usize, + visible + .iter() + .filter_map(|v| sections.get(v.slot).flat_id.map(|id| (id, v.origin))), + |page| sorted.buffer(page).clone(), + ) + }) + } + _ => false, + }; + if flat_frame { + self.section_draw_calls = self.flat.as_ref().map_or(0, |f| f.calls.len()); + } else if self.multi_draw && !self.draws.is_empty() { + if self.draws.len() as u64 > self.indirect_capacity { + self.indirect_capacity = (self.draws.len() as u64).next_power_of_two(); + self.indirect = self.device.create_buffer(&wgpu::BufferDescriptor { + label: Some("Section draws"), + size: self.indirect_capacity * 20, + usage: wgpu::BufferUsages::INDIRECT | wgpu::BufferUsages::COPY_DST, + mapped_at_creation: false, + }); + } + self.uploads.buffer( + &mut encoder, + &self.indirect, + 0, + bytemuck::cast_slice(&self.draws), + ); + } let view_target = target_texture.create_view(&wgpu::TextureViewDescriptor { format: Some(self.config.format.remove_srgb_suffix()), ..Default::default() @@ -3102,24 +3138,6 @@ impl Renderer { ); } if !frame.screen.is_empty() { - let vertices: Vec<crate::screen_effects::ScreenVertex> = - frame.screen.iter().flat_map(|q| q.vertices).collect(); - if vertices.len() as u64 > self.screen_capacity { - self.screen_capacity = (vertices.len() as u64).next_power_of_two(); - self.screen_buffer = self.device.create_buffer(&wgpu::BufferDescriptor { - label: Some("Screen effect vertices"), - size: self.screen_capacity - * std::mem::size_of::<crate::screen_effects::ScreenVertex>() as u64, - usage: wgpu::BufferUsages::VERTEX | wgpu::BufferUsages::COPY_DST, - mapped_at_creation: false, - }); - } - self.uploads.buffer( - &mut encoder, - &self.screen_buffer, - 0, - bytemuck::cast_slice(&vertices), - ); let attachments = [Some(wgpu::RenderPassColorAttachment { view: &view_target, resolve_target: None, @@ -3212,9 +3230,6 @@ impl Renderer { ); } self.hud.draw( - &self.device, - &self.queue, - &mut self.uploads, &mut encoder, &view_target, &self.depth, @@ -3229,12 +3244,12 @@ impl Renderer { .take() .map(|path| (path, self.copy_frame(&mut encoder, &target_texture))); self.uploads.finish(&encoder); + if has_section_copies { + self.section_copy_bytes = 0; + self.section_uploads.finish(&encoder); + } let commands = crate::spans::time("encode", || encoder.finish()); - // The section copies run first: this frame draws what they write. - let copies = self.take_section_copies(); - let submission = crate::spans::time("submit", || { - self.queue.submit(copies.into_iter().chain([commands])) - }); + let submission = crate::spans::time("submit", || self.queue.submit([commands])); if let Some(timer) = &mut self.gpu_timer { timer.submitted(); timer.collect(&self.device, &mut self.gpu_times); diff --git a/crates/horizon-client/src/gfx/upload.rs b/crates/horizon-client/src/gfx/upload.rs index a60791d4c..0d56c73a0 100644 --- a/crates/horizon-client/src/gfx/upload.rs +++ b/crates/horizon-client/src/gfx/upload.rs @@ -36,7 +36,9 @@ impl Uploads { let row = width as usize * 4; debug_assert_eq!(pixels.len(), row * height as usize); let padded = row.next_multiple_of(wgpu::COPY_BYTES_PER_ROW_ALIGNMENT as usize); - let size = NonZeroU64::new((padded * height as usize) as u64).expect("non-empty texture"); + let Some(size) = NonZeroU64::new((padded * height as usize) as u64) else { + return; + }; let alignment = NonZeroU64::new(u64::from(wgpu::COPY_BYTES_PER_ROW_ALIGNMENT)) .expect("non-zero alignment"); let slice = self.belt.allocate(size, alignment); diff --git a/crates/horizon-client/src/hud.rs b/crates/horizon-client/src/hud.rs index be4bdb52e..0cc99b07b 100644 --- a/crates/horizon-client/src/hud.rs +++ b/crates/horizon-client/src/hud.rs @@ -977,7 +977,12 @@ impl HudRenderer { capacity, }) } - pub fn animate_fire(&mut self, queue: &wgpu::Queue, tick: u64) { + pub fn animate_fire( + &mut self, + uploads: &mut crate::gfx::upload::Uploads, + encoder: &mut wgpu::CommandEncoder, + tick: u64, + ) { let Some(texture) = &self.atlas_texture else { return; }; @@ -987,7 +992,8 @@ impl HudRenderer { continue; } let pixels = animation.resized_pixels(frame, rect.w, rect.h); - queue.write_texture( + uploads.texture( + encoder, wgpu::TexelCopyTextureInfo { texture, mip_level: 0, @@ -998,35 +1004,27 @@ impl HudRenderer { }, aspect: wgpu::TextureAspect::All, }, + rect.w, + rect.h, &pixels, - wgpu::TexelCopyBufferLayout { - offset: 0, - bytes_per_row: Some(rect.w * 4), - rows_per_image: Some(rect.h), - }, - wgpu::Extent3d { - width: rect.w, - height: rect.h, - depth_or_array_layers: 1, - }, ); *previous = frame; } } - pub fn draw( + /// Stage the batch's atlas patches, vertices and uniform: before the + /// frame's first pass, so the copies share one command buffer. + pub fn prepare( &mut self, device: &wgpu::Device, - queue: &wgpu::Queue, uploads: &mut crate::gfx::upload::Uploads, encoder: &mut wgpu::CommandEncoder, - target: &wgpu::TextureView, - depth: &wgpu::TextureView, batch: &HudBatch, size: [u32; 2], ) { if let Some(texture) = &self.atlas_texture { for p in &batch.patches { - queue.write_texture( + uploads.texture( + encoder, wgpu::TexelCopyTextureInfo { texture, mip_level: 0, @@ -1037,17 +1035,9 @@ impl HudRenderer { }, aspect: wgpu::TextureAspect::All, }, + p.width, + p.height, &p.rgba, - wgpu::TexelCopyBufferLayout { - offset: 0, - bytes_per_row: Some(p.width * 4), - rows_per_image: None, - }, - wgpu::Extent3d { - width: p.width, - height: p.height, - depth_or_array_layers: 1, - }, ); } } @@ -1078,6 +1068,19 @@ impl HudRenderer { size: [size[0] as f32, size[1] as f32, batch.scale, 0.0], }), ); + } + /// Draw the batch `prepare` staged. + pub fn draw( + &self, + encoder: &mut wgpu::CommandEncoder, + target: &wgpu::TextureView, + depth: &wgpu::TextureView, + batch: &HudBatch, + size: [u32; 2], + ) { + if batch.vertices.is_empty() || size.contains(&0) { + return; + } let attachments = [Some(wgpu::RenderPassColorAttachment { view: target, resolve_target: None, From 44fba3bf9d8b2b96c6c21855fc7970107a8d8b8b Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 17:50:52 +0200 Subject: [PATCH 135/163] horizon-server: find game files prepared without sounds init and run looked for asset-index.json to recognise a prepared folder, but horizon-prepare writes that file only with the optional sounds (`horizon-prepare sounds`). A server prepared the usual way, without sounds, was never found: init said "no prepared game files" and listed the folder that held them. They are now recognised by horizon-resources.json, the manifest every preparation writes and the one the game itself reads. Found by installing v2026.10.18.15 with install.sh on the Mac mini and preparing from the release folder. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-server/src/engine.rs | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/crates/horizon-server/src/engine.rs b/crates/horizon-server/src/engine.rs index c0043e1d3..b39b5bed9 100644 --- a/crates/horizon-server/src/engine.rs +++ b/crates/horizon-server/src/engine.rs @@ -65,12 +65,13 @@ pub fn resource_candidates(config: &Config, dir: &Path, program: Option<&Path>) out } -/// The prepared game files: a folder holding the asset index `horizon-prepare` writes. +/// The prepared game files: a folder holding the manifest every `horizon-prepare` run writes +/// (`asset-index.json` comes only with the optional sounds, which a server doesn't need). pub fn resources(config: &Config, dir: &Path, program: Option<&Path>) -> Result<PathBuf, String> { let candidates = resource_candidates(config, dir, program); candidates .iter() - .find(|d| d.join("asset-index.json").is_file()) + .find(|d| d.join("horizon-resources.json").is_file()) .cloned() .ok_or_else(|| { let tried: Vec<String> = candidates @@ -179,4 +180,19 @@ mod tests { [PathBuf::from("/data/res")] ); } + + #[test] + fn resources_prepared_without_sounds_are_found() { + let root = std::env::temp_dir().join(format!("horizon-server-res-{}", std::process::id())); + let prepared = root.join(".local/horizon-client/26.3"); + std::fs::create_dir_all(&prepared).unwrap(); + let program = root.join("horizon-client"); + let config = Config::default(); + let server = root.join("server"); + assert!(resources(&config, &server, Some(&program)).is_err()); + // What `horizon-prepare` writes on every run; no asset index without `horizon-prepare sounds`. + std::fs::write(prepared.join("horizon-resources.json"), "{}").unwrap(); + assert_eq!(resources(&config, &server, Some(&program)), Ok(prepared)); + std::fs::remove_dir_all(&root).unwrap(); + } } From 1b141ef33073505b9bfa8a97a4a3e67354aba46d Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 18:04:38 +0200 Subject: [PATCH 136/163] Startup: no time limit on loading the world resources Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game.rs | 26 ++++++++++---------------- 1 file changed, 10 insertions(+), 16 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 7cda9671e..a8096487a 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -10824,18 +10824,14 @@ enum PendingWorldEntry { struct WorldRestLoader { progress: Progress, handle: JoinHandle<std::result::Result<(), String>>, - started: Instant, } impl WorldRestLoader { fn ready(&self) -> Result<bool> { - if self.handle.is_finished() { - return Ok(true); - } - if self.started.elapsed() > Duration::from_secs(120) { - return Err("world resource loading timed out after 120 seconds".into()); - } - Ok(false) + // No time limit: the title stays usable while this loads, and a slow + // disk or a debug build can take minutes. A failure ends the thread + // and is reported by `finish`. + Ok(self.handle.is_finished()) } fn finish(self) -> Result<()> { @@ -11150,7 +11146,6 @@ fn load_resources( Some(WorldRestLoader { progress: rest_progress, handle, - started: Instant::now(), }) } else { let rest = load_world_rest( @@ -12005,7 +12000,6 @@ mod tests { wait.recv().unwrap(); Ok(()) }), - started: Instant::now(), }; assert!(!loader.ready().unwrap()); release.send(()).unwrap(); @@ -12013,7 +12007,7 @@ mod tests { } #[test] - fn world_rest_poll_reports_a_stalled_worker() { + fn world_rest_poll_waits_for_a_slow_worker() { let (release, wait) = std::sync::mpsc::channel(); let loader = WorldRestLoader { progress: Progress::new(), @@ -12021,12 +12015,14 @@ mod tests { wait.recv().unwrap(); Ok(()) }), - started: Instant::now() - Duration::from_secs(121), }; - let error = loader.ready().unwrap_err().to_string(); + // However long it takes, a worker still loading is not an error. + assert!(!loader.ready().unwrap()); release.send(()).unwrap(); + while !loader.ready().unwrap() { + std::thread::sleep(Duration::from_millis(1)); + } loader.finish().unwrap(); - assert_eq!(error, "world resource loading timed out after 120 seconds"); } #[test] @@ -12034,7 +12030,6 @@ mod tests { let loader = WorldRestLoader { progress: Progress::new(), handle: std::thread::spawn(|| Err("missing world table".to_owned())), - started: Instant::now(), }; assert_eq!( loader.finish().unwrap_err().to_string(), @@ -12047,7 +12042,6 @@ mod tests { let loader = WorldRestLoader { progress: Progress::new(), handle: std::thread::spawn(|| panic!("broken loader")), - started: Instant::now(), }; assert_eq!( loader.finish().unwrap_err().to_string(), From 4ea2243e4d1a44f910857bd759845db70e3690a8 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 18:15:17 +0200 Subject: [PATCH 137/163] horizon-server on Linux: say which libraries the game needs, and follow updates On a Linux without ALSA's library (most minimal server images), the game exits at once with the loader's "error while loading shared libraries: libasound.so.2". The supervisor took that for a crash and restarted it five times over two and a half minutes before giving up with "see logs/latest.log", which holds nothing about it. Now: - `run` starts the game with --help first (it loads no game files) and, if the system can't load it, stops at once with the loader's line and the packages to install on Debian/Ubuntu, Fedora, Arch and NixOS; - `init` prints the same as a warning after "Game:"; - install.sh lists the libraries `ldd` can't find, with the same advice; - docs/server.md says so in the install section. Also, a service installed without the installer's launcher on the PATH ran `<dir>/releases/<tag>/horizon-server`: Linux reports the running program with links resolved, so the unit pinned that release and an update never reached it. The fallback now goes through `<dir>/current` while it points at that release. Found by the end-to-end install check on the ThinkPad (NixOS, no nix-ld libraries) with v2026.10.18.15. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-server/src/engine.rs | 92 +++++++++++++++++++++++++ crates/horizon-server/src/init.rs | 3 + crates/horizon-server/src/service.rs | 43 +++++++++++- crates/horizon-server/src/supervisor.rs | 2 + docs/server.md | 5 ++ packaging/server/install.sh | 12 ++++ 6 files changed, 155 insertions(+), 2 deletions(-) diff --git a/crates/horizon-server/src/engine.rs b/crates/horizon-server/src/engine.rs index b39b5bed9..d1373bb05 100644 --- a/crates/horizon-server/src/engine.rs +++ b/crates/horizon-server/src/engine.rs @@ -49,6 +49,52 @@ pub fn program(config: &Config, dir: &Path) -> Result<PathBuf, String> { }) } +/// Checks that the game program starts at all: `--help` loads no game files, so it fails only when the +/// system can't load the program, as on a Linux without the ALSA and udev libraries it links (even a +/// server needs them until there is a headless engine). The reason, with what to install. +pub fn check_starts(program: &Path) -> Result<(), String> { + let output = Command::new(program) + .arg("--help") + .stdin(Stdio::null()) + .stdout(Stdio::null()) + .stderr(Stdio::piped()) + .output() + .map_err(|e| format!("the game ({}) can't start: {e}", program.display()))?; + if output.status.success() { + return Ok(()); + } + let stderr = String::from_utf8_lossy(&output.stderr); + Err(start_failure(program, output.status.code(), &stderr)) +} + +/// What to tell the owner when the game program exits at once. +fn start_failure(program: &Path, code: Option<i32>, stderr: &str) -> String { + let reason = stderr + .lines() + .find(|l| !l.trim().is_empty()) + .unwrap_or("") + .trim(); + let mut text = format!( + "the game ({}) can't start{}{}", + program.display(), + code.map_or(String::new(), |c| format!(" (exit status {c})")), + if reason.is_empty() { + String::new() + } else { + format!(": {reason}") + } + ); + if reason.contains("error while loading shared libraries") { + text.push_str( + "\nIt needs ALSA's and udev's libraries (libasound.so.2, libudev.so.1), even on a server. Install \ + them:\n Debian, Ubuntu: sudo apt install libasound2 libudev1 (Ubuntu 24.04 and later: \ + libasound2t64)\n Fedora, RHEL: sudo dnf install alsa-lib systemd-libs\n Arch: sudo pacman -S \ + alsa-lib systemd-libs\n NixOS: enable programs.nix-ld with alsa-lib and udev in its libraries", + ); + } + text +} + /// Where the prepared game files may be, in the order they are tried. pub fn resource_candidates(config: &Config, dir: &Path, program: Option<&Path>) -> Vec<PathBuf> { if !config.engine.resources.is_empty() { @@ -195,4 +241,50 @@ mod tests { assert_eq!(resources(&config, &server, Some(&program)), Ok(prepared)); std::fs::remove_dir_all(&root).unwrap(); } + + #[test] + fn a_missing_library_says_what_to_install() { + let program = Path::new("/opt/horizon/horizon-client"); + let text = start_failure( + program, + Some(127), + "/opt/horizon/horizon-client: error while loading shared libraries: libasound.so.2: cannot open \ + shared object file: No such file or directory\n", + ); + assert!(text.starts_with( + "the game (/opt/horizon/horizon-client) can't start (exit status 127): /opt/horizon/horizon-client: \ + error while loading shared libraries: libasound.so.2" + )); + assert!(text.contains("sudo apt install libasound2 libudev1")); + let other = start_failure(program, Some(1), "something else\n"); + assert_eq!( + other, + "the game (/opt/horizon/horizon-client) can't start (exit status 1): something else" + ); + } + + #[cfg(unix)] + #[test] + fn the_check_runs_the_program() { + use std::os::unix::fs::PermissionsExt; + let root = + std::env::temp_dir().join(format!("horizon-server-check-{}", std::process::id())); + std::fs::create_dir_all(&root).unwrap(); + let script = |name: &str, body: &str| { + let path = root.join(name); + std::fs::write(&path, format!("#!/bin/sh\n{body}\n")).unwrap(); + std::fs::set_permissions(&path, std::fs::Permissions::from_mode(0o755)).unwrap(); + path + }; + assert_eq!(check_starts(&script("starts", "exit 0")), Ok(())); + let fails = script("fails", "echo 'no luck' >&2; exit 3"); + assert_eq!( + check_starts(&fails), + Err(format!( + "the game ({}) can't start (exit status 3): no luck", + fails.display() + )) + ); + std::fs::remove_dir_all(&root).unwrap(); + } } diff --git a/crates/horizon-server/src/init.rs b/crates/horizon-server/src/init.rs index 757b6def8..bd595cddb 100644 --- a/crates/horizon-server/src/init.rs +++ b/crates/horizon-server/src/init.rs @@ -205,6 +205,9 @@ pub fn run(dir: &Path, answers: Answers) -> Result<(), String> { match engine::program(&cfg, dir) { Ok(program) => { println!("Game: {}", program.display()); + if let Err(e) = engine::check_starts(&program) { + println!("Warning: {e}"); + } match engine::resources(&cfg, dir, Some(&program)) { Ok(resources) => println!("Game files: {}", resources.display()), Err(e) => println!("{e}"), diff --git a/crates/horizon-server/src/service.rs b/crates/horizon-server/src/service.rs index 2cafa0e3d..6e6d59f23 100644 --- a/crates/horizon-server/src/service.rs +++ b/crates/horizon-server/src/service.rs @@ -32,7 +32,8 @@ pub fn name(dir: &Path) -> String { } /// The program the service runs: the `horizon-server` on the PATH (the installer's launcher, which keeps -/// running the current version after an update), else this program. +/// running the current version after an update), else this program, through the installer's `current` +/// link when it runs from an installed release. fn program() -> Result<PathBuf, String> { let on_path = std::env::var_os("PATH") .map(|p| std::env::split_paths(&p).collect::<Vec<_>>()) @@ -42,10 +43,30 @@ fn program() -> Result<PathBuf, String> { .find(|p| p.is_file()); match on_path { Some(path) => Ok(path), - None => std::env::current_exe().map_err(|e| e.to_string()), + None => std::env::current_exe() + .map(|exe| through_current(&exe)) + .map_err(|e| e.to_string()), } } +/// `<dir>/releases/<tag>/horizon-server` as `<dir>/current/horizon-server` while `current` points at that +/// release (install.sh and install.ps1's layout), so an update applies at the next restart. Linux reports +/// the running program with links resolved, so the release's own path is what this program sees there. +fn through_current(exe: &Path) -> PathBuf { + let current = (|| { + let release = exe.parent()?; + let releases = release.parent()?; + if releases.file_name()? != "releases" { + return None; + } + let current = releases.parent()?.join("current"); + let name = exe.file_name()?; + let same = std::fs::canonicalize(¤t).ok()? == std::fs::canonicalize(release).ok()?; + same.then(|| current.join(name)) + })(); + current.unwrap_or_else(|| exe.to_path_buf()) +} + /// A systemd unit: a user unit, or with `user` a system unit running as that user. pub fn systemd_unit(program: &Path, dir: &Path, user: Option<&str>) -> String { let (run_as, wanted_by) = match user { @@ -374,4 +395,22 @@ mod tests { assert!(plist.contains("<string>/srv/R&D</string>")); assert!(plist.contains("<string>/srv/R&D/logs/supervisor.log</string>")); } + + #[cfg(unix)] + #[test] + fn an_installed_release_runs_through_current() { + let root = + std::env::temp_dir().join(format!("horizon-service-current-{}", std::process::id())); + let release = root.join("releases/v1"); + std::fs::create_dir_all(&release).unwrap(); + let exe = release.join("horizon-server"); + std::fs::write(&exe, "").unwrap(); + // Not the release in use (or no installer layout): this program as it is. + assert_eq!(through_current(&exe), exe); + std::os::unix::fs::symlink(&release, root.join("current")).unwrap(); + assert_eq!(through_current(&exe), root.join("current/horizon-server")); + let other = root.join("bin/horizon-server"); + assert_eq!(through_current(&other), other); + std::fs::remove_dir_all(&root).unwrap(); + } } diff --git a/crates/horizon-server/src/supervisor.rs b/crates/horizon-server/src/supervisor.rs index ad056a77c..fdec60eff 100644 --- a/crates/horizon-server/src/supervisor.rs +++ b/crates/horizon-server/src/supervisor.rs @@ -76,6 +76,8 @@ pub fn run(dir: &Path) -> Result<(), String> { let config = Config::load(dir)?; let program = engine::program(&config, dir)?; let resources = engine::resources(&config, dir, Some(&program))?; + // A game the system can't load would only crash again at every restart: say why at once. + engine::check_starts(&program)?; let _lock = lock(dir)?; let shared = Shared::new(dir); let _endpoint = api::start(shared.clone())?; diff --git a/docs/server.md b/docs/server.md index 941a4341b..6c6c4a9b4 100644 --- a/docs/server.md +++ b/docs/server.md @@ -185,6 +185,11 @@ comes out of the headless-engine work. it from GitHub Releases, and checks it against the SHA-256 GitHub publishes for each asset. It never asks for sudo. Options: `--version vX.Y.Z`, `--dir` (default `~/.local/share/horizon`), `--bin` (default `~/.local/bin`). + On Linux the game links ALSA's and udev's libraries (`libasound.so.2`, `libudev.so.1`) even as a server, + until the headless engine exists. Minimal server images often lack ALSA (Debian and Ubuntu: + `sudo apt install libasound2 libudev1`, `libasound2t64` on Ubuntu 24.04 and later). The script lists any + that are missing, `init` warns, and `run` stops at once with what to install, rather than restarting a + game that can't load. - Windows: `irm https://raw.githubusercontent.com/ludovic111/horizon/main/packaging/server/install.ps1 | iex` The script does the same into `%LOCALAPPDATA%\Horizon` (`-Version`, `-Dir`), with junctions instead of diff --git a/packaging/server/install.sh b/packaging/server/install.sh index 221fcf0a8..08b710e37 100755 --- a/packaging/server/install.sh +++ b/packaging/server/install.sh @@ -86,6 +86,18 @@ for tool in horizon-server horizon-prepare; do done echo "Installed Horizon $TAG in $RELEASE; horizon-server and horizon-prepare are in $BIN." +# The game links ALSA and udev, even as a server; minimal Linux images often lack them. +if [ "$(uname -s)" = Linux ] && command -v ldd >/dev/null; then + MISSING=$(ldd "$RELEASE/horizon-client" 2>/dev/null | awk '/not found/ { printf "%s ", $1 }') + if [ -n "$MISSING" ]; then + echo "The game needs libraries this system doesn't have: $MISSING" + echo "Install them before starting a server:" + echo " Debian, Ubuntu: sudo apt install libasound2 libudev1 (Ubuntu 24.04 and later: libasound2t64)" + echo " Fedora, RHEL: sudo dnf install alsa-lib systemd-libs" + echo " Arch: sudo pacman -S alsa-lib systemd-libs" + echo " NixOS: enable programs.nix-ld with alsa-lib and udev in its libraries" + fi +fi case ":$PATH:" in *":$BIN:"*) ;; *) echo "Add $BIN to your PATH, for example: echo 'export PATH=\"$BIN:\$PATH\"' >> ~/.profile" ;; From 80dacdba68fcac9def47f162005ae8ea80246825 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 18:36:16 +0200 Subject: [PATCH 138/163] lan_attributes: read items through Resources::items() after #878 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game/lan_attributes.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/crates/horizon-client/src/game/lan_attributes.rs b/crates/horizon-client/src/game/lan_attributes.rs index 9a324e332..72d06c2ef 100644 --- a/crates/horizon-client/src/game/lan_attributes.rs +++ b/crates/horizon-client/src/game/lan_attributes.rs @@ -53,7 +53,7 @@ impl Game<'_> { out: &mut Vec<AttributeSnapshot>, ) { for (slot, item) in slots { - let Some(info) = item.and_then(|i| self.res.items.get(i)) else { + let Some(info) = item.and_then(|i| self.res.items().get(i)) else { continue; }; for (attribute, id, amount, op, group) in &info.modifiers { From ac2547c24aa6382797160cbc0a853398fc4b8dfd Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 19:03:29 +0200 Subject: [PATCH 139/163] lan_e2e light: wait for the border chunk's light before comparing On the server thread, lan_e2e --check light failed its border step (#891): the guest's border chunk still had block light 0 next to glowstone placed in the chunk past it. The server was right; the check was not. same_light() waits until the host's light equals the guest's, but on the server thread the host's game is a client too, and both are dark until the light update arrives. They agreed at once, same_light returned, and the next line read the guest's light before the update came. The check now waits up to 100 ticks for the guest's border light, then compares the host's with it. With temporary logging on the server thread: the glowstone lands in a finished chunk that isn't lit (the ring past what the guest tracks), so the edit queues a full light job for its neighbours. The border chunk's job then relights sections 15 to 17, and Hub::broadcast_light_changes sends them to both clients as a tracked border chunk, as ChunkMap.isChunkOnTrackedBorder does. Nothing in the engine changes. Fixes #891 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- tools/lan_e2e.py | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index 4d13b1c22..5def799f6 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -1260,9 +1260,15 @@ def check_light(host, guest, out): host('command', command=f'setblock {near} {y} {gz} minecraft:glowstone') try: lo, hi = (untracked * 16 - 16, y - 3, gz - 8), (untracked * 16 - 1, y + 3, gz + 8) + # On the server thread the host's game is a client too, as dark as the guest until the light + # update arrives: wait for it before comparing them. + for _ in range(10): + lit = guest.raw('light', near - 2, y, gz, near - 2, y, gz)['block'] + if lit == 'd': + break + host.wait(10) + assert lit == 'd', f'the border chunk by the glowstone has block light {lit}, not 13, after 100 ticks' results['border'] = same_light(host, guest, lo, hi, 'border chunk') - lit = guest.raw('light', near - 2, y, gz, near - 2, y, gz)['block'] - assert lit == 'd', f'the border chunk by the glowstone has block light {lit}, not 13' finally: host('command', command=f'setblock {near} {y} {gz} minecraft:air') results['border_cleared'] = same_light(host, guest, lo, hi, 'border chunk without the glowstone') From 40972de77a4cb5db4864796728bd2e538ced7a29 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 19:26:26 +0200 Subject: [PATCH 140/163] Benchmark: Horizon's server against vanilla 26.3 with mixed bots, as installed The first published benchmark for the working version (docs/server.md section 10, item 4). It ran the v2026.10.18.15 release, as install.sh installs it, against vanilla 26.3 with 1, 10, 25 and 50 mixed bots. The servers ran on the ThinkPad (quiet, under nice 19) and the bots on the Mac mini over the tailnet. Vanilla's default game rules applied on both; Horizon's server runs the locator bar now. Both servers kept 20 TPS throughout. Horizon used 3.7 to 5.2 times less memory. Its average tick was shorter with 1, 10 and 25 bots and 18 % longer with 50, while it generated about twice the new terrain a second (the exploring bots fly as fast as each server sends chunks). Its P99 was lower at every count. benchmarks/server-mixed-2026-10-18/ holds the README, the report and the machine's load; docs/server.md links it from sections 9 and 10. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- benchmarks/server-mixed-2026-10-18/README.md | 125 ++++++ benchmarks/server-mixed-2026-10-18/load.txt | 286 ++++++++++++++ benchmarks/server-mixed-2026-10-18/mixed.json | 367 ++++++++++++++++++ docs/server.md | 12 +- 4 files changed, 789 insertions(+), 1 deletion(-) create mode 100644 benchmarks/server-mixed-2026-10-18/README.md create mode 100644 benchmarks/server-mixed-2026-10-18/load.txt create mode 100644 benchmarks/server-mixed-2026-10-18/mixed.json diff --git a/benchmarks/server-mixed-2026-10-18/README.md b/benchmarks/server-mixed-2026-10-18/README.md new file mode 100644 index 000000000..3cbe3897f --- /dev/null +++ b/benchmarks/server-mixed-2026-10-18/README.md @@ -0,0 +1,125 @@ +# Horizon's server against vanilla 26.3: mixed bots (2026-10-18) + +The first benchmark from docs/server.md section 10 (item 4): the same bots on Horizon's dedicated server, as +`install.sh` installs it today, and on vanilla 26.3's, one server at a time on the same quiet machine. +There were 1, 10, 25 and 50 bots, all with the `mixed` behaviour. + +## Summary + +- **Both servers held 20 TPS in every run.** +- **Memory:** Horizon's RSS was 3.7 to 5.2 times smaller: 0.65 GB against 3.4 GB with one player, and + 1.0 GB against 4.0 GB with 50. Vanilla runs with the usual fixed heap (`-Xms4g -Xmx4g`), so its RSS + is mostly that heap. +- **Tick time (MSPT):** + - with 1, 10 and 25 players, Horizon's average tick was shorter (2.4 against 17.9 ms, 12.4 against 34.5, + 24.0 against 31.6); + - with 50, it was longer (35.2 against 29.7 ms); + - Horizon's P99 was lower at every count, and so were its worst 5-second windows (241 ms at most, + against 424 to 2320 ms for vanilla). +- **The work was not equal, and the difference counts against Horizon.** In `mixed`, 20 % of the bots + fly straight out at 22 blocks a second, as fast as each server sends them chunks. Horizon kept up: + - with 10 or more players it sent 2.9 to 5.9 times as many chunks a second, and generated 1.9 to 2.9 + times as much new terrain a second; + - its walking bots each received 3300 to 4000 chunks, against 640 to 1100 on vanilla once 10 or more + were online. + + So at 50 players Horizon's tick is 18 % longer while it generates twice the new terrain. The + equal-rate explore pass of `../server-equal-work-2026-10-17/` is the fair comparison for exploring. +- **Start (fresh world, to `Done`):** 10 to 20 s for Horizon, 14.5 to 28.6 s for vanilla. + +## Results + +MSPT is milliseconds per tick from each server's own `/tick query` (50 is the limit for 20 TPS). P95 and +P99 are over the whole run. "Worst P99" is the highest P99 of a single 5-second query. RSS and CPU cover +the server's whole process tree (100 % is one thread; the machine has 4). "New chunks/s" counts chunks +no bot had before. "Pulled back" counts position packets that moved a bot back. + +| Bots | Server | MSPT | P95 | P99 | Worst P99 | TPS | RSS (mean / max) | CPU | Start | Chunks/s | New chunks/s | Pulled back | +|---:|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:| +| 1 | Horizon | **2.4** | 5.2 | 18.2 | 45.6 | 20 | **0.65 / 0.66 GB** | 25 % | 10.9 s | 9.9 | 0.3 | 0 | +| 1 | vanilla | 17.9 | 27.6 | 47.3 | 423.8 | 20 | 3.38 / 3.39 GB | 64 % | 14.8 s | 9.9 | 0.3 | 0 | +| 10 | Horizon | **12.4** | 36.0 | 65.9 | 117.1 | 20 | **0.94 / 1.01 GB** | 210 % | 10.2 s | 98.2 | 36.5 | 6267 | +| 10 | vanilla | 34.5 | 63.5 | 138.6 | 884.7 | 20 | 3.59 / 3.66 GB | 217 % | 14.5 s | 24.3 | 19.1 | 5500 | +| 25 | Horizon | **24.0** | 49.7 | 80.6 | 168.8 | 20 | **1.01 / 1.18 GB** | 192 % | 14.7 s | 178.2 | 31.9 | 5532 | +| 25 | vanilla | 31.6 | 70.0 | 222.7 | 2319.6 | 20 | 3.74 / 4.06 GB | 218 % | 28.6 s | 30.4 | 10.8 | 4524 | +| 50 | Horizon | 35.2 | 69.0 | 96.6 | 240.8 | 20 | **1.01 / 1.25 GB** | 218 % | 19.8 s | 273.2 | 34.6 | 8369 | +| 50 | vanilla | **29.7** | 62.3 | 137.4 | 489.3 | 20 | 4.00 / 4.60 GB | 294 % | 20.6 s | 94.4 | 17.8 | 12034 | + +Chunks each bot received, by behaviour (mean): + +| Bots | Server | walk | explore | idle | +|---:|---|---:|---:|---:| +| 10 | Horizon | 3992 | 7360 | 473 | +| 10 | vanilla | 680 | 2824 | 358 | +| 25 | Horizon | 3928 | 2475 | 473 | +| 25 | vanilla | 640 | 738 | 180 | +| 50 | Horizon | 3300 | 1192 | 460 | +| 50 | vanilla | 1105 | 629 | 220 | + +No bot failed to join or was dropped, and no chunk was sent twice (`resent` 0), on either server. Vanilla +also logged "moved too quickly" 12, 324 and 2193 times at 10, 25 and 50 bots. + +## Method + +`tools/server_bench.py`, unchanged, runs each configuration on a fresh server: + +- the same `server.properties` on both: seed 12345, view and simulation distance 10, offline, creative, + difficulty easy, `sync-chunk-writes=true`, white-list off; +- `gamerule respawn_radius 0`, and otherwise vanilla's default game rules on both. The locator bar is on + for both: Horizon's server has run it since v2026.10.18.13. The 2026-10-17 runs turned it off on vanilla + because Horizon had none then; +- the server waits for `Done`, then the bots join one a second, warm up for 60 seconds, and are measured + for 300 seconds, with `/tick query` every 5 seconds and RSS and CPU every second. + +The bots are `horizon-bots --behaviour mixed`: 60 % walk, 20 % explore and 20 % idle, each choice +deterministic per bot. All are creative and fly 24 blocks above their spawn: + +- `walk`: random points within 48 blocks at 5.6 blocks a second; +- `explore`: straight out at up to 22 blocks a second, as fast as chunks come; +- `idle`: hovers. + +A bot doesn't move while the chunk it stands in hasn't arrived, and it acknowledges chunk batches as +vanilla's client does. + +**Machine.** The ThinkPad: Intel Core i7-7500U (2 cores, 4 threads), 32 GB, NixOS (Linux 6.18). No other +session ran on it (`load.txt`: the fleet monitor shows 0 sessions throughout). The busy periods are the +servers themselves, which used 2 to 3 of its 4 threads from 10 bots up, so both servers were CPU-bound +there. The servers ran under `nice -n 19`. The desktop was meant to run this (24 threads) but didn't +wake. The bots ran on the Mac mini (M4 Pro) and reached the ThinkPad over the tailnet, so they took none +of the servers' CPU. The Mac mini was shared with other work (70 to 90 % busy), which only affects the +bots' timing. + +**What ran.** + +- Horizon: the published v2026.10.18.15 release, `horizon-client` (the engine) at 6c078b28, as + `install.sh` installs it. Its game files were prepared from the owner's own Minecraft by the release's + `horizon-prepare`. `horizon-server` (the supervisor, which takes no part in the tick) came from #898 + (4ea2243e), because the release's copy can't find game files prepared without sounds (#893). + `horizon-bots` came from main. +- Vanilla: the pinned 26.3 server jar (the owner's own copy) on OpenJDK 25.0.4.1, `-Xms4g -Xmx4g`. + +On Linux the release's engine needs `libasound.so.2` and `libudev.so.1`. The ThinkPad has them only in +the Nix store, so the run set `LD_LIBRARY_PATH` to them (see #898). + +## Reproduce + + curl -fsSL https://raw.githubusercontent.com/ludovic111/horizon/main/packaging/server/install.sh | sh + horizon-prepare --prepare --server-jar /path/to/server.jar # your own copy + cargo build --release -p horizon-bots # on the machine that runs the bots + # in a checkout whose .local/minecraft holds the pinned vanilla jars (tools/lab.py prepare): + HORIZON_BENCH_BIN=<a folder with horizon-server and horizon-client> \ + python3 tools/server_bench.py --servers horizon,vanilla --bots 1,10,25,50 --behaviour mixed --nice 19 \ + --bots-via 'ssh <bots machine>' --bots-bin /path/to/horizon-bots --connect <this machine's address> \ + --out mixed.json + +`mixed.json` is the report (`horizon-server-benchmark`: machine, versions, settings and every run), and +`load.txt` is the ThinkPad's load before and during the run. + +## Next + +- An equal-work `mixed` pass (`--explore-speed` at a rate both servers keep up with), then 100 bots. +- The same run on a bigger machine, so neither server is CPU-bound at 25 to 50 bots. +- Paper and Fabric + Lithium (docs/server.md section 9). +- At 50 players Horizon's tick is longer than vanilla's while it generates and sends far more. The + profile of the 2026-10-17 run (streaming and block entity ticks growing with players) is + perf-server's to take on. diff --git a/benchmarks/server-mixed-2026-10-18/load.txt b/benchmarks/server-mixed-2026-10-18/load.txt new file mode 100644 index 000000000..3468f9f86 --- /dev/null +++ b/benchmarks/server-mixed-2026-10-18/load.txt @@ -0,0 +1,286 @@ +ludothinkpad — OK + RAM 29.1 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 2% busy (agents 0.0, rest 0.1 cores) · 67°C · load 2.1 + · disk 295.5 GB free · battery 96% + +Sessions, most important first: + (finished session) 0.0 GB leftovers: node 0.0 GB + +Other machines (≤ 1 min old): desktop offline · macbook offline · macmini ok: 26.6 GB free, 14 threads 69% busy, 1 sessions + +# During the run, once a minute (uptime, then ~/fleet/load fleet) +18:25:30 + 18:25:30 up 8 days 3:08, 0 users, load average: 2.13, 1.53, 1.29 +ludothinkpad ok: 29.1 GB free, 4 threads 2% busy, 0 sessions +desktop offline +macmini busy: 27.6 GB free, 14 threads 87% busy, 1 sessions +18:26:34 + 18:26:34 up 8 days 3:09, 0 users, load average: 1.70, 1.56, 1.31 +ludothinkpad ok: 28.5 GB free, 4 threads 23% busy, 0 sessions +desktop offline +macmini busy: 26.4 GB free, 14 threads 85% busy, 1 sessions +18:27:38 + 18:27:38 up 8 days 3:10, 0 users, load average: 1.10, 1.43, 1.28 +ludothinkpad ok: 28.5 GB free, 4 threads 4% busy, 0 sessions +desktop offline +macmini ok: 27.7 GB free, 14 threads 80% busy, 1 sessions +18:28:42 + 18:28:42 up 8 days 3:11, 0 users, load average: 0.93, 1.29, 1.24 +ludothinkpad ok: 28.5 GB free, 4 threads 22% busy, 0 sessions +desktop offline +macmini ok: 26.0 GB free, 14 threads 82% busy, 1 sessions +18:29:46 + 18:29:46 up 8 days 3:12, 0 users, load average: 0.62, 1.12, 1.18 +ludothinkpad ok: 28.5 GB free, 4 threads 12% busy, 0 sessions +desktop offline +macmini ok: 25.7 GB free, 14 threads 81% busy, 1 sessions +18:30:50 + 18:30:51 up 8 days 3:13, 0 users, load average: 0.79, 1.05, 1.15 +ludothinkpad ok: 28.5 GB free, 4 threads 7% busy, 0 sessions +desktop offline +macmini busy: 27.0 GB free, 14 threads 88% busy, 1 sessions +18:31:55 + 18:31:55 up 8 days 3:14, 0 users, load average: 0.67, 0.96, 1.11 +ludothinkpad ok: 28.6 GB free, 4 threads 73% busy, 0 sessions +desktop offline +macmini ok: 27.3 GB free, 14 threads 79% busy, 1 sessions +18:32:59 + 18:32:59 up 8 days 3:15, 0 users, load average: 4.01, 1.91, 1.44 +ludothinkpad ok: 25.9 GB free, 4 threads 24% busy, 0 sessions +desktop offline +macmini ok: 26.4 GB free, 14 threads 85% busy, 1 sessions +18:34:03 + 18:34:03 up 8 days 3:16, 0 users, load average: 2.24, 1.84, 1.44 +ludothinkpad ok: 25.9 GB free, 4 threads 21% busy, 0 sessions +desktop offline +macmini busy: 29.2 GB free, 14 threads 86% busy, 1 sessions +18:35:07 + 18:35:07 up 8 days 3:17, 0 users, load average: 1.28, 1.63, 1.40 +ludothinkpad ok: 25.8 GB free, 4 threads 21% busy, 0 sessions +desktop offline +macmini busy: 31.0 GB free, 14 threads 86% busy, 1 sessions +18:36:11 + 18:36:11 up 8 days 3:18, 0 users, load average: 0.79, 1.41, 1.33 +ludothinkpad ok: 25.9 GB free, 4 threads 18% busy, 0 sessions +desktop offline +macmini busy: 26.3 GB free, 14 threads 93% busy, 1 sessions +18:37:15 + 18:37:15 up 8 days 3:20, 0 users, load average: 1.44, 1.47, 1.36 +ludothinkpad ok: 25.9 GB free, 4 threads 23% busy, 0 sessions +desktop offline +macmini busy: 26.8 GB free, 14 threads 86% busy, 1 sessions +18:38:19 + 18:38:19 up 8 days 3:21, 0 users, load average: 1.37, 1.45, 1.36 +ludothinkpad ok: 25.9 GB free, 4 threads 13% busy, 0 sessions +desktop offline +macmini busy: 26.7 GB free, 14 threads 86% busy, 1 sessions +18:39:24 + 18:39:24 up 8 days 3:22, 0 users, load average: 2.27, 1.66, 1.44 +ludothinkpad ok: 28.3 GB free, 4 threads 62% busy, 0 sessions +desktop offline +macmini ok: 27.1 GB free, 14 threads 70% busy, 1 sessions +18:40:28 + 18:40:28 up 8 days 3:23, 0 users, load average: 1.95, 1.72, 1.48 +ludothinkpad ok: 28.3 GB free, 4 threads 63% busy, 0 sessions +desktop offline +macmini ok: 26.7 GB free, 14 threads 84% busy, 1 sessions +18:41:32 + 18:41:32 up 8 days 3:24, 0 users, load average: 3.32, 2.22, 1.67 +ludothinkpad ok: 28.2 GB free, 4 threads 61% busy, 0 sessions +desktop offline +macmini busy: 26.8 GB free, 14 threads 85% busy, 1 sessions +18:42:36 + 18:42:36 up 8 days 3:25, 0 users, load average: 3.13, 2.33, 1.75 +ludothinkpad ok: 28.2 GB free, 4 threads 60% busy, 0 sessions +desktop offline +macmini busy: 27.1 GB free, 14 threads 91% busy, 1 sessions +18:43:40 + 18:43:40 up 8 days 3:26, 0 users, load average: 3.27, 2.48, 1.83 +ludothinkpad busy: 28.1 GB free, 4 threads 90% busy, 0 sessions +desktop offline +macmini busy: 28.3 GB free, 14 threads 92% busy, 1 sessions +18:44:44 + 18:44:44 up 8 days 3:27, 0 users, load average: 2.14, 2.32, 1.82 +ludothinkpad ok: 28.1 GB free, 4 threads 55% busy, 0 sessions +desktop offline +macmini busy: 30.4 GB free, 14 threads 88% busy, 1 sessions +18:45:48 + 18:45:48 up 8 days 3:28, 0 users, load average: 4.94, 3.06, 2.11 +ludothinkpad busy: 25.9 GB free, 4 threads 86% busy, 0 sessions +desktop offline +macmini ok: 28.7 GB free, 14 threads 84% busy, 1 sessions +18:46:53 + 18:46:53 up 8 days 3:29, 0 users, load average: 6.55, 3.92, 2.47 +ludothinkpad busy: 25.4 GB free, 4 threads 99% busy, 0 sessions +desktop offline +macmini ok: 29.3 GB free, 14 threads 81% busy, 1 sessions +18:47:57 + 18:47:57 up 8 days 3:30, 0 users, load average: 8.50, 4.96, 2.93 +ludothinkpad busy: 24.0 GB free, 4 threads 100% busy, 0 sessions +desktop offline +macmini busy: 27.9 GB free, 14 threads 90% busy, 1 sessions +18:49:01 + 18:49:01 up 8 days 3:31, 0 users, load average: 8.59, 5.68, 3.31 +ludothinkpad busy: 22.7 GB free, 4 threads 99% busy, 0 sessions +desktop offline +macmini ok: 28.2 GB free, 14 threads 85% busy, 1 sessions +18:50:05 + 18:50:05 up 8 days 3:32, 0 users, load average: 7.81, 6.07, 3.61 +ludothinkpad busy: 24.5 GB free, 4 threads 90% busy, 0 sessions +desktop offline +macmini busy: 28.6 GB free, 14 threads 96% busy, 1 sessions +18:51:09 + 18:51:09 up 8 days 3:33, 0 users, load average: 8.29, 6.50, 3.93 +ludothinkpad busy: 24.3 GB free, 4 threads 92% busy, 0 sessions +desktop offline +macmini busy: 28.0 GB free, 14 threads 94% busy, 1 sessions +18:52:14 + 18:52:14 up 8 days 3:35, 0 users, load average: 5.58, 6.06, 3.95 +ludothinkpad busy: 26.0 GB free, 4 threads 100% busy, 0 sessions +desktop offline +macmini busy: 26.3 GB free, 14 threads 87% busy, 1 sessions +18:53:18 + 18:53:18 up 8 days 3:36, 0 users, load average: 4.53, 5.69, 3.97 +ludothinkpad busy: 27.2 GB free, 4 threads 89% busy, 0 sessions +desktop offline +macmini busy: 26.8 GB free, 14 threads 87% busy, 1 sessions +18:54:22 + 18:54:22 up 8 days 3:37, 0 users, load average: 5.31, 5.64, 4.07 +ludothinkpad busy: 26.3 GB free, 4 threads 100% busy, 0 sessions +desktop offline +macmini busy: 29.3 GB free, 14 threads 91% busy, 1 sessions +18:55:26 + 18:55:26 up 8 days 3:38, 0 users, load average: 10.47, 6.99, 4.63 +ludothinkpad busy: 26.1 GB free, 4 threads 100% busy, 0 sessions +desktop offline +macmini busy: 26.7 GB free, 14 threads 90% busy, 1 sessions +18:56:30 + 18:56:30 up 8 days 3:39, 0 users, load average: 9.27, 7.45, 4.96 +ludothinkpad busy: 26.2 GB free, 4 threads 100% busy, 0 sessions +desktop offline +macmini busy: 28.5 GB free, 14 threads 92% busy, 1 sessions +18:57:35 + 18:57:35 up 8 days 3:40, 0 users, load average: 7.79, 7.39, 5.10 +ludothinkpad busy: 26.1 GB free, 4 threads 100% busy, 0 sessions +desktop offline +macmini ok: 27.1 GB free, 14 threads 80% busy, 1 sessions +18:58:39 + 18:58:39 up 8 days 3:41, 0 users, load average: 8.06, 7.55, 5.32 +ludothinkpad busy: 26.4 GB free, 4 threads 100% busy, 0 sessions +desktop offline +macmini busy: 31.8 GB free, 14 threads 95% busy, 1 sessions +18:59:43 + 18:59:43 up 8 days 3:42, 0 users, load average: 8.44, 7.65, 5.50 +ludothinkpad busy: 26.2 GB free, 4 threads 100% busy, 0 sessions +desktop offline +macmini busy: 31.4 GB free, 14 threads 94% busy, 1 sessions +19:00:47 + 19:00:47 up 8 days 3:43, 0 users, load average: 11.04, 8.66, 6.00 +ludothinkpad busy: 24.9 GB free, 4 threads 100% busy, 0 sessions +desktop offline +macmini busy: 31.8 GB free, 14 threads 88% busy, 1 sessions +19:01:51 + 19:01:51 up 8 days 3:44, 0 users, load average: 11.91, 9.37, 6.41 +ludothinkpad busy: 24.4 GB free, 4 threads 100% busy, 0 sessions +desktop offline +macmini ok: 32.9 GB free, 14 threads 77% busy, 1 sessions +19:02:56 + 19:02:56 up 8 days 3:45, 0 users, load average: 11.64, 9.85, 6.79 +ludothinkpad ok: 25.5 GB free, 4 threads 70% busy, 0 sessions +desktop offline +macmini busy: 30.9 GB free, 14 threads 91% busy, 1 sessions +19:04:00 + 19:04:00 up 8 days 3:46, 0 users, load average: 11.42, 10.06, 7.06 +ludothinkpad busy: 23.4 GB free, 4 threads 99% busy, 0 sessions +desktop offline +macmini busy: 28.4 GB free, 14 threads 94% busy, 1 sessions +19:05:04 + 19:05:04 up 8 days 3:47, 0 users, load average: 9.83, 9.96, 7.24 +ludothinkpad busy: 23.2 GB free, 4 threads 100% busy, 0 sessions +desktop offline +macmini ok: 31.4 GB free, 14 threads 80% busy, 1 sessions +19:06:09 + 19:06:09 up 8 days 3:48, 0 users, load average: 8.38, 9.68, 7.34 +ludothinkpad ok: 22.7 GB free, 4 threads 17% busy, 0 sessions +desktop offline +macmini busy: 29.8 GB free, 14 threads 86% busy, 1 sessions +19:07:13 + 19:07:13 up 8 days 3:49, 0 users, load average: 4.51, 8.27, 7.00 +ludothinkpad ok: 25.7 GB free, 4 threads 75% busy, 0 sessions +desktop offline +macmini busy: 26.5 GB free, 14 threads 89% busy, 1 sessions +19:08:17 + 19:08:17 up 8 days 3:51, 0 users, load average: 6.77, 8.13, 7.04 +ludothinkpad busy: 25.8 GB free, 4 threads 95% busy, 0 sessions +desktop offline +macmini busy: 30.8 GB free, 14 threads 91% busy, 1 sessions +19:09:22 + 19:09:22 up 8 days 3:52, 0 users, load average: 8.27, 8.25, 7.14 +ludothinkpad busy: 25.2 GB free, 4 threads 100% busy, 0 sessions +desktop offline +macmini busy: 28.3 GB free, 14 threads 91% busy, 1 sessions +19:10:26 + 19:10:26 up 8 days 3:53, 0 users, load average: 8.88, 8.57, 7.34 +ludothinkpad busy: 24.8 GB free, 4 threads 99% busy, 0 sessions +desktop offline +macmini ok: 32.4 GB free, 14 threads 72% busy, 1 sessions +19:11:30 + 19:11:30 up 8 days 3:54, 0 users, load average: 13.33, 10.05, 7.94 +ludothinkpad busy: 24.7 GB free, 4 threads 97% busy, 0 sessions +desktop offline +macmini busy: 30.1 GB free, 14 threads 87% busy, 1 sessions +19:12:35 + 19:12:35 up 8 days 3:55, 0 users, load average: 10.92, 10.13, 8.12 +ludothinkpad ok: 26.4 GB free, 4 threads 76% busy, 0 sessions +desktop offline +macmini busy: 29.3 GB free, 14 threads 86% busy, 1 sessions +19:13:39 + 19:13:39 up 8 days 3:56, 0 users, load average: 9.98, 9.89, 8.16 +ludothinkpad busy: 25.8 GB free, 4 threads 90% busy, 0 sessions +desktop offline +macmini busy: 28.8 GB free, 14 threads 93% busy, 1 sessions +19:14:43 + 19:14:43 up 8 days 3:57, 0 users, load average: 8.95, 9.63, 8.19 +ludothinkpad busy: 25.1 GB free, 4 threads 100% busy, 0 sessions +desktop offline +macmini ok: 29.6 GB free, 14 threads 71% busy, 1 sessions +19:15:47 + 19:15:47 up 8 days 3:58, 0 users, load average: 12.02, 10.38, 8.55 +ludothinkpad busy: 24.5 GB free, 4 threads 100% busy, 0 sessions +desktop offline +macmini busy: 28.1 GB free, 14 threads 93% busy, 1 sessions +19:16:52 + 19:16:52 up 8 days 3:59, 0 users, load average: 13.82, 11.21, 8.95 +ludothinkpad busy: 23.9 GB free, 4 threads 100% busy, 0 sessions +desktop offline +macmini ok: 28.4 GB free, 14 threads 75% busy, 1 sessions +19:17:56 + 19:17:56 up 8 days 4:00, 0 users, load average: 11.95, 11.20, 9.10 +ludothinkpad busy: 25.0 GB free, 4 threads 99% busy, 0 sessions +desktop offline +macmini ok: 28.4 GB free, 14 threads 81% busy, 1 sessions +19:19:00 + 19:19:00 up 8 days 4:01, 0 users, load average: 11.46, 11.14, 9.22 +ludothinkpad busy: 24.6 GB free, 4 threads 95% busy, 0 sessions +desktop offline +macmini ok: 26.4 GB free, 14 threads 83% busy, 1 sessions +19:20:04 + 19:20:04 up 8 days 4:02, 0 users, load average: 11.11, 10.97, 9.28 +ludothinkpad busy: 24.6 GB free, 4 threads 93% busy, 0 sessions +desktop offline +macmini ok: 26.7 GB free, 14 threads 85% busy, 1 sessions +19:21:08 + 19:21:08 up 8 days 4:03, 0 users, load average: 9.81, 10.60, 9.27 +ludothinkpad busy: 24.4 GB free, 4 threads 91% busy, 0 sessions +desktop offline +macmini ok: 27.8 GB free, 14 threads 75% busy, 1 sessions +19:22:13 + 19:22:13 up 8 days 4:04, 0 users, load average: 5.98, 9.51, 9.00 +ludothinkpad ok: 23.8 GB free, 4 threads 18% busy, 0 sessions +desktop offline +macmini busy: 29.7 GB free, 14 threads 85% busy, 1 sessions +19:23:17 + 19:23:17 up 8 days 4:06, 0 users, load average: 4.01, 8.27, 8.60 +ludothinkpad ok: 23.1 GB free, 4 threads 56% busy, 0 sessions +desktop offline +macmini ok: 28.2 GB free, 14 threads 79% busy, 1 sessions diff --git a/benchmarks/server-mixed-2026-10-18/mixed.json b/benchmarks/server-mixed-2026-10-18/mixed.json new file mode 100644 index 000000000..36b21c327 --- /dev/null +++ b/benchmarks/server-mixed-2026-10-18/mixed.json @@ -0,0 +1,367 @@ +{ + "kind": "horizon-server-benchmark", + "date": "2026-10-18T17:23:30+00:00", + "machine": { + "system": "Linux", + "machine": "x86_64", + "cpus": 4, + "note": "ThinkPad: Intel Core i7-7500U (2 cores, 4 threads), 32 GB, NixOS, Linux 6.18; the bots on the Mac mini (M4 Pro) over the tailnet" + }, + "commit": "4ea2243e4d1a44f910857bd759845db70e3690a8", + "java": [ + "openjdk 25.0.4.1 2026-08-18" + ], + "settings": { + "servers": "horizon,vanilla", + "bots": "1,10,25,50", + "behaviour": "mixed", + "join_every": 1.0, + "warmup": 60, + "seconds": 300, + "seed": 12345, + "explore_speed": 0, + "gamerule": "", + "heap": "4g", + "out": "mixed.json", + "nice": 19, + "bots_via": "ssh macmini", + "bots_bin": "horizon-bots (on the Mac mini)", + "connect": "<the ThinkPad's tailnet address>", + "properties": { + "level-seed": "12345", + "view-distance": "10", + "simulation-distance": "10", + "online-mode": "false", + "white-list": "false", + "gamemode": "creative", + "force-gamemode": "true", + "spawn-protection": "0", + "max-players": "200", + "difficulty": "easy", + "sync-chunk-writes": "true" + } + }, + "runs": [ + { + "server": "horizon", + "bots": 1, + "behaviour": "mixed", + "start_seconds": 10.92, + "mspt": { + "average": 2.38, + "p50": 1.97, + "p95": 5.17, + "p99": 18.2 + }, + "mspt_worst_p99": 45.6, + "tps": 20.0, + "rss_mb": { + "mean": 653.7, + "max": 659.2 + }, + "cpu_percent": 24.51, + "chunks_per_second": 9.9, + "unique_per_second": 0.3, + "forgotten_per_second": 9.93, + "waited_ticks_per_second": 0.0, + "chunks_total": 3951, + "chunks_per_bot": { + "walk": 3951.0 + }, + "unique_chunks_per_bot": { + "walk": 699.0 + }, + "resent": 0, + "pulled_back": 0, + "moved_too_quickly": 0, + "moved_wrongly": 0, + "bots_joined": 1, + "bots_failed": [], + "tick_queries": 58 + }, + { + "server": "vanilla", + "bots": 1, + "behaviour": "mixed", + "start_seconds": 14.75, + "mspt": { + "average": 17.9, + "p50": 18.39, + "p95": 27.58, + "p99": 47.28 + }, + "mspt_worst_p99": 423.8, + "tps": 20.0, + "rss_mb": { + "mean": 3382.06, + "max": 3394.1 + }, + "cpu_percent": 64.02, + "chunks_per_second": 9.92, + "unique_per_second": 0.29, + "forgotten_per_second": 9.95, + "waited_ticks_per_second": 0.0, + "chunks_total": 3846, + "chunks_per_bot": { + "walk": 3846.0 + }, + "unique_chunks_per_bot": { + "walk": 699.0 + }, + "resent": 0, + "pulled_back": 0, + "moved_too_quickly": 0, + "moved_wrongly": 0, + "bots_joined": 1, + "bots_failed": [], + "tick_queries": 58 + }, + { + "server": "horizon", + "bots": 10, + "behaviour": "mixed", + "start_seconds": 10.22, + "mspt": { + "average": 12.39, + "p50": 8.33, + "p95": 35.99, + "p99": 65.9 + }, + "mspt_worst_p99": 117.1, + "tps": 20.0, + "rss_mb": { + "mean": 935.85, + "max": 1008.6 + }, + "cpu_percent": 210.37, + "chunks_per_second": 98.22, + "unique_per_second": 36.49, + "forgotten_per_second": 98.25, + "waited_ticks_per_second": 0.0, + "chunks_total": 39618, + "chunks_per_bot": { + "walk": 3992.17, + "explore": 7359.5, + "idle": 473.0 + }, + "unique_chunks_per_bot": { + "walk": 696.83, + "explore": 6869.0, + "idle": 473.0 + }, + "resent": 0, + "pulled_back": 6267, + "moved_too_quickly": 0, + "moved_wrongly": 0, + "bots_joined": 10, + "bots_failed": [], + "tick_queries": 58 + }, + { + "server": "vanilla", + "bots": 10, + "behaviour": "mixed", + "start_seconds": 14.54, + "mspt": { + "average": 34.47, + "p50": 29.67, + "p95": 63.52, + "p99": 138.58 + }, + "mspt_worst_p99": 884.7, + "tps": 20.0, + "rss_mb": { + "mean": 3594.26, + "max": 3661.7 + }, + "cpu_percent": 217.13, + "chunks_per_second": 24.34, + "unique_per_second": 19.13, + "forgotten_per_second": 20.12, + "waited_ticks_per_second": 0.62, + "chunks_total": 10443, + "chunks_per_bot": { + "walk": 679.83, + "explore": 2824.0, + "idle": 358.0 + }, + "unique_chunks_per_bot": { + "walk": 389.17, + "explore": 2824.0, + "idle": 358.0 + }, + "resent": 0, + "pulled_back": 5500, + "moved_too_quickly": 12, + "moved_wrongly": 0, + "bots_joined": 10, + "bots_failed": [], + "tick_queries": 58 + }, + { + "server": "horizon", + "bots": 25, + "behaviour": "mixed", + "start_seconds": 14.73, + "mspt": { + "average": 24.0, + "p50": 21.07, + "p95": 49.72, + "p99": 80.57 + }, + "mspt_worst_p99": 168.8, + "tps": 20.0, + "rss_mb": { + "mean": 1013.07, + "max": 1179.4 + }, + "cpu_percent": 192.47, + "chunks_per_second": 178.23, + "unique_per_second": 31.85, + "forgotten_per_second": 177.93, + "waited_ticks_per_second": 60.59, + "chunks_total": 73657, + "chunks_per_bot": { + "walk": 3927.87, + "explore": 2474.8, + "idle": 473.0 + }, + "unique_chunks_per_bot": { + "walk": 691.73, + "explore": 2447.8, + "idle": 473.0 + }, + "resent": 0, + "pulled_back": 5532, + "moved_too_quickly": 0, + "moved_wrongly": 0, + "bots_joined": 25, + "bots_failed": [], + "tick_queries": 58 + }, + { + "server": "vanilla", + "bots": 25, + "behaviour": "mixed", + "start_seconds": 28.57, + "mspt": { + "average": 31.59, + "p50": 25.18, + "p95": 70.03, + "p99": 222.74 + }, + "mspt_worst_p99": 2319.6, + "tps": 20.0, + "rss_mb": { + "mean": 3742.51, + "max": 4055.0 + }, + "cpu_percent": 218.34, + "chunks_per_second": 30.37, + "unique_per_second": 10.84, + "forgotten_per_second": 29.44, + "waited_ticks_per_second": 50.91, + "chunks_total": 14193, + "chunks_per_bot": { + "walk": 640.2, + "explore": 738.0, + "idle": 180.0 + }, + "unique_chunks_per_bot": { + "walk": 211.33, + "explore": 737.6, + "idle": 180.0 + }, + "resent": 0, + "pulled_back": 4524, + "moved_too_quickly": 324, + "moved_wrongly": 0, + "bots_joined": 25, + "bots_failed": [], + "tick_queries": 56 + }, + { + "server": "horizon", + "bots": 50, + "behaviour": "mixed", + "start_seconds": 19.84, + "mspt": { + "average": 35.2, + "p50": 32.12, + "p95": 69.04, + "p99": 96.56 + }, + "mspt_worst_p99": 240.8, + "tps": 20.0, + "rss_mb": { + "mean": 1013.2, + "max": 1249.1 + }, + "cpu_percent": 217.68, + "chunks_per_second": 273.18, + "unique_per_second": 34.58, + "forgotten_per_second": 268.19, + "waited_ticks_per_second": 138.29, + "chunks_total": 115527, + "chunks_per_bot": { + "walk": 3300.1, + "explore": 1192.4, + "idle": 460.0 + }, + "unique_chunks_per_bot": { + "walk": 632.67, + "explore": 1186.9, + "idle": 460.0 + }, + "resent": 0, + "pulled_back": 8369, + "moved_too_quickly": 0, + "moved_wrongly": 0, + "bots_joined": 50, + "bots_failed": [], + "tick_queries": 57 + }, + { + "server": "vanilla", + "bots": 50, + "behaviour": "mixed", + "start_seconds": 20.58, + "mspt": { + "average": 29.74, + "p50": 23.6, + "p95": 62.25, + "p99": 137.41 + }, + "mspt_worst_p99": 489.3, + "tps": 20.0, + "rss_mb": { + "mean": 3995.71, + "max": 4597.8 + }, + "cpu_percent": 294.31, + "chunks_per_second": 94.36, + "unique_per_second": 17.76, + "forgotten_per_second": 94.69, + "waited_ticks_per_second": 101.48, + "chunks_total": 41637, + "chunks_per_bot": { + "walk": 1104.97, + "explore": 628.8, + "idle": 220.0 + }, + "unique_chunks_per_bot": { + "walk": 279.4, + "explore": 626.4, + "idle": 220.0 + }, + "resent": 0, + "pulled_back": 12034, + "moved_too_quickly": 2193, + "moved_wrongly": 0, + "bots_joined": 50, + "bots_failed": [], + "tick_queries": 57 + } + ], + "horizon_build": "v2026.10.18.15 release binaries (horizon-client, the engine, at 6c078b28); horizon-server from #898 (4ea2243e, the supervisor only)" +} \ No newline at end of file diff --git a/docs/server.md b/docs/server.md index 941a4341b..4421aca7b 100644 --- a/docs/server.md +++ b/docs/server.md @@ -480,6 +480,16 @@ reproducible by anyone, and show the same gameplay on both sides. and every packet woke its connection's writer thread (#649). Together they took the 50-bot walking tick from 281 ms to 31 ms. At 25 walking bots most of what remains is the engine's streaming and block entity ticks, both of which grow with players (the README has the profile). +- **Mixed bots, as installed (2026-10-18,** `benchmarks/server-mixed-2026-10-18/`, the first published + run for the working version). It used the v2026.10.18.15 release as `install.sh` installs it, against + vanilla 26.3, with 1, 10, 25 and 50 `mixed` bots and vanilla's default game rules on both (Horizon has + the locator bar now). The servers ran on the ThinkPad and the bots on the Mac mini. Results: + - Both kept 20 TPS in every run. + - Horizon's RSS was 3.7 to 5.2 times smaller (1.0 GB against 4.0 GB at 50). + - Horizon's average tick was shorter with 1, 10 and 25 bots (2.4 against 17.9 ms, 12.4 against 34.5, + 24.0 against 31.6) and longer with 50 (35.2 against 29.7). Its P99 was lower at every count. + - Horizon also did more work: it kept up with the exploring bots, so it generated 1.9 to 2.9 times + the new terrain a second. - **Ownership.** perf-server-1 owns making the tick faster. This work only measures it, files what it finds, and fixes startup, RAM and packaging. @@ -498,7 +508,7 @@ vanilla. archive in the release. 3. The web panel MVP: status, live TPS/MSPT/RAM/CPU, players, console, backups and login links. 4. `horizon-bots` and `tools/server_bench.py`, with a first run against vanilla (1/10/25/50 bots, `mixed`) - published in `benchmarks/`. + published in `benchmarks/`: done, `benchmarks/server-mixed-2026-10-18/` (section 9). 5. Small engine fixes found on the way: logging refused logins (vanilla's lines). **Where it stands (2026-10-16):** items 1 to 4 are built and in review (section 11). What's left for the 23rd: From bdc758c5e5ed6cb1d704f4f4c996f39349762aae Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 18:30:25 +0200 Subject: [PATCH 141/163] Server log: vanilla's thread in latest.log, and local time on the console A dedicated server printed refused logins on its console as vanilla does ("[Server thread/INFO]: Disconnecting <name> ..."), but wrote them to logs/latest.log under the connection thread's own name ("[horizon-lan-conn/INFO]"): the file logger used the OS thread's name, not the one vanilla logs the line from. The engine's lines now go to the file under the same thread as on the console. The console's times were UTC while logs/latest.log and vanilla's console (Log4j's %d{HH:mm:ss}) use local time, so the two disagreed by the time zone, as did the supervisor's own lines in logs/supervisor.log and the web panel's console. Both now print local time. Backup names keep their UTC time, as documented. Found by the end-to-end install check on the Mac mini and the ThinkPad. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- Cargo.lock | 1 + crates/horizon-client/src/game/dedicated.rs | 14 +++++--------- crates/horizon-client/src/logging.rs | 8 ++++++++ crates/horizon-server/Cargo.toml | 2 ++ crates/horizon-server/src/supervisor.rs | 12 ++++-------- 5 files changed, 20 insertions(+), 17 deletions(-) diff --git a/Cargo.lock b/Cargo.lock index aa41f656f..94e2052e3 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -1556,6 +1556,7 @@ dependencies = [ name = "horizon-server" version = "0.1.0" dependencies = [ + "chrono", "horizon-bench", "horizon-server-files", "libc", diff --git a/crates/horizon-client/src/game/dedicated.rs b/crates/horizon-client/src/game/dedicated.rs index f9c3464dd..905073b31 100644 --- a/crates/horizon-client/src/game/dedicated.rs +++ b/crates/horizon-client/src/game/dedicated.rs @@ -11,9 +11,7 @@ use horizon_client::{ Result, lan::{LoginGate, NetConfig, NetLog, OnlineMode, hub::HubConfig}, server::{ - eula, - java_properties::now_millis, - profiles, + eula, profiles, properties::{GAME_MODES, ServerProperties, SystemEntropy}, user_cache::UserCache, user_lists::{ @@ -84,18 +82,16 @@ fn log_from(thread: &str, level: &str, message: &str) { "ERROR" => ::log::Level::Error, _ => ::log::Level::Info, }; - horizon_client::logging::write_only(file_level, message); + horizon_client::logging::write_as(thread, file_level, message); CAPTURE.with_borrow_mut(|lines| { if let Some(lines) = lines { lines.push(message.to_owned()); } }); - let secs = now_millis().div_euclid(1000).rem_euclid(86_400); + // Log4j's %d{HH:mm:ss}: the local time, as in logs/latest.log. println!( - "[{:02}:{:02}:{:02}] [{thread}/{level}]: {message}", - secs / 3600, - secs / 60 % 60, - secs % 60 + "[{}] [{thread}/{level}]: {message}", + chrono::Local::now().format("%H:%M:%S") ); } diff --git a/crates/horizon-client/src/logging.rs b/crates/horizon-client/src/logging.rs index c434c8efb..cb7638f26 100644 --- a/crates/horizon-client/src/logging.rs +++ b/crates/horizon-client/src/logging.rs @@ -330,6 +330,14 @@ pub fn write_only(level: log::Level, message: &str) { } } +/// Writes `message` to the log file only, under the thread vanilla names for it (`Server thread` for +/// a login refused on a connection's own thread), as the console line beside it shows. +pub fn write_as(thread: &str, level: log::Level, message: &str) { + if let Some(logger) = LOGGER.get() { + logger.write(thread, level, message); + } +} + /// The last lines written, oldest first (for crash reports). pub fn recent_lines() -> Vec<String> { LOGGER.get().map_or_else(Vec::new, |l| { diff --git a/crates/horizon-server/Cargo.toml b/crates/horizon-server/Cargo.toml index c3800b80c..2432cd481 100644 --- a/crates/horizon-server/Cargo.toml +++ b/crates/horizon-server/Cargo.toml @@ -10,6 +10,8 @@ description = "Host a Horizon server: server.toml, the CLI and the supervisor th horizon-server-files = { path = "../horizon-server-files" } # The game process's RAM and CPU (the same probes the benchmark reports use). horizon-bench = { path = "../horizon-bench" } +# The log's local times, as the game prints them. +chrono = { version = "0.4.42", default-features = false, features = ["clock", "std"] } serde = { version = "1", features = ["derive"] } serde_json = "1" toml = "1.1" diff --git a/crates/horizon-server/src/supervisor.rs b/crates/horizon-server/src/supervisor.rs index ad056a77c..0e1cf8a7c 100644 --- a/crates/horizon-server/src/supervisor.rs +++ b/crates/horizon-server/src/supervisor.rs @@ -8,7 +8,6 @@ use crate::{ config::Config, engine, signals, }; -use horizon_server_files::java_properties::now_millis; use serde_json::json; use std::{ fs::File, @@ -29,15 +28,12 @@ const MAX_BACKOFF: Duration = Duration::from_secs(300); /// How long `stop` may take before the game is killed. const STOP_TIMEOUT: Duration = Duration::from_secs(120); -/// A line from the supervisor, in the game's log format (`[HH:mm:ss] [thread/LEVEL]: message`, UTC), on -/// stdout and in the log the API serves. +/// A line from the supervisor, in the game's log format (`[HH:mm:ss] [thread/LEVEL]: message`, local time +/// as the game's own lines), on stdout and in the log the API serves. fn note(shared: &Shared, level: &str, message: &str) { - let secs = now_millis().div_euclid(1000).rem_euclid(86_400); let line = format!( - "[{:02}:{:02}:{:02}] [Supervisor/{level}]: {message}", - secs / 3600, - secs / 60 % 60, - secs % 60 + "[{}] [Supervisor/{level}]: {message}", + chrono::Local::now().format("%H:%M:%S") ); println!("{line}"); shared.log.lock().unwrap().push(line); From 02a6ab7429cbb4de63c8f0e7abc3708aac9e2c95 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 19:29:23 +0200 Subject: [PATCH 142/163] Guest ticks: count the per-tick statistics without making strings, and date a criterion only when one is granted Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../horizon-client/src/game/advancements.rs | 3 + crates/horizon-client/src/game/stats.rs | 113 +++++++++++++++--- 2 files changed, 99 insertions(+), 17 deletions(-) diff --git a/crates/horizon-client/src/game/advancements.rs b/crates/horizon-client/src/game/advancements.rs index d80a1f8f4..d13ed6b13 100644 --- a/crates/horizon-client/src/game/advancements.rs +++ b/crates/horizon-client/src/game/advancements.rs @@ -408,6 +408,9 @@ impl Game<'_> { } } } + if hits.is_empty() { + return; + } let date = now_text(); for (ai, ci) in hits { let a = &tree.list[ai]; diff --git a/crates/horizon-client/src/game/stats.rs b/crates/horizon-client/src/game/stats.rs index 8f642d97a..7a97416ca 100644 --- a/crates/horizon-client/src/game/stats.rs +++ b/crates/horizon-client/src/game/stats.rs @@ -20,22 +20,50 @@ pub(super) struct Stats { /// Statistic changes (type, key, amount; `None` = reset) for the /// scoreboard criteria to follow. pub(super) events: Vec<(String, String, Option<i32>)>, - /// Changed since the client was last sent them (`StatsCounter`'s dirty set). - pub(super) dirty: BTreeSet<(String, String)>, + /// Changed since the client was last sent them (`StatsCounter`'s dirty + /// set), by type. + dirty: BTreeMap<String, BTreeSet<String>>, } + +/// `minecraft:` and `name`, given to `f` from the stack when short: some +/// counters go up every tick for every player, and they are found without +/// a string made for each. +fn namespaced<T>(name: &str, f: impl FnOnce(&str) -> T) -> T { + const NAMESPACE: &str = "minecraft:"; + let mut buf = [0u8; 96]; + let len = NAMESPACE.len() + name.len(); + if len > buf.len() { + return f(&format!("{NAMESPACE}{name}")); + } + buf[..NAMESPACE.len()].copy_from_slice(NAMESPACE.as_bytes()); + buf[NAMESPACE.len()..len].copy_from_slice(name.as_bytes()); + // Two strings one after the other are one. + f(std::str::from_utf8(&buf[..len]).unwrap_or_default()) +} + +/// The map under `key`, made when missing, found without an owned key +/// when there. +fn entry<'a, V: Default>(map: &'a mut BTreeMap<String, V>, key: &str) -> &'a mut V { + if !map.contains_key(key) { + map.insert(key.to_owned(), V::default()); + } + map.get_mut(key).expect("just inserted") +} + impl Stats { pub(super) fn add(&mut self, ty: &str, key: &str, n: i32) { - let v = self - .values - .entry(format!("minecraft:{ty}")) - .or_default() - .entry(key.to_owned()) - .or_insert(0); - *v = v.saturating_add(n); - self.events - .push((format!("minecraft:{ty}"), key.to_owned(), Some(n))); - self.dirty - .insert((format!("minecraft:{ty}"), key.to_owned())); + namespaced(ty, |ty| { + let v = entry(entry(&mut self.values, ty), key); + *v = v.saturating_add(n); + self.events.push((ty.to_owned(), key.to_owned(), Some(n))); + self.mark_dirty(ty, key); + }); + } + fn mark_dirty(&mut self, ty: &str, key: &str) { + let keys = entry(&mut self.dirty, ty); + if !keys.contains(key) { + keys.insert(key.to_owned()); + } } pub(super) fn get(&self, ty: &str, key: &str) -> i32 { self.values @@ -48,20 +76,19 @@ impl Stats { if let Some(m) = self.values.get_mut(&format!("minecraft:{ty}")) { m.insert(key.to_owned(), 0); } - self.dirty - .insert((format!("minecraft:{ty}"), key.to_owned())); + self.mark_dirty(&format!("minecraft:{ty}"), key); self.events .push((format!("minecraft:{ty}"), key.to_owned(), None)); } pub(super) fn custom(&mut self, key: &str, n: i32) { - self.add("custom", &format!("minecraft:{key}"), n); + namespaced(key, |key| self.add("custom", key, n)); } /// `ServerStatsCounter.markAllDirty`: everything goes out on the next request. pub(super) fn mark_all_dirty(&mut self) { self.dirty = self .values .iter() - .flat_map(|(ty, m)| m.keys().map(|k| (ty.clone(), k.clone()))) + .map(|(ty, m)| (ty.clone(), m.keys().cloned().collect())) .collect(); } /// `ServerStatsCounter.sendStats`' entries: the dirty statistics and @@ -69,6 +96,7 @@ impl Stats { pub(super) fn take_dirty(&mut self) -> Vec<(String, String, i32)> { std::mem::take(&mut self.dirty) .into_iter() + .flat_map(|(ty, keys)| keys.into_iter().map(move |key| (ty.clone(), key))) .map(|(ty, key)| { let v = self.values.get(&ty).and_then(|m| m.get(&key)).copied(); (ty, key, v.unwrap_or(0)) @@ -344,3 +372,54 @@ impl Game<'_> { }) } } + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn counters_events_and_dirty_entries() { + let mut s = Stats::default(); + s.custom("play_time", 1); + s.custom("play_time", 1); + s.add("mined", "minecraft:stone", 2); + s.custom(&"x".repeat(100), 3); + assert_eq!(s.get("custom", "minecraft:play_time"), 2); + assert_eq!(s.get("mined", "minecraft:stone"), 2); + assert_eq!( + s.get("custom", &format!("minecraft:{}", "x".repeat(100))), + 3 + ); + assert_eq!(s.events.len(), 4); + assert_eq!( + s.events[1], + ( + "minecraft:custom".into(), + "minecraft:play_time".into(), + Some(1) + ) + ); + let long = format!("minecraft:{}", "x".repeat(100)); + let sent = |v: &[(&str, &str, i32)]| -> Vec<(String, String, i32)> { + v.iter() + .map(|&(t, k, n)| (t.to_owned(), k.to_owned(), n)) + .collect() + }; + assert_eq!( + s.take_dirty(), + sent(&[ + ("minecraft:custom", "minecraft:play_time", 2), + ("minecraft:custom", &long, 3), + ("minecraft:mined", "minecraft:stone", 2), + ]) + ); + assert!(s.take_dirty().is_empty()); + s.reset("mined", "minecraft:stone"); + assert_eq!( + s.take_dirty(), + sent(&[("minecraft:mined", "minecraft:stone", 0)]) + ); + s.mark_all_dirty(); + assert_eq!(s.take_dirty().len(), 3); + } +} From 4de112fe1672088ce7fe4143ae6c416bc4b9fc50 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sun, 18 Oct 2026 19:06:34 +0100 Subject: [PATCH 143/163] Fix multiplayer tick ordering and interaction target parity --- .../examples/interaction_input_fixture.rs | 122 ++++++ .../examples/player_sync_fixture.rs | 72 ++++ crates/horizon-client/src/game/hand.rs | 2 +- crates/horizon-client/src/game/remote.rs | 378 ++++++++++++------ .../horizon-client/src/interaction_input.rs | 186 +++++++++ crates/horizon-client/src/lib.rs | 2 + crates/horizon-client/src/net.rs | 63 ++- crates/horizon-client/src/player_sync.rs | 86 ++++ .../parity/VanillaInteractionInputOracle.java | 161 ++++++++ .../parity/VanillaPlayerSyncOracle.java | 109 +++++ tools/test_interaction_input_parity.py | 53 +++ tools/test_player_sync_parity.py | 76 ++++ 12 files changed, 1183 insertions(+), 127 deletions(-) create mode 100644 crates/horizon-client/examples/interaction_input_fixture.rs create mode 100644 crates/horizon-client/examples/player_sync_fixture.rs create mode 100644 crates/horizon-client/src/interaction_input.rs create mode 100644 crates/horizon-client/src/player_sync.rs create mode 100644 mods/horizon/src/test/java/dev/horizonlab/parity/VanillaInteractionInputOracle.java create mode 100644 mods/horizon/src/test/java/dev/horizonlab/parity/VanillaPlayerSyncOracle.java create mode 100644 tools/test_interaction_input_parity.py create mode 100644 tools/test_player_sync_parity.py diff --git a/crates/horizon-client/examples/interaction_input_fixture.rs b/crates/horizon-client/examples/interaction_input_fixture.rs new file mode 100644 index 000000000..bb408dd88 --- /dev/null +++ b/crates/horizon-client/examples/interaction_input_fixture.rs @@ -0,0 +1,122 @@ +use horizon_client::interaction_input::{ + Button, InteractionInput, InteractionWorld, TargetUseWorld, use_on_target, +}; +use serde_json::Value; +use std::io::{BufRead, Write}; + +struct World { + using: bool, + destroying: bool, + entity: bool, + dig_on_attack: bool, + begin_using: bool, + delay: u32, + events: Vec<String>, + passing: bool, +} +impl InteractionWorld for World { + fn using_item(&self) -> bool { + self.using + } + fn release_using(&mut self) { + self.events.push("release".into()); + self.using = false; + } + fn start_attack(&mut self) -> bool { + self.events.push("attack".into()); + if !self.entity { + self.destroying = self.dig_on_attack; + } + false + } + fn start_use(&mut self) { + if self.destroying { + return; + } + self.delay = 4; + let entity = self.entity; + use_on_target(self, entity); + } + fn pick(&mut self) { + self.events.push("pick".into()); + } + fn use_delay(&self) -> u32 { + self.delay + } + fn continue_attack(&mut self, down: bool) { + if self.using { + return; + } + let down = down && !self.entity; + self.events.push(format!("continue {down}")); + if !down { + self.destroying = false; + } + } +} + +impl TargetUseWorld for World { + fn use_entity(&mut self) -> bool { + self.events + .push(if self.passing { "entity" } else { "use" }.into()); + if self.passing { + false + } else { + self.using = self.begin_using; + true + } + } + fn use_block(&mut self) -> bool { + self.events + .push(if self.passing { "block" } else { "use" }.into()); + if self.passing { + false + } else { + self.using = self.begin_using; + true + } + } + fn use_item(&mut self) { + self.events.push("item".into()); + self.using = self.begin_using; + } +} + +fn main() -> Result<(), Box<dyn std::error::Error>> { + let args: Vec<_> = std::env::args().collect(); + let input = std::io::BufReader::new(std::fs::File::open(&args[1])?); + let mut out = std::io::BufWriter::new(std::fs::File::create(&args[2])?); + for (i, line) in input.lines().enumerate() { + let row: Value = serde_json::from_str(&line?)?; + let flag = |key: &str| row[key].as_bool().unwrap(); + let mut world = World { + using: flag("using"), + destroying: flag("destroying"), + entity: flag("entity"), + dig_on_attack: flag("dig_on_attack"), + begin_using: flag("begin_using"), + delay: row["delay"].as_u64().unwrap() as u32, + events: vec![], + passing: row["passing"].as_bool().unwrap_or(false), + }; + let mut input = InteractionInput::default(); + for button in row["clicks"].as_array().unwrap() { + input.press(match button.as_u64().unwrap() { + 0 => Button::Attack, + 1 => Button::Use, + _ => Button::Pick, + }); + } + input.tick(&mut world, flag("attack_down"), flag("use_down")); + writeln!(out, "== {i}")?; + for event in world.events { + writeln!(out, "{event}")?; + } + writeln!( + out, + "state {} {} {}", + world.using, world.destroying, world.delay + )?; + } + Ok(()) +} diff --git a/crates/horizon-client/examples/player_sync_fixture.rs b/crates/horizon-client/examples/player_sync_fixture.rs new file mode 100644 index 000000000..b50a672af --- /dev/null +++ b/crates/horizon-client/examples/player_sync_fixture.rs @@ -0,0 +1,72 @@ +use horizon_client::player_sync::{PositionSender, teleport_velocity}; +use horizon_core::geometry::Vec3; +use horizon_protocol::packets::play::{PlayerPosition, Serverbound as S}; +use serde_json::Value; +use std::io::{BufRead, Write}; + +fn number(value: &Value) -> f64 { + f64::from_bits(u64::from_str_radix(value.as_str().unwrap(), 16).unwrap()) +} + +fn main() -> Result<(), Box<dyn std::error::Error>> { + let args: Vec<_> = std::env::args().collect(); + let input = std::io::BufReader::new(std::fs::File::open(&args[1])?); + let mut out = std::io::BufWriter::new(std::fs::File::create(&args[2])?); + for line in input.lines() { + let row: Value = serde_json::from_str(&line?)?; + if row["kind"] == "movement" { + let mut sender = PositionSender::default(); + for op in row["ops"].as_array().unwrap() { + let pos = std::array::from_fn(|i| number(&op[i])); + let rot = (number(&op[3]) as f32, number(&op[4]) as f32); + if let Some(packet) = + sender.update(pos, rot, op[5].as_bool().unwrap(), op[6].as_bool().unwrap()) + { + let name = match packet { + S::MovePlayerPos(_) => "pos", + S::MovePlayerPosRot(_) => "posrot", + S::MovePlayerRot(_) => "rot", + S::MovePlayerStatus(_) => "status", + _ => unreachable!(), + }; + write!(out, "{name} ")?; + for byte in &packet.encode()[1..] { + write!(out, "{byte:02x}")?; + } + writeln!(out)?; + } else { + writeln!(out, "-")?; + } + } + } else { + let vector = |key: &str| { + Vec3::new( + number(&row[key][0]), + number(&row[key][1]), + number(&row[key][2]), + ) + }; + let rotation = |key: &str| (number(&row[key][0]) as f32, number(&row[key][1]) as f32); + let old = rotation("old"); + let new = rotation("new"); + let delta = vector("delta"); + let packet = PlayerPosition { + teleport: 0, + position: [0.0; 3], + delta: [delta.x, delta.y, delta.z], + yaw: new.0, + pitch: new.1, + relatives: row["flags"].as_i64().unwrap() as i32, + }; + let v = teleport_velocity(vector("velocity"), old, new, &packet); + writeln!( + out, + "{:016x} {:016x} {:016x}", + v.x.to_bits(), + v.y.to_bits(), + v.z.to_bits() + )?; + } + } + Ok(()) +} diff --git a/crates/horizon-client/src/game/hand.rs b/crates/horizon-client/src/game/hand.rs index 13309af87..6e11febbd 100644 --- a/crates/horizon-client/src/game/hand.rs +++ b/crates/horizon-client/src/game/hand.rs @@ -39,7 +39,7 @@ impl Game<'_> { }); self.clicks.destroying = destroying; self.attack_clicks = 0; - self.stop_remote_mining(); + self.request_remote_mining_stop(); self.mining = None; } /// `LivingEntity.swing` with `getModifiedSwingDuration`. diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 545133427..e4d1af1b1 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -94,11 +94,7 @@ pub(super) struct Remote { biome_bits: u8, view_distance: i32, sequence: i32, - last_pos: [f64; 3], - last_rot: (f32, f32), - last_on_ground: bool, - last_collision: bool, - reminder: u32, + position_sender: horizon_client::player_sync::PositionSender, last_input: u8, was_sprinting: bool, carried: Option<usize>, @@ -144,6 +140,8 @@ pub(super) struct Remote { profile: u128, destroying: Option<([i32; 3], u8, f32)>, destroy_delay: u32, + input: horizon_client::interaction_input::InteractionInput, + stop_mining: bool, placing: Option<([i32; 3], u64)>, death_message: Option<String>, player_type: Option<Arc<MobType>>, @@ -273,6 +271,7 @@ impl Game<'_> { self.container = None; self.carried = None; self.using = None; + self.clicks.miss_time = 0; self.set_mode_id(0); self.experience = Experience { level: 0, @@ -301,11 +300,7 @@ impl Game<'_> { biome_bits: 7, view_distance: self.settings.render_distance, sequence: 0, - last_pos: [0.0; 3], - last_rot: (0.0, 0.0), - last_on_ground: false, - last_collision: false, - reminder: 0, + position_sender: Default::default(), last_input: 0, was_sprinting: false, carried: None, @@ -334,6 +329,8 @@ impl Game<'_> { profile: 0, destroying: None, destroy_delay: 0, + input: Default::default(), + stop_mining: false, placing: None, death_message: None, player_type, @@ -657,6 +654,8 @@ impl Game<'_> { r.dimension = dimension; r.game_mode = spawn.game_type; r.loaded_sent = false; + // A replacement LocalPlayer has a fresh sendPosition baseline. + r.position_sender = Default::default(); r.predictions.clear(); self.set_mode_id(spawn.game_type); self.dim = Dim::from_id(&spawn.dimension); @@ -1211,6 +1210,9 @@ impl Game<'_> { fn handle_packet(&mut self, packet: C) -> Result<()> { match packet { + // ClientCommonPacketListenerImpl.handlePing runs on the game + // thread, after all preceding packets (especially teleports). + C::Ping(p) => self.send(S::Pong(p)), // PingDebugMonitor.onPongReceived. C::PongResponse(p) => { let delay = self.debug_millis() - p.time; @@ -2352,10 +2354,11 @@ impl Game<'_> { p.pitch }) .clamp(-90.0, 90.0); - let delta = Vec3::new( - pick(rel::DELTA_X, velocity.x, p.delta[0]), - pick(rel::DELTA_Y, velocity.y, p.delta[1]), - pick(rel::DELTA_Z, velocity.z, p.delta[2]), + let delta = horizon_client::player_sync::teleport_velocity( + velocity, + (self.yaw, self.pitch), + (yaw, pitch), + p, ); match self.player.as_mut() { Some(player) => { @@ -2378,8 +2381,8 @@ impl Game<'_> { self.yaw = yaw; self.pitch = pitch; if let Some(r) = self.remote.as_mut() { - r.last_pos = [position.x, position.y, position.z]; - r.last_rot = (yaw, pitch); + // handleMovePlayer does not change LocalPlayer.sendPosition's + // baseline: the next tick must still report the corrected state. r.destroying = None; } self.mining = None; @@ -2396,6 +2399,16 @@ impl Game<'_> { /// One client tick while connected (Minecraft.tick with a ClientLevel). pub(super) fn tick_remote(&mut self) -> Result<()> { + self.tick_remote_level()?; + // Minecraft.tick sends this even when the player cannot tick yet, + // including while waiting for chunks. Keep it outside early returns. + if self.remote.as_ref().is_some_and(|r| r.joined) { + self.send(S::ClientTickEnd(Empty)); + } + Ok(()) + } + + fn tick_remote_level(&mut self) -> Result<()> { self.ticks += 1; // Options.broadcastOptions: a changed render distance is sent again. let view = client_view_distance(self.settings.render_distance); @@ -2425,6 +2438,10 @@ impl Game<'_> { if self.use_delay > 0 { self.use_delay -= 1; } + // Minecraft.handleKeybinds precedes entity ticking and sendChanges. + // Window callbacks only queue clicks, so an interaction cannot leak + // between CLIENT_TICK_END and a later pong. + self.remote_handle_input(); // ClientLevel.tick: the border's size change. self.border.tick(); self.tick_remote_entities(running); @@ -2447,13 +2464,11 @@ impl Game<'_> { (player.position.z.floor() as i32) >> 4, ); if !self.streaming.is_lit(cx, cz) { - // Moved where nothing is loaded by horizon-ctl (`tp`, `fly`): - // the server hears of it, and sends the chunks there. A player - // who walked there has already sent that move. - let pos = [player.position.x, player.position.y, player.position.z]; + // LocalPlayer.tick can wait for chunks, but Minecraft.tick still + // calls sendChanges: rotations and the 20-tick position reminder + // must continue, as well as moves into the unloaded area. if let Some(r) = self.remote.as_ref() && r.loaded_sent - && r.last_pos != pos { let input = r.last_input; self.remote_send_state(input); @@ -2552,16 +2567,9 @@ impl Game<'_> { // The player's own model (third person, the inventory's preview). self.tick_player_model(); if !dead { - self.remote_mining(); - // Minecraft.handleKeybinds: no new use while an item is in use. - if self.right && self.use_delay == 0 && playing && self.using.is_none() { - self.remote_use(); - self.use_delay = 4; - } self.remote_tick_using(); } self.remote_send_state(input); - self.send(S::ClientTickEnd(Empty)); Ok(()) } /// The local player's share of every touching entity's @@ -2791,41 +2799,12 @@ impl Game<'_> { data: 0, })); } - r.reminder += 1; - let d = [ - pos[0] - r.last_pos[0], - pos[1] - r.last_pos[1], - pos[2] - r.last_pos[2], - ]; - let moved = d[0] * d[0] + d[1] * d[1] + d[2] * d[2] > 2.0e-4 * 2.0e-4 || r.reminder >= 20; - let rotated = yaw != r.last_rot.0 || pitch != r.last_rot.1; - let flags = u8::from(on_ground) | u8::from(collision) << 1; - let [x, y, z] = pos; - if moved && rotated { - out.push(S::MovePlayerPosRot(play::MovePlayerPosRot { - x, - y, - z, - yaw, - pitch, - flags, - })); - } else if moved { - out.push(S::MovePlayerPos(play::MovePlayerPos { x, y, z, flags })); - } else if rotated { - out.push(S::MovePlayerRot(play::MovePlayerRot { yaw, pitch, flags })); - } else if r.last_on_ground != on_ground || r.last_collision != collision { - out.push(S::MovePlayerStatus(play::MovePlayerStatus { flags })); + if let Some(packet) = r + .position_sender + .update(pos, (yaw, pitch), on_ground, collision) + { + out.push(packet); } - if moved { - r.last_pos = pos; - r.reminder = 0; - } - if rotated { - r.last_rot = (yaw, pitch); - } - r.last_on_ground = on_ground; - r.last_collision = collision; // Creative inventory edits are sent slot by slot (SetCreativeModeSlot). let mut creative_slots = Vec::new(); if self.creative { @@ -2868,16 +2847,12 @@ impl Game<'_> { } /// MultiPlayerGameMode.startDestroyBlock / continueDestroyBlock. - fn remote_mining(&mut self) { + fn remote_mining(&mut self, start: bool) { let Some(r) = self.remote.as_mut() else { return; }; - if r.destroy_delay > 0 { + if !start && r.destroy_delay > 0 { r.destroy_delay -= 1; - } - if !self.left || self.screen != Screen::Playing { - self.stop_remote_mining(); - self.mining = None; return; } let Some(hit) = self.pick() else { @@ -2889,11 +2864,6 @@ impl Game<'_> { if self.res.facts().is_air(state) { return; } - if self.remote.as_ref().is_some_and(|r| r.destroy_delay > 0) { - return; - } - self.swing_arm(); - self.send(S::Punch(Empty)); if self.creative { let seq = self.next_sequence(); self.predict_break(hit.pos, state, seq); @@ -2931,6 +2901,9 @@ impl Game<'_> { .as_ref() .and_then(|r| r.destroying) .is_some_and(|(p, _, _)| p == hit.pos); + if start && same { + return; + } if !same { if let Some((old, _, _)) = self.remote.as_mut().and_then(|r| r.destroying.take()) { self.send(S::PlayerAction(play::PlayerAction { @@ -3045,15 +3018,25 @@ impl Game<'_> { } self.mining = None; } - /// Minecraft.startUseItem: use on the targeted block, then the item itself. + /// Minecraft.startUseItem: use one crosshair target, then the item itself. fn remote_use(&mut self) { - let held_block = self - .held() - .and_then(|h| self.res.items().get(&h.item)) - .is_some_and(|i| i.block.is_some()); + // Minecraft.startUseItem returns before resetting rightClickDelay + // while a survival block break is active. + if self.remote.as_ref().is_some_and(|r| r.destroying.is_some()) { + return; + } + self.use_delay = 4; + // Resolve the crosshair once. A passing entity interaction keeps + // that target and may only fall back to using the item itself. + let entity = self.entity_targeted(); + horizon_client::interaction_input::use_on_target(&mut RemoteUseWorld(self), entity); + } + + fn remote_use_entity(&mut self) -> bool { let sneaking = self.keys.contains(&KeyCode::ShiftLeft); - // Entities first (interact), like the hit result order. - if let Some((i, _)) = self.mob_hit() { + if let Some((i, distance)) = self.mob_hit() + && self.before_block(distance) + { let id = self.mobs[i].id as i32; self.send(S::Interact(play::Interact { id, @@ -3069,9 +3052,17 @@ impl Game<'_> { .is_some_and(|r| r.level_players.contains_key(&id)); if !player { self.swing_arm(); - return; + return true; } } + false + } + + fn remote_use_block(&mut self) -> bool { + let held_block = self + .held() + .and_then(|h| self.res.items().get(&h.item)) + .is_some_and(|i| i.block.is_some()); if let Some(hit) = self.pick() { let seq = self.next_sequence(); let cursor = [ @@ -3100,9 +3091,13 @@ impl Game<'_> { } if held_block { self.swing_arm(); - return; + return true; } } + false + } + + fn remote_use_item(&mut self) { if let Some(held) = self.held().cloned() { let seq = self.next_sequence(); self.send(S::UseItem(play::UseItem { @@ -3134,7 +3129,10 @@ impl Game<'_> { self.using = None; return; }; - if !self.right || slot != self.selected || self.screen != Screen::Playing { + // Button release belongs to the next handleKeybinds phase, which + // sends RELEASE_USE_ITEM. Do not silently clear a use begun by a + // quick press/release between ticks. + if slot != self.selected { self.using = None; return; } @@ -3153,52 +3151,139 @@ impl Game<'_> { self.using = Some((slot, ticks + 1)); } } - /// Left click: attack the targeted entity (MultiPlayerGameMode.attack). + /// MouseHandler updates KeyMapping; handleKeybinds sends packets on a tick. pub(super) fn remote_mouse(&mut self, button: MouseButton, pressed: bool) -> Result<()> { - if self.screen == Screen::Chat { - return Ok(()); - } - match button { + use horizon_client::interaction_input::Button; + let input = match button { MouseButton::Left => { - if pressed && let Some((i, _)) = self.mob_hit() { - let id = self.mobs[i].id as i32; - self.send(S::Attack(play::Attack { id })); - self.send(S::Punch(Empty)); - self.swing_arm(); - return Ok(()); - } - if pressed && self.pick().is_none() { - self.send(S::Punch(Empty)); - self.swing_arm(); - } - self.left = pressed; + self.toggles + .button(2, pressed, false, self.settings.toggle_attack); + self.left = self.toggles.is_down(2); + Some(Button::Attack) } MouseButton::Right => { - self.right = pressed; - if pressed { - self.remote_use(); - self.use_delay = 4; - } else { - self.send(S::PlayerAction(play::PlayerAction { - action: 6, - pos: [0; 3], - direction: 0, - sequence: 0, - })); - } + self.toggles + .button(3, pressed, false, self.settings.toggle_use); + self.right = self.toggles.is_down(3); + Some(Button::Use) } - MouseButton::Middle if pressed => { - if let Some(hit) = self.pick() { - self.send(S::PickItemFromBlock(play::PickItemFromBlock { - pos: hit.pos, - include_data: self.has_control_down(), - })); - } - } - _ => {} + MouseButton::Middle => Some(Button::Pick), + _ => None, + }; + if pressed + && let Some(button) = input + && let Some(remote) = self.remote.as_mut() + { + remote.input.press(button); } Ok(()) } + + pub(super) fn request_remote_mining_stop(&mut self) { + if let Some(r) = self.remote.as_mut() { + r.stop_mining = true; + } + } + + fn remote_handle_input(&mut self) { + let Some(r) = self.remote.as_mut() else { + return; + }; + let mut input = std::mem::take(&mut r.input); + let stop = std::mem::take(&mut r.stop_mining); + let ready = r.loaded_sent && self.screen == Screen::Playing && self.sleeping.is_none(); + if stop || !ready { + self.stop_remote_mining(); + } + if !ready { + return; + } + // MultiPlayerGameMode.tick syncs the carried slot before keybinds. + let carried_changed = self.remote.as_mut().is_some_and(|r| { + if r.carried == Some(self.selected) { + false + } else { + r.carried = Some(self.selected); + true + } + }); + if carried_changed { + self.send(S::SetCarriedItem(play::SetCarriedItem { + slot: self.selected as i16, + })); + } + let (attack, use_item) = (self.left, self.right); + input.tick(&mut RemoteInputWorld(self), attack, use_item); + if self.clicks.miss_time > 0 { + self.clicks.miss_time -= 1; + } + if let Some(r) = self.remote.as_mut() { + r.input = input; + } + } + + fn remote_start_attack(&mut self) -> bool { + if self.clicks.miss_time > 0 { + return false; + } + if self.spectator() { + return true; + } + let mut instant = false; + if let Some((i, distance)) = self.mob_hit() + && self.before_block(distance) + { + self.send(S::Attack(play::Attack { + id: self.mobs[i].id as i32, + })); + self.reset_attack_strength(); + } else if !self.entity_targeted() + && let Some(hit) = self.pick() + { + self.remote_mining(true); + instant = self + .res + .facts() + .is_air(self.world.block(hit.pos[0], hit.pos[1], hit.pos[2])); + } else { + if !self.creative { + self.clicks.miss_time = 10; + } + self.reset_attack_strength(); + } + self.swing_arm(); + self.send(S::Punch(Empty)); + instant + } + + fn remote_continue_attack(&mut self, down: bool) { + if !down { + self.clicks.miss_time = 0; + } + if self.clicks.miss_time > 0 || self.using.is_some() { + return; + } + let entity = self.entity_targeted(); + if down + && !entity + && let Some(hit) = self.pick() + { + let state = self.world.block(hit.pos[0], hit.pos[1], hit.pos[2]); + if !self.res.facts().is_air(state) { + self.remote_mining(false); + self.swing_arm(); + self.send(S::Punch(Empty)); + } else { + if let Some(r) = self.remote.as_mut() { + r.destroying = None; + } + self.mining = None; + } + } else { + self.stop_remote_mining(); + self.mining = None; + } + } /// Keys with a multiplayer meaning; returns true when consumed. pub(super) fn remote_key(&mut self, key: KeyCode) -> Result<bool> { if self.screen != Screen::Playing { @@ -3886,6 +3971,57 @@ fn client_view_distance(render_distance: i32) -> i8 { render_distance.clamp(2, i32::from(i8::MAX)) as i8 } +struct RemoteInputWorld<'g, 'a>(&'g mut Game<'a>); + +struct RemoteUseWorld<'g, 'a>(&'g mut Game<'a>); + +impl horizon_client::interaction_input::TargetUseWorld for RemoteUseWorld<'_, '_> { + fn use_entity(&mut self) -> bool { + self.0.remote_use_entity() + } + fn use_block(&mut self) -> bool { + self.0.remote_use_block() + } + fn use_item(&mut self) { + self.0.remote_use_item(); + } +} + +impl horizon_client::interaction_input::InteractionWorld for RemoteInputWorld<'_, '_> { + fn using_item(&self) -> bool { + self.0.using.is_some() + } + fn release_using(&mut self) { + self.0.send(S::PlayerAction(play::PlayerAction { + action: 6, + pos: [0; 3], + direction: 0, + sequence: 0, + })); + self.0.using = None; + } + fn start_attack(&mut self) -> bool { + self.0.remote_start_attack() + } + fn start_use(&mut self) { + self.0.remote_use(); + } + fn pick(&mut self) { + if let Some(hit) = self.0.pick() { + self.0.send(S::PickItemFromBlock(play::PickItemFromBlock { + pos: hit.pos, + include_data: self.0.has_control_down(), + })); + } + } + fn use_delay(&self) -> u32 { + self.0.use_delay + } + fn continue_attack(&mut self, down: bool) { + self.0.remote_continue_attack(down); + } +} + #[cfg(test)] mod tests { use super::Game; diff --git a/crates/horizon-client/src/interaction_input.rs b/crates/horizon-client/src/interaction_input.rs new file mode 100644 index 000000000..d17cb938c --- /dev/null +++ b/crates/horizon-client/src/interaction_input.rs @@ -0,0 +1,186 @@ +//! The mouse-key portion of Minecraft.handleKeybinds. Events only count clicks; +//! the client tick consumes them before player movement and CLIENT_TICK_END. +#[derive(Default)] +pub struct InteractionInput { + clicks: [u32; 3], +} + +#[derive(Clone, Copy)] +pub enum Button { + Attack, + Use, + Pick, +} + +pub trait InteractionWorld { + fn using_item(&self) -> bool; + fn release_using(&mut self); + fn start_attack(&mut self) -> bool; + fn start_use(&mut self); + fn pick(&mut self); + fn use_delay(&self) -> u32; + fn continue_attack(&mut self, down: bool); +} + +/// Minecraft.startUseItem dispatches one hit result per hand. A passing +/// entity interaction falls back to the item, without trying a block behind it. +pub trait TargetUseWorld { + fn use_entity(&mut self) -> bool; + fn use_block(&mut self) -> bool; + fn use_item(&mut self); +} + +pub fn use_on_target(world: &mut impl TargetUseWorld, entity: bool) { + let consumed = if entity { + world.use_entity() + } else { + world.use_block() + }; + if !consumed { + world.use_item(); + } +} + +impl InteractionInput { + pub fn press(&mut self, button: Button) { + self.clicks[button as usize] += 1; + } + + pub fn tick(&mut self, world: &mut impl InteractionWorld, attack_down: bool, use_down: bool) { + let [attack, use_item, pick] = std::mem::take(&mut self.clicks); + let mut instant = false; + if world.using_item() { + if !use_down { + world.release_using(); + } + // Vanilla drains all three click queues while using an item, + // including the tick that releases it. + } else { + for _ in 0..attack { + instant |= world.start_attack(); + } + for _ in 0..use_item { + world.start_use(); + } + for _ in 0..pick { + world.pick(); + } + } + if use_down && world.use_delay() == 0 && !world.using_item() { + world.start_use(); + } + world.continue_attack(!instant && attack_down); + } +} + +#[cfg(test)] +mod tests { + use super::*; + + #[derive(Default)] + struct World { + using: bool, + destroying: bool, + delay: u32, + begin_using: bool, + events: Vec<&'static str>, + } + impl InteractionWorld for World { + fn using_item(&self) -> bool { + self.using + } + fn release_using(&mut self) { + self.events.push("release"); + self.using = false; + } + fn start_attack(&mut self) -> bool { + self.events.push("attack"); + false + } + fn start_use(&mut self) { + if !self.destroying { + self.events.push("use"); + self.delay = 4; + self.using = self.begin_using; + } + } + fn pick(&mut self) { + self.events.push("pick"); + } + fn use_delay(&self) -> u32 { + self.delay + } + fn continue_attack(&mut self, _: bool) { + self.events.push("continue"); + } + } + + #[test] + fn quick_clicks_wait_for_a_tick_and_follow_keybind_order() { + let mut input = InteractionInput::default(); + let mut world = World::default(); + input.press(Button::Use); + input.press(Button::Pick); + input.press(Button::Attack); + assert!(world.events.is_empty()); + // Both edges can arrive between ticks; the press still acts once. + input.tick(&mut world, false, false); + assert_eq!(world.events, ["attack", "use", "pick", "continue"]); + world.events.clear(); + input.tick(&mut world, false, false); + assert_eq!( + world.events, + ["continue"], + "no spurious release or repeated click" + ); + } + + #[test] + fn releasing_actual_item_use_discards_clicks_for_that_tick() { + let mut input = InteractionInput::default(); + let mut world = World { + using: true, + ..Default::default() + }; + for button in [Button::Attack, Button::Use, Button::Pick] { + input.press(button); + } + input.tick(&mut world, true, false); + assert_eq!(world.events, ["release", "continue"]); + } + + #[test] + fn holding_use_respects_the_delay_and_active_digging() { + let mut input = InteractionInput::default(); + let mut world = World { + destroying: true, + ..Default::default() + }; + input.press(Button::Use); + input.tick(&mut world, true, true); + assert_eq!(world.events, ["continue"]); + world.destroying = false; + world.events.clear(); + input.tick(&mut world, false, true); + assert_eq!(world.events, ["use", "continue"]); + world.events.clear(); + input.tick(&mut world, false, true); + assert_eq!(world.events, ["continue"]); + } + + #[test] + fn a_quick_use_click_releases_on_the_following_tick() { + let mut input = InteractionInput::default(); + let mut world = World { + begin_using: true, + ..Default::default() + }; + input.press(Button::Use); + input.tick(&mut world, false, false); + assert_eq!(world.events, ["use", "continue"]); + assert!(world.using); + world.events.clear(); + input.tick(&mut world, false, false); + assert_eq!(world.events, ["release", "continue"]); + } +} diff --git a/crates/horizon-client/src/lib.rs b/crates/horizon-client/src/lib.rs index 1e2c8c331..ef4ee42bc 100644 --- a/crates/horizon-client/src/lib.rs +++ b/crates/horizon-client/src/lib.rs @@ -85,6 +85,7 @@ pub mod hud_layout; pub mod hud_overlays; pub mod hunger; pub mod input; +pub mod interaction_input; pub mod inv_sort; pub mod inventory_effects; pub mod item_data; @@ -133,6 +134,7 @@ pub mod particles; pub mod patrol; pub mod perf_overlay; pub mod pick_item; +pub mod player_sync; pub mod poi_sections; pub mod portal_sections; pub mod pose; diff --git a/crates/horizon-client/src/net.rs b/crates/horizon-client/src/net.rs index f9ad5992a..74f1b0b6d 100644 --- a/crates/horizon-client/src/net.rs +++ b/crates/horizon-client/src/net.rs @@ -1,7 +1,8 @@ //! Multiplayer session: a network thread that connects to a server, logs in, //! runs the configuration phase and then forwards decoded play packets to the -//! game thread. Keep-alives and pings are answered on the network thread like -//! vanilla's connection handlers so a busy frame never times the client out. +//! game thread. Keep-alives are answered on the network thread; pings wait for +//! the game thread, like ClientCommonPacketListenerImpl.handlePing, so a pong +//! cannot overtake an earlier world update or teleport acknowledgement. //! Online-mode servers need the Microsoft account the launcher signed in //! (crate::auth): the login joins the server through the session service and //! encrypts the connection (ClientHandshakePacketListenerImpl.handleHello). @@ -382,8 +383,17 @@ fn run( uuid: profile.uuid, name: profile.name, }); + receive_play(&mut reader, shared_writer, lang, send) +} + +fn receive_play( + reader: &mut ConnReader, + shared_writer: &Mutex<Option<ConnWriter>>, + lang: &Language, + send: &Sender<Event>, +) -> Result<String, String> { loop { - let (id, payload) = reader.recv().map_err(e)?; + let (id, payload) = reader.recv().map_err(|e| e.to_string())?; let packet = match play::Clientbound::decode(id, &payload) { Ok(p) => p, Err(err) => { @@ -404,7 +414,6 @@ fn run( }; match packet { play::Clientbound::KeepAlive(k) => reply(play::Serverbound::KeepAlive(k)), - play::Clientbound::Ping(p) => reply(play::Serverbound::Pong(p)), play::Clientbound::BundleDelimiter(_) => {} play::Clientbound::ResourcePackPush(p) => { // Declined: Horizon has no server resource packs. @@ -415,7 +424,7 @@ fn run( } play::Clientbound::StartConfiguration(_) => { reply(play::Serverbound::ConfigurationAcknowledged(Empty)); - let registries = configure(&mut reader, shared_writer, lang, send)?; + let registries = configure(reader, shared_writer, lang, send)?; let _ = send.send(Event::Reconfigured(Arc::new(registries))); } play::Clientbound::Disconnect(d) => return Ok(plain(&d.reason, lang)), @@ -585,6 +594,50 @@ pub fn ping(address: &str, timeout: Duration) -> Result<(serde_json::Value, u128 mod tests { use super::*; + #[test] + fn pings_wait_behind_teleports_but_keepalives_do_not_wait_for_the_game() { + let (client, server) = horizon_protocol::connection::Pipe::pair(); + let (mut reader, writer) = Connection::local(client).split(); + let writer = Arc::new(Mutex::new(Some(writer))); + let (send, events) = channel(); + let thread_writer = writer.clone(); + let thread = std::thread::spawn(move || { + receive_play(&mut reader, &thread_writer, &Language::new(), &send) + }); + let mut server = Connection::local(server); + let teleport = play::Clientbound::PlayerPosition(play::PlayerPosition { + teleport: 42, + position: [10.0, 64.0, 10.0], + delta: [0.0; 3], + yaw: 90.0, + pitch: 0.0, + relatives: 0, + }); + server.send(&teleport.encode()).unwrap(); + server + .send(&play::Clientbound::Ping(cfg::Ping { id: 7 }).encode()) + .unwrap(); + // A reply to this proves the receive loop has passed the ping. The + // old implementation instead replies with Pong before this keepalive. + server + .send(&play::Clientbound::KeepAlive(cfg::KeepAlive { id: 9 }).encode()) + .unwrap(); + let (id, body) = server.recv().unwrap(); + assert_eq!( + play::Serverbound::decode(id, &body).unwrap(), + play::Serverbound::KeepAlive(cfg::KeepAlive { id: 9 }) + ); + let timeout = Duration::from_secs(5); + assert!( + matches!(events.recv_timeout(timeout).unwrap(), Event::Packet(p) if *p == teleport) + ); + assert!( + matches!(events.recv_timeout(timeout).unwrap(), Event::Packet(p) if *p == play::Clientbound::Ping(cfg::Ping { id: 7 })) + ); + writer.lock().unwrap().take().unwrap().shutdown(); + assert!(thread.join().unwrap().is_err()); + } + #[test] fn server_brand_payload_is_decoded_and_invalid_or_unrelated_payloads_are_ignored() { let (send, events) = channel(); diff --git a/crates/horizon-client/src/player_sync.rs b/crates/horizon-client/src/player_sync.rs new file mode 100644 index 000000000..96b09c708 --- /dev/null +++ b/crates/horizon-client/src/player_sync.rs @@ -0,0 +1,86 @@ +//! LocalPlayer.sendPosition and PositionMoveRotation.calculateAbsolute. +use horizon_core::geometry::Vec3; +use horizon_protocol::packets::play::{self, PlayerPosition, Serverbound as S, relative}; + +/// Only movement updates advance this baseline. A teleport acknowledgement is +/// separate and must not suppress the next tick's corrected position or look. +#[derive(Default)] +pub struct PositionSender { + position: [f64; 3], + rotation: (f32, f32), + on_ground: bool, + collision: bool, + reminder: u32, +} + +impl PositionSender { + pub fn update( + &mut self, + position: [f64; 3], + rotation: (f32, f32), + on_ground: bool, + collision: bool, + ) -> Option<S> { + self.reminder += 1; + let d: [f64; 3] = std::array::from_fn(|i| position[i] - self.position[i]); + let moved = + d[0] * d[0] + d[1] * d[1] + d[2] * d[2] > 2.0e-4 * 2.0e-4 || self.reminder >= 20; + let rotated = rotation.0 - self.rotation.0 != 0.0 || rotation.1 - self.rotation.1 != 0.0; + let flags = u8::from(on_ground) | u8::from(collision) << 1; + let [x, y, z] = position; + let (yaw, pitch) = rotation; + let packet = if moved && rotated { + Some(S::MovePlayerPosRot(play::MovePlayerPosRot { + x, + y, + z, + yaw, + pitch, + flags, + })) + } else if moved { + Some(S::MovePlayerPos(play::MovePlayerPos { x, y, z, flags })) + } else if rotated { + Some(S::MovePlayerRot(play::MovePlayerRot { yaw, pitch, flags })) + } else if self.on_ground != on_ground || self.collision != collision { + Some(S::MovePlayerStatus(play::MovePlayerStatus { flags })) + } else { + None + }; + if moved { + self.position = position; + self.reminder = 0; + } + if rotated { + self.rotation = rotation; + } + self.on_ground = on_ground; + self.collision = collision; + packet + } +} + +/// Rotate the old velocity before adding the relative delta components. +/// Angles deliberately use Java's double toRadians followed by a float cast. +pub fn teleport_velocity( + mut velocity: Vec3, + old_rotation: (f32, f32), + new_rotation: (f32, f32), + packet: &PlayerPosition, +) -> Vec3 { + if packet.relatives & relative::ROTATE_DELTA != 0 { + let pitch = f64::from(old_rotation.1 - new_rotation.1).to_radians() as f32; + let yaw = f64::from(old_rotation.0 - new_rotation.0).to_radians() as f32; + velocity = velocity.rotate_x(pitch).rotate_y(yaw); + } + let old = [velocity.x, velocity.y, velocity.z]; + let flags = [relative::DELTA_X, relative::DELTA_Y, relative::DELTA_Z]; + let result: [f64; 3] = std::array::from_fn(|i| { + if packet.relatives & flags[i] != 0 { + old[i] + packet.delta[i] + } else { + packet.delta[i] + } + }); + Vec3::new(result[0], result[1], result[2]) +} diff --git a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaInteractionInputOracle.java b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaInteractionInputOracle.java new file mode 100644 index 000000000..884e5042a --- /dev/null +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaInteractionInputOracle.java @@ -0,0 +1,161 @@ +package dev.horizonlab.parity; + +import com.google.gson.*; +import java.io.PrintWriter; +import java.lang.reflect.*; +import java.nio.file.*; +import java.util.*; +import net.minecraft.client.*; +import net.minecraft.client.gui.Gui; +import net.minecraft.client.multiplayer.*; +import net.minecraft.client.player.LocalPlayer; +import net.minecraft.core.*; +import net.minecraft.network.protocol.Packet; +import net.minecraft.world.*; +import net.minecraft.world.entity.*; +import net.minecraft.world.entity.player.*; +import net.minecraft.world.flag.*; +import net.minecraft.world.item.ItemStack; +import net.minecraft.world.item.component.SwingAnimation; +import net.minecraft.world.level.block.Blocks; +import net.minecraft.world.level.block.state.BlockState; +import net.minecraft.world.level.border.WorldBorder; +import net.minecraft.world.phys.*; + +/** Runs the shipped handleKeybinds; only game-mode effects and UI are shells. */ +public final class VanillaInteractionInputOracle { + static Object unsafe; + static Method allocate; + static List<String> events = new ArrayList<>(); + static Field field(Class<?> type, String name) throws Exception { + var f = type.getDeclaredField(name); f.setAccessible(true); return f; + } + static <T> T make(Class<T> type) throws Exception { return type.cast(allocate.invoke(unsafe, type)); } + public static class MC extends Minecraft { + public MC() { super(null); } + @Override public boolean hasControlDown() { return false; } + } + public static class UI extends Gui { + public UI() { super(null, null, null); } + @Override public void handleKeybinds() {} + } + public static class Mouse extends MouseHandler { + public Mouse() { super(null); } + @Override public boolean isMouseGrabbed() { return true; } + } + public static class Level extends ClientLevel { + public Level() { super(null, null, null, null, 0, 0, null, false, 0L, 0); } + @Override public BlockState getBlockState(BlockPos pos) { return Blocks.STONE.defaultBlockState(); } + @Override public FeatureFlagSet enabledFeatures() { return FeatureFlags.REGISTRY.allFlags(); } + } + public static class Connection extends ClientPacketListener { + public Connection() { super(null, null, null); } + @Override public void send(Packet<?> packet) {} + } + public static class Human extends LocalPlayer { + boolean using; + ItemStack held = ItemStack.EMPTY; + public Human() { super(null, null, null, null, null, null, false, null, null); } + @Override public boolean isUsingItem() { return using; } + @Override public boolean isSpectator() { return false; } + @Override public boolean isCreative() { return false; } + @Override public boolean isHandsBusy() { return false; } + @Override public ItemStack getItemInHand(InteractionHand hand) { + return hand == InteractionHand.MAIN_HAND ? held : ItemStack.EMPTY; + } + @Override public void itemUsed(InteractionHand hand) {} + @Override public boolean cannotAttackWithItem(ItemStack item, int slot) { return false; } + @Override public boolean isWithinEntityInteractionRange(Entity e, double buffer) { return true; } + @Override public boolean swing(InteractionHand hand, SwingAnimation animation, boolean send) { return false; } + } + public static class Mode extends MultiPlayerGameMode { + boolean destroying, digOnAttack, beginUsing, passing; + Human player; + public Mode() { super(null, null); } + @Override public boolean isDestroying() { return destroying; } + @Override public boolean isSpectator() { return false; } + @Override public boolean startDestroyBlock(BlockPos pos, Direction face) { + events.add("attack"); destroying = digOnAttack; return true; + } + @Override public boolean continueDestroyBlock(BlockPos pos, Direction face) { + events.add("continue true"); return true; + } + @Override public void stopDestroyBlock() { events.add("continue false"); destroying = false; } + @Override public void attack(Player p, Entity e) { events.add("attack"); } + @Override public void releaseUsingItem(Player p) { events.add("release"); player.using = false; } + InteractionResult use() { events.add("use"); player.using = beginUsing; return InteractionResult.SUCCESS_SERVER; } + @Override public InteractionResult useItemOn(LocalPlayer p, InteractionHand h, BlockHitResult hit) { + if (passing) { events.add("block"); return InteractionResult.PASS; } + return use(); + } + @Override public InteractionResult interact(Player p, Entity e, EntityHitResult hit, InteractionHand h) { + if (passing) { events.add("entity"); return InteractionResult.PASS; } + return use(); + } + @Override public InteractionResult useItem(Player p, InteractionHand h) { + events.add("item"); player.using = beginUsing; return InteractionResult.SUCCESS_SERVER; + } + @Override public void handlePickItemFromBlock(BlockPos pos, boolean data) { events.add("pick"); } + @Override public void handlePickItemFromEntity(Entity entity, boolean data) { events.add("pick"); } + } + static boolean flag(JsonObject row, String name) { return row.get(name).getAsBoolean(); } + public static void main(String[] args) throws Exception { + ParityData.init(); + var u = Class.forName("sun.misc.Unsafe"); unsafe = field(u, "theUnsafe").get(null); + allocate = u.getMethod("allocateInstance", Class.class); + var handle = Minecraft.class.getDeclaredMethod("handleKeybinds"); handle.setAccessible(true); + try (var out = new PrintWriter(Files.newBufferedWriter(Path.of(args[1]))); + var lines = Files.lines(Path.of(args[0]))) { + int i = 0; + for (String line : (Iterable<String>) lines::iterator) { + var row = JsonParser.parseString(line).getAsJsonObject(); + var mc = make(MC.class); var options = make(Options.class); + for (var f : Options.class.getDeclaredFields()) { + if (Modifier.isStatic(f.getModifiers())) continue; + f.setAccessible(true); + if (f.getType() == KeyMapping.class) f.set(options, make(KeyMapping.class)); + if (f.getType() == KeyMapping[].class) { + var keys = new KeyMapping[9]; + for (int n = 0; n < keys.length; n++) keys[n] = make(KeyMapping.class); + f.set(options, keys); + } + } + var player = make(Human.class); player.using = flag(row, "using"); + boolean passing = row.has("passing") && flag(row, "passing"); + player.held = passing ? new ItemStack(Blocks.STONE.asItem()) : ItemStack.EMPTY; + var level = make(Level.class); + field(ClientLevel.class, "worldBorder").set(level, new WorldBorder()); + field(Player.class, "abilities").set(player, new Abilities()); + field(LocalPlayer.class, "connection").set(player, make(Connection.class)); + var mode = make(Mode.class); mode.player = player; + mode.destroying = flag(row, "destroying"); mode.digOnAttack = flag(row, "dig_on_attack"); + mode.beginUsing = flag(row, "begin_using"); + mode.passing = passing; + field(Minecraft.class, "options").set(mc, options); + field(Minecraft.class, "gui").set(mc, make(UI.class)); + field(Minecraft.class, "mouseHandler").set(mc, make(Mouse.class)); + field(Minecraft.class, "player").set(mc, player); + field(Minecraft.class, "level").set(mc, level); + field(Minecraft.class, "gameMode").set(mc, mode); + var entity = make(net.minecraft.world.entity.item.ItemEntity.class); + field(Entity.class, "blockPosition").set(entity, BlockPos.ZERO); + field(Minecraft.class, "hitResult").set(mc, flag(row, "entity") + ? new EntityHitResult(entity, Vec3.ZERO) + : new BlockHitResult(Vec3.ZERO, Direction.UP, BlockPos.ZERO, false)); + String[] names = {"keyAttack", "keyUse", "keyPickItem"}; + for (var click : row.getAsJsonArray("clicks")) { + var key = (KeyMapping)field(Options.class, names[click.getAsInt()]).get(options); + var count = field(KeyMapping.class, "clickCount"); + count.setInt(key, count.getInt(key) + 1); + } + field(KeyMapping.class, "isDown").setBoolean(options.keyAttack, flag(row, "attack_down")); + field(KeyMapping.class, "isDown").setBoolean(options.keyUse, flag(row, "use_down")); + field(Minecraft.class, "rightClickDelay").setInt(mc, row.get("delay").getAsInt()); + events.clear(); handle.invoke(mc); + out.println("== " + i++); + for (String event : events) out.println(event); + out.println("state " + player.using + " " + mode.destroying + " " + field(Minecraft.class, "rightClickDelay").getInt(mc)); + } + } + } +} diff --git a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaPlayerSyncOracle.java b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaPlayerSyncOracle.java new file mode 100644 index 000000000..056240bb8 --- /dev/null +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaPlayerSyncOracle.java @@ -0,0 +1,109 @@ +package dev.horizonlab.parity; + +import com.google.gson.*; +import io.netty.buffer.Unpooled; +import java.io.PrintWriter; +import java.lang.reflect.*; +import java.nio.file.*; +import java.util.HexFormat; +import net.minecraft.client.*; +import net.minecraft.client.multiplayer.ClientPacketListener; +import net.minecraft.client.player.LocalPlayer; +import net.minecraft.network.FriendlyByteBuf; +import net.minecraft.network.protocol.Packet; +import net.minecraft.network.protocol.game.ServerboundMovePlayerPacket; +import net.minecraft.world.entity.*; +import net.minecraft.world.phys.Vec3; + +/** Runs shipped methods; only the world lifecycle and packet sink are fixtures. */ +public final class VanillaPlayerSyncOracle { + static Object unsafe; + static Method allocate; + static PrintWriter out; + static Field field(Class<?> type, String name) throws Exception { + var f = type.getDeclaredField(name); f.setAccessible(true); return f; + } + static <T> T make(Class<T> type) throws Exception { + return type.cast(allocate.invoke(unsafe, type)); + } + public static final class Player extends LocalPlayer { + boolean ground; + public Player() { super(null, null, null, null, null, null, false, null, null); } + @Override protected boolean isControlledCamera() { return true; } + @Override public boolean isSprinting() { return false; } + @Override public boolean onGround() { return ground; } + } + public static final class Sink extends ClientPacketListener { + boolean sent; + public Sink() { super(null, null, null); } + @Override public void send(Packet<?> packet) { + sent = true; + var buf = new FriendlyByteBuf(Unpooled.buffer()); + String name; + try { + if (packet instanceof ServerboundMovePlayerPacket.PosRot p) { + name = "posrot"; ServerboundMovePlayerPacket.PosRot.STREAM_CODEC.encode(buf, p); + } else if (packet instanceof ServerboundMovePlayerPacket.Pos p) { + name = "pos"; ServerboundMovePlayerPacket.Pos.STREAM_CODEC.encode(buf, p); + } else if (packet instanceof ServerboundMovePlayerPacket.Rot p) { + name = "rot"; ServerboundMovePlayerPacket.Rot.STREAM_CODEC.encode(buf, p); + } else if (packet instanceof ServerboundMovePlayerPacket.StatusOnly p) { + name = "status"; ServerboundMovePlayerPacket.StatusOnly.STREAM_CODEC.encode(buf, p); + } else { throw new AssertionError(packet); } + byte[] bytes = new byte[buf.readableBytes()]; buf.readBytes(bytes); + out.println(name + " " + HexFormat.of().formatHex(bytes)); + } finally { buf.release(); } + } + } + static double number(JsonElement value) { + return Double.longBitsToDouble(Long.parseUnsignedLong(value.getAsString(), 16)); + } + static Vec3 vector(JsonObject row, String key) { + var a = row.getAsJsonArray(key); + return new Vec3(number(a.get(0)), number(a.get(1)), number(a.get(2))); + } + public static void main(String[] args) throws Exception { + net.minecraft.SharedConstants.tryDetectVersion(); + net.minecraft.server.Bootstrap.bootStrap(); + var u = Class.forName("sun.misc.Unsafe"); + unsafe = field(u, "theUnsafe").get(null); + allocate = u.getMethod("allocateInstance", Class.class); + var sendPosition = LocalPlayer.class.getDeclaredMethod("sendPosition"); + sendPosition.setAccessible(true); + var minecraft = make(Minecraft.class); + var options = make(Options.class); + field(Options.class, "autoJump").set(options, OptionInstance.createBoolean("test", false)); + field(Minecraft.class, "options").set(minecraft, options); + try (var output = new PrintWriter(Files.newBufferedWriter(Path.of(args[1]))); + var lines = Files.lines(Path.of(args[0]))) { + out = output; + for (String line : (Iterable<String>) lines::iterator) { + var row = JsonParser.parseString(line).getAsJsonObject(); + if (row.get("kind").getAsString().equals("movement")) { + var p = make(Player.class); + var sink = make(Sink.class); + field(LocalPlayer.class, "connection").set(p, sink); + field(LocalPlayer.class, "minecraft").set(p, minecraft); + for (var value : row.getAsJsonArray("ops")) { + var op = value.getAsJsonArray(); + field(Entity.class, "position").set(p, new Vec3(number(op.get(0)), number(op.get(1)), number(op.get(2)))); + field(Entity.class, "yRot").setFloat(p, (float)number(op.get(3))); + field(Entity.class, "xRot").setFloat(p, (float)number(op.get(4))); + p.ground = op.get(5).getAsBoolean(); + p.horizontalCollision = op.get(6).getAsBoolean(); + sink.sent = false; + sendPosition.invoke(p); + if (!sink.sent) out.println("-"); + } + } else { + var old = row.getAsJsonArray("old"); + var next = row.getAsJsonArray("new"); + var base = new PositionMoveRotation(Vec3.ZERO, vector(row, "velocity"), (float)number(old.get(0)), (float)number(old.get(1))); + var change = new PositionMoveRotation(Vec3.ZERO, vector(row, "delta"), (float)number(next.get(0)), (float)number(next.get(1))); + var v = PositionMoveRotation.calculateAbsolute(base, change, Relative.unpack(row.get("flags").getAsInt())).deltaMovement(); + out.printf("%016x %016x %016x%n", Double.doubleToRawLongBits(v.x), Double.doubleToRawLongBits(v.y), Double.doubleToRawLongBits(v.z)); + } + } + } + } +} diff --git a/tools/test_interaction_input_parity.py b/tools/test_interaction_input_parity.py new file mode 100644 index 000000000..1aa34a73f --- /dev/null +++ b/tools/test_interaction_input_parity.py @@ -0,0 +1,53 @@ +#!/usr/bin/env python3 +"""Compare queued interaction ordering with the real Minecraft.handleKeybinds.""" +import itertools +import json +import random + +try: + from . import lab, oracle_harness as harness +except ImportError: + import lab, oracle_harness as harness + + +def corpus(): + rng = random.Random(0x434C49434B) + for using, destroying, attack_down, use_down, entity in itertools.product([False, True], repeat=5): + for clicks in [[], [1], [0, 1], [1, 0], [2, 1, 0], [0, 0, 1, 1, 2]]: + for delay in [0, 3]: + yield dict(using=using, destroying=destroying, attack_down=attack_down, + use_down=use_down, entity=entity, clicks=clicks, delay=delay, + dig_on_attack=rng.choice([False, True]), + begin_using=rng.choice([False, True])) + # A player interaction returning PASS must go directly to the held item. + # The level still reports a solid block underneath the entity hit. + for entity in [False, True]: + for clicks in [[1], [1, 1], [0, 1], [1, 2]]: + yield dict(using=False, destroying=False, attack_down=False, use_down=False, + entity=entity, clicks=clicks, delay=0, dig_on_attack=False, + begin_using=False, passing=True) + + +def main(): + def inputs(build): + rows = list(corpus()) + path = build / "inputs.jsonl" + path.write_text("".join(json.dumps(row) + "\n" for row in rows)) + return path, len(rows) + + harness.differential( + "interaction-input-parity", "VanillaInteractionInputOracle", "interaction_input_fixture", inputs, + "Invokes Minecraft.handleKeybinds itself with real KeyMapping click counters. " + "Compares attack/use/pick ordering, release gating, drained clicks during use, " + "held-button repetition and use cooldowns for block/entity targets. " + "Includes passing entity interactions over solid blocks: only the held " + "item may be tried afterward. " + "Game-mode side effects and world simulation are controlled fixtures.", + sources=[lab.ROOT / "crates/horizon-client/src/interaction_input.rs", + lab.ROOT / "crates/horizon-client/src/game/remote.rs", + lab.ROOT / "crates/horizon-client/src/game/hand.rs", + lab.ROOT / "mods/horizon/src/test/java/dev/horizonlab/parity/ParityData.java"]) + + +if __name__ == "__main__": + main() diff --git a/tools/test_player_sync_parity.py b/tools/test_player_sync_parity.py new file mode 100644 index 000000000..4c78b439f --- /dev/null +++ b/tools/test_player_sync_parity.py @@ -0,0 +1,76 @@ +#!/usr/bin/env python3 +"""Compare movement packet selection and teleport velocity with the pinned client.""" +import json +import random +import struct + +try: + from . import lab, oracle_harness as harness +except ImportError: + import lab, oracle_harness as harness + + +def corpus(): + # Stationary heartbeats, rotation-only updates, status changes and corrected + # positions followed by unchanged looks must retain vanilla's packet types. + yield dict(kind="movement", ops=[[0, 0, 0, 0, 0, False, False]] * 61) + yield dict(kind="movement", ops=[ + [0, 64, 0, 90, 0, True, False], + [0, 64, 0, 90, 0, True, False], + [0, 64, 0, 91, 0, True, False], + [100, 80, -20, 180, 20, False, False], + [100, 80, -20, 180, 20, True, False], + [100, 80, -20, 180, 20, True, True], + ]) + rng = random.Random(0x53594E43) + for _ in range(300): + state = [0, 0, 0, 0, 0, False, False] + ops = [] + for _ in range(80): + if rng.random() < 0.5: + axis = rng.randrange(3) + state[axis] += rng.choice([0, 0.0001, 0.0002, 0.0002000001, 0.1, 10]) + if rng.random() < 0.3: + state[3] += rng.choice([-360, -1, 0, 0.001, 1, 360]) + state[4] = rng.choice([-90, 0, 30, 90]) + if rng.random() < 0.2: + state[rng.randrange(5, 7)] = rng.choice([False, True]) + ops.append(state.copy()) + yield dict(kind="movement", ops=ops) + for flags in range(16): + for _ in range(40): + yield dict(kind="velocity", flags=flags << 5, + velocity=[rng.uniform(-4, 4) for _ in range(3)], + delta=[rng.uniform(-4, 4) for _ in range(3)], + old=[rng.uniform(-720, 720), rng.uniform(-90, 90)], + new=[rng.uniform(-720, 720), rng.uniform(-90, 90)]) + + +def main(): + def inputs(build): + rows = list(corpus()) + def bits(v): + return struct.pack(">d", v).hex() + for row in rows: + if row["kind"] == "movement": + row["ops"] = [[*map(bits, op[:5]), *op[5:]] for op in row["ops"]] + else: + for key in ["velocity", "delta", "old", "new"]: + row[key] = list(map(bits, row[key])) + path = build / "inputs.jsonl" + path.write_text("".join(json.dumps(row) + "\n" for row in rows)) + return path, len(rows) + + harness.differential( + "player-sync-parity", "VanillaPlayerSyncOracle", "player_sync_fixture", inputs, + "Actual LocalPlayer.sendPosition packet payloads over persistent movement " + "sequences; PositionMoveRotation.calculateAbsolute velocity with every " + "relative-delta/rotate-delta combination. World simulation, connection " + "scheduling and live anticheat behaviour are outside this harness.", + sources=[lab.ROOT / "crates/horizon-client/src/player_sync.rs", + lab.ROOT / "crates/horizon-client/src/game/remote.rs", + lab.ROOT / "crates/horizon-client/src/net.rs"]) + + +if __name__ == "__main__": + main() From 519ec1217cbf1c4c91bc427ccd2d61a6fdcc383e Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 20:17:21 +0200 Subject: [PATCH 144/163] Server build: the game without sound or controllers, so Linux servers need neither ALSA nor udev horizon-client's cpal output and its controllers (gilrs, the DualSense's HID output) move behind the audio and controllers features, on by default, so the game is unchanged. Built with --no-default-features it links neither libasound.so.2 nor libudev.so.1. release.yml packages that build as horizon-engine in horizon-server-linux-x86_64.tar.gz (xtask package-server, checked by check_imports.py --server); install.sh installs it on Linux (and --archive installs a local one); horizon-server already prefers horizon-engine. The Dockerfile uses it too, and CI lints it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .github/workflows/ci.yml | 2 + .github/workflows/release.yml | 28 +- crates/horizon-client/Cargo.toml | 15 +- crates/horizon-client/src/audio.rs | 21 +- crates/horizon-client/src/game/pad.rs | 404 ++--------------- .../horizon-client/src/game/pad/hardware.rs | 409 ++++++++++++++++++ crates/horizon-client/src/gamepad.rs | 3 + crates/horizon-server/src/engine.rs | 25 +- docs/release-flow.md | 1 + docs/server.md | 50 ++- packaging/server/Dockerfile | 15 +- packaging/server/install.sh | 80 ++-- tools/check_imports.py | 13 +- xtask/src/main.rs | 58 ++- 14 files changed, 670 insertions(+), 454 deletions(-) create mode 100644 crates/horizon-client/src/game/pad/hardware.rs diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 5d5e285c5..da23874b8 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -56,6 +56,8 @@ jobs: run: | cargo +stable fmt --all -- --check cargo +stable clippy --workspace --all-targets -- -D warnings + # The server build (released as horizon-engine): the game without sound or controllers. + cargo +stable clippy -p horizon-client --all-targets --no-default-features -- -D warnings - name: Test Rust core and voxel kernel correctness if: steps.rust.outputs.required != 'false' run: cargo +stable test --workspace diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index a4780c85b..bd916514b 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -76,6 +76,9 @@ jobs: os: ubuntu-22.04 dir: horizon-linux-x86_64 asset: horizon-linux-x86_64.tar.gz + # The server build too: packaging/server/install.sh installs it on Linux. + server_dir: horizon-server-linux-x86_64 + server_asset: horizon-server-linux-x86_64.tar.gz - name: windows os: windows-latest dir: horizon-windows-x64 @@ -190,6 +193,29 @@ jobs: path: dist/${{ matrix.asset }} if-no-files-found: error retention-days: 3 + - name: The server build (the game without sound or controllers, as horizon-engine) + if: matrix.server_asset + run: | + set -euo pipefail + # After the client is packaged: target/release/horizon-client is rebuilt without the audio and + # controllers features, so it needs neither libasound nor libudev (minimal server images lack them). + cargo build --release --locked -p horizon-client --no-default-features --bin horizon-client + cargo run --locked -p xtask -- package-server target/release/horizon-client "dist/${{ matrix.server_dir }}" + folder="dist/${{ matrix.server_dir }}" + python3 tools/check_imports.py --server "$folder/horizon-engine" "$folder/horizon-server" "$folder/horizon-prepare" + "$folder/horizon-engine" --help | grep -q -- '--resources' + "$folder/horizon-server" --version + cd dist + rm -f "${{ matrix.server_asset }}" + tar czf "${{ matrix.server_asset }}" "${{ matrix.server_dir }}" + ls -l "${{ matrix.server_asset }}" + - uses: actions/upload-artifact@v4 + if: matrix.server_asset + with: + name: ${{ matrix.server_asset }} + path: dist/${{ matrix.server_asset }} + if-no-files-found: error + retention-days: 3 publish: needs: [decide, build] @@ -220,7 +246,7 @@ jobs: run: | gh release create "$TAG" --target "${{ needs.decide.outputs.head }}" --title "$(cat notes/title.txt)" \ --notes-file notes/body.md --latest dist/horizon-linux-x86_64.tar.gz dist/horizon-windows-x64.zip \ - dist/horizon-macos-arm64.zip + dist/horizon-macos-arm64.zip dist/horizon-server-linux-x86_64.tar.gz - name: Dry run, the release that would be published if: needs.decide.outputs.dry_run == 'true' run: | diff --git a/crates/horizon-client/Cargo.toml b/crates/horizon-client/Cargo.toml index 8713bc1b7..82dca390d 100644 --- a/crates/horizon-client/Cargo.toml +++ b/crates/horizon-client/Cargo.toml @@ -31,7 +31,8 @@ toml = "1.1" naga = { version = "30.0.1", features = ["wgsl-in"] } # Java (OptiFine/Iris) shader packs, translated to WGSL. horizon-shaderpack = { path = "../horizon-shaderpack" } -cpal = "0.16" +# Sound (ALSA on Linux); the `audio` feature. +cpal = { version = "0.16", optional = true } symphonia = { version = "0.5", default-features = false, features = ["ogg", "vorbis"] } miniz_oxide = "0.8" ab_glyph = "0.2.32" @@ -44,10 +45,10 @@ horizon-telemetry = { path = "../horizon-telemetry", default-features = false } horizon-bench = { path = "../horizon-bench" } arboard = { version = "3.6.1", default-features = false, features = ["wayland-data-control"] } zip = { version = "2", default-features = false, features = ["deflate"] } -# Controllers (evdev + libudev on Linux, IOKit on macOS, Windows.Gaming.Input). -gilrs = "0.11" +# Controllers (evdev + libudev on Linux, IOKit on macOS, Windows.Gaming.Input); the `controllers` feature. +gilrs = { version = "0.11", optional = true } # The DualSense's rumble, adaptive triggers and lights over HID (gilrs only reads it). -horizon-dualsense = { path = "../horizon-dualsense" } +horizon-dualsense = { path = "../horizon-dualsense", optional = true } # HTTPS to the Minecraft services (online-mode session join). ureq = { version = "2", default-features = false, features = ["tls"] } @@ -60,6 +61,12 @@ rustix = { version = "1", default-features = false, features = ["std", "time"] } winresource = "0.1" [features] +default = ["audio", "controllers"] +# Sound output. Without it (and `controllers`) the program links neither libasound nor libudev on +# Linux: the server build (`--no-default-features`, released as horizon-engine; docs/server.md). +audio = ["dep:cpal"] +# Controllers: gilrs, and the DualSense's own output. Without it only `horizon-ctl pad`'s virtual pad. +controllers = ["dep:gilrs", "dep:horizon-dualsense"] # Records the call sites of mob random draws (`mob_ai_probe` traces). rng-trace = ["horizon-core/rng-trace"] diff --git a/crates/horizon-client/src/audio.rs b/crates/horizon-client/src/audio.rs index 0c45fa934..250babf22 100644 --- a/crates/horizon-client/src/audio.rs +++ b/crates/horizon-client/src/audio.rs @@ -9,6 +9,7 @@ use crate::sound_engine::{ Sounds, TickContext, }; use crate::sound_events::{Sound, SoundRegistry}; +#[cfg(feature = "audio")] use cpal::traits::{DeviceTrait, HostTrait, StreamTrait}; use horizon_core::random::{LegacyRandom, RandomSource}; use std::{ @@ -134,8 +135,14 @@ fn attach(mixer: &Mutex<Mixer>, channel: ChannelId, samples: Samples, looping: b c.looping |= looping; } } +/// The open output stream. A build without the `audio` feature (the server build, which must not +/// need libasound) never has one. +#[cfg(feature = "audio")] +type Stream = cpal::Stream; +#[cfg(not(feature = "audio"))] +type Stream = std::convert::Infallible; pub struct Audio { - _stream: Option<cpal::Stream>, + _stream: Option<Stream>, pub engine: SoundEngine, backend: MixerBackend, /// Record `Heard` sounds (the subtitle overlay is listening). @@ -333,6 +340,8 @@ fn distance_gain(linear: Option<f32>, distance: f32) -> f32 { Some(_) => 0.0, } } +// Only the output stream mixes; a build without one (no `audio` feature) never does. +#[cfg_attr(not(feature = "audio"), allow(dead_code))] fn mix(mixer: &mut Mixer, data: &mut [f32], channels: usize, rate: u32) { data.fill(0.0); let listener = mixer.listener; @@ -415,6 +424,7 @@ fn mix(mixer: &mut Mixer, data: &mut [f32], channels: usize, rate: u32) { /// `HORIZON_NO_AUDIO`, or a virtual screen (`vscreen`), where agents and /// harnesses run the game and must stay off the user's speakers. /// `HORIZON_AUDIO=1` opens the output anyway (testing into a null sink). +#[cfg(any(feature = "audio", test))] fn output_disabled(var: impl Fn(&str) -> Option<std::ffi::OsString>) -> Option<String> { if var("HORIZON_NO_AUDIO").is_some() { return Some("audio off: HORIZON_NO_AUDIO is set".into()); @@ -430,6 +440,7 @@ fn output_disabled(var: impl Fn(&str) -> Option<std::ffi::OsString>) -> Option<S } /// An output stream on `device` in its default configuration, whatever its /// sample format: the mixer works in f32 and converts. +#[cfg(feature = "audio")] fn open_device( device: &cpal::Device, mixer: Arc<Mutex<Mixer>>, @@ -450,6 +461,7 @@ fn open_device( stream.play()?; Ok((stream, config)) } +#[cfg(feature = "audio")] fn build_stream<T: cpal::SizedSample + cpal::FromSample<f32>>( device: &cpal::Device, config: &cpal::SupportedStreamConfig, @@ -523,7 +535,12 @@ impl Audio { capture: None, } } - fn open(mixer: Arc<Mutex<Mixer>>) -> Result<cpal::Stream> { + #[cfg(not(feature = "audio"))] + fn open(_: Arc<Mutex<Mixer>>) -> Result<Stream> { + Err("this build has no sound output (built without the `audio` feature)".into()) + } + #[cfg(feature = "audio")] + fn open(mixer: Arc<Mutex<Mixer>>) -> Result<Stream> { if let Some(reason) = output_disabled(|name| std::env::var_os(name)) { return Err(reason.into()); } diff --git a/crates/horizon-client/src/game/pad.rs b/crates/horizon-client/src/game/pad.rs index 216b547b0..9a71bdc75 100644 --- a/crates/horizon-client/src/game/pad.rs +++ b/crates/horizon-client/src/game/pad.rs @@ -6,12 +6,12 @@ use super::{Game, Screen}; use horizon_client::{ Result, - gamepad::{self, Button, Edges, GlyphStyle, HealthWatch, PadState, Rumble, TriggerFeel}, + gamepad::{self, Button, Edges, GlyphStyle, HealthWatch, PadState, Rumble}, keybinds::{KeyBinds, key_code, mouse_button}, mouse::Rotation, }; use serde_json::{Value, json}; -use std::time::{Duration, Instant}; +use std::time::Instant; use winit::{event_loop::ActiveEventLoop, keyboard::KeyCode}; pub(super) const HELP: &[&str] = &[ @@ -25,10 +25,9 @@ pub(super) const HELP: &[&str] = &[ /// The controllers and the state the game last acted on. #[derive(Default)] pub(super) struct Pads { - gilrs: Option<gilrs::Gilrs>, - started: bool, - /// The pad last touched; only its input counts. - active: Option<gilrs::GamepadId>, + /// The real controllers and the DualSense's output. + #[cfg(feature = "controllers")] + devices: hardware::Devices, /// The virtual pad of `horizon-ctl pad`. injected: PadState, /// The virtual pad was in use at the last poll. @@ -48,49 +47,38 @@ pub(super) struct Pads { pub(super) style: GlyphStyle, /// The cursor the pad drives in menus. pub(super) menu: super::pad_menu::MenuCursor, - /// Vibrations playing (an effect stops when dropped) and when they end. - rumbles: Vec<(gilrs::ff::Effect, Instant)>, /// The last vibration asked for, for `pad status`. last_rumble: Option<(&'static str, gamepad::Pulse)>, /// The player's health between polls (a drop is damage taken). health: HealthWatch, - /// The active pad is a DualSense. - dualsense: bool, - /// Its own output over HID (rumble here; gilrs only reads it), started once this window - /// has the pad in hand; dropped, it releases the pad. - output: Option<horizon_dualsense::Link>, - /// Its HD haptics, on USB: looked for once each time the output opens. - haptics: Option<horizon_dualsense::haptics::Haptics>, - haptics_tried: bool, - /// What it was last told to show. - shown: Option<horizon_dualsense::device::State>, } -fn gilrs_button(button: Button) -> gilrs::Button { - use gilrs::Button as G; - match button { - Button::South => G::South, - Button::East => G::East, - Button::West => G::West, - Button::North => G::North, - Button::LeftBumper => G::LeftTrigger, - Button::RightBumper => G::RightTrigger, - Button::LeftTrigger => G::LeftTrigger2, - Button::RightTrigger => G::RightTrigger2, - Button::Select => G::Select, - Button::Start => G::Start, - Button::LeftStick => G::LeftThumb, - Button::RightStick => G::RightThumb, - Button::DPadUp => G::DPadUp, - Button::DPadDown => G::DPadDown, - Button::DPadLeft => G::DPadLeft, - Button::DPadRight => G::DPadRight, +#[cfg(feature = "controllers")] +mod hardware; + +/// A build without the `controllers` feature (the server build, which must not need libudev): no +/// hardware pads, only `horizon-ctl pad`'s virtual one. +#[cfg(not(feature = "controllers"))] +mod hardware { + use super::{super::Game, Pads}; + use horizon_client::gamepad::{PadState, Pulse, Rumble}; + use serde_json::{Value, json}; + + impl Pads { + pub(super) fn read(&mut self) -> PadState { + PadState::default() + } } -} -fn is_dualsense(pad: &gilrs::Gamepad) -> bool { - matches!((pad.vendor_id(), pad.product_id()), - (Some(vendor), Some(product)) if horizon_dualsense::is_dualsense(vendor, product)) + impl Game<'_> { + pub(super) fn pad_output_off(&mut self) {} + pub(super) fn pad_output_frame(&mut self) {} + pub(in crate::game) fn pad_close_output(&mut self) {} + pub(super) fn pad_vibrate(&mut self, _: Rumble, _: Pulse) {} + pub(super) fn pad_devices_status(&self) -> Value { + json!({ "backend": false, "controllers": [] }) + } + } } impl Pads { @@ -99,93 +87,6 @@ impl Pads { pub(super) fn player_replaced(&mut self) { self.health.forget(); } - /// Open gilrs on first use. A platform without it (or a Linux without - /// udev) leaves controllers off; the game runs as before. - fn start(&mut self) { - if self.started { - return; - } - self.started = true; - self.gilrs = match gilrs::Gilrs::new() { - Ok(g) => { - for (_, pad) in g.gamepads() { - log::info!("Controller connected: {}", pad.name()); - } - Some(g) - } - Err(gilrs::Error::NotImplemented(_)) => None, - Err(e) => { - log::warn!("Horizon: controllers are unavailable: {e}"); - None - } - }; - } - - /// Drain gilrs' events and read the active pad. - fn read(&mut self) -> PadState { - let Some(gilrs) = self.gilrs.as_mut() else { - return PadState::default(); - }; - while let Some(gilrs::Event { id, event, .. }) = gilrs.next_event() { - use gilrs::EventType as E; - match event { - E::Connected => { - log::info!("Controller connected: {}", gilrs.gamepad(id).name()); - if let Some(output) = &self.output { - output.scan(); - } - } - E::Disconnected => { - log::info!("Controller disconnected: {}", gilrs.gamepad(id).name()); - if self.active == Some(id) { - self.active = None; - } - if let Some(output) = &self.output { - output.scan(); - } - } - E::ButtonPressed(..) => self.active = Some(id), - E::AxisChanged(_, value, _) | E::ButtonChanged(_, value, _) - if value.abs() > 0.5 => - { - self.active = Some(id) - } - _ => {} - } - } - let Some(pad) = self.active.and_then(|id| gilrs.connected_gamepad(id)) else { - // Before any pad is touched (the virtual pad playing), a DualSense still shows it. - self.dualsense = gilrs.gamepads().any(|(_, pad)| is_dualsense(&pad)); - return PadState::default(); - }; - self.style = GlyphStyle::of_vendor(pad.vendor_id()); - self.dualsense = is_dualsense(&pad); - let mut state = PadState::default(); - for button in Button::ALL { - if !matches!(button, Button::LeftTrigger | Button::RightTrigger) { - state.set(button, pad.is_pressed(gilrs_button(button))); - } - } - let axis = |a| pad.value(a); - use gilrs::Axis as A; - state.left = [axis(A::LeftStickX), axis(A::LeftStickY)]; - state.right = [axis(A::RightStickX), axis(A::RightStickY)]; - // Triggers arrive as analog buttons on most mappings, as plain - // buttons on some. - let trigger = |b: gilrs::Button| { - let value = pad.button_data(b).map_or(0.0, |d| d.value()); - if pad.is_pressed(b) { - value.max(1.0) - } else { - value - } - }; - state.triggers = [ - trigger(gilrs::Button::LeftTrigger2), - trigger(gilrs::Button::RightTrigger2), - ]; - state - } } impl Game<'_> { @@ -193,9 +94,7 @@ impl Game<'_> { pub(super) fn poll_pads(&mut self, event_loop: &ActiveEventLoop) { let settings = &self.settings.controller; if !settings.enabled { - // Dropping the output frees the triggers. - self.pad.output = None; - self.pad.shown = None; + self.pad_output_off(); if self.pad.state != PadState::default() { self.pad.state = PadState::default(); for (button, down) in self.pad.edges.release_all() { @@ -204,7 +103,6 @@ impl Game<'_> { } return; } - self.pad.start(); let hardware = self.pad.read(); self.ui.options.pad_style = self.settings.controller.glyphs.resolve(self.pad.style); let state = hardware.merge(&self.pad.injected); @@ -219,11 +117,7 @@ impl Game<'_> { self.pad.in_use = true; } self.pad.state = state; - if self.pad.dualsense && self.pad.in_use && self.focused && self.pad.output.is_none() { - self.pad.output = Some(horizon_dualsense::Link::start()); - } - self.pad_haptics(); - self.pad_show(); + self.pad_output_frame(); // Damage from any source, here or on a server; nothing counts on // the title screen. let health = self @@ -234,8 +128,6 @@ impl Game<'_> { if let Some(damage) = self.pad.health.observe(health) { self.pad_rumble(Rumble::Hurt(damage)); } - let now = Instant::now(); - self.pad.rumbles.retain(|(_, end)| *end > now); let ticking = self.title.is_none() && self.screen == Screen::Playing && !self.pause; for button in std::mem::take(&mut self.pad.late_releases) { if !ticking || self.pad.pressed_at[button as usize] != Some(self.ticks) { @@ -404,150 +296,8 @@ impl Game<'_> { self.pitch = rotation.x_rot; } - /// The DualSense's HID output, while it is the active pad, open, and this window has focus - /// (another game on the same pad keeps it otherwise). - fn pad_output(&self) -> Option<&horizon_dualsense::Link> { - let output = self.pad.output.as_ref()?; - (self.pad.dualsense && self.focused && output.open().is_some()).then_some(output) - } - - /// What the DualSense shows: while playing, its triggers feel what their actions do; in - /// menus, paused, unfocused or with another pad active, they are free. - fn pad_show(&mut self) { - if self.pad.output.is_none() { - return; - } - let playing = self.pad.dualsense - && self.focused - && self.title.is_none() - && self.screen == Screen::Playing - && !self.pause; - let (using, attacking) = if playing { - self.trigger_feels() - } else { - (TriggerFeel::Free, TriggerFeel::Free) - }; - // The lightbar follows the player; menus keep the last colour. - let in_world = self.title.is_none(); - let lightbar = match self.player.as_mut().filter(|_| in_world) { - Some(p) => { - let max = p.attribute("minecraft:max_health").unwrap_or(20.0) as f32; - let health = p.health.health() / max.max(1.0); - self.settings - .controller - .lightbar - .colour(health, self.dim.id()) - } - None => self.pad.shown.and_then(|s| s.lightbar), - }; - let lights = self.settings.controller.lightbar != gamepad::Lightbar::Off; - let state = horizon_dualsense::device::State { - triggers: self.settings.controller.trigger_effects(using, attacking), - lightbar: lightbar.filter(|_| lights), - player_leds: lights.then_some(horizon_dualsense::PLAYER_1), - }; - if self.pad.shown != Some(state) - && let Some(output) = &self.pad.output - { - output.set(state); - self.pad.shown = Some(state); - } - } - - /// What `key.use` and `key.attack` are doing, for the triggers bound to them. - fn trigger_feels(&self) -> (TriggerFeel, TriggerFeel) { - let using = match self.using { - Some((slot, ticks)) => match self.stack_in(slot) { - Some(s) if &*s.item == "minecraft:bow" => { - TriggerFeel::Draw(gamepad::bow_power(ticks)) - } - // TridentItem.THROW_THRESHOLD_TIME. - Some(s) if &*s.item == "minecraft:trident" => { - TriggerFeel::Draw(ticks as f32 / 10.0) - } - Some(s) if &*s.item == "minecraft:crossbow" => { - TriggerFeel::Draw(ticks as f32 / Self::charge_ticks(s).max(1) as f32) - } - Some(s) if self.blocks_attacks(s).is_some() => TriggerFeel::Brace, - _ => TriggerFeel::Free, - }, - None => self.idle_use_feel(), - }; - // Creative breaks at once; blocks that can't be broken have a negative hardness. - let attacking = match &self.mining { - Some(m) if !self.creative => { - let state = self.world.block(m.pos[0], m.pos[1], m.pos[2]); - TriggerFeel::Texture(self.res.facts().get(state).hardness) - } - _ => TriggerFeel::Free, - }; - (using, attacking) - } - - /// The use trigger while nothing is in use: a loaded crossbow clicks, an item that boosts (a - /// rocket while gliding, the stick of the mount being ridden) catches, a shield weighs, and - /// locks while an axe has disabled it. - fn idle_use_feel(&self) -> TriggerFeel { - let gliding = self.player.as_ref().is_some_and(|p| p.fall_flying); - let mount = self - .riding - .and_then(|id| self.mobs.iter().find(|m| m.id == id)); - let mount = mount.map_or("", |m| m.kind.id.as_str()); - let feel = |stack: Option<&horizon_client::items::ItemStack>| match stack - .map(|s| (s, &*s.item)) - { - Some((s, "minecraft:crossbow")) if s.data().is_some_and(|d| !d.charged.is_empty()) => { - TriggerFeel::Click - } - Some((_, "minecraft:firework_rocket")) if gliding => TriggerFeel::Boost, - Some((_, "minecraft:carrot_on_a_stick")) if mount == "minecraft:pig" => { - TriggerFeel::Boost - } - Some((_, "minecraft:warped_fungus_on_a_stick")) if mount == "minecraft:strider" => { - TriggerFeel::Boost - } - Some((s, _)) if self.blocks_attacks(s).is_some() => match self.shield_cooldown { - 0 => TriggerFeel::Brace, - _ => TriggerFeel::Locked, - }, - _ => TriggerFeel::Free, - }; - // Use tries the main hand first. - match feel(self.stack_in(self.selected)) { - TriggerFeel::Free => feel(self.offhand.as_ref()), - main => main, - } - } - - /// Open the pad's haptics once its output is open over USB (its audio device is there - /// only then); close them when it goes. Opt-in with `HORIZON_DUALSENSE_HAPTICS=1` until - /// they are proven on a pad (docs/controllers.md); never for games without sound (tests). - fn pad_haptics(&mut self) { - let usb = self.pad.output.as_ref().and_then(|o| o.open()) - == Some(horizon_dualsense::Transport::Usb); - if !usb { - self.pad.haptics = None; - self.pad.haptics_tried = false; - } else if !self.pad.haptics_tried { - self.pad.haptics_tried = true; - if std::env::var_os("HORIZON_DUALSENSE_HAPTICS").is_some_and(|v| v == "1") - && std::env::var_os("HORIZON_NO_AUDIO").is_none() - { - self.pad.haptics = horizon_dualsense::haptics::Haptics::open(); - } - } - } - - /// Release the DualSense's output (the game is quitting). - pub(super) fn pad_close_output(&mut self) { - self.pad.haptics = None; - self.pad.output = None; - } - /// Vibrate the active pad, when vibration is on and the pad is the one - /// playing (a pad lying idle while the mouse plays stays still): a - /// DualSense through its own report, else gilrs' force feedback, which - /// platforms without it (gilrs on macOS) skip. + /// playing (a pad lying idle while the mouse plays stays still). pub(super) fn pad_rumble(&mut self, rumble: Rumble) { let settings = &self.settings.controller; if !settings.enabled || !settings.vibration || !self.pad.in_use { @@ -557,68 +307,7 @@ impl Game<'_> { return; }; self.pad.last_rumble = Some((rumble.name(), pulse)); - let level = |v: f32| (v.clamp(0.0, 1.0) * 255.0).round() as u8; - if let Some(haptics) = self - .pad - .haptics - .as_ref() - .filter(|_| self.pad_output().is_some()) - { - let steps = rumble.shape().into_iter().map(|step| { - ( - step.strong, - step.weak, - Duration::from_millis(u64::from(step.millis)), - ) - }); - haptics.play(&steps.collect::<Vec<_>>()); - return; - } - if let Some(output) = self.pad_output() { - let steps = rumble.shape().into_iter().map(|step| { - let length = Duration::from_millis(u64::from(step.millis)); - ([level(step.strong), level(step.weak)], length) - }); - output.rumble(steps.collect()); - return; - } - let (Some(gilrs), Some(id)) = (self.pad.gilrs.as_mut(), self.pad.active) else { - return; - }; - if !gilrs - .connected_gamepad(id) - .is_some_and(|g| g.is_ff_supported()) - { - return; - } - use gilrs::ff::{BaseEffect, BaseEffectType, EffectBuilder, Repeat, Replay, Ticks}; - let length = Ticks::from_ms(pulse.millis); - let motor = |kind| BaseEffect { - kind, - scheduling: Replay { - play_for: length, - ..Default::default() - }, - envelope: Default::default(), - }; - let magnitude = |v: f32| (v.clamp(0.0, 1.0) * f32::from(u16::MAX)) as u16; - let effect = EffectBuilder::new() - .add_effect(motor(BaseEffectType::Strong { - magnitude: magnitude(pulse.strong), - })) - .add_effect(motor(BaseEffectType::Weak { - magnitude: magnitude(pulse.weak), - })) - .repeat(Repeat::For(length)) - .gamepads(&[id]) - .finish(gilrs); - match effect.and_then(|e| e.play().map(|()| e)) { - Ok(effect) => { - let end = Instant::now() + Duration::from_millis(u64::from(pulse.millis) + 50); - self.pad.rumbles.push((effect, end)); - } - Err(e) => log::debug!("Horizon: controller vibration: {e}"), - } + self.pad_vibrate(rumble, pulse); } /// `horizon-ctl pad ...`. @@ -639,32 +328,15 @@ impl Game<'_> { }; match arg(1)? { "status" => { - let pads: Vec<Value> = self.pad.gilrs.as_ref().map_or(Vec::new(), |g| { - g.gamepads() - .map(|(id, p)| { - json!({ - "name": p.name(), - "vendor": p.vendor_id(), - "product": p.product_id(), - "active": self.pad.active == Some(id), - }) - }) - .collect() - }); let s = &self.pad.state; let held: Vec<&str> = Button::ALL .into_iter() .filter(|b| self.pad.edges.is_held(*b)) .map(Button::name) .collect(); - Ok(json!({ + let mut status = json!({ "enabled": self.settings.controller.enabled, - "backend": self.pad.gilrs.is_some(), - "controllers": pads, "glyphs": self.pad.style.name(), - "dualsense_output": self.pad.output.as_ref().and_then(|o| o.open()) - .map(|t| format!("{t:?}")), - "trigger_effects": self.pad.shown.map(|s| s.triggers), "last_rumble": self.pad.last_rumble.map(|(why, p)| json!({ "reason": why, "strong": p.strong, "weak": p.weak, "ms": p.millis, })), @@ -674,7 +346,13 @@ impl Game<'_> { "left": s.left, "right": s.right, "triggers": s.triggers, - })) + }); + if let (Some(status), Value::Object(devices)) = + (status.as_object_mut(), self.pad_devices_status()) + { + status.extend(devices); + } + Ok(status) } "release" => { self.pad.injected = PadState::default(); diff --git a/crates/horizon-client/src/game/pad/hardware.rs b/crates/horizon-client/src/game/pad/hardware.rs new file mode 100644 index 000000000..b464ef3ee --- /dev/null +++ b/crates/horizon-client/src/game/pad/hardware.rs @@ -0,0 +1,409 @@ +//! The real controllers (the `controllers` feature): gilrs' pads, and the DualSense's own output +//! over HID: its rumble, adaptive triggers, lights and HD haptics. A build without the feature (the +//! server build) has the stub in pad.rs instead, and only `horizon-ctl pad`'s virtual pad. +use super::{ + super::{Game, Screen}, + Pads, +}; +use horizon_client::gamepad::{self, Button, GlyphStyle, PadState, Rumble, TriggerFeel}; +use serde_json::{Value, json}; +use std::time::{Duration, Instant}; + +/// The controllers gilrs sees and the DualSense's output. +#[derive(Default)] +pub(super) struct Devices { + gilrs: Option<gilrs::Gilrs>, + started: bool, + /// The pad last touched; only its input counts. + active: Option<gilrs::GamepadId>, + /// Vibrations playing (an effect stops when dropped) and when they end. + rumbles: Vec<(gilrs::ff::Effect, Instant)>, + /// The active pad is a DualSense. + dualsense: bool, + /// Its own output over HID (rumble here; gilrs only reads it), started once this window + /// has the pad in hand; dropped, it releases the pad. + output: Option<horizon_dualsense::Link>, + /// Its HD haptics, on USB: looked for once each time the output opens. + haptics: Option<horizon_dualsense::haptics::Haptics>, + haptics_tried: bool, + /// What it was last told to show. + shown: Option<horizon_dualsense::device::State>, +} + +fn gilrs_button(button: Button) -> gilrs::Button { + use gilrs::Button as G; + match button { + Button::South => G::South, + Button::East => G::East, + Button::West => G::West, + Button::North => G::North, + Button::LeftBumper => G::LeftTrigger, + Button::RightBumper => G::RightTrigger, + Button::LeftTrigger => G::LeftTrigger2, + Button::RightTrigger => G::RightTrigger2, + Button::Select => G::Select, + Button::Start => G::Start, + Button::LeftStick => G::LeftThumb, + Button::RightStick => G::RightThumb, + Button::DPadUp => G::DPadUp, + Button::DPadDown => G::DPadDown, + Button::DPadLeft => G::DPadLeft, + Button::DPadRight => G::DPadRight, + } +} + +fn is_dualsense(pad: &gilrs::Gamepad) -> bool { + matches!((pad.vendor_id(), pad.product_id()), + (Some(vendor), Some(product)) if horizon_dualsense::is_dualsense(vendor, product)) +} + +impl Pads { + /// Open gilrs on first use. A platform without it (or a Linux without + /// udev) leaves controllers off; the game runs as before. + fn start(&mut self) { + if self.devices.started { + return; + } + self.devices.started = true; + self.devices.gilrs = match gilrs::Gilrs::new() { + Ok(g) => { + for (_, pad) in g.gamepads() { + log::info!("Controller connected: {}", pad.name()); + } + Some(g) + } + Err(gilrs::Error::NotImplemented(_)) => None, + Err(e) => { + log::warn!("Horizon: controllers are unavailable: {e}"); + None + } + }; + } + + /// Drain gilrs' events and read the active pad (opening gilrs the first time). + pub(super) fn read(&mut self) -> PadState { + self.start(); + let Some(gilrs) = self.devices.gilrs.as_mut() else { + return PadState::default(); + }; + while let Some(gilrs::Event { id, event, .. }) = gilrs.next_event() { + use gilrs::EventType as E; + match event { + E::Connected => { + log::info!("Controller connected: {}", gilrs.gamepad(id).name()); + if let Some(output) = &self.devices.output { + output.scan(); + } + } + E::Disconnected => { + log::info!("Controller disconnected: {}", gilrs.gamepad(id).name()); + if self.devices.active == Some(id) { + self.devices.active = None; + } + if let Some(output) = &self.devices.output { + output.scan(); + } + } + E::ButtonPressed(..) => self.devices.active = Some(id), + E::AxisChanged(_, value, _) | E::ButtonChanged(_, value, _) + if value.abs() > 0.5 => + { + self.devices.active = Some(id) + } + _ => {} + } + } + let Some(pad) = self + .devices + .active + .and_then(|id| gilrs.connected_gamepad(id)) + else { + // Before any pad is touched (the virtual pad playing), a DualSense still shows it. + self.devices.dualsense = gilrs.gamepads().any(|(_, pad)| is_dualsense(&pad)); + return PadState::default(); + }; + self.style = GlyphStyle::of_vendor(pad.vendor_id()); + self.devices.dualsense = is_dualsense(&pad); + let mut state = PadState::default(); + for button in Button::ALL { + if !matches!(button, Button::LeftTrigger | Button::RightTrigger) { + state.set(button, pad.is_pressed(gilrs_button(button))); + } + } + let axis = |a| pad.value(a); + use gilrs::Axis as A; + state.left = [axis(A::LeftStickX), axis(A::LeftStickY)]; + state.right = [axis(A::RightStickX), axis(A::RightStickY)]; + // Triggers arrive as analog buttons on most mappings, as plain + // buttons on some. + let trigger = |b: gilrs::Button| { + let value = pad.button_data(b).map_or(0.0, |d| d.value()); + if pad.is_pressed(b) { + value.max(1.0) + } else { + value + } + }; + state.triggers = [ + trigger(gilrs::Button::LeftTrigger2), + trigger(gilrs::Button::RightTrigger2), + ]; + state + } +} + +impl Game<'_> { + /// Controllers are turned off: dropping the DualSense's output frees its triggers. + pub(super) fn pad_output_off(&mut self) { + self.pad.devices.output = None; + self.pad.devices.shown = None; + } + + /// After each poll: the DualSense's output opens once this window has the pad in hand, then + /// shows what the game is doing; vibrations that are over stop. + pub(super) fn pad_output_frame(&mut self) { + if self.pad.devices.dualsense + && self.pad.in_use + && self.focused + && self.pad.devices.output.is_none() + { + self.pad.devices.output = Some(horizon_dualsense::Link::start()); + } + self.pad_haptics(); + self.pad_show(); + let now = Instant::now(); + self.pad.devices.rumbles.retain(|(_, end)| *end > now); + } + + /// The DualSense's HID output, while it is the active pad, open, and this window has focus + /// (another game on the same pad keeps it otherwise). + fn pad_output(&self) -> Option<&horizon_dualsense::Link> { + let output = self.pad.devices.output.as_ref()?; + (self.pad.devices.dualsense && self.focused && output.open().is_some()).then_some(output) + } + + /// What the DualSense shows: while playing, its triggers feel what their actions do; in + /// menus, paused, unfocused or with another pad active, they are free. + fn pad_show(&mut self) { + if self.pad.devices.output.is_none() { + return; + } + let playing = self.pad.devices.dualsense + && self.focused + && self.title.is_none() + && self.screen == Screen::Playing + && !self.pause; + let (using, attacking) = if playing { + self.trigger_feels() + } else { + (TriggerFeel::Free, TriggerFeel::Free) + }; + // The lightbar follows the player; menus keep the last colour. + let in_world = self.title.is_none(); + let lightbar = match self.player.as_mut().filter(|_| in_world) { + Some(p) => { + let max = p.attribute("minecraft:max_health").unwrap_or(20.0) as f32; + let health = p.health.health() / max.max(1.0); + self.settings + .controller + .lightbar + .colour(health, self.dim.id()) + } + None => self.pad.devices.shown.and_then(|s| s.lightbar), + }; + let lights = self.settings.controller.lightbar != gamepad::Lightbar::Off; + let state = horizon_dualsense::device::State { + triggers: self.settings.controller.trigger_effects(using, attacking), + lightbar: lightbar.filter(|_| lights), + player_leds: lights.then_some(horizon_dualsense::PLAYER_1), + }; + if self.pad.devices.shown != Some(state) + && let Some(output) = &self.pad.devices.output + { + output.set(state); + self.pad.devices.shown = Some(state); + } + } + + /// What `key.use` and `key.attack` are doing, for the triggers bound to them. + fn trigger_feels(&self) -> (TriggerFeel, TriggerFeel) { + let using = match self.using { + Some((slot, ticks)) => match self.stack_in(slot) { + Some(s) if &*s.item == "minecraft:bow" => { + TriggerFeel::Draw(gamepad::bow_power(ticks)) + } + // TridentItem.THROW_THRESHOLD_TIME. + Some(s) if &*s.item == "minecraft:trident" => { + TriggerFeel::Draw(ticks as f32 / 10.0) + } + Some(s) if &*s.item == "minecraft:crossbow" => { + TriggerFeel::Draw(ticks as f32 / Self::charge_ticks(s).max(1) as f32) + } + Some(s) if self.blocks_attacks(s).is_some() => TriggerFeel::Brace, + _ => TriggerFeel::Free, + }, + None => self.idle_use_feel(), + }; + // Creative breaks at once; blocks that can't be broken have a negative hardness. + let attacking = match &self.mining { + Some(m) if !self.creative => { + let state = self.world.block(m.pos[0], m.pos[1], m.pos[2]); + TriggerFeel::Texture(self.res.facts().get(state).hardness) + } + _ => TriggerFeel::Free, + }; + (using, attacking) + } + + /// The use trigger while nothing is in use: a loaded crossbow clicks, an item that boosts (a + /// rocket while gliding, the stick of the mount being ridden) catches, a shield weighs, and + /// locks while an axe has disabled it. + fn idle_use_feel(&self) -> TriggerFeel { + let gliding = self.player.as_ref().is_some_and(|p| p.fall_flying); + let mount = self + .riding + .and_then(|id| self.mobs.iter().find(|m| m.id == id)); + let mount = mount.map_or("", |m| m.kind.id.as_str()); + let feel = |stack: Option<&horizon_client::items::ItemStack>| match stack + .map(|s| (s, &*s.item)) + { + Some((s, "minecraft:crossbow")) if s.data().is_some_and(|d| !d.charged.is_empty()) => { + TriggerFeel::Click + } + Some((_, "minecraft:firework_rocket")) if gliding => TriggerFeel::Boost, + Some((_, "minecraft:carrot_on_a_stick")) if mount == "minecraft:pig" => { + TriggerFeel::Boost + } + Some((_, "minecraft:warped_fungus_on_a_stick")) if mount == "minecraft:strider" => { + TriggerFeel::Boost + } + Some((s, _)) if self.blocks_attacks(s).is_some() => match self.shield_cooldown { + 0 => TriggerFeel::Brace, + _ => TriggerFeel::Locked, + }, + _ => TriggerFeel::Free, + }; + // Use tries the main hand first. + match feel(self.stack_in(self.selected)) { + TriggerFeel::Free => feel(self.offhand.as_ref()), + main => main, + } + } + + /// Open the pad's haptics once its output is open over USB (its audio device is there + /// only then); close them when it goes. Opt-in with `HORIZON_DUALSENSE_HAPTICS=1` until + /// they are proven on a pad (docs/controllers.md); never for games without sound (tests). + fn pad_haptics(&mut self) { + let usb = self.pad.devices.output.as_ref().and_then(|o| o.open()) + == Some(horizon_dualsense::Transport::Usb); + if !usb { + self.pad.devices.haptics = None; + self.pad.devices.haptics_tried = false; + } else if !self.pad.devices.haptics_tried { + self.pad.devices.haptics_tried = true; + if std::env::var_os("HORIZON_DUALSENSE_HAPTICS").is_some_and(|v| v == "1") + && std::env::var_os("HORIZON_NO_AUDIO").is_none() + { + self.pad.devices.haptics = horizon_dualsense::haptics::Haptics::open(); + } + } + } + + /// Release the DualSense's output (the game is quitting). + pub(in crate::game) fn pad_close_output(&mut self) { + self.pad.devices.haptics = None; + self.pad.devices.output = None; + } + + /// Play a vibration on the active pad: a DualSense through its own report, else gilrs' force + /// feedback, which platforms without it (gilrs on macOS) skip. + pub(super) fn pad_vibrate(&mut self, rumble: Rumble, pulse: gamepad::Pulse) { + let level = |v: f32| (v.clamp(0.0, 1.0) * 255.0).round() as u8; + if let Some(haptics) = self + .pad + .devices + .haptics + .as_ref() + .filter(|_| self.pad_output().is_some()) + { + let steps = rumble.shape().into_iter().map(|step| { + ( + step.strong, + step.weak, + Duration::from_millis(u64::from(step.millis)), + ) + }); + haptics.play(&steps.collect::<Vec<_>>()); + return; + } + if let Some(output) = self.pad_output() { + let steps = rumble.shape().into_iter().map(|step| { + let length = Duration::from_millis(u64::from(step.millis)); + ([level(step.strong), level(step.weak)], length) + }); + output.rumble(steps.collect()); + return; + } + let (Some(gilrs), Some(id)) = (self.pad.devices.gilrs.as_mut(), self.pad.devices.active) + else { + return; + }; + if !gilrs + .connected_gamepad(id) + .is_some_and(|g| g.is_ff_supported()) + { + return; + } + use gilrs::ff::{BaseEffect, BaseEffectType, EffectBuilder, Repeat, Replay, Ticks}; + let length = Ticks::from_ms(pulse.millis); + let motor = |kind| BaseEffect { + kind, + scheduling: Replay { + play_for: length, + ..Default::default() + }, + envelope: Default::default(), + }; + let magnitude = |v: f32| (v.clamp(0.0, 1.0) * f32::from(u16::MAX)) as u16; + let effect = EffectBuilder::new() + .add_effect(motor(BaseEffectType::Strong { + magnitude: magnitude(pulse.strong), + })) + .add_effect(motor(BaseEffectType::Weak { + magnitude: magnitude(pulse.weak), + })) + .repeat(Repeat::For(length)) + .gamepads(&[id]) + .finish(gilrs); + match effect.and_then(|e| e.play().map(|()| e)) { + Ok(effect) => { + let end = Instant::now() + Duration::from_millis(u64::from(pulse.millis) + 50); + self.pad.devices.rumbles.push((effect, end)); + } + Err(e) => log::debug!("Horizon: controller vibration: {e}"), + } + } + + /// The hardware part of `pad status`. + pub(super) fn pad_devices_status(&self) -> Value { + let devices = &self.pad.devices; + let pads: Vec<Value> = devices.gilrs.as_ref().map_or(Vec::new(), |g| { + g.gamepads() + .map(|(id, p)| { + json!({ + "name": p.name(), + "vendor": p.vendor_id(), + "product": p.product_id(), + "active": devices.active == Some(id), + }) + }) + .collect() + }); + json!({ + "backend": devices.gilrs.is_some(), + "controllers": pads, + "dualsense_output": devices.output.as_ref().and_then(|o| o.open()).map(|t| format!("{t:?}")), + "trigger_effects": devices.shown.map(|s| s.triggers), + }) + } +} diff --git a/crates/horizon-client/src/gamepad.rs b/crates/horizon-client/src/gamepad.rs index a250f5e8c..220f74a5b 100644 --- a/crates/horizon-client/src/gamepad.rs +++ b/crates/horizon-client/src/gamepad.rs @@ -1009,6 +1009,7 @@ pub enum TriggerFeel { /// Mining a block of this hardness: a buzz, stronger and slower on harder blocks. Texture(f32), } +#[cfg(feature = "controllers")] impl TriggerFeel { /// The effect, for a trigger that presses its action at `threshold` (0..1) of its travel. pub fn effect(self, threshold: f32) -> horizon_dualsense::TriggerEffect { @@ -1044,6 +1045,7 @@ impl TriggerFeel { } } } +#[cfg(feature = "controllers")] impl PadSettings { /// The left and right triggers' effects: each feels the action bound to it, `key.use` or /// `key.attack`. @@ -1404,6 +1406,7 @@ mod tests { assert_eq!(w.observe(Some(1.0)), Some(1.0)); } + #[cfg(feature = "controllers")] #[test] fn triggers_feel_their_action() { use horizon_dualsense::{TRIGGER_OFF, trigger}; diff --git a/crates/horizon-server/src/engine.rs b/crates/horizon-server/src/engine.rs index d1373bb05..aa83693cb 100644 --- a/crates/horizon-server/src/engine.rs +++ b/crates/horizon-server/src/engine.rs @@ -11,7 +11,9 @@ use std::{ time::Duration, }; -/// The game's program names, most specific first: a headless engine once there is one, else the game. +/// The game's program names, most specific first: the server build (the game without sound or +/// controllers, so it needs neither ALSA nor udev on Linux; `horizon-server-linux-x86_64.tar.gz` holds it), +/// else the full game. const PROGRAMS: [&str; 2] = ["horizon-engine", "horizon-client"]; fn exe(name: &str) -> String { @@ -50,8 +52,8 @@ pub fn program(config: &Config, dir: &Path) -> Result<PathBuf, String> { } /// Checks that the game program starts at all: `--help` loads no game files, so it fails only when the -/// system can't load the program, as on a Linux without the ALSA and udev libraries it links (even a -/// server needs them until there is a headless engine). The reason, with what to install. +/// system can't load the program, as on a Linux without the ALSA and udev libraries the full game links +/// (the server build doesn't). The reason, with what to install. pub fn check_starts(program: &Path) -> Result<(), String> { let output = Command::new(program) .arg("--help") @@ -84,10 +86,13 @@ fn start_failure(program: &Path, code: Option<i32>, stderr: &str) -> String { format!(": {reason}") } ); - if reason.contains("error while loading shared libraries") { + if reason.contains("error while loading shared libraries") + && (reason.contains("libasound") || reason.contains("libudev")) + { text.push_str( - "\nIt needs ALSA's and udev's libraries (libasound.so.2, libudev.so.1), even on a server. Install \ - them:\n Debian, Ubuntu: sudo apt install libasound2 libudev1 (Ubuntu 24.04 and later: \ + "\nThe full game needs ALSA's and udev's libraries (libasound.so.2, libudev.so.1). Install the \ + server build, which needs neither (packaging/server/install.sh picks it on Linux), or the \ + libraries:\n Debian, Ubuntu: sudo apt install libasound2 libudev1 (Ubuntu 24.04 and later: \ libasound2t64)\n Fedora, RHEL: sudo dnf install alsa-lib systemd-libs\n Arch: sudo pacman -S \ alsa-lib systemd-libs\n NixOS: enable programs.nix-ld with alsa-lib and udev in its libraries", ); @@ -256,6 +261,14 @@ mod tests { error while loading shared libraries: libasound.so.2" )); assert!(text.contains("sudo apt install libasound2 libudev1")); + // Another library: no ALSA advice (the server build, horizon-engine, links neither). + let engine = start_failure( + Path::new("/opt/horizon/horizon-engine"), + Some(127), + "/opt/horizon/horizon-engine: error while loading shared libraries: libgcc_s.so.1: cannot open \ + shared object file: No such file or directory\n", + ); + assert!(!engine.contains("libasound"), "{engine}"); let other = start_failure(program, Some(1), "something else\n"); assert_eq!( other, diff --git a/docs/release-flow.md b/docs/release-flow.md index f1015a31f..b72d896b8 100644 --- a/docs/release-flow.md +++ b/docs/release-flow.md @@ -131,6 +131,7 @@ the notes. | Archive | Runs on | Checks | | --- | --- | --- | | `horizon-linux-x86_64.tar.gz` | GitHub `ubuntu-22.04` (an older glibc, so it runs on any recent distribution) | the standard loader and libraries only (`tools/check_imports.py`) | +| `horizon-server-linux-x86_64.tar.gz` | the same Linux job, after the client archive: `horizon-server`, `horizon-prepare` and the game built with `--no-default-features` as `horizon-engine` (docs/server.md) | as above, and neither `libasound.so.2` nor `libudev.so.1` (`tools/check_imports.py --server`) | | `horizon-windows-x64.zip` | GitHub `windows-latest`, C runtime linked in | system DLLs only (`tools/check_imports.py`) | | `horizon-macos-arm64.zip` | The Mac mini's runner (`vars.MAC_RUNNER=macos-latest` sends it to GitHub) | system libraries only (`otool -L`); a 1500-frame offscreen run of a new world (about 12 s; 300 frames end before the world has loaded) with resources prepared from the runner's own Minecraft (`--offscreen --world smoke --frames 1500 --smoke-report`: frames drawn, chunks generated and meshed, a player, no error) | diff --git a/docs/server.md b/docs/server.md index 923eddf2c..015ded555 100644 --- a/docs/server.md +++ b/docs/server.md @@ -55,9 +55,10 @@ distance 10. The vanilla server was the pinned 26.3 `server.jar` on Java 25 with | What has to be installed | one 46.8 MB binary + 589 MB of prepared resources | Java 25 + the 62 MB jar | | Crates linked | 384 (wgpu, winit, cpal, gilrs, arboard, naga…) | n/a | -On Linux the binary loads `libasound.so.2` (cpal) and `libudev.so.1` (gilrs) at startup, even on a server. -wgpu, winit and the Wayland/X11 libraries are loaded only when a window opens. That makes a minimal -container image need ALSA and udev for a program that never plays a sound or reads a controller. +On Linux the full game loads `libasound.so.2` (cpal) and `libudev.so.1` (gilrs) at startup. wgpu, winit +and the Wayland/X11 libraries are loaded only when a window opens. The server build (`horizon-engine`, +section 3) is the same program built without its `audio` and `controllers` features, so it needs neither +library, and a minimal server image runs it as it is. The two clear losses are RAM and idle CPU. The dedicated server loads everything the client needs to draw (the HUD atlas, item renderer, block-entity models, panorama, fog and music tables, entity models), and it @@ -145,16 +146,22 @@ game built in `Game::new`, the integrated server on its own thread. On that base 1. The dedicated path skips everything only a window uses: the HUD atlas, item renderer, block-entity and entity models, panorama, fog, music, and mesh tables (perf-ticks-2 already stops server-side meshing). This is the RAM and start-time item. -2. The game moves into a library crate, with the window, audio and controller parts behind a `client` - feature. A `horizon-engine` binary built without that feature links no wgpu, winit, cpal or gilrs, and - needs neither ALSA nor udev. The supervisor finds it beside itself and falls back to `horizon-client`. +2. The game moves into a library crate, with the window parts behind a `client` feature, so + `horizon-engine` links no wgpu or winit either. Sound and controllers are already optional (the + `audio` and `controllers` features, on by default): `horizon-engine` today is the game built without + them (section 3). ## 3. Packaging -**Binaries.** The release archives already hold `horizon-client`, `horizon-ctl` and `horizon-prepare`. -`horizon-server` joins them (PR 3: `xtask package` and `release.yml` build it and check it starts). Once -`horizon-engine` exists (section 2), a separate small archive per platform -(`horizon-server-<os>-<arch>.tar.gz` or `.zip`) holds just the server's binaries. +**Binaries.** The release archives hold `horizon-client`, `horizon-ctl`, `horizon-prepare` and +`horizon-server`. On Linux the release also has `horizon-server-linux-x86_64.tar.gz`: `horizon-server`, +`horizon-prepare` and `horizon-engine`, the game built with `--no-default-features` (no sound, no +controllers), which links neither `libasound.so.2` nor `libudev.so.1`. `release.yml` builds it after the +client archive (`xtask package-server`) and fails if `tools/check_imports.py --server` finds either library; +CI lints the same build. `horizon-server` runs `horizon-engine` when it is beside it or on the PATH, else +`horizon-client`. Build it yourself with `cargo build --release -p horizon-client --no-default-features` +and copy `target/release/horizon-client` as `horizon-engine`. macOS and Windows have no such libraries to +avoid, so they keep the one archive. **Game files: the owner's own copy, as with `prepare`.** Nothing of Mojang's is redistributed and nothing is downloaded on the owner's behalf. `horizon-server` looks for prepared resources in this order: @@ -181,15 +188,16 @@ comes out of the headless-engine work. - Linux and macOS: `curl -fsSL https://raw.githubusercontent.com/ludovic111/horizon/main/packaging/server/install.sh | sh` - The script picks the release archive for the OS and architecture (Linux x86_64, macOS arm64), downloads - it from GitHub Releases, and checks it against the SHA-256 GitHub publishes for each asset. It never asks - for sudo. Options: `--version vX.Y.Z`, `--dir` (default `~/.local/share/horizon`), `--bin` (default - `~/.local/bin`). - On Linux the game links ALSA's and udev's libraries (`libasound.so.2`, `libudev.so.1`) even as a server, - until the headless engine exists. Minimal server images often lack ALSA (Debian and Ubuntu: - `sudo apt install libasound2 libudev1`, `libasound2t64` on Ubuntu 24.04 and later). The script lists any - that are missing, `init` warns, and `run` stops at once with what to install, rather than restarting a - game that can't load. + The script picks the release archive for the OS and architecture (on Linux x86_64 the server archive, + on macOS arm64 the game's), downloads it from GitHub Releases, and checks it against the SHA-256 GitHub + publishes for each asset. It never asks for sudo. Options: `--version vX.Y.Z`, `--dir` (default + `~/.local/share/horizon`), `--bin` (default `~/.local/bin`), and `--archive FILE` to install an archive + already on the machine (a build of your own; no download and no checksum). + A Linux release from before the server archive installs the full game, which links ALSA's and udev's + libraries (`libasound.so.2`, `libudev.so.1`); minimal server images often lack them (Debian and Ubuntu: + `sudo apt install libasound2 libudev1`, `libasound2t64` on Ubuntu 24.04 and later). Then the script lists + any that are missing, `init` warns, and `run` stops at once with what to install, rather than restarting + a game that can't load. - Windows: `irm https://raw.githubusercontent.com/ludovic111/horizon/main/packaging/server/install.ps1 | iex` The script does the same into `%LOCALAPPDATA%\Horizon` (`-Version`, `-Dir`), with junctions instead of @@ -201,8 +209,8 @@ comes out of the headless-engine work. (`horizon-prepare`, `horizon-server init`). **Docker** (`packaging/server/Dockerfile`, built the same way as the relay's image): a multi-stage build that -ends on `debian:bookworm-slim` as user `horizon`. It adds `libasound2` and `libudev1` until the headless engine -lands. It uses volume `/data` for the server folder, takes the owner's prepared game files as a read-only +ends on `debian:bookworm-slim` as user `horizon`, with the server build as `horizon-engine`, so the image needs +no ALSA or udev. It uses volume `/data` for the server folder, takes the owner's prepared game files as a read-only mount on `/opt/horizon/.local/horizon-client/26.3`, exposes port `25565/tcp`, and keeps the control API (and later the panel) on 127.0.0.1 inside the container: `docker exec <name> horizon-server status|cmd|backup`. On the first start, `HORIZON_EULA=true` and `HORIZON_WORLD`, `HORIZON_SEED`, `HORIZON_PORT`, diff --git a/packaging/server/Dockerfile b/packaging/server/Dockerfile index bbb74ba26..5ae395205 100644 --- a/packaging/server/Dockerfile +++ b/packaging/server/Dockerfile @@ -13,20 +13,15 @@ # start writes /data/server.toml from HORIZON_* (EULA, WORLD, SEED, PORT, WHITELIST, PLAYERS, OP); later # starts use the file. Manage it with `docker exec horizon horizon-server status|cmd|backup|logs ...`. FROM rust:1-slim-bookworm AS build -RUN apt-get update \ - && apt-get install -y --no-install-recommends pkg-config libasound2-dev libudev-dev \ - && rm -rf /var/lib/apt/lists/* WORKDIR /src COPY . . -RUN cargo build --release --locked -p horizon-client --bin horizon-client -p horizon-server --bin horizon-server \ - && mkdir /out && cp target/release/horizon-client target/release/horizon-server /out/ +# The server build of the game (no sound, no controllers: it needs neither ALSA nor udev) as horizon-engine. +RUN cargo build --release --locked -p horizon-client --no-default-features --bin horizon-client \ + && cargo build --release --locked -p horizon-server --bin horizon-server \ + && mkdir /out && cp target/release/horizon-client /out/horizon-engine && cp target/release/horizon-server /out/ FROM debian:bookworm-slim -# The game links ALSA and udev even when it runs headless with no sound. -RUN apt-get update \ - && apt-get install -y --no-install-recommends libasound2 libudev1 \ - && rm -rf /var/lib/apt/lists/* \ - && useradd --system --home-dir /data --shell /usr/sbin/nologin horizon \ +RUN useradd --system --home-dir /data --shell /usr/sbin/nologin horizon \ && mkdir -p /data /opt/horizon/.local/horizon-client \ && chown horizon:horizon /data COPY --from=build /out/ /opt/horizon/ diff --git a/packaging/server/install.sh b/packaging/server/install.sh index 08b710e37..eed312c74 100755 --- a/packaging/server/install.sh +++ b/packaging/server/install.sh @@ -1,9 +1,11 @@ #!/bin/sh # Installs horizon-server (docs/server.md) on Linux or macOS: the latest Horizon release for this computer, -# downloaded from GitHub Releases and checked against the SHA-256 GitHub publishes for it. +# downloaded from GitHub Releases and checked against the SHA-256 GitHub publishes for it. On Linux that is +# the server build (horizon-server-linux-x86_64.tar.gz), which needs neither ALSA nor udev. # # curl -fsSL https://raw.githubusercontent.com/ludovic111/horizon/main/packaging/server/install.sh | sh # curl -fsSL .../install.sh | sh -s -- --version v0.5.0 --dir /opt/horizon --bin /usr/local/bin +# sh install.sh --archive horizon-server-linux-x86_64.tar.gz --version mybuild (an archive you have) # # It needs curl, tar or unzip, and sha256sum or shasum; it never asks for sudo (pick folders you can write). # Releases go to <dir>/releases/<version>, <dir>/current points at the one in use, and <bin>/horizon-server @@ -15,6 +17,7 @@ REPO=ludovic111/horizon VERSION=latest DIR="${XDG_DATA_HOME:-$HOME/.local/share}/horizon" BIN="$HOME/.local/bin" +ARCHIVE= die() { echo "horizon install: $*" >&2; exit 1; } @@ -23,45 +26,58 @@ while [ $# -gt 0 ]; do --version) [ $# -ge 2 ] || die "--version needs a tag"; VERSION=$2; shift 2 ;; --dir) [ $# -ge 2 ] || die "--dir needs a folder"; DIR=$2; shift 2 ;; --bin) [ $# -ge 2 ] || die "--bin needs a folder"; BIN=$2; shift 2 ;; - -h|--help) sed -n '2,12p' "$0" 2>/dev/null || true; exit 0 ;; + --archive) [ $# -ge 2 ] || die "--archive needs a file"; ARCHIVE=$2; shift 2 ;; + -h|--help) sed -n '2,14p' "$0" 2>/dev/null || true; exit 0 ;; *) die "unknown option $1" ;; esac done +# The archives to look for, in order: on Linux the server build, else (releases before it) the full game. case "$(uname -s)-$(uname -m)" in - Linux-x86_64) ASSET=horizon-linux-x86_64.tar.gz ;; - Darwin-arm64) ASSET=horizon-macos-arm64.zip ;; + Linux-x86_64) ASSETS="horizon-server-linux-x86_64.tar.gz horizon-linux-x86_64.tar.gz" ;; + Darwin-arm64) ASSETS=horizon-macos-arm64.zip ;; *) die "no Horizon release for $(uname -s) $(uname -m) yet: build it from source (docs/server.md)" ;; esac -command -v curl >/dev/null || die "curl is needed" -if command -v sha256sum >/dev/null; then SHA="sha256sum" -elif command -v shasum >/dev/null; then SHA="shasum -a 256" -else die "sha256sum or shasum is needed"; fi - -if [ "$VERSION" = latest ]; then API="https://api.github.com/repos/$REPO/releases/latest" -else API="https://api.github.com/repos/$REPO/releases/tags/$VERSION"; fi -JSON=$(curl -fsSL -H "Accept: application/vnd.github+json" "$API") || die "no release $VERSION on GitHub" - -TAG=$(printf '%s\n' "$JSON" | sed -n 's/^ "tag_name": "\([^"]*\)".*/\1/p' | head -n 1) -[ -n "$TAG" ] || die "could not read the release's tag" -# The asset's download address and digest, from its block in the release's JSON. -FIELDS=$(printf '%s\n' "$JSON" | awk -v asset="$ASSET" ' - /"name": / { line = $0; sub(/.*"name": "/, "", line); sub(/".*/, "", line); current = line } - current == asset && /"digest": / { line = $0; sub(/.*"digest": "sha256:/, "", line); sub(/".*/, "", line); digest = line } - current == asset && /"browser_download_url": / { line = $0; sub(/.*"browser_download_url": "/, "", line); sub(/".*/, "", line); url = line } - END { print url; print digest }') -URL=$(printf '%s\n' "$FIELDS" | sed -n 1p) -DIGEST=$(printf '%s\n' "$FIELDS" | sed -n 2p) -[ -n "$URL" ] || die "release $TAG has no $ASSET" -[ -n "$DIGEST" ] || die "release $TAG publishes no SHA-256 for $ASSET" - TMP=$(mktemp -d) trap 'rm -rf "$TMP"' EXIT -echo "Downloading Horizon $TAG ($ASSET)..." -curl -fL --progress-bar -o "$TMP/$ASSET" "$URL" -GOT=$($SHA "$TMP/$ASSET" | cut -d' ' -f1) -[ "$GOT" = "$DIGEST" ] || die "$ASSET doesn't match its SHA-256 (got $GOT, expected $DIGEST): not installed" +if [ -n "$ARCHIVE" ]; then + # An archive already here (a build of your own, or one fetched by hand): checking it is up to you. + [ -f "$ARCHIVE" ] || die "no archive $ARCHIVE" + if [ "$VERSION" = latest ]; then TAG=local; else TAG=$VERSION; fi + ASSET=$(basename "$ARCHIVE") + cp "$ARCHIVE" "$TMP/$ASSET" +else + command -v curl >/dev/null || die "curl is needed" + if command -v sha256sum >/dev/null; then SHA="sha256sum" + elif command -v shasum >/dev/null; then SHA="shasum -a 256" + else die "sha256sum or shasum is needed"; fi + + if [ "$VERSION" = latest ]; then API="https://api.github.com/repos/$REPO/releases/latest" + else API="https://api.github.com/repos/$REPO/releases/tags/$VERSION"; fi + JSON=$(curl -fsSL -H "Accept: application/vnd.github+json" "$API") || die "no release $VERSION on GitHub" + + TAG=$(printf '%s\n' "$JSON" | sed -n 's/^ "tag_name": "\([^"]*\)".*/\1/p' | head -n 1) + [ -n "$TAG" ] || die "could not read the release's tag" + # The first asset the release has: its download address and digest, from its block in the release's JSON. + for ASSET in $ASSETS; do + FIELDS=$(printf '%s\n' "$JSON" | awk -v asset="$ASSET" ' + /"name": / { line = $0; sub(/.*"name": "/, "", line); sub(/".*/, "", line); current = line } + current == asset && /"digest": / { line = $0; sub(/.*"digest": "sha256:/, "", line); sub(/".*/, "", line); digest = line } + current == asset && /"browser_download_url": / { line = $0; sub(/.*"browser_download_url": "/, "", line); sub(/".*/, "", line); url = line } + END { print url; print digest }') + URL=$(printf '%s\n' "$FIELDS" | sed -n 1p) + DIGEST=$(printf '%s\n' "$FIELDS" | sed -n 2p) + [ -z "$URL" ] || break + done + [ -n "$URL" ] || die "release $TAG has none of $ASSETS" + [ -n "$DIGEST" ] || die "release $TAG publishes no SHA-256 for $ASSET" + + echo "Downloading Horizon $TAG ($ASSET)..." + curl -fL --progress-bar -o "$TMP/$ASSET" "$URL" + GOT=$($SHA "$TMP/$ASSET" | cut -d' ' -f1) + [ "$GOT" = "$DIGEST" ] || die "$ASSET doesn't match its SHA-256 (got $GOT, expected $DIGEST): not installed" +fi mkdir -p "$TMP/x" case "$ASSET" in @@ -86,8 +102,8 @@ for tool in horizon-server horizon-prepare; do done echo "Installed Horizon $TAG in $RELEASE; horizon-server and horizon-prepare are in $BIN." -# The game links ALSA and udev, even as a server; minimal Linux images often lack them. -if [ "$(uname -s)" = Linux ] && command -v ldd >/dev/null; then +# The full game (releases before the server build) links ALSA and udev; minimal Linux images often lack them. +if [ "$(uname -s)" = Linux ] && [ ! -e "$RELEASE/horizon-engine" ] && command -v ldd >/dev/null; then MISSING=$(ldd "$RELEASE/horizon-client" 2>/dev/null | awk '/not found/ { printf "%s ", $1 }') if [ -n "$MISSING" ]; then echo "The game needs libraries this system doesn't have: $MISSING" diff --git a/tools/check_imports.py b/tools/check_imports.py index 8cdabe45b..85afb541d 100644 --- a/tools/check_imports.py +++ b/tools/check_imports.py @@ -5,7 +5,8 @@ Windows .exe: every DLL in the import and delay-import tables must ship with Windows (no VCRUNTIME140.dll, vulkan-1.dll, ...): Vulkan and the like are loaded at run time, so a missing driver is an error message, not a dialog. Linux ELF: the loader must be the standard one (not a /nix/store path) and the -needed libraries the ones every desktop distribution has. +needed libraries the ones every desktop distribution has. `--server`: a server +build, which may not need ALSA or udev either (minimal server images lack them). """ import argparse @@ -30,6 +31,8 @@ LINUX_SYSTEM = { "libc.so.6", "libm.so.6", "libgcc_s.so.1", "libdl.so.2", "libpthread.so.0", "librt.so.1", "ld-linux-x86-64.so.2", "libasound.so.2", "libudev.so.1", } +# The game's sound (cpal) and controllers (gilrs): a desktop has them, a server image may not. +LINUX_DESKTOP_ONLY = {"libasound.so.2", "libudev.so.1"} def windows_allowed(name): @@ -111,7 +114,7 @@ def elf_needs(data): return interpreter, needed, runpath -def check(path): +def check(path, server=False): data = Path(path).read_bytes() problems = [] if data[:2] == b"MZ": @@ -123,6 +126,8 @@ def check(path): if interpreter not in (None, LINUX_LOADER): problems.append(f"loader is {interpreter}, not {LINUX_LOADER}") problems += [f"needs {n}, which not every distribution has" for n in needed if n not in LINUX_SYSTEM] + if server: + problems += [f"needs {n}, which a server may not have" for n in needed if n in LINUX_DESKTOP_ONLY] problems += [f"has a run path to {p}" for p in runpath if "/nix/store" in p] summary = f"{interpreter}; " + ", ".join(needed) print(f"{path}: {summary}") @@ -134,8 +139,10 @@ def check(path): def main(): parser = argparse.ArgumentParser(description=__doc__.splitlines()[0]) parser.add_argument("binaries", nargs="+") + parser.add_argument("--server", action="store_true", + help="a server build: not even ALSA or udev (the game's sound and controllers)") args = parser.parse_args() - ok = all([check(path) for path in args.binaries]) + ok = all([check(path, args.server) for path in args.binaries]) sys.exit(0 if ok else 1) diff --git a/xtask/src/main.rs b/xtask/src/main.rs index 05b84553b..28b591626 100644 --- a/xtask/src/main.rs +++ b/xtask/src/main.rs @@ -6,6 +6,10 @@ //! them to its own), and PLAY.txt. It holds none of Minecraft's files: players prepare those //! from their own copy. .github/workflows/release.yml makes the release folders with it. //! +//! `package-server ENGINE OUTDIR`: a server folder (docs/server.md): the server build of the game +//! (`cargo build --release -p horizon-client --no-default-features`, without sound or controllers) +//! as horizon-engine, with horizon-prepare and horizon-server from beside it and the same sources. +//! //! `tokens`: writes `website/src/tokens.css`, the design tokens of `crates/horizon-theme` as CSS //! custom properties (a horizon-theme test fails when the file is out of date). //! @@ -17,7 +21,7 @@ use std::fs; use std::path::{Component, Path, PathBuf}; use std::process::{Command, ExitCode}; -const USAGE: &str = "usage: cargo run -p xtask -- package BINARY OUTDIR | tokens | icons"; +const USAGE: &str = "usage: cargo run -p xtask -- package BINARY OUTDIR | package-server ENGINE OUTDIR | tokens | icons"; /// What the release folder takes from the repository at HEAD, as `git archive` writes it. const ARCHIVED: [&str; 5] = [ @@ -34,10 +38,16 @@ const ARCHIVED: [&str; 5] = [ /// (docs/server.md). const TOOLS: [&str; 3] = ["horizon-ctl", "horizon-prepare", "horizon-server"]; +/// The programs beside the engine in a server folder. +const SERVER_TOOLS: [&str; 2] = ["horizon-prepare", "horizon-server"]; + fn main() -> ExitCode { let args: Vec<String> = std::env::args().skip(1).collect(); let result = match args.as_slice() { [task, binary, out] if task == "package" => package(Path::new(binary), Path::new(out)), + [task, engine, out] if task == "package-server" => { + package_server(Path::new(engine), Path::new(out)) + } [task] if task == "tokens" => tokens(), [task] if task == "icons" => icons(), _ => Err(USAGE.to_string()), @@ -209,6 +219,21 @@ fn icons() -> Result<(), String> { } fn package(binary: &Path, out: &Path) -> Result<(), String> { + let repo = new_folder(out)?; + copy_into(binary, out)?; + copy_beside(binary, &TOOLS, out)?; + let play = repo.join("packaging/PLAY.txt"); + copy(&play, &out.join("PLAY.txt")) +} + +fn package_server(engine: &Path, out: &Path) -> Result<(), String> { + new_folder(out)?; + copy(engine, &out.join(program_name(engine, "horizon-engine")))?; + copy_beside(engine, &SERVER_TOOLS, out) +} + +/// `OUT`, emptied, with the sources the release folders take (`ARCHIVED`); the repository's path. +fn new_folder(out: &Path) -> Result<PathBuf, String> { let top = git( Path::new(env!("CARGO_MANIFEST_DIR")), &["rev-parse", "--show-toplevel"], @@ -224,15 +249,25 @@ fn package(binary: &Path, out: &Path) -> Result<(), String> { let mut args = vec!["archive", "--format=tar", "HEAD"]; args.extend(ARCHIVED); extract(&git(&repo, &args)?, out)?; - copy_into(binary, out)?; - let exe = binary.extension().is_some_and(|e| e == "exe"); - for tool in TOOLS { - let name = if exe { - format!("{tool}.exe") - } else { - tool.to_string() - }; - let path = binary.parent().unwrap_or(Path::new("")).join(name); + Ok(repo) +} + +/// `name`, with `.exe` when `program` has it. +fn program_name(program: &Path, name: &str) -> String { + if program.extension().is_some_and(|e| e == "exe") { + format!("{name}.exe") + } else { + name.to_string() + } +} + +/// Copies `tools`, built beside `program`, into `out`. +fn copy_beside(program: &Path, tools: &[&str], out: &Path) -> Result<(), String> { + for tool in tools { + let path = program + .parent() + .unwrap_or(Path::new("")) + .join(program_name(program, tool)); if !path.is_file() { return Err(format!( "{} is missing; build it too: cargo build --release -p horizon-client --bins -p horizon-prepare -p horizon-server", @@ -241,8 +276,7 @@ fn package(binary: &Path, out: &Path) -> Result<(), String> { } copy_into(&path, out)?; } - let play = repo.join("packaging/PLAY.txt"); - copy(&play, &out.join("PLAY.txt")) + Ok(()) } /// `cp FILE DIR/`. From d634870f1569cac382b38ceaebec541f13f24833 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 20:48:34 +0200 Subject: [PATCH 145/163] Structures: Repurposed's matter phase, piece origin and y value rule tests Repurposed Structures' mineshafts and Nether monument test blocks with three rule tests of their own. Vanilla, and the game, refuse a processor list naming a type they do not know, and with it every pool naming the list: the 5 Nether mineshaft start pools in a ported pack never load. The game now runs them under its own types, with the mod's fields: - horizon:matter_phase (MatterPhaseRuleTest): solid (not air, no fluid, canOcclude), liquid, air, and air or liquid with rails and chains, optionally inverted. Structure processors now bind the block properties to read canOcclude. - horizon:piece_origin_axis_aligned_linear_pos: vanilla's axis-aligned chance over the block's distance from its template's origin. - horizon:y_value: the block's world height in a range. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-world/src/block_properties.rs | 23 ++- .../src/worldgen/block_feature.rs | 3 + .../src/worldgen/fluid_predicate.rs | 3 + .../src/worldgen/generator_structures.rs | 10 +- .../horizon-world/src/worldgen/rule_test.rs | 89 ++++++++- .../src/worldgen/structure/processor.rs | 179 ++++++++++++++---- .../horizon-world/tests/rule_test_bounds.rs | 77 ++++++++ 7 files changed, 342 insertions(+), 42 deletions(-) diff --git a/crates/horizon-world/src/block_properties.rs b/crates/horizon-world/src/block_properties.rs index 7c0e17f61..98e06f7cb 100644 --- a/crates/horizon-world/src/block_properties.rs +++ b/crates/horizon-world/src/block_properties.rs @@ -79,15 +79,18 @@ impl BlockProperty { #[derive(Clone, Debug)] pub struct BoundBlockProperty { states: Arc<[u8]>, - property: BlockProperty, + mask: u8, } impl BoundBlockProperty { pub fn contains(&self, id: BlockStateId) -> bool { self.states .get(id.0 as usize) - .is_some_and(|flags| flags & self.property.mask() != 0) + .is_some_and(|flags| flags & self.mask != 0) } } +/// The per-state flag of the block definition's `canOcclude`, past the +/// [`BlockProperty`] bits. +const CAN_OCCLUDE: u8 = 16; /// Immutable FULL face-occlusion results, independent of support/collision. #[derive(Clone, Debug)] @@ -195,7 +198,12 @@ impl<'r> BlockPropertiesRegistry<'r> { .ok_or_else(|| invalid("missing block occlusion shape"))?, ) .map_err(|error| invalid(error.to_string()))?, - ) << 3), + ) << 3) + | if properties.can_occlude { + CAN_OCCLUDE + } else { + 0 + }, ); } Ok(Self { @@ -225,7 +233,14 @@ impl<'r> BlockPropertiesRegistry<'r> { pub fn bind(&self, property: BlockProperty) -> BoundBlockProperty { BoundBlockProperty { states: Arc::clone(&self.states), - property, + mask: property.mask(), + } + } + /// The states whose block definition can occlude (BlockState.canOcclude). + pub fn bind_can_occlude(&self) -> BoundBlockProperty { + BoundBlockProperty { + states: Arc::clone(&self.states), + mask: CAN_OCCLUDE, } } } diff --git a/crates/horizon-world/src/worldgen/block_feature.rs b/crates/horizon-world/src/worldgen/block_feature.rs index a901a583d..00f0c64c1 100644 --- a/crates/horizon-world/src/worldgen/block_feature.rs +++ b/crates/horizon-world/src/worldgen/block_feature.rs @@ -23,6 +23,7 @@ pub struct FeatureBlockBindings<'r> { )>, physical_properties: Option<[BoundBlockProperty; 4]>, pub(crate) occlusion_faces: Option<crate::block_properties::BoundOcclusionFaces>, + pub(crate) can_occlude: Option<BoundBlockProperty>, biomes: Option<Arc<super::biome_predicate::BiomePredicateBindings>>, pub(crate) fluids: super::fluid_predicate::FluidPredicateBindings, pub(crate) codec: BlockStateJsonCodec<'r>, @@ -88,6 +89,7 @@ impl<'r> FeatureBlockBindings<'r> { properties.bind(BlockProperty::SolidRender), ]); self.occlusion_faces = Some(properties.bind_occlusion_faces()); + self.can_occlude = Some(properties.bind_can_occlude()); Ok(self) } pub fn with_biomes( @@ -156,6 +158,7 @@ impl<'r> FeatureBlockBindings<'r> { biomes: None, physical_properties: None, occlusion_faces: None, + can_occlude: None, fluids: super::fluid_predicate::FluidPredicateBindings::new(registry)?, blocks: blocks .into_iter() diff --git a/crates/horizon-world/src/worldgen/fluid_predicate.rs b/crates/horizon-world/src/worldgen/fluid_predicate.rs index d8bcb10ab..1394445c9 100644 --- a/crates/horizon-world/src/worldgen/fluid_predicate.rs +++ b/crates/horizon-world/src/worldgen/fluid_predicate.rs @@ -45,6 +45,9 @@ impl FluidPredicateBindings { self.tags = resolved; Ok(self) } + pub(crate) fn table(&self) -> &Arc<FluidStateTable> { + &self.table + } pub fn state(&self, block: BlockStateId) -> Option<crate::fluid::FluidState> { self.table.get(block) } diff --git a/crates/horizon-world/src/worldgen/generator_structures.rs b/crates/horizon-world/src/worldgen/generator_structures.rs index 3b6d058ae..11765ab57 100644 --- a/crates/horizon-world/src/worldgen/generator_structures.rs +++ b/crates/horizon-world/src/worldgen/generator_structures.rs @@ -195,11 +195,19 @@ impl StructureState { for (i, def) in registry.structures.iter().enumerate() { by_step[def.step].push(i); } - let bindings = FeatureBlockBindings::with_tags( + let mut bindings = FeatureBlockBindings::with_tags( data.registry(), data.integers().clone(), &data.block_tags, )?; + // Processors that test what a block is made of read canOcclude. + if let Some(blocks) = data + .feature_resources + .as_ref() + .and_then(|r| r.blocks.as_ref()) + { + bindings = bindings.with_block_properties(&blocks.properties)?; + } Ok(Some(Self { registry, resources: resources.clone(), diff --git a/crates/horizon-world/src/worldgen/rule_test.rs b/crates/horizon-world/src/worldgen/rule_test.rs index d9f836961..5202baa31 100644 --- a/crates/horizon-world/src/worldgen/rule_test.rs +++ b/crates/horizon-world/src/worldgen/rule_test.rs @@ -3,7 +3,11 @@ use super::{ DecodeError, Object, block_feature::FeatureBlockBindings, density::identifier, integer, number_text, required, }; -use crate::registry::BlockStateId; +use crate::{ + block_properties::BoundBlockProperty, + fluid::{FluidKind, FluidStateTable}, + registry::BlockStateId, +}; use horizon_core::random::RandomSource; use serde_json::value::RawValue; use std::{collections::BTreeSet, sync::Arc}; @@ -21,6 +25,85 @@ enum Node { RandomStates(Arc<BTreeSet<BlockStateId>>, f32), RandomState(BlockStateId, f32), Height(i32, i32), + Phase(Box<MatterPhase>), +} +/// `horizon:matter_phase`: Repurposed Structures' MatterPhaseRuleTest, which +/// its mineshafts and Nether monument use to match a block by what it is +/// made of (`phase_to_test_for`), optionally inverted (`invert_condition`). +#[derive(Clone, Debug)] +struct MatterPhase { + phase: Phase, + invert: bool, + air: [BlockStateId; 3], + fluids: Arc<FluidStateTable>, + /// Only for `SOLID`. + can_occlude: Option<BoundBlockProperty>, + /// Blocks.RAIL and Blocks.CHAIN (26.3's iron chain). + rail_or_chain: BTreeSet<BlockStateId>, +} +#[derive(Clone, Copy, Debug)] +enum Phase { + Solid, + Liquid, + Air, + AirRailOrChain, + LiquidRailOrChain, +} +impl MatterPhase { + fn decode(object: &Object, bindings: &FeatureBlockBindings<'_>) -> Result<Self, DecodeError> { + let name: String = serde_json::from_str(required(object, "phase_to_test_for")?.get())?; + let phase = match name.as_str() { + "SOLID" => Phase::Solid, + "LIQUID" => Phase::Liquid, + "AIR" => Phase::Air, + "AIR_RAIL_OR_CHAIN" => Phase::AirRailOrChain, + "LIQUID_RAIL_OR_CHAIN" => Phase::LiquidRailOrChain, + _ => return Err(DecodeError::Field("matter phase")), + }; + let invert = match object.get("invert_condition") { + Some(v) => serde_json::from_str(v.get())?, + None => false, + }; + let can_occlude = match phase { + Phase::Solid => Some( + bindings + .can_occlude + .clone() + .ok_or(DecodeError::Field("matter phase block properties"))?, + ), + _ => None, + }; + let mut rail_or_chain = BTreeSet::new(); + for name in ["minecraft:rail", "minecraft:iron_chain"] { + rail_or_chain.extend(bindings.blocks.get(name).into_iter().flat_map(|s| s.iter())); + } + Ok(Self { + phase, + invert, + air: bindings.air, + fluids: bindings.fluids.table().clone(), + can_occlude, + rail_or_chain, + }) + } + fn test(&self, state: BlockStateId) -> bool { + let air = self.air.contains(&state); + let liquid = self + .fluids + .get(state) + .is_some_and(|f| f.kind() != FluidKind::Empty); + let rail_or_chain = || self.rail_or_chain.contains(&state); + let matched = match self.phase { + Phase::Solid => { + !air && !liquid && self.can_occlude.as_ref().is_some_and(|c| c.contains(state)) + } + Phase::Liquid => liquid, + Phase::Air => air, + Phase::AirRailOrChain => air || rail_or_chain(), + Phase::LiquidRailOrChain => liquid || rail_or_chain(), + }; + matched != self.invert + } } impl RuleTest { pub fn from_json(json: &str, bindings: &FeatureBlockBindings<'_>) -> Result<Self, DecodeError> { @@ -104,6 +187,9 @@ impl RuleTest { Node::Any(values) } } + "horizon:matter_phase" => { + Node::Phase(Box::new(MatterPhase::decode(&object, bindings)?)) + } _ => return Err(DecodeError::Field("replacement rule type")), }; Ok(Self(node)) @@ -128,6 +214,7 @@ impl RuleTest { state == *expected && random.next_float() < *probability } Node::Height(min, max) => *min <= position[1] && position[1] <= *max, + Node::Phase(phase) => phase.test(state), } } } diff --git a/crates/horizon-world/src/worldgen/structure/processor.rs b/crates/horizon-world/src/worldgen/structure/processor.rs index 76e1a4cd1..4001f25cb 100644 --- a/crates/horizon-world/src/worldgen/structure/processor.rs +++ b/crates/horizon-world/src/worldgen/structure/processor.rs @@ -49,6 +49,22 @@ enum PosRule { max_dist: i32, axis: Option<usize>, }, + /// `horizon:piece_origin_axis_aligned_linear_pos`: Repurposed Structures' + /// PieceOriginAxisAlignedLinearPosRuleTest, vanilla's axis-aligned chance + /// over the block's distance from the template's origin along one axis. + PieceOrigin { + min_chance: f32, + max_chance: f32, + min_dist: i32, + max_dist: i32, + axis: usize, + }, + /// `horizon:y_value`: Repurposed Structures' YValuePosRuleTest, the + /// block's world height in `min_y_value..=max_y_value`. + YValue { + min: i32, + max: i32, + }, } #[derive(Clone, Debug)] enum Modifier { @@ -83,9 +99,97 @@ impl PosRule { } }), }, + "horizon:piece_origin_axis_aligned_linear_pos" => { + let int = |key| p.get(key).and_then(Value::as_i64).unwrap_or(0) as i32; + let (min_dist, max_dist) = (int("min_dist"), int("max_dist")); + if min_dist >= max_dist { + return Err(DecodeError::Field("position predicate distance range")); + } + Self::PieceOrigin { + min_chance: p.get("min_chance").and_then(Value::as_f64).unwrap_or(0.) as f32, + max_chance: p.get("max_chance").and_then(Value::as_f64).unwrap_or(0.) as f32, + min_dist, + max_dist, + axis: match p.get("axis").map(|a| a.as_str()) { + Some(Some("x")) => 0, + None | Some(Some("y")) => 1, + Some(Some("z")) => 2, + _ => return Err(DecodeError::Field("position predicate axis")), + }, + } + } + "horizon:y_value" => { + let int = |key| { + p.get(key) + .and_then(Value::as_i64) + .map(|v| v as i32) + .ok_or(DecodeError::Field("position predicate y value")) + }; + let (min, max) = (int("min_y_value")?, int("max_y_value")?); + if min > max { + return Err(DecodeError::Field("position predicate y range")); + } + Self::YValue { min, max } + } _ => return Err(DecodeError::Field("position predicate")), }) } + /// PosRuleTest.test for a block at `world`, `relative` in its template, + /// in a piece placed at `reference`. + fn test( + &self, + relative: [i32; 3], + world: [i32; 3], + reference: [i32; 3], + random: &mut impl RandomSource, + ) -> bool { + match *self { + Self::Always => true, + Self::Linear { + min_chance, + max_chance, + min_dist, + max_dist, + axis, + } => { + let dist = match axis { + None => (0..3).map(|i| (world[i] - reference[i]).abs()).sum::<i32>(), + Some(a) => ((world[a] - reference[a]) as f32).abs() as i32, + }; + random.next_float() + <= clamped_chance(min_chance, max_chance, min_dist, max_dist, dist) + } + Self::PieceOrigin { + min_chance, + max_chance, + min_dist, + max_dist, + axis, + } => { + let dist = (relative[axis] as f32).abs() as i32; + random.next_float() + <= clamped_chance(min_chance, max_chance, min_dist, max_dist, dist) + } + Self::YValue { min, max } => (min..=max).contains(&world[1]), + } + } +} +/// Mth.clampedLerp(min_chance, max_chance, Mth.inverseLerp(dist, min_dist, max_dist)). +fn clamped_chance( + min_chance: f32, + max_chance: f32, + min_dist: i32, + max_dist: i32, + dist: i32, +) -> f32 { + let t = (dist - min_dist) as f32 / (max_dist - min_dist) as f32; + if t < 0. { + min_chance + } else if t > 1. { + max_chance + } else { + min_chance + t * (max_chance - min_chance) + } } impl Modifier { /// A rule's `block_entity_modifier` (passthrough when missing). @@ -589,42 +693,9 @@ fn process_block<W: PlacementContext>( if !rule.location.test(located, info.pos, &mut random) { continue; } - let position_ok = match &rule.position { - PosRule::Always => true, - PosRule::Linear { - min_chance, - max_chance, - min_dist, - max_dist, - axis, - } => { - let dist = match axis { - None => (0..3) - .map(|i| (info.pos[i] - reference[i]).abs()) - .sum::<i32>(), - Some(a) => { - let d: [f32; 3] = std::array::from_fn(|i| { - if i == *a { - ((info.pos[i] - reference[i]) as f32).abs() - } else { - 0. - } - }); - (d[0] + d[1] + d[2]) as i32 - } - }; - let roll = random.next_float(); - let t = (dist - min_dist) as f32 / (max_dist - min_dist) as f32; - let chance = if t < 0. { - *min_chance - } else if t > 1. { - *max_chance - } else { - min_chance + t * (max_chance - min_chance) - }; - roll <= chance - } - }; + let position_ok = rule + .position + .test(relative, info.pos, reference, &mut random); if !position_ok { continue; } @@ -1250,6 +1321,42 @@ mod tests { assert!(SpawnerMobs::decode(&bad, |_| Ok(BlockStateId(0))).is_err()); } + #[test] + fn repurposed_position_rules() { + let decode = |v: Value| PosRule::decode(Some(&v)); + // Over 3..4 blocks from the template's origin along y, 0 to 1. + let rule = decode( + json!({"predicate_type": "horizon:piece_origin_axis_aligned_linear_pos", + "axis": "y", "min_chance": 0, "max_chance": 1, "min_dist": 3, "max_dist": 4}), + ) + .unwrap(); + let mut random = LegacyRandom::new(1); + let world = [100, 64, -100]; + // At or under min_dist the chance is 0, a roll of 0 aside; past max_dist it is 1. + assert!(!rule.test([9, 2, 9], world, world, &mut random)); + assert!(rule.test([0, -5, 0], world, world, &mut random)); + // The world position and the piece's do not count. + assert!(rule.test([0, 4, 0], [0, 0, 0], [50, 50, 50], &mut random)); + // Repurposed refuses an empty distance range and an unknown axis. + for bad in [ + json!({"predicate_type": "horizon:piece_origin_axis_aligned_linear_pos"}), + json!({"predicate_type": "horizon:piece_origin_axis_aligned_linear_pos", + "min_dist": 0, "max_dist": 1, "axis": "w"}), + json!({"predicate_type": "horizon:y_value", "min_y_value": 5, "max_y_value": 4}), + json!({"predicate_type": "horizon:y_value", "min_y_value": 5}), + ] { + assert!(decode(bad.clone()).is_err(), "{bad}"); + } + let y = decode( + json!({"predicate_type": "horizon:y_value", "min_y_value": 0, "max_y_value": 31}), + ) + .unwrap(); + assert!(y.test([0; 3], [7, 31, 7], [0; 3], &mut random)); + assert!(y.test([0, 99, 0], [7, 0, 7], [0; 3], &mut random)); + assert!(!y.test([0; 3], [7, 32, 7], [0; 3], &mut random)); + assert!(!y.test([0; 3], [7, -1, 7], [0; 3], &mut random)); + } + #[test] fn rule_parts_read_ids_without_a_namespace() { // CTOV writes "always_true"; vanilla reads it as minecraft:always_true. diff --git a/crates/horizon-world/tests/rule_test_bounds.rs b/crates/horizon-world/tests/rule_test_bounds.rs index de4862f54..e3f614590 100644 --- a/crates/horizon-world/tests/rule_test_bounds.rs +++ b/crates/horizon-world/tests/rule_test_bounds.rs @@ -67,3 +67,80 @@ fn binding_rejects_unknown_tag_blocks_and_duplicate_canonical_tags() { ]); assert!(FeatureBlockBindings::with_tags(®istry, BTreeSet::new(), &tags).is_err()); } +#[test] +fn matter_phase_matches_what_a_block_is_made_of() { + // air, cave_air, void_air, stone, then water (level 0), rail, iron_chain. + let mut states: Vec<Tag> = [ + "minecraft:air", + "minecraft:cave_air", + "minecraft:void_air", + "minecraft:stone", + ] + .iter() + .map(|name| Tag::compound([("id", Tag::String((*name).into()))])) + .collect(); + states.push(Tag::compound([ + ("id", Tag::String("minecraft:water".into())), + ( + "properties", + Tag::compound([("level", Tag::String("0".into()))]), + ), + ])); + for name in ["minecraft:rail", "minecraft:iron_chain"] { + states.push(Tag::compound([("id", Tag::String(name.into()))])); + } + let names = [ + "minecraft:air", + "minecraft:cave_air", + "minecraft:void_air", + "minecraft:stone", + "minecraft:water", + "minecraft:rail", + "minecraft:iron_chain", + ]; + let registry = BlockRegistry::from_nbt(&Tag::compound([ + ("DataVersion", Tag::Int(DATA_VERSION)), + ("states", Tag::List(states)), + ( + "defaults", + Tag::Compound( + names + .iter() + .enumerate() + .map(|(id, name)| ((*name).into(), Tag::Int(id as i32))) + .collect(), + ), + ), + ])) + .unwrap(); + let bindings = FeatureBlockBindings::new(®istry, BTreeSet::new()).unwrap(); + let mut random = horizon_core::random::LegacyRandom::new(0); + let matches = |phase: &str, invert: bool, random: &mut horizon_core::random::LegacyRandom| { + let json = format!( + r#"{{"predicate_type":"horizon:matter_phase","phase_to_test_for":"{phase}","invert_condition":{invert}}}"# + ); + let test = RuleTest::from_json(&json, &bindings).unwrap(); + (0..names.len() as u32) + .filter(|&id| test.test(horizon_world::registry::BlockStateId(id), [0; 3], random)) + .collect::<Vec<_>>() + }; + assert_eq!(matches("AIR", false, &mut random), [0, 1, 2]); + assert_eq!(matches("LIQUID", false, &mut random), [4]); + assert_eq!( + matches("AIR_RAIL_OR_CHAIN", false, &mut random), + [0, 1, 2, 5, 6] + ); + assert_eq!( + matches("LIQUID_RAIL_OR_CHAIN", false, &mut random), + [4, 5, 6] + ); + assert_eq!(matches("AIR", true, &mut random), [3, 4, 5, 6]); + // The phase is the enum's name as written; SOLID needs canOcclude. + for json in [ + r#"{"predicate_type":"horizon:matter_phase","phase_to_test_for":"air"}"#, + r#"{"predicate_type":"horizon:matter_phase","phase_to_test_for":"SOLID"}"#, + r#"{"predicate_type":"horizon:matter_phase"}"#, + ] { + assert!(RuleTest::from_json(json, &bindings).is_err(), "{json}"); + } +} From 5fcea03fb8c8401d969d3afb294a6c94be90087a Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 20:49:23 +0200 Subject: [PATCH 146/163] Carry: Repurposed's rule tests as the game's, and the chain as the iron chain Two things kept Repurposed Structures' mineshaft processor lists from loading in 26.3, and with them the mod's 5 Nether mineshaft pools: - Its three rule tests written in Java. Carry renames them to the game's horizon:matter_phase, horizon:piece_origin_axis_aligned_linear_pos and horizon:y_value (213 in 75 lists), counted in the report's rule_tests_carried. - 1.21.1's minecraft:chain, which 26.3 calls minecraft:iron_chain (its datafixers rename it in worlds). Carry renames it in recipes, loot tables and worldgen files: 112 files in 5 of ATM10's mods. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/carry.rs | 58 ++++++++++++- crates/horizon-port-pack/src/processors.rs | 97 ++++++++++++++++++++++ crates/horizon-port-pack/src/worldgen.rs | 6 +- docs/modpacks.md | 11 +++ 4 files changed, 169 insertions(+), 3 deletions(-) diff --git a/crates/horizon-port-pack/src/carry.rs b/crates/horizon-port-pack/src/carry.rs index b342f45fd..fcf9f3498 100644 --- a/crates/horizon-port-pack/src/carry.rs +++ b/crates/horizon-port-pack/src/carry.rs @@ -205,6 +205,29 @@ pub fn upgrade_recipe(recipe: &mut Value) -> bool { true } +/// Block and item ids vanilla renamed after 1.21.1, as its datafixers +/// rename them in worlds (DataVersion 4541: the chain became the iron chain +/// when copper chains came in). A data file naming the old id fails to load +/// in 26.3: a recipe, a loot entry, a processor's block match. +const RENAMED_IDS: [(&str, &str); 1] = [("minecraft:chain", "minecraft:iron_chain")]; + +/// Every string of a data file that is a renamed id ([`RENAMED_IDS`]) set to +/// the new one, in place; whether any was. +pub fn renamed_ids(v: &mut Value) -> bool { + match v { + Value::String(s) => match RENAMED_IDS.iter().find(|(old, _)| s == old) { + Some((_, new)) => { + *s = (*new).to_owned(); + true + } + None => false, + }, + Value::Array(a) => a.iter_mut().fold(false, |c, x| renamed_ids(x) | c), + Value::Object(o) => o.values_mut().fold(false, |c, x| renamed_ids(x) | c), + _ => false, + } +} + /// A 1.21.1 loot table in 26.3's shape, in place: `conditions` lists become /// one `condition` (`all_of` for several), `functions` become `modifier`, /// and conditions and functions name their kind in `type`. A tool match on @@ -410,12 +433,16 @@ pub fn carry( { if let Ok(mut recipe) = serde_json::from_slice::<Value>(&bytes) { tags_used(&recipe, &mut convention); - if upgrade_recipe(&mut recipe) { + let renamed = renamed_ids(&mut recipe); + let upgraded = upgrade_recipe(&mut recipe); + if upgraded { report.recipes_upgraded += 1; - bytes = serde_json::to_vec_pretty(&recipe).unwrap_or(bytes); } else { report.recipes_kept.push(file.to_owned()); } + if upgraded || renamed { + bytes = serde_json::to_vec_pretty(&recipe).unwrap_or(bytes); + } } } else if let Some(kind) = rel .strip_prefix("worldgen/") @@ -433,6 +460,10 @@ pub fn carry( &mut v, &processor_data, &mut types.processors_carried, + ) | crate::processors::rule_tests( + kind, + &mut v, + &mut types.rule_tests_carried, ); let mut changed = crate::worldgen::upgrade(kind, &mut v, types, &set_tags) || carried; @@ -463,6 +494,7 @@ pub fn carry( &processor_data, &mut types.processors_carried, ); + crate::processors::rule_tests(kind, &mut added, &mut types.rule_tests_carried); crate::worldgen::upgrade(kind, &mut added, types, &set_tags); let to = format!( "data/{id}/worldgen/{kind}/{}/{path}", @@ -487,6 +519,7 @@ pub fn carry( if let Ok(mut table) = serde_json::from_slice::<Value>(&bytes) { let before = table.clone(); upgrade_loot(&mut table); + renamed_ids(&mut table); if table != before { report.loot_tables_upgraded += 1; bytes = serde_json::to_vec_pretty(&table).unwrap_or(bytes); @@ -809,6 +842,27 @@ mod tests { assert_eq!(new, glass); } + #[test] + fn renames_ids_vanilla_renamed() { + let mut recipe = json!({"type": "minecraft:crafting_shaped", "pattern": ["c"], + "key": {"c": {"item": "minecraft:chain"}}, "result": {"id": "m:sign", "count": 1}}); + assert!(renamed_ids(&mut recipe)); + assert_eq!(recipe["key"]["c"]["item"], "minecraft:iron_chain"); + let mut rule = json!({"input_predicate": {"predicate_type": "minecraft:block_match", + "block": "minecraft:chain"}, "output_state": {"id": "minecraft:chain", + "properties": {"axis": "y"}}}); + assert!(renamed_ids(&mut rule)); + assert_eq!(rule["input_predicate"]["block"], "minecraft:iron_chain"); + assert_eq!(rule["output_state"]["id"], "minecraft:iron_chain"); + // Only whole ids: other blocks and mods' own chains stay. + let mut other = json!([ + "minecraft:chain_command_block", + "m:chain", + "minecraft:iron_chain" + ]); + assert!(!renamed_ids(&mut other)); + } + #[test] fn templates_from_blockstate_properties() { let door = diff --git a/crates/horizon-port-pack/src/processors.rs b/crates/horizon-port-pack/src/processors.rs index 7fcc0fd94..6e22133df 100644 --- a/crates/horizon-port-pack/src/processors.rs +++ b/crates/horizon-port-pack/src/processors.rs @@ -150,6 +150,49 @@ pub fn carry( }) } +/// Repurposed Structures' rule tests and the game's types that run them +/// (`horizon_world::worldgen`'s `rule_test` and `structure::processor`). +const RULE_TESTS: [(&str, &str); 3] = [ + ( + "repurposed_structures:matter_phase_rule_test", + "horizon:matter_phase", + ), + ( + "repurposed_structures:piece_origin_axis_aligned_linear_pos_rule_test", + "horizon:piece_origin_axis_aligned_linear_pos", + ), + ( + "repurposed_structures:y_value_pos_rule_test", + "horizon:y_value", + ), +]; + +/// Renames the rule tests written in Java that the game runs under its own +/// type ([`RULE_TESTS`]) in a worldgen file's processor lists; each is +/// counted by type in `carried`. Their fields are the mod's. Whether +/// anything changed. Without this the game, like vanilla, refuses the list +/// and every pool naming it: Repurposed's mineshafts and Nether monument. +pub fn rule_tests(kind: &str, v: &mut Value, carried: &mut BTreeMap<String, usize>) -> bool { + fn rename(v: &mut Value, carried: &mut BTreeMap<String, usize>) -> bool { + match v { + Value::Object(o) => { + let mut changed = false; + if let Some(Value::String(t)) = o.get_mut("predicate_type") + && let Some((old, new)) = RULE_TESTS.iter().find(|(old, _)| t == old) + { + *carried.entry((*old).to_owned()).or_default() += 1; + *t = (*new).to_owned(); + changed = true; + } + o.values_mut().fold(changed, |c, x| rename(x, carried) | c) + } + Value::Array(a) => a.iter_mut().fold(false, |c, x| rename(x, carried) | c), + _ => false, + } + } + each_list(kind, v, &mut |list| rename(list, carried)) +} + /// The data form of a Java processor: the processors to put in its place /// (none for a no-op), or `None` when it has none. fn as_data(kind: &str, p: &Value, data: &ProcessorData) -> Option<Vec<Value>> { @@ -502,4 +545,58 @@ mod tests { assert_eq!(p[3]["processor_type"], "betterdungeons:candle_processor"); assert_eq!(carried.values().sum::<usize>(), 3); } + + #[test] + fn repurposed_rule_tests_become_the_games() { + let rule = |input: Value, position: Value| { + json!({"input_predicate": input, "location_predicate": {"predicate_type": + "repurposed_structures:matter_phase_rule_test", "phase_to_test_for": "AIR"}, + "position_predicate": position, "output_state": {"id": "minecraft:lava"}}) + }; + let mut pool = json!({"elements": [{"weight": 1, "element": { + "element_type": "minecraft:single_pool_element", "processors": {"processors": [ + {"processor_type": "minecraft:rule", "rules": [rule( + json!({"predicate_type": "minecraft:always_true"}), + json!({"predicate_type": "repurposed_structures:y_value_pos_rule_test", + "min_y_value": 0, "max_y_value": 31}))]}, + {"processor_type": "minecraft:capped", "limit": 2, "delegate": { + "processor_type": "minecraft:rule", "rules": [rule( + json!({"predicate_type": "minecraft:block_match", "block": "minecraft:rail"}), + json!({"predicate_type": + "repurposed_structures:piece_origin_axis_aligned_linear_pos_rule_test", + "axis": "y", "min_dist": 0, "max_dist": 1}))]}}]}}}]}); + let mut carried = BTreeMap::new(); + assert!(rule_tests("template_pool", &mut pool, &mut carried)); + let list = &pool["elements"][0]["element"]["processors"]["processors"]; + let first = &list[0]["rules"][0]; + assert_eq!( + first["location_predicate"]["predicate_type"], + "horizon:matter_phase" + ); + assert_eq!(first["location_predicate"]["phase_to_test_for"], "AIR"); + assert_eq!( + first["position_predicate"]["predicate_type"], + "horizon:y_value" + ); + assert_eq!(first["position_predicate"]["max_y_value"], 31); + let delegated = &list[1]["delegate"]["rules"][0]; + assert_eq!( + delegated["position_predicate"]["predicate_type"], + "horizon:piece_origin_axis_aligned_linear_pos" + ); + assert_eq!( + delegated["input_predicate"]["predicate_type"], + "minecraft:block_match" + ); + assert_eq!(carried.values().sum::<usize>(), 4); + assert_eq!(carried["repurposed_structures:matter_phase_rule_test"], 2); + // A file holding none is left as it is. + assert!(!rule_tests("template_pool", &mut pool, &mut carried)); + assert!(!rule_tests( + "structure", + &mut json!({"predicate_type": + "repurposed_structures:y_value_pos_rule_test"}), + &mut carried + )); + } } diff --git a/crates/horizon-port-pack/src/worldgen.rs b/crates/horizon-port-pack/src/worldgen.rs index 7de9f39ce..507819566 100644 --- a/crates/horizon-port-pack/src/worldgen.rs +++ b/crates/horizon-port-pack/src/worldgen.rs @@ -131,6 +131,9 @@ pub struct Upgrade { /// Processors written in Java carried as data the game runs /// ([`crate::processors`]), by type. pub processors_carried: BTreeMap<String, usize>, + /// Rule tests written in Java carried as the game's own + /// ([`crate::processors::rule_tests`]), by type. + pub rule_tests_carried: BTreeMap<String, usize>, /// Entries added to other structure sets and template pools /// (`horizon:add_to`), by the set or pool they join. pub added_to: BTreeMap<String, usize>, @@ -345,10 +348,11 @@ pub fn upgrade( ) -> bool { let states = block_states(v); report.block_states += usize::from(states); + let renamed = crate::carry::renamed_ids(v); let dropped = crate::processors::each_list(kind, v, &mut |list| { drop_java_processors(list, &mut report.processors_dropped) }); - upgrade_types(kind, v, report, set_tags) || states || dropped + upgrade_types(kind, v, report, set_tags) || states || dropped || renamed } /// Takes the processors written in Java (any type outside `minecraft:` and diff --git a/docs/modpacks.md b/docs/modpacks.md index 12e522e24..0e8a0121f 100644 --- a/docs/modpacks.md +++ b/docs/modpacks.md @@ -455,6 +455,17 @@ Two cases the oracle fills in: Moog's were empty (763 spawners with a mob, up from 628); in the Nether the 52 empty ones in Moog's Nether Structures are filled (162, up from 110). Chests are unchanged: 2,777 and 1,405 with a loot table. + - **Rule tests** written in Java. Repurposed Structures' mineshafts and Nether monument test + blocks with three of the mod's own rule tests inside vanilla `rule` processors: what a + block is made of (solid, liquid, air, with rails and chains), a chance over the distance + from the template's origin along one axis, and a world height range. The game runs them + as `horizon:matter_phase`, `horizon:piece_origin_axis_aligned_linear_pos` and + `horizon:y_value` with the mod's fields, and carry renames them (213 in 75 lists). + - **Renamed ids.** 26.3 calls 1.21.1's chain the iron chain (its datafixers rename it in + worlds). Carry renames it in recipes, loot tables and worldgen files (112 files in 5 mods: + Repurposed's mineshafts, Better Dungeons' processors, Regions Unexplored's hanging sign + recipes...), which otherwise fail to load in 26.3. With both, the 5 Nether mineshaft pools load: 47 of + Repurposed's Nether mineshafts in the 128×128-chunk square (seed 1234), under the lava sea. - **Big templates** (#838). Vanilla reads structure templates with no limit on their tag count; Horizon now does too (`nbt::Limits::templates`). Seven of ATM10's 8,962 carried templates are past the old 1,000,000-tag cap: YUNG's monument start, four When Dungeons From 1f2f2a9f6d8ffbbdb8a67f51d7a67e4693bd68e0 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 18:47:55 +0200 Subject: [PATCH 147/163] Chunk batches: encode each column once a tick, its new sections on warm-up threads Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/lan/chunks.rs | 366 +++++++++++++++++++----- crates/horizon-client/src/lan/hub.rs | 197 ++++++++----- 2 files changed, 415 insertions(+), 148 deletions(-) diff --git a/crates/horizon-client/src/lan/chunks.rs b/crates/horizon-client/src/lan/chunks.rs index a9cf57a7d..35339a05c 100644 --- a/crates/horizon-client/src/lan/chunks.rs +++ b/crates/horizon-client/src/lan/chunks.rs @@ -15,7 +15,13 @@ use horizon_protocol::{ registry::{Builtin, ceil_log2}, }; use horizon_world::nbt::Tag; -use std::{collections::HashMap, sync::Arc}; +use std::{ + collections::HashMap, + sync::{ + Arc, OnceLock, + atomic::{AtomicUsize, Ordering}, + }, +}; const NON_AIR: u8 = 1; const FLUID: u8 = 2; @@ -83,12 +89,10 @@ pub fn block_entity_type(name: &str) -> Option<&'static str> { /// Per-state facts and registry ids for encoding chunks. pub struct ChunkEncoder { - flags: Vec<u8>, + /// What encoding a section needs, shared with the warm-up threads. + coder: Arc<SectionCoder>, /// Block entity type id per state (-1 for none). entity_types: Vec<i16>, - /// Network biome id per internal biome index. - pub biome_ids: Vec<i32>, - biome_bits: u8, /// The block registry id of each state's block, for BlockEvent. pub block_ids: Vec<i32>, /// The save's tables, for the heightmaps. @@ -104,6 +108,14 @@ pub struct ChunkEncoder { sky: bool, } +/// Per-state flags and biome ids: all a section's encoding reads. +struct SectionCoder { + flags: Vec<u8>, + /// Network biome id per internal biome index. + biome_ids: Vec<i32>, + biome_bits: u8, +} + /// A column's client heightmaps, valid while it holds the same sections. struct Heights { sections: Vec<std::sync::Weak<Section>>, @@ -170,8 +182,151 @@ impl Layers { } } +impl SectionCoder { + /// LevelChunkSection.write, and its block entity blocks. + fn wire(&self, section: &Section) -> (Arc<[u8]>, Entities) { + let (encoded, entities) = self.section(section); + let mut w = horizon_protocol::buf::Writer::new(); + encoded.write(&mut w); + (w.data.into(), entities.into()) + } + + fn section(&self, section: &Section) -> (horizon_protocol::chunk::Section, Vec<(u16, u32)>) { + let mut values = Vec::with_capacity(BLOCKS); + let (mut non_empty, mut fluids, mut entities) = (0i16, 0i16, Vec::new()); + let mut count = |state: u32, n: i16| { + let f = self.flags.get(state as usize).copied().unwrap_or(0); + if f & NON_AIR != 0 { + non_empty += n; + if f & FLUID != 0 { + fluids += n; + } + } + f & ENTITY != 0 + }; + // One block everywhere (all air, mostly): what from_values would give. + let uniform = section.blocks.uniform(); + if let Some(v) = uniform { + if count(v, BLOCKS as i16) { + entities = (0..BLOCKS as u16).map(|i| (i, v)).collect(); + } + } else { + let mut unpacked = [0u32; BLOCKS]; + section.unpack(&mut unpacked); + for (i, &v) in unpacked.iter().enumerate() { + if count(v, 1) { + entities.push((i as u16, v)); + } + values.push(v as i32); + } + } + let biome_values: Vec<i32> = (0..BIOMES) + .map(|j| { + let internal = section.biomes.get(j) as u16; + self.biome_ids + .get(usize::from(internal)) + .copied() + .unwrap_or(0) + }) + .collect(); + ( + horizon_protocol::chunk::Section { + non_empty, + fluids, + states: match uniform { + Some(v) => Paletted { + bits: 0, + palette: vec![v as i32], + data: Vec::new(), + }, + None => Paletted::from_values( + &values, + Strategy::Blocks, + crate::chunk::block_strategy().global_bits, + ), + }, + biomes: Paletted::from_values(&biome_values, Strategy::Biomes, self.biome_bits), + }, + entities, + ) + } +} + /// Sections kept before the ones no longer resident are dropped. const CACHE_SWEEP: usize = 1 << 15; + +/// Uncached sections below which a batch is encoded on the tick's thread +/// alone: waking the warm-up threads costs more than a few sections. +const WARM_MIN: usize = 16; + +/// Sections a batch needs, each taken by whichever thread is free first, +/// and what each gave: its wire bytes and, with varying light, its layers. +struct Warm { + coder: Arc<SectionCoder>, + sections: Vec<Arc<Section>>, + next: AtomicUsize, + done: Vec<OnceLock<Warmed>>, +} +type Warmed = ((Arc<[u8]>, Entities), Option<Arc<Layers>>); +impl Warm { + /// Encode sections until none is left to take. + fn run(&self) { + loop { + let i = self.next.fetch_add(1, Ordering::Relaxed); + let Some(s) = self.sections.get(i) else { + return; + }; + let light = matches!(s.light, Light::Full(_)).then(|| Arc::new(Layers::of(&s.light))); + let _ = self.done[i].set((self.coder.wire(s), light)); + } + } +} + +/// The warm-up threads (one per core besides the tick's) and the job they +/// take: its number, and the job while it has sections left to take. +struct WarmPool { + job: std::sync::Mutex<(u64, Option<Arc<Warm>>)>, + ready: std::sync::Condvar, +} + +/// The warm-up threads, started the first time; none on a single core or +/// when no thread could start. +fn warm_pool() -> Option<&'static WarmPool> { + static POOL: OnceLock<Option<Arc<WarmPool>>> = OnceLock::new(); + POOL.get_or_init(|| { + let threads = std::thread::available_parallelism().map_or(1, |n| n.get()) - 1; + let pool = Arc::new(WarmPool { + job: Default::default(), + ready: Default::default(), + }); + let started = (0..threads) + .filter(|i| { + let pool = pool.clone(); + std::thread::Builder::new() + .name(format!("horizon-chunk-encode-{i}")) + .spawn(move || { + let mut done = 0; + loop { + let job = { + let mut slot = pool.job.lock().unwrap(); + while slot.0 == done { + slot = pool.ready.wait(slot).unwrap(); + } + done = slot.0; + slot.1.clone() + }; + if let Some(job) = job { + job.run(); + } + } + }) + .is_ok() + }) + .count(); + (started > 0).then_some(pool) + }) + .as_deref() +} impl ChunkEncoder { /// `biome_names`: the internal biome list in order; `biome_registry`: /// the synchronized biome entries in network order. @@ -218,10 +373,12 @@ impl ChunkEncoder { }) .collect(); Self { - flags, + coder: Arc::new(SectionCoder { + flags, + biome_ids, + biome_bits: ceil_log2(biome_registry.len()), + }), entity_types, - biome_ids, - biome_bits: ceil_log2(biome_registry.len()), block_ids, tables: None, cache: Default::default(), @@ -297,7 +454,8 @@ impl ChunkEncoder { /// LevelChunkSection.hasOnlyAir, negated. fn non_air(&self, section: &Section) -> bool { - let non_air = |v: u32| self.flags.get(v as usize).copied().unwrap_or(0) & NON_AIR != 0; + let non_air = + |v: u32| self.coder.flags.get(v as usize).copied().unwrap_or(0) & NON_AIR != 0; // The palette first: most sections are all air, or one block. if !section.blocks.maybe_has(non_air) { false @@ -314,10 +472,7 @@ impl ChunkEncoder { if let Some(wire) = self.cached(section, |e| e.wire.clone()) { return wire; } - let (encoded, entities) = self.section(section); - let mut w = horizon_protocol::buf::Writer::new(); - encoded.write(&mut w); - let wire: (Arc<[u8]>, Entities) = (w.data.into(), entities.into()); + let wire = self.coder.wire(section); self.cached(section, |e| e.wire = Some(wire.clone())); wire } @@ -340,71 +495,12 @@ impl ChunkEncoder { .map(|t| i32::from(*t)) } pub fn is_air(&self, state: u32) -> bool { - self.flags + self.coder + .flags .get(state as usize) .is_none_or(|f| f & NON_AIR == 0) } - fn section(&self, section: &Section) -> (horizon_protocol::chunk::Section, Vec<(u16, u32)>) { - let mut values = Vec::with_capacity(BLOCKS); - let (mut non_empty, mut fluids, mut entities) = (0i16, 0i16, Vec::new()); - let mut count = |state: u32, n: i16| { - let f = self.flags.get(state as usize).copied().unwrap_or(0); - if f & NON_AIR != 0 { - non_empty += n; - if f & FLUID != 0 { - fluids += n; - } - } - f & ENTITY != 0 - }; - // One block everywhere (all air, mostly): what from_values would give. - let uniform = section.blocks.uniform(); - if let Some(v) = uniform { - if count(v, BLOCKS as i16) { - entities = (0..BLOCKS as u16).map(|i| (i, v)).collect(); - } - } else { - let mut unpacked = [0u32; BLOCKS]; - section.unpack(&mut unpacked); - for (i, &v) in unpacked.iter().enumerate() { - if count(v, 1) { - entities.push((i as u16, v)); - } - values.push(v as i32); - } - } - let biome_values: Vec<i32> = (0..BIOMES) - .map(|j| { - let internal = section.biomes.get(j) as u16; - self.biome_ids - .get(usize::from(internal)) - .copied() - .unwrap_or(0) - }) - .collect(); - ( - horizon_protocol::chunk::Section { - non_empty, - fluids, - states: match uniform { - Some(v) => Paletted { - bits: 0, - palette: vec![v as i32], - data: Vec::new(), - }, - None => Paletted::from_values( - &values, - Strategy::Blocks, - crate::chunk::block_strategy().global_bits, - ), - }, - biomes: Paletted::from_values(&biome_values, Strategy::Biomes, self.biome_bits), - }, - entities, - ) - } - /// The chunk column with its light and block entities. /// The non-air sections of a column as bits (LevelChunkSection.hasOnlyAir). fn occupied(&self, chunk: &Chunk) -> u64 { @@ -442,6 +538,65 @@ impl ChunkEncoder { self.body(chunk, &world.block_entities, self.around(chunk, world)) } + /// Encode the sections of these columns not cached yet before their + /// bodies are made, shared out to the warm-up threads: a batch of new + /// terrain costs mostly its sections' first encoding. This thread takes + /// sections too until none is left, then caches what is done; it never + /// waits for the other threads (they keep their results to themselves + /// until then), and a section one of them is still on is encoded again + /// by `body_in`, with the same bytes. + pub fn warm(&self, columns: &[&Chunk]) { + let sections: Vec<Arc<Section>> = { + let cache = self.cache.lock().unwrap(); + columns + .iter() + .flat_map(|c| &c.sections[self.sections.clone()]) + .filter(|s| { + cache + .get(&(Arc::as_ptr(s) as usize)) + .is_none_or(|e| e.wire.is_none()) + }) + .cloned() + .collect() + }; + if sections.len() < WARM_MIN { + return; + } + let Some(pool) = warm_pool() else { + return; + }; + let job = Arc::new(Warm { + coder: self.coder.clone(), + done: sections.iter().map(|_| OnceLock::new()).collect(), + sections, + next: AtomicUsize::new(0), + }); + { + let mut slot = pool.job.lock().unwrap(); + slot.0 += 1; + slot.1 = Some(job.clone()); + } + pool.ready.notify_all(); + job.run(); + // Every section is claimed: the job leaves the slot. + { + let mut slot = pool.job.lock().unwrap(); + if slot.1.as_ref().is_some_and(|j| Arc::ptr_eq(j, &job)) { + slot.1 = None; + } + } + let mut cache = self.cache.lock().unwrap(); + for (s, done) in job.sections.iter().zip(&job.done) { + if let Some((wire, light)) = done.get() { + let e = self.entry(&mut cache, s); + e.wire = Some(wire.clone()); + if light.is_some() { + e.light = light.clone(); + } + } + } + } + fn body( &self, chunk: &Chunk, @@ -930,7 +1085,7 @@ mod tests { /// The bytes on the wire for a section, encoded afresh. fn fresh(encoder: &ChunkEncoder, section: &Section) -> Vec<u8> { let mut w = horizon_protocol::buf::Writer::new(); - encoder.section(section).0.write(&mut w); + encoder.coder.section(section).0.write(&mut w); w.data } @@ -1077,6 +1232,67 @@ mod tests { ); } + /// Columns whose sections the warm-up threads encoded give the bytes + /// each gives on its own, also with a column twice and its neighbours' + /// sections deciding the light layers. + #[test] + fn warmed_columns_give_the_same_bodies() { + let builtin = Builtin::parse( + r#"{"minecraft:block_entity_type": {"entries": { + "minecraft:sign": {"protocol_id": 7}}}}"#, + ) + .unwrap(); + let states = [ + "minecraft:air", + "minecraft:stone", + "minecraft:water", + "minecraft:oak_sign", + ] + .map(|n| (Arc::<str>::from(n), n.ends_with("water"))); + let mut world = crate::world::World::new(horizon_world::registry::BlockStateId(0), 0); + for x in -2..2 { + for z in -2..2 { + let mut chunk = Chunk::empty(x, z); + let n = (x * 7 + z * 13).rem_euclid(17); + for i in 0..40 + n * 30 { + let (bx, bz) = ((i * 5 + n) % 16, (i * 11) % 16); + chunk.set(bx, MIN_Y + (i * 37 + n * 50) % 384, bz, 1 + (i % 3) as u32); + } + let mut light = Box::new([0u8; 4096]); + for (i, v) in light.iter_mut().enumerate() { + *v = (i * 31 + n as usize) as u8; + } + Arc::make_mut(&mut chunk.sections[(n % 24) as usize]).light = Light::Full(light); + world.block_entities.insert( + (x * 16 + 2, 70, z * 16 + 3), + BlockEntity::Sign(crate::signs::SignData::default()), + ); + chunk.set(2, 70, 3, 3); + world.chunks.insert((x, z), Arc::new(chunk)); + } + } + let mut keys: Vec<(i32, i32)> = + (-2..2).flat_map(|x| (-2..2).map(move |z| (x, z))).collect(); + keys.push(keys[5]); + let chunks: Vec<&Chunk> = keys + .iter() + .map(|k| &**world.chunks.get(k).unwrap()) + .collect(); + let alone = ChunkEncoder::new(states.clone(), &builtin, &[], &[]); + let expected: Vec<Vec<u8>> = chunks.iter().map(|c| alone.body_in(c, &world)).collect(); + let warmed = ChunkEncoder::new(states, &builtin, &[], &[]); + let bodies = |encoder: &ChunkEncoder| -> Vec<Vec<u8>> { + chunks.iter().map(|c| encoder.body_in(c, &world)).collect() + }; + assert!(chunks.len() * SECTIONS >= WARM_MIN); + warmed.warm(&chunks); + assert_eq!(bodies(&warmed), expected); + // Again, from the cache, with nothing left to warm. + warmed.warm(&chunks); + assert_eq!(bodies(&warmed), expected); + warmed.warm(&[]); + } + #[test] fn a_nether_column_sends_its_sixteen_sections_without_sky_light() { let chunk = Chunk::empty(0, 0); diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index 9ec3eca2d..b96b9a001 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -12,6 +12,7 @@ use super::{ guest::{Guest, SentEffect, stack_to_network}, }; use crate::{ + chunk::Chunk, collisions::SceneCollisions, effects::{EffectInstance, PlayerEffects}, items::ItemStack, @@ -1027,11 +1028,7 @@ impl Hub { ctx.world.light_log = Some(Default::default()); } self.sync_world(ctx); - for i in 0..self.guests.len() { - if self.here(&self.guests[i]) { - self.update_chunks(i, ctx); - } - } + crate::spans::time("lan_chunks", || self.update_chunks(ctx)); self.broadcast_light_changes(ctx.world); self.broadcast_block_changes(ctx.world); // ServerGamePacketListenerImpl.tick: the actions handled since the last tick are @@ -1170,86 +1167,140 @@ impl Hub { // ---- chunks -------------------------------------------------------- - fn update_chunks(&mut self, i: usize, ctx: &TickCtx) { + /// Every player's chunks here: their views, then the next batch of each + /// (PlayerChunkSender.sendNextChunks). The batches are chosen first, the + /// columns in them encoded once each, their new sections on the warm-up + /// threads too (`ChunkEncoder::warm`), then sent: nothing changes the + /// level in between, and each player's packets keep their order. + fn update_chunks(&mut self, ctx: &TickCtx) { + let world = &*ctx.world; + let mut batches = Vec::new(); + for i in 0..self.guests.len() { + if self.here(&self.guests[i]) { + self.update_view(i); + if let Some(batch) = self.next_batch(i, world) { + batches.push((i, batch)); + } + } + } + if batches.is_empty() { + return; + } + // Each column once, however many players it goes to, with the + // number of batches that take it. + let (mut columns, mut uses): (Vec<&Chunk>, Vec<usize>) = Default::default(); + let mut index = crate::fast_hash::FxHashMap::default(); + let batches: Vec<(usize, Vec<usize>, Vec<usize>)> = batches + .into_iter() + .map(|(i, batch)| { + let (taken, bodies) = batch + .into_iter() + .map(|(idx, chunk)| { + let j = *index.entry((chunk.x, chunk.z)).or_insert_with(|| { + columns.push(chunk); + uses.push(0); + columns.len() - 1 + }); + uses[j] += 1; + (idx, j) + }) + .unzip(); + (i, taken, bodies) + }) + .collect(); + self.encoder.warm(&columns); + let mut bodies: Vec<Vec<u8>> = columns + .iter() + .map(|c| self.encoder.body_in(c, world)) + .collect(); + for (i, taken, batch) in batches { + let g = &mut self.guests[i]; + let size = batch.len(); + g.batch_quota -= size as f32; + g.send(&C::ChunkBatchStart(horizon_protocol::packets::Empty)); + g.sender.send_many(batch.into_iter().map(|j| { + uses[j] -= 1; + if uses[j] == 0 { + std::mem::take(&mut bodies[j]) + } else { + bodies[j].clone() + } + })); + g.send(&C::ChunkBatchFinished(play::ChunkBatchFinished { + size: size as i32, + })); + g.unacknowledged += 1; + for idx in taken.into_iter().rev() { + let key = g.chunk_queue.remove(idx); + g.sent_chunks.insert(key); + } + } + } + + /// ChunkMap.move's view change: the new centre, the chunks that left + /// the view forgotten and the ones that entered it queued, closest first. + fn update_view(&mut self, i: usize) { let (cx, cz) = self.guests[i].chunk(); let r = self.guests[i].view_distance; let g = &mut self.guests[i]; - if g.center != Some((cx, cz)) { - g.center = Some((cx, cz)); - if g.center_sent.take() != Some((cx, cz)) { - g.send(&C::SetChunkCacheCenter(play::SetChunkCacheCenter { - x: cx, - z: cz, - })); - } - // Chunks that left the view. - let forget: Vec<_> = g - .sent_chunks - .iter() - .copied() - .filter(|&(x, z)| !tracked(cx, cz, r, x, z)) - .collect(); - for (x, z) in forget { - g.sent_chunks.remove(&(x, z)); - g.send(&C::ForgetLevelChunk(play::ForgetLevelChunk { pos: [x, z] })); - } - g.chunk_queue.retain(|&(x, z)| tracked(cx, cz, r, x, z)); - for dz in -r - 2..=r + 2 { - for dx in -r - 2..=r + 2 { - let key = (cx + dx, cz + dz); - if tracked(cx, cz, r, key.0, key.1) - && !g.sent_chunks.contains(&key) - && !g.chunk_queue.contains(&key) - { - g.chunk_queue.push(key); - } + if g.center == Some((cx, cz)) { + return; + } + g.center = Some((cx, cz)); + if g.center_sent.take() != Some((cx, cz)) { + g.send(&C::SetChunkCacheCenter(play::SetChunkCacheCenter { + x: cx, + z: cz, + })); + } + // Chunks that left the view. + let forget: Vec<_> = g + .sent_chunks + .iter() + .copied() + .filter(|&(x, z)| !tracked(cx, cz, r, x, z)) + .collect(); + for (x, z) in forget { + g.sent_chunks.remove(&(x, z)); + g.send(&C::ForgetLevelChunk(play::ForgetLevelChunk { pos: [x, z] })); + } + g.chunk_queue.retain(|&(x, z)| tracked(cx, cz, r, x, z)); + for dz in -r - 2..=r + 2 { + for dx in -r - 2..=r + 2 { + let key = (cx + dx, cz + dz); + if tracked(cx, cz, r, key.0, key.1) + && !g.sent_chunks.contains(&key) + && !g.chunk_queue.contains(&key) + { + g.chunk_queue.push(key); } } - g.chunk_queue - .sort_by_key(|&(x, z)| i64::from(x - cx).pow(2) + i64::from(z - cz).pow(2)); } - // PlayerChunkSender.sendNextChunks: ready chunks, closest first, in - // batches the client's acknowledgements pace. + g.chunk_queue + .sort_by_key(|&(x, z)| i64::from(x - cx).pow(2) + i64::from(z - cz).pow(2)); + } + + /// PlayerChunkSender.sendNextChunks' choice: ready chunks, closest first, + /// as many as the batch quota the client's acknowledgements pace allows, + /// with their places in the queue. + fn next_batch<'w>(&mut self, i: usize, world: &'w World) -> Option<Vec<(usize, &'w Chunk)>> { + let g = &mut self.guests[i]; if self.ticks <= g.placed_at + 1 || g.unacknowledged >= g.max_unacknowledged { - return; + return None; } g.batch_quota = (g.batch_quota + g.chunks_per_tick).min(g.chunks_per_tick.max(1.0)); if g.batch_quota < 1.0 || g.chunk_queue.is_empty() { - return; + return None; } let budget = g.batch_quota.floor() as usize; - let mut packets = Vec::new(); - let mut taken = Vec::new(); - for (idx, key) in g.chunk_queue.iter().enumerate() { - if packets.len() >= budget { - break; - } - let Some(chunk) = ctx.world.chunks.get(key) else { - continue; - }; - if !chunk.lit { - continue; - } - packets.push(self.encoder.body_in(chunk, ctx.world)); - taken.push(idx); - } - if packets.is_empty() { - return; - } - let size = packets.len(); - g.batch_quota -= size as f32; - g.send(&C::ChunkBatchStart(horizon_protocol::packets::Empty)); - for body in packets { - g.sender.send(body); - } - g.send(&C::ChunkBatchFinished(play::ChunkBatchFinished { - size: size as i32, - })); - g.unacknowledged += 1; - for idx in taken.into_iter().rev() { - let key = g.chunk_queue.remove(idx); - g.sent_chunks.insert(key); - } + let batch: Vec<_> = g + .chunk_queue + .iter() + .enumerate() + .filter_map(|(idx, key)| Some((idx, &**world.chunks.get(key).filter(|c| c.lit)?))) + .take(budget) + .collect(); + (!batch.is_empty()).then_some(batch) } /// Resend a chunk to everyone who has it (a block entity changed, relight). From f1d5bf520986b00a5b968a84d85809fca1a039fa Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 20:57:07 +0200 Subject: [PATCH 148/163] server_bench: compare each bot count's work across servers, and flag runs that aren't equal Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- tests/test_server_bench.py | 32 +++++++++++++++++++++++++ tools/server_bench.py | 48 ++++++++++++++++++++++++++++++++++++-- 2 files changed, 78 insertions(+), 2 deletions(-) create mode 100644 tests/test_server_bench.py diff --git a/tests/test_server_bench.py b/tests/test_server_bench.py new file mode 100644 index 000000000..f392297bc --- /dev/null +++ b/tests/test_server_bench.py @@ -0,0 +1,32 @@ +import unittest + +from tools.server_bench import work + + +def run(server, bots, sent, new, waited=0.0, behaviour="mixed"): + return {"server": server, "behaviour": behaviour, "bots": bots, "chunks_per_second": sent, + "unique_per_second": new, "waited_ticks_per_second": waited} + + +class ServerBenchWorkTests(unittest.TestCase): + def test_shares_of_the_busiest_server(self): + [row] = work([run("horizon", 10, 98.2, 36.5), run("vanilla", 10, 24.3, 19.1, 12.0)]) + self.assertFalse(row["equal"]) + self.assertEqual(row["servers"]["horizon"]["chunks_per_second"], {"value": 98.2, "share": 1.0}) + self.assertEqual(row["servers"]["vanilla"]["chunks_per_second"]["share"], 0.247) + self.assertEqual(row["servers"]["vanilla"]["waited_ticks_per_second"], 12.0) + + def test_equal_within_ten_percent_or_a_chunk(self): + [row] = work([run("horizon", 25, 236, 28.9), run("vanilla", 25, 252, 28.9)]) + self.assertTrue(row["equal"]) + # One bot: 0.3 against 1.1 new chunks a second is within a chunk. + [row] = work([run("horizon", 1, 9.9, 0.3), run("vanilla", 1, 9.9, 1.1)]) + self.assertTrue(row["equal"]) + + def test_only_counts_run_on_several_servers(self): + failed = dict(run("vanilla", 50, 0, 0), error="watchdog") + self.assertEqual(work([run("horizon", 50, 450, 10), failed, run("horizon", 1, 9, 0.3)]), []) + + +if __name__ == "__main__": + unittest.main() diff --git a/tools/server_bench.py b/tools/server_bench.py index c79d6aab1..0ba99617a 100755 --- a/tools/server_bench.py +++ b/tools/server_bench.py @@ -19,7 +19,9 @@ The bots can run on another machine, so they don't take the server's CPU: `--bot `--bots-bin` naming horizon-bots there and `--connect` the address it reaches this machine at. `--nice 19` runs every server at the lowest priority (a shared machine). The explore bots fly as fast as each server sends them chunks, so a faster server gets more terrain to generate; `--explore-speed` slows them to a rate -both servers keep up with, for equal work. +both servers keep up with, for equal work. After the runs, the work table compares the servers at each bot +count: chunks sent and new chunks generated a second, against the busiest server's. A run whose work is more +than 10 % apart isn't a fair comparison of its tick times. The vanilla side runs the pinned server jar from tools/lab.py prepare (your own copy). It needs Java 25. The Horizon side runs target/release/horizon-server with the engine beside it; build both first: @@ -306,6 +308,38 @@ def run_once(kind, bots, behaviour, args, out): return result +# How far apart two servers' chunks a second (sent, and new) may be and still count as the same work: 10 %, +# or a chunk a second when there are few. +EQUAL_WORK = 0.10 + + +def work(runs): + """Each pass and bot count that ran on more than one server: every server's chunks sent and new chunks a + second as a share of the busiest one's, the ticks a second its bots stood waiting for their own chunk, + and whether the work was equal (within EQUAL_WORK on both).""" + groups = {} + for r in runs: + if 'error' not in r: + groups.setdefault((r['behaviour'], r['bots']), []).append(r) + rows = [] + for (behaviour, bots), group in groups.items(): + if len(group) < 2: + continue + row = {'behaviour': behaviour, 'bots': bots, 'servers': {}, 'equal': True} + for key in ('chunks_per_second', 'unique_per_second'): + top = max(r.get(key) or 0 for r in group) + for r in group: + value = r.get(key) or 0 + share = round(value / top, 3) if top else 1.0 + row['servers'].setdefault(r['server'], {})[key] = {'value': value, 'share': share} + if top - value > max(EQUAL_WORK * top, 1.0): + row['equal'] = False + for r in group: + row['servers'][r['server']]['waited_ticks_per_second'] = r.get('waited_ticks_per_second') + rows.append(row) + return rows + + def main(): parser = argparse.ArgumentParser(description=__doc__.split('\n\n')[0]) parser.add_argument('--servers', default='horizon,vanilla') @@ -346,6 +380,7 @@ def main(): 'java': subprocess.run(['java', '--version'], capture_output=True, text=True).stdout.splitlines()[:1], 'settings': {**vars(args), 'out': str(args.out), 'properties': PROPERTIES}, 'runs': runs, + 'work': work(runs), } path = args.out or out / 'report.json' path.parent.mkdir(parents=True, exist_ok=True) @@ -356,11 +391,20 @@ def main(): if 'error' in r: print(f'{r["server"]:8} {r["behaviour"]:8} {r["bots"]:>4} failed: {r["error"].splitlines()[0]}') continue - per_bot = r['chunks_per_bot'].get(r['behaviour']) + # A mixed pass: every bot's. + per_bot = r['chunks_per_bot'].get(r['behaviour']) or round((r['chunks_total'] or 0) / r['bots']) print(f'{r["server"]:8} {r["behaviour"]:8} {r["bots"]:>4} {r["start_seconds"]:>8} {r["mspt"]["average"]!s:>6} ' f'{r["mspt"]["p95"]!s:>6} {r["mspt"]["p99"]!s:>6} {r["rss_mb"]["mean"]!s:>7} {r["cpu_percent"]!s:>6} ' f'{r["chunks_per_second"]!s:>8} {per_bot!s:>6} {r["resent"]!s:>6} {r["pulled_back"]!s:>6} ' f'{r["bots_joined"]!s:>6}') + if report['work']: + print(f'\nWork, against the busiest server (chunks a second sent, new; ticks a second bots waited):') + for row in report['work']: + cells = ' '.join( + f'{server} {w["chunks_per_second"]["value"]} ({w["chunks_per_second"]["share"]:.0%}), ' + f'{w["unique_per_second"]["value"]} ({w["unique_per_second"]["share"]:.0%}), ' + f'{w["waited_ticks_per_second"]}' for server, w in row['servers'].items()) + print(f'{row["behaviour"]:8} {row["bots"]:>4} {"equal" if row["equal"] else "NOT EQUAL"} {cells}') print(f'\nWrote {path}') From 00343ad2e28218c8c644d46f58467869de654b65 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 19:30:23 +0200 Subject: [PATCH 149/163] Chunk packets: pack a paletted container a long at a time Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-protocol/src/chunk.rs | 24 ++++++++++++++++++------ 1 file changed, 18 insertions(+), 6 deletions(-) diff --git a/crates/horizon-protocol/src/chunk.rs b/crates/horizon-protocol/src/chunk.rs index 32d7f98b6..165627d90 100644 --- a/crates/horizon-protocol/src/chunk.rs +++ b/crates/horizon-protocol/src/chunk.rs @@ -57,6 +57,19 @@ pub fn storage_len(bits: u8, entries: usize) -> usize { } } +/// SimpleBitStorage's longs for `values` at `bits` each, a long at a time. +fn pack<T>(values: &[T], bits: u8, id: impl Fn(&T) -> u64) -> Vec<i64> { + let per = 64 / bits as usize; + values + .chunks(per) + .map(|word| { + word.iter() + .enumerate() + .fold(0u64, |w, (k, v)| w | id(v) << (k * bits as usize)) as i64 + }) + .collect() +} + /// One PalettedContainer as sent. #[derive(Clone, Debug, PartialEq)] pub struct Paletted { @@ -160,12 +173,11 @@ impl Paletted { data: Vec::new(), }; } - let mut data = vec![0i64; storage_len(bits, values.len())]; - let per = 64 / bits as usize; - for (i, (&v, &id)) in values.iter().zip(&ids).enumerate() { - let id = if has_palette { u64::from(id) } else { v as u64 }; - data[i / per] |= (id << ((i % per) * bits as usize)) as i64; - } + let data = if has_palette { + pack(&ids, bits, |&id| u64::from(id)) + } else { + pack(values, bits, |&v| v as u64) + }; Self { bits, palette: if has_palette { palette } else { Vec::new() }, From 41bd91f295dc5f1d57f371089c105a4f417cc0e7 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 21:35:47 +0200 Subject: [PATCH 150/163] CI: cancel a pull request's unfinished checks when it closes A merged or closed pull request's queued runs held the self-hosted runners until someone cancelled them by hand. pull_request_target lets the token cancel runs of fork pull requests too; the job checks out nothing. It matches the branch and the head commit, so a fork's branch named like another doesn't cancel that one's runs. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .github/workflows/cancel-on-close.yml | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 .github/workflows/cancel-on-close.yml diff --git a/.github/workflows/cancel-on-close.yml b/.github/workflows/cancel-on-close.yml new file mode 100644 index 000000000..9a6e44965 --- /dev/null +++ b/.github/workflows/cancel-on-close.yml @@ -0,0 +1,27 @@ +name: cancel-on-close +# A closed or merged pull request's queued and running checks free the runners at once. +# pull_request_target so the token can cancel runs of pull requests from forks too; +# it checks out nothing and runs no code from the pull request. +on: + pull_request_target: + types: [closed] +permissions: + actions: write +jobs: + cancel: + runs-on: ubuntu-latest + steps: + - name: Cancel the pull request's unfinished runs + env: + GH_TOKEN: ${{ github.token }} + REPO: ${{ github.repository }} + BRANCH: ${{ github.event.pull_request.head.ref }} + SHA: ${{ github.event.pull_request.head.sha }} + run: | + for status in queued in_progress waiting pending requested; do + gh run list -R "$REPO" --branch "$BRANCH" --status "$status" --limit 100 \ + --json databaseId,event,headSha \ + -q ".[] | select(.event == \"pull_request\" and .headSha == \"$SHA\") | .databaseId" + done | sort -u | while read -r id; do + gh run cancel -R "$REPO" "$id" || true + done From 82c8de262f3d10f16c0126c78f55a986f59b1428 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 20:55:14 +0200 Subject: [PATCH 151/163] Repurposed's mineshafts: laid out under the terrain, carried as jigsaws Repurposed Structures' 10 overworld mineshafts (birch, desert, icy, jungle, ocean...) are its generic jigsaw with one change in MineshaftStructure.postLayoutAdjustments: the layout is not centred on the chunk; its top goes 15 blocks under the lowest ocean floor at the chunk's middle and 16 blocks to each side (taking one off after each side, as the mod does), never up, within y_allowance. - Game: "layout": "mineshaft" in horizon:piece_limited runs that step. - Carry: repurposed_structures:generic_mineshaft becomes minecraft:jigsaw with the piece-limited layout and that key, as its generic jigsaw does. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/worldgen.rs | 21 ++++- .../src/worldgen/structure/piece_limited.rs | 77 ++++++++++++++++++- 2 files changed, 96 insertions(+), 2 deletions(-) diff --git a/crates/horizon-port-pack/src/worldgen.rs b/crates/horizon-port-pack/src/worldgen.rs index 7de9f39ce..ce5dc23fe 100644 --- a/crates/horizon-port-pack/src/worldgen.rs +++ b/crates/horizon-port-pack/src/worldgen.rs @@ -42,6 +42,9 @@ const REPURPOSED_CHECKED: [(&str, &str); 3] = [ ), ("repurposed_structures:stronghold_end", "stronghold_end"), ]; +/// Repurposed Structures' mineshaft: its generic jigsaw laid out under the +/// terrain (`"layout": "mineshaft"` in `horizon:piece_limited`). +const REPURPOSED_MINESHAFT: &str = "repurposed_structures:generic_mineshaft"; /// Layout rules the piece-limited assembler keeps (`horizon:piece_limited`). const PIECE_LIMITED_RULES: [&str; 4] = [ "y_allowance", @@ -421,8 +424,10 @@ fn upgrade_types( Some(t) if JIGSAWS.contains(&t) || NETHER_JIGSAWS.contains(&t) + || t == REPURPOSED_MINESHAFT || REPURPOSED_CHECKED.iter().any(|(r, _)| *r == t) => { + let mineshaft = t == REPURPOSED_MINESHAFT; let check = REPURPOSED_CHECKED.iter().find(|(r, _)| *r == t); let check = check.map(|(_, c)| *c); let library = match t.split_once(':').map(|(ns, _)| ns) { @@ -435,7 +440,10 @@ fn upgrade_types( } else { "lowest" }; - let limited = library.map(|l| piece_limited(v, l)); + let mut limited = library.map(|l| piece_limited(v, l)); + if let Some(limited) = limited.as_mut().filter(|_| mineshaft) { + limited["layout"] = "mineshaft".into(); + } start_checks(v, liquid, lost, limited.is_some()); if let Some(check) = check { if !v["horizon:start_checks"].is_object() { @@ -1345,6 +1353,17 @@ mod tests { moogs["horizon:piece_limited"], json!({"library": "moogs", "burying": "average_land"}) ); + // Repurposed's mineshaft is laid out under the terrain. + let mut mineshaft = json!({"type": "repurposed_structures:generic_mineshaft", + "start_pool": "rs:mineshafts/birch/start_pool", "size": 9, + "liquid_settings": "ignore_waterlogging"}); + assert!(upgrade("structure", &mut mineshaft, &mut report, &NO_TAGS)); + assert_eq!(mineshaft["type"], "minecraft:jigsaw"); + assert_eq!( + mineshaft["horizon:piece_limited"], + json!({"library": "repurposed", "layout": "mineshaft"}) + ); + assert_eq!(mineshaft["liquid_settings"], "ignore_waterlogging"); // Lithostitched's jigsaw is vanilla's: no key. let mut litho = json!({"type": "lithostitched:jigsaw"}); assert!(upgrade("structure", &mut litho, &mut report, &NO_TAGS)); diff --git a/crates/horizon-world/src/worldgen/structure/piece_limited.rs b/crates/horizon-world/src/worldgen/structure/piece_limited.rs index 1372f247b..753df0258 100644 --- a/crates/horizon-world/src/worldgen/structure/piece_limited.rs +++ b/crates/horizon-world/src/worldgen/structure/piece_limited.rs @@ -13,7 +13,8 @@ //! "ignore_bounds_pools": ["x:pool"], //! "land_search": "highest_land", // the Nether variants: or "lowest_land", "fixed_height" //! "ledge_offset_y": 2, -//! "pieces": [{"name": "x:piece", "required": 1, "min_depth": 3, "max": 2}] +//! "pieces": [{"name": "x:piece", "required": 1, "min_depth": 3, "max": 2}], +//! "layout": "mineshaft" // Repurposed's mineshafts: moved under the terrain //! } //! ``` //! @@ -25,6 +26,8 @@ //! (`required`, from `min_depth`), the whole layout retried up to 40 times //! until every required piece is in, and after it the pieces centred on the //! chunk corner, then buried in the terrain or moved onto Nether land. +//! Repurposed's overworld mineshafts are not centred: their top goes 15 +//! blocks under the terrain around the chunk. use super::{ BoundingBox, Rotation, StructureResources, StructureTemplate, jigsaw::{ @@ -63,6 +66,15 @@ pub enum Burying { LowestSide, } +/// The structure type's postLayoutAdjustments. +#[derive(Clone, Copy, Debug, PartialEq, Eq)] +pub enum Layout { + /// GenericJigsawStructure's: centred, then buried or moved onto land. + Generic, + /// Repurposed Structures' MineshaftStructure. + Mineshaft, +} + #[derive(Clone, Copy, Debug, PartialEq, Eq)] pub enum LandSearch { Highest, @@ -89,6 +101,7 @@ pub struct Config { ignore_bounds: HashSet<String>, land_search: Option<LandSearch>, ledge: i32, + layout: Layout, /// Counted templates by id, in the order of Java's HashMap of the /// required pieces (the first one still short is forced in first). pieces: Vec<(Identifier, Counted)>, @@ -152,6 +165,10 @@ impl Config { _ => None, }, ledge: int("ledge_offset_y").unwrap_or(0), + layout: match v["layout"].as_str() { + Some("mineshaft") => Layout::Mineshaft, + _ => Layout::Generic, + }, pieces: sorted, } } @@ -353,6 +370,10 @@ fn adjust( if pieces.is_empty() { return; } + if limits.layout == Layout::Mineshaft { + below_terrain(limits, context, start, pieces); + return; + } // GeneralUtils.centerAllPieces on the chunk's corner. let center = pieces[0].bounding_box.center(); let d = [start[0] - center[0], 0, start[2] - center[2]]; @@ -435,6 +456,44 @@ fn adjust( shift_all(limits, pieces, [0, dy, 0]); } +/// MineshaftStructure.postLayoutAdjustments: the layout's top moved to 15 +/// blocks under the lowest ocean floor at the chunk's middle and 16 blocks +/// to each side, within y_allowance; never up. +fn below_terrain( + limits: &Config, + context: &mut impl StartContext, + start: [i32; 3], + pieces: &mut [PoolPiece], +) { + let target = mineshaft_top(start, limits.min_y, |x, z| { + context.base_height(x, z, HeightmapType::OceanFloorWg) + }); + let top = pieces + .iter() + .map(|p| p.bounding_box.max[1]) + .max() + .unwrap_or(i32::MIN); + if target < limits.max_y.unwrap_or(i32::MAX) && target < top { + shift_all(limits, pieces, [0, target - top, 0]); + } +} + +/// Where [`below_terrain`] puts a mineshaft's top: `floor` is the first free +/// height over the ocean floor (getFirstFreeHeight, OCEAN_FLOOR_WG). +fn mineshaft_top( + start: [i32; 3], + min_y: Option<i32>, + mut floor: impl FnMut(i32, i32) -> i32, +) -> i32 { + let (x, z) = (start[0] + 7, start[2] + 7); + let mut terrain = floor(x, z) - 1; + // Plane.HORIZONTAL's order; the mod takes one more off after each. + for (dx, dz) in [(0, -16), (16, 0), (0, 16), (-16, 0)] { + terrain = terrain.min(floor(x + dx, z + dz)) - 1; + } + (terrain - 15).max(min_y.unwrap_or(i32::MIN)) +} + /// AVERAGE_LAND: the mean land height over a grid on the first piece's /// footprint; no structure when none of the heights is allowed. fn average_land( @@ -918,6 +977,22 @@ mod tests { assert_eq!(limits.library, Library::Repurposed); } + #[test] + fn mineshafts_go_under_the_lowest_floor_around() { + // Floor 80 at the middle (7, 7), 70 north, 90 east, 60 south, 85 west. + let floor = |x, z| match (x, z) { + (7, 7) => 80, + (7, -9) => 70, + (23, 7) => 90, + (7, 23) => 60, + (-9, 7) => 85, + other => panic!("{other:?}"), + }; + // 79, min(79, 70) - 1 = 69, 68, min(68, 60) - 1 = 59, 58; 15 under it. + assert_eq!(mineshaft_top([0, 50, 0], None, floor), 43); + assert_eq!(mineshaft_top([0, 50, 0], Some(48), floor), 48); + } + #[test] fn nether_land_is_found_in_the_column() { // A column from y 0: netherrack to 40, lava 41..=45, air, a ledge 70..=72. From e3909f4370f3628dc8b821690a2a043257b9344f Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 21:13:25 +0200 Subject: [PATCH 152/163] Carry: Better Dungeons' small Nether dungeon, as YUNG's jigsaw betterdungeons:small_nether_dungeon is YUNG's jigsaw structure (the same fields and YungJigsawManager assembly) behind the mod's smallNetherDungeons config switch, which ships on. Carry maps it as it maps yungsapi:yung_jigsaw: minecraft:jigsaw with horizon:yungsapi. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/worldgen.rs | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/crates/horizon-port-pack/src/worldgen.rs b/crates/horizon-port-pack/src/worldgen.rs index 7de9f39ce..9ab2f7f2d 100644 --- a/crates/horizon-port-pack/src/worldgen.rs +++ b/crates/horizon-port-pack/src/worldgen.rs @@ -414,7 +414,9 @@ fn upgrade_types( let mut unsupported = |t: &str| *report.unsupported.entry(t.to_owned()).or_default() += 1; let changed = match kind { "structure" => match v["type"].as_str() { - Some("yungsapi:yung_jigsaw") => { + // Better Dungeons' small Nether dungeon is YUNG's jigsaw behind a + // config switch that ships on. + Some("yungsapi:yung_jigsaw" | "betterdungeons:small_nether_dungeon") => { yung_structure(v, lost); true } @@ -1182,6 +1184,19 @@ mod tests { for gone in ["max_y", "x_offset_in_chunk", "enhanced_terrain_adaptation"] { assert!(s.get(gone).is_none(), "{gone}"); } + // Better Dungeons' small Nether dungeon is the same jigsaw. + let mut nether = json!({"type": "betterdungeons:small_nether_dungeon", + "start_pool": "betterdungeons:small_nether_dungeon", "size": 10, + "start_jigsaw_name": "betterdungeons:small_nether_dungeon_anchor", + "max_distance_from_center": 80, "liquid_settings": "ignore_waterlogging"}); + assert!(upgrade("structure", &mut nether, &mut report, &NO_TAGS)); + assert_eq!(nether["type"], "minecraft:jigsaw"); + assert_eq!(nether["horizon:yungsapi"], json!({})); + assert_eq!( + nether["start_jigsaw_name"], + "betterdungeons:small_nether_dungeon_anchor" + ); + assert!(report.unsupported.is_empty()); let mut pool = json!({"elements": [{"weight": 3, "element": { "element_type": "yungsapi:yung_single_element", "location": "y:room", "processors": "minecraft:empty", "projection": "rigid", From 1e800099e96a1a8f288e8e9a99bd6178810a2cab Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 21:18:34 +0200 Subject: [PATCH 153/163] Carry: vertical_distance_from_start_piece is a dead field, not a lost rule Repurposed Structures' jungle fortress and End stronghold still write vertical_distance_from_start_piece, but no codec of the mod (or of Moog's Structure Lib) reads it any more: its own structures ignore it. Carry drops it without counting it in rules_lost, which now lists only rules the mods do run. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/worldgen.rs | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/crates/horizon-port-pack/src/worldgen.rs b/crates/horizon-port-pack/src/worldgen.rs index 7de9f39ce..a10503164 100644 --- a/crates/horizon-port-pack/src/worldgen.rs +++ b/crates/horizon-port-pack/src/worldgen.rs @@ -94,14 +94,17 @@ const START_RULES: [(&str, &str); 3] = [ ]; /// The jigsaws' rules on laying out pieces, which vanilla's jigsaw has no /// place for. -const LAYOUT_RULES: [&str; 6] = [ +const LAYOUT_RULES: [&str; 5] = [ "y_allowance", "burying_type", "use_bounding_box_hack", "pools_that_ignore_boundaries", "enhanced_terrain_adaptation", - "vertical_distance_from_start_piece", ]; +/// Fields of older versions the mods' codecs no longer read: their own +/// structures ignore them, and so does carry. Repurposed's jungle fortress +/// and End stronghold still write `vertical_distance_from_start_piece`. +const DEAD_FIELDS: [&str; 1] = ["vertical_distance_from_start_piece"]; /// Pool elements that are vanilla's with extra fields: (mod type, vanilla type). const ELEMENTS: [(&str, &str); 3] = [ ( @@ -646,6 +649,9 @@ fn start_checks(v: &mut Value, liquid: &str, lost: &mut BTreeMap<String, usize>, checks.insert(to.into(), n.clone()); } } + for field in DEAD_FIELDS { + o.remove(field); + } for rule in LAYOUT_RULES { let kept = limited && PIECE_LIMITED_RULES.contains(&rule); if o.remove(rule).is_some_and(|r| r != Value::Bool(false)) && !kept { @@ -1101,11 +1107,13 @@ mod tests { assert!(moogs.get(gone).is_none(), "{gone}"); } assert_eq!(moogs["size"], 7); - // Repurposed Structures reads the block above the bottom. + // Repurposed Structures reads the block above the bottom. Its jungle + // fortress's vertical distance is a field its code no longer reads. let mut rs = json!({"type": "repurposed_structures:generic_jigsaw_structure", - "cannot_spawn_in_liquid": true}); + "cannot_spawn_in_liquid": true, "vertical_distance_from_start_piece": 35}); assert!(upgrade("structure", &mut rs, &mut report, &NO_TAGS)); assert_eq!(rs["horizon:start_checks"], json!({"liquid": "lowest"})); + assert!(rs.get("vertical_distance_from_start_piece").is_none()); // Repurposed's own checks: the Nether city, Nether shipwrecks, the End stronghold. for (t, check) in [ ("city_nether_structure", "city_nether"), From 4b18b79d1586ad91389cb0e0fa21271dce81929d Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 21:46:09 +0200 Subject: [PATCH 154/163] vanilla_client.py on macOS: the real vanilla 26.3 client joins Horizon's server The tool picks this machine's natives (macOS arm64 or Linux), adds -XstartOnFirstThread on macOS and turns vsync off there: with it on, an unseen window (a locked session) blocks in SDL_GL_SwapWindow before the client joins. docs/server.md records the join. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- docs/server.md | 10 +++++++--- tools/vanilla_client.py | 23 +++++++++++++++++------ 2 files changed, 24 insertions(+), 9 deletions(-) diff --git a/docs/server.md b/docs/server.md index 923eddf2c..a8855905d 100644 --- a/docs/server.md +++ b/docs/server.md @@ -74,9 +74,13 @@ not tick cost, so it is in scope here (see section 9). headless client built from vanilla's own codecs, pings and joins Horizon's server and vanilla's from the same world copy. It compares every login, configuration and play packet up to the first chunk batch, the chunk bytes, chat, `/list`, failing commands, the console lines and the files left behind. Result on main: - see "Harnesses on main" below. The real vanilla GUI client (`tools/vanilla_client.py`) could not be run - here: the tool only knows Linux natives, and the Mac mini's session was locked, which stalls the client's - rendering. It runs on the desktop under vscreen. + see "Harnesses on main" below. +- **The real vanilla 26.3 client** (`tools/vanilla_client.py`, from the owner's own files, dev-only) joins + too. On 2026-10-18 it joined the server build of the game (`horizon-engine`, section 3) on the Mac mini: + `python3 tools/vanilla_client.py --name Vanilla --join localhost:PORT`. It logged in, drew the terrain + around spawn and stayed connected for four minutes, with no warning or error on the server. The tool + runs on Linux under vscreen and on macOS from the logged-in screen session, even a locked one, with vsync + off. ### What fails or is missing diff --git a/tools/vanilla_client.py b/tools/vanilla_client.py index 88c6aba5b..41ae38556 100644 --- a/tools/vanilla_client.py +++ b/tools/vanilla_client.py @@ -5,6 +5,10 @@ servers: --offlineDeveloperMode) and optionally join a server straight away vscreen start python3 tools/vanilla_client.py --name Guest --join localhost:25565 +On Linux (x86_64) and on macOS (Apple silicon, from the logged-in screen session), from the files +tools/lab.py prepared on that machine. On macOS vsync is off: with it on, a window nobody can see (a +locked session, or covered) blocks in SDL_GL_SwapWindow and the client stops before it joins. + Sound goes to OpenAL's null backend. The game directory gets an options.txt that skips the first-run screens, keeps the game running unfocused and renders few chunks, so a harness can drive it with vscreen keys. @@ -21,6 +25,9 @@ from pathlib import Path ROOT = Path(__file__).resolve().parents[1] GAME = ROOT / ".local/minecraft/26.3" +MAC = sys.platform == "darwin" +# The natives of this machine's platform, and the shared libraries in them. +NATIVES, LIBRARY_SUFFIX = ("natives-macos-arm64.jar", ".dylib") if MAC else ("natives-linux.jar", ".so") OPTIONS = { "onboardAccessibility": "false", @@ -40,6 +47,8 @@ OPTIONS = { "onlyShowSecureChat": "false", "rawMouseInput": "false", } +if sys.platform == "darwin": + OPTIONS["enableVsync"] = "false" def offline_uuid(name): @@ -49,10 +58,12 @@ def offline_uuid(name): return uuid.UUID(bytes=bytes(digest)) -def linux_library(path): +def host_library(path): name = Path(path).name if "natives-" in name: - return name.endswith("natives-linux.jar") + return name.endswith(NATIVES) + if MAC: + return "netty-transport-native" not in name or "linux" not in name if "netty-transport-native" in name and ("osx" in name or "aarch_64" in name): return False return "java-objc-bridge" not in name @@ -60,18 +71,18 @@ def linux_library(path): def classpath(): prepared = json.loads((GAME / "prepared.json").read_text()) - jars = [ROOT / p for p in prepared["libraries"]["client"] if linux_library(p)] + jars = [ROOT / p for p in prepared["libraries"]["client"] if host_library(p)] return [GAME / "jars/client.jar", *jars] def extract_natives(jars, target): target.mkdir(parents=True, exist_ok=True) for jar in jars: - if not jar.name.endswith("natives-linux.jar"): + if not jar.name.endswith(NATIVES): continue with zipfile.ZipFile(jar) as archive: for name in archive.namelist(): - if name.endswith(".so") and "arm" not in name and "aarch" not in name: + if name.endswith(LIBRARY_SUFFIX) and (MAC or ("arm" not in name and "aarch" not in name)): out = target / Path(name).name if not out.exists(): out.write_bytes(archive.read(name)) @@ -105,7 +116,7 @@ def command(args): extract_natives(jars, natives) assets = args.assets or (args.game_dir / "assets") (assets / "indexes").mkdir(parents=True, exist_ok=True) - cmd = ["java", f"-Xmx{args.heap}", "-XX:StackShadowPages=32", + cmd = ["java", f"-Xmx{args.heap}", *(["-XstartOnFirstThread"] if MAC else []), "-XX:StackShadowPages=32", "--enable-native-access=ALL-UNNAMED", "--add-exports", "java.base/jdk.internal.misc=ALL-UNNAMED", f"-Djava.library.path={natives}", f"-Dorg.lwjgl.system.SharedLibraryExtractPath={natives}", From 3cd155792d442c6c7d16b0d8760081b37c7b3dc5 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 20:36:55 +0200 Subject: [PATCH 155/163] Entity tracking: check a pair again only when one side moves, as vanilla's ChunkMap Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/lan/entity.rs | 147 +++++++++++++++++++++--- crates/horizon-client/src/lan/guest.rs | 4 + crates/horizon-client/src/lan/hub.rs | 3 + crates/horizon-client/tests/lan_bot.rs | 24 +++- 4 files changed, 163 insertions(+), 15 deletions(-) diff --git a/crates/horizon-client/src/lan/entity.rs b/crates/horizon-client/src/lan/entity.rs index 6350cf6f9..9082e01fa 100644 --- a/crates/horizon-client/src/lan/entity.rs +++ b/crates/horizon-client/src/lan/entity.rs @@ -150,6 +150,14 @@ struct ServerEntity { seen: u32, index: usize, added: bool, + /// TrackedEntity.lastSectionPos: its pairs are checked again when it + /// moves to another section. + section: [i32; 3], +} + +/// SectionPos.of(entity). +fn section_of(position: [f64; 3]) -> [i32; 3] { + position.map(|v| (v.floor() as i32) >> 4) } /// VecDeltaCodec.encode. @@ -183,6 +191,7 @@ impl ServerEntity { seen: 0, index: 0, added: true, + section: section_of(e.position), } } @@ -486,6 +495,9 @@ impl Tracker { /// view distance and chunks. pub struct Viewer<'a> { pub entity_id: i32, + /// It accepted a move since the last tick (ChunkMap.move): every pair + /// of it is checked again. + pub moved: bool, pub position: [f64; 3], pub view_distance: i32, pub chunks: &'a crate::fast_hash::FxHashSet<(i32, i32)>, @@ -539,6 +551,11 @@ pub struct Entities { flags: Vec<Vec<u8>>, /// Whether a client starts tracking each entity this tick. pairs: Vec<bool>, + /// The entities that appeared or moved to another section this tick + /// (their pairs with every client are checked again), in order and as a + /// flag per entity. + moved: Vec<usize>, + is_moved: Vec<bool>, /// One entity's packets and their bodies, kept between entities. packets: Vec<play::Clientbound>, bodies: Vec<Vec<u8>>, @@ -579,13 +596,25 @@ impl Entities { self.probes.clear(); self.chunks.clear(); self.chunk_index.clear(); + self.moved.clear(); + self.is_moved.clear(); + self.is_moved.resize(entities.len(), false); for (index, e) in entities.iter().enumerate() { - let s = self - .states - .entry(e.id) - .or_insert_with(|| ServerEntity::new(e, kind(&e.kind), riding)); + let mut added = false; + let s = self.states.entry(e.id).or_insert_with(|| { + added = true; + ServerEntity::new(e, kind(&e.kind), riding) + }); s.seen = now; s.index = index; + // ChunkMap.addEntity, and ChunkMap.tick's section change: + // updatePlayers. + let section = section_of(e.position); + if added || section != s.section { + s.section = section; + self.moved.push(index); + self.is_moved[index] = true; + } let at = ( (e.position[0].floor() as i32) >> 4, (e.position[2].floor() as i32) >> 4, @@ -612,17 +641,70 @@ impl Entities { self.held.resize(self.chunks.len(), 0); let (chunks, held, pairs) = (&self.chunks, &mut self.held, &mut self.pairs); let mut kept = 0; - flags.extend(self.probes.iter().zip(pairs.iter_mut()).map(|(p, pairs)| { - if p.id == v.entity_id || !sees(v, p, chunks, held) { - 0 - } else if v.tracker.seen.contains(&p.id) { - kept += 1; - SEES | TRACKS - } else { - *pairs = true; - SEES + // A client that moved (ChunkMap.move), or whose own entity + // appeared or changed section (ChunkMap.tick's movedPlayers), has + // every pair checked again. + let all = v.moved + || self + .states + .get(&v.entity_id) + .is_none_or(|s| s.seen != now || self.is_moved[s.index]); + if all { + flags.extend(self.probes.iter().zip(pairs.iter_mut()).map(|(p, pairs)| { + if p.id == v.entity_id || !sees(v, p, chunks, held) { + 0 + } else if v.tracker.seen.contains(&p.id) { + kept += 1; + SEES | TRACKS + } else { + *pairs = true; + SEES + } + })); + } else if v.tracker.seen.len() * 4 > self.probes.len() { + // Otherwise its pairs stay as they were, but for the entities + // that appeared or changed section; a client tracking much + // of the level goes through it in order. + let is_moved = &self.is_moved; + flags.extend(self.probes.iter().zip(pairs.iter_mut()).zip(is_moved).map( + |((p, pairs), &moved)| { + let tracks = v.tracker.seen.contains(&p.id); + if p.id == v.entity_id || (moved && !sees(v, p, chunks, held)) { + 0 + } else if tracks { + kept += 1; + SEES | TRACKS + } else if moved { + *pairs = true; + SEES + } else { + 0 + } + }, + )); + } else { + // One tracking little of it, from what it tracks. + flags.resize(self.probes.len(), 0); + for id in &v.tracker.seen { + if let Some(s) = self.states.get(id).filter(|s| s.seen == now) { + flags[s.index] = SEES | TRACKS; + kept += 1; + } } - })); + for &index in &self.moved { + let p = &self.probes[index]; + let tracks = flags[index] & TRACKS != 0; + if p.id != v.entity_id && sees(v, p, chunks, held) { + if !tracks { + flags[index] = SEES; + pairs[index] = true; + } + } else if tracks { + flags[index] = 0; + kept -= 1; + } + } + } // Usually the client still sees all it tracks. let mut removed = Vec::new(); if kept != v.tracker.seen.len() { @@ -896,6 +978,7 @@ mod tests { trackers: [Tracker; 2], out: [Vec<Vec<u8>>; 2], positions: [[f64; 3]; 2], + moved: [bool; 2], } impl Clients { @@ -905,6 +988,7 @@ mod tests { trackers: Default::default(), out: Default::default(), positions: [[0.0, 64.0, 0.0]; 2], + moved: [false; 2], } } fn tick(&mut self, level: &mut Entities, entities: &[&EntityState]) { @@ -916,6 +1000,7 @@ mod tests { let mut viewers = [ Viewer { entity_id: 1, + moved: self.moved[0], position: self.positions[0], view_distance: 10, chunks: &self.chunks, @@ -924,6 +1009,7 @@ mod tests { }, Viewer { entity_id: 2, + moved: self.moved[1], position: self.positions[1], view_distance: 10, chunks: &self.chunks, @@ -939,6 +1025,39 @@ mod tests { p.encode() } + /// ChunkMap checks a pair again only when one side moves: a zombie + /// walking into range within its section isn't paired with a client + /// standing still until the client moves, and one walking out stays + /// tracked until it changes section. + #[test] + fn pairs_are_checked_again_when_a_side_moves() { + let mut level = Entities::default(); + let mut clients = Clients::new(); + clients.positions[0] = [-108.0, 64.0, 0.0]; + let mut me = state(-108.0); + (me.id, me.kind) = (1, "minecraft:player".into()); + // 128.5 blocks away: past a zombie's 8 chunks. + let tracks = |clients: &Clients| clients.trackers[0].is_tracking(7); + clients.tick(&mut level, &[&me, &state(20.5)]); + assert!(!tracks(&clients)); + // 127.5 blocks away, in the same section: not checked again. + clients.tick(&mut level, &[&me, &state(19.5)]); + assert!(!tracks(&clients)); + // The client's move checks every pair of it. + clients.moved[0] = true; + clients.tick(&mut level, &[&me, &state(19.5)]); + assert!(tracks(&clients)); + clients.moved[0] = false; + clients.tick(&mut level, &[&me, &state(20.5)]); + assert!(tracks(&clients)); + // Into the next section, out of range: no longer tracked. + clients.tick(&mut level, &[&me, &state(40.0)]); + assert!(!tracks(&clients)); + // The other client (at the origin, its entity not in the level) + // checks every pair each tick. + assert!(clients.trackers[1].is_tracking(7)); + } + #[test] fn every_client_gets_the_same_changes_and_late_ones_are_paired() { let mut level = Entities::default(); diff --git a/crates/horizon-client/src/lan/guest.rs b/crates/horizon-client/src/lan/guest.rs index 1a699bc45..279d87a5a 100644 --- a/crates/horizon-client/src/lan/guest.rs +++ b/crates/horizon-client/src/lan/guest.rs @@ -99,6 +99,9 @@ pub struct Guest { /// A position move arrived since the client's last ClientTickEnd /// (receivedPositionThisTick): a second one is a protocol error. pub position_this_tick: bool, + /// It accepted a move since the last entity range checks + /// (ServerChunkCache.move), which then check all of its pairs again. + pub moved: bool, /// The client finished loading terrain (ServerboundPlayerLoadedPacket). pub loaded: bool, // Chunks. @@ -233,6 +236,7 @@ impl Guest { received_moves: 0, known_moves: 0, position_this_tick: false, + moved: false, loaded: false, center: None, sent_chunks: Default::default(), diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index 9ec3eca2d..d37ca7c4c 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -1545,6 +1545,7 @@ impl Hub { .zip(outs.iter_mut()) .map(|(g, out)| Viewer { entity_id: g.entity_id, + moved: std::mem::take(&mut g.moved), position: g.position, view_distance: g.view_distance, chunks: &g.sent_chunks, @@ -1986,6 +1987,8 @@ impl Hub { let g = &mut self.guests[i]; g.previous_position = g.position; g.position = to; + // ServerChunkCache.move: its pairs are checked again. + g.moved = true; let moved = [0, 1, 2].map(|k| g.position[k] - g.previous_position[k]); if g.moves.is_empty() { g.moves_from_ground = g.on_ground; diff --git a/crates/horizon-client/tests/lan_bot.rs b/crates/horizon-client/tests/lan_bot.rs index db2679f71..f6646b682 100644 --- a/crates/horizon-client/tests/lan_bot.rs +++ b/crates/horizon-client/tests/lan_bot.rs @@ -428,13 +428,35 @@ fn guests_see_each_other_and_the_world_entities() { }; let first = thread::spawn(move || { let mut bot = connect(port, "Alex", false)?; + bot.c + .reader + .set_read_timeout(Some(Duration::from_millis(200))) + .unwrap(); let mut zombies = 0; let mut players = 0; let mut moves = 0; + let mut at: Option<[f64; 3]> = None; + let mut reminder = Instant::now(); let deadline = Instant::now() + Duration::from_secs(20); while Instant::now() < deadline && !(zombies > 0 && players > 0 && moves > 0) { - match bot.recv_play()? { + // A vanilla client sends its position at least every 20 ticks even + // when standing still (LocalPlayer's positionReminder), and the + // server checks which entities it sees again on each one. + if let Some([x, y, z]) = at + && reminder.elapsed() >= Duration::from_secs(1) + { + bot.send(S::MovePlayerPos(play::MovePlayerPos { x, y, z, flags: 1 })); + reminder = Instant::now(); + } + let Ok((id, payload)) = bot.c.recv() else { + continue; + }; + let Ok(packet) = C::decode(id, &payload) else { + continue; + }; + match packet { C::PlayerPosition(p) => { + at = Some(p.position); bot.send(S::AcceptTeleportation(play::AcceptTeleportation { id: p.teleport, x: p.position[0], From 96822cd5f86063afe759f80c22e0cc66df74150c Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 21:50:39 +0200 Subject: [PATCH 156/163] Moog's trial spawners and vaults: the saved state out, the configs in Moog's trial spawner and vault randomizing processors keep the block and change its block entity. The templates were saved with state that breaks them in a new world: a vault's server_data holds state_updating_resumes_at far in the future (it never opens) and a spawner's spawn_data an empty entity (it spawns nothing of its own). - Game: a horizon:edit block entity modifier takes `remove`'s keys out, then merges `data` in. append_static now merges as CompoundTag.merge does (compounds in both are merged), not a shallow replace. - Carry: each processor becomes vanilla's rule processor, one rule per block state (12 trial spawner, 32 vault), with horizon:edit: the spawner's normal and ominous configs by id, the vault's loot table and key (the ominous ones on ominous vaults). trial_spawner/ files get their mobs' 1.21.1 ArmorItems/HandItems as 26.3's equipment. ATM10: 6 more processors carried (125 of 1,427). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/carry.rs | 10 + crates/horizon-port-pack/src/processors.rs | 227 ++++++++++++++++++ .../src/worldgen/structure/processor.rs | 90 ++++++- docs/modpacks.md | 12 +- 4 files changed, 332 insertions(+), 7 deletions(-) diff --git a/crates/horizon-port-pack/src/carry.rs b/crates/horizon-port-pack/src/carry.rs index b342f45fd..5c878cc41 100644 --- a/crates/horizon-port-pack/src/carry.rs +++ b/crates/horizon-port-pack/src/carry.rs @@ -473,6 +473,16 @@ pub fn carry( &serde_json::to_vec_pretty(&added).unwrap_or_default(), )?; } + } else if rel.starts_with("trial_spawner/") + && name.starts_with("data/") + && name.ends_with(".json") + { + // Trial spawner configs (Moog's arenas): their mobs' NBT. + if let Ok(mut config) = serde_json::from_slice::<Value>(&bytes) + && crate::processors::upgrade_trial_spawner(&mut config) + { + bytes = serde_json::to_vec_pretty(&config).unwrap_or(bytes); + } } else if rel.starts_with("tags/worldgen/biome/") && name.starts_with("data/") { if let Ok(v) = serde_json::from_slice::<Value>(&bytes) { crate::worldgen::convention_tags(&v, &mut biome_conventions); diff --git a/crates/horizon-port-pack/src/processors.rs b/crates/horizon-port-pack/src/processors.rs index 7fcc0fd94..cb1a8a565 100644 --- a/crates/horizon-port-pack/src/processors.rs +++ b/crates/horizon-port-pack/src/processors.rs @@ -193,11 +193,177 @@ fn as_data(kind: &str, p: &Value, data: &ProcessorData) -> Option<Vec<Value>> { } Vec::new() } + "moogs_structures:trial_spawner_randomizing_processor" => { + // The configs by id: 26.3 reads them from `trial_spawner/`, the + // folder Moog's loads them from. + let mut nbt = json!({"normal_config": p["normal_config"].as_str()?}); + if let Some(ominous) = p["ominous_config"].as_str() { + nbt["ominous_config"] = ominous.into(); + } + // The state the template was saved with goes. + let saved = [ + "server_data", + "shared_data", + "spawn_data", + "cooldown_end_at_tick", + "next_mob_spawns_at", + ]; + vec![same_state_rule(&TRIAL_SPAWNER_STATES, &saved, |_| { + nbt.clone() + })] + } + "moogs_structures:vault_randomizing_processor" => { + let normal = p["loot_table"].as_str()?; + let config = |ominous: bool| { + let (table, key) = match ominous { + true => ( + p["ominous_loot_table"].as_str().unwrap_or(normal), + p["ominous_key_item"] + .as_str() + .unwrap_or("minecraft:ominous_trial_key"), + ), + false => ( + normal, + p["key_item"].as_str().unwrap_or("minecraft:trial_key"), + ), + }; + // Merged into the vault's config, as the mod puts both in. + json!({"config": {"loot_table": table, "key_item": {"id": key, "count": 1}}}) + }; + vec![same_state_rule( + &VAULT_STATES, + &["server_data", "shared_data"], + |s| config(s.get("ominous") == Some(&"true")), + )] + } _ if ns == "betterdungeons" || ns == "betterdeserttemples" => vec![yung_spawner(kind, p)?], _ => return None, }) } +/// A block's states, as (block, [(property, values)]). +type States = ( + &'static str, + &'static [(&'static str, &'static [&'static str])], +); +const TRIAL_SPAWNER_STATES: States = ( + "minecraft:trial_spawner", + &[ + ( + "trial_spawner_state", + &[ + "inactive", + "waiting_for_players", + "active", + "waiting_for_reward_ejection", + "ejecting_reward", + "cooldown", + ], + ), + ("ominous", &["false", "true"]), + ], +); +const VAULT_STATES: States = ( + "minecraft:vault", + &[ + ("facing", &["north", "south", "west", "east"]), + ( + "vault_state", + &["inactive", "active", "unlocking", "ejecting"], + ), + ("ominous", &["false", "true"]), + ], +); + +/// Moog's trial spawner and vault processors keep the block, take keys out +/// of its block entity and set others. As vanilla's `rule`: one rule per +/// state of the block, matching it and writing it back, with the game's +/// `horizon:edit` modifier taking out `remove` and merging `nbt(state)` in. +fn same_state_rule( + states: &States, + remove: &[&str], + nbt: impl Fn(&BTreeMap<&str, &str>) -> Value, +) -> Value { + let (block, properties) = states; + let mut all = vec![BTreeMap::new()]; + for (key, values) in properties.iter() { + all = all + .into_iter() + .flat_map(|s| { + values.iter().map(move |v| { + let mut s = s.clone(); + s.insert(*key, *v); + s + }) + }) + .collect(); + } + let rules: Vec<Value> = all + .iter() + .map(|s| { + let state = json!({"id": block, "properties": s}); + json!({ + "input_predicate": {"predicate_type": "minecraft:blockstate_match", "block_state": state}, + "location_predicate": {"predicate_type": "minecraft:always_true"}, + "output_state": state, + "block_entity_modifier": {"type": "horizon:edit", "remove": remove, "data": nbt(s)}, + }) + }) + .collect(); + json!({"processor_type": "minecraft:rule", "rules": rules}) +} + +/// An entity's NBT in 26.3's shape, in place: 1.21.1's `ArmorItems` (feet +/// to head), `HandItems` (main hand, off hand) and their drop chances become +/// `equipment` and `drop_chances` by slot; empty items and the default drop +/// chance (0.085) are left out, as 26.3 saves them. Whether it changed. +pub fn upgrade_entity(entity: &mut Value) -> bool { + let Some(o) = entity.as_object_mut() else { + return false; + }; + const ARMOR: [&str; 4] = ["feet", "legs", "chest", "head"]; + const HANDS: [&str; 2] = ["mainhand", "offhand"]; + let mut changed = false; + for (items, chances, slots) in [ + ("ArmorItems", "ArmorDropChances", &ARMOR[..]), + ("HandItems", "HandDropChances", &HANDS[..]), + ] { + if let Some(Value::Array(list)) = o.remove(items) { + changed = true; + for (slot, item) in slots.iter().zip(list) { + if item.get("id").is_some() { + let equipment = o.entry("equipment").or_insert_with(|| json!({})); + equipment[*slot] = item; + } + } + } + if let Some(Value::Array(list)) = o.remove(chances) { + changed = true; + for (slot, chance) in slots.iter().zip(list) { + if chance.as_f64().is_some_and(|c| (c - 0.085).abs() > 1e-6) { + let drop = o.entry("drop_chances").or_insert_with(|| json!({})); + drop[*slot] = chance; + } + } + } + } + changed +} + +/// A 1.21.1 trial spawner config (`trial_spawner/`) in 26.3's shape, in +/// place: its mobs' NBT ([`upgrade_entity`]). Whether it changed. +pub fn upgrade_trial_spawner(config: &mut Value) -> bool { + let mut changed = false; + for p in config["spawn_potentials"] + .as_array_mut() + .into_iter() + .flatten() + { + changed |= upgrade_entity(&mut p["data"]["entity"]); + } + changed +} + /// [`as_data`]'s `horizon:spawner_mobs` for the mods' spawner randomizing /// processors, whose fields have the same names and defaults. fn spawner_mobs(p: &Value, mobs: Vec<Value>, rules: Option<Value>) -> Value { @@ -502,4 +668,65 @@ mod tests { assert_eq!(p[3]["processor_type"], "betterdungeons:candle_processor"); assert_eq!(carried.values().sum::<usize>(), 3); } + + #[test] + fn trial_spawners_and_vaults_drop_their_saved_state() { + let mut list = json!({"processors": [ + {"processor_type": "moogs_structures:trial_spawner_randomizing_processor", + "normal_config": "mns:arena/normal", "ominous_config": "mns:arena/ominous"}, + {"processor_type": "moogs_structures:vault_randomizing_processor", + "loot_table": "mns:vaults/main", "ominous_loot_table": "mns:vaults/ominous"}]}); + let mut carried = BTreeMap::new(); + assert!(carry("processor_list", &mut list, &data(), &mut carried)); + let p = list["processors"].as_array().unwrap(); + let rules = |i: usize| p[i]["rules"].as_array().unwrap().clone(); + // Every state of the block: 6 x 2 trial spawners, 4 x 4 x 2 vaults. + assert_eq!((rules(0).len(), rules(1).len()), (12, 32)); + let spawner = &rules(0)[0]; + assert_eq!( + spawner["input_predicate"]["block_state"], + spawner["output_state"] + ); + assert_eq!( + spawner["block_entity_modifier"], + json!({"type": "horizon:edit", + "remove": ["server_data", "shared_data", "spawn_data", + "cooldown_end_at_tick", "next_mob_spawns_at"], + "data": {"normal_config": "mns:arena/normal", + "ominous_config": "mns:arena/ominous"}}) + ); + for rule in rules(1) { + let ominous = rule["output_state"]["properties"]["ominous"] == "true"; + let (table, key) = match ominous { + true => ("mns:vaults/ominous", "minecraft:ominous_trial_key"), + false => ("mns:vaults/main", "minecraft:trial_key"), + }; + assert_eq!( + rule["block_entity_modifier"], + json!({"type": "horizon:edit", "remove": ["server_data", "shared_data"], + "data": {"config": {"loot_table": table, + "key_item": {"id": key, "count": 1}}}}) + ); + } + assert_eq!(carried.len(), 2); + } + + #[test] + fn trial_spawner_mobs_take_26_3s_equipment() { + let mut config = json!({"spawn_potentials": [{"weight": 1, "data": {"entity": { + "id": "minecraft:skeleton", + "ArmorItems": [{}, {}, {}, {"id": "minecraft:iron_helmet", "count": 1}], + "ArmorDropChances": [0.085, 0.085, 0.085, 0.0], + "HandItems": [{"id": "minecraft:bow", "count": 1}, {}], + "HandDropChances": [0.085, 0.085]}}}]}); + assert!(upgrade_trial_spawner(&mut config)); + assert_eq!( + config["spawn_potentials"][0]["data"]["entity"], + json!({"id": "minecraft:skeleton", + "equipment": {"head": {"id": "minecraft:iron_helmet", "count": 1}, + "mainhand": {"id": "minecraft:bow", "count": 1}}, + "drop_chances": {"head": 0.0}}) + ); + assert!(!upgrade_trial_spawner(&mut config)); + } } diff --git a/crates/horizon-world/src/worldgen/structure/processor.rs b/crates/horizon-world/src/worldgen/structure/processor.rs index 76e1a4cd1..8fa1f769a 100644 --- a/crates/horizon-world/src/worldgen/structure/processor.rs +++ b/crates/horizon-world/src/worldgen/structure/processor.rs @@ -56,6 +56,14 @@ enum Modifier { Clear, AppendLoot(String), AppendStatic(Compound), + /// `horizon:edit`: `remove`'s keys taken out of the block entity, then + /// `data` merged in as append_static does. The data form of the mods' + /// processors that copy a block entity and change parts of it (Moog's + /// trial spawners and vaults drop their saved state). + Edit { + remove: Vec<String>, + data: Compound, + }, } impl PosRule { /// A rule's `position_predicate` (always true when missing). Types are @@ -104,11 +112,45 @@ impl Modifier { Tag::Compound(c) => Self::AppendStatic(c), _ => Self::AppendStatic(Compound::new()), }, + "horizon:edit" => Self::Edit { + remove: m["remove"] + .as_array() + .into_iter() + .flatten() + .map(|k| k.as_str().map(str::to_owned)) + .collect::<Option<_>>() + .ok_or(DecodeError::Field("block entity modifier keys"))?, + data: match json_to_nbt(&m["data"]) { + Tag::Compound(c) => c, + _ => Compound::new(), + }, + }, _ => return Err(DecodeError::Field("block entity modifier")), }, ) } } +/// A block entity with `remove`'s keys taken out and `data` merged in +/// (append_static is the one with nothing to remove). +fn edited(nbt: Option<&Compound>, remove: &[String], data: &Compound) -> Compound { + let mut nbt = nbt.cloned().unwrap_or_default(); + for key in remove { + nbt.remove(&JavaString::from(key.as_str())); + } + merge(&mut nbt, data); + nbt +} +/// CompoundTag.merge: compounds in both are merged, anything else replaced. +fn merge(into: &mut Compound, other: &Compound) { + for (key, value) in other { + match (into.get_mut(key), value) { + (Some(Tag::Compound(mine)), Tag::Compound(theirs)) => merge(mine, theirs), + _ => { + into.insert(key.clone(), value.clone()); + } + } + } +} #[derive(Clone, Debug)] pub struct Rule { input: RuleTest, @@ -637,10 +679,9 @@ fn process_block<W: PlacementContext>( nbt.insert("LootTableSeed".into(), Tag::Long(random.next_long())); Some(nbt) } - Modifier::AppendStatic(data) => { - let mut nbt = info.nbt.clone().unwrap_or_default(); - nbt.extend(data.clone()); - Some(nbt) + Modifier::AppendStatic(data) => Some(edited(info.nbt.as_ref(), &[], data)), + Modifier::Edit { remove, data } => { + Some(edited(info.nbt.as_ref(), remove, data)) } }; return Ok(Some(BlockInfo { @@ -1282,4 +1323,45 @@ mod tests { )); assert!(Modifier::decode(Some(&json!({"type": ""}))).is_err()); } + + #[test] + fn block_entity_edits_merge_deep_and_drop_keys() { + let nbt = |v: Value| match json_to_nbt(&v) { + Tag::Compound(c) => c, + _ => unreachable!(), + }; + let vault = nbt(json!({"id": "minecraft:vault", + "config": {"loot_table": "x:old", "key_item": {"id": "minecraft:trial_key"}}, + "server_data": {"state_updating_resumes_at": 533162741}})); + // append_static merges compounds the way CompoundTag.merge does. + let Ok(Modifier::AppendStatic(data)) = Modifier::decode(Some(&json!({ + "type": "append_static", "data": {"config": {"loot_table": "x:new"}}}))) + else { + panic!("append_static") + }; + let merged = edited(Some(&vault), &[], &data); + assert_eq!( + merged, + nbt(json!({"id": "minecraft:vault", + "config": {"loot_table": "x:new", "key_item": {"id": "minecraft:trial_key"}}, + "server_data": {"state_updating_resumes_at": 533162741}})) + ); + let Ok(Modifier::Edit { remove, data }) = Modifier::decode(Some(&json!({ + "type": "horizon:edit", "remove": ["server_data"], + "data": {"config": {"loot_table": "x:new"}}}))) + else { + panic!("horizon:edit") + }; + assert_eq!( + edited(Some(&vault), &remove, &data), + nbt(json!({"id": "minecraft:vault", + "config": {"loot_table": "x:new", "key_item": {"id": "minecraft:trial_key"}}})) + ); + assert_eq!( + edited(None, &remove, &data), + nbt(json!({"config": {"loot_table": "x:new"}})) + ); + let bad = json!({"type": "horizon:edit", "remove": [1], "data": {}}); + assert!(Modifier::decode(Some(&bad)).is_err()); + } } diff --git a/docs/modpacks.md b/docs/modpacks.md index 12e522e24..fcd87f15c 100644 --- a/docs/modpacks.md +++ b/docs/modpacks.md @@ -447,9 +447,15 @@ Two cases the oracle fills in: written in). YUNG's Better Dungeons and Better Desert Temples turn a spawner or a placeholder block (gravel, bone block, yellow wool...) into a spawner of a fixed mob: that is vanilla's `rule` processor with an `append_static` block entity. Moog's vanilla loot - swap acts only when a "replace vanilla" preset is on, and they ship off. 119 of the 1,427 - processors are carried; 1,308 are still taken out (blocks swapped, aged or propped up, - Moog's trial spawner and vault configs, YUNG's chest caps). + swap acts only when a "replace vanilla" preset is on, and they ship off. Moog's trial + spawner and vault processors keep the block and change its block entity: one `rule` per + block state, with the game's `horizon:edit` modifier, which takes out the state the + template was saved with (a vault saved with `state_updating_resumes_at` far in the future + never opens; a spawner's saved `spawn_data` blocks its own mobs) and merges in the + spawner's normal and ominous configs (by id: the carry upgrades `trial_spawner/` files' + mobs to 26.3's `equipment`) or the vault's loot table and key. 125 of the 1,427 + processors are carried; 1,302 are still taken out (blocks swapped, aged or propped up, + YUNG's chest caps). In the 128×128-chunk square (seed 1234), every spawner of a mod structure now has its mob: in the Overworld 83 Better Dungeons spawners held the template's placeholder pig and 17 of Moog's were empty (763 spawners with a mob, up from 628); in the Nether the 52 empty ones From a0bcc13f1c046f845b81c95bc7bfcc3903b6e7ff Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 20:24:09 +0200 Subject: [PATCH 157/163] Tick blocks around every player, from vanilla's chunk tickets (#890) Without a local player (dedicated server, --server-thread) no block ticked: tick_blocks returned early, so crops, fluids, redstone, pistons and pressure plates stood still, and a LAN host ticked only around itself. ticket_levels ports DistanceManager's levels: PLAYER_LOADING at 31 within the view distance and PLAYER_SIMULATION at 31 - simulation distance for every player in the level (the local player, LAN guests, a server's players), and FORCED at 31. Random ticks run in simulation entity-ticking chunks that are ticking chunks, scheduled ticks, block events and block entities in block ticking ones, entities in entity ticking ones; the sculk blocks follow the same rule. Saved ticks unpack when a chunk starts ticking (startTickingChunk), not when it loads. The hub keeps the tick-rate state current while nobody is in the game, so a player joining a frozen server is told once (updateJoiningPlayer). dedicated_server parity froze nothing while the client was sent its chunks: saved fluid ticks there (a lava fall that never settles) ran before or after the chunk was sent depending on each server's loading speed, and it failed on main too. It now freezes the game until the client has its chunks. lan_e2e gets a growth check: water flows and wheat grows next to a guest 1000 blocks from the host. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game.rs | 79 +++++- .../src/game/block_entity_ticks.rs | 25 +- crates/horizon-client/src/game/creatures.rs | 21 +- crates/horizon-client/src/game/levels.rs | 6 +- crates/horizon-client/src/game/persist.rs | 8 +- crates/horizon-client/src/game/sculk.rs | 14 +- .../horizon-client/src/game/sculk_fixture.rs | 2 + crates/horizon-client/src/lan/hub.rs | 6 + crates/horizon-client/src/lib.rs | 1 + .../src/tick_chunk_membership.rs | 45 ++++ crates/horizon-client/src/ticket_levels.rs | 232 ++++++++++++++++++ tools/lan_e2e.py | 48 +++- tools/test_dedicated_server_parity.py | 10 + 13 files changed, 431 insertions(+), 66 deletions(-) create mode 100644 crates/horizon-client/src/ticket_levels.rs diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index dc56fc4fa..2cbdabaa4 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -480,6 +480,8 @@ struct GameLevel<'w> { rand_sequences: &'w mut horizon_client::random_sequences::RandomSequences, pending: &'w mut spill::Pending, spill: &'w mut spill::Spill, + /// Where the chunk tickets let blocks tick. + tickets: horizon_client::ticket_levels::Levels, } struct PlayerCollision { y: f64, @@ -677,6 +679,11 @@ impl LevelAccess for GameLevel<'_> { ) .unwrap_or(false) } + /// `ServerLevel.isPositionTickingWithEntitiesLoaded`: block ticking, and + /// a ticking chunk. + fn is_ticking_chunk(&self, chunk: horizon_core::position::ChunkPos) -> bool { + self.tickets.block_ticking(chunk.x, chunk.z) && ticking_chunk(self.world, chunk.x, chunk.z) + } /// Entities that trigger pressure plates, tripwires and detector rails: /// the players (the host and the LAN guests, mobs) and the minecarts. fn count_entities(&self, area: Aabb, query: EntityQuery) -> usize { @@ -953,6 +960,12 @@ struct DragView { left: Option<u32>, } /// Ctrl+Q reads the physical keyboard, independently of sprint key mappings. +/// A chunk whose ticking future can complete (`ChunkMap.prepareTickingChunk`): +/// lit, with its neighbours loaded, as `postprocess_chunks` waits for. +fn ticking_chunk(world: &World, x: i32, z: i32) -> bool { + world.chunks.get(&(x, z)).is_some_and(|c| c.lit) + && (-1..=1).all(|dz| (-1..=1).all(|dx| world.chunks.contains_key(&(x + dx, z + dz)))) +} fn drop_whole_stack(physical_keys: &HashSet<KeyCode>) -> bool { physical_keys.contains(&KeyCode::ControlLeft) || physical_keys.contains(&KeyCode::ControlRight) } @@ -1205,6 +1218,7 @@ struct Game<'a> { end: end::EndState, block_ticks: Ticks, tick_chunks: horizon_client::tick_chunk_membership::TickChunkMembership, + tickets: horizon_client::ticket_levels::ChunkTickets, random_tick_sections: horizon_client::random_tick_sections::RandomTickSections, level_events: Vec<LevelEvent>, falling: Vec<FallingBlock>, @@ -2038,6 +2052,7 @@ impl Game<'_> { rand_sequences: &mut self.rand_sequences, pending: &mut self.pending, spill: &mut self.spill, + tickets: self.tickets.levels(), }; let result = f(self.res.behaviours(), &mut level, &mut self.block_ticks); self.flush_spill(); @@ -2080,22 +2095,62 @@ impl Game<'_> { } self.tick_chunks.recycle_added(added); } - /// ServerLevel.tick block phases: scheduled ticks, random ticks within the - /// simulation distance, block events and moving pistons. + /// `DistanceManager`'s tickets of the level in place, from every player in + /// it (the local player, LAN guests, a server's players) and its forced + /// chunks. A game with neither a server nor a player (the headless + /// fixtures) ticks everywhere. + fn update_chunk_tickets(&mut self) { + let mut players: Vec<(i32, i32)> = self.lan.as_ref().map_or_else(Vec::new, |h| { + h.hub + .guests + .iter() + .filter(|g| h.hub.here(g)) + .map(|g| g.chunk()) + .collect() + }); + if let Some(p) = &self.player { + players.push(( + (p.position.x.floor() as i32) >> 4, + (p.position.z.floor() as i32) >> 4, + )); + } + let sources = (self.options.dedicated.is_some() || !players.is_empty()).then(|| { + horizon_client::ticket_levels::Sources { + players, + forced: self.streaming.forced.iter().copied().collect(), + view_distance: self.settings.render_distance.clamp(2, 32), + simulation_distance: self.settings.simulation_distance.max(2), + } + }); + self.tickets.update(sources); + } + /// `ServerLevel.startTickingChunk`: a loaded chunk's saved ticks are + /// scheduled from the game time at which it becomes a ticking chunk + /// (block ticking, with its neighbours loaded). Chunks become ticking + /// between ticks in vanilla: before this tick's clock advanced. + fn start_ticking_chunks(&mut self) { + let levels = self.tickets.levels(); + let world = &self.world; + let started = self + .tick_chunks + .start_ticking(|(x, z)| levels.loaded_ticking(x, z) && ticking_chunk(world, x, z)); + let time = self.world.game_time - 1; + for (x, z) in started { + let pos = horizon_core::position::ChunkPos::new(x, z); + self.block_ticks.blocks.unpack_chunk(pos, time); + self.block_ticks.fluids.unpack_chunk(pos, time); + } + } + /// ServerLevel.tick block phases: scheduled ticks, random ticks in the + /// chunks the tickets simulate, block events and moving pistons. fn tick_blocks(&mut self) -> Result<()> { self.sync_tick_chunks(); - let Some(p) = self.player.as_ref() else { - return Ok(()); - }; - let (pcx, pcz) = ( - (p.position.x.floor() as i32) >> 4, - (p.position.z.floor() as i32) >> 4, - ); - let simulation = self.settings.render_distance.min(8); + self.start_ticking_chunks(); + let levels = self.tickets.levels(); let mut ticking = Vec::new(); let facts = self.res.facts(); for (&(x, z), chunk) in &self.world.chunks { - if (x - pcx).abs() > simulation || (z - pcz).abs() > simulation || !chunk.lit { + if !levels.random_ticking(x, z) || !ticking_chunk(&self.world, x, z) { continue; } // Capture eligibility before inside-block and scheduled updates, as @@ -3872,6 +3927,7 @@ impl Game<'_> { /// What the tick runs after the local player's own update: effects, the /// world's entities and blocks, and the network hub. fn tick_world(&mut self, running: bool) -> Result<()> { + self.update_chunk_tickets(); horizon_client::spans::time("tick_effects", || self.tick_effects()); horizon_client::spans::time("tick_using", || self.tick_using()); horizon_client::spans::time("tick_hud", || self.tick_hud()); @@ -10683,6 +10739,7 @@ impl<'a> Game<'a> { end: Default::default(), block_ticks: Ticks::new(0), tick_chunks: Default::default(), + tickets: Default::default(), random_tick_sections: Default::default(), level_events: Vec::new(), falling: Vec::new(), diff --git a/crates/horizon-client/src/game/block_entity_ticks.rs b/crates/horizon-client/src/game/block_entity_ticks.rs index 1c0258871..bb1cadd15 100644 --- a/crates/horizon-client/src/game/block_entity_ticks.rs +++ b/crates/horizon-client/src/game/block_entity_ticks.rs @@ -101,27 +101,12 @@ impl Game<'_> { }) .collect() } - /// `ServerLevel.shouldTickBlocksAt`: chunks within the simulation - /// distance plus one (`DistanceManager.inBlockTickingRange`, Chebyshev - /// in chunks) of the player or a guest. With nobody there, a dedicated - /// server ticks none; the game alone (no player yet, headless fixtures) - /// ticks every chunk. + /// `ServerLevel.shouldTickBlocksAt` in a block-ticking chunk + /// (`LevelChunk.isTicking`, block coordinates), from every player's + /// tickets (`update_chunk_tickets`). fn block_ticking_area(&self) -> impl Fn(i32, i32) -> bool + use<> { - let d = self.settings.simulation_distance.max(2) + 1; - let mut centres: Vec<(i32, i32)> = self.streaming.extra.iter().map(|&(c, _)| c).collect(); - if let Some(p) = &self.player { - centres.push(( - (p.position.x.floor() as i32) >> 4, - (p.position.z.floor() as i32) >> 4, - )); - } - let everywhere = centres.is_empty() && self.options.dedicated.is_none(); - move |x, z| { - everywhere - || centres - .iter() - .any(|&(cx, cz)| ((x >> 4) - cx).abs().max(((z >> 4) - cz).abs()) <= d) - } + let levels = self.tickets.levels(); + move |x, z| levels.block_ticking_at(x, z) } /// `AbstractFurnaceBlockEntity.serverTick` of the furnace at `pos`, and /// its block's `lit` following it. diff --git a/crates/horizon-client/src/game/creatures.rs b/crates/horizon-client/src/game/creatures.rs index 6e9b3d84a..422d050b6 100644 --- a/crates/horizon-client/src/game/creatures.rs +++ b/crates/horizon-client/src/game/creatures.rs @@ -475,24 +475,11 @@ impl Game<'_> { self.tick_raids(); self.tick_creature_entities() } - /// `DistanceManager.inEntityTickingRange`: chunks within the simulation - /// distance (Chebyshev, in chunks) of the player or of a guest. + /// `DistanceManager.inEntityTickingRange` in an entity-ticking chunk + /// (block coordinates), from every player's tickets (`update_chunk_tickets`). pub(super) fn entity_ticking_area(&self) -> impl Fn(i32, i32) -> bool + use<> { - let d = self.settings.simulation_distance.max(2); - let mut centres: Vec<(i32, i32)> = self.streaming.extra.iter().map(|&(c, _)| c).collect(); - if let Some(p) = &self.player { - centres.push(( - (p.position.x.floor() as i32) >> 4, - (p.position.z.floor() as i32) >> 4, - )); - } - let everywhere = centres.is_empty(); - move |x, z| { - everywhere - || centres - .iter() - .any(|&(cx, cz)| ((x >> 4) - cx).abs().max(((z >> 4) - cz).abs()) <= d) - } + let levels = self.tickets.levels(); + move |x, z| levels.entity_ticking_at(x, z) } /// The entity phase of `tick_creatures`: every mob's tick, deaths, and the /// projectiles and effects that follow from them. diff --git a/crates/horizon-client/src/game/levels.rs b/crates/horizon-client/src/game/levels.rs index bd2f84efb..3225408f5 100644 --- a/crates/horizon-client/src/game/levels.rs +++ b/crates/horizon-client/src/game/levels.rs @@ -20,7 +20,8 @@ use super::{ }; use horizon_client::{ Result, block_entity_anim::BlockEntityAnims, random_tick_sections::RandomTickSections, - save::SaveDir, streaming::Streaming, tick_chunk_membership::TickChunkMembership, world::World, + save::SaveDir, streaming::Streaming, tick_chunk_membership::TickChunkMembership, + ticket_levels::ChunkTickets, world::World, }; use horizon_world::level::{LevelEvent, Ticks}; use std::{collections::HashMap, sync::Arc, time::Instant}; @@ -37,6 +38,7 @@ pub(super) struct Parked { save: Arc<SaveDir>, block_ticks: Ticks, tick_chunks: TickChunkMembership, + tickets: ChunkTickets, random_tick_sections: RandomTickSections, level_events: Vec<LevelEvent>, falling: Vec<FallingBlock>, @@ -113,6 +115,7 @@ impl Game<'_> { save, block_ticks: Ticks::new(self.level.seed as i32), tick_chunks: Default::default(), + tickets: Default::default(), random_tick_sections: Default::default(), level_events: Vec::new(), falling: Vec::new(), @@ -159,6 +162,7 @@ impl Game<'_> { swap(&mut self.save, &mut p.save); swap(&mut self.block_ticks, &mut p.block_ticks); swap(&mut self.tick_chunks, &mut p.tick_chunks); + swap(&mut self.tickets, &mut p.tickets); swap(&mut self.random_tick_sections, &mut p.random_tick_sections); swap(&mut self.level_events, &mut p.level_events); swap(&mut self.falling, &mut p.falling); diff --git a/crates/horizon-client/src/game/persist.rs b/crates/horizon-client/src/game/persist.rs index 2574f45d7..7a967a024 100644 --- a/crates/horizon-client/src/game/persist.rs +++ b/crates/horizon-client/src/game/persist.rs @@ -105,7 +105,9 @@ impl Game<'_> { chunk.saved = Some(Arc::new(extras)); } /// Register a newly resident chunk with the tick scheduler, with the - /// block and fluid ticks it was saved with. + /// block and fluid ticks it was saved with (`LevelChunk.registerTickContainerInLevel` + /// at FULL). They are unpacked when the chunk starts ticking + /// (`start_ticking_chunks`). pub(super) fn register_chunk_ticks(&mut self, key: (i32, i32)) { let pos = ChunkPos::new(key.0, key.1); let saved = self.world.chunks.get(&key).and_then(|c| c.saved.clone()); @@ -130,9 +132,7 @@ impl Game<'_> { .is_ok() && loaded { - let time = self.world.game_time; - self.block_ticks.blocks.unpack_chunk(pos, time); - self.block_ticks.fluids.unpack_chunk(pos, time); + self.tick_chunks.wait(key); } // The saved list is consumed: later saves take the scheduler's ticks. if loaded && let Some(c) = self.world.chunks.get_mut(&key) { diff --git a/crates/horizon-client/src/game/sculk.rs b/crates/horizon-client/src/game/sculk.rs index fc6c03f9e..de7ea6df2 100644 --- a/crates/horizon-client/src/game/sculk.rs +++ b/crates/horizon-client/src/game/sculk.rs @@ -705,18 +705,10 @@ impl Game<'_> { } Ok(()) } - /// `ServerLevel.shouldTickBlocksAt`, as `tick_blocks` decides it. + /// `ServerLevel.shouldTickBlocksAt` in a block-ticking chunk, from every + /// player's tickets (`update_chunk_tickets`), once the chunk is lit. fn chunk_ticks(&self, cx: i32, cz: i32) -> bool { - let Some(p) = self.player.as_ref() else { - return false; - }; - let (pcx, pcz) = ( - (p.position.x.floor() as i32) >> 4, - (p.position.z.floor() as i32) >> 4, - ); - let simulation = self.settings.render_distance.min(8); - (cx - pcx).abs() <= simulation - && (cz - pcz).abs() <= simulation + self.tickets.levels().block_ticking(cx, cz) && self.world.chunks.get(&(cx, cz)).is_some_and(|c| c.lit) } fn tick_sculk_block(&mut self, key: (i32, i32, i32)) -> Result<()> { diff --git a/crates/horizon-client/src/game/sculk_fixture.rs b/crates/horizon-client/src/game/sculk_fixture.rs index b57f559b6..890e571b8 100644 --- a/crates/horizon-client/src/game/sculk_fixture.rs +++ b/crates/horizon-client/src/game/sculk_fixture.rs @@ -696,6 +696,8 @@ impl Game<'_> { seed_fresh(m, 0x5eed + (named + i + 1) as i64); } } + // The player's tickets, as `tick_world` takes them. + self.update_chunk_tickets(); // Entities: the player's warden spawn tracker, then the mobs. self.tick_sculk_entities(); // (ServerChunkCache.tick, natural spawning and its chunk shuffle, is not run.) diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index 6456b1001..cab5a9d16 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -1012,6 +1012,12 @@ impl Hub { } } if !self.guests.iter().any(|g| self.here(g)) { + // ServerTickRateManager broadcasts a change to the players there + // are; one who joins later is sent the state as it is then + // (`updateJoiningPlayer`). + if !self.guests.iter().any(|g| g.placed) { + self.ticking = (ctx.tick_rate, ctx.tick_frozen); + } if !self .guests .iter() diff --git a/crates/horizon-client/src/lib.rs b/crates/horizon-client/src/lib.rs index 1e2c8c331..437fbfa9d 100644 --- a/crates/horizon-client/src/lib.rs +++ b/crates/horizon-client/src/lib.rs @@ -172,6 +172,7 @@ pub mod telemetry; pub mod testgen; pub mod text; pub mod tick_chunk_membership; +pub mod ticket_levels; pub mod title; pub mod title_edition; pub mod toasts; diff --git a/crates/horizon-client/src/tick_chunk_membership.rs b/crates/horizon-client/src/tick_chunk_membership.rs index 42785f289..a7e934443 100644 --- a/crates/horizon-client/src/tick_chunk_membership.rs +++ b/crates/horizon-client/src/tick_chunk_membership.rs @@ -10,6 +10,9 @@ pub struct TickChunkMembership { revision: Option<u64>, added: Vec<Key>, removed: Vec<Key>, + /// Loaded chunks with saved ticks that have not started ticking yet + /// (`LevelChunkTicks.pendingTicks`, unpacked by `startTickingChunk`). + waiting: HashSet<Key>, } impl TickChunkMembership { @@ -20,6 +23,7 @@ impl TickChunkMembership { self.revision = None; self.added.clear(); self.removed.clear(); + self.waiting.clear(); } /// Returns false in O(1) when resident membership is unchanged. On change, @@ -36,6 +40,7 @@ impl TickChunkMembership { true } else { self.removed.push(*key); + self.waiting.remove(key); false } }); @@ -62,6 +67,28 @@ impl TickChunkMembership { pub fn removed(&self) -> &[Key] { &self.removed } + + /// `key` was registered with saved ticks to unpack once it ticks. + pub fn wait(&mut self, key: Key) { + self.waiting.insert(key); + } + + /// The waiting chunks that `ticking` says now tick, no longer waiting. + pub fn start_ticking(&mut self, mut ticking: impl FnMut(Key) -> bool) -> Vec<Key> { + if self.waiting.is_empty() { + return Vec::new(); + } + let started: Vec<Key> = self + .waiting + .iter() + .copied() + .filter(|&k| ticking(k)) + .collect(); + for key in &started { + self.waiting.remove(key); + } + started + } } #[cfg(test)] @@ -124,6 +151,24 @@ mod tests { compare(&mut cache, &mut old, &map); } + #[test] + fn waiting_chunks_start_ticking_once_and_unloaded_ones_stop_waiting() { + let mut map = ChunkMap::default(); + let mut cache = TickChunkMembership::default(); + for key in [(0, 0), (1, 0), (2, 0)] { + map.insert(key, Arc::new(Chunk::empty(key.0, key.1))); + cache.wait(key); + } + cache.synchronize(&map); + assert_eq!(cache.start_ticking(|k| k == (0, 0)), vec![(0, 0)]); + assert!(cache.start_ticking(|k| k == (0, 0)).is_empty()); + map.remove(&(1, 0)); + cache.synchronize(&map); + let mut started = cache.start_ticking(|_| true); + started.sort_unstable(); + assert_eq!(started, vec![(2, 0)]); + } + #[test] fn scheduler_keeps_saved_ticks_on_stable_membership_and_removes_unloaded_chunks() { use horizon_core::{ diff --git a/crates/horizon-client/src/ticket_levels.rs b/crates/horizon-client/src/ticket_levels.rs new file mode 100644 index 000000000..216815de1 --- /dev/null +++ b/crates/horizon-client/src/ticket_levels.rs @@ -0,0 +1,232 @@ +//! Which chunks tick, from the chunk tickets of `DistanceManager`. +//! +//! Every player holds two kinds of ticket: +//! - `PLAYER_LOADING` at level 31 (`ENTITY_TICKING`) on every chunk within +//! the server's view distance (Chebyshev), from `PlayerTicketTracker`; +//! - `PLAYER_SIMULATION` at level `31 - simulationDistance` on its own chunk. +//! +//! A `/forceload`ed chunk holds a `FORCED` ticket at level 31 of both kinds. +//! Levels rise by one per chunk away from a ticket (`ChunkTracker`) and each +//! chunk takes the lowest. The loading level gives the chunk's +//! `FullChunkStatus` (`ChunkLevel.fullStatus`: 31 entity ticking, 32 block +//! ticking, 33 full) and the simulation level gives what +//! `inEntityTickingRange` (31 or less) and `inBlockTickingRange` (32 or less) +//! answer. Vanilla needs both: +//! - entities tick where both levels are entity ticking (`ServerLevel.tick`, +//! and `EntityTickList` holds only the entities of entity-ticking chunks); +//! - random ticks run in the simulation tracker's entity-ticking chunks that +//! have a ticking chunk (`ChunkMap.forEachBlockTickingChunk`); +//! - scheduled ticks, block events and block entities run where both are +//! block ticking (`isPositionTickingWithEntitiesLoaded`, +//! `shouldTickBlocksAt`, `LevelChunk.isTicking`). +//! +//! Whoever the players are (the local player, LAN guests, a dedicated +//! server's players), they count the same. +use crate::fast_hash::FxHashMap; +use std::sync::Arc; + +/// `ChunkLevel`'s levels. +pub const ENTITY_TICKING: u8 = 31; +pub const BLOCK_TICKING: u8 = 32; +/// What a chunk with no ticket near it has (`FULL` and above count as none). +const NONE: (u8, u8) = (BLOCK_TICKING + 1, BLOCK_TICKING + 1); + +/// The tickets of one level: where its players are, its forced chunks, and +/// the server's view and simulation distances. +#[derive(Clone, Debug, Default, PartialEq, Eq)] +pub struct Sources { + pub players: Vec<(i32, i32)>, + pub forced: Vec<(i32, i32)>, + pub view_distance: i32, + pub simulation_distance: i32, +} + +/// Each chunk's (loading, simulation) level, for the chunks where either is +/// block ticking or lower; `None` ticks everywhere (a game with no server and +/// no player: the headless fixtures). +#[derive(Clone, Default)] +pub struct Levels(Option<Arc<FxHashMap<(i32, i32), (u8, u8)>>>); + +impl Levels { + /// Chunk coordinates. + fn get(&self, x: i32, z: i32) -> Option<(u8, u8)> { + let map = self.0.as_ref()?; + Some(map.get(&(x, z)).copied().unwrap_or(NONE)) + } + /// `DistanceManager.inEntityTickingRange`, in an entity-ticking chunk: + /// where entities tick. + pub fn entity_ticking(&self, x: i32, z: i32) -> bool { + self.get(x, z) + .is_none_or(|(l, s)| l <= ENTITY_TICKING && s <= ENTITY_TICKING) + } + /// `inBlockTickingRange` in a block-ticking chunk: where scheduled ticks, + /// block events and block entities run. + pub fn block_ticking(&self, x: i32, z: i32) -> bool { + self.get(x, z) + .is_none_or(|(l, s)| l <= BLOCK_TICKING && s <= BLOCK_TICKING) + } + /// `inEntityTickingRange` in a block-ticking chunk: where random ticks run. + pub fn random_ticking(&self, x: i32, z: i32) -> bool { + self.get(x, z) + .is_none_or(|(l, s)| l <= BLOCK_TICKING && s <= ENTITY_TICKING) + } + /// `ChunkHolder.getFullStatus` is block ticking or more: the chunk's + /// ticking future can complete (its saved ticks unpack then). + pub fn loaded_ticking(&self, x: i32, z: i32) -> bool { + self.get(x, z).is_none_or(|(l, _)| l <= BLOCK_TICKING) + } + /// The same as [`Self::entity_ticking`] at a block position. + pub fn entity_ticking_at(&self, x: i32, z: i32) -> bool { + self.entity_ticking(x >> 4, z >> 4) + } + /// The same as [`Self::block_ticking`] at a block position. + pub fn block_ticking_at(&self, x: i32, z: i32) -> bool { + self.block_ticking(x >> 4, z >> 4) + } +} + +/// The levels, rebuilt only when their sources change (a player crossing +/// into another chunk, a distance or a forced chunk changing). +#[derive(Default)] +pub struct ChunkTickets { + sources: Option<Sources>, + levels: Levels, +} + +impl ChunkTickets { + /// `None`: tick everywhere. + pub fn update(&mut self, mut sources: Option<Sources>) { + if let Some(s) = sources.as_mut() { + s.players.sort_unstable(); + s.players.dedup(); + s.forced.sort_unstable(); + } + if sources == self.sources { + return; + } + self.levels = Levels(sources.as_ref().map(|s| Arc::new(compute(s)))); + self.sources = sources; + } + pub fn levels(&self) -> Levels { + self.levels.clone() + } +} + +fn compute(s: &Sources) -> FxHashMap<(i32, i32), (u8, u8)> { + let view = s.view_distance.clamp(0, 32); + let simulation = s.simulation_distance.clamp(0, 32); + let mut levels: FxHashMap<(i32, i32), (u8, u8)> = FxHashMap::default(); + let mut lower = |key, loading: i32, sim: i32| { + let e = levels.entry(key).or_insert(NONE); + e.0 = e.0.min(loading.min(i32::from(NONE.0)) as u8); + e.1 = e.1.min(sim.min(i32::from(NONE.1)) as u8); + }; + // PLAYER_LOADING within the view distance, PLAYER_SIMULATION at the + // player's chunk (`getPlayerTicketLevel`: never below 0). + let player_sim = (i32::from(ENTITY_TICKING) - simulation).max(0); + let reach = (view + 1).max(i32::from(BLOCK_TICKING) - player_sim); + for &(px, pz) in &s.players { + for dz in -reach..=reach { + for dx in -reach..=reach { + let d = dx.abs().max(dz.abs()); + lower( + (px + dx, pz + dz), + i32::from(ENTITY_TICKING) + (d - view).max(0), + player_sim + d, + ); + } + } + } + for &(fx, fz) in &s.forced { + for dz in -1i32..=1 { + for dx in -1i32..=1 { + let level = i32::from(ENTITY_TICKING) + dx.abs().max(dz.abs()); + lower((fx + dx, fz + dz), level, level); + } + } + } + levels.retain(|_, l| *l != NONE); + levels +} + +#[cfg(test)] +mod tests { + use super::*; + + fn levels(players: &[(i32, i32)], forced: &[(i32, i32)], view: i32, sim: i32) -> Levels { + let mut t = ChunkTickets::default(); + t.update(Some(Sources { + players: players.to_vec(), + forced: forced.to_vec(), + view_distance: view, + simulation_distance: sim, + })); + t.levels() + } + + #[test] + fn simulation_distance_inside_the_view() { + // view 8, simulation 4: entities and random ticks out to 4 chunks, + // scheduled ticks out to 5. + let l = levels(&[(0, 0)], &[], 8, 4); + assert!(l.entity_ticking(4, -4) && !l.entity_ticking(5, 0)); + assert!(l.random_ticking(-4, 4) && !l.random_ticking(0, 5)); + assert!(l.block_ticking(5, 5) && !l.block_ticking(6, 0)); + assert!(l.loaded_ticking(9, 9) && !l.loaded_ticking(10, 0)); + } + + #[test] + fn view_distance_inside_the_simulation() { + // view 4, simulation 10: what isn't loaded at entity ticking (beyond + // the view distance) runs no entities, and block ticks stop where the + // chunk is only full (beyond the view distance + 1). + let l = levels(&[(0, 0)], &[], 4, 10); + assert!(l.entity_ticking(4, 0) && !l.entity_ticking(5, 0)); + assert!(l.random_ticking(5, 0) && !l.random_ticking(6, 0)); + assert!(l.block_ticking(5, 5) && !l.block_ticking(6, 0)); + } + + #[test] + fn every_player_and_forced_chunk() { + let l = levels(&[(0, 0), (40, 0)], &[(-100, 7)], 4, 4); + assert!(l.entity_ticking(44, 0) && l.entity_ticking(0, -4)); + assert!(!l.entity_ticking(20, 0)); + // A forced chunk entity ticks, its neighbours only block tick. + assert!(l.entity_ticking(-100, 7) && !l.entity_ticking(-101, 7)); + assert!(l.block_ticking(-101, 8) && !l.block_ticking(-102, 7)); + assert!(!l.random_ticking(-101, 7)); + assert!(l.entity_ticking_at(-1600, 112) && !l.block_ticking_at(-1617, 112)); + } + + #[test] + fn no_tickets_tick_nothing_and_no_sources_everything() { + let none = levels(&[], &[], 10, 10); + assert!(!none.block_ticking(0, 0) && !none.entity_ticking(0, 0)); + let everywhere = ChunkTickets::default().levels(); + assert!(everywhere.random_ticking(1000, -1000)); + } + + #[test] + fn rebuilt_only_when_sources_change() { + let mut t = ChunkTickets::default(); + let s = |players: Vec<(i32, i32)>| { + Some(Sources { + players, + forced: Vec::new(), + view_distance: 2, + simulation_distance: 2, + }) + }; + t.update(s(vec![(0, 0), (5, 5)])); + let first = t.levels(); + t.update(s(vec![(5, 5), (0, 0)])); + assert!(Arc::ptr_eq( + first.0.as_ref().unwrap(), + t.levels().0.as_ref().unwrap() + )); + t.update(s(vec![(1, 0), (5, 5)])); + assert!(t.levels().entity_ticking(3, 0) && !first.entity_ticking(3, 0)); + t.update(None); + assert!(t.levels().0.is_none()); + } +} diff --git a/tools/lan_e2e.py b/tools/lan_e2e.py index f0db98e40..144ed6961 100755 --- a/tools/lan_e2e.py +++ b/tools/lan_e2e.py @@ -69,6 +69,8 @@ address. The script then checks, from both sides, what a guest's game used to ge swing when its hoe tills dirt (the server's use) (#848). - time: the guest's clock is the host's: it stops with `/time pause`, and catches up with the 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. - light: the guest's light matches the host's: around a torch placed near it, under a roof and once a block of the roof is removed under the sky, and in the last chunk it tracks next to glowstone in a chunk it doesn't (only the server's light updates bring that one). @@ -105,7 +107,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', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'trials', 'clicks', 'sleep', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'light', 'time', 'swings', 'plates', 'effects', 'portals', 'distance'] +CHECKS = ['tab', 'self', 'armour', 'nametags', 'walls', 'chest', 'crafting', 'sign', 'damage', 'mobs', 'hazards', 'pvp', 'hurt', 'respawn', 'containers', 'feedback', 'titles', 'chat', 'commands', 'recipes', 'machines', 'brewing', 'trials', 'clicks', 'sleep', 'push', 'eat', 'eating', 'xp', 'objects', 'projectiles', 'light', 'time', 'swings', 'plates', 'effects', 'portals', 'distance', 'growth'] class Game: @@ -1528,6 +1530,48 @@ def same_light(host, guest, lo, hi, what, ticks=100): f'{h["sky"][i]} block {h["block"][i]}, guest sky {g["sky"][i]} block {g["block"][i]}') +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) + guest('command', command='gamemode creative') + guest('command', command=f'tp @s {x0 + 1000:.2f} 200 {z0:.2f}') + guest.wait(100) + x, y, z = (int(v // 1) for v in pos_of(guest)) + # A platform in the air over wherever the guest landed: a water source two blocks east of the + # guest, wheat on farmland two blocks west. Vanilla's water spreads only towards the nearest + # drop (FlowingFluid.getSpread), so any of the source's four neighbours may take it. Wheat + # grows only in daylight (raw brightness 9 or more). + top = max(y + 12, 120) + water = (x + 2, top + 1, z) + beside = [(water[0] + dx, water[1], water[2] + dz) for dx, dz in ((1, 0), (-1, 0), (0, 1), (0, -1))] + wheat = (x - 2, top + 1, z) + flowed = [] + try: + host('command', command='time set noon') + guest('command', command=f'fill {x - 4} {top} {z - 2} {x + 4} {top} {z + 2} minecraft:stone') + guest('command', command=f'setblock {wheat[0]} {top} {wheat[2]} minecraft:farmland[moisture=7]') + guest('command', command=f'setblock {wheat[0]} {wheat[1]} {wheat[2]} minecraft:wheat[age=0]') + guest('command', command='gamerule random_tick_speed 1000') + guest('command', command=f'setblock {water[0]} {water[1]} {water[2]} minecraft:water') + for _ in range(40): + guest.wait(10) + flowed = [p for p in beside if guest.raw('block', *p).get('block') == 'minecraft:water'] + if flowed: + break + age = wait_state(guest, wheat, 'age', '7', 2400) + guest.shot(out, 'growth') + finally: + guest('command', command='gamerule random_tick_speed 3') + host('command', command='time set day') + guest('command', command=f'tp @s {x0:.2f} {y0:.2f} {z0:.2f}') + guest('command', command='gamemode survival') + guest.wait(40) + detail = {'flowed': flowed, 'wheat age': age} + assert flowed, f'the water beside the guest did not flow: {detail}' + assert age == '7', f'the wheat beside the guest did not grow: {detail}' + return detail + + def check_light(host, guest, out): gx, gy, gz = (int(v // 1) for v in pos_of(guest)) results = {} @@ -1591,7 +1635,7 @@ CHECK_FNS = {'tab': check_tab, 'self': check_self, 'armour': check_armour, 'name 'xp': check_xp, 'objects': check_objects, 'projectiles': check_projectiles, 'light': check_light, 'plates': check_plates, 'swings': check_swings, - 'time': check_time} + 'time': check_time, 'growth': check_growth} def run(ctl, out, resources, checks): diff --git a/tools/test_dedicated_server_parity.py b/tools/test_dedicated_server_parity.py index 6ac9aecbe..e8497d7f8 100644 --- a/tools/test_dedicated_server_parity.py +++ b/tools/test_dedicated_server_parity.py @@ -268,6 +268,12 @@ def run_side(label, command, directory, client): # it stays put; experience keeps its profession). server.console('summon minecraft:villager ~1 ~ ~ {NoAI:1b,Xp:1,VillagerData:' '{profession:"minecraft:librarian",level:2,type:"minecraft:plains"}}') + # The saved world still has fluid ticks due in the area the client is sent (a lava fall + # that never settles), and they run once their chunk ticks. When that is, against when the + # chunk is sent, follows how fast the server loads the chunks around the joining player: + # each run, vanilla sends a different set of them already flowed. Frozen until the client + # has its chunks, both servers send the world as saved; blocks tick again from the chat on. + server.console('tick freeze') port = int(PROPERTIES_PORTS[label]) legacy = legacy_ping(port) # The client asks to be made an operator once it has traded, runs /kill and respawns. @@ -282,7 +288,11 @@ def run_side(label, command, directory, client): joined = threading.Thread(target=join) joined.start() deadline = time.time() + 300 + frozen = True while joined.is_alive() and not any('<Tester> ready to respawn' in l for l in server.lines): + if frozen and any('<Tester> hello from the parity client' in l for l in server.lines): + server.console('tick unfreeze') + frozen = False if time.time() > deadline: break time.sleep(0.2) From c7985974e79af41a9f827f44c99d5d463c0d9b09 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 22:12:13 +0200 Subject: [PATCH 158/163] Better Desert Temples' placeholder blocks: suspicious sand, sherds, swaps Better Desert Temples builds its temples with placeholder blocks (orange, red and white glass, blue and yellow concrete, red wool, polished diorite, blank pots) that its Java processors turn into suspicious sand, sand and sandstone, upside-down stairs, cobwebs, terracotta, TNT and pots with sherds. Carry dropped them, so the placeholders stayed in the world. - Game: a horizon:pick processor. A block of `block` takes the first pick whose `below` is past one settings.getRandom(pos).nextFloat(), else `default`; an outcome is a state or one of several by nextInt (Util.getRandom), a new block entity or the block's own, and NBT lists of picked strings (one float each). - Carry: the fixed swaps become vanilla's rule; the random ones horizon:pick with the mod's bounds (BlockStateRandomizer's sums as floats). The processors that read or change the world around (pillars, Diorite's waterlogging) stay dropped. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/processors.rs | 144 ++++++++++ .../src/worldgen/structure/processor.rs | 253 ++++++++++++++++++ docs/modpacks.md | 10 +- 3 files changed, 404 insertions(+), 3 deletions(-) diff --git a/crates/horizon-port-pack/src/processors.rs b/crates/horizon-port-pack/src/processors.rs index cb1a8a565..737a90433 100644 --- a/crates/horizon-port-pack/src/processors.rs +++ b/crates/horizon-port-pack/src/processors.rs @@ -236,6 +236,11 @@ fn as_data(kind: &str, p: &Value, data: &ProcessorData) -> Option<Vec<Value>> { |s| config(s.get("ominous") == Some(&"true")), )] } + _ if ns == "betterdeserttemples" + && let Some(processor) = desert_temple(kind) => + { + vec![processor] + } _ if ns == "betterdungeons" || ns == "betterdeserttemples" => vec![yung_spawner(kind, p)?], _ => return None, }) @@ -364,6 +369,110 @@ pub fn upgrade_trial_spawner(config: &mut Value) -> bool { changed } +/// A block state as 26.3 writes it. +fn block(id: &str) -> Value { + json!({"id": id}) +} + +/// Better Desert Temples' placeholder blocks (glass, concrete and wool in +/// the templates) as the mod's processors turn them: the fixed ones as +/// vanilla's `rule`, the random ones as the game's `horizon:pick`, with the +/// mod's bounds on one `nextFloat` (YUNG's BlockStateRandomizer adds its +/// chances up in floats). The ones that read or change the world around +/// (pillars, Diorite's waterlogging) stay dropped. +fn desert_temple(kind: &str) -> Option<Value> { + let swap = |from: &str, to: &str| { + json!({"processor_type": "minecraft:rule", "rules": [{ + "input_predicate": {"predicate_type": "minecraft:block_match", "block": from}, + "location_predicate": {"predicate_type": "minecraft:always_true"}, + "output_state": block(to)}]}) + }; + let pick = |from: &str, picks: Vec<Value>, default: Value| json!({"processor_type": "horizon:pick", "block": from, "picks": picks, "default": default}); + // YUNG's BlockStateRandomizer: an entry wins below the sum of the + // chances so far, summed as floats. + let randomizer = |entries: &[(f32, &str)]| { + let mut bottom = 0f32; + entries + .iter() + .map(|(chance, id)| { + bottom += chance; + json!({"below": bottom as f64, "state": block(id)}) + }) + .collect::<Vec<_>>() + }; + let at = |below: f32, id: &str| json!({"below": below as f64, "state": block(id)}); + // Sandstone stairs, upside down, facing Plane.HORIZONTAL.getRandomDirection. + let stairs = || { + let states: Vec<Value> = ["north", "east", "south", "west"] + .iter() + .map(|facing| { + json!({"id": "minecraft:sandstone_stairs", "properties": { + "facing": facing, "half": "top", "shape": "straight", "waterlogged": "false"}}) + }) + .collect(); + json!({"states": states}) + }; + Some(match kind.strip_prefix("betterdeserttemples:")? { + "blue_concrete_processor" => swap("minecraft:blue_concrete", "minecraft:blue_terracotta"), + "yellow_concrete_processor" => { + swap("minecraft:yellow_concrete", "minecraft:yellow_terracotta") + } + "red_wool_processor" => swap("minecraft:red_wool", "minecraft:tnt"), + "white_stained_glass_processor" => pick( + "minecraft:white_stained_glass", + randomizer(&[(0.4, "minecraft:cobweb")]), + json!({"state": block("minecraft:air")}), + ), + "polished_diorite_processor" => pick( + "minecraft:polished_diorite", + randomizer(&[(0.6, "minecraft:cut_sandstone")]), + json!({"state": block("minecraft:sandstone")}), + ), + "orange_stained_glass_processor" => { + let mut sus = at(0.01, "minecraft:suspicious_sand"); + sus["nbt"] = json!({"LootTable": "minecraft:archaeology/desert_pyramid"}); + let mut stairs = stairs(); + stairs["below"] = (0.45f32 as f64).into(); + pick( + "minecraft:orange_stained_glass", + vec![ + sus, + at(0.1, "minecraft:sand"), + at(0.2, "minecraft:sandstone"), + stairs, + ], + json!({"state": block("minecraft:cut_sandstone")}), + ) + } + "red_stained_glass_processor" => pick( + "minecraft:red_stained_glass", + vec![at(0.3, "minecraft:sand"), at(0.75, "minecraft:sandstone")], + stairs(), + ), + "pot_processor" => { + // Four sherds, one float each; the pot back to its default state. + let values: Vec<Value> = [ + (0.05f32, "archer"), + (0.1, "miner"), + (0.15, "prize"), + (0.2, "skull"), + ] + .iter() + .map(|(below, sherd)| { + json!({"below": *below as f64, "value": format!("minecraft:{sherd}_pottery_sherd")}) + }) + .collect(); + pick( + "minecraft:decorated_pot", + Vec::new(), + json!({"state": block("minecraft:decorated_pot"), "lists": [{ + "key": "sherds", "count": 4, "values": values, "default": "minecraft:brick"}]}), + ) + } + _ => return None, + }) +} + /// [`as_data`]'s `horizon:spawner_mobs` for the mods' spawner randomizing /// processors, whose fields have the same names and defaults. fn spawner_mobs(p: &Value, mobs: Vec<Value>, rules: Option<Value>) -> Value { @@ -729,4 +838,39 @@ mod tests { ); assert!(!upgrade_trial_spawner(&mut config)); } + + #[test] + fn desert_temple_placeholders_become_rules_and_picks() { + let mut list = json!({"processors": [ + {"processor_type": "betterdeserttemples:red_wool_processor"}, + {"processor_type": "betterdeserttemples:white_stained_glass_processor"}, + {"processor_type": "betterdeserttemples:orange_stained_glass_processor"}, + {"processor_type": "betterdeserttemples:pot_processor"}, + {"processor_type": "betterdeserttemples:quartz_pillar_processor"}]}); + let mut carried = BTreeMap::new(); + assert!(carry("processor_list", &mut list, &data(), &mut carried)); + let p = list["processors"].as_array().unwrap(); + assert_eq!( + p[0]["rules"][0]["output_state"], + json!({"id": "minecraft:tnt"}) + ); + assert_eq!(p[1]["processor_type"], "horizon:pick"); + assert_eq!(p[1]["picks"][0]["below"], 0.4f32 as f64); + assert_eq!(p[1]["default"]["state"]["id"], "minecraft:air"); + let glass = &p[2]["picks"]; + assert_eq!(glass[0]["state"]["id"], "minecraft:suspicious_sand"); + assert_eq!( + glass[0]["nbt"]["LootTable"], + "minecraft:archaeology/desert_pyramid" + ); + assert_eq!(glass[3]["states"].as_array().unwrap().len(), 4); + assert_eq!(glass[3]["below"], 0.45f32 as f64); + assert_eq!(p[3]["default"]["lists"][0]["count"], 4); + // The pillar reads the world below: still Java, still dropped later. + assert_eq!( + p[4]["processor_type"], + "betterdeserttemples:quartz_pillar_processor" + ); + assert_eq!(carried.values().sum::<usize>(), 4); + } } diff --git a/crates/horizon-world/src/worldgen/structure/processor.rs b/crates/horizon-world/src/worldgen/structure/processor.rs index 8fa1f769a..204a168db 100644 --- a/crates/horizon-world/src/worldgen/structure/processor.rs +++ b/crates/horizon-world/src/worldgen/structure/processor.rs @@ -182,6 +182,7 @@ pub enum Processor { LavaSubmerged, BlackstoneReplace, SpawnerMobs(Box<SpawnerMobs>), + Pick(Box<Pick>), } #[derive(Clone, Debug, Default)] pub struct ProcessorList(pub Vec<Processor>); @@ -198,6 +199,146 @@ const SPAWNER_FIELDS: [(&str, &str, i16); 7] = [ ("spawn_range", "SpawnRange", 4), ]; +/// `horizon:pick`, which `horizon-port-pack` writes for the mods' processors +/// that turn a placeholder block into one of several (YUNG's, written in +/// Java): a block of `block` takes the first of `picks` whose `below` is past +/// one `settings.getRandom(pos).nextFloat()`, else `default` (no float is +/// drawn when there are no picks; with no default the block stays). +#[derive(Clone, Debug)] +pub struct Pick { + block: String, + picks: Vec<(f32, Outcome)>, + default: Option<Outcome>, +} +#[derive(Clone, Debug)] +struct Outcome { + /// The state, or one of them by `nextInt(len)` (Util.getRandom), drawn + /// after the pick. + states: Vec<BlockStateId>, + /// The new block entity; the block's own stays when missing. + nbt: Option<Compound>, + /// Keys set to lists of `count` strings, each the first of `values` + /// whose bound is past a new `nextFloat`, else `default` (pot sherds). + lists: Vec<PickedList>, +} +#[derive(Clone, Debug)] +struct PickedList { + key: String, + count: usize, + values: Vec<(f32, String)>, + default: String, +} +fn below(v: &Value) -> Result<f32, DecodeError> { + v["below"] + .as_f64() + .map(|b| b as f32) + .ok_or(DecodeError::Field("pick bound")) +} +impl Pick { + fn decode( + value: &Value, + state: impl Fn(&Value) -> Result<BlockStateId, DecodeError>, + ) -> Result<Self, DecodeError> { + let outcome = |v: &Value| -> Result<Outcome, DecodeError> { + let states = match v.get("states") { + Some(list) => list + .as_array() + .ok_or(DecodeError::Field("pick states"))? + .iter() + .map(&state) + .collect::<Result<Vec<_>, _>>()?, + None => vec![state(&v["state"])?], + }; + if states.is_empty() { + return Err(DecodeError::Field("pick states")); + } + let nbt = match v.get("nbt").map(json_to_nbt) { + Some(Tag::Compound(c)) => Some(c), + Some(_) => return Err(DecodeError::Field("pick nbt")), + None => None, + }; + let text = |v: &Value| { + v.as_str() + .map(str::to_owned) + .ok_or(DecodeError::Field("pick list")) + }; + let lists = v["lists"] + .as_array() + .into_iter() + .flatten() + .map(|l| { + Ok(PickedList { + key: text(&l["key"])?, + count: l["count"].as_u64().ok_or(DecodeError::Field("pick list"))? as usize, + values: l["values"] + .as_array() + .into_iter() + .flatten() + .map(|e| Ok((below(e)?, text(&e["value"])?))) + .collect::<Result<_, DecodeError>>()?, + default: text(&l["default"])?, + }) + }) + .collect::<Result<_, DecodeError>>()?; + Ok(Outcome { states, nbt, lists }) + }; + Ok(Self { + block: value["block"] + .as_str() + .map(|b| super::super::tags::identifier(b).map(|i| i.to_string())) + .ok_or(DecodeError::Field("pick block"))??, + picks: value["picks"] + .as_array() + .into_iter() + .flatten() + .map(|p| Ok((below(p)?, outcome(p)?))) + .collect::<Result<_, DecodeError>>()?, + default: value.get("default").map(outcome).transpose()?, + }) + } + fn apply(&self, info: BlockInfo, random: &mut dyn ProcessorRandom) -> BlockInfo { + let outcome = match self.picks.is_empty() { + true => self.default.as_ref(), + false => { + let f = random.float(); + self.picks + .iter() + .find(|(b, _)| f < *b) + .map(|(_, o)| o) + .or(self.default.as_ref()) + } + }; + let Some(outcome) = outcome else { + return info; + }; + let state = match outcome.states.as_slice() { + [one] => *one, + many => many[random.int(many.len() as i32) as usize], + }; + let mut nbt = outcome.nbt.clone().or(info.nbt); + for list in &outcome.lists { + let values = (0..list.count) + .map(|_| { + let f = random.float(); + let v = list + .values + .iter() + .find(|(b, _)| f < *b) + .map_or(&list.default, |(_, v)| v); + Tag::String(v.as_str().into()) + }) + .collect(); + nbt.get_or_insert_with(Compound::new) + .insert(list.key.as_str().into(), Tag::List(values)); + } + BlockInfo { + pos: info.pos, + state, + nbt, + } + } +} + /// `horizon:spawner_mobs`, which `horizon-port-pack` writes for the spawner /// randomizing processors of Moog's Structure Lib and Repurposed Structures /// (Java code in the mods): a spawner gets one mob of a weighted list, @@ -429,6 +570,7 @@ impl Processor { None => Ok(resources.registry.default_state("minecraft:air").unwrap()), })?)) } + "horizon:pick" => Self::Pick(Box::new(Pick::decode(value, state)?)), _ => return Err(DecodeError::Field("structure processor type")), }) } @@ -693,6 +835,10 @@ fn process_block<W: PlacementContext>( Some(info) } Processor::Capped { .. } => Some(info), + Processor::Pick(pick) => match name(info.state) == pick.block { + true => Some(settings.with_random(info.pos, |r| pick.apply(info, r))), + false => Some(info), + }, Processor::SpawnerMobs(spawner) => { if name(info.state) != "minecraft:spawner" { return Ok(Some(info)); @@ -1364,4 +1510,111 @@ mod tests { let bad = json!({"type": "horizon:edit", "remove": [1], "data": {}}); assert!(Modifier::decode(Some(&bad)).is_err()); } + + /// Scripted draws: floats in turn, then ints. + struct Draws(Vec<f32>, Vec<i32>); + impl ProcessorRandom for Draws { + fn float(&mut self) -> f32 { + self.0.remove(0) + } + fn int(&mut self, bound: i32) -> i32 { + let i = self.1.remove(0); + assert!(i < bound); + i + } + fn long(&mut self) -> i64 { + unreachable!() + } + } + + #[test] + fn picks_follow_yungs_cascade() { + // States by name: sand 1, sandstone 2, the four stairs 10..13. + let id = |v: &Value| { + Ok(BlockStateId(match v["Name"].as_str() { + Some("minecraft:sand") => 1, + Some("minecraft:sandstone") => 2, + Some("minecraft:suspicious_sand") => 3, + _ => { + 10 + ["north", "east", "south", "west"] + .iter() + .position(|f| v["Properties"]["facing"] == *f) + .unwrap_or(9) as u32 + } + })) + }; + let stairs: Vec<Value> = ["north", "east", "south", "west"] + .iter() + .map(|f| json!({"Name": "minecraft:sandstone_stairs", "Properties": {"facing": f}})) + .collect(); + let pick = Pick::decode( + &json!({"block": "red_stained_glass", "picks": [ + {"below": 0.01, "state": {"Name": "minecraft:suspicious_sand"}, + "nbt": {"LootTable": "minecraft:archaeology/desert_pyramid"}}, + {"below": 0.3, "state": {"Name": "minecraft:sand"}}, + {"below": 0.75, "state": {"Name": "minecraft:sandstone"}}], + "default": {"states": stairs}}), + id, + ) + .unwrap(); + assert_eq!(pick.block, "minecraft:red_stained_glass"); + let glass = || BlockInfo { + pos: [1, 2, 3], + state: BlockStateId(0), + nbt: Some(Compound::new()), + }; + let run = |f: f32, i: Vec<i32>| pick.apply(glass(), &mut Draws(vec![f], i)); + let sus = run(0.005, vec![]); + assert_eq!(sus.state, BlockStateId(3)); + assert!( + sus.nbt + .unwrap() + .contains_key(&JavaString::from("LootTable")) + ); + assert_eq!(run(0.01, vec![]).state, BlockStateId(1)); + assert_eq!(run(0.2999, vec![]).nbt, Some(Compound::new())); + assert_eq!(run(0.3, vec![]).state, BlockStateId(2)); + // The stairs' facing: Plane.HORIZONTAL[nextInt(4)] after the pick. + assert_eq!(run(0.75, vec![2]).state, BlockStateId(12)); + assert_eq!(run(0.99, vec![1]).state, BlockStateId(11)); + + let pot = Pick::decode( + &json!({"block": "minecraft:decorated_pot", "default": { + "state": {"Name": "minecraft:sand"}, + "lists": [{"key": "sherds", "count": 4, "default": "minecraft:brick", + "values": [{"below": 0.05, "value": "minecraft:archer_pottery_sherd"}, + {"below": 0.1, "value": "minecraft:miner_pottery_sherd"}]}]}}), + id, + ) + .unwrap(); + // No picks: no float for them; one float per sherd. + let out = pot.apply( + BlockInfo { + nbt: None, + ..glass() + }, + &mut Draws(vec![0.5, 0.01, 0.07, 0.1], vec![]), + ); + let Some(Tag::List(sherds)) = out.nbt.unwrap().get(&JavaString::from("sherds")).cloned() + else { + panic!("sherds") + }; + let names: Vec<String> = sherds + .iter() + .map(|t| match t { + Tag::String(s) => s.to_string_lossy(), + _ => String::new(), + }) + .collect(); + assert_eq!( + names, + [ + "minecraft:brick", + "minecraft:archer_pottery_sherd", + "minecraft:miner_pottery_sherd", + "minecraft:brick" + ] + ); + assert!(Pick::decode(&json!({"block": "a", "default": {"states": []}}), id).is_err()); + } } diff --git a/docs/modpacks.md b/docs/modpacks.md index fcd87f15c..04e3dd987 100644 --- a/docs/modpacks.md +++ b/docs/modpacks.md @@ -453,9 +453,13 @@ Two cases the oracle fills in: template was saved with (a vault saved with `state_updating_resumes_at` far in the future never opens; a spawner's saved `spawn_data` blocks its own mobs) and merges in the spawner's normal and ominous configs (by id: the carry upgrades `trial_spawner/` files' - mobs to 26.3's `equipment`) or the vault's loot table and key. 125 of the 1,427 - processors are carried; 1,302 are still taken out (blocks swapped, aged or propped up, - YUNG's chest caps). + mobs to 26.3's `equipment`) or the vault's loot table and key. Better Desert Temples' + placeholder blocks (orange, red and white glass, blue and yellow concrete, red wool, + polished diorite, blank pots) become what its processors make of them: the fixed swaps as + vanilla's `rule`, the random ones (suspicious sand, sand and sandstone, upside-down stairs, + cobwebs, sherds on the pots) as the game's `horizon:pick`, on the same `nextFloat` as the + mod. 133 of the 1,427 processors are carried; 1,294 are still taken out (blocks swapped, + aged or propped up, YUNG's chest caps). In the 128×128-chunk square (seed 1234), every spawner of a mod structure now has its mob: in the Overworld 83 Better Dungeons spawners held the template's placeholder pig and 17 of Moog's were empty (763 spawners with a mob, up from 628); in the Nether the 52 empty ones From 50215b484ac0d53e524fd3ece0a27f810f262995 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 22:39:03 +0200 Subject: [PATCH 159/163] Better Dungeons' small dungeons: one or two chests, as the mod caps them Better Dungeons' small dungeon templates hold several chests; its Java chest processor keeps the first, then each other one on nextFloat <= 0.2 until two have stayed, and turns the rest into cave air. Carry dropped it, so every chest stayed. - Game: horizon:count_cap. Of `blocks`, the first `min` a placement meets stay, then each stays on settings.getRandom(pos).nextFloat() <= chance until `max` have; the others become `replacement`. Counted per placement (PlaceSettings, reset in process_infos), like the mod's DungeonContext, set up per StructureTemplate.placeInWorld. - Carry: betterdungeons:small_dungeon_chest_processor becomes it with the mod's config defaults (1, 2, 0.2; chest and trapped chest). Seed 1234, five small dungeons decorated: 12 chests -> 6. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/processors.rs | 23 +++++ .../src/worldgen/structure/processor.rs | 95 +++++++++++++++++++ docs/modpacks.md | 7 +- 3 files changed, 123 insertions(+), 2 deletions(-) diff --git a/crates/horizon-port-pack/src/processors.rs b/crates/horizon-port-pack/src/processors.rs index 737a90433..818e5db14 100644 --- a/crates/horizon-port-pack/src/processors.rs +++ b/crates/horizon-port-pack/src/processors.rs @@ -241,6 +241,14 @@ fn as_data(kind: &str, p: &Value, data: &ProcessorData) -> Option<Vec<Value>> { { vec![processor] } + "betterdungeons:small_dungeon_chest_processor" => { + // Its config's defaults: one chest at least, two at most, a + // fifth of the others kept until then; ChestBlock covers both. + vec![json!({"processor_type": "horizon:count_cap", + "blocks": ["minecraft:chest", "minecraft:trapped_chest"], + "min": 1, "max": 2, "chance": 0.2f32 as f64, + "replacement": block("minecraft:cave_air")})] + } _ if ns == "betterdungeons" || ns == "betterdeserttemples" => vec![yung_spawner(kind, p)?], _ => return None, }) @@ -873,4 +881,19 @@ mod tests { ); assert_eq!(carried.values().sum::<usize>(), 4); } + + #[test] + fn small_dungeon_chests_are_capped() { + let mut list = json!({"processors": [ + {"processor_type": "betterdungeons:small_dungeon_chest_processor"}]}); + let mut carried = BTreeMap::new(); + assert!(carry("processor_list", &mut list, &data(), &mut carried)); + let cap = &list["processors"][0]; + assert_eq!(cap["processor_type"], "horizon:count_cap"); + assert_eq!( + (cap["min"].as_u64(), cap["max"].as_u64()), + (Some(1), Some(2)) + ); + assert_eq!(cap["replacement"], json!({"id": "minecraft:cave_air"})); + } } diff --git a/crates/horizon-world/src/worldgen/structure/processor.rs b/crates/horizon-world/src/worldgen/structure/processor.rs index 204a168db..922664cba 100644 --- a/crates/horizon-world/src/worldgen/structure/processor.rs +++ b/crates/horizon-world/src/worldgen/structure/processor.rs @@ -183,6 +183,7 @@ pub enum Processor { BlackstoneReplace, SpawnerMobs(Box<SpawnerMobs>), Pick(Box<Pick>), + CountCap(Box<CountCap>), } #[derive(Clone, Debug, Default)] pub struct ProcessorList(pub Vec<Processor>); @@ -339,6 +340,56 @@ impl Pick { } } +/// `horizon:count_cap`, which `horizon-port-pack` writes for Better +/// Dungeons' chest processor (Java in the mod): of the `blocks` one +/// placement meets, the first `min` stay, the rest each stay when +/// `settings.getRandom(pos).nextFloat() <= chance` until `max` have, and the +/// others become `replacement`. The count is the placement's (the mod's +/// DungeonContext, set up per StructureTemplate.placeInWorld: one chunk of +/// the piece), shared by every such processor in it. +#[derive(Clone, Debug)] +pub struct CountCap { + blocks: BTreeSet<String>, + min: u32, + max: u32, + chance: f32, + replacement: BlockStateId, +} +impl CountCap { + fn decode( + value: &Value, + state: impl Fn(&Value) -> Result<BlockStateId, DecodeError>, + ) -> Result<Self, DecodeError> { + let count = |key: &'static str| { + value[key] + .as_u64() + .and_then(|n| u32::try_from(n).ok()) + .ok_or(DecodeError::Field(key)) + }; + Ok(Self { + blocks: value["blocks"] + .as_array() + .ok_or(DecodeError::Field("blocks"))? + .iter() + .map(|b| { + let b = b.as_str().ok_or(DecodeError::Field("blocks"))?; + Ok(super::super::tags::identifier(b)?.to_string()) + }) + .collect::<Result<_, DecodeError>>()?, + min: count("min")?, + max: count("max")?, + chance: float(value, "chance")?, + replacement: state(&value["replacement"])?, + }) + } + /// Whether a counted block stays, counting it if so. + fn keeps(&self, counted: &mut u32, roll: impl FnOnce() -> f32) -> bool { + let keep = *counted < self.min || (*counted < self.max && roll() <= self.chance); + *counted += u32::from(keep); + keep + } +} + /// `horizon:spawner_mobs`, which `horizon-port-pack` writes for the spawner /// randomizing processors of Moog's Structure Lib and Repurposed Structures /// (Java code in the mods): a spawner gets one mob of a weighted list, @@ -571,6 +622,7 @@ impl Processor { })?)) } "horizon:pick" => Self::Pick(Box::new(Pick::decode(value, state)?)), + "horizon:count_cap" => Self::CountCap(Box::new(CountCap::decode(value, state)?)), _ => return Err(DecodeError::Field("structure processor type")), }) } @@ -624,6 +676,8 @@ pub struct PlaceSettings<'a> { /// StructurePlaceSettings.ignoreEntities / finalizeEntities. pub ignore_entities: bool, pub finalize_entities: bool, + /// The blocks `horizon:count_cap` kept in this placement. + counted: u32, } impl<'a> PlaceSettings<'a> { pub fn new(rotation: Rotation) -> Self { @@ -638,6 +692,7 @@ impl<'a> PlaceSettings<'a> { known_shape: false, ignore_entities: false, finalize_entities: false, + counted: 0, } } pub fn with_processors(mut self, list: &'a ProcessorList) -> Self { @@ -835,6 +890,23 @@ fn process_block<W: PlacementContext>( Some(info) } Processor::Capped { .. } => Some(info), + Processor::CountCap(cap) => match cap.blocks.contains(name(info.state)) { + true => { + let pos = info.pos; + let mut counted = settings.counted; + let keep = cap.keeps(&mut counted, || settings.with_random(pos, |r| r.float())); + settings.counted = counted; + Some(match keep { + true => info, + false => BlockInfo { + pos, + state: cap.replacement, + nbt: None, + }, + }) + } + false => Some(info), + }, Processor::Pick(pick) => match name(info.state) == pick.block { true => Some(settings.with_random(info.pos, |r| pick.apply(info, r))), false => Some(info), @@ -956,6 +1028,7 @@ fn process_infos<W: PlacementContext>( reference: [i32; 3], settings: &mut PlaceSettings<'_>, ) -> Result<Vec<BlockInfo>, PlacementQueryError> { + settings.counted = 0; let whole = settings .processors .iter() @@ -1617,4 +1690,26 @@ mod tests { ); assert!(Pick::decode(&json!({"block": "a", "default": {"states": []}}), id).is_err()); } + + #[test] + fn count_caps_keep_the_first_then_some() { + let cap = CountCap::decode( + &json!({"blocks": ["chest", "minecraft:trapped_chest"], "min": 1, "max": 2, + "chance": 0.2, "replacement": {"id": "minecraft:cave_air"}}), + |_| Ok(BlockStateId(5)), + ) + .unwrap(); + assert!(cap.blocks.contains("minecraft:chest")); + let mut counted = 0; + // The first stays without a roll. + assert!(cap.keeps(&mut counted, || unreachable!())); + // Then each stays on nextFloat <= 0.2, until two have. + assert!(!cap.keeps(&mut counted, || 0.21)); + assert!(cap.keeps(&mut counted, || 0.2)); + assert!(!cap.keeps(&mut counted, || unreachable!())); + assert_eq!(counted, 2); + assert!( + CountCap::decode(&json!({"blocks": [], "min": -1}), |_| Ok(BlockStateId(5))).is_err() + ); + } } diff --git a/docs/modpacks.md b/docs/modpacks.md index 04e3dd987..b6daee867 100644 --- a/docs/modpacks.md +++ b/docs/modpacks.md @@ -458,8 +458,11 @@ Two cases the oracle fills in: polished diorite, blank pots) become what its processors make of them: the fixed swaps as vanilla's `rule`, the random ones (suspicious sand, sand and sandstone, upside-down stairs, cobwebs, sherds on the pots) as the game's `horizon:pick`, on the same `nextFloat` as the - mod. 133 of the 1,427 processors are carried; 1,294 are still taken out (blocks swapped, - aged or propped up, YUNG's chest caps). + mod. Better Dungeons' small dungeons keep one chest and each other one with a fifth's + chance, two at most (the game's `horizon:count_cap`, counted per placement as the mod's + DungeonContext is): 12 chests in five small dungeons at seed 1234 become 6. + 136 of the 1,427 processors are carried; 1,291 are still taken out (blocks swapped, aged + or propped up). In the 128×128-chunk square (seed 1234), every spawner of a mod structure now has its mob: in the Overworld 83 Better Dungeons spawners held the template's placeholder pig and 17 of Moog's were empty (763 spawners with a mob, up from 628); in the Nether the 52 empty ones From a9ad185287ca9e369bdb3a02f0da537cf56f0757 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 22:45:28 +0200 Subject: [PATCH 160/163] Lithostitched's block swaps, with the properties both blocks have ChoiceTheorem's Overhauled Village swaps blocks in its templates through Lithostitched's block_swap processor (137 lists): a map of block to block, the new one taking Block.withPropertiesOf the old state, and the block left alone when the new one is not registered. Carry dropped it. - Game: horizon:block_swap, the same map; the new block's default state with each property of the old one it has too (by name, when the value is one of its own). - Carry: lithostitched:block_swap becomes it. ATM10: processors carried 136 -> 273 of 1,427 (dropped 1,291 -> 1,154). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/processors.rs | 23 ++++++ .../src/worldgen/structure/processor.rs | 82 +++++++++++++++++++ docs/modpacks.md | 8 +- 3 files changed, 111 insertions(+), 2 deletions(-) diff --git a/crates/horizon-port-pack/src/processors.rs b/crates/horizon-port-pack/src/processors.rs index 818e5db14..39fc2ef33 100644 --- a/crates/horizon-port-pack/src/processors.rs +++ b/crates/horizon-port-pack/src/processors.rs @@ -241,6 +241,11 @@ fn as_data(kind: &str, p: &Value, data: &ProcessorData) -> Option<Vec<Value>> { { vec![processor] } + "lithostitched:block_swap" => { + // The same map; the game's swap keeps the properties both have. + p["blocks"].as_object()?; + vec![json!({"processor_type": "horizon:block_swap", "blocks": p["blocks"]})] + } "betterdungeons:small_dungeon_chest_processor" => { // Its config's defaults: one chest at least, two at most, a // fifth of the others kept until then; ChestBlock covers both. @@ -896,4 +901,22 @@ mod tests { ); assert_eq!(cap["replacement"], json!({"id": "minecraft:cave_air"})); } + + #[test] + fn lithostitched_block_swaps_become_the_games() { + let mut list = json!({"processors": [ + {"processor_type": "lithostitched:block_swap", + "blocks": {"minecraft:cobblestone": "minecraft:mossy_cobblestone"}}, + {"processor_type": "lithostitched:block_swap", "blocks": []}]}); + let mut carried = BTreeMap::new(); + assert!(carry("processor_list", &mut list, &data(), &mut carried)); + let p = list["processors"].as_array().unwrap(); + assert_eq!( + p[0], + json!({"processor_type": "horizon:block_swap", + "blocks": {"minecraft:cobblestone": "minecraft:mossy_cobblestone"}}) + ); + // A map that is not one stays Java (dropped later). + assert_eq!(p[1]["processor_type"], "lithostitched:block_swap"); + } } diff --git a/crates/horizon-world/src/worldgen/structure/processor.rs b/crates/horizon-world/src/worldgen/structure/processor.rs index 922664cba..4be7a07aa 100644 --- a/crates/horizon-world/src/worldgen/structure/processor.rs +++ b/crates/horizon-world/src/worldgen/structure/processor.rs @@ -184,6 +184,9 @@ pub enum Processor { SpawnerMobs(Box<SpawnerMobs>), Pick(Box<Pick>), CountCap(Box<CountCap>), + /// `horizon:block_swap` (Lithostitched's `block_swap`): blocks by name + /// become others, keeping the properties both have. + BlockSwap(std::collections::BTreeMap<String, String>), } #[derive(Clone, Debug, Default)] pub struct ProcessorList(pub Vec<Processor>); @@ -622,6 +625,20 @@ impl Processor { })?)) } "horizon:pick" => Self::Pick(Box::new(Pick::decode(value, state)?)), + "horizon:block_swap" => Self::BlockSwap( + value["blocks"] + .as_object() + .ok_or(DecodeError::Field("blocks"))? + .iter() + .map(|(from, to)| { + let to = to.as_str().ok_or(DecodeError::Field("blocks"))?; + Ok(( + super::super::tags::identifier(from)?.to_string(), + super::super::tags::identifier(to)?.to_string(), + )) + }) + .collect::<Result<_, DecodeError>>()?, + ), "horizon:count_cap" => Self::CountCap(Box::new(CountCap::decode(value, state)?)), _ => return Err(DecodeError::Field("structure processor type")), }) @@ -714,6 +731,30 @@ impl<'a> PlaceSettings<'a> { } } +/// Block.withPropertiesOf: `block`'s default state with each property of +/// `from` it has too (by name, when the value is one of its own). None for +/// a block the registry does not know (the mod keeps the block then). +fn with_properties_of( + registry: &crate::registry::BlockRegistry, + block: &str, + from: BlockStateId, +) -> Option<BlockStateId> { + let default = registry.default_state(block)?; + let mut state = registry.state(default)?.clone(); + for (key, value) in ®istry.state(from)?.properties { + if let Some(own) = state.properties.get(key) + && own != value + { + let mut changed = state.clone(); + changed.properties.insert(key.clone(), value.clone()); + if registry.id(&changed).is_some() { + state = changed; + } + } + } + registry.id(&state) +} + /// BlackstoneReplaceProcessor's block map. fn blackstone(name: &str) -> Option<&'static str> { Some(match name.strip_prefix("minecraft:")? { @@ -890,6 +931,15 @@ fn process_block<W: PlacementContext>( Some(info) } Processor::Capped { .. } => Some(info), + Processor::BlockSwap(blocks) => { + let swapped = blocks + .get(name(info.state)) + .and_then(|to| with_properties_of(registry, to, info.state)); + Some(match swapped { + Some(state) => BlockInfo { state, ..info }, + None => info, + }) + } Processor::CountCap(cap) => match cap.blocks.contains(name(info.state)) { true => { let pos = info.pos; @@ -1712,4 +1762,36 @@ mod tests { CountCap::decode(&json!({"blocks": [], "min": -1}), |_| Ok(BlockStateId(5))).is_err() ); } + + #[test] + fn block_swaps_keep_the_properties_both_blocks_have() { + let row = |name: &str, props: Value| json!([name, false, false, "", {"id": name, "properties": props}]); + let facts = json!({"defaults": {"a:log": 1, "a:stairs": 4, "a:stone": 6}, + "states": [ + row("a:log", json!({"axis": "x"})), row("a:log", json!({"axis": "y"})), + row("a:stairs", json!({"facing": "east", "half": "top"})), + row("a:stairs", json!({"facing": "east", "half": "bottom"})), + row("a:stairs", json!({"facing": "north", "half": "bottom"})), + row("a:stairs", json!({"facing": "north", "half": "top"})), + ["a:stone", false, false, "", "a:stone"]]}); + let registry = + crate::registry::BlockRegistry::from_facts_json(facts.to_string().as_bytes()).unwrap(); + // facing and half carried over; the default where `from` has none. + assert_eq!( + with_properties_of(®istry, "a:stairs", BlockStateId(2)), + Some(BlockStateId(2)) + ); + assert_eq!( + with_properties_of(®istry, "a:stairs", BlockStateId(0)), + Some(BlockStateId(4)) + ); + assert_eq!( + with_properties_of(®istry, "a:stone", BlockStateId(5)), + Some(BlockStateId(6)) + ); + assert_eq!( + with_properties_of(®istry, "a:missing", BlockStateId(0)), + None + ); + } } diff --git a/docs/modpacks.md b/docs/modpacks.md index b6daee867..faca959b9 100644 --- a/docs/modpacks.md +++ b/docs/modpacks.md @@ -461,8 +461,12 @@ Two cases the oracle fills in: mod. Better Dungeons' small dungeons keep one chest and each other one with a fifth's chance, two at most (the game's `horizon:count_cap`, counted per placement as the mod's DungeonContext is): 12 chests in five small dungeons at seed 1234 become 6. - 136 of the 1,427 processors are carried; 1,291 are still taken out (blocks swapped, aged - or propped up). + Lithostitched's `block_swap` (137 lists, all in ChoiceTheorem's Overhauled Village) is the + game's `horizon:block_swap`: the same map, with Block.withPropertiesOf's properties kept; + a target block the game does not have (most of them are Nature's Spirit's and Croptopia's) + leaves the block as it is, as the mod does. 273 of the 1,427 processors are carried; 1,154 + are still taken out (Formations' biome replacements, Repurposed's pillars and fluid fixes, + Lithostitched's reference, condition and apply_random, blocks aged or propped up). In the 128×128-chunk square (seed 1234), every spawner of a mod structure now has its mob: in the Overworld 83 Better Dungeons spawners held the template's placeholder pig and 17 of Moog's were empty (763 spawners with a mob, up from 628); in the Nether the 52 empty ones From 875773a08fc568fe637b0255799c3fc5f87a35d8 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 23:10:31 +0200 Subject: [PATCH 161/163] Villagers, traders and golems never despawn for distance Village villagers are placed from the jigsaw templates without PersistenceRequired (the village's iron golem has it), so Mob.checkDespawn discarded every villager of a village generated more than 128 blocks from the player, and the rest after a while beyond 32 blocks. Vanilla's Villager, WanderingTrader and AbstractGolem (iron, snow and copper golems, shulkers) override removeWhenFarAway to false. Fixes #917. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/mobs/ai.rs | 51 ++++++++++++++++++++++++---- 1 file changed, 44 insertions(+), 7 deletions(-) diff --git a/crates/horizon-client/src/mobs/ai.rs b/crates/horizon-client/src/mobs/ai.rs index 475bd7611..709a57619 100644 --- a/crates/horizon-client/src/mobs/ai.rs +++ b/crates/horizon-client/src/mobs/ai.rs @@ -1026,14 +1026,11 @@ fn check_despawn(m: &mut Mob, w: &MobWorld) -> bool { || super::nautilus::is_nautilus(m.species()) && m.extra.tame || m.species() == Species::SulfurCube && (super::sulfur_cube::has_body(m) || m.extra.scratch[3] != 0); - // removeWhenFarAway: animals, wardens, allays, patrols and raiders, - // zombie villagers being cured and ridden mobs stay; the wither's - // checkDespawn never removes it for distance. + // removeWhenFarAway: animals, villagers, golems, patrols and raiders, + // zombie villagers being cured and ridden mobs stay. let creature = m.kind.category == "creature"; - let removable = !(matches!( - m.species(), - Species::Warden | Species::Allay | Species::Wither - ) || creature && m.kind.flags.animal && !m.extra.jockey + let removable = !(never_removed_when_far(m.species()) + || creature && m.kind.flags.animal && !m.extra.jockey || super::raider::keeps_alive(m, d) || super::zombie_villager::keeps_alive(m) || super::riders::keeps_alive(m)); @@ -1059,6 +1056,24 @@ fn check_despawn(m: &mut Mob, w: &MobWorld) -> bool { } true } +/// The types whose `removeWhenFarAway` is always false (`Villager`, +/// `WanderingTrader`, `AbstractGolem`: iron, snow and copper golems and +/// shulkers; `Allay`, `Warden`), and the wither, whose `checkDespawn` never +/// removes it for distance. +fn never_removed_when_far(s: Species) -> bool { + matches!( + s, + Species::Villager + | Species::WanderingTrader + | Species::IronGolem + | Species::SnowGolem + | Species::CopperGolem + | Species::Shulker + | Species::Allay + | Species::Warden + | Species::Wither + ) +} /// Movement speed bonus multiplier (baby zombies are 50% faster, etc.). pub fn speed_bonus(m: &Mob) -> f64 { match m.species() { @@ -1579,3 +1594,25 @@ mod bucket_axolotl_tests { assert_eq!(family(Species::Axolotl), Family::Aquatic); } } +#[cfg(test)] +mod despawn_tests { + use super::*; + /// Village villagers are placed without PersistenceRequired (unlike the + /// village's iron golem), so they must never despawn for distance. + #[test] + fn villagers_traders_and_golems_never_despawn_for_distance() { + for s in [ + Species::Villager, + Species::WanderingTrader, + Species::IronGolem, + Species::SnowGolem, + Species::CopperGolem, + Species::Shulker, + ] { + assert!(never_removed_when_far(s), "{s:?}"); + } + for s in [Species::Zombie, Species::ZombieVillager, Species::Pillager] { + assert!(!never_removed_when_far(s), "{s:?}"); + } + } +} From 32a37e8937069331e06f03ee3751335852639095 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 23:22:07 +0200 Subject: [PATCH 162/163] Benchmark: Horizon's server against vanilla 26.3 with mixed bots, equal work Explore bots paced at 0.8 blocks a second and a 300-second warm-up, so both servers serve the same paths; the work table shows it. Horizon ran as horizon-engine (the server build, from its archive). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../server-equal-mixed-2026-10-18/README.md | 137 ++++ .../server-equal-mixed-2026-10-18/load.txt | 702 ++++++++++++++++++ .../mixed-equal.json | 421 +++++++++++ docs/server.md | 17 +- 4 files changed, 1276 insertions(+), 1 deletion(-) create mode 100644 benchmarks/server-equal-mixed-2026-10-18/README.md create mode 100644 benchmarks/server-equal-mixed-2026-10-18/load.txt create mode 100644 benchmarks/server-equal-mixed-2026-10-18/mixed-equal.json diff --git a/benchmarks/server-equal-mixed-2026-10-18/README.md b/benchmarks/server-equal-mixed-2026-10-18/README.md new file mode 100644 index 000000000..5849e72ba --- /dev/null +++ b/benchmarks/server-equal-mixed-2026-10-18/README.md @@ -0,0 +1,137 @@ +# Horizon's server against vanilla 26.3: mixed bots, equal work (2026-10-18) + +This reruns `../server-mixed-2026-10-18/` with the bots' load made the same on both servers. In that run the +`explore` bots flew as fast as each server sent them chunks. Horizon kept up and vanilla didn't, so Horizon +sent 2.9 to 5.9 times as many chunks a second, and vanilla's walking bots got a fifth of the chunks Horizon's +got. The comparison of tick times wasn't fair. + +## Summary + +- **The work was equal** at 1 and 10 bots. At 25 bots it was equal in chunks sent a second (158.6 against 157.6); + vanilla was still catching up on chunks its bots hadn't had yet, see "Equal work" below. Every bot joined, none + was dropped, no chunk was sent twice, and no bot ever waited for the chunk it stood in. +- **Tick time (MSPT), same work:** + - 1 bot: 1.8 ms on Horizon against 11.3 on vanilla; + - 10 bots: 4.7 against 34.3 ms; + - 25 bots: 11.7 against 50.5 ms. Vanilla dropped just under 20 TPS (19.8) and its worst 5-second P99 was + 1388 ms, against Horizon's 130; + - 50 bots: Horizon ran at 23.8 ms (20 TPS). Vanilla's watchdog stopped its server 30 s after the last bot + joined ("A single server tick took 60.01 seconds"). +- **Memory:** Horizon's RSS was 4.1 to 4.9 times smaller: 0.69 against 3.40 GB with one bot, 0.95 against + 3.87 GB with 25, and 1.03 GB with 50. Vanilla's heap is fixed at 4 GB, so its RSS is mostly that heap. +- **CPU** (100 % is one of the machine's 4 threads): 30 against 128 % at 10 bots, 58 against 192 % at 25. +- **What changed since the first run:** the first run's vanilla held 50 bots at 29.7 ms because its walking + bots got 640 to 1100 chunks each. With the explore bots paced, vanilla serves the walking bots in full + (5400 to 6100 chunks each, against Horizon's 6100 to 6600), and that is the load it can't carry at 50. + +## Results + +MSPT is milliseconds per tick from each server's own `/tick query` (50 is the limit for 20 TPS). P95 and P99 +are over the 300 measured seconds. "Worst P99" is the highest P99 of a single 5-second query. RSS and CPU +cover the server's process tree. "First-time chunks/s" counts chunks a bot hadn't received before (summed +over the bots). "Waited" is ticks a second that bots stood still waiting for their own chunk. "Pulled back" +counts position packets that moved a bot back. + +| Bots | Server | MSPT | P95 | P99 | Worst P99 | TPS | RSS (mean / max) | CPU | Start | Chunks/s | First-time chunks/s | Waited | Pulled back | +|---:|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:|---:| +| 1 | Horizon | **1.77** | 4.21 | 13.04 | 47.5 | 20 | **0.69 / 0.69 GB** | 28 % | 19.7 s | 9.94 | 0.01 | 0 | 0 | +| 1 | vanilla | 11.34 | 17.12 | 33.22 | 119.1 | 20 | 3.40 / 3.42 GB | 36 % | 20.4 s | 9.98 | 0.01 | 0 | 0 | +| 10 | Horizon | **4.74** | 10.48 | 19.69 | 120.1 | 20 | **0.86 / 0.88 GB** | 30 % | 19.5 s | 61.35 | 1.79 | 0 | 4159 | +| 10 | vanilla | 34.30 | 53.72 | 89.08 | 375.8 | 20 | 3.71 / 3.75 GB | 128 % | 19.9 s | 61.66 | 1.93 | 0 | 3976 | +| 25 | Horizon | **11.72** | 24.45 | 43.79 | 129.8 | 20 | **0.95 / 1.09 GB** | 58 % | 9.6 s | 158.57 | 5.78 | 0 | 3496 | +| 25 | vanilla | 50.45 | 74.09 | 191.21 | 1388.1 | 19.82 | 3.87 / 4.75 GB | 192 % | 37.8 s | 157.63 | 8.25 | 0 | 3629 | +| 50 | Horizon | **23.82** | 50.98 | 74.64 | 195.9 | 20 | **1.03 / 1.20 GB** | 98 % | 14.9 s | 302.81 | 10.96 | 0 | 7565 | +| 50 | vanilla | stopped by its watchdog | | | | | | | 11.2 s | | | | | + +Chunks each bot received over the whole run, by behaviour (mean): + +| Bots | Server | walk | explore | idle | +|---:|---|---:|---:|---:| +| 1 | Horizon | 6092 | | | +| 1 | vanilla | 6084 | | | +| 10 | Horizon | 6248 | 1165 | 473 | +| 10 | vanilla | 5729 | 1124 | 473 | +| 25 | Horizon | 6629 | 1267 | 473 | +| 25 | vanilla | 5387 | 1119 | 473 | +| 50 | Horizon | 6497 | 1256 | 473 | + +Both servers pulled bots back about as often (`moved too quickly` 20 and 296 times on vanilla at 10 and 25 +bots). + +## Equal work + +`tools/server_bench.py` now prints a work table after the runs. At each bot count it compares every server's +chunks sent a second and first-time chunks a second with the busiest server's. Work counts as equal when +both are within 10 % (or within a chunk a second when there are few). The report keeps the table as `work`. + +| Bots | Chunks/s (Horizon, vanilla) | First-time chunks/s (Horizon, vanilla) | Equal | +|---:|---|---|---| +| 1 | 9.94, 9.98 | 0.01, 0.01 | yes | +| 10 | 61.35, 61.66 | 1.79, 1.93 | yes | +| 25 | 158.57, 157.63 | 5.78, 8.25 | no: vanilla sent 2.5 more first-time chunks a second | + +Two settings made the load the same: + +- **Explore bots paced at 0.8 blocks a second** (`--explore-speed 0.8`), the rate the 2026-10-17 run showed + both servers keep up with. Every bot then follows the same path on both servers. The path is deterministic + per bot, and a bot only stops while the chunk it stands in hasn't arrived, which never happened here + (`Waited` 0). So both servers had the same chunks to send. +- **A 300-second warm-up** before the 300 measured seconds. A first pass with the old 60-second warm-up + (aborted after 10 bots) sent the same chunks a second on both (63.1 against 61.4). But vanilla was still + delivering the bots' first views during the measurement (12.9 first-time chunks a second against Horizon's + 4.1), so its window held more work than Horizon's. With 300 seconds both were in steady state at 1 and 10 + bots. At 25, vanilla still sent 2.5 more first-time chunks a second than Horizon: 1.6 % of all it sent, and + its walking bots ended the run with 19 % fewer chunks. Read the 25-bot tick times with that in mind: the + extra first-time chunks are work vanilla had still to do because it fell behind. + +## Method + +`tools/server_bench.py` ran each configuration on a fresh server: + +- the same `server.properties` on both: seed 12345, view and simulation distance 10, offline, creative, + difficulty easy, `sync-chunk-writes=true`, white-list off; +- `gamerule respawn_radius 0`, and otherwise vanilla's default game rules (the locator bar on for both); +- the server waits for `Done`, the bots join one a second, warm up for 300 seconds and are measured for 300, + with `/tick query` every 5 seconds and RSS and CPU every second. + +The bots are `horizon-bots --behaviour mixed`: 60 % walk, 20 % explore and 20 % idle, each choice deterministic +per bot. All are creative and fly 24 blocks above spawn. `walk` flies to random points within 48 blocks at +5.6 blocks a second, `explore` flies straight out at 0.8 blocks a second, and `idle` hovers. + +**Machine.** The ThinkPad: Intel Core i7-7500U (2 cores, 4 threads), 32 GB, NixOS. The desktop (24 threads) +was meant to run it, but it didn't wake (`~/fleet/power wake desktop` timed out, as it did for the first run). +No other session ran on the ThinkPad during the runs (`load.txt`, a sample a minute). The servers ran under +`nice -n 19`. The bots ran on the Mac mini (M4 Pro, shared with other work at 70 to 90 % CPU) and reached the +ThinkPad over the tailnet. + +**What ran.** + +- Horizon: the server build from #916 (`horizon-client --no-default-features`, no sound or controllers) at + 519ec121, packaged with `xtask package-server` and installed with `install.sh --archive`, as Linux owners + will get it. `horizon-server` ran it as `horizon-engine`. The game files were prepared from the owner's own + Minecraft. `horizon-bots` and `server_bench.py` came from this PR. +- Vanilla: the pinned 26.3 server jar (the owner's own copy) on OpenJDK 25.0.4.1, `-Xms4g -Xmx4g`. + +`server_bench.py` stopped after vanilla's 50-bot server crashed and before it wrote its report. +`mixed-equal.json` holds the run lines it printed. The vanilla 50 entry and its error come from that server's +log, and the `work` table was computed with `server_bench.work`. `load.txt` is the fleet monitor's view of the +machines during the runs. + +## Reproduce + + curl -fsSL https://raw.githubusercontent.com/ludovic111/horizon/main/packaging/server/install.sh | sh + horizon-prepare --prepare --server-jar /path/to/server.jar # your own copy + cargo build --release -p horizon-bots # on the machine that runs the bots + # in a checkout whose .local/minecraft holds the pinned vanilla jars (tools/lab.py prepare): + HORIZON_BENCH_BIN=~/.local/share/horizon/current \ + python3 tools/server_bench.py --servers horizon,vanilla --bots 1,10,25,50 --behaviour mixed \ + --explore-speed 0.8 --warmup 300 --nice 19 \ + --bots-via 'ssh <bots machine>' --bots-bin /path/to/horizon-bots --connect <this machine's address> \ + --out mixed-equal.json + +## Next + +- One pass per configuration ran. Vanilla at 50 bots, in particular, needs a second pass, ideally on the + desktop (24 threads), where neither server is CPU-bound. +- 100 bots, and Paper and Fabric + Lithium (docs/server.md section 9). +- A longer warm-up, or measuring from when the first-time chunk rate settles, so the 25-bot work is equal too. diff --git a/benchmarks/server-equal-mixed-2026-10-18/load.txt b/benchmarks/server-equal-mixed-2026-10-18/load.txt new file mode 100644 index 000000000..2992b4a26 --- /dev/null +++ b/benchmarks/server-equal-mixed-2026-10-18/load.txt @@ -0,0 +1,702 @@ +2026-10-18T19:32:39Z +ludothinkpad ok: 27.2 GB free, 4 threads 17% busy, 0 sessions +desktop offline +macmini ok: 25.9 GB free, 14 threads 73% busy, 1 sessions +macbook offline + RAM 27.0 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 42% busy (agents 0.0, rest 1.6 cores) · 80°C · load 5.9 + · disk 289.5 GB free · battery 96% · Ludovic: away + +2026-10-18T19:33:44Z +ludothinkpad ok: 26.7 GB free, 4 threads 19% busy, 0 sessions +desktop offline +macmini busy: 26.7 GB free, 14 threads 93% busy, 1 sessions +macbook offline + RAM 26.7 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 34% busy (agents 0.0, rest 1.7 cores) · 81°C · load 4.0 + · disk 289.5 GB free · battery 96% · Ludovic: away + +2026-10-18T19:34:48Z +ludothinkpad ok: 26.4 GB free, 4 threads 56% busy, 0 sessions +desktop offline +macmini busy: 26.9 GB free, 14 threads 90% busy, 1 sessions +macbook offline + RAM 26.4 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 54% busy (agents 0.0, rest 2.2 cores) · 79°C · load 2.8 + · disk 289.5 GB free · battery 96% · Ludovic: away + +2026-10-18T19:35:52Z +ludothinkpad ok: 26.7 GB free, 4 threads 27% busy, 0 sessions +desktop offline +macmini ok: 25.4 GB free, 14 threads 85% busy, 1 sessions +macbook offline + RAM 26.6 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 30% busy (agents 0.0, rest 1.1 cores) · 82°C · load 2.2 + · disk 289.5 GB free · battery 96% · Ludovic: away + +2026-10-18T19:36:57Z +ludothinkpad ok: 26.7 GB free, 4 threads 25% busy, 0 sessions +desktop offline +macmini busy: 25.4 GB free, 14 threads 93% busy, 1 sessions +macbook offline + RAM 26.7 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 37% busy (agents 0.0, rest 1.2 cores) · 80°C · load 1.5 + · disk 289.5 GB free · battery 96% · Ludovic: away + +2026-10-18T19:38:01Z +ludothinkpad ok: 26.6 GB free, 4 threads 54% busy, 0 sessions +desktop offline +macmini ok: 26.7 GB free, 14 threads 64% busy, 1 sessions +macbook offline + RAM 26.6 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 21% busy (agents 0.0, rest 1.2 cores) · 81°C · load 1.9 + · disk 289.5 GB free · battery 96% · Ludovic: away + +2026-10-18T19:39:05Z +ludothinkpad ok: 26.7 GB free, 4 threads 20% busy, 0 sessions +desktop offline +macmini ok: 26.1 GB free, 14 threads 70% busy, 1 sessions +macbook offline + RAM 26.7 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 28% busy (agents 0.0, rest 1.0 cores) · 81°C · load 1.3 + · disk 289.5 GB free · battery 96% · Ludovic: away + +2026-10-18T19:40:10Z +ludothinkpad ok: 26.7 GB free, 4 threads 39% busy, 0 sessions +desktop offline +macmini ok: 29.2 GB free, 14 threads 73% busy, 1 sessions +macbook offline + RAM 26.6 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 32% busy (agents 0.0, rest 1.7 cores) · 80°C · load 0.9 + · disk 289.5 GB free · battery 96% · Ludovic: away + +2026-10-18T19:41:14Z +ludothinkpad ok: 26.7 GB free, 4 threads 31% busy, 0 sessions +desktop offline +macmini ok: 28.8 GB free, 14 threads 77% busy, 1 sessions +macbook offline + RAM 26.7 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 15% busy (agents 0.0, rest 1.1 cores) · 82°C · load 1.3 + · disk 289.5 GB free · battery 96% · Ludovic: away + +2026-10-18T19:42:19Z +ludothinkpad ok: 26.5 GB free, 4 threads 26% busy, 0 sessions +desktop offline +macmini busy: 26.1 GB free, 14 threads 94% busy, 1 sessions +macbook offline + RAM 26.2 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 30% busy (agents 0.0, rest 1.3 cores) · 78°C · load 1.1 + · disk 289.6 GB free · battery 96% · Ludovic: away + +2026-10-18T19:43:23Z +ludothinkpad busy: 26.7 GB free, 4 threads 99% busy, 0 sessions +desktop offline +macmini ok: 28.2 GB free, 14 threads 83% busy, 1 sessions +macbook offline + RAM 26.3 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 99% busy (agents 0.0, rest 3.8 cores) · 86°C · load 2.4 + · disk 289.6 GB free · battery 96% · Ludovic: away + +2026-10-18T19:44:27Z +ludothinkpad busy: 25.2 GB free, 4 threads 98% busy, 0 sessions +desktop offline +macmini ok: 29.0 GB free, 14 threads 73% busy, 1 sessions +macbook offline + RAM 24.9 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 83% busy (agents 0.0, rest 3.7 cores) · 83°C · load 5.5 + · disk 289.5 GB free · battery 96% · Ludovic: away + +2026-10-18T19:45:31Z +ludothinkpad ok: 24.5 GB free, 4 threads 39% busy, 0 sessions +desktop offline +macmini busy: 27.0 GB free, 14 threads 93% busy, 1 sessions +macbook offline + RAM 24.6 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 34% busy (agents 0.0, rest 1.5 cores) · 84°C · load 3.5 + · disk 289.5 GB free · battery 96% · Ludovic: away + +2026-10-18T19:46:35Z +ludothinkpad ok: 23.7 GB free, 4 threads 69% busy, 0 sessions +desktop offline +macmini busy: 26.2 GB free, 14 threads 90% busy, 1 sessions +macbook offline + RAM 23.8 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 75% busy (agents 0.0, rest 2.8 cores) · 87°C · load 2.7 + · disk 289.5 GB free · battery 96% · Ludovic: away + +2026-10-18T19:47:40Z +ludothinkpad ok: 23.8 GB free, 4 threads 66% busy, 0 sessions +desktop offline +macmini busy: 25.9 GB free, 14 threads 85% busy, 1 sessions +macbook offline + RAM 23.8 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 59% busy (agents 0.0, rest 2.5 cores) · 83°C · load 2.9 + · disk 291.7 GB free · battery 96% · Ludovic: away + +2026-10-18T19:48:44Z +ludothinkpad ok: 24.2 GB free, 4 threads 61% busy, 0 sessions +desktop offline +macmini busy: 29.0 GB free, 14 threads 90% busy, 1 sessions +macbook offline + RAM 24.3 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 62% busy (agents 0.0, rest 2.5 cores) · 84°C · load 3.2 + · disk 291.6 GB free · battery 96% · Ludovic: away + +2026-10-18T19:49:48Z +ludothinkpad ok: 25.1 GB free, 4 threads 59% busy, 0 sessions +desktop offline +macmini ok: 31.1 GB free, 14 threads 81% busy, 1 sessions +macbook offline + RAM 25.1 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 57% busy (agents 0.0, rest 2.4 cores) · 85°C · load 2.9 + · disk 291.6 GB free · battery 96% · Ludovic: away + +2026-10-18T19:50:52Z +ludothinkpad ok: 25.7 GB free, 4 threads 39% busy, 0 sessions +desktop offline +macmini busy: 28.4 GB free, 14 threads 88% busy, 2 sessions +macbook offline + RAM 25.8 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 18% busy (agents 0.0, rest 1.4 cores) · 67°C · load 2.4 + · disk 291.6 GB free · battery 96% · Ludovic: away + +2026-10-18T19:51:57Z +ludothinkpad ok: 23.7 GB free, 4 threads 40% busy, 0 sessions +desktop offline +macmini ok: 27.9 GB free, 14 threads 83% busy, 1 sessions +macbook offline + RAM 23.7 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 23% busy (agents 0.0, rest 1.4 cores) · 81°C · load 1.8 + · disk 291.6 GB free · battery 96% · Ludovic: away + +2026-10-18T19:53:01Z +ludothinkpad ok: 25.3 GB free, 4 threads 25% busy, 0 sessions +desktop offline +macmini ok: 27.1 GB free, 14 threads 84% busy, 1 sessions +macbook offline + RAM 25.1 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 31% busy (agents 0.0, rest 1.2 cores) · 80°C · load 1.8 + · disk 291.6 GB free · battery 96% · Ludovic: away + +2026-10-18T19:54:05Z +ludothinkpad ok: 26.5 GB free, 4 threads 75% busy, 0 sessions +desktop offline +macmini busy: 27.1 GB free, 14 threads 91% busy, 1 sessions +macbook offline + RAM 26.5 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 69% busy (agents 0.0, rest 2.5 cores) · 78°C · load 2.3 + · disk 291.6 GB free · battery 96% · Ludovic: away + +2026-10-18T19:55:09Z +ludothinkpad busy: 26.4 GB free, 4 threads 89% busy, 0 sessions +desktop offline +macmini busy: 26.3 GB free, 14 threads 86% busy, 1 sessions +macbook offline + RAM 26.3 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 32% busy (agents 0.0, rest 2.4 cores) · 79°C · load 2.9 + · disk 291.6 GB free · battery 96% · Ludovic: away + +2026-10-18T19:56:14Z +ludothinkpad ok: 26.4 GB free, 4 threads 39% busy, 0 sessions +desktop offline +macmini ok: 27.1 GB free, 14 threads 68% busy, 1 sessions +macbook offline + RAM 26.4 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 63% busy (agents 0.0, rest 1.8 cores) · 82°C · load 2.3 + · disk 291.6 GB free · battery 96% · Ludovic: away + +2026-10-18T19:57:18Z +ludothinkpad ok: 26.3 GB free, 4 threads 20% busy, 0 sessions +desktop offline +macmini busy: 29.2 GB free, 14 threads 85% busy, 1 sessions +macbook offline + RAM 26.3 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 19% busy (agents 0.0, rest 1.0 cores) · 80°C · load 1.8 + · disk 291.6 GB free · battery 96% · Ludovic: away + +2026-10-18T19:58:22Z +ludothinkpad ok: 26.3 GB free, 4 threads 28% busy, 0 sessions +desktop offline +macmini busy: 27.3 GB free, 14 threads 88% busy, 1 sessions +macbook offline + RAM 26.1 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 93% busy (agents 0.0, rest 2.5 cores) · 80°C · load 2.0 + · disk 291.6 GB free · battery 96% · Ludovic: away + +2026-10-18T19:59:27Z +ludothinkpad ok: 26.2 GB free, 4 threads 52% busy, 0 sessions +desktop offline +macmini ok: 35.0 GB free, 14 threads 85% busy, 1 sessions +macbook offline + RAM 26.2 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 22% busy (agents 0.0, rest 1.8 cores) · 80°C · load 3.6 + · disk 291.4 GB free · battery 96% · Ludovic: away + +2026-10-18T20:00:31Z +ludothinkpad busy: 25.8 GB free, 4 threads 87% busy, 0 sessions +desktop offline +macmini busy: 33.0 GB free, 14 threads 87% busy, 1 sessions +macbook offline + RAM 27.5 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 51% busy (agents 0.0, rest 2.9 cores) · 79°C · load 3.6 + · disk 291.5 GB free · battery 96% · Ludovic: away + +2026-10-18T20:01:35Z +ludothinkpad ok: 25.6 GB free, 4 threads 35% busy, 0 sessions +desktop offline +macmini ok: 32.4 GB free, 14 threads 81% busy, 1 sessions +macbook ok: 7.2 GB free, 12 threads 32% busy, 0 sessions + RAM 25.6 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 34% busy (agents 0.0, rest 1.3 cores) · 81°C · load 2.5 + · disk 291.6 GB free · battery 96% · Ludovic: away + +2026-10-18T20:02:40Z +ludothinkpad ok: 26.6 GB free, 4 threads 35% busy, 0 sessions +desktop offline +macmini ok: 29.2 GB free, 14 threads 79% busy, 1 sessions +macbook ok: 6.5 GB free, 12 threads 39% busy, 0 sessions + RAM 26.5 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 33% busy (agents 0.0, rest 1.3 cores) · 81°C · load 2.7 + · disk 291.6 GB free · battery 96% · Ludovic: away + +2026-10-18T20:03:44Z +ludothinkpad ok: 25.5 GB free, 4 threads 56% busy, 0 sessions +desktop offline +macmini busy: 31.1 GB free, 14 threads 89% busy, 1 sessions +macbook ok: 6.8 GB free, 12 threads 6% busy, 0 sessions + RAM 25.2 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 66% busy (agents 0.0, rest 2.5 cores) · 87°C · load 2.5 + · disk 291.3 GB free · battery 96% · Ludovic: away + +2026-10-18T20:04:48Z +ludothinkpad busy: 26.2 GB free, 4 threads 99% busy, 0 sessions +desktop offline +macmini busy: 30.0 GB free, 14 threads 89% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 31% busy, 0 sessions + RAM 25.8 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 84% busy (agents 0.0, rest 3.7 cores) · 85°C · load 3.4 + · disk 291.3 GB free · battery 96% · Ludovic: away + +2026-10-18T20:05:52Z +ludothinkpad busy: 24.5 GB free, 4 threads 100% busy, 0 sessions +desktop offline +macmini busy: 34.1 GB free, 14 threads 89% busy, 1 sessions +macbook ok: 6.6 GB free, 12 threads 10% busy, 0 sessions + RAM 24.6 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 100% busy (agents 0.0, rest 4.0 cores) · 83°C · load 9.0 + · disk 291.0 GB free · battery 96% · Ludovic: away + +2026-10-18T20:06:57Z +ludothinkpad busy: 23.5 GB free, 4 threads 100% busy, 0 sessions +desktop offline +macmini busy: 28.3 GB free, 14 threads 88% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 5% busy, 0 sessions + RAM 23.6 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 99% busy (agents 0.0, rest 4.0 cores) · 82°C · load 10.1 + · disk 309.2 GB free · battery 96% · Ludovic: away + +2026-10-18T20:08:01Z +ludothinkpad busy: 23.4 GB free, 4 threads 88% busy, 0 sessions +desktop offline +macmini ok: 29.6 GB free, 14 threads 83% busy, 1 sessions +macbook ok: 6.6 GB free, 12 threads 2% busy, 0 sessions + RAM 23.4 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 77% busy (agents 0.0, rest 3.4 cores) · 84°C · load 7.5 + · disk 309.2 GB free · battery 96% · Ludovic: away + +2026-10-18T20:09:05Z +ludothinkpad busy: 24.0 GB free, 4 threads 89% busy, 0 sessions +desktop offline +macmini ok: 25.9 GB free, 14 threads 83% busy, 1 sessions +macbook ok: 7.1 GB free, 12 threads 19% busy, 0 sessions + RAM 23.9 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 91% busy (agents 0.0, rest 3.6 cores) · 82°C · load 5.9 + · disk 309.1 GB free · battery 96% · Ludovic: away + +2026-10-18T20:10:09Z +ludothinkpad busy: 24.0 GB free, 4 threads 98% busy, 0 sessions +desktop offline +macmini busy: 27.1 GB free, 14 threads 88% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 19% busy, 0 sessions + RAM 24.0 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 92% busy (agents 0.0, rest 3.7 cores) · 84°C · load 6.6 + · disk 309.1 GB free · battery 96% · Ludovic: away + +2026-10-18T20:11:14Z +ludothinkpad busy: 24.3 GB free, 4 threads 92% busy, 0 sessions +desktop offline +macmini ok: 26.3 GB free, 14 threads 84% busy, 1 sessions +macbook ok: 6.6 GB free, 12 threads 18% busy, 0 sessions + RAM 24.4 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 99% busy (agents 0.0, rest 3.7 cores) · 85°C · load 6.5 + · disk 309.0 GB free · battery 96% · Ludovic: away + +2026-10-18T20:12:18Z +ludothinkpad busy: 24.7 GB free, 4 threads 89% busy, 0 sessions +desktop offline +macmini ok: 28.6 GB free, 14 threads 78% busy, 1 sessions +macbook ok: 7.3 GB free, 12 threads 20% busy, 0 sessions + RAM 24.7 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 82% busy (agents 0.0, rest 3.4 cores) · 84°C · load 6.1 + · disk 309.0 GB free · battery 96% · Ludovic: away + +2026-10-18T20:13:22Z +ludothinkpad ok: 23.4 GB free, 4 threads 53% busy, 0 sessions +desktop offline +macmini ok: 28.1 GB free, 14 threads 77% busy, 1 sessions +macbook ok: 7.3 GB free, 12 threads 20% busy, 0 sessions + RAM 23.4 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 48% busy (agents 0.0, rest 2.4 cores) · 80°C · load 4.2 + · disk 309.0 GB free · battery 96% · Ludovic: away + +2026-10-18T20:14:27Z +ludothinkpad ok: 24.0 GB free, 4 threads 44% busy, 0 sessions +desktop offline +macmini ok: 28.0 GB free, 14 threads 71% busy, 1 sessions +macbook ok: 6.9 GB free, 12 threads 2% busy, 0 sessions + RAM 24.1 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 23% busy (agents 0.0, rest 2.0 cores) · 77°C · load 4.3 + · disk 309.0 GB free · battery 96% · Ludovic: away + +2026-10-18T20:15:31Z +ludothinkpad ok: 22.7 GB free, 4 threads 31% busy, 0 sessions +desktop offline +macmini busy: 27.2 GB free, 14 threads 86% busy, 1 sessions +macbook ok: 6.9 GB free, 12 threads 19% busy, 0 sessions + RAM 22.5 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 30% busy (agents 0.0, rest 1.3 cores) · 77°C · load 2.6 + · disk 309.1 GB free · battery 96% · Ludovic: away + +2026-10-18T20:16:35Z +ludothinkpad ok: 26.8 GB free, 4 threads 37% busy, 0 sessions +desktop offline +macmini ok: 28.6 GB free, 14 threads 82% busy, 1 sessions +macbook ok: 6.8 GB free, 12 threads 9% busy, 0 sessions + RAM 26.8 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 42% busy (agents 0.0, rest 1.7 cores) · 81°C · load 2.3 + · disk 309.1 GB free · battery 96% · Ludovic: away + +2026-10-18T20:17:39Z +ludothinkpad ok: 26.3 GB free, 4 threads 63% busy, 0 sessions +desktop offline +macmini ok: 26.8 GB free, 14 threads 78% busy, 1 sessions +macbook ok: 7.0 GB free, 12 threads 19% busy, 0 sessions + RAM 26.4 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 64% busy (agents 0.0, rest 2.6 cores) · 87°C · load 1.9 + · disk 309.0 GB free · battery 96% · Ludovic: away + +2026-10-18T20:18:43Z +ludothinkpad ok: 26.9 GB free, 4 threads 37% busy, 0 sessions +desktop offline +macmini busy: 32.2 GB free, 14 threads 87% busy, 1 sessions +macbook ok: 7.0 GB free, 12 threads 10% busy, 0 sessions + RAM 26.9 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 56% busy (agents 0.0, rest 1.9 cores) · 84°C · load 3.9 + · disk 309.0 GB free · battery 96% · Ludovic: away + +2026-10-18T20:19:48Z +ludothinkpad ok: 26.0 GB free, 4 threads 77% busy, 0 sessions +desktop offline +macmini ok: 29.2 GB free, 14 threads 83% busy, 1 sessions +macbook ok: 7.0 GB free, 12 threads 10% busy, 0 sessions + RAM 26.0 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 66% busy (agents 0.0, rest 2.9 cores) · 86°C · load 3.2 + · disk 309.0 GB free · battery 96% · Ludovic: away + +2026-10-18T20:20:52Z +ludothinkpad ok: 25.9 GB free, 4 threads 80% busy, 0 sessions +desktop offline +macmini ok: 26.8 GB free, 14 threads 84% busy, 1 sessions +macbook ok: 7.0 GB free, 12 threads 17% busy, 0 sessions + RAM 25.9 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 68% busy (agents 0.0, rest 3.2 cores) · 86°C · load 4.4 + · disk 309.0 GB free · battery 96% · Ludovic: away + +2026-10-18T20:21:56Z +ludothinkpad ok: 26.3 GB free, 4 threads 63% busy, 0 sessions +desktop offline +macmini ok: 26.3 GB free, 14 threads 77% busy, 1 sessions +macbook ok: 6.8 GB free, 12 threads 14% busy, 0 sessions + RAM 26.3 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 66% busy (agents 0.0, rest 2.8 cores) · 84°C · load 3.1 + · disk 309.0 GB free · battery 96% · Ludovic: away + +2026-10-18T20:23:00Z +ludothinkpad ok: 26.8 GB free, 4 threads 74% busy, 0 sessions +desktop offline +macmini ok: 26.1 GB free, 14 threads 82% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 11% busy, 0 sessions + RAM 26.7 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 65% busy (agents 0.0, rest 2.8 cores) · 84°C · load 5.0 + · disk 308.9 GB free · battery 96% · Ludovic: away + +2026-10-18T20:24:05Z +ludothinkpad ok: 26.9 GB free, 4 threads 64% busy, 0 sessions +desktop offline +macmini busy: 28.3 GB free, 14 threads 90% busy, 1 sessions +macbook ok: 6.8 GB free, 12 threads 8% busy, 0 sessions + RAM 26.9 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 64% busy (agents 0.0, rest 2.7 cores) · 86°C · load 4.9 + · disk 308.9 GB free · battery 96% · Ludovic: away + +2026-10-18T20:25:09Z +ludothinkpad ok: 26.0 GB free, 4 threads 56% busy, 0 sessions +desktop offline +macmini busy: 26.2 GB free, 14 threads 88% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 12% busy, 0 sessions + RAM 26.0 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 49% busy (agents 0.0, rest 2.1 cores) · 72°C · load 5.5 + · disk 309.0 GB free · battery 96% · Ludovic: away + +2026-10-18T20:26:13Z +ludothinkpad ok: 25.8 GB free, 4 threads 47% busy, 0 sessions +desktop offline +macmini ok: 27.8 GB free, 14 threads 78% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 8% busy, 0 sessions + RAM 25.8 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 56% busy (agents 0.0, rest 2.1 cores) · 78°C · load 3.1 + · disk 308.9 GB free · battery 96% · Ludovic: away + +2026-10-18T20:27:18Z +ludothinkpad busy: 25.5 GB free, 4 threads 94% busy, 0 sessions +desktop offline +macmini ok: 26.6 GB free, 14 threads 82% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 17% busy, 0 sessions + RAM 25.4 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 100% busy (agents 0.0, rest 3.9 cores) · 78°C · load 4.7 + · disk 308.9 GB free · battery 96% · Ludovic: away + +2026-10-18T20:28:22Z +ludothinkpad busy: 24.6 GB free, 4 threads 100% busy, 0 sessions +desktop offline +macmini ok: 26.4 GB free, 14 threads 80% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 8% busy, 0 sessions + RAM 24.2 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 99% busy (agents 0.0, rest 4.0 cores) · 77°C · load 10.5 + · disk 308.9 GB free · battery 96% · Ludovic: away + +2026-10-18T20:29:27Z +ludothinkpad busy: 24.3 GB free, 4 threads 100% busy, 0 sessions +desktop offline +macmini ok: 29.8 GB free, 14 threads 80% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 8% busy, 0 sessions + RAM 24.0 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 99% busy (agents 0.0, rest 4.0 cores) · 82°C · load 10.0 + · disk 308.9 GB free · battery 96% · Ludovic: away + +2026-10-18T20:30:31Z +ludothinkpad busy: 23.7 GB free, 4 threads 91% busy, 0 sessions +desktop offline +macmini ok: 30.1 GB free, 14 threads 71% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 9% busy, 0 sessions + RAM 23.7 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 94% busy (agents 0.0, rest 3.8 cores) · 80°C · load 10.3 + · disk 308.9 GB free · battery 96% · Ludovic: away + +2026-10-18T20:31:36Z +ludothinkpad busy: 23.6 GB free, 4 threads 93% busy, 0 sessions +desktop offline +macmini ok: 28.0 GB free, 14 threads 81% busy, 1 sessions +macbook ok: 6.6 GB free, 12 threads 14% busy, 0 sessions + RAM 23.6 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 95% busy (agents 0.0, rest 3.7 cores) · 80°C · load 10.7 + · disk 308.9 GB free · battery 96% · Ludovic: away + +2026-10-18T20:32:40Z +ludothinkpad busy: 23.6 GB free, 4 threads 94% busy, 0 sessions +desktop offline +macmini ok: 26.9 GB free, 14 threads 76% busy, 1 sessions +macbook ok: 6.8 GB free, 12 threads 22% busy, 0 sessions + RAM 23.6 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 84% busy (agents 0.0, rest 3.5 cores) · 80°C · load 9.7 + · disk 308.9 GB free · battery 96% · Ludovic: away + +2026-10-18T20:33:45Z +ludothinkpad ok: 25.2 GB free, 4 threads 51% busy, 0 sessions +desktop offline +macmini ok: 27.1 GB free, 14 threads 82% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 17% busy, 0 sessions + RAM 25.2 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 48% busy (agents 0.0, rest 2.1 cores) · 87°C · load 6.5 + · disk 309.0 GB free · battery 96% · Ludovic: away + +2026-10-18T20:34:49Z +ludothinkpad ok: 25.1 GB free, 4 threads 56% busy, 0 sessions +desktop offline +macmini busy: 28.2 GB free, 14 threads 87% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 17% busy, 0 sessions + RAM 24.5 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 78% busy (agents 0.0, rest 2.7 cores) · 88°C · load 4.0 + · disk 309.0 GB free · battery 96% · Ludovic: away + +2026-10-18T20:35:53Z +ludothinkpad busy: 23.6 GB free, 4 threads 86% busy, 0 sessions +desktop offline +macmini busy: 27.9 GB free, 14 threads 86% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 17% busy, 0 sessions + RAM 23.7 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 88% busy (agents 0.0, rest 3.3 cores) · 85°C · load 4.9 + · disk 309.0 GB free · battery 96% · Ludovic: away + +2026-10-18T20:36:58Z +ludothinkpad ok: 23.6 GB free, 4 threads 75% busy, 0 sessions +desktop offline +macmini ok: 29.4 GB free, 14 threads 84% busy, 1 sessions +macbook ok: 6.5 GB free, 12 threads 18% busy, 0 sessions + RAM 23.6 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 85% busy (agents 0.0, rest 3.2 cores) · 85°C · load 5.1 + · disk 309.0 GB free · battery 96% · Ludovic: away + +2026-10-18T20:38:02Z +ludothinkpad ok: 22.6 GB free, 4 threads 55% busy, 0 sessions +desktop offline +macmini ok: 26.5 GB free, 14 threads 80% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 10% busy, 0 sessions + RAM 22.3 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 54% busy (agents 0.0, rest 2.2 cores) · 85°C · load 4.5 + · disk 308.9 GB free · battery 96% · Ludovic: away + +2026-10-18T20:39:06Z +ludothinkpad ok: 27.2 GB free, 4 threads 55% busy, 0 sessions +desktop offline +macmini busy: 29.5 GB free, 14 threads 85% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 9% busy, 0 sessions + RAM 27.3 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 48% busy (agents 0.0, rest 2.2 cores) · 87°C · load 4.0 + · disk 308.9 GB free · battery 96% · Ludovic: away + +2026-10-18T20:40:10Z +ludothinkpad ok: 26.2 GB free, 4 threads 72% busy, 0 sessions +desktop offline +macmini ok: 27.7 GB free, 14 threads 84% busy, 1 sessions +macbook ok: 6.6 GB free, 12 threads 19% busy, 0 sessions + RAM 26.3 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 80% busy (agents 0.0, rest 3.1 cores) · 86°C · load 10.8 + · disk 308.9 GB free · battery 96% · Ludovic: away + +2026-10-18T20:41:15Z +ludothinkpad busy: 26.4 GB free, 4 threads 86% busy, 0 sessions +desktop offline +macmini ok: 28.5 GB free, 14 threads 79% busy, 1 sessions +macbook ok: 6.6 GB free, 12 threads 10% busy, 0 sessions + RAM 26.4 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 90% busy (agents 0.0, rest 3.4 cores) · 86°C · load 12.8 + · disk 308.9 GB free · battery 96% · Ludovic: away + +2026-10-18T20:42:19Z +ludothinkpad ok: 26.2 GB free, 4 threads 82% busy, 0 sessions +desktop offline +macmini ok: 26.9 GB free, 14 threads 78% busy, 1 sessions +macbook ok: 6.6 GB free, 12 threads 11% busy, 0 sessions + RAM 26.2 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 74% busy (agents 0.0, rest 3.3 cores) · 85°C · load 8.8 + · disk 308.9 GB free · battery 96% · Ludovic: away + +2026-10-18T20:43:23Z +ludothinkpad busy: 26.7 GB free, 4 threads 93% busy, 0 sessions +desktop offline +macmini ok: 27.3 GB free, 14 threads 81% busy, 1 sessions +macbook ok: 6.6 GB free, 12 threads 10% busy, 0 sessions + RAM 26.7 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 88% busy (agents 0.0, rest 3.4 cores) · 85°C · load 5.4 + · disk 308.9 GB free · battery 96% · Ludovic: away + +2026-10-18T20:44:27Z +ludothinkpad ok: 27.0 GB free, 4 threads 82% busy, 0 sessions +desktop offline +macmini busy: 26.9 GB free, 14 threads 87% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 13% busy, 0 sessions + RAM 27.0 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 75% busy (agents 0.0, rest 3.3 cores) · 82°C · load 9.8 + · disk 308.8 GB free · battery 96% · Ludovic: away + +2026-10-18T20:45:32Z +ludothinkpad ok: 27.2 GB free, 4 threads 76% busy, 0 sessions +desktop offline +macmini ok: 26.8 GB free, 14 threads 80% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 10% busy, 0 sessions + RAM 27.2 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 84% busy (agents 0.0, rest 3.2 cores) · 85°C · load 6.9 + · disk 308.8 GB free · battery 96% · Ludovic: away + +2026-10-18T20:46:36Z +ludothinkpad busy: 27.1 GB free, 4 threads 87% busy, 0 sessions +desktop offline +macmini busy: 26.8 GB free, 14 threads 92% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 9% busy, 0 sessions + RAM 26.8 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 85% busy (agents 0.0, rest 3.2 cores) · 82°C · load 4.4 + · disk 308.8 GB free · battery 96% · Ludovic: away + +2026-10-18T20:47:40Z +ludothinkpad busy: 25.3 GB free, 4 threads 86% busy, 0 sessions +desktop offline +macmini ok: 26.5 GB free, 14 threads 72% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 9% busy, 0 sessions + RAM 25.5 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 85% busy (agents 0.0, rest 3.4 cores) · 86°C · load 3.7 + · disk 308.8 GB free · battery 96% · Ludovic: away + +2026-10-18T20:48:45Z +ludothinkpad busy: 26.1 GB free, 4 threads 100% busy, 0 sessions +desktop offline +macmini ok: 28.5 GB free, 14 threads 84% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 15% busy, 0 sessions + RAM 26.1 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 98% busy (agents 0.0, rest 3.9 cores) · 80°C · load 6.5 + · disk 308.8 GB free · battery 96% · Ludovic: away + +2026-10-18T20:49:50Z +ludothinkpad ok: 26.8 GB free, 4 threads 71% busy, 0 sessions +desktop offline +macmini busy: 27.7 GB free, 14 threads 93% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 10% busy, 0 sessions + RAM 26.6 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 92% busy (agents 0.0, rest 3.4 cores) · 81°C · load 5.2 + · disk 308.7 GB free · battery 96% · Ludovic: away + +2026-10-18T20:50:54Z +ludothinkpad busy: 25.8 GB free, 4 threads 100% busy, 0 sessions +desktop offline +macmini busy: 31.3 GB free, 14 threads 95% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 11% busy, 0 sessions + RAM 25.8 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 99% busy (agents 0.0, rest 4.0 cores) · 82°C · load 8.1 + · disk 308.7 GB free · battery 96% · Ludovic: away + +2026-10-18T20:51:59Z +ludothinkpad ok: 27.2 GB free, 4 threads 12% busy, 0 sessions +desktop offline +macmini ok: 31.2 GB free, 14 threads 76% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 8% busy, 0 sessions + RAM 27.2 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 15% busy (agents 0.0, rest 1.3 cores) · 81°C · load 7.9 + · disk 308.7 GB free · battery 96% · Ludovic: away + +2026-10-18T20:53:03Z +ludothinkpad ok: 27.3 GB free, 4 threads 42% busy, 0 sessions +desktop offline +macmini busy: 27.8 GB free, 14 threads 87% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 9% busy, 0 sessions + RAM 27.2 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 14% busy (agents 0.0, rest 0.8 cores) · 82°C · load 3.1 + · disk 308.7 GB free · battery 96% · Ludovic: away + +2026-10-18T20:54:08Z +ludothinkpad ok: 28.9 GB free, 4 threads 4% busy, 0 sessions +desktop offline +macmini ok: 29.2 GB free, 14 threads 80% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 9% busy, 0 sessions + RAM 28.9 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 2% busy (agents 0.0, rest 0.3 cores) · 82°C · load 1.3 + · disk 308.7 GB free · battery 96% · Ludovic: away + +2026-10-18T20:55:12Z +ludothinkpad ok: 27.7 GB free, 4 threads 27% busy, 0 sessions +desktop offline +macmini ok: 31.2 GB free, 14 threads 70% busy, 1 sessions +macbook ok: 6.7 GB free, 12 threads 10% busy, 0 sessions + RAM 27.6 GB free of 31.2 GB · swap 0.3 GB/15.6 GB + CPU 4 threads, 26% busy (agents 0.0, rest 1.2 cores) · 69°C · load 1.0 + · disk 308.8 GB free · battery 96% · Ludovic: away + diff --git a/benchmarks/server-equal-mixed-2026-10-18/mixed-equal.json b/benchmarks/server-equal-mixed-2026-10-18/mixed-equal.json new file mode 100644 index 000000000..c494f3b24 --- /dev/null +++ b/benchmarks/server-equal-mixed-2026-10-18/mixed-equal.json @@ -0,0 +1,421 @@ +{ + "kind": "horizon-server-benchmark", + "date": "2026-10-18T19:32:00+00:00", + "machine": { + "system": "Linux", + "machine": "x86_64", + "cpus": 4, + "name": "ThinkPad, Intel Core i7-7500U, 32 GB, NixOS" + }, + "commit": "f1d5bf520986b00a5b968a84d85809fca1a039fa", + "engine": "horizon-engine: the server build of #916 (horizon-client --no-default-features) at 519ec121, as install.sh --archive installed it", + "java": [ + "openjdk 25.0.4.1 2026-08-18" + ], + "settings": { + "servers": "horizon,vanilla", + "bots": "1,10,25,50", + "behaviour": "mixed", + "join_every": 1.0, + "warmup": 300, + "seconds": 300, + "seed": 12345, + "explore_speed": 0.8, + "gamerule": "", + "heap": "4g", + "nice": 19, + "bots_via": "ssh macmini", + "connect": "the ThinkPad's tailnet address", + "properties": { + "level-seed": "12345", + "view-distance": "10", + "simulation-distance": "10", + "online-mode": "false", + "white-list": "false", + "gamemode": "creative", + "force-gamemode": "true", + "spawn-protection": "0", + "max-players": "200", + "difficulty": "easy", + "sync-chunk-writes": "true" + } + }, + "note": "server_bench.py was stopped after vanilla's 50-bot server crashed, before it wrote this file; the runs are the lines it printed, and the vanilla 50 entry is taken from that server's log.", + "runs": [ + { + "server": "horizon", + "bots": 1, + "behaviour": "mixed", + "start_seconds": 19.73, + "mspt": { + "average": 1.77, + "p50": 1.34, + "p95": 4.21, + "p99": 13.04 + }, + "mspt_worst_p99": 47.5, + "tps": 20.0, + "rss_mb": { + "mean": 686.54, + "max": 686.7 + }, + "cpu_percent": 27.92, + "chunks_per_second": 9.94, + "unique_per_second": 0.01, + "forgotten_per_second": 9.9, + "waited_ticks_per_second": 0.0, + "chunks_total": 6092, + "chunks_per_bot": { + "walk": 6092.0 + }, + "unique_chunks_per_bot": { + "walk": 699.0 + }, + "resent": 0, + "pulled_back": 0, + "moved_too_quickly": 0, + "moved_wrongly": 0, + "bots_joined": 1, + "bots_failed": [], + "tick_queries": 58 + }, + { + "server": "vanilla", + "bots": 1, + "behaviour": "mixed", + "start_seconds": 20.45, + "mspt": { + "average": 11.34, + "p50": 10.6, + "p95": 17.12, + "p99": 33.22 + }, + "mspt_worst_p99": 119.1, + "tps": 20.0, + "rss_mb": { + "mean": 3404.16, + "max": 3416.3 + }, + "cpu_percent": 35.93, + "chunks_per_second": 9.98, + "unique_per_second": 0.01, + "forgotten_per_second": 9.93, + "waited_ticks_per_second": 0.0, + "chunks_total": 6084, + "chunks_per_bot": { + "walk": 6084.0 + }, + "unique_chunks_per_bot": { + "walk": 699.0 + }, + "resent": 0, + "pulled_back": 0, + "moved_too_quickly": 0, + "moved_wrongly": 0, + "bots_joined": 1, + "bots_failed": [], + "tick_queries": 59 + }, + { + "server": "horizon", + "bots": 10, + "behaviour": "mixed", + "start_seconds": 19.54, + "mspt": { + "average": 4.74, + "p50": 3.83, + "p95": 10.48, + "p99": 19.69 + }, + "mspt_worst_p99": 120.1, + "tps": 20.0, + "rss_mb": { + "mean": 855.26, + "max": 882.7 + }, + "cpu_percent": 29.78, + "chunks_per_second": 61.35, + "unique_per_second": 1.79, + "forgotten_per_second": 61.47, + "waited_ticks_per_second": 0.0, + "chunks_total": 40762, + "chunks_per_bot": { + "walk": 6247.67, + "explore": 1165.0, + "idle": 473.0 + }, + "unique_chunks_per_bot": { + "walk": 701.83, + "explore": 1086.0, + "idle": 473.0 + }, + "resent": 0, + "pulled_back": 4159, + "moved_too_quickly": 0, + "moved_wrongly": 0, + "bots_joined": 10, + "bots_failed": [], + "tick_queries": 58 + }, + { + "server": "vanilla", + "bots": 10, + "behaviour": "mixed", + "start_seconds": 19.95, + "mspt": { + "average": 34.3, + "p50": 32.2, + "p95": 53.72, + "p99": 89.08 + }, + "mspt_worst_p99": 375.8, + "tps": 20.0, + "rss_mb": { + "mean": 3713.5, + "max": 3754.9 + }, + "cpu_percent": 128.07, + "chunks_per_second": 61.66, + "unique_per_second": 1.93, + "forgotten_per_second": 61.71, + "waited_ticks_per_second": 0.0, + "chunks_total": 37568, + "chunks_per_bot": { + "walk": 5729.0, + "explore": 1124.0, + "idle": 473.0 + }, + "unique_chunks_per_bot": { + "walk": 701.17, + "explore": 1055.0, + "idle": 473.0 + }, + "resent": 0, + "pulled_back": 3976, + "moved_too_quickly": 20, + "moved_wrongly": 0, + "bots_joined": 10, + "bots_failed": [], + "tick_queries": 58 + }, + { + "server": "horizon", + "bots": 25, + "behaviour": "mixed", + "start_seconds": 9.61, + "mspt": { + "average": 11.72, + "p50": 9.88, + "p95": 24.45, + "p99": 43.79 + }, + "mspt_worst_p99": 129.8, + "tps": 20.0, + "rss_mb": { + "mean": 947.35, + "max": 1086.1 + }, + "cpu_percent": 57.83, + "chunks_per_second": 158.57, + "unique_per_second": 5.78, + "forgotten_per_second": 158.45, + "waited_ticks_per_second": 0.0, + "chunks_total": 108126, + "chunks_per_bot": { + "walk": 6628.53, + "explore": 1266.6, + "idle": 473.0 + }, + "unique_chunks_per_bot": { + "walk": 704.67, + "explore": 1189.2, + "idle": 473.0 + }, + "resent": 0, + "pulled_back": 3496, + "moved_too_quickly": 0, + "moved_wrongly": 0, + "bots_joined": 25, + "bots_failed": [], + "tick_queries": 58 + }, + { + "server": "vanilla", + "bots": 25, + "behaviour": "mixed", + "start_seconds": 37.78, + "mspt": { + "average": 50.45, + "p50": 46.39, + "p95": 74.09, + "p99": 191.21 + }, + "mspt_worst_p99": 1388.1, + "tps": 19.82, + "rss_mb": { + "mean": 3866.18, + "max": 4745.0 + }, + "cpu_percent": 192.42, + "chunks_per_second": 157.63, + "unique_per_second": 8.25, + "forgotten_per_second": 156.12, + "waited_ticks_per_second": 0.0, + "chunks_total": 88763, + "chunks_per_bot": { + "walk": 5387.0, + "explore": 1118.6, + "idle": 473.0 + }, + "unique_chunks_per_bot": { + "walk": 699.0, + "explore": 1075.0, + "idle": 473.0 + }, + "resent": 2, + "pulled_back": 3629, + "moved_too_quickly": 296, + "moved_wrongly": 0, + "bots_joined": 25, + "bots_failed": [], + "tick_queries": 58 + }, + { + "server": "horizon", + "bots": 50, + "behaviour": "mixed", + "start_seconds": 14.93, + "mspt": { + "average": 23.82, + "p50": 20.11, + "p95": 50.98, + "p99": 74.64 + }, + "mspt_worst_p99": 195.9, + "tps": 20.0, + "rss_mb": { + "mean": 1031.41, + "max": 1201.2 + }, + "cpu_percent": 98.21, + "chunks_per_second": 302.81, + "unique_per_second": 10.96, + "forgotten_per_second": 303.47, + "waited_ticks_per_second": 0.0, + "chunks_total": 212181, + "chunks_per_bot": { + "walk": 6496.53, + "explore": 1255.5, + "idle": 473.0 + }, + "unique_chunks_per_bot": { + "walk": 701.9, + "explore": 1184.7, + "idle": 473.0 + }, + "resent": 0, + "pulled_back": 7565, + "moved_too_quickly": 0, + "moved_wrongly": 0, + "bots_joined": 50, + "bots_failed": [], + "tick_queries": 58 + }, + { + "server": "vanilla", + "bots": 50, + "behaviour": "mixed", + "start_seconds": 11.16, + "error": "stopped by its watchdog 30 s after the last bot joined: \"A single server tick took 60.01 seconds (should be max 0.05)\" (Player.tick)" + } + ], + "work": [ + { + "behaviour": "mixed", + "bots": 1, + "servers": { + "horizon": { + "chunks_per_second": { + "value": 9.94, + "share": 0.996 + }, + "unique_per_second": { + "value": 0.01, + "share": 1.0 + }, + "waited_ticks_per_second": 0.0 + }, + "vanilla": { + "chunks_per_second": { + "value": 9.98, + "share": 1.0 + }, + "unique_per_second": { + "value": 0.01, + "share": 1.0 + }, + "waited_ticks_per_second": 0.0 + } + }, + "equal": true + }, + { + "behaviour": "mixed", + "bots": 10, + "servers": { + "horizon": { + "chunks_per_second": { + "value": 61.35, + "share": 0.995 + }, + "unique_per_second": { + "value": 1.79, + "share": 0.927 + }, + "waited_ticks_per_second": 0.0 + }, + "vanilla": { + "chunks_per_second": { + "value": 61.66, + "share": 1.0 + }, + "unique_per_second": { + "value": 1.93, + "share": 1.0 + }, + "waited_ticks_per_second": 0.0 + } + }, + "equal": true + }, + { + "behaviour": "mixed", + "bots": 25, + "servers": { + "horizon": { + "chunks_per_second": { + "value": 158.57, + "share": 1.0 + }, + "unique_per_second": { + "value": 5.78, + "share": 0.701 + }, + "waited_ticks_per_second": 0.0 + }, + "vanilla": { + "chunks_per_second": { + "value": 157.63, + "share": 0.994 + }, + "unique_per_second": { + "value": 8.25, + "share": 1.0 + }, + "waited_ticks_per_second": 0.0 + } + }, + "equal": false + } + ] +} diff --git a/docs/server.md b/docs/server.md index 923eddf2c..0d27b4481 100644 --- a/docs/server.md +++ b/docs/server.md @@ -495,6 +495,20 @@ reproducible by anyone, and show the same gameplay on both sides. 24.0 against 31.6) and longer with 50 (35.2 against 29.7). Its P99 was lower at every count. - Horizon also did more work: it kept up with the exploring bots, so it generated 1.9 to 2.9 times the new terrain a second. +- **Mixed bots, equal work (2026-10-18,** `benchmarks/server-equal-mixed-2026-10-18/`). This is the same + run with the load made equal. The explore bots fly at 0.8 blocks a second, so every bot follows the same + path on both servers and none waits for terrain. A 300-second warm-up lets both finish the bots' first + views before the measurement. `server_bench.py` now prints a work table that compares each count's chunks + a second across servers and flags a run that isn't equal. Horizon ran as `horizon-engine`, the server + build, installed from its archive. Results, on the ThinkPad again (the desktop didn't wake): + - The work was equal at 1 and 10 bots. At 25 the chunks sent a second were equal (158.6 against 157.6), + and vanilla still sent 2.5 more first-time chunks a second while it caught up. + - Tick: 1.8 against 11.3 ms at 1 bot, 4.7 against 34.3 at 10, 11.7 against 50.5 at 25 (vanilla 19.8 TPS). + At 50 Horizon ran at 23.8 ms. Vanilla's watchdog stopped its server 30 s after the last bot joined (a + 60-second tick). This is one pass, to repeat on a bigger machine. + - Horizon's RSS was 4.1 to 4.9 times smaller (1.03 GB at 50). + - Served in full, vanilla's walking bots got 5400 to 6100 chunks each, against 640 to 1100 in the first + run. That is why vanilla held 50 bots there and not here. - **Ownership.** perf-server-1 owns making the tick faster. This work only measures it, files what it finds, and fixes startup, RAM and packaging. @@ -513,7 +527,8 @@ vanilla. archive in the release. 3. The web panel MVP: status, live TPS/MSPT/RAM/CPU, players, console, backups and login links. 4. `horizon-bots` and `tools/server_bench.py`, with a first run against vanilla (1/10/25/50 bots, `mixed`) - published in `benchmarks/`: done, `benchmarks/server-mixed-2026-10-18/` (section 9). + published in `benchmarks/`: done, `benchmarks/server-mixed-2026-10-18/`, and with equal work + `benchmarks/server-equal-mixed-2026-10-18/` (section 9). 5. Small engine fixes found on the way: logging refused logins (vanilla's lines). **Where it stands (2026-10-16):** items 1 to 4 are built and in review (section 11). What's left for the 23rd: From 13cd89578a3ef14d9e74ac8be81a3032aad699c6 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 18 Oct 2026 18:46:40 +0200 Subject: [PATCH 163/163] Terrain: occlusion culling of solid sections (Vulkan) Sections that terrain in front hides entirely are drawn with an instance count of 0. Phase 1 draws the sections the last test read back saw; in the same pass every other section's box (and an eighth of phase 1's) is drawn against phase 1's depth, front faces only, with a fragment shader forced past an early depth test that marks the section seen. Phase 2, in a second pass, draws what the test saw. The test is exact per pixel and needs no depth read or Hi-Z, and every solid draw stays one entry of one list, so the CPU records as many draws as before (Mesa unrolls a multi-draw per entry on Intel Gen9). Culling pauses while the last result hid under a tenth of the solid indices, with one frame in 64 testing everything. HD 620 at RD16: +23-42% FPS in five of perf-frame-6's six views, the peak view unchanged; RD32: +14-109%. Pixels unchanged, also on camera jumps. Vulkan only: naga's MSL has no early fragment tests. HORIZON_GPU_CULL=0 turns it off, `all` culls every frame; `section-cull on|off` in a game. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game/control.rs | 11 + .../horizon-client/src/game/render_control.rs | 1 + crates/horizon-client/src/gfx.rs | 186 ++++++- crates/horizon-client/src/gfx/cull.rs | 511 ++++++++++++++++++ crates/horizon-client/src/gfx/cull.wgsl | 101 ++++ 5 files changed, 800 insertions(+), 10 deletions(-) create mode 100644 crates/horizon-client/src/gfx/cull.rs create mode 100644 crates/horizon-client/src/gfx/cull.wgsl diff --git a/crates/horizon-client/src/game/control.rs b/crates/horizon-client/src/game/control.rs index 0183559ef..3e0711aeb 100644 --- a/crates/horizon-client/src/game/control.rs +++ b/crates/horizon-client/src/game/control.rs @@ -197,6 +197,16 @@ impl Game<'_> { } Ok(Some(json!({ "ok": true, "flat": r.flat_draws() }))) } + "section-cull" => { + let r = self.renderer.as_mut().ok_or("no renderer")?; + match words.get(1).copied() { + None => {} + Some("on") => r.set_section_cull(true)?, + Some("off") => r.set_section_cull(false)?, + Some(other) => return Err(format!("unknown section cull mode {other}").into()), + } + Ok(Some(json!({ "ok": true, "cull": r.section_cull() }))) + } "sculk" => Ok(Some(self.sculk_command(&words)?)), "status" => Ok(Some(self.control_status())), "pad" => Ok(Some(self.pad_command(&words)?)), @@ -714,6 +724,7 @@ impl Game<'_> { "drawn_sections": r.drawn_sections, "section_draws": r.section_draws, "section_draw_calls": r.section_draw_calls, + "culled_sections": r.culled_sections(), "uploaded_bytes": r.uploaded_bytes, "resident_sections": r.resident_sections(), "arena_bytes": arena_bytes, diff --git a/crates/horizon-client/src/game/render_control.rs b/crates/horizon-client/src/game/render_control.rs index c8355a395..31a7a33a0 100644 --- a/crates/horizon-client/src/game/render_control.rs +++ b/crates/horizon-client/src/game/render_control.rs @@ -12,6 +12,7 @@ pub const HELP: &[&str] = &[ "particle NAME X Y Z [DX DY DZ] [COUNT] spawn particles (vanilla /particle spread)", "signedit X Y Z [front|back] open the sign editor for the sign at X Y Z", "section-draws [flat|indirect] how terrain sections are drawn (A/B checks); replies the mode", + "section-cull [on|off] occlusion culling of solid sections (A/B checks); replies the mode", ]; impl Game<'_> { diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index d3b71bc60..8481fdcab 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -58,6 +58,7 @@ pub fn outline_vertices(edges: &[[f64; 6]], camera: glam::DVec3) -> Vec<[f32; 6] } mod arena; +mod cull; mod flat; mod java_stages; mod occlusion; @@ -270,6 +271,9 @@ pub struct Renderer { flat: Option<flat::Flat>, /// `flat` draws this frame's sections (off: the per-section draws). flat_on: bool, + /// Occlusion culling of solid section draws, where multi-draw is native. + cull: Option<cull::Cull>, + cull_on: bool, sky: wgpu::RenderPipeline, dark_disc: wgpu::RenderPipeline, lines: wgpu::RenderPipeline, @@ -365,6 +369,10 @@ pub struct Renderer { draws: Vec<[u32; 5]>, /// Vertex arena page and optional sorted index arena page of each draw. draw_pages: Vec<(u32, Option<u32>)>, + /// Solid draws left to occlusion culling's phase 2, while the list is + /// built, and their pages. + phase2_draws: Vec<[u32; 5]>, + phase2_pages: Vec<(u32, Option<u32>)>, /// Block-entity blocks per meshed section (world position, state id). block_entities: HashMap<SectionKey, Vec<([i32; 3], u32)>>, /// Changes whenever `block_entities` does (unique across renderers). @@ -654,6 +662,7 @@ impl Renderer { // Mappable primary buffers: section pages that no // longer fit in video memory go to system memory. required_features: timing::GpuTimer::features(&adapter) + | cull::Cull::features(&adapter) | (adapter.features() & (wgpu::Features::INDIRECT_FIRST_INSTANCE | wgpu::Features::MAPPABLE_PRIMARY_BUFFERS)), @@ -1100,7 +1109,9 @@ impl Renderer { let instances = device.create_buffer(&wgpu::BufferDescriptor { label: Some("Section origins"), size: instance_capacity * 16, - usage: wgpu::BufferUsages::VERTEX | wgpu::BufferUsages::COPY_DST, + usage: wgpu::BufferUsages::VERTEX + | wgpu::BufferUsages::COPY_DST + | wgpu::BufferUsages::STORAGE, mapped_at_creation: false, }); let outline = device.create_buffer(&wgpu::BufferDescriptor { @@ -1745,6 +1756,15 @@ impl Renderer { let multi_draw = device .features() .contains(wgpu::Features::INDIRECT_FIRST_INSTANCE); + // HORIZON_GPU_CULL=0 turns occlusion culling off, `all` culls every + // frame however little it hides (A/B checks). + let cull_env = std::env::var("HORIZON_GPU_CULL"); + let cull = (cull_env.as_deref() != Ok("0") && cull::Cull::supported(&adapter, &device)) + .then(|| { + let mut cull = cull::Cull::new(&device, config.format.remove_srgb_suffix()); + cull.always = cull_env.as_deref() == Ok("all"); + cull + }); let world_post = world_post::Post::new(&device, config.format.remove_srgb_suffix()); let uploads = upload::Uploads::new(&device); let section_uploads = upload::Uploads::with_chunk(&device, SECTION_UPLOAD_CHUNK); @@ -1772,6 +1792,8 @@ impl Renderer { solid, translucent, flat_on: flat.is_some(), + cull_on: cull.is_some(), + cull, flat, sky, dark_disc, @@ -1845,6 +1867,8 @@ impl Renderer { origins: Vec::new(), draws: Vec::new(), draw_pages: Vec::new(), + phase2_draws: Vec::new(), + phase2_pages: Vec::new(), block_entities: HashMap::new(), block_entity_revision: next_block_entity_revision(), occlusion: occlusion::Occlusion::new(crate::chunk::HEIGHT / 16), @@ -1998,6 +2022,27 @@ impl Renderer { self.flat_on = on; Ok(()) } + /// Whether solid sections are occlusion culled (`cull`). + pub fn section_cull(&self) -> bool { + self.cull_on + } + /// Switches occlusion culling, for A/B checks. + pub fn set_section_cull(&mut self, on: bool) -> Result<()> { + if on && self.cull.is_none() { + return Err("occlusion culling is off on this device".into()); + } + self.cull_on = on; + Ok(()) + } + /// Of the boxes occlusion culling's last test read back drew, how many + /// it did not see and how many it drew, and the share of solid indices + /// it hid. + pub fn culled_sections(&self) -> Option<([usize; 2], f32)> { + self.cull + .as_ref() + .filter(|_| self.cull_on) + .map(|c| c.hidden) + } pub fn section_count(&self) -> usize { self.sections.len() } @@ -2117,7 +2162,15 @@ impl Renderer { /// origins bound: one indirect multi-draw, or a loop without it. /// Consecutive draws in one arena page share a vertex buffer binding, /// keeping the list's order (translucent sections go back to front). - fn draw_sections(&self, pass: &mut wgpu::RenderPass<'_>, first: u32, count: u32) { + /// `indirect` holds the list's draws from `base`. + fn draw_sections( + &self, + pass: &mut wgpu::RenderPass<'_>, + indirect: &wgpu::Buffer, + base: u32, + first: u32, + count: u32, + ) { let (mut i, end) = (first as usize, (first + count) as usize); while i < end { let (page, index_page) = self.draw_pages[i]; @@ -2129,7 +2182,8 @@ impl Renderer { let indices = index_page.map_or(&self.indices, |p| self.sorted_indices.buffer(p)); pass.set_index_buffer(indices.slice(..), wgpu::IndexFormat::Uint32); if self.multi_draw { - pass.multi_draw_indexed_indirect(&self.indirect, i as u64 * 20, run as u32); + let offset = (i - base as usize) as u64 * 20; + pass.multi_draw_indexed_indirect(indirect, offset, run as u32); } else { for d in &self.draws[i..i + run] { pass.draw_indexed(d[2]..d[2] + d[0], d[3] as i32, d[4]..d[4] + 1); @@ -2574,7 +2628,9 @@ impl Renderer { self.instances = self.device.create_buffer(&wgpu::BufferDescriptor { label: Some("Section origins"), size: self.instance_capacity * 16, - usage: wgpu::BufferUsages::VERTEX | wgpu::BufferUsages::COPY_DST, + usage: wgpu::BufferUsages::VERTEX + | wgpu::BufferUsages::COPY_DST + | wgpu::BufferUsages::STORAGE, mapped_at_creation: false, }); } @@ -2603,15 +2659,48 @@ impl Renderer { let eye = (frame.bob * crate::camera::view_matrix(frame.yaw, frame.pitch)) .inverse() .transform_point3(Vec3::ZERO); + // Occlusion culling leaves the sections its last result did not see + // to phase 2, after the others, with instance counts of 0. + let mut cull = self + .cull + .as_mut() + .filter(|_| { + self.cull_on + && !frame.title + && self.multi_draw + && !(self.flat_on && self.flat.is_some()) + }) + .and_then(|cull| cull.begin(&self.device).then_some(cull)); + self.phase2_draws.clear(); + self.phase2_pages.clear(); for (i, v) in visible.iter().enumerate() { let s = self.sections.get(v.slot); + let first_phase = cull.as_ref().is_none_or(|c| c.first(v.slot)); + let (draws, pages) = if first_phase { + (&mut self.draws, &mut self.draw_pages) + } else { + (&mut self.phase2_draws, &mut self.phase2_pages) + }; + let start = draws.len(); + let instances = u32::from(first_phase); + let mut indices = 0; // Only the solid groups that can face the eye. s.faces.ranges(eye - Vec3::from(v.origin), |first, quads| { let first = s.start + u64::from(first) * 4; - self.draws.push([quads * 6, 1, 0, first as u32, i as u32]); - self.draw_pages.push((s.page, None)); + draws.push([quads * 6, instances, 0, first as u32, i as u32]); + pages.push((s.page, None)); + indices += quads * 6; }); + match &mut cull { + Some(c) if first_phase => c.drawn(i, v.slot, indices), + Some(c) => c.deferred(i, v.slot, start, draws.len() - start, indices), + None => {} + } } + let phase1_draws = self.draws.len() as u32; + self.draws.extend_from_slice(&self.phase2_draws); + self.draw_pages.extend_from_slice(&self.phase2_pages); + let culling = cull.is_some(); let solid_draws = self.draws.len() as u32; // LevelRenderer: nearby sections each frame, plus a rotating eighth // (at least 15) of the visible list. Cached views avoid needless sorts. @@ -2661,6 +2750,7 @@ impl Renderer { (0..self.draws.len()) .filter(|&i| { i == 0 + || i == phase1_draws as usize || i == solid_draws as usize || self.draw_pages[i] != self.draw_pages[i - 1] }) @@ -2874,6 +2964,16 @@ impl Renderer { 0, bytemuck::cast_slice(&self.draws), ); + if culling && let Some(cull) = &mut self.cull { + cull.upload( + &self.device, + &mut self.uploads, + &mut encoder, + &self.draws[phase1_draws as usize..solid_draws as usize], + &self.instances, + &self.globals, + ); + } } let view_target = target_texture.create_view(&wgpu::TextureViewDescriptor { format: Some(self.config.format.remove_srgb_suffix()), @@ -2891,6 +2991,7 @@ impl Renderer { Some((color, depth)) => (color, depth), None => (&view_target, &self.depth), }; + let cull = self.cull.as_ref().filter(|_| culling && solid_draws > 0); { let attachments = [Some(wgpu::RenderPassColorAttachment { view: world_view, @@ -2919,8 +3020,9 @@ impl Renderer { view: world_depth, depth_ops: Some(wgpu::Operations { load: wgpu::LoadOp::Clear(0.0), - // A shader pack reads the world's depth. - store: if pack { + // A shader pack reads the world's depth, and + // phase 2 of occlusion culling draws over it. + store: if pack || cull.is_some() { wgpu::StoreOp::Store } else { wgpu::StoreOp::Discard @@ -2970,7 +3072,59 @@ impl Renderer { pass.set_pipeline(&self.solid); pass.set_index_buffer(self.indices.slice(..), wgpu::IndexFormat::Uint32); pass.set_vertex_buffer(1, self.instances.slice(..)); - self.draw_sections(&mut pass, 0, solid_draws); + match cull { + Some(cull) => { + // Phase 1 and the boxes against its depth, then + // what they found in sight, in a pass that loads + // both targets (it reads the test's results). + self.draw_sections(&mut pass, &self.indirect, 0, 0, phase1_draws); + cull.test(&mut pass); + drop(pass); + let attachments = [Some(wgpu::RenderPassColorAttachment { + view: world_view, + resolve_target: None, + depth_slice: None, + ops: wgpu::Operations { + load: wgpu::LoadOp::Load, + store: wgpu::StoreOp::Store, + }, + })]; + pass = encoder.begin_render_pass(&wgpu::RenderPassDescriptor { + label: Some("Horizon world, after culling"), + color_attachments: &attachments, + depth_stencil_attachment: Some( + wgpu::RenderPassDepthStencilAttachment { + view: world_depth, + depth_ops: Some(wgpu::Operations { + load: wgpu::LoadOp::Load, + store: if pack { + wgpu::StoreOp::Store + } else { + wgpu::StoreOp::Discard + }, + }), + stencil_ops: None, + }, + ), + ..Default::default() + }); + pass.set_bind_group(0, &self.group, &[]); + pass.set_pipeline(&self.solid); + pass.set_index_buffer( + self.indices.slice(..), + wgpu::IndexFormat::Uint32, + ); + pass.set_vertex_buffer(1, self.instances.slice(..)); + self.draw_sections( + &mut pass, + &cull.phase2, + phase1_draws, + phase1_draws, + solid_draws - phase1_draws, + ); + } + None => self.draw_sections(&mut pass, &self.indirect, 0, 0, solid_draws), + } } } if entity_quads > 0 { @@ -3022,7 +3176,13 @@ impl Renderer { pass.set_pipeline(&self.translucent); pass.set_index_buffer(self.indices.slice(..), wgpu::IndexFormat::Uint32); pass.set_vertex_buffer(1, self.instances.slice(..)); - self.draw_sections(&mut pass, solid_draws, translucent_draws); + self.draw_sections( + &mut pass, + &self.indirect, + 0, + solid_draws, + translucent_draws, + ); } } // LevelRenderer.executeClassicTransparency: translucent targets' @@ -3236,6 +3396,9 @@ impl Renderer { frame.hud, [self.config.width, self.config.height], ); + if culling && let Some(cull) = &mut self.cull { + cull.end(&self.device, &mut encoder); + } if let Some(timer) = &mut self.gpu_timer { timer.end(&mut encoder); } @@ -3250,6 +3413,9 @@ impl Renderer { } let commands = crate::spans::time("encode", || encoder.finish()); let submission = crate::spans::time("submit", || self.queue.submit([commands])); + if let Some(cull) = &mut self.cull { + cull.submitted(); + } if let Some(timer) = &mut self.gpu_timer { timer.submitted(); timer.collect(&self.device, &mut self.gpu_times); diff --git a/crates/horizon-client/src/gfx/cull.rs b/crates/horizon-client/src/gfx/cull.rs new file mode 100644 index 000000000..6926aab70 --- /dev/null +++ b/crates/horizon-client/src/gfx/cull.rs @@ -0,0 +1,511 @@ +//! Occlusion culling of solid section draws, in two phases. +//! +//! Frustum and cave culling leave many sections that terrain in front hides +//! entirely (about half of the solid vertices drawn from the ground at render +//! distance 16, more at 32), and drawing fewer vertices is what helps an +//! integrated GPU. Phase 1 draws the sections that the last test read back +//! saw. Then, in the same pass, the box of every other section (and of a +//! share of phase 1's, to notice when they go out of sight) is drawn against +//! phase 1's depth with no writes but to the test's results. Phase 2, in a +//! second pass, draws the sections whose box was seen; the others' draws have +//! an instance count of 0. +//! +//! The picture stays the one without culling: the boxes (grown by a block, +//! the farthest a block model reaches out of its cell) are drawn front faces +//! only, so a fragment is the box's nearest point on its pixel, and the +//! fragment shader runs only where the depth test passes (forced early), so a +//! section is left out only where all of its fragments would fail the depth +//! test against the final depth, which is only nearer. What the CPU knows of +//! the results only sorts sections between the phases: a stale result draws +//! a hidden section in phase 1, or tests a section that is in sight. +//! +//! Every solid draw is an entry of one of the two lists, so the CPU records +//! as many draws as without culling: drivers that unroll an indirect +//! multi-draw on the CPU (Mesa's on Intel Gen9) pay per entry. Phase 2's +//! counts come from the GPU, which needs a native multi-draw and forced +//! early depth tests: Vulkan. Translucent draws are not culled. +use std::num::NonZeroU64; +use std::sync::{ + Arc, + atomic::{AtomicU8, Ordering}, +}; + +const WORDS: u64 = 5 * 4; +/// Phase 1's sections are each tested every `RETEST` frames. +const RETEST: u32 = 8; +/// Culling runs while the last result read back hid at least this share of +/// the frame's solid indices: below it the test and the second pass cost +/// more than they save. Else one frame in `PROBE` tests every section. +const MIN_SHARE: f32 = 0.1; +const PROBE: u32 = 64; +/// Boxes over more than this share of the screen count as seen untested. +const BIG: f32 = 0.25; +/// Results read back at once, some frames late so the CPU never waits. +const READBACKS: usize = 3; +const FREE: u8 = 0; +const PENDING: u8 = 1; +const MAPPED: u8 = 2; + +#[repr(C)] +#[derive(Clone, Copy, bytemuck::Pod, bytemuck::Zeroable)] +struct Params { + stamp: u32, + big: f32, + pad: [u32; 2], +} + +/// One frame's results on their way back. +struct Readback { + buffer: wgpu::Buffer, + capacity: u64, + state: Arc<AtomicU8>, + stamp: u32, + /// The resident slot of each test, and its section's solid indices. + slots: Vec<u32>, + indices: Vec<u32>, + /// The frame's solid indices. + total: u64, +} + +/// The bind group and the buffers from outside it was made with. +struct Group { + origins: wgpu::Buffer, + globals: wgpu::Buffer, + group: wgpu::BindGroup, +} + +pub struct Cull { + pipeline: wgpu::RenderPipeline, + layout: wgpu::BindGroupLayout, + group: Option<Group>, + params: wgpu::Buffer, + /// Phase 2's draws: the solid draws after phase 1's in the frame's list. + pub phase2: wgpu::Buffer, + phase2_capacity: u64, + tests: wgpu::Buffer, + tests_capacity: u64, + /// This frame's tests: visible index, first phase 2 draw, phase 2 draws. + test_data: Vec<[u32; 4]>, + test_slots: Vec<u32>, + test_indices: Vec<u32>, + total: u64, + /// The frame tests every section, as culling was off. + probe: bool, + results: wgpu::Buffer, + readbacks: Vec<Readback>, + next: usize, + current: Option<usize>, + /// Per resident slot: whether the last result read back saw it. + seen: Vec<bool>, + stamp: u32, + /// Of the boxes the last test read back drew, how many it did not see + /// and how many it drew, and the share of solid indices hidden. + pub hidden: ([usize; 2], f32), + /// Cull every frame, whatever the hidden share (A/B checks). + pub always: bool, +} + +fn buffer( + device: &wgpu::Device, + label: &str, + size: u64, + usage: wgpu::BufferUsages, +) -> wgpu::Buffer { + device.create_buffer(&wgpu::BufferDescriptor { + label: Some(label), + size, + usage, + mapped_at_creation: false, + }) +} + +const PHASE2_USAGE: wgpu::BufferUsages = wgpu::BufferUsages::INDIRECT + .union(wgpu::BufferUsages::STORAGE) + .union(wgpu::BufferUsages::COPY_DST); +const TESTS_USAGE: wgpu::BufferUsages = + wgpu::BufferUsages::STORAGE.union(wgpu::BufferUsages::COPY_DST); +const RESULTS_USAGE: wgpu::BufferUsages = + wgpu::BufferUsages::STORAGE.union(wgpu::BufferUsages::COPY_SRC); +const READBACK_USAGE: wgpu::BufferUsages = + wgpu::BufferUsages::MAP_READ.union(wgpu::BufferUsages::COPY_DST); + +impl Cull { + /// The device feature culling needs, where the adapter has it. + pub fn features(adapter: &wgpu::Adapter) -> wgpu::Features { + adapter.features() & wgpu::Features::SHADER_EARLY_DEPTH_TEST + } + /// Whether the device draws an indirect multi-draw natively and runs + /// fragment shaders that write storage only past an early depth test. + pub fn supported(adapter: &wgpu::Adapter, device: &wgpu::Device) -> bool { + adapter.get_info().backend == wgpu::Backend::Vulkan + && device.features().contains( + wgpu::Features::SHADER_EARLY_DEPTH_TEST | wgpu::Features::INDIRECT_FIRST_INSTANCE, + ) + && adapter.get_downlevel_capabilities().flags.contains( + wgpu::DownlevelFlags::VERTEX_STORAGE + | wgpu::DownlevelFlags::FRAGMENT_WRITABLE_STORAGE, + ) + } + /// `color` is the world pass's colour format. + pub fn new(device: &wgpu::Device, color: wgpu::TextureFormat) -> Self { + let entry = |binding, visibility, ty| wgpu::BindGroupLayoutEntry { + binding, + visibility, + ty, + count: None, + }; + let storage = |read_only| wgpu::BindingType::Buffer { + ty: wgpu::BufferBindingType::Storage { read_only }, + has_dynamic_offset: false, + min_binding_size: None, + }; + let uniform = wgpu::BindingType::Buffer { + ty: wgpu::BufferBindingType::Uniform, + has_dynamic_offset: false, + min_binding_size: None, + }; + let both = wgpu::ShaderStages::VERTEX_FRAGMENT; + let vertex = wgpu::ShaderStages::VERTEX; + let fragment = wgpu::ShaderStages::FRAGMENT; + let layout = device.create_bind_group_layout(&wgpu::BindGroupLayoutDescriptor { + label: Some("Section culling"), + entries: &[ + entry(0, both, storage(true)), + entry(1, fragment, storage(false)), + entry(2, fragment, storage(false)), + entry(3, vertex, storage(true)), + entry(4, vertex, uniform), + entry(5, both, uniform), + ], + }); + let module = device.create_shader_module(wgpu::ShaderModuleDescriptor { + label: Some("Section culling"), + source: wgpu::ShaderSource::Wgsl(include_str!("cull.wgsl").into()), + }); + let pipeline_layout = device.create_pipeline_layout(&wgpu::PipelineLayoutDescriptor { + label: Some("Section culling"), + bind_group_layouts: &[Some(&layout)], + ..Default::default() + }); + let pipeline = device.create_render_pipeline(&wgpu::RenderPipelineDescriptor { + label: Some("Section culling"), + layout: Some(&pipeline_layout), + vertex: wgpu::VertexState { + module: &module, + entry_point: Some("vs_box"), + compilation_options: Default::default(), + buffers: &[], + }, + primitive: wgpu::PrimitiveState { + cull_mode: Some(wgpu::Face::Back), + ..Default::default() + }, + // The world pass's reversed depth test, without writes. + 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: &module, + entry_point: Some("fs_box"), + compilation_options: Default::default(), + targets: &[Some(wgpu::ColorTargetState { + format: color, + blend: None, + write_mask: wgpu::ColorWrites::empty(), + })], + }), + multiview_mask: None, + cache: None, + }); + Self { + pipeline, + layout, + group: None, + params: buffer( + device, + "Section culling parameters", + std::mem::size_of::<Params>() as u64, + wgpu::BufferUsages::UNIFORM | wgpu::BufferUsages::COPY_DST, + ), + phase2: buffer(device, "Section draws, phase 2", WORDS, PHASE2_USAGE), + phase2_capacity: 1, + tests: buffer(device, "Section tests", 16, TESTS_USAGE), + tests_capacity: 1, + test_data: Vec::new(), + test_slots: Vec::new(), + test_indices: Vec::new(), + total: 0, + probe: false, + results: buffer(device, "Section test results", 4, RESULTS_USAGE), + readbacks: (0..READBACKS) + .map(|_| Readback { + buffer: buffer(device, "Section test readback", 4, READBACK_USAGE), + capacity: 1, + state: Arc::new(AtomicU8::new(FREE)), + stamp: 0, + slots: Vec::new(), + indices: Vec::new(), + total: 0, + }) + .collect(), + next: 0, + current: None, + seen: Vec::new(), + stamp: 0, + hidden: ([0; 2], 1.0), + always: false, + } + } + + /// Start a frame: take in the results that came back, and tell whether + /// the frame culls. + pub fn begin(&mut self, device: &wgpu::Device) -> bool { + let _ = device.poll(wgpu::PollType::Poll); + for i in 0..READBACKS { + let r = &mut self.readbacks[(self.next + i) % READBACKS]; + if r.state.load(Ordering::Acquire) != MAPPED { + continue; + } + let mapped = r.buffer.slice(..r.slots.len() as u64 * 4); + if let Ok(data) = mapped.get_mapped_range() { + let results: &[u32] = bytemuck::cast_slice(&data); + let (mut hidden, mut indices) = (0, 0u64); + for (&result, &n) in results.iter().zip(&r.indices) { + if result != r.stamp { + hidden += 1; + indices += u64::from(n); + } + } + let share = indices as f32 / r.total.max(1) as f32; + self.hidden = ([hidden, results.len()], share); + for (&slot, &result) in r.slots.iter().zip(results) { + let slot = slot as usize; + if slot >= self.seen.len() { + self.seen.resize(slot + 1, false); + } + self.seen[slot] = result == r.stamp; + } + } + r.buffer.unmap(); + r.state.store(FREE, Ordering::Release); + } + self.stamp = self.stamp.wrapping_add(1).max(1); + self.test_data.clear(); + self.test_slots.clear(); + self.test_indices.clear(); + self.total = 0; + self.probe = !self.always && self.hidden.1 < MIN_SHARE; + !self.probe || self.stamp.is_multiple_of(PROBE) + } + + /// Whether phase 1 draws the section in resident `slot`. + pub fn first(&self, slot: u32) -> bool { + self.seen.get(slot as usize).copied().unwrap_or(false) + } + + /// A section phase 1 draws, `index` in the visible list, with `indices` + /// solid indices: tested in turn. + pub fn drawn(&mut self, index: usize, slot: u32, indices: u32) { + self.total += u64::from(indices); + if indices > 0 && (self.probe || slot.wrapping_add(self.stamp).is_multiple_of(RETEST)) { + self.push([index as u32, 0, 0, 0], slot, indices); + } + } + + /// A section left to phase 2: its `draws` from phase 2's `first`. + pub fn deferred(&mut self, index: usize, slot: u32, first: usize, draws: usize, indices: u32) { + self.total += u64::from(indices); + if draws > 0 { + self.push([index as u32, first as u32, draws as u32, 0], slot, indices); + } + } + + fn push(&mut self, test: [u32; 4], slot: u32, indices: u32) { + self.test_data.push(test); + self.test_slots.push(slot); + self.test_indices.push(indices); + } + + /// Stage this frame's inputs: phase 2's draws, with instance counts of 0, + /// and the tests, which read the frame's camera-relative `origins` and + /// view projection (the start of `globals`). + pub fn upload( + &mut self, + device: &wgpu::Device, + uploads: &mut super::upload::Uploads, + encoder: &mut wgpu::CommandEncoder, + phase2: &[[u32; 5]], + origins: &wgpu::Buffer, + globals: &wgpu::Buffer, + ) { + let draws = phase2.len() as u64; + if draws > self.phase2_capacity { + self.phase2_capacity = draws.next_power_of_two(); + self.phase2 = buffer( + device, + "Section draws, phase 2", + self.phase2_capacity * WORDS, + PHASE2_USAGE, + ); + self.group = None; + } + let tests = self.test_data.len() as u64; + if tests > self.tests_capacity { + self.tests_capacity = tests.next_power_of_two(); + self.tests = buffer( + device, + "Section tests", + self.tests_capacity * 16, + TESTS_USAGE, + ); + self.results = buffer( + device, + "Section test results", + self.tests_capacity * 4, + RESULTS_USAGE, + ); + self.group = None; + } + if draws > 0 { + uploads.buffer(encoder, &self.phase2, 0, bytemuck::cast_slice(phase2)); + } + if tests > 0 { + uploads.buffer( + encoder, + &self.tests, + 0, + bytemuck::cast_slice(&self.test_data), + ); + } + let params = Params { + stamp: self.stamp, + big: BIG, + pad: [0; 2], + }; + uploads.buffer(encoder, &self.params, 0, bytemuck::bytes_of(¶ms)); + if !self + .group + .as_ref() + .is_some_and(|g| g.origins == *origins && g.globals == *globals) + { + self.group = Some(self.make_group(device, origins, globals)); + } + } + + /// In the world pass after phase 1: draw the tested boxes against its + /// depth. Leaves the pass's pipeline and group 0 changed. + pub fn test(&self, pass: &mut wgpu::RenderPass<'_>) { + let Some(Group { group, .. }) = &self.group else { + return; + }; + if self.test_data.is_empty() { + return; + } + pass.set_pipeline(&self.pipeline); + pass.set_bind_group(0, group, &[]); + pass.draw(0..36, 0..self.test_data.len() as u32); + } + + /// After the world passes: copy the results for reading back, when a + /// readback buffer is free. + pub fn end(&mut self, device: &wgpu::Device, encoder: &mut wgpu::CommandEncoder) { + let tests = self.test_data.len() as u64; + let r = &mut self.readbacks[self.next]; + if tests == 0 || r.state.load(Ordering::Acquire) != FREE { + return; + } + if tests > r.capacity { + r.capacity = tests.next_power_of_two(); + r.buffer = buffer( + device, + "Section test readback", + r.capacity * 4, + READBACK_USAGE, + ); + } + encoder.copy_buffer_to_buffer(&self.results, 0, &r.buffer, 0, tests * 4); + r.stamp = self.stamp; + r.slots.clear(); + r.slots.extend_from_slice(&self.test_slots); + r.indices.clear(); + r.indices.extend_from_slice(&self.test_indices); + r.total = self.total; + self.current = Some(self.next); + } + + /// After the frame's submission: start reading its results back. + pub fn submitted(&mut self) { + let Some(i) = self.current.take() else { + return; + }; + let r = &self.readbacks[i]; + let state = r.state.clone(); + state.store(PENDING, Ordering::Release); + r.buffer + .slice(..r.slots.len() as u64 * 4) + .map_async(wgpu::MapMode::Read, move |result| { + state.store( + if result.is_ok() { MAPPED } else { FREE }, + Ordering::Release, + ); + }); + self.next = (i + 1) % READBACKS; + } + + fn make_group( + &self, + device: &wgpu::Device, + origins: &wgpu::Buffer, + globals: &wgpu::Buffer, + ) -> Group { + fn whole(binding: u32, buffer: &wgpu::Buffer) -> wgpu::BindGroupEntry<'_> { + wgpu::BindGroupEntry { + binding, + resource: buffer.as_entire_binding(), + } + } + let group = device.create_bind_group(&wgpu::BindGroupDescriptor { + label: Some("Section culling"), + layout: &self.layout, + entries: &[ + whole(0, &self.tests), + whole(1, &self.results), + whole(2, &self.phase2), + whole(3, origins), + wgpu::BindGroupEntry { + binding: 4, + resource: wgpu::BindingResource::Buffer(wgpu::BufferBinding { + buffer: globals, + offset: 0, + size: NonZeroU64::new(64), + }), + }, + whole(5, &self.params), + ], + }); + Group { + origins: origins.clone(), + globals: globals.clone(), + group, + } + } +} + +#[cfg(test)] +mod tests { + #[test] + fn shader_validates() { + let module = naga::front::wgsl::parse_str(include_str!("cull.wgsl")).unwrap(); + naga::valid::Validator::new( + naga::valid::ValidationFlags::all(), + naga::valid::Capabilities::all(), + ) + .validate(&module) + .unwrap(); + } +} diff --git a/crates/horizon-client/src/gfx/cull.wgsl b/crates/horizon-client/src/gfx/cull.wgsl new file mode 100644 index 000000000..faa495caf --- /dev/null +++ b/crates/horizon-client/src/gfx/cull.wgsl @@ -0,0 +1,101 @@ +// Occlusion culling of solid section draws (gfx/cull.rs). + +struct Params { + // This frame's test: a test that sees its box stores the number. + stamp: u32, + // Boxes covering more than this share of the screen count as seen. + big: f32, +} +// The leading member of terrain.wgsl's Globals. +struct Globals { + view_proj: mat4x4<f32>, +} + +// One test per section: its visible index (which names its origin), its +// first draw in `phase2` and how many draws it has there (0: phase 1 drew +// it, and the test only tells whether it is still in sight). +@group(0) @binding(0) var<storage, read> tests: array<vec4<u32>>; +// Per test: the stamp of the frame whose test saw the box. +@group(0) @binding(1) var<storage, read_write> results: array<u32>; +// Phase 2's draws, 5 words each, with instance counts of 0 until seen. +@group(0) @binding(2) var<storage, read_write> phase2: array<u32>; +// Camera-relative origin of each visible section. +@group(0) @binding(3) var<storage, read> origins: array<vec4<f32>>; +@group(0) @binding(4) var<uniform> globals: Globals; +@group(0) @binding(5) var<uniform> params: Params; + +// The corners (bit 0: x, bit 1: y, bit 2: z) of the box's 12 triangles, +// counter-clockwise seen from outside. +const CORNERS = array<u32, 36>( + 0u, 6u, 2u, 0u, 4u, 6u, 1u, 3u, 7u, 1u, 7u, 5u, 0u, 1u, 5u, 0u, 5u, 4u, + 2u, 7u, 3u, 2u, 6u, 7u, 0u, 3u, 1u, 0u, 2u, 3u, 4u, 5u, 7u, 4u, 7u, 6u, +); + +struct Box { + @builtin(position) position: vec4<f32>, + @location(0) @interpolate(flat) test: u32, +} + +fn corner(origin: vec3<f32>, c: u32) -> vec3<f32> { + return origin + vec3( + select(-1.0, 17.0, (c & 1u) != 0u), + select(-1.0, 17.0, (c & 2u) != 0u), + select(-1.0, 17.0, (c & 4u) != 0u), + ); +} + +// Each tested section's box, grown by a block (block models reach one block +// out of their cell), drawn after phase 1 against its depth with back faces +// culled: a front face fragment that passes the depth test is the box's +// nearest point on that pixel in front of phase 1's depth, so the section +// may show there. A box failing everywhere would have every fragment of its +// section fail the depth test against the final depth, which is only nearer. +@vertex +fn vs_box(@builtin(vertex_index) v: u32, @builtin(instance_index) t: u32) -> Box { + let origin = origins[tests[t].x].xyz; + var out: Box; + out.test = t; + // The box's screen rectangle, from the corners in front of the camera. + var lo = vec2(1e30); + var hi = vec2(-1e30); + var behind = false; + for (var c = 0u; c < 8u; c++) { + let p = globals.view_proj * vec4(corner(origin, c), 1.0); + behind = behind || p.w <= 0.0; + let q = p.xy / max(p.w, 1e-6); + lo = min(lo, q); + hi = max(hi, q); + } + let size = max(min(hi, vec2(1.0)) - max(lo, vec2(-1.0)), vec2(0.0)); + // A box within a block of the camera may cross the near plane, which + // clips its front faces away, and a box over a large part of the screen + // is nearly always in sight and costly to test: both count as seen, + // through a small triangle in the top left corner at the nearest depth. + let near = all(origin < vec3(2.0)) && all(origin > vec3(-18.0)); + if near || (!behind && size.x * size.y > params.big * 4.0) { + var p = vec2(-1.0, 1.0); + if v == 1u { + p.y -= 0.05; + } else if v == 2u { + p.x += 0.05; + } + out.position = select(vec4(0.0, 0.0, 0.0, 1.0), vec4(p, 1.0, 1.0), v < 3u); + return out; + } + out.position = globals.view_proj * vec4(corner(origin, CORNERS[v]), 1.0); + return out; +} + +// Runs only for fragments that pass the depth test (forced early). +@fragment +@early_depth_test(force) +fn fs_box(in: Box) -> @location(0) vec4<f32> { + if results[in.test] != params.stamp { + results[in.test] = params.stamp; + let test = tests[in.test]; + for (var k = 0u; k < test.z; k++) { + phase2[(test.y + k) * 5u + 1u] = 1u; + } + } + return vec4(0.0); +}