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 001/112] 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 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 002/112] 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 003/112] 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 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 004/112] 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 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 005/112] 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 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 006/112] 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 007/112] 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 008/112] 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 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 009/112] 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 010/112] 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 011/112] 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 012/112] 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 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 013/112] 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 c1211b2245e452ffd2664b87b74f2edac323cbb6 Mon Sep 17 00:00:00 2001 From: LookImEcho-Rick <62575172+LookImEcho-Rick@users.noreply.github.com> Date: Sat, 17 Oct 2026 21:08:53 -0500 Subject: [PATCH 014/112] Fix execute source dimension for player teleports --- .../horizon-client/src/game/command_blocks.rs | 2 +- crates/horizon-client/src/game/commands.rs | 47 +++++++++++++++++-- .../src/game/commands/execute.rs | 38 ++++++++------- .../horizon-client/src/game/commands/place.rs | 4 +- .../horizon-client/src/game/nether_portal.rs | 21 +++++++-- tools/command_exec_corpus.py | 22 +++++++++ 6 files changed, 108 insertions(+), 26 deletions(-) diff --git a/crates/horizon-client/src/game/command_blocks.rs b/crates/horizon-client/src/game/command_blocks.rs index 5a5fa11c8..434c72e72 100644 --- a/crates/horizon-client/src/game/command_blocks.rs +++ b/crates/horizon-client/src/game/command_blocks.rs @@ -356,7 +356,7 @@ impl Game<'_> { eyes: false, silent: false, store: None, - elsewhere: false, + dimension: self.dim, 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 1995efbf4..aca4d3002 100644 --- a/crates/horizon-client/src/game/commands.rs +++ b/crates/horizon-client/src/game/commands.rs @@ -231,8 +231,8 @@ impl Game<'_> { .ok_or_else(|| err("argument.pos.missing.int", &[]))?; // BlockPos.containing(getPosition) let p = self.resolve_coords(&c).map(|v| v.floor() as i32); - let elsewhere = self.command_source.is_some_and(|s| s.elsewhere); - if elsewhere || !self.world.chunks.contains_key(&(p[0] >> 4, p[2] >> 4)) { + let dimension = self.command_source.map_or(self.dim, |s| s.dimension); + if dimension != self.dim || !self.world.chunks.contains_key(&(p[0] >> 4, p[2] >> 4)) { return Err(err("argument.pos.unloaded", &[])); } if p[1] < horizon_client::chunk::MIN_Y @@ -1056,6 +1056,42 @@ impl Game<'_> { Target::Frame(_) | Target::Painting(_) => {} } } + /// Teleport the local player into the command source's dimension. Unlike + /// portal travel, `/tp` keeps the coordinates given by the command. + fn teleport_player_to_dimension( + &mut self, + dimension: Dim, + pos: [f64; 3], + rotation: Option<[f32; 2]>, + ) -> R<()> { + let Some(mut player) = self.player.take() else { + return Ok(()); + }; + let from = self.dim; + if self.switch_level(dimension, player.position).is_err() { + self.player = Some(player); + return Err(err("command.failed", &[])); + } + self.trigger_dimension(from, dimension); + let target = Vec3::new(pos[0], pos[1], pos[2]); + player.position = target; + player.velocity = Vec3::ZERO; + player.fall_distance = 0.0; + player.ground.on_ground = false; + if let Some([yaw, pitch]) = rotation { + let pitch = pitch.clamp(-90.0, 90.0); + self.yaw = yaw; + self.pitch = pitch; + player.yaw = yaw; + player.head_yaw = yaw; + player.pitch = pitch; + } + self.travelling = Some((player, target)); + self.portals.travel = None; + self.end_travel = false; + self.end_portal_travel = false; + Ok(()) + } fn cmd_teleport(&mut self, id: &str, ctx: &Context) -> R<i32> { let targets = if id.starts_with("teleport.targets") { self.entities(ctx, "targets", false)? @@ -1125,7 +1161,12 @@ impl Game<'_> { ]); } for &t in &targets { - self.teleport_to(t, pos, rotation); + let dimension = self.command_source.map_or(self.dim, |s| s.dimension); + if t == Target::Player && dimension != self.dim { + self.teleport_player_to_dimension(dimension, pos, rotation)?; + } else { + self.teleport_to(t, pos, rotation); + } } let [x, y, z] = pos.map(|v| Text::literal(format_double(v))); let message = if targets.len() == 1 { diff --git a/crates/horizon-client/src/game/commands/execute.rs b/crates/horizon-client/src/game/commands/execute.rs index 1fa67c8b6..9db5654d6 100644 --- a/crates/horizon-client/src/game/commands/execute.rs +++ b/crates/horizon-client/src/game/commands/execute.rs @@ -1,7 +1,7 @@ //! `/execute` (ExecuteCommand): walk the parsed redirect chain, forking and //! filtering command sources, then run the final command once per source, //! reporting each result to the `store` callbacks of its source. -use super::{Arg, Context, Game, R, Target, data::DataRef, err}; +use super::{Arg, Context, Dim, Game, R, Target, data::DataRef, err}; use horizon_client::{ command::{CommandError, vanilla}, nbt_path::NbtPath, @@ -23,9 +23,9 @@ pub(in crate::game) struct Source { pub silent: bool, /// Index of the newest `store` in `ExecState::stores`. pub store: Option<u32>, - /// `execute in` another dimension than the one Horizon has loaded: none - /// of its chunks are loaded. - pub elsewhere: bool, + /// The level this command source uses. Horizon has only this dimension's + /// chunks loaded in the single-player client. + pub dimension: Dim, /// The command block whose output this source is /// (`BaseCommandBlock.CloseableCommandBlockSource`). pub block: Option<(i32, i32, i32)>, @@ -76,7 +76,7 @@ impl Game<'_> { eyes: false, silent: false, store: None, - elsewhere: false, + dimension: self.dim, block: None, } } @@ -89,7 +89,7 @@ impl Game<'_> { eyes: false, silent: true, store: None, - elsewhere: false, + dimension: self.dim, block: None, } } @@ -440,7 +440,7 @@ impl Game<'_> { Some(Source { pos: self.target_position(t)?, rot: self.target_rotation(t), - elsewhere: false, + dimension: self.dim, ..s }) }) @@ -531,8 +531,8 @@ impl Game<'_> { ..s }], "in" => { - // Horizon keeps one dimension loaded: in another one, no - // chunk is loaded (as in vanilla without a player there). + // CommandSourceStack.withLevel scales the source position; + // absolute coordinates passed to /tp are unaffected. let Some(Arg::Resource(dim)) = c.get("dimension") else { return Ok(vec![s]); }; @@ -542,8 +542,12 @@ impl Game<'_> { ) { return Err(err("argument.dimension.invalid", &[dim])); } + let dimension = Dim::from_id(dim); + let coordinate_scale = |dim| if dim == Dim::Nether { 8.0 } else { 1.0 }; + let scale = coordinate_scale(s.dimension) / coordinate_scale(dimension); vec![Source { - elsewhere: dim != self.dim.id(), + pos: [s.pos[0] * scale, s.pos[1], s.pos[2] * scale], + dimension, ..s }] } @@ -785,14 +789,16 @@ impl Game<'_> { let p = self .coords(c, "pos") .map(|co| co.block(self.source_position(), self.source_rotation())); - return Ok(flag(p.is_some_and(|p| { - self.world.chunks.contains_key(&(p[0] >> 4, p[2] >> 4)) - }))); + let dimension = self.command_source.map_or(self.dim, |s| s.dimension); + return Ok(flag( + dimension == self.dim + && p.is_some_and(|p| self.world.chunks.contains_key(&(p[0] >> 4, p[2] >> 4))), + )); } if c.has("dimension") { - return Ok(flag( - matches!(c.get("dimension"), Some(Arg::Resource(d)) if d == self.dim.id()), - )); + let dimension = self.command_source.map_or(self.dim, |s| s.dimension); + return Ok(flag(matches!(c.get("dimension"), Some(Arg::Resource(d)) + if d.as_str() == dimension.id()))); } if c.has("block") { let p = self.block_pos_arg(c, "pos")?; diff --git a/crates/horizon-client/src/game/commands/place.rs b/crates/horizon-client/src/game/commands/place.rs index 3e447a7fb..9037304b0 100644 --- a/crates/horizon-client/src/game/commands/place.rs +++ b/crates/horizon-client/src/game/commands/place.rs @@ -79,10 +79,10 @@ impl Game<'_> { } /// `PlaceCommand.checkLoaded`: every chunk of the inclusive range. fn place_check_loaded(&self, min: [i32; 2], max: [i32; 2]) -> R<()> { - let elsewhere = self.command_source.is_some_and(|s| s.elsewhere); + let dimension = self.command_source.map_or(self.dim, |s| s.dimension); for cx in min[0]..=max[0] { for cz in min[1]..=max[1] { - if elsewhere || !self.world.chunks.contains_key(&(cx, cz)) { + if dimension != self.dim || !self.world.chunks.contains_key(&(cx, cz)) { return Err(err("argument.pos.unloaded", &[])); } } diff --git a/crates/horizon-client/src/game/nether_portal.rs b/crates/horizon-client/src/game/nether_portal.rs index 9ff9e8421..582092f57 100644 --- a/crates/horizon-client/src/game/nether_portal.rs +++ b/crates/horizon-client/src/game/nether_portal.rs @@ -352,10 +352,23 @@ impl Game<'_> { ) -> Result<()> { self.resolve_arrivals(); let plan = self.portals.travel.take(); - let exit = plan.as_ref().and_then(|plan| self.nether_exit_portal(plan)); - let (position, rotation) = match (plan, exit) { - (Some(plan), Some(exit)) => self.arrival(&plan, exit), - _ => (target, 0.0), + let Some(plan) = plan else { + // A command teleport can change dimensions without going through + // a portal. It has no portal placement, rotation, or sound effect. + player.position = target; + player.velocity = Vec3::ZERO; + player.fall_distance = 0.0; + self.previous_position = target; + self.player = Some(player); + self.pad.player_replaced(); + self.sway = Default::default(); + self.apply_equipment(); + return Ok(()); + }; + let exit = self.nether_exit_portal(&plan); + let (position, rotation) = match exit { + Some(exit) => self.arrival(&plan, exit), + None => (target, 0.0), }; player.position = position; // Relative.ROTATION and Relative.DELTA: the yaw turns, the motion diff --git a/tools/command_exec_corpus.py b/tools/command_exec_corpus.py index eb99e1f1a..4b9d9b9e6 100644 --- a/tools/command_exec_corpus.py +++ b/tools/command_exec_corpus.py @@ -391,6 +391,28 @@ def execute(): *setup('/kill @e[type=minecraft:armor_stand]', '/setblock 4 210 4 minecraft:air', '/setblock 5 210 5 minecraft:air', '/scoreboard objectives remove exec', '/tp @s 8.5 230 8.5 0 0'), {'op': 'tick', 'n': 25}, + *setup('/gamemode spectator'), + cmd('/execute in minecraft:the_nether if dimension minecraft:the_nether run say source dimension'), + cmd('/execute in minecraft:the_nether at @s if dimension minecraft:overworld run say entity dimension'), + cmd('/execute in minecraft:the_nether positioned as @s if dimension minecraft:the_nether run say position only'), + cmd('/execute in minecraft:the_nether if loaded 0 100 0'), + cmd('/execute in minecraft:the_nether run tp @s 0 100 0'), + {'op': 'settle'}, + cmd('/execute if dimension minecraft:the_nether run say dimension switched'), + cmd('/data get entity @s Pos'), + cmd('/execute in minecraft:the_nether positioned 80 100 -40 in minecraft:overworld run tp @s ~ ~ ~'), + {'op': 'settle'}, + cmd('/execute if dimension minecraft:overworld run say relative dimension'), + cmd('/data get entity @s Pos'), + cmd('/execute in minecraft:overworld positioned 80 100 -40 in minecraft:the_nether run tp @s ~ ~ ~ 45 30'), + {'op': 'settle'}, + cmd('/data get entity @s Pos'), + cmd('/data get entity @s Rotation'), + cmd('/execute in minecraft:overworld run tp @s 8.5 230 8.5'), + {'op': 'settle'}, + cmd('/execute if dimension minecraft:overworld run say dimension restored'), + cmd('/data get entity @s Pos'), + *setup('/gamemode creative'), ] 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 015/112] Rerun CI now that the PR is ready for review 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 016/112] 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 017/112] 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 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 018/112] 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 019/112] 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 020/112] 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 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 021/112] 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 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 022/112] 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 023/112] 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 024/112] 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 025/112] 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 026/112] 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 027/112] 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 028/112] 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 029/112] 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 030/112] 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 031/112] 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 032/112] 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 033/112] 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 034/112] 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 035/112] 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 036/112] 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 037/112] 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 038/112] 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 039/112] 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 040/112] 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 041/112] 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 042/112] 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 043/112] 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 044/112] 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 045/112] 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 046/112] 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 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 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 047/112] 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 048/112] 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 049/112] 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 050/112] 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 051/112] 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 052/112] 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 053/112] 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 054/112] 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 055/112] 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 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⋙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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 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�>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 056/112] 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 057/112] 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 058/112] 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 059/112] 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 060/112] 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 061/112] 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 062/112] 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 063/112] 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 064/112] 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 065/112] 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 066/112] 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 067/112] 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 068/112] 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 069/112] 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 070/112] 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 071/112] 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 072/112] 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 073/112] 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 074/112] 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 075/112] 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 076/112] 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 077/112] 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 078/112] 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 079/112] 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 080/112] 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 081/112] 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 082/112] 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 083/112] 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 084/112] 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 085/112] 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 086/112] 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 087/112] 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 088/112] 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 089/112] 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 090/112] 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 091/112] 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 092/112] 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 093/112] 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 094/112] 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 095/112] 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 096/112] 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); +} From 745c756df52db1be9dc8ba0d601dc0a211fd5f12 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Mon, 19 Oct 2026 00:21:20 +0100 Subject: [PATCH 097/112] perf(worldgen): cache carver biomes per worker --- .../horizon-world/src/worldgen/generator.rs | 68 ++++++++++++++++++- 1 file changed, 66 insertions(+), 2 deletions(-) diff --git a/crates/horizon-world/src/worldgen/generator.rs b/crates/horizon-world/src/worldgen/generator.rs index 7b73d35a8..75c3b3a6b 100644 --- a/crates/horizon-world/src/worldgen/generator.rs +++ b/crates/horizon-world/src/worldgen/generator.rs @@ -906,7 +906,15 @@ where Ok(chunk) } fn carver_biome(&self, worker: &mut WorkerState, origin: ChunkPos) -> Result<BiomeId, String> { - if let Some(id) = self.carver_cache.lock().unwrap().get(&(origin.x, origin.z)) { + let key = (origin.x, origin.z); + if let Some(id) = worker.carver_biomes.get(&key) { + return Ok(*id); + } + if worker.carver_biomes.len() >= 4096 { + worker.carver_biomes.clear(); + } + if let Some(id) = self.carver_cache.lock().unwrap().get(&key) { + worker.carver_biomes.insert(key, *id); return Ok(*id); } let mut resolver = self.source.resolver( @@ -926,7 +934,8 @@ where if cache.len() >= CACHE_LIMIT * 4 { cache.clear(); } - cache.insert((origin.x, origin.z), id); + cache.insert(key, id); + worker.carver_biomes.insert(key, id); Ok(id) } fn generate( @@ -1393,6 +1402,9 @@ pub(super) struct WorkerState { pub(super) temperatures: Vec<BiomeTemperature>, biome_context: SamplerContext, carver_context: SamplerContext, + /// Seed/dimension-bound lookups avoid the shared mutex for overlapping + /// carver neighborhoods. Bounded independently of the shared cache. + carver_biomes: HashMap<(i32, i32), BiomeId>, timings: StageTimings, heights: HashMap<(i32, i32, u8), i32>, /// Decorate with structure pieces only (for structure parity checks). @@ -1868,6 +1880,7 @@ impl OverworldGenerator { .collect(), biome_context: SamplerContext::cached(), carver_context: SamplerContext::default(), + carver_biomes: HashMap::new(), timings: StageTimings::default(), structures_only: false, heights: HashMap::new(), @@ -1947,6 +1960,57 @@ impl GeneratorWorker { mod tests { use super::*; + #[test] + fn local_carver_cache_is_worker_owned_and_eviction_preserves_terrain() { + let root = std::env::var_os("HORIZON_RESOURCES") + .map(std::path::PathBuf::from) + .unwrap_or_else(|| { + Path::new(env!("CARGO_MANIFEST_DIR")).join("../../.local/horizon-client/26.3") + }); + if !root.join("worldgen/world_presets.json").exists() { + eprintln!("skipping: no worldgen bundle at {}", root.display()); + return; + } + let registry = Box::leak(Box::new( + crate::level::data::load_registry(&root).expect("registry"), + )); + let data = GeneratorData::load(&root.join("worldgen"), registry).unwrap(); + let generator = OverworldGenerator::new(data.clone(), 12345).unwrap(); + let mut first = generator.worker(); + let mut second = generator.worker(); + let pos = ChunkPos::new(0, 0); + let before = first.generate_proto(pos).unwrap(); + assert!(!first.state.carver_biomes.is_empty()); + assert!(second.state.carver_biomes.is_empty()); + second.generate_proto(pos).unwrap(); + assert_eq!(first.state.carver_biomes, second.state.carver_biomes); + let expected = first.state.carver_biomes.clone(); + first.state.carver_biomes.clear(); + // Fill unrelated origins to force eviction on the next local miss. + for x in 0..4096 { + first.state.carver_biomes.insert((x, 100_000), BiomeId(0)); + } + let after = first.generate_proto(pos).unwrap(); + assert_eq!(first.state.carver_biomes, expected); + for y in -64..320 { + for z in 0..16 { + for x in 0..16 { + assert_eq!(before.block(x, y, z), after.block(x, y, z)); + assert_eq!(before.biome_id_at(x, y, z), after.biome_id_at(x, y, z)); + } + } + } + assert!( + OverworldGenerator::new(data, -1) + .unwrap() + .worker() + .state + .carver_biomes + .is_empty() + ); + assert_eq!(second.state.carver_biomes, expected); + } + /// Generators of one seed and dimension share their ring positions; /// another seed or generator gets its own, and old entries go. #[test] From 08c77ad78534e5079fed9ba152e1b2d27142b0bf Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Mon, 19 Oct 2026 00:15:22 +0200 Subject: [PATCH 098/112] Spawn mobs around every player, and despawn from the nearest of them Natural spawning returned without a local player, so a dedicated or --server-thread server spawned no mobs and a LAN host spawned them only around itself. ServerChunkCache.tickChunks now takes its spawning chunks from every player in the level (ChunkMap.collectSpawningChunks), the global caps from the natural spawn chunk tracker's size, and the local caps from each player (LocalMobCapCalculator). Inhabited time and thunder follow the same chunks (tickSpawningChunk), the wandering trader picks a random living player (getRandomPlayer), and mobs despawn by their distance to the nearest non-spectator of any kind. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../horizon-client/examples/mob_ai_probe.rs | 1 + crates/horizon-client/src/game/creatures.rs | 32 ++-- crates/horizon-client/src/game/lightning.rs | 8 +- .../src/game/natural_spawning.rs | 177 ++++++++++++++---- .../src/game/wandering_trader.rs | 25 ++- crates/horizon-client/src/mobs.rs | 3 + crates/horizon-client/src/mobs/ai.rs | 6 +- 7 files changed, 179 insertions(+), 73 deletions(-) diff --git a/crates/horizon-client/examples/mob_ai_probe.rs b/crates/horizon-client/examples/mob_ai_probe.rs index 0b3adec31..2a4969221 100644 --- a/crates/horizon-client/examples/mob_ai_probe.rs +++ b/crates/horizon-client/examples/mob_ai_probe.rs @@ -1024,6 +1024,7 @@ fn main() -> horizon_client::Result<()> { collision: &collision, data: &data, player: player.clone(), + nearest_player: player.as_ref().filter(|p| !p.spectator).map(|p| p.position), others: $snapshot, others_grid: $grid, daylight: (world.day_time.rem_euclid(24000)) < 12000, diff --git a/crates/horizon-client/src/game/creatures.rs b/crates/horizon-client/src/game/creatures.rs index 422d050b6..d82e8a5aa 100644 --- a/crates/horizon-client/src/game/creatures.rs +++ b/crates/horizon-client/src/game/creatures.rs @@ -377,6 +377,7 @@ impl Game<'_> { } pub(super) fn mob_world_base<'s>(&'s self, others: &'s [Seen]) -> MobWorld<'s> { let (rain, thunder) = self.world.weather.levels(1.0); + let player = self.player_view(); MobWorld { world: &self.world, registry: self.pack.assets.registry, @@ -384,7 +385,8 @@ impl Game<'_> { movement: &self.motion.blocks, collision: self.collision, data: self.res.mob_data(), - player: self.player_view(), + nearest_player: player.as_ref().filter(|p| !p.spectator).map(|p| p.position), + player, others, others_grid: None, daylight: self.dim != Dim::Nether && self.sky_darken() < 4, @@ -429,25 +431,6 @@ impl Game<'_> { }; spawning::LocalDifficulty::new(base, self.world.day_time, inhabited, moon) } - /// `ServerChunkCache.tickSpawningChunk`: chunks whose centre is within - /// 128 blocks of the player gain inhabited time. - fn tick_inhabited(&mut self) { - let Some(p) = self.player.as_ref().map(|p| p.position) else { - return; - }; - let (pcx, pcz) = (p.x.floor() as i32 >> 4, p.z.floor() as i32 >> 4); - for dx in -8..=8 { - for dz in -8..=8 { - let key = (pcx + dx, pcz + dz); - let (cx, cz) = (f64::from(key.0 * 16 + 8), f64::from(key.1 * 16 + 8)); - if (cx - p.x).powi(2) + (cz - p.z).powi(2) < 128.0 * 128.0 - && self.world.chunks.contains_key(&key) - { - *self.world.inhabited.entry(key).or_insert(0) += 1; - } - } - } - } /// Advance every mob one tick, then apply their events. pub(super) fn tick_creatures(&mut self) -> Result<()> { self.attack_ticks = self.attack_ticks.saturating_add(1); @@ -464,7 +447,6 @@ impl Game<'_> { } self.spawn_generation_creatures(key.0, key.1); } - self.tick_inhabited(); self.tick_leads(); self.spawn_natural(); // ServerChunkCache.tickChunks: the custom spawners tick only with spawn_mobs. @@ -505,6 +487,7 @@ impl Game<'_> { let ticking = self.entity_ticking_area(); // With guests on, each mob sees its nearest player (game/lan_mobs.rs). let guests = self.lan_guest_views(); + let players = self.level_players(); let mut bindings = match self.lan.as_mut() { Some(host) if !guests.is_empty() => std::mem::take(&mut host.mob_players), _ => Default::default(), @@ -523,6 +506,13 @@ impl Game<'_> { let mut w = self.mob_world_base(&snapshot); w.others_grid = Some(&grid); let m = &mut mobs[i]; + w.nearest_player = super::natural_spawning::nearest_player( + &players, + m.position.x, + m.position.y, + m.position.z, + ) + .map(|p| p.position); let seen_guest = if guests.is_empty() { None } else { diff --git a/crates/horizon-client/src/game/lightning.rs b/crates/horizon-client/src/game/lightning.rs index 7b480a8e6..6c4dd933f 100644 --- a/crates/horizon-client/src/game/lightning.rs +++ b/crates/horizon-client/src/game/lightning.rs @@ -24,14 +24,18 @@ pub(super) struct Bolt { converted: Vec<u32>, } impl Game<'_> { - /// One `tickThunder` roll per loaded chunk. + /// `ServerChunkCache.tickSpawningChunk`: one `tickThunder` roll per + /// spawning chunk (within 128 blocks of a player) that is in entity + /// ticking range. pub(super) fn tick_thunder(&mut self) { // isRaining (rain level > 0.2) and isThundering (> 0.9, sky light, no ceiling). let (rain, thunder) = self.world.weather.levels(1.0); if rain <= 0.2 || thunder <= 0.9 || self.dim != super::Dim::Overworld { return; } - let chunks: Vec<(i32, i32)> = self.world.chunks.keys().copied().collect(); + let (_, mut chunks) = self.spawning_chunks(&self.level_players()); + let levels = self.tickets.levels(); + chunks.retain(|&(x, z)| levels.random_ticking(x, z)); for (cx, cz) in chunks { if self.world.random.next_int_bound(100_000).unwrap_or(1) != 0 { continue; diff --git a/crates/horizon-client/src/game/natural_spawning.rs b/crates/horizon-client/src/game/natural_spawning.rs index 059437d7b..9bf7023af 100644 --- a/crates/horizon-client/src/game/natural_spawning.rs +++ b/crates/horizon-client/src/game/natural_spawning.rs @@ -23,10 +23,54 @@ use horizon_core::{ use horizon_world::registry::BlockStateId; use std::collections::HashMap; +/// A player in the level in place, as spawning and despawning see it. +pub(super) struct LevelPlayer { + pub(super) position: Vec3, + pub(super) bounds: Aabb, + pub(super) alive: bool, + pub(super) creative: bool, + pub(super) spectator: bool, +} +impl LevelPlayer { + fn distance_sqr(&self, x: f64, y: f64, z: f64) -> f64 { + (self.position.x - x).powi(2) + + (self.position.y - y).powi(2) + + (self.position.z - z).powi(2) + } +} +/// `ChunkMap.euclideanDistanceSquared` below 128 blocks +/// (`playerIsCloseEnoughForSpawning`). +fn close_enough_for_spawning(p: &LevelPlayer, (cx, cz): (i32, i32)) -> bool { + let (x, z) = ( + f64::from(cx * 16 + 8) - p.position.x, + f64::from(cz * 16 + 8) - p.position.z, + ); + !p.spectator && x * x + z * z < 16384.0 +} +/// `EntityGetter.getNearestPlayer(x, y, z, -1, false)`: the nearest +/// non-spectator, alive or not. +pub(super) fn nearest_player( + players: &[LevelPlayer], + x: f64, + y: f64, + z: f64, +) -> Option<&LevelPlayer> { + let mut best: Option<(&LevelPlayer, f64)> = None; + for p in players.iter().filter(|p| !p.spectator) { + let d = p.distance_sqr(x, y, z); + if best.is_none_or(|(_, b)| d < b) { + best = Some((p, d)); + } + } + best.map(|(p, _)| p) +} + /// The game level as natural spawning reads it. pub(super) struct GameLevel<'g, 'a> { pub(super) game: &'g Game<'a>, pub(super) w: MobWorld<'g>, + /// Every player in the level ([`Game::level_players`]). + pub(super) players: Vec<LevelPlayer>, /// Boxes of the mobs this pass created, not yet in the game's list. pub(super) pending: std::cell::RefCell<Vec<Aabb>>, /// The types and boxes of what a spawner created this tick. @@ -84,8 +128,11 @@ impl SpawnLevel for GameLevel<'_, '_> { fn world_seed(&self) -> i64 { self.w.world_seed } + /// `getNearestPlayer(x, y, z, distance, true)`, over every player. fn player_near(&self, x: f64, y: f64, z: f64, distance: f64) -> bool { - self.w.player_near(x, y, z, distance) + self.players.iter().any(|p| { + p.alive && !p.creative && !p.spectator && p.distance_sqr(x, y, z) < distance * distance + }) } } impl NaturalLevel for GameLevel<'_, '_> { @@ -138,12 +185,7 @@ impl NaturalLevel for GameLevel<'_, '_> { StructureSpawns::shared(&self.game.options.resources) } fn nearest_player_distance_sqr(&self, x: f64, y: f64, z: f64) -> Option<f64> { - let p = self.game.player.as_ref()?; - if self.game.spectator() { - return None; - } - let d = [p.position.x - x, p.position.y - y, p.position.z - z]; - Some(d[0] * d[0] + d[1] * d[1] + d[2] * d[2]) + nearest_player(&self.players, x, y, z).map(|p| p.distance_sqr(x, y, z)) } fn respawn(&self) -> Option<[i32; 3]> { // The world spawn point lives in the overworld. @@ -184,9 +226,9 @@ impl NaturalLevel for GameLevel<'_, '_> { } fn unobstructed(&self, bounds: Aabb) -> bool { let player = self - .game - .player_view() - .is_some_and(|p| p.alive && !p.spectator && p.bounds.intersects(bounds)); + .players + .iter() + .any(|p| p.alive && !p.spectator && p.bounds.intersects(bounds)); !player && !self.pending.borrow().iter().any(|b| b.intersects(bounds)) && !self @@ -221,17 +263,10 @@ impl NaturalLevel for GameLevel<'_, '_> { } } impl horizon_client::mobs::spawner::SpawnerLevel for GameLevel<'_, '_> { + /// `Level.hasNearbyAlivePlayer`, over every player. fn alive_player_near(&self, x: f64, y: f64, z: f64, range: f64) -> bool { - let Some(p) = self.game.player_view() else { - return false; - }; - if !p.alive || p.spectator { - return false; - } - let at = self.game.player.as_ref().map(|p| p.position); - at.is_some_and(|a| { - let d = (a.x - x).powi(2) + (a.y - y).powi(2) + (a.z - z).powi(2); - range < 0.0 || d < range * range + self.players.iter().any(|p| { + p.alive && !p.spectator && (range < 0.0 || p.distance_sqr(x, y, z) < range * range) }) } fn spawner_blocks_work(&self) -> bool { @@ -261,6 +296,7 @@ impl<'a> Game<'a> { GameLevel { game: self, w: self.mob_world_base(&[]), + players: self.level_players(), pending: Default::default(), pending_ids: Default::default(), } @@ -299,25 +335,82 @@ impl<'a> Game<'a> { } } } + /// Every player in the level in place: the local player, and the LAN + /// guests or server players in it. + pub(super) fn level_players(&self) -> Vec<LevelPlayer> { + let mut players: Vec<LevelPlayer> = self.lan.as_ref().map_or_else(Vec::new, |h| { + h.hub + .guests + .iter() + .filter(|g| h.hub.here(g)) + .map(|g| LevelPlayer { + position: Vec3::new(g.position[0], g.position[1], g.position[2]), + bounds: super::lan_mobs::guest_bounds(g), + alive: !g.dead, + creative: g.creative(), + spectator: g.spectator(), + }) + .collect() + }); + if let Some(p) = self.player_view() { + players.insert( + 0, + LevelPlayer { + position: p.position, + bounds: p.bounds, + alive: p.alive, + creative: p.creative, + spectator: p.spectator, + }, + ); + } + players + } + /// `ChunkMap.collectSpawningChunks`: the natural spawn chunk tracker's + /// chunks (within 8 chunks of a player, `getSpawnCandidateChunks`) that + /// are ticking and within 128 blocks of a non-spectator. Also returns how + /// many chunks the tracker holds (`getNaturalSpawnChunkCount`). + pub(super) fn spawning_chunks(&self, players: &[LevelPlayer]) -> (i32, Vec<(i32, i32)>) { + let mut candidates: Vec<(i32, i32)> = Vec::with_capacity(289 * players.len()); + let mut seen = horizon_client::fast_hash::FxHashSet::default(); + for p in players { + let (pcx, pcz) = ( + p.position.x.floor() as i32 >> 4, + p.position.z.floor() as i32 >> 4, + ); + for dx in -8..=8 { + for dz in -8..=8 { + let key = (pcx + dx, pcz + dz); + if seen.insert(key) { + candidates.push(key); + } + } + } + } + let count = candidates.len() as i32; + let levels = self.tickets.levels(); + candidates.retain(|&(cx, cz)| { + levels.loaded_ticking(cx, cz) + && super::ticking_chunk(&self.world, cx, cz) + && players + .iter() + .any(|p| close_enough_for_spawning(p, (cx, cz))) + }); + (count, candidates) + } /// `ServerChunkCache.tickChunks`: the spawn state over the loaded mobs, /// the categories under their global caps (creatures every 400 ticks), - /// then `spawnForChunk` in the shuffled chunks within 128 blocks of the - /// player. + /// then `tickSpawningChunk` in the shuffled spawning chunks of every + /// player: inhabited time, then `spawnForChunk`. pub(super) fn spawn_natural(&mut self) { - let Some(p) = self.player.as_ref().map(|p| p.position) else { + let players = self.level_players(); + if players.is_empty() { return; - }; - let (pcx, pcz) = (p.x.floor() as i32 >> 4, p.z.floor() as i32 >> 4); - // ChunkMap.collectSpawningChunks: tracked chunks whose centre is - // within 128 blocks of a non-spectator. - let spectator = self.spectator(); - let mut chunks: Vec<(i32, i32)> = (-8..=8) - .flat_map(|dx| (-8..=8).map(move |dz| (pcx + dx, pcz + dz))) - .filter(|&(cx, cz)| { - let (x, z) = (f64::from(cx * 16 + 8) - p.x, f64::from(cz * 16 + 8) - p.z); - !spectator && x * x + z * z < 16384.0 && self.world.chunks.contains_key(&(cx, cz)) - }) - .collect(); + } + let (spawnable, mut chunks) = self.spawning_chunks(&players); + for &key in &chunks { + *self.world.inhabited.entry(key).or_insert(0) += 1; + } let spawn_mobs = self.ui.rules.bool("spawn_mobs"); let spawn_enemies = self.ui.rules.bool("spawn_monsters"); let mut random = std::mem::replace(&mut self.world.random, LegacyRandom::new(0)); @@ -339,12 +432,14 @@ impl<'a> Game<'a> { persistent: m.persistent, }) .collect(); - let players = vec![SpawnPlayer { - position: [p.x, p.y, p.z], - spectator, - }]; - // A single player's natural spawn chunk tracker covers 17 x 17 chunks. - let mut state = SpawnState::new(&level, 289, players, &counted, |cx, cz| { + let players = players + .iter() + .map(|p| SpawnPlayer { + position: [p.position.x, p.position.y, p.position.z], + spectator: p.spectator, + }) + .collect(); + let mut state = SpawnState::new(&level, spawnable, players, &counted, |cx, cz| { self.world.chunks.contains_key(&(cx, cz)) }); let categories = if spawn_mobs { diff --git a/crates/horizon-client/src/game/wandering_trader.rs b/crates/horizon-client/src/game/wandering_trader.rs index d42ac662f..87ca5753b 100644 --- a/crates/horizon-client/src/game/wandering_trader.rs +++ b/crates/horizon-client/src/game/wandering_trader.rs @@ -6,7 +6,7 @@ use horizon_client::{ mobs::{Species, leash::Holder, spawning, trader}, save::{read_dat, write_dat}, }; -use horizon_core::random::RandomSource; +use horizon_core::{geometry::Vec3, random::RandomSource}; use horizon_world::nbt::Tag; const TICK_DELAY: i32 = 1200; @@ -83,10 +83,7 @@ impl Game<'_> { } /// `WanderingTraderSpawner.tick`. pub(super) fn tick_wandering_trader(&mut self) { - if self.dim != Dim::Overworld - || self.player.is_none() - || !self.ui.rules.bool("spawn_wandering_traders") - { + if self.dim != Dim::Overworld || !self.ui.rules.bool("spawn_wandering_traders") { return; } self.load_trader_data(); @@ -110,9 +107,23 @@ impl Game<'_> { } /// `WanderingTraderSpawner.spawn`. fn spawn_trader(&mut self) -> bool { - let Some(p) = self.player.as_ref().map(|p| p.position) else { + // ServerLevel.getRandomPlayer: one of the living players, drawn + // from the level random. + let alive: Vec<Vec3> = self + .level_players() + .into_iter() + .filter(|p| p.alive) + .map(|p| p.position) + .collect(); + if alive.is_empty() { return true; - }; + } + let pick = self + .world + .random + .next_int_bound(alive.len() as i32) + .unwrap_or(0); + let p = alive[pick as usize]; if self.world.random.next_int_bound(10).unwrap_or(1) != 0 { return false; } diff --git a/crates/horizon-client/src/mobs.rs b/crates/horizon-client/src/mobs.rs index 3fe743fab..c8155984c 100644 --- a/crates/horizon-client/src/mobs.rs +++ b/crates/horizon-client/src/mobs.rs @@ -1412,6 +1412,9 @@ pub struct MobWorld<'a> { pub collision: &'a BlockCollisionRegistry<'a>, pub data: &'a MobData, pub player: Option<PlayerView>, + /// `getNearestPlayer(mob, -1)`: where the nearest non-spectator of every + /// player in the level stands, alive or not (the despawn distance). + pub nearest_player: Option<Vec3>, pub others: &'a [Seen], /// `others` by position, when the caller keeps one (the mob ticks). pub others_grid: Option<&'a seen_grid::SeenGrid>, diff --git a/crates/horizon-client/src/mobs/ai.rs b/crates/horizon-client/src/mobs/ai.rs index 709a57619..34276ddda 100644 --- a/crates/horizon-client/src/mobs/ai.rs +++ b/crates/horizon-client/src/mobs/ai.rs @@ -1018,8 +1018,10 @@ pub fn despawn_check(m: &mut Mob, w: &MobWorld) -> bool { /// Mob.checkDespawn, before the tick (players are the only despawn /// reference). Returns false when the mob is discarded. fn check_despawn(m: &mut Mob, w: &MobWorld) -> bool { - let Some(p) = &w.player else { return true }; - let d = m.distance_sqr(p.position); + let Some(p) = w.nearest_player else { + return true; + }; + let d = m.distance_sqr(p); // requiresCustomPersistence: raiders in a raid, a tame nautilus, a sulfur // cube holding a block or let out of a bucket. let persistent = m.persistent From c755ca04f5bb1fae597841848479b362fff935e9 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Mon, 19 Oct 2026 00:31:12 +0200 Subject: [PATCH 099/112] Tick paintings, frames, boats, armor stands, falling blocks and TNT only in entity-ticking chunks ServerLevel.tick ticks an entity only where the chunk tickets make it entity ticking (inEntityTickingRange, and EntityTickList holds only the entities of entity-ticking chunks). Mobs, items and minecarts already checked it (#931); these six entity kinds ticked wherever they were loaded, so TNT went off and sand fell past the simulation distance. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game.rs | 5 +++++ crates/horizon-client/src/game/armor_stands.rs | 5 +++++ crates/horizon-client/src/game/boats.rs | 7 ++++++- crates/horizon-client/src/game/frames.rs | 7 +++++++ crates/horizon-client/src/game/paintings.rs | 8 ++++++++ crates/horizon-client/src/game/tnt.rs | 6 ++++++ 6 files changed, 37 insertions(+), 1 deletion(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 2cbdabaa4..772a26730 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -2594,7 +2594,12 @@ impl Game<'_> { let mut dropped = Vec::new(); let mut collision_error = None; let entity_drops = self.ui.rules.bool("entity_drops"); + // ServerLevel.tick: only entities in entity-ticking chunks tick. + let ticking = self.entity_ticking_area(); falling.retain_mut(|f| { + if !ticking(f.position.x.floor() as i32, f.position.z.floor() as i32) { + return true; + } let original = f.clone(); f.previous = f.position; f.age = f.age.wrapping_add(1); diff --git a/crates/horizon-client/src/game/armor_stands.rs b/crates/horizon-client/src/game/armor_stands.rs index 6ff5c7c15..58cd27494 100644 --- a/crates/horizon-client/src/game/armor_stands.rs +++ b/crates/horizon-client/src/game/armor_stands.rs @@ -382,7 +382,12 @@ impl Game<'_> { subject: None, }; let mut dead = Vec::new(); + // ServerLevel.tick: only entities in entity-ticking chunks tick. + let ticking = self.entity_ticking_area(); for (i, a) in self.armor_stands.iter_mut().enumerate() { + if !ticking(a.position.x.floor() as i32, a.position.z.floor() as i32) { + continue; + } a.tick(&mut scene); if !a.environment_tick(&self.world, self.res.facts(), self.pack.assets.registry) { dead.push(i); diff --git a/crates/horizon-client/src/game/boats.rs b/crates/horizon-client/src/game/boats.rs index 1d1a6b628..f9740598e 100644 --- a/crates/horizon-client/src/game/boats.rs +++ b/crates/horizon-client/src/game/boats.rs @@ -443,8 +443,13 @@ impl Game<'_> { } /// Every boat but the ridden one (which ticks with its rider). pub(super) fn tick_boats(&mut self) { + // ServerLevel.tick: only entities in entity-ticking chunks tick. + let ticking = self.entity_ticking_area(); for i in 0..self.boats.len() { - if Some(self.boats[i].id) == self.riding { + let p = self.boats[i].position; + if Some(self.boats[i].id) == self.riding + || !ticking(p.x.floor() as i32, p.z.floor() as i32) + { continue; } let b = self.boats[i].clone(); diff --git a/crates/horizon-client/src/game/frames.rs b/crates/horizon-client/src/game/frames.rs index 857eb40a4..7f5e6c26a 100644 --- a/crates/horizon-client/src/game/frames.rs +++ b/crates/horizon-client/src/game/frames.rs @@ -282,8 +282,15 @@ impl Game<'_> { } /// BlockAttachedEntity.tick for frames. pub(super) fn tick_item_frames(&mut self) { + // ServerLevel.tick: only entities in entity-ticking chunks tick. + let ticking = self.entity_ticking_area(); let mut i = 0; while i < self.item_frames.len() { + let at = center(&self.item_frames[i]); + if !ticking(at[0].floor() as i32, at[2].floor() as i32) { + i += 1; + continue; + } self.item_frames[i].check_interval += 1; if self.item_frames[i].check_interval >= 100 { self.item_frames[i].check_interval = 0; diff --git a/crates/horizon-client/src/game/paintings.rs b/crates/horizon-client/src/game/paintings.rs index bd2884575..321e59f7d 100644 --- a/crates/horizon-client/src/game/paintings.rs +++ b/crates/horizon-client/src/game/paintings.rs @@ -232,8 +232,16 @@ impl Game<'_> { } /// BlockAttachedEntity.tick: check survival every 100 ticks. pub(super) fn tick_paintings(&mut self) { + // ServerLevel.tick: only entities in entity-ticking chunks tick. + let ticking = self.entity_ticking_area(); let mut i = 0; while i < self.paintings.len() { + let (lo, hi) = self.paintings[i].bounds(); + let centre = [0, 2].map(|k| ((lo[k] + hi[k]) / 2.0).floor() as i32); + if !ticking(centre[0], centre[1]) { + i += 1; + continue; + } self.paintings[i].check_interval += 1; if self.paintings[i].check_interval >= 100 { self.paintings[i].check_interval = 0; diff --git a/crates/horizon-client/src/game/tnt.rs b/crates/horizon-client/src/game/tnt.rs index 92da4a0bb..80ad97d7f 100644 --- a/crates/horizon-client/src/game/tnt.rs +++ b/crates/horizon-client/src/game/tnt.rs @@ -156,8 +156,14 @@ impl Game<'_> { pub(super) fn tick_tnt(&mut self) -> Result<()> { let mut count = self.tnts.len(); let mut i = 0; + // ServerLevel.tick: only entities in entity-ticking chunks tick. + let ticking = self.entity_ticking_area(); while i < count { let t = &mut self.tnts[i]; + if !ticking(t.position.x.floor() as i32, t.position.z.floor() as i32) { + i += 1; + continue; + } t.tick( &self.world, self.collision, From e805e9886c06d37685c27e3056717e425da4aa59 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Mon, 19 Oct 2026 00:55:45 +0200 Subject: [PATCH 100/112] Scan for the motion-blocking top from the world surface, not the build limit getHeightmapPos(MOTION_BLOCKING) walked every column from y 319 down, one block lookup per y. Each precipitation roll (3 in 48 per ticking chunk per tick) and each isRainingAt paid for it: with the chunks of 10 players ticking it was most of tick_blocks. Only air lies above the WORLD_SURFACE heightmap the chunk already keeps, and air neither blocks motion nor holds a fluid, so the scan starts there. LevelAccess gains world_surface (the build limit by default, so other levels scan as before). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/game.rs | 3 +++ crates/horizon-world/src/level/mod.rs | 6 ++++++ crates/horizon-world/src/level/weather.rs | 6 ++++-- 3 files changed, 13 insertions(+), 2 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 2cbdabaa4..13d75817d 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -510,6 +510,9 @@ impl EntityObstructionWorld for PlayerObstruction { } } impl LevelAccess for GameLevel<'_> { + fn world_surface(&self, x: i32, z: i32) -> i32 { + self.world.world_surface(x, z, |s| self.facts.is_air(s)) + } fn precipitation(&self, pos: BlockPos) -> Option<horizon_world::level::Precipitation> { self.behaviours.precipitation_info(self, pos) } diff --git a/crates/horizon-world/src/level/mod.rs b/crates/horizon-world/src/level/mod.rs index f1f0b21ac..c706ca280 100644 --- a/crates/horizon-world/src/level/mod.rs +++ b/crates/horizon-world/src/level/mod.rs @@ -301,6 +301,12 @@ pub trait LevelAccess { fn max_y(&self) -> i32 { 320 } + /// `getHeight(WORLD_SURFACE, x, z)`: one above the column's highest + /// block that isn't air. Only air lies above it, so scans for the other + /// heightmaps start there. The default, `max_y`, scans the whole column. + fn world_surface(&self, _x: i32, _z: i32) -> i32 { + self.max_y() + } /// Vanilla `level.random` (a `LegacyRandomSource`). fn random(&mut self) -> &mut LegacyRandom; fn game_time(&self) -> i64; diff --git a/crates/horizon-world/src/level/weather.rs b/crates/horizon-world/src/level/weather.rs index c43d96b15..93027d889 100644 --- a/crates/horizon-world/src/level/weather.rs +++ b/crates/horizon-world/src/level/weather.rs @@ -40,14 +40,16 @@ impl Behaviours { BiomePrecipitation::Rain } } - /// `getHeightmapPos(MOTION_BLOCKING, pos)`. + /// `getHeightmapPos(MOTION_BLOCKING, pos)`, scanning down from the + /// world surface (air neither blocks motion nor holds a fluid). pub fn motion_blocking_top<L: LevelAccess + ?Sized>( &self, level: &L, pos: BlockPos, ) -> BlockPos { let blocks = self.tag("minecraft:blocks_motion_in_heightmap"); - for y in (level.min_y()..level.max_y()).rev() { + let top = level.world_surface(pos.x, pos.z).min(level.max_y()); + for y in (level.min_y()..top).rev() { let state = level.block_state(BlockPos::new(pos.x, y, pos.z)); let fluid = self.fluid(state).kind() != FluidKind::Empty; if fluid || blocks.is_some_and(|t| t.contains(self.block(state))) { From 6a4bed4744eeb1b1e905ca2bab29ca7e9a5c399a Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Mon, 19 Oct 2026 00:52:21 +0100 Subject: [PATCH 101/112] Coordinate concurrent neighbour cache misses by chunk key --- .../horizon-world/src/worldgen/generator.rs | 148 ++++++++++++++++++ .../src/worldgen/generator_structures.rs | 13 +- 2 files changed, 160 insertions(+), 1 deletion(-) diff --git a/crates/horizon-world/src/worldgen/generator.rs b/crates/horizon-world/src/worldgen/generator.rs index 7b73d35a8..ee0805d9a 100644 --- a/crates/horizon-world/src/worldgen/generator.rs +++ b/crates/horizon-world/src/worldgen/generator.rs @@ -635,6 +635,7 @@ struct Pipeline<R: RandomSource> { picker: GlobalFluidPicker, zoom: BiomeZoom, biome_cache: BiomeCache, + biome_work: ChunkWork, carver_cache: Mutex<HashMap<(i32, i32), BiomeId>>, pub(super) decoration: Option<super::generator_decoration::Decoration>, pub(super) structures: Option<super::generator_structures::StructureState>, @@ -643,6 +644,30 @@ struct Pipeline<R: RandomSource> { spawn_position: std::sync::OnceLock<[i32; 2]>, } const CACHE_LIMIT: usize = 16384; +/// Coordinates only equal missing neighbour keys. Weak entries retain no +/// computed values across eviction or explicit invalidation. Only one work +/// lock may be held at a time; finish shared prerequisites before acquiring it. +pub(super) struct ChunkWork(Mutex<HashMap<(i32, i32), std::sync::Weak<Mutex<()>>>>); +impl ChunkWork { + pub(super) fn new() -> Self { + Self(Mutex::new(HashMap::new())) + } + pub(super) fn at(&self, key: (i32, i32)) -> Arc<Mutex<()>> { + let mut work = self.0.lock().unwrap(); + if let Some(lock) = work.get(&key).and_then(std::sync::Weak::upgrade) { + return lock; + } + if work.len() >= 4096 { + // Keep every active builder/waiter on its original lock, including + // when the result cache was cleared while it was in flight. + work.retain(|_, lock| lock.strong_count() > 0); + } + let lock = Arc::new(Mutex::new(())); + work.insert(key, Arc::downgrade(&lock)); + lock + } +} + type BiomeCache = Mutex<HashMap<(i32, i32), Arc<BiomeChunk<BiomeId>>>>; fn state(registry: &BlockRegistry, raw: &Value) -> Result<BlockStateId, GeneratorError> { @@ -834,6 +859,7 @@ where extensions, picker, biome_cache: Mutex::new(HashMap::new()), + biome_work: ChunkWork::new(), carver_cache: Mutex::new(HashMap::new()), decoration: None, structures: None, @@ -867,6 +893,11 @@ where worker: &mut WorkerState, pos: ChunkPos, ) -> Result<Arc<BiomeChunk<BiomeId>>, GeneratorError> { + if let Some(chunk) = self.biome_cache.lock().unwrap().get(&(pos.x, pos.z)) { + return Ok(chunk.clone()); + } + let work = self.biome_work.at((pos.x, pos.z)); + let _work = work.lock().unwrap(); if let Some(chunk) = self.biome_cache.lock().unwrap().get(&(pos.x, pos.z)) { return Ok(chunk.clone()); } @@ -2013,4 +2044,121 @@ mod tests { .is_err() ); } + #[test] + fn neighbour_work_cleanup_keeps_active_keys_and_releases_idle_keys() { + let work = ChunkWork::new(); + let first = work.at((0, 0)); + let held = first.lock().unwrap(); + let same = work.at((0, 0)); + assert!(Arc::ptr_eq(&first, &same)); + assert!(!Arc::ptr_eq(&first, &work.at((1, 0)))); + // Sweep many expired weak entries while a builder and a prospective + // waiter retain their key. Cleanup must not split their coordination. + for x in 1..8192 { + drop(work.at((x, 1))); + } + assert!(work.0.lock().unwrap().len() <= 4096); + assert!(Arc::ptr_eq(&same, &work.at((0, 0)))); + let weak = Arc::downgrade(&first); + drop(held); + drop((first, same)); + assert!(weak.upgrade().is_none()); + let next = work.at((0, 0)); + assert_eq!(Arc::strong_count(&next), 1); + } + + /// Equal concurrent misses share one biome volume and the same mutable + /// structure pieces. Exercise cold ring startup before work coordination, + /// then cache eviction and explicit start invalidation with old Arcs alive. + #[test] + fn concurrent_neighbours_share_results_and_survive_invalidation() { + let root = std::env::var_os("HORIZON_RESOURCES") + .map(std::path::PathBuf::from) + .unwrap_or_else(|| { + Path::new(env!("CARGO_MANIFEST_DIR")).join("../../.local/horizon-client/26.3") + }); + if !root.join("worldgen/world_presets.json").exists() { + eprintln!("skipping: no worldgen bundle at {}", root.display()); + return; + } + let registry = Box::leak(Box::new( + crate::level::data::load_registry(&root).expect("registry"), + )); + let data = GeneratorData::load(&root.join("worldgen"), registry).expect("worldgen data"); + let preset: Value = serde_json::from_str(&data.world_presets["minecraft:normal"]).unwrap(); + let generator_json = &preset["dimensions"]["minecraft:overworld"]["generator"]; + let settings: Value = + serde_json::from_str(&data.settings[generator_json["settings"].as_str().unwrap()]) + .unwrap(); + let pipeline = Arc::new( + Pipeline::new( + data, + 12345, + XoroshiroRandom::new(12345), + generator_json, + &settings, + true, + Some((-64, 384)), + ) + .expect("pipeline"), + ); + let generator = OverworldGenerator { + pipeline: pipeline.clone(), + }; + let barrier = std::sync::Barrier::new(6); + let pos = ChunkPos::new(11, -11); // ancient city for this seed + let results = std::thread::scope(|scope| { + let handles: Vec<_> = (0..6) + .map(|_| { + scope.spawn(|| { + let mut worker = generator.worker(); + barrier.wait(); + let biomes = pipeline.biome_chunk(&mut worker.state, pos).unwrap(); + let starts = pipeline.structure_starts(&mut worker.state, pos); + (biomes, starts) + }) + }) + .collect(); + handles + .into_iter() + .map(|h| h.join().unwrap()) + .collect::<Vec<_>>() + }); + let (biomes, starts) = &results[0]; + assert!(!starts.is_empty(), "fixture must exercise shared pieces"); + for (b, s) in &results[1..] { + assert!(Arc::ptr_eq(biomes, b)); + assert_eq!(starts.len(), s.len()); + for (first, other) in starts.iter().zip(s) { + assert!(Arc::ptr_eq(first, other)); + } + } + // Force the existing whole-cache biome eviction threshold. + { + let mut cache = pipeline.biome_cache.lock().unwrap(); + cache.clear(); + for x in 0..CACHE_LIMIT as i32 { + cache.insert((x, 10000), biomes.clone()); + } + } + let mut worker = generator.worker(); + let rebuilt = pipeline.biome_chunk(&mut worker.state, pos).unwrap(); + assert!(!Arc::ptr_eq(biomes, &rebuilt)); + assert_eq!(pipeline.biome_cache.lock().unwrap().len(), 1); + for section in 0..24 { + assert_eq!(biomes.section(section), rebuilt.section(section)); + } + worker.forget_structure_starts(); + let fresh = worker.structure_starts(pos); + assert_eq!(starts.len(), fresh.len()); + for (old, new) in starts.iter().zip(&fresh) { + assert!(!Arc::ptr_eq(old, new)); + assert_eq!(old.name, new.name); + assert_eq!(old.bounding_box, new.bounding_box); + } + let again = worker.structure_starts(pos); + for (first, hit) in fresh.iter().zip(&again) { + assert!(Arc::ptr_eq(first, hit)); + } + } } diff --git a/crates/horizon-world/src/worldgen/generator_structures.rs b/crates/horizon-world/src/worldgen/generator_structures.rs index 3b6d058ae..befa71e48 100644 --- a/crates/horizon-world/src/worldgen/generator_structures.rs +++ b/crates/horizon-world/src/worldgen/generator_structures.rs @@ -2,7 +2,7 @@ use super::{ biome::BiomeId, block_feature::FeatureBlockBindings, - generator::{GeneratorData, GeneratorError}, + generator::{ChunkWork, GeneratorData, GeneratorError}, structure::{ StructureResources, start::{ @@ -31,6 +31,7 @@ pub(super) struct StructureState { /// Structure indices of each decoration step, in registry order. pub(super) by_step: Vec<Vec<usize>>, starts: StartCache, + start_work: ChunkWork, /// Concentric ring positions, computed on first use and shared with /// later generators of the same seed and dimension. rings: Arc<OnceLock<Rings>>, @@ -207,6 +208,7 @@ impl StructureState { possible_sets, by_step, starts: StartCache::new(), + start_work: ChunkWork::new(), rings, ring_work: OnceLock::new(), })) @@ -238,6 +240,8 @@ 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) { + // As before, a build already in flight can publish after this clear. + // Do not wait for work locks or retain initialized entries here. self.starts.clear(); } /// The (cached) structure starts owned by a chunk. @@ -249,7 +253,14 @@ impl StructureState { if let Some(found) = self.starts.get((chunk.x, chunk.z)) { return found; } + // Ring searches enlist other workers and wait for them: never hold a + // chunk-work lock while helping, even when this chunk has no starts. let rings = self.rings(context); + let work = self.start_work.at((chunk.x, chunk.z)); + let _work = work.lock().unwrap(); + if let Some(found) = self.starts.get((chunk.x, chunk.z)) { + return found; + } let starts: Starts = Arc::new( create_starts( &self.registry, From 0ab07f720967092847a487a70052dc8a53fed497 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Mon, 19 Oct 2026 01:10:17 +0100 Subject: [PATCH 102/112] Fix spectator scroll wheel flight speed --- .../examples/game_loop_probe.rs | 24 ++++++--- crates/horizon-client/src/game.rs | 22 +++++--- crates/horizon-client/src/game/remote.rs | 7 ++- crates/horizon-client/src/motion.rs | 50 +++++++++++++++++-- crates/horizon-client/src/mouse.rs | 6 +++ .../parity/VanillaGameLoopOracle.java | 11 +++- tools/test_game_loop_parity.py | 13 +++-- 7 files changed, 111 insertions(+), 22 deletions(-) diff --git a/crates/horizon-client/examples/game_loop_probe.rs b/crates/horizon-client/examples/game_loop_probe.rs index 56da454d9..66a428162 100644 --- a/crates/horizon-client/examples/game_loop_probe.rs +++ b/crates/horizon-client/examples/game_loop_probe.rs @@ -233,22 +233,32 @@ fn mouse(c: &Value, out: &mut impl Write) -> Result<()> { fn scroll(c: &Value, out: &mut impl Write) -> Result<()> { let mut handler = MouseLook::default(); let mut slot = c["slot"].as_i64().unwrap() as i32; + let spectator = c["spectator"].as_bool().unwrap_or(false); + let mut speed = 0.05; // OptionInstance.set quantises the wheel sensitivity. let mut file = OptionsFile::default(); file.set("mouseWheelSensitivity", V::Double(db(&c["sens"]))); let sensitivity = file.double("mouseWheelSensitivity"); writeln!(out, "scroll")?; for op in c["ops"].as_array().unwrap() { - if let Some((wheel, _)) = + if let Some((wheel, (_, y))) = handler.on_scroll(db(&op[0]), db(&op[1]), b(&c["discrete"]), sensitivity) { - slot = horizon_client::mouse::ScrollWheelHandler::next_selection( - f64::from(wheel), - slot, - 9, - ); + if spectator { + speed = horizon_client::mouse::spectator_flying_speed(speed, y); + } else { + slot = horizon_client::mouse::ScrollWheelHandler::next_selection( + f64::from(wheel), + slot, + 9, + ); + } + } + if spectator { + writeln!(out, "{slot} {}", fb(speed))?; + } else { + writeln!(out, "{slot}")?; } - writeln!(out, "{slot}")?; } Ok(()) } diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 2cbdabaa4..aa49c539f 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -9925,15 +9925,25 @@ impl ApplicationHandler for Game<'_> { && self.sleeping.is_none() && self.player.is_some() && !self.extras_scroll(d) - && let Some((wheel, _)) = + && let Some((wheel, (_, vertical_steps))) = self.mouse .on_scroll(raw_x, raw_y, discrete, wheel_sensitivity) { - self.selected = horizon_client::mouse::ScrollWheelHandler::next_selection( - f64::from(wheel), - self.selected as i32, - 9, - ) as usize; + if self.spectator() { + if let Some(player) = &mut self.player { + player.flying_speed = horizon_client::mouse::spectator_flying_speed( + player.flying_speed, + vertical_steps, + ); + } + } else { + self.selected = + horizon_client::mouse::ScrollWheelHandler::next_selection( + f64::from(wheel), + self.selected as i32, + 9, + ) as usize; + } } if self.screen == Screen::Chat && d != 0.0 { self.chat_scroll(d); diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 36c9fe4f3..f454771f3 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -1805,7 +1805,12 @@ impl Game<'_> { } _ => {} }, - C::PlayerAbilities(p) => self.creative = p.flags & 8 != 0, + C::PlayerAbilities(p) => { + self.creative = p.flags & 8 != 0; + if let Some(player) = &mut self.player { + player.flying_speed = p.flying_speed; + } + } C::SetHeldSlot(p) => { self.selected = p.slot.clamp(0, 8) as usize; if let Some(r) = self.remote.as_mut() { diff --git a/crates/horizon-client/src/motion.rs b/crates/horizon-client/src/motion.rs index 293aa61a2..6fca66c1d 100644 --- a/crates/horizon-client/src/motion.rs +++ b/crates/horizon-client/src/motion.rs @@ -224,6 +224,8 @@ pub struct PlayerMotion { /// Spectator mode: no physics, always flying (`Player.tick`). pub spectator: bool, pub flying: bool, + /// Client-side `Abilities.flyingSpeed`, adjusted by the spectator scroll wheel. + pub flying_speed: f32, /// The jump key last tick (LocalPlayer.aiStep's wasJumping). pub was_jumping: bool, /// `LocalPlayer.autoJumpEnabled` (the Auto-Jump option) and @@ -387,6 +389,7 @@ impl PlayerMotion { invulnerable: false, spectator: false, flying: false, + flying_speed: 0.05, was_jumping: false, auto_jump_enabled: false, auto_jump_time: 0, @@ -789,7 +792,7 @@ impl MotionWorld<'_, '_, '_> { // Vertical flight: jump up, shift down, three times the flying speed. let ya = i32::from(jumping) - i32::from(self.player.shift_key_down); if ya != 0 { - self.player.velocity.y += f64::from(ya as f32 * 0.05 * 3.0); + self.player.velocity.y += f64::from(ya as f32 * self.player.flying_speed * 3.0); } } self.dry_tick(TickInput::PreparedLocal { @@ -1863,8 +1866,8 @@ impl LivingAirWorld for MotionWorld<'_, '_, '_> { } fn flying_speed(&mut self) -> Result<f32> { if self.player.flying { - // Abilities.flyingSpeed 0.05, doubled when sprinting. - return Ok(if self.player.sprinting { 0.1 } else { 0.05 }); + // Player.getFlyingSpeed: abilities speed, doubled when sprinting. + return Ok(self.player.flying_speed * if self.player.sprinting { 2.0 } else { 1.0 }); } Ok(if self.player.sprinting { 0.025999999 @@ -2123,6 +2126,47 @@ mod tests { assert!(player.position.y < 84.0); } + #[test] + fn spectator_scroll_speed_controls_horizontal_and_vertical_flight() { + let root = Path::new(env!("CARGO_MANIFEST_DIR")).join("../../.local/horizon-client/26.3"); + if !root.join("movement-properties.nbt").exists() { + 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 = |steps| { + let mut scene = World::test_scene(&assets, &render, 2).unwrap(); + let start = Vec3::new(20.5, 12.0, 20.5); + let mut player = PlayerMotion::new(&resources, start).unwrap(); + player.spectator = true; + player.flying_speed = crate::mouse::spectator_flying_speed(player.flying_speed, steps); + MotionWorld { + entities: &[], + player: &mut player, + scene: &mut scene, + assets: &assets, + collision_binding: &binding, + resources: &resources, + } + .controlled_simulation_tick(crate::sprint::Keys { + forward: true, + jump: true, + ..Default::default() + }) + .unwrap(); + player.position.subtract(start) + }; + let stopped = run(-100); + assert_eq!(stopped, Vec3::ZERO); + let normal = run(0); + let fast = run(10); + assert!(normal.y > 0.0 && normal.z > 0.0); + assert!((fast.y - normal.y * 2.0).abs() < 1e-6); + assert!((fast.z - normal.z * 2.0).abs() < 1e-6); + } + #[test] fn resident_spectator_flight_ignores_solid_and_climbable_blocks() { let root = Path::new(env!("CARGO_MANIFEST_DIR")).join("../../.local/horizon-client/26.3"); diff --git a/crates/horizon-client/src/mouse.rs b/crates/horizon-client/src/mouse.rs index d2794d790..1cee2be87 100644 --- a/crates/horizon-client/src/mouse.rs +++ b/crates/horizon-client/src/mouse.rs @@ -80,6 +80,12 @@ impl ScrollWheelHandler { } } +/// `MouseHandler.onScroll` with the spectator menu closed. Only vertical whole +/// wheel steps adjust `Abilities.flyingSpeed`; horizontal scrolling does not. +pub fn spectator_flying_speed(speed: f32, vertical_steps: i32) -> f32 { + (speed + vertical_steps as f32 * 0.005).clamp(0.0, 0.2) +} + /// Entity rotation as `Entity.turn` keeps it. #[derive(Clone, Copy, Debug, PartialEq)] pub struct Rotation { diff --git a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaGameLoopOracle.java b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaGameLoopOracle.java index 0be89888a..294ceacac 100644 --- a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaGameLoopOracle.java +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaGameLoopOracle.java @@ -118,13 +118,14 @@ public final class VanillaGameLoopOracle { static final class StubPlayer extends LocalPlayer { boolean scoping; + boolean spectator; StubPlayer() { super(null, null, null, null, null, Input.EMPTY, false, null, null); } @Override public boolean isScoping() { return scoping; } - @Override public boolean isSpectator() { return false; } + @Override public boolean isSpectator() { return spectator; } } static Minecraft shell; @@ -327,6 +328,12 @@ public final class VanillaGameLoopOracle { StubPlayer player = make(StubPlayer.class); Inventory inventory = make(Inventory.class); inventory.setSelectedSlot(c.get("slot").getAsInt()); + player.spectator = c.has("spectator") && c.get("spectator").getAsBoolean(); + field(net.minecraft.world.entity.player.Player.class, "abilities").set(player, new net.minecraft.world.entity.player.Abilities()); + var hud = make(net.minecraft.client.gui.Hud.class); + field(net.minecraft.client.gui.Hud.class, "spectatorGui").set(hud, + make(net.minecraft.client.gui.components.spectator.SpectatorGui.class)); + field(Gui.class, "hud").set(mc.gui, hud); field(net.minecraft.world.entity.player.Player.class, "inventory").set(player, inventory); mc.player = player; options.discreteMouseScroll().set(c.get("discrete").getAsBoolean()); @@ -336,7 +343,7 @@ public final class VanillaGameLoopOracle { for (var e : c.getAsJsonArray("ops")) { var op = e.getAsJsonArray(); h.onScroll(1L, d(op.get(0)), d(op.get(1))); - out.println(inventory.getSelectedSlot()); + out.println(inventory.getSelectedSlot() + (player.spectator ? " " + fb(player.getAbilities().getFlyingSpeed()) : "")); } } diff --git a/tools/test_game_loop_parity.py b/tools/test_game_loop_parity.py index d724dc6ac..101b3f238 100644 --- a/tools/test_game_loop_parity.py +++ b/tools/test_game_loop_parity.py @@ -120,8 +120,15 @@ def scroll_cases(rng): x = rng.choice([0.0, 0.0, 0.0, 1.0, -1.0, 0.25, -0.25, 0.4, 2.0, 5.5, -7.0, rng.uniform(-3, 3)]) y = rng.choice([0.0, 1.0, -1.0, 1.0, -1.0, 0.1, -0.3, 0.5, -0.5, 2.0, -3.0, 120.0, rng.uniform(-3, 3)]) ops.append([dbits(x), dbits(y)]) - yield dict(t='scroll', discrete=rng.random() < 0.4, sens=dbits(rng.choice([1.0, 0.01, 10.0, 0.5, 2.0, 3.1622776601683795])), - slot=rng.randrange(9), ops=ops) + case = dict(t='scroll', discrete=rng.random() < 0.4, sens=dbits(rng.choice([1.0, 0.01, 10.0, 0.5, 2.0, 3.1622776601683795])), + slot=rng.randrange(9), ops=ops) + yield case + yield dict(case, spectator=True) + # Bounds, recovery from each bound, fractional accumulation, and horizontal-only input. + yield dict(t='scroll', discrete=False, sens=dbits(1.0), slot=4, spectator=True, + ops=[[dbits(x), dbits(y)] for x, y in + [(0, 100), (0, -1), (0, -100), (0, 1), (0, .4), (0, .7), + (0, -.4), (0, -.7), (5, 0), (-5, 0)]]) def key_cases(rng): @@ -152,7 +159,7 @@ def main(): 'Window.calculateScale/setGuiScale and MouseHandler scaled positions, FramerateLimitTracker throttle reasons and ' 'limits (not the focus-lost exclusive-fullscreen branch, which reads SDL), MouseHandler.onMove/turnPlayer with ' 'sensitivity, cinematic smoothing, scoping and inversion, Entity.turn clamps, onScroll with ScrollWheelHandler ' - 'accumulation, discrete scrolling and hotbar selection, and ToggleKeyMapping/KeyMapping down, click and ' + 'accumulation, discrete scrolling, hotbar selection and spectator flight speed, and ToggleKeyMapping/KeyMapping down, click and ' 'screen-release state. The frame clock source (Blaze3D.getTime, System.nanoTime) is injected, so sleeping in ' 'FramerateLimiter and vsync present-mode selection are covered by Rust unit tests only.') harness.differential( From 2fe7cb3a4bb156daab731ff5b031621f6e39c763 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Mon, 19 Oct 2026 01:23:23 +0100 Subject: [PATCH 103/112] Reuse terrain sampler scratch buffers between chunks --- crates/horizon-core/src/density/mod.rs | 7 ++ crates/horizon-core/src/density/tests.rs | 70 +++++++++++++++++++ .../horizon-world/src/worldgen/generator.rs | 26 +++++-- 3 files changed, 97 insertions(+), 6 deletions(-) diff --git a/crates/horizon-core/src/density/mod.rs b/crates/horizon-core/src/density/mod.rs index 6bc84a8d1..f4ee1af49 100644 --- a/crates/horizon-core/src/density/mod.rs +++ b/crates/horizon-core/src/density/mod.rs @@ -103,6 +103,13 @@ impl SamplerContext { self.scratch.push(buffer); result } + /// Start an independent evaluation, retaining only temporary scratch buffers. + /// Cached scalar/volume results and world bindings must not cross chunks or + /// graphs, whose cache IDs can refer to different functions. + pub fn reset(&mut self) { + self.caches = self.caches.as_ref().map(|_| Vec::new()); + self.fields = WorldFields::default(); + } /// Release retained storage between worlds or after unusually large work. pub fn clear_scratch(&mut self) { self.scratch.clear(); diff --git a/crates/horizon-core/src/density/tests.rs b/crates/horizon-core/src/density/tests.rs index 77a643097..9fad8bc4f 100644 --- a/crates/horizon-core/src/density/tests.rs +++ b/crates/horizon-core/src/density/tests.rs @@ -755,3 +755,73 @@ fn spline_lazy_branch_failure_preserves_completed_output_and_returns_scratch() { assert_eq!(context.scratch.len(), 2); assert_eq!(sampler.sample_value(&mut context, [0; 3]), Ok(7.0)); } + +#[test] +fn reset_retains_scratch_but_discards_graph_caches_and_world_bindings() { + let binding = Arc::new(ConstantSampler(17.0)); + let lifetime = Arc::downgrade(&binding); + let mut context = SamplerContext::cached() + .with_world_fields(WorldFields::default().with_field(WorldField::Beardifier, binding)); + let cached = CachingDensitySampler::new( + 0, + Arc::new(ContextBoundSampler::new(WorldField::Beardifier)), + ) + .unwrap(); + let volume = DensityVolume::new([2; 3], [0; 3], [1; 3]).unwrap(); + let mut output = [0.0; 8]; + cached + .sample_volume(&mut context, &mut output, volume) + .unwrap(); + assert_eq!(output, [17.0; 8]); + assert_eq!(cached.sample_value(&mut context, [9; 3]), Ok(17.0)); + context + .with_buffer(128, |_, buffer| { + buffer.fill(99.0); + Ok(()) + }) + .unwrap(); + let allocation = context.scratch[0].as_ptr(); + let capacity = context.scratch[0].capacity(); + context.reset(); + assert!(lifetime.upgrade().is_none()); + assert!(context.caches.as_ref().unwrap().is_empty()); + assert_eq!(context.scratch[0].as_ptr(), allocation); + assert_eq!(context.scratch[0].capacity(), capacity); + // Same coordinates and cache ID must resolve the new context's fallback. + assert_eq!(cached.sample_value(&mut context, [9; 3]), Ok(0.0)); + cached + .sample_volume(&mut context, &mut output, volume) + .unwrap(); + assert_eq!(output, [0.0; 8]); + // A different graph may reuse IDs without inheriting scalar/volume results. + context.reset(); + let replacement = CachingDensitySampler::new(0, Arc::new(ConstantSampler(3.0))).unwrap(); + assert_eq!(replacement.sample_value(&mut context, [9; 3]), Ok(3.0)); + replacement + .sample_volume(&mut context, &mut output, volume) + .unwrap(); + assert_eq!(output, [3.0; 8]); +} + +#[test] +fn reset_after_sampling_error_drops_blender_and_preserves_uncached_mode() { + let blender = Arc::new(EmptyBlender); + let lifetime = Arc::downgrade(&blender); + let mut context = + SamplerContext::default().with_world_fields(WorldFields::default().with_blender(blender)); + let result: Result<(), SampleError> = context.with_buffer(64, |_, buffer| { + buffer.fill(42.0); + Err(SampleError::RecursiveCache) + }); + assert_eq!(result, Err(SampleError::RecursiveCache)); + let allocation = context.scratch[0].as_ptr(); + context.reset(); + assert!(lifetime.upgrade().is_none()); + assert!(context.caches.is_none()); + context + .with_buffer(32, |_, buffer| { + assert_eq!(buffer.as_ptr(), allocation); + Ok(()) + }) + .unwrap(); +} diff --git a/crates/horizon-world/src/worldgen/generator.rs b/crates/horizon-world/src/worldgen/generator.rs index 7b73d35a8..068fdf5bc 100644 --- a/crates/horizon-world/src/worldgen/generator.rs +++ b/crates/horizon-world/src/worldgen/generator.rs @@ -933,6 +933,19 @@ where &self, worker: &mut WorkerState, pos: ChunkPos, + ) -> Result<ProtoChunk, GeneratorError> { + let mut context = std::mem::take(&mut worker.terrain_context); + let result = self.generate_with_context(worker, pos, &mut context); + // Release chunk-specific bindings and caches even after a sampling error. + context.reset(); + worker.terrain_context = context; + result + } + fn generate_with_context( + &self, + worker: &mut WorkerState, + pos: ChunkPos, + context: &mut SamplerContext, ) -> Result<ProtoChunk, GeneratorError> { let data = &self.data; let (min, height, sea) = ( @@ -985,13 +998,12 @@ where ), None => Vec::new(), }; - let mut context = SamplerContext::cached(); if let Some(beard) = self .structures .as_ref() .and_then(|s| s.beardifier(&references, pos)) { - context = context.with_world_fields( + *context = std::mem::take(context).with_world_fields( horizon_core::density::WorldFields::default().with_field( horizon_core::density::WorldField::Beardifier, Arc::new(beard), @@ -1016,7 +1028,7 @@ where .fork_positional(), RegistryAquiferBlockStates::new(data.registry).map_err(stage("aquifer"))?, volume, - &mut context, + context, ) .map_err(stage("aquifer"))?, ), @@ -1030,7 +1042,7 @@ where &mut chunk, volume, self.router.get(RouterField::FinalDensity).as_ref(), - &mut context, + context, aquifer.as_mut(), self.settings.default_block, ) @@ -1051,7 +1063,7 @@ where possible: Some(possible), }, preliminary_surface: self.preliminary.clone(), - density_context: &mut context, + density_context: context, write_min_y: min, write_max_y: min + height - 1, }, @@ -1086,7 +1098,7 @@ where possible: None, }, preliminary_surface: self.preliminary.clone(), - density_context: &mut context, + density_context: context, }, aquifer.as_mut(), &data.carving_blocks, @@ -1391,6 +1403,7 @@ pub struct StageTimings { /// thread-local caches and never change results. pub(super) struct WorkerState { pub(super) temperatures: Vec<BiomeTemperature>, + terrain_context: SamplerContext, biome_context: SamplerContext, carver_context: SamplerContext, timings: StageTimings, @@ -1866,6 +1879,7 @@ impl OverworldGenerator { .iter() .map(|s| BiomeTemperature::new(*s)) .collect(), + terrain_context: SamplerContext::cached(), biome_context: SamplerContext::cached(), carver_context: SamplerContext::default(), timings: StageTimings::default(), From c0f0c17ed4b05dd72d9ecda26ae6a925e0018f0c Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Mon, 19 Oct 2026 03:07:17 +0200 Subject: [PATCH 104/112] Keep restored chunk entities out of /summon's result after a level switch Coming back to a level, the entities saved with its chunks wait in World::loaded_entities until the next tick spawns them, as vanilla's PersistentEntitySectionManager.processPendingLoads does. /summon pushed its compound onto that queue and drained all of it, so the first waiting entity took the id counted as the summon's root: after a Nether round trip `/summon minecraft:armor_stand ...` reported "Summoned new Pig". Summon now spawns only its own stack and leaves the queue to the tick. The command harness's settle now waits for the entities of the chunks around the player as well, like the oracle's settle (areEntitiesActuallyLoadedAndTicking), and a `portal` op sends the player through the nether portal it stands in (Entity.handlePortal: NetherPortalBlock.getPortalDestination, teleportToPortalDestination). The corpus's new `levels` group makes the round trip and checks the Overworld's pig and a summon's feedback on the way back. Fixes #947 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../src/game/command_harness.rs | 21 +++++++++++++++- .../horizon-client/src/game/commands/data.rs | 9 ++++++- .../horizon-client/src/game/nether_portal.rs | 6 +++++ .../parity/VanillaCommandExecOracle.java | 18 +++++++++++++ tools/command_exec_corpus.py | 25 ++++++++++++++++++- 5 files changed, 76 insertions(+), 3 deletions(-) diff --git a/crates/horizon-client/src/game/command_harness.rs b/crates/horizon-client/src/game/command_harness.rs index ed3f8b336..096ba1c74 100644 --- a/crates/horizon-client/src/game/command_harness.rs +++ b/crates/horizon-client/src/game/command_harness.rs @@ -4,7 +4,8 @@ //! command as the player (Commands.performPrefixedCommand) and records every //! system message it produced, as styled spans, with the results reported to //! the player's `CommandResultCallback`; `tick` advances the game; `settle` -//! waits until the terrain around the player is loaded. +//! waits until the terrain and entities around the player are loaded; +//! `portal` sends the player through the nether portal it stands in. use super::Game; use horizon_client::{Result, text::Text}; use serde_json::{Value, json}; @@ -40,6 +41,19 @@ pub(super) fn spans(text: &Text) -> Value { } impl Game<'_> { + /// The player's portal process finished in the nether portal it stands + /// in (the oracle's player is not ticked, so neither is the wait). + fn harness_portal(&mut self) -> Result<()> { + let Some(p) = &self.player else { + return Err("command harness: portal without a player".into()); + }; + let entry = horizon_core::position::BlockPos::containing(p.position); + let block = self.world.block(entry.x, entry.y, entry.z); + if &*self.res.facts().get(block).name != "minecraft:nether_portal" { + return Err("command harness: the player is not in a nether portal".into()); + } + self.player_through_nether_portal(entry) + } /// Load terrain until the player stands in lit chunks. fn harness_settle(&mut self, deadline: Instant) -> Result<()> { loop { @@ -51,6 +65,10 @@ impl Game<'_> { (p.position.z.floor() as i32) >> 4, ); if (-1..=1).all(|dz| (-1..=1).all(|dx| self.streaming.is_lit(cx + dx, cz + dz))) { + // The oracle's settle also waits for the entities saved + // in those chunks (areEntitiesActuallyLoadedAndTicking): + // after a dimension change they come back from the save. + self.spawn_loaded_entities(); return Ok(()); } } @@ -130,6 +148,7 @@ impl Game<'_> { } } "settle" => self.harness_settle(deadline)?, + "portal" => self.harness_portal()?, other => return Err(format!("command harness: unknown op {other}").into()), } } diff --git a/crates/horizon-client/src/game/commands/data.rs b/crates/horizon-client/src/game/commands/data.rs index bbb388deb..89e3d6397 100644 --- a/crates/horizon-client/src/game/commands/data.rs +++ b/crates/horizon-client/src/game/commands/data.rs @@ -666,13 +666,20 @@ impl Game<'_> { /// Spawn an entity from its compound (`EntityType.loadEntityRecursive`); /// returns what was created. pub(super) fn spawn_entity_from_nbt(&mut self, tag: Tag) -> Option<Target> { - let before = self.next_entity; let key = { let p = entity_nbt::position(&tag)?; ((p.x.floor() as i32) >> 4, (p.z.floor() as i32) >> 4) }; + // Only this stack spawns now: the entities of chunks that finished + // loading wait for the level's entity tick, as in vanilla + // (PersistentEntitySectionManager.processPendingLoads), and must not + // take the ids counted as this stack's. + let mut waiting = std::mem::take(&mut self.world.loaded_entities); + let before = self.next_entity; self.world.loaded_entities.push((key, vec![tag])); self.spawn_loaded_entities(); + waiting.append(&mut self.world.loaded_entities); + self.world.loaded_entities = waiting; if self.next_entity == before { return None; } diff --git a/crates/horizon-client/src/game/nether_portal.rs b/crates/horizon-client/src/game/nether_portal.rs index 94df10ec4..11c32f701 100644 --- a/crates/horizon-client/src/game/nether_portal.rs +++ b/crates/horizon-client/src/game/nether_portal.rs @@ -298,6 +298,12 @@ impl Game<'_> { else { return Ok(()); }; + self.player_through_nether_portal(entry) + } + /// `Entity.handlePortal` once the player's portal process at `entry` + /// finished: `NetherPortalBlock.getPortalDestination`, then + /// `teleportToPortalDestination` (`isAllowedToEnterPortal`). + pub(super) fn player_through_nether_portal(&mut self, entry: BlockPos) -> Result<()> { let Some(p) = self.player.as_ref() else { return Ok(()); }; diff --git a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaCommandExecOracle.java b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaCommandExecOracle.java index 4b61558d8..8c6225401 100644 --- a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaCommandExecOracle.java +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaCommandExecOracle.java @@ -222,6 +222,7 @@ public final class VanillaCommandExecOracle { } } case "settle" -> settle(); + case "portal" -> portal(); default -> throw new IllegalArgumentException(line); } } @@ -278,6 +279,23 @@ public final class VanillaCommandExecOracle { } /** Force-load the chunks around the player (Horizon waits for its streamed terrain). */ + /** + * Entity.handlePortal once the player's portal process finished in the + * nether portal it stands in (the oracle does not tick the player). + */ + void portal() { + ServerLevel level = player.level(); + net.minecraft.core.BlockPos entry = player.blockPosition(); + if (!level.getBlockState(entry).is(net.minecraft.world.level.block.Blocks.NETHER_PORTAL)) { + throw new IllegalStateException("portal: the player is not in a nether portal"); + } + var block = (net.minecraft.world.level.block.NetherPortalBlock) net.minecraft.world.level.block.Blocks.NETHER_PORTAL; + var transition = block.getPortalDestination(level, player, entry); + if (transition != null) { + player.teleportToPortalDestination(level, transition); + } + } + void settle() { ServerLevel level = player.level(); int cx = player.chunkPosition().x(), cz = player.chunkPosition().z(); diff --git a/tools/command_exec_corpus.py b/tools/command_exec_corpus.py index eb99e1f1a..4757e66f0 100644 --- a/tools/command_exec_corpus.py +++ b/tools/command_exec_corpus.py @@ -2,7 +2,8 @@ Each group is a list of operations: `cmd` runs a command as the player and records its messages and results (`record: false` runs setup silently), -`tick` advances the game and `settle` loads the terrain around the player. +`tick` advances the game, `settle` loads the terrain and entities around the +player and `portal` sends the player through the nether portal it stands in. Everything happens high above the terrain (y 200 and up, where both worlds are air) after the world's entities are removed, so the results do not depend on world generation. @@ -394,6 +395,27 @@ def execute(): ] +def levels(): + """A nether portal round trip: on the way back the Overworld's entities (the + pig left by `entities`) are found and a summon names what it summoned.""" + return [ + *setup('/fill 2 231 12 5 236 12 minecraft:obsidian', '/fill 3 232 12 4 235 12 minecraft:nether_portal[axis=x]', + '/tp @s 3.5 232 12.5 0 0'), + {'op': 'portal'}, + {'op': 'settle'}, + cmd('/execute if dimension minecraft:the_nether run say through the portal'), + {'op': 'portal'}, + {'op': 'settle'}, + cmd('/execute if dimension minecraft:overworld run say back through the portal'), + cmd('/data get entity @s Pos'), + cmd('/data get entity @s Rotation'), + cmd('/execute if entity @e[type=minecraft:pig]'), + cmd('/summon minecraft:armor_stand 4.5 210 4.5 {NoGravity:1b,Tags:["lv"],CustomName:"Back"}'), + *setup('/kill @e[tag=lv]', '/fill 2 231 12 5 236 12 minecraft:air', '/tp @s 8.5 230 8.5 0 0'), + {'op': 'settle'}, + ] + + def items_and_loot(): return [ *setup('/clear @s', '/gamemode survival'), @@ -918,6 +940,7 @@ def groups(): ('entities', entities()), ('scores, teams and bossbars', scores()), ('execute', execute()), + ('levels', levels()), ('items and loot', items_and_loot()), ('world', world_misc()), ('progression', progression()), From cd30aae4a8c1c90548c51e23eae285ef17e6311f Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Mon, 19 Oct 2026 02:02:22 +0200 Subject: [PATCH 105/112] Strongholds: sample each ring search through one biome resolver ChunkGeneratorStructureState's ring searches call findBiomeHorizontal, which samples its 57x57 quarts in order through one resolver; vanilla's climate index starts each lookup from the previous result and keeps it on a tie. Horizon built a fresh resolver for every quart, so ties went the other way: three of seed 1234's 128 strongholds were up to 6 chunks off (the first one 96 blocks from vanilla's). StartContext::noise_biomes samples a batch through one resolver and the search hands it the square. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../horizon-world/src/worldgen/generator.rs | 62 +++++++++++++++---- .../src/worldgen/generator_structures.rs | 21 ++++--- .../src/worldgen/structure/start.rs | 4 ++ .../src/worldgen/structure/stronghold.rs | 28 ++++++--- 4 files changed, 86 insertions(+), 29 deletions(-) diff --git a/crates/horizon-world/src/worldgen/generator.rs b/crates/horizon-world/src/worldgen/generator.rs index 75c3b3a6b..b13def97d 100644 --- a/crates/horizon-world/src/worldgen/generator.rs +++ b/crates/horizon-world/src/worldgen/generator.rs @@ -1279,15 +1279,23 @@ where self.pipeline.generation() } fn noise_biome(&mut self, quart: [i32; 3]) -> BiomeId { + self.noise_biomes(&[quart])[0] + } + fn noise_biomes(&mut self, quarts: &[[i32; 3]]) -> Vec<BiomeId> { let mut resolver = self.pipeline.source.resolver( &self.pipeline.climate, self.pipeline.router.get(RouterField::Erosion).as_ref(), ); - resolver - .sample(&mut self.worker.carver_context, quart) - .ok() - .and_then(|name| self.pipeline.data.biome_id(name)) - .unwrap_or(BiomeId(0)) + quarts + .iter() + .map(|&quart| { + resolver + .sample(&mut self.worker.carver_context, quart) + .ok() + .and_then(|name| self.pipeline.data.biome_id(name)) + .unwrap_or(BiomeId(0)) + }) + .collect() } fn set_valid_biomes(&mut self, biomes: &BTreeSet<BiomeId>) { self.valid = biomes.clone(); @@ -2011,10 +2019,8 @@ mod tests { assert_eq!(second.state.carver_biomes, expected); } - /// Generators of one seed and dimension share their ring positions; - /// another seed or generator gets its own, and old entries go. - #[test] - fn ring_positions_are_shared_by_seed_and_dimension() { + /// The prepared worldgen data, if this checkout has it. + fn prepared_data() -> Option<Arc<GeneratorData>> { let root = std::env::var_os("HORIZON_RESOURCES") .map(std::path::PathBuf::from) .unwrap_or_else(|| { @@ -2022,12 +2028,46 @@ mod tests { }); if !root.join("worldgen/world_presets.json").exists() { eprintln!("skipping: no worldgen bundle at {}", root.display()); - return; + return None; } let registry: &'static BlockRegistry = Box::leak(Box::new( crate::level::data::load_registry(&root).expect("registry"), )); - let data = GeneratorData::load(&root.join("worldgen"), registry).expect("worldgen data"); + Some(GeneratorData::load(&root.join("worldgen"), registry).expect("worldgen data")) + } + + /// Seed 1234's strongholds where vanilla 26.3 puts them + /// (VanillaStructureStartOracle with HORIZON_RINGS). Each search sampled + /// its quarts through fresh resolvers, which broke climate ties their own + /// way: three of the 128 were up to 6 chunks off. + #[test] + fn stronghold_rings_match_vanilla() { + let Some(data) = prepared_data() else { + return; + }; + let generator = OverworldGenerator::new(data, 1234).expect("generator"); + generator.worker().structure_starts(ChunkPos::new(0, 0)); + let rings = generator + .ring_positions("minecraft:strongholds") + .expect("ring positions"); + assert_eq!(rings.len(), 128); + for (i, x, z) in [ + (0, -100, -125), + (1, 131, -12), + (111, 1190, -560), + (113, 1305, -112), + ] { + assert_eq!(rings[i], ChunkPos::new(x, z), "stronghold {i}"); + } + } + + /// Generators of one seed and dimension share their ring positions; + /// another seed or generator gets its own, and old entries go. + #[test] + fn ring_positions_are_shared_by_seed_and_dimension() { + let Some(data) = prepared_data() else { + return; + }; let first = OverworldGenerator::new(data.clone(), 1234).expect("generator"); let again = OverworldGenerator::new(data.clone(), 1234).expect("generator"); { diff --git a/crates/horizon-world/src/worldgen/generator_structures.rs b/crates/horizon-world/src/worldgen/generator_structures.rs index 11765ab57..985b96f0e 100644 --- a/crates/horizon-world/src/worldgen/generator_structures.rs +++ b/crates/horizon-world/src/worldgen/generator_structures.rs @@ -73,14 +73,14 @@ impl RingWork { fn help<'a>( &self, preferred: impl Fn(usize) -> &'a BTreeSet<BiomeId>, - biome: &mut dyn FnMut([i32; 3]) -> BiomeId, + biomes: &mut dyn FnMut(&[[i32; 3]]) -> Vec<BiomeId>, ) { loop { let i = self.next.fetch_add(1, Ordering::Relaxed); let Some((set, search)) = self.searches.get(i) else { break; }; - let _ = self.found[i].set(search.find(preferred(*set), biome)); + let _ = self.found[i].set(search.find(preferred(*set), biomes)); let mut left = self.left.lock().unwrap(); *left -= 1; if *left == 0 { @@ -237,8 +237,8 @@ impl StructureState { ) }); let registry = &self.registry; - work.help(|set| registry.ring_biomes(set), &mut |q| { - context.noise_biome(q) + work.help(|set| registry.ring_biomes(set), &mut |quarts| { + context.noise_biomes(quarts) }); self.rings .get_or_init(|| work.rings(|set| registry.sets[set].name.clone())) @@ -464,8 +464,13 @@ mod tests { #[test] fn ring_work_shared_between_threads_matches_serial_search() { let preferred: BTreeSet<BiomeId> = (0..20).map(|b| BiomeId(b * 3)).collect(); - let biome = |q: [i32; 3]| { - BiomeId((q[0].wrapping_mul(31) ^ q[2].wrapping_mul(17)).rem_euclid(64) as u32) + let biomes = |quarts: &[[i32; 3]]| -> Vec<BiomeId> { + quarts + .iter() + .map(|q| { + BiomeId((q[0].wrapping_mul(31) ^ q[2].wrapping_mul(17)).rem_euclid(64) as u32) + }) + .collect() }; let none = BTreeSet::new(); for seed in [0, 1234, -77, i64::MAX] { @@ -477,12 +482,12 @@ mod tests { let sets = [&preferred, &none, &preferred]; std::thread::scope(|scope| { for _ in 0..4 { - scope.spawn(|| work.help(|set| sets[set], &mut { biome })); + scope.spawn(|| work.help(|set| sets[set], &mut { biomes })); } }); let rings = work.rings(|set| format!("set{set}")); let serial = |s: i64, distance, spread, count, preferred| { - ring_positions(s, distance, spread, count, preferred, &mut { biome }) + ring_positions(s, distance, spread, count, preferred, &mut { biomes }) }; assert_eq!(rings["set0"], serial(seed, 32, 3, 128, &preferred)); assert_eq!(rings["set1"], Vec::new()); diff --git a/crates/horizon-world/src/worldgen/structure/start.rs b/crates/horizon-world/src/worldgen/structure/start.rs index 3d61bf168..dfb8176e0 100644 --- a/crates/horizon-world/src/worldgen/structure/start.rs +++ b/crates/horizon-world/src/worldgen/structure/start.rs @@ -707,6 +707,10 @@ pub trait StartContext: JigsawContext { fn generation(&self) -> WorldGenerationContext; /// Noise biome at a quart position (caching resolver, no zoom). fn noise_biome(&mut self, quart: [i32; 3]) -> BiomeId; + /// Noise biomes of `quarts` in order through one resolver, as + /// BiomeSource.findBiomeHorizontal samples: each climate lookup starts + /// from the previous result, which a tie keeps. + fn noise_biomes(&mut self, quarts: &[[i32; 3]]) -> Vec<BiomeId>; fn set_valid_biomes(&mut self, biomes: &BTreeSet<BiomeId>); } diff --git a/crates/horizon-world/src/worldgen/structure/stronghold.rs b/crates/horizon-world/src/worldgen/structure/stronghold.rs index 270b412af..e1a10808f 100644 --- a/crates/horizon-world/src/worldgen/structure/stronghold.rs +++ b/crates/horizon-world/src/worldgen/structure/stronghold.rs @@ -14,17 +14,18 @@ use std::{collections::BTreeSet, f64::consts::PI, sync::Mutex}; /// ChunkGeneratorStructureState.generateRingPositions with /// BiomeSource.findBiomeHorizontal (radius 112, step 1, not closest). +/// `biomes` samples a search's quarts in order, as one caching resolver. pub fn ring_positions( seed: i64, distance: i32, spread: i32, count: i32, preferred: &BTreeSet<BiomeId>, - biome: &mut dyn FnMut([i32; 3]) -> BiomeId, + biomes: &mut dyn FnMut(&[[i32; 3]]) -> Vec<BiomeId>, ) -> Vec<ChunkPos> { ring_searches(seed, distance, spread, count) .iter() - .map(|search| search.find(preferred, biome)) + .map(|search| search.find(preferred, biomes)) .collect() } @@ -39,23 +40,30 @@ pub struct RingSearch { impl RingSearch { /// BiomeSource.findBiomeHorizontal around the ring chunk's centre: a /// random preferred biome within 112 blocks, else the ring chunk itself. + /// + /// Vanilla samples the square in order on one thread, and its climate + /// index (Climate.RTree) starts each lookup from the previous result and + /// keeps it on a tie; so `biomes` gets the whole square at once, in + /// vanilla's order. Fresh lookups moved seed 1234's first stronghold 6 + /// chunks: one quart on a lush caves / ocean tie went to the ocean. pub fn find( &self, preferred: &BTreeSet<BiomeId>, - biome: &mut dyn FnMut([i32; 3]) -> BiomeId, + biomes: &mut dyn FnMut(&[[i32; 3]]) -> Vec<BiomeId>, ) -> ChunkPos { let mut search = self.random.clone(); let (cx, cz) = ((self.x * 16 + 8) >> 2, (self.z * 16 + 8) >> 2); + let quarts: Vec<[i32; 3]> = (-28..=28) + .flat_map(|dz| (-28..=28).map(move |dx| [cx + dx, 0, cz + dz])) + .collect(); let mut found = 0; let mut result = None; - for dz in -28..=28 { - for dx in -28..=28 { - if preferred.contains(&biome([cx + dx, 0, cz + dz])) { - if result.is_none() || search.next_int_bound(found + 1).unwrap_or(1) == 0 { - result = Some(((cx + dx) << 2, (cz + dz) << 2)); - } - found += 1; + for (quart, biome) in quarts.iter().zip(biomes(&quarts)) { + if preferred.contains(&biome) { + if result.is_none() || search.next_int_bound(found + 1).unwrap_or(1) == 0 { + result = Some((quart[0] << 2, quart[2] << 2)); } + found += 1; } } match result { From bb3ec12ed07e71d8b4563a93c1cf86c72608fbea Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Mon, 19 Oct 2026 02:39:04 +0200 Subject: [PATCH 106/112] Carry: read data files with comments, as Minecraft does Minecraft reads data JSON with Gson's lenient reader, which skips `//`, `#` and `/* */` comments. Six of YUNG's template pools have them (Better Fortresses' bridges, halls and hall ends; Better Jungle Temples' floors), so carry refused them as unreadable and the structures lost those pieces: seed 1234's seven Better Fortresses had 265 pieces in all, now 3,765, and five Better Jungle Temples 170, now 196. A file that parses once its comments are gone is carried as plain JSON. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/carry.rs | 87 ++++++++++++++++++++++++++- 1 file changed, 86 insertions(+), 1 deletion(-) diff --git a/crates/horizon-port-pack/src/carry.rs b/crates/horizon-port-pack/src/carry.rs index 2f4af104c..0cf36b88b 100644 --- a/crates/horizon-port-pack/src/carry.rs +++ b/crates/horizon-port-pack/src/carry.rs @@ -343,7 +343,15 @@ fn unreadable(name: &str, bytes: &mut Vec<u8>) -> Option<String> { } let value: Value = match serde_json::from_slice(bytes) { Ok(v) => v, - Err(e) => return Some(format!("does not parse as JSON: {e}")), + // Minecraft reads data files with Gson's lenient reader, which skips + // comments: YUNG's pools have them. The carry is plain JSON. + Err(e) => match serde_json::from_slice::<Value>(&without_comments(bytes)) { + Ok(v) => { + *bytes = serde_json::to_vec_pretty(&v).expect("a parsed value serializes"); + v + } + Err(_) => return Some(format!("does not parse as JSON: {e}")), + }, }; let shared_tag = name.starts_with("data/minecraft/tags/") || name.starts_with("data/c/tags/"); if shared_tag && value.get("replace").and_then(Value::as_bool) == Some(true) { @@ -352,6 +360,53 @@ fn unreadable(name: &str, bytes: &mut Vec<u8>) -> Option<String> { None } +/// JSON text without the comments Gson's lenient reader skips: `//` and +/// `#` to the end of the line, and `/* ... */`, outside strings. +fn without_comments(bytes: &[u8]) -> Vec<u8> { + let mut out = Vec::with_capacity(bytes.len()); + let mut i = 0; + let mut string = false; + while i < bytes.len() { + let b = bytes[i]; + if string { + out.push(b); + if b == b'\\' { + out.extend(bytes.get(i + 1)); + i += 1; + } else if b == b'"' { + string = false; + } + i += 1; + continue; + } + match (b, bytes.get(i + 1)) { + (b'"', _) => { + string = true; + out.push(b); + i += 1; + } + (b'/', Some(b'/')) | (b'#', _) => { + while i < bytes.len() && bytes[i] != b'\n' { + i += 1; + } + } + (b'/', Some(b'*')) => { + i += 2; + while i < bytes.len() && !bytes[i..].starts_with(b"*/") { + i += 1; + } + i += 2; + out.push(b' '); + } + _ => { + out.push(b); + i += 1; + } + } + } + out +} + /// 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; @@ -800,6 +855,36 @@ mod tests { use super::*; use std::io::Write; + /// YUNG's pools carry comments, which Minecraft's lenient reader skips; + /// the carry holds them as plain JSON. A comment marker inside a string + /// stays, and text that is not JSON without its comments is refused. + #[test] + fn reads_json_with_comments_as_minecraft_does() { + let name = "data/m/worldgen/template_pool/bridge.json"; + let mut bytes = br#"{ + // Pillar w/ chance of unlit beacon + "elements": [ /* one */ {"weight": 20, "location": "m:a//b#c"} ], # done + "fallback": "minecraft:empty" +}"# + .to_vec(); + assert_eq!(unreadable(name, &mut bytes), None); + let v: Value = serde_json::from_slice(&bytes).unwrap(); + assert_eq!( + v, + json!({"elements": [{"weight": 20, "location": "m:a//b#c"}], + "fallback": "minecraft:empty"}) + ); + let mut plain = br#"{"a": "b\"//"}"#.to_vec(); + assert_eq!(unreadable(name, &mut plain), None); + assert_eq!(plain, br#"{"a": "b\"//"}"#.to_vec()); + let mut broken = b"{\"a\": 1} trailing".to_vec(); + assert!( + unreadable(name, &mut broken) + .unwrap() + .starts_with("does not parse") + ); + } + #[test] fn upgrades_ingredients() { let mut r = json!({"type": "minecraft:crafting_shaped", "pattern": ["##"], From be85b81d136d81054da2b370a3f138752d671f63 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Mon, 19 Oct 2026 02:50:14 +0200 Subject: [PATCH 107/112] YUNG's assembler: modifiers, piece_in_range and dead-end pools Better Nether Fortresses relies on three parts of YUNG's API the game did not have: - piece_in_range: another piece (of some templates, or any) inside the piece's box grown sideways, below and above. - Modifiers, applied once the layout is done, in piece order and with the assembler's random: a condition, then actions on the piece itself. transform swaps its template for one picked by setFeatureSeed(x, y, x) and moves it by an offset turned with the piece; delay_generation moves it to the end of the piece list. - Dead-end pools: a piece that got no child though it has other jigsaws is taken out (its parent's junction, its room and its count given back) and a piece of its dead-end pool is chosen for the same parent jigsaw. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../src/worldgen/structure/jigsaw.rs | 4 +- .../src/worldgen/structure/yung.rs | 447 ++++++++++++++++-- 2 files changed, 422 insertions(+), 29 deletions(-) diff --git a/crates/horizon-world/src/worldgen/structure/jigsaw.rs b/crates/horizon-world/src/worldgen/structure/jigsaw.rs index 34a2728f4..27651268d 100644 --- a/crates/horizon-world/src/worldgen/structure/jigsaw.rs +++ b/crates/horizon-world/src/worldgen/structure/jigsaw.rs @@ -30,7 +30,7 @@ pub enum Projection { Rigid, TerrainMatching, } -#[derive(Debug)] +#[derive(Clone, Debug)] pub enum PoolElement { Empty, Single { @@ -400,7 +400,7 @@ impl Pools { } } -#[derive(Clone, Copy, Debug)] +#[derive(Clone, Copy, Debug, PartialEq, Eq)] pub struct Junction { pub source_x: i32, pub source_ground_y: i32, diff --git a/crates/horizon-world/src/worldgen/structure/yung.rs b/crates/horizon-world/src/worldgen/structure/yung.rs index 07b363cfb..8298dfb4a 100644 --- a/crates/horizon-world/src/worldgen/structure/yung.rs +++ b/crates/horizon-world/src/worldgen/structure/yung.rs @@ -9,7 +9,10 @@ //! 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. +//! `max_y`. Pieces fit the same free space as vanilla's. A piece that ends +//! up with no child can be swapped for one of a dead-end pool, and once the +//! layout is done each piece's modifiers can turn it into another template +//! or place it last. use super::{ BoundingBox, Rotation, StructureResources, StructureTemplate, jigsaw::{ @@ -21,7 +24,7 @@ use crate::{ heightmap::HeightmapType, worldgen::{DecodeError, block_feature::FeatureBlockBindings}, }; -use horizon_core::random::RandomSource; +use horizon_core::random::{LegacyRandom, RandomSource, WorldgenRandom}; use serde_json::Value; use std::{ cell::RefCell, @@ -48,7 +51,7 @@ impl Config { } /// A piece's rules (`"horizon:yungsapi"` on a pool element). -#[derive(Debug, Default)] +#[derive(Clone, Debug, Default)] pub struct Rules { /// Pieces sharing a name share the cap `max_count`. name: Option<String>, @@ -60,6 +63,10 @@ pub struct Rules { /// Placed even where it overlaps other pieces or leaves the bounds. ignore_bounds: bool, condition: Condition, + /// The pool a piece that got no child is swapped for. + deadend_pool: Option<String>, + /// Applied to the piece once the layout is done. + modifiers: Vec<Modifier>, } impl Rules { pub fn decode(v: &Value, resources: &StructureResources) -> Result<Self, DecodeError> { @@ -75,6 +82,13 @@ impl Rules { Some(c) => Condition::decode(c, resources)?, None => Condition::True, }, + deadend_pool: v["deadend_pool"].as_str().map(str::to_owned), + modifiers: v["modifiers"] + .as_array() + .into_iter() + .flatten() + .map(|m| Modifier::decode(m, resources)) + .collect::<Result<_, _>>()?, }) } /// YungJigsawPoolElement.isAtValidDepth. @@ -88,8 +102,79 @@ impl Rules { } } +/// A StructureModifier: when its condition holds for the piece, its actions +/// apply to the piece (the `self` target, the only one YUNG's API has). +#[derive(Clone, Debug)] +struct Modifier { + condition: Condition, + actions: Vec<Action>, +} +impl Modifier { + fn decode(v: &Value, resources: &StructureResources) -> Result<Self, DecodeError> { + Ok(Self { + condition: match v.get("condition") { + Some(c) => Condition::decode(c, resources)?, + None => Condition::True, + }, + actions: v["actions"] + .as_array() + .ok_or(DecodeError::Field("modifier actions"))? + .iter() + .map(|a| Action::decode(a, resources)) + .collect::<Result<_, _>>()?, + }) + } +} + +#[derive(Clone, Debug)] +enum Action { + /// TransformAction: the piece becomes one of these templates, moved by + /// `offset` turned with the piece. + Transform { + output: Vec<Arc<StructureTemplate>>, + offset: [i32; 3], + }, + /// DelayGenerationAction: the piece is placed after every other. + DelayGeneration, +} +impl Action { + fn decode(v: &Value, resources: &StructureResources) -> Result<Self, DecodeError> { + Ok(match v["type"].as_str().unwrap_or_default() { + "transform" => { + let output = v["output"] + .as_array() + .into_iter() + .flatten() + .map(|t| { + let id = t.as_str().ok_or(DecodeError::Field("transform output"))?; + resources + .template(id) + .ok_or_else(|| DecodeError::Registry(format!("missing template {id}"))) + }) + .collect::<Result<Vec<_>, _>>()?; + if output.is_empty() { + return Err(DecodeError::Field("transform output")); + } + let offset = v["offset"].as_array(); + let at = |i: usize| { + offset + .and_then(|o| o.get(i)) + .and_then(Value::as_i64) + .unwrap_or(0) as i32 + }; + Self::Transform { + output, + offset: [at(0), at(1), at(2)], + } + } + "delay_generation" => Self::DelayGeneration, + _ => return Err(DecodeError::Field("YUNG modifier action type")), + }) + } +} + /// YUNG's structure conditions, as carry writes them. -#[derive(Debug, Default)] +#[derive(Clone, Debug, Default)] enum Condition { #[default] True, @@ -114,6 +199,14 @@ enum Condition { range: i32, rotation: Rotation, }, + /// Another piece (of these templates, or any when None) within the + /// piece's box grown by these ranges, not overlapping the piece. + PieceInRange { + templates: Option<Vec<Arc<StructureTemplate>>>, + horizontal: i32, + above: i32, + below: i32, + }, } impl Condition { fn decode(v: &Value, resources: &StructureResources) -> Result<Self, DecodeError> { @@ -163,6 +256,26 @@ impl Condition { range: int("range").unwrap_or(0), rotation: rotation(&v["rotation"])?, }, + "piece_in_range" => { + let pieces = v["pieces"] + .as_array() + .map(Vec::as_slice) + .unwrap_or_default(); + let any = pieces.is_empty() || pieces.iter().any(|p| p == "yungsapi:all"); + Self::PieceInRange { + // An unknown template matches nothing, as YUNG's API's + // empty stand-in does. + templates: (!any).then(|| { + pieces + .iter() + .filter_map(|p| resources.template(p.as_str()?)) + .collect() + }), + horizontal: int("horizontal_range").unwrap_or(0), + above: int("above_range").unwrap_or(0), + below: int("below_range").unwrap_or(0), + } + } _ => return Err(DecodeError::Field("YUNG condition type")), }) } @@ -179,7 +292,7 @@ impl Condition { 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]]); + let [low, high] = at.span; bottom.is_none_or(|y| f64::from(low) >= y) && top.is_none_or(|y| f64::from(high) <= y) } @@ -200,16 +313,35 @@ impl Condition { 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) + at.near(piece, &search, |template| { + templates.is_empty() || templates.iter().any(|t| Arc::ptr_eq(t, template)) + }) + } + Self::PieceInRange { + templates, + horizontal, + above, + below, + } => { + let Some(piece) = at.piece else { + return false; + }; + let search = BoundingBox::new( + [ + piece.min[0] - horizontal, + piece.min[1] - below, + piece.min[2] - horizontal, + ], + [ + piece.max[0] + horizontal, + piece.max[1] + above, + piece.max[2] + horizontal, + ], + ); + at.near(piece, &search, |template| { + templates + .as_ref() + .is_none_or(|ts| ts.iter().any(|t| Arc::ptr_eq(t, template))) }) } } @@ -226,12 +358,38 @@ impl<C: JigsawContext> JigsawContextDyn for C { } } -/// What a condition sees of the piece being placed. +/// What a condition sees of the piece being placed (or modified). struct At<'a> { depth: i32, rotation: Rotation, piece: Option<BoundingBox>, + /// The piece's lowest and highest Y when the condition was set up. + span: [i32; 2], pieces: &'a [PoolPiece], + /// Pieces taken out by a dead end, by index; the rest are kept. + gone: &'a [bool], +} +impl At<'_> { + /// Whether another single piece whose template matches lies in `search` + /// without overlapping `piece` (nor being exactly it). + fn near( + &self, + piece: BoundingBox, + search: &BoundingBox, + matches: impl Fn(&Arc<StructureTemplate>) -> bool, + ) -> bool { + self.pieces.iter().enumerate().any(|(i, other)| { + let PoolElement::Single { template, .. } = other.element.as_ref() else { + return false; + }; + let b = other.bounding_box; + !self.gone.get(i).copied().unwrap_or(false) + && b != piece + && matches(template) + && b.intersects(search) + && !b.intersects(&piece) + }) + } } /// The index of the entry to try: the first priority piece, else one drawn @@ -300,7 +458,9 @@ pub fn assemble( depth: 0, rotation, piece: None, + span: [0, 0], pieces: &[], + gone: &[], }; if element .yung() @@ -342,6 +502,8 @@ pub fn assemble( bindings, pieces: vec![start], states: vec![(free, 0)], + origins: vec![None], + gone: vec![false], counts: HashMap::new(), }; if config.max_depth > 0 { @@ -350,7 +512,7 @@ pub fn assemble( assembler.children(piece, &mut queue, context, random); } } - Some(([cx, cy, cz], assembler.pieces)) + Some(([cx, cy, cz], assembler.modified(random))) } /// JigsawStructureAssembler. @@ -363,14 +525,20 @@ struct Assembler<'a> { pieces: Vec<PoolPiece>, /// Per piece: the free space it was placed in, and its depth. states: Vec<(Rc<RefCell<Free>>, i32)>, + /// Per piece: where it was placed and the junction it left on its + /// parent (none for the start piece), for a dead end to undo. + origins: Vec<Option<(Slot, Junction)>>, + /// Per piece: taken out by a dead end. + gone: Vec<bool>, /// Pieces placed per capped name. counts: HashMap<String, i32>, } /// Where a child goes: the parent's jigsaw and what it needs. -struct Slot<'s> { +#[derive(Clone)] +struct Slot { source: usize, - jigsaw: &'s super::jigsaw::Jigsaw, + jigsaw: super::jigsaw::Jigsaw, target_pos: [i32; 3], free: Rc<RefCell<Free>>, depth: i32, @@ -403,7 +571,10 @@ impl Assembler<'_> { }; 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 jigsaws = element.shuffled_jigsaws(self.resources, position, rotation, random); + let count = jigsaws.len(); + let mut any = false; + for jigsaw in jigsaws { let Some(target) = self.pool(&jigsaw.pool) else { continue; }; @@ -432,28 +603,119 @@ impl Assembler<'_> { }; let slot = Slot { source, - jigsaw: &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); + any |= placed || self.choose(&slot, fallback.raw.clone(), queue, context, random); + } + if let Some(pool) = element.yung().and_then(|r| r.deadend_pool.as_deref()) + && !any + && count > 1 + { + self.dead_end(source, pool, queue, context, random); + } + } + /// A piece with a dead-end pool that got no child though it has other + /// jigsaws is taken out, its parent's junction and its room freed and its + /// count given back, and a piece of that pool is chosen in its place for + /// the same parent jigsaw. The start piece stays. + fn dead_end( + &mut self, + piece: usize, + pool: &str, + queue: &mut VecDeque<usize>, + context: &mut impl JigsawContext, + random: &mut impl RandomSource, + ) { + let Some(pool) = self.pool(pool) else { + return; + }; + let Some((slot, junction)) = self.origins[piece].clone() else { + return; + }; + let parent = &mut self.pieces[slot.source].junctions; + if let Some(i) = parent.iter().position(|j| *j == junction) { + parent.remove(i); + } + let bounds = self.pieces[piece].bounding_box; + { + let mut free = slot.free.borrow_mut(); + if let Some(i) = free.removed.iter().position(|b| *b == bounds) { + free.removed.remove(i); } } + self.gone[piece] = true; + let element = self.pieces[piece].element.clone(); + if let Some((name, _)) = element.yung().and_then(Rules::capped) + && let Some(count) = self.counts.get_mut(name) + { + *count -= 1; + } + self.choose(&slot, pool.raw.clone(), queue, context, random); + } + /// applyModifications: each piece's modifiers, in piece order, then the + /// delayed pieces moved last. Returns the pieces kept. + fn modified(mut self, random: &mut impl RandomSource) -> Vec<PoolPiece> { + let mut delayed = vec![false; self.pieces.len()]; + for (i, delay) in delayed.iter_mut().enumerate() { + let element = self.pieces[i].element.clone(); + let Some(rules) = element + .yung() + .filter(|r| !self.gone[i] && !r.modifiers.is_empty()) + else { + continue; + }; + let b = self.pieces[i].bounding_box; + let (depth, rotation, span) = ( + self.states[i].1, + self.pieces[i].rotation, + [b.min[1], b.max[1]], + ); + for modifier in &rules.modifiers { + let at = At { + depth, + rotation, + piece: Some(self.pieces[i].bounding_box), + span, + pieces: &self.pieces, + gone: &self.gone, + }; + if !modifier.condition.passes(&at, random) { + continue; + } + for action in &modifier.actions { + match action { + Action::Transform { output, offset } => { + transform(&mut self.pieces[i], output, *offset); + } + Action::DelayGeneration => *delay = true, + } + } + } + } + let (mut kept, mut last) = (Vec::new(), Vec::new()); + for ((piece, gone), delay) in self.pieces.into_iter().zip(self.gone).zip(delayed) { + if !gone { + if delay { &mut last } else { &mut kept }.push(piece); + } + } + kept.extend(last); + kept } /// chooseCandidateFromPool: whether a piece was placed. fn choose( &mut self, - slot: &Slot<'_>, + 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 jigsaw = &slot.jigsaw; let (source_rigid, source_y, source_ground) = { let s = &self.pieces[slot.source]; ( @@ -561,16 +823,19 @@ impl Assembler<'_> { depth: slot.depth + 1, rotation, piece: Some(target_box), + span: [target_box.min[1], target_box.max[1]], pieces: &self.pieces, + gone: &self.gone, }; if rules.is_some_and(|r| !r.condition.passes(&at, random)) { continue; } - self.pieces[slot.source].junctions.push(Junction { + let on_parent = Junction { source_x: slot.target_pos[0], source_ground_y: junction_y - local_y + source_ground, source_z: slot.target_pos[2], - }); + }; + self.pieces[slot.source].junctions.push(on_parent); slot.free.borrow_mut().removed.push(target_box); self.pieces.push(PoolPiece { element: target.clone(), @@ -586,6 +851,8 @@ impl Assembler<'_> { waterlogging: self.config.waterlogging, }); self.states.push((slot.free.clone(), slot.depth + 1)); + self.origins.push(Some((slot.clone(), on_parent))); + self.gone.push(false); if slot.depth < self.config.max_depth { queue.push_back(self.pieces.len() - 1); } @@ -602,6 +869,39 @@ impl Assembler<'_> { } } +/// TransformAction: the piece takes one of `output`'s templates, picked by a +/// random seeded with setFeatureSeed(x, y, x) of its position, and moves by +/// `offset` turned with it. Like YUNG's API's new piece, it loses its +/// junctions and takes its own liquid setting (else waterlogging). +fn transform(piece: &mut PoolPiece, output: &[Arc<StructureTemplate>], offset: [i32; 3]) { + let [x, y, _] = piece.position; + let mut random = WorldgenRandom::new(LegacyRandom::new(0)); + random.set_feature_seed(i64::from(x), y, x); + let chosen = random.next_int_bound(output.len() as i32).unwrap_or(0) as usize; + let mut element = (*piece.element).clone(); + let PoolElement::Single { + template, + waterlogging, + .. + } = &mut element + else { + return; + }; + *template = output[chosen].clone(); + piece.waterlogging = waterlogging.unwrap_or(true); + let [dx, dy, dz] = offset; + let [dx, dz] = match piece.rotation { + Rotation::None => [dx, dz], + Rotation::Clockwise90 => [-dz, dx], + Rotation::Clockwise180 => [-dx, -dz], + Rotation::Counterclockwise90 => [dz, -dx], + }; + piece.position = [x + dx, y + dy, piece.position[2] + dz]; + piece.bounding_box = element.bounding_box(piece.position, piece.rotation); + piece.element = Arc::new(element); + piece.junctions.clear(); +} + #[cfg(test)] mod tests { use super::*; @@ -680,7 +980,9 @@ mod tests { depth, rotation, piece: Some(BoundingBox::new([0, 10, 0], [4, 14, 4])), + span: [10, 14], pieces: &pieces, + gone: &[], }; let mut random = LegacyRandom::new(1); let depth = Condition::Depth { @@ -704,6 +1006,7 @@ mod tests { 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])), + span: [0, 4], ..at(Rotation::None, 1) }; assert!(north(Vec::new(), Rotation::None).passes(&low, &mut random)); @@ -724,4 +1027,94 @@ mod tests { assert!(all.passes(&turned, &mut random)); assert!(!Condition::AnyOf(vec![Condition::False]).passes(&turned, &mut random)); } + + #[test] + fn piece_in_range_searches_a_grown_box() { + let t = Arc::new(StructureTemplate::empty()); + let other = Arc::new(StructureTemplate::empty()); + let piece = BoundingBox::new([0, 0, 0], [4, 4, 4]); + let above = |gone: &'static [bool]| { + let pieces = vec![PoolPiece { + element: single(&t, None), + position: [0, 30, 0], + ground_level_delta: 1, + rotation: Rotation::None, + bounding_box: BoundingBox::new([0, 30, 0], [4, 34, 4]), + junctions: Vec::new(), + waterlogging: true, + }]; + (pieces, gone) + }; + let range = |templates, above| Condition::PieceInRange { + templates, + horizontal: 0, + above, + below: 0, + }; + let mut random = LegacyRandom::new(1); + let (pieces, gone) = above(&[]); + let at = At { + depth: 1, + rotation: Rotation::None, + piece: Some(piece), + span: [0, 4], + pieces: &pieces, + gone, + }; + // 26 blocks above the piece's top: in a 40-block search, not 20. + assert!(range(None, 40).passes(&at, &mut random)); + assert!(!range(None, 20).passes(&at, &mut random)); + assert!(range(Some(vec![t.clone()]), 40).passes(&at, &mut random)); + assert!(!range(Some(vec![other]), 40).passes(&at, &mut random)); + // An unknown template matches nothing; a piece taken out by a dead + // end is not seen. + assert!(!range(Some(Vec::new()), 40).passes(&at, &mut random)); + let (pieces, gone) = above(&[true]); + let at = At { + pieces: &pieces, + gone, + ..at + }; + assert!(!range(None, 40).passes(&at, &mut random)); + } + + #[test] + fn transform_picks_by_position_and_turns_its_offset() { + let (a, b) = ( + Arc::new(StructureTemplate::empty()), + Arc::new(StructureTemplate::empty()), + ); + let rules = Rules { + name: Some("pillar".into()), + ..Rules::default() + }; + let mut piece = PoolPiece { + element: single(&a, Some(rules)), + position: [100, 40, -7], + ground_level_delta: 1, + rotation: Rotation::Clockwise90, + bounding_box: BoundingBox::new([100, 40, -7], [104, 44, -3]), + junctions: vec![Junction { + source_x: 0, + source_ground_y: 0, + source_z: 0, + }], + waterlogging: false, + }; + transform(&mut piece, &[a.clone(), b.clone()], [-1, 2, 0]); + // setFeatureSeed(x, y, x): seed x + y + 10000 * x, then nextInt(2). + let mut java = LegacyRandom::new(100 + 40 + 10000 * 100); + let chosen = [&a, &b][java.next_int_bound(2).unwrap() as usize]; + let PoolElement::Single { template, yung, .. } = piece.element.as_ref() else { + panic!("not a single element"); + }; + assert!(Arc::ptr_eq(template, chosen)); + assert_eq!( + yung.as_ref().and_then(|r| r.name.as_deref()), + Some("pillar") + ); + // (-1, 2, 0) turned 90° clockwise is (0, 2, -1). + assert_eq!(piece.position, [100, 42, -8]); + assert!(piece.junctions.is_empty() && piece.waterlogging); + } } From 8e095b88fa9eb2a1036e85702cc1190d55c96dd2 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Mon, 19 Oct 2026 04:17:42 +0200 Subject: [PATCH 108/112] Carry: write Lithostitched's processor references in lithostitched:reference runs the processors of other lists in turn. Carry now writes their processors in its place, in order and references in them too, from the mod's own processor lists. A reference to a tag or to a list the mod lacks stays, and is dropped and counted as before. ChoiceTheorem's Overhauled Village builds most of its lists this way. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/processors.rs | 102 ++++++++++++++++++++- 1 file changed, 99 insertions(+), 3 deletions(-) diff --git a/crates/horizon-port-pack/src/processors.rs b/crates/horizon-port-pack/src/processors.rs index 33cde2f99..db099972f 100644 --- a/crates/horizon-port-pack/src/processors.rs +++ b/crates/horizon-port-pack/src/processors.rs @@ -10,6 +10,9 @@ //! 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. +//! - Lithostitched's `reference` runs other processor lists in turn: their +//! processors are written in its place (Choice Theorem's Overhauled +//! Villages builds most of its lists so). //! //! 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 @@ -29,6 +32,8 @@ pub struct ProcessorData { /// Moog's "replace vanilla" presets that are on by default: /// `(mod id, vanilla_key)`. pub replace_vanilla: BTreeSet<(String, String)>, + /// The mod's processor lists by id, for Lithostitched's references. + pub lists: BTreeMap<String, Value>, } impl ProcessorData { @@ -47,7 +52,8 @@ impl ProcessorData { continue; }; let spawners = rest.strip_prefix("rs_spawners/"); - if spawners.is_none() && rest != "moogs_structures/replace_vanilla" { + let list = rest.strip_prefix("worldgen/processor_list/"); + if spawners.is_none() && list.is_none() && rest != "moogs_structures/replace_vanilla" { continue; } let mut text = String::new(); @@ -58,6 +64,10 @@ impl ProcessorData { else { continue; }; + if let Some(path) = list { + out.lists.insert(format!("{ns}:{path}"), v); + continue; + } if let Some(path) = spawners { let mobs = v["mobs"] .as_array() @@ -133,8 +143,10 @@ pub fn carry( return false; }; let mut changed = false; - let mut out = Vec::with_capacity(list.len()); - for p in list.drain(..) { + let expanded = references(std::mem::take(list), data, carried, 0); + changed |= expanded.1; + let mut out = Vec::with_capacity(expanded.0.len()); + for p in expanded.0 { let kind = p["processor_type"].as_str().unwrap_or_default().to_owned(); match as_data(&kind, &p, data) { Some(replacement) => { @@ -193,6 +205,60 @@ pub fn rule_tests(kind: &str, v: &mut Value, carried: &mut BTreeMap<String, usiz each_list(kind, v, &mut |list| rename(list, carried)) } +/// Lithostitched's references in a list, each replaced by the processors of +/// the lists it names, in order (references in them too, to a depth of 8). +/// One naming a tag or a list the mod does not have stays, to be dropped. +/// Whether any was replaced. +fn references( + list: Vec<Value>, + data: &ProcessorData, + carried: &mut BTreeMap<String, usize>, + depth: usize, +) -> (Vec<Value>, bool) { + let mut out = Vec::with_capacity(list.len()); + let mut changed = false; + for p in list { + let named = (p["processor_type"] == "lithostitched:reference" && depth < 8) + .then(|| referenced(&p["processor_lists"], data)) + .flatten(); + match named { + Some(inner) => { + *carried.entry("lithostitched:reference".into()).or_default() += 1; + out.extend(references(inner, data, carried, depth + 1).0); + changed = true; + } + None => out.push(p), + } + } + (out, changed) +} + +/// The processors of the lists a reference names: an id, an inline list, or +/// a list of either. +fn referenced(lists: &Value, data: &ProcessorData) -> Option<Vec<Value>> { + let one = |l: &Value| -> Option<Vec<Value>> { + let mut list = match l { + Value::String(id) if !id.starts_with('#') => { + let id = if id.contains(':') { + id.clone() + } else { + format!("minecraft:{id}") + }; + data.lists.get(&id)?.clone() + } + Value::Object(_) | Value::Array(_) => l.clone(), + _ => return None, + }; + processors(&mut list).map(std::mem::take) + }; + match lists { + // A bare list of processors is one inline list; else a list of lists. + Value::Array(a) if a.iter().any(|x| x.get("processor_type").is_some()) => Some(a.clone()), + Value::Array(a) => Some(a.iter().map(one).collect::<Option<Vec<_>>>()?.concat()), + other => one(other), + } +} + /// 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>> { @@ -963,6 +1029,36 @@ mod tests { assert_eq!(p[1]["processor_type"], "lithostitched:block_swap"); } + #[test] + fn lithostitched_references_are_written_in() { + let mut data = data(); + let gravity = json!({"processor_type": "minecraft:gravity", "heightmap": "WORLD_SURFACE_WG", "offset": 0}); + data.lists + .insert("v:road".into(), json!({"processors": [gravity.clone()]})); + data.lists.insert( + "v:house".into(), + json!({"processors": [ + {"processor_type": "lithostitched:reference", "processor_lists": "v:road"}, + {"processor_type": "lithostitched:block_swap", "blocks": {"minecraft:dirt": "minecraft:grass_block"}}]}), + ); + let mut list = json!({"processors": [ + {"processor_type": "lithostitched:reference", "processor_lists": ["v:house", "v:road"]}, + {"processor_type": "lithostitched:reference", "processor_lists": "#v:roads"}, + {"processor_type": "lithostitched:reference", "processor_lists": ["v:nowhere"]}]}); + let mut carried = BTreeMap::new(); + assert!(carry("processor_list", &mut list, &data, &mut carried)); + let p = list["processors"].as_array().unwrap(); + // House (its own reference to road first, then its swap), then road; + // the swap inside is carried too. + assert_eq!(p[0], gravity); + assert_eq!(p[1]["processor_type"], "horizon:block_swap"); + assert_eq!(p[2], gravity); + // A tag or a list the mod lacks stays, to be dropped. + assert_eq!(p[3]["processor_lists"], "#v:roads"); + assert_eq!(p[4]["processor_lists"], json!(["v:nowhere"])); + assert_eq!(carried["lithostitched:reference"], 2); + } + #[test] fn repurposed_rule_tests_become_the_games() { let rule = |input: Value, position: Value| { From 2647ed7ed02c734d895882adb1d44ad8851cd793 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Mon, 19 Oct 2026 04:23:03 +0200 Subject: [PATCH 109/112] Structure processors: Lithostitched's apply_random, condition and set_block as data horizon:apply_random runs one processor list drawn by weight (WeightedList.getRandom); horizon:condition runs `then` or `else` by a test of the block (true, all_of, any_of, not, random_chance and matching_blocks on the placed or the existing block). Both take their random from Lithostitched's RandomSettings: seeded with the world seed plus the name's hash, forked positionally at the block, the piece or the structure's pivot. process_block now gets the piece's position for it. horizon:set_block is Lithostitched's set_block with a simple or weighted state provider: the block becomes the state (drawn at the chosen position from the unsalted seed), keeping the properties it shares with the old one unless preserve_state is off. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- .../src/worldgen/structure/processor.rs | 84 +++- .../structure/processor/lithostitched.rs | 434 ++++++++++++++++++ 2 files changed, 517 insertions(+), 1 deletion(-) create mode 100644 crates/horizon-world/src/worldgen/structure/processor/lithostitched.rs diff --git a/crates/horizon-world/src/worldgen/structure/processor.rs b/crates/horizon-world/src/worldgen/structure/processor.rs index 980a90848..dd65ccd56 100644 --- a/crates/horizon-world/src/worldgen/structure/processor.rs +++ b/crates/horizon-world/src/worldgen/structure/processor.rs @@ -21,6 +21,8 @@ use horizon_core::{ use serde_json::Value; use std::{collections::BTreeSet, sync::Arc}; +mod lithostitched; + /// The draws processors make from StructurePlaceSettings' random. pub trait ProcessorRandom { fn float(&mut self) -> f32; @@ -291,6 +293,14 @@ pub enum Processor { /// `horizon:block_swap` (Lithostitched's `block_swap`): blocks by name /// become others, keeping the properties both have. BlockSwap(std::collections::BTreeMap<String, String>), + /// `horizon:apply_random` (Lithostitched's `apply_random`): a processor + /// list drawn by weight runs on the block. + ApplyRandom(Box<lithostitched::ApplyRandom>), + /// `horizon:condition` (Lithostitched's `condition`): `then` or `else` + /// runs on the block, by a test of it. + Condition(Box<lithostitched::Conditional>), + /// `horizon:set_block` (Lithostitched's `set_block`). + SetBlock(Box<lithostitched::SetBlock>), } #[derive(Clone, Debug, Default)] pub struct ProcessorList(pub Vec<Processor>); @@ -744,6 +754,15 @@ impl Processor { .collect::<Result<_, DecodeError>>()?, ), "horizon:count_cap" => Self::CountCap(Box::new(CountCap::decode(value, state)?)), + "horizon:apply_random" => Self::ApplyRandom(Box::new( + lithostitched::ApplyRandom::decode(value, resources, bindings)?, + )), + "horizon:set_block" => { + Self::SetBlock(Box::new(lithostitched::SetBlock::decode(value, state)?)) + } + "horizon:condition" => Self::Condition(Box::new(lithostitched::Conditional::decode( + value, resources, bindings, + )?)), _ => return Err(DecodeError::Field("structure processor type")), }) } @@ -880,11 +899,37 @@ fn blackstone(name: &str) -> Option<&'static str> { }) } type ProcessResult = Result<Option<BlockInfo>, PlacementQueryError>; +/// The processors of a list in turn, until one removes the block. +#[allow(clippy::too_many_arguments)] +fn process_list<W: PlacementContext>( + list: &ProcessorList, + world: &mut W, + resources: &StructureResources, + position: [i32; 3], + reference: [i32; 3], + relative: [i32; 3], + info: BlockInfo, + settings: &mut PlaceSettings<'_>, +) -> ProcessResult { + let mut current = info; + for processor in &list.0 { + match process_block( + processor, world, resources, position, reference, relative, current, settings, + )? { + Some(next) => current = next, + None => return Ok(None), + } + } + Ok(Some(current)) +} +/// StructureProcessor.processBlock: `position` is the piece's, `reference` +/// the structure's pivot and `relative` the block's in the template. #[allow(clippy::too_many_arguments)] fn process_block<W: PlacementContext>( processor: &Processor, world: &mut W, resources: &StructureResources, + position: [i32; 3], reference: [i32; 3], relative: [i32; 3], info: BlockInfo, @@ -1028,6 +1073,42 @@ fn process_block<W: PlacementContext>( } false => Some(info), }, + Processor::ApplyRandom(apply) => { + let seed = world.world_seed()?; + let mut random = apply.random.create(seed, position, reference, info.pos); + match apply.pick(&mut random) { + Some(list) => { + return process_list( + list, world, resources, position, reference, relative, info, settings, + ); + } + None => Some(info), + } + } + Processor::SetBlock(set) => { + let seed = world.world_seed()?; + let state = set.state(seed, position, reference, info.pos); + let state = match set.preserves() { + true => registry + .state(state) + .and_then(|s| with_properties_of(registry, &s.name, info.state)) + .unwrap_or(state), + false => state, + }; + Some(BlockInfo { state, ..info }) + } + Processor::Condition(c) => { + let seed = world.world_seed()?; + let mut random = c.random.create(seed, position, reference, info.pos); + let location = world.block_state(info.pos)?; + let passed = c + .condition + .test(info.state, location, registry, &mut random); + let list = if passed { &c.then } else { &c.otherwise }; + return process_list( + list, world, resources, position, reference, relative, info, settings, + ); + } Processor::Pick(pick) => match name(info.state) == pick.block { true => Some(settings.with_random(info.pos, |r| pick.apply(info, r))), false => Some(info), @@ -1176,7 +1257,7 @@ fn process_infos<W: PlacementContext>( for processor in processors { let Some(value) = current.take() else { break }; current = process_block( - processor, world, resources, reference, info.pos, value, settings, + processor, world, resources, position, reference, info.pos, value, settings, )?; } if let Some(value) = current { @@ -1220,6 +1301,7 @@ fn process_infos<W: PlacementContext>( delegate, world, resources, + position, reference, original[index].pos, before.clone(), diff --git a/crates/horizon-world/src/worldgen/structure/processor/lithostitched.rs b/crates/horizon-world/src/worldgen/structure/processor/lithostitched.rs new file mode 100644 index 000000000..f0bb1c6ba --- /dev/null +++ b/crates/horizon-world/src/worldgen/structure/processor/lithostitched.rs @@ -0,0 +1,434 @@ +//! Lithostitched's processors that pick processors, carried as data +//! (`horizon:apply_random` and `horizon:condition`): one runs a processor +//! list drawn by weight, the other one list or another by a test of the +//! block. Both draw from Lithostitched's RandomSettings: a random seeded from +//! the world seed and a name, at the block, the piece or the structure. +//! `horizon:set_block` is its `set_block`, which the conditions mostly run. +use super::{Processor, ProcessorList}; +use crate::{ + registry::{BlockRegistry, BlockStateId}, + worldgen::{DecodeError, block_feature::FeatureBlockBindings, structure::StructureResources}, +}; +use horizon_core::{ + position::BlockPos, + random::{LegacyRandom, PositionalRandom, RandomSource}, +}; +use serde_json::Value; +use std::{collections::BTreeSet, sync::Arc}; + +/// RandomSettings: where the random is taken, and the name salting it. +#[derive(Clone, Debug, PartialEq)] +pub struct RandomSettings { + mode: Mode, + /// ResourceLocation.hashCode of the name (`lithostitched:default`). + salt: i32, +} +#[derive(Clone, Copy, Debug, PartialEq)] +enum Mode { + Block, + Piece, + Structure, +} +impl RandomSettings { + /// A mode alone, or `{"mode": ..., "name": ...}`; per block when unset. + fn decode(v: Option<&Value>) -> Result<Self, DecodeError> { + let mode = Mode::decode; + let (mode, name) = match v { + None => (Mode::Block, "lithostitched:default"), + Some(Value::String(m)) => (mode(Some(m))?, "lithostitched:default"), + Some(o) => ( + mode(o["mode"].as_str())?, + o["name"] + .as_str() + .ok_or(DecodeError::Field("random name"))?, + ), + }; + let (namespace, path) = name.split_once(':').unwrap_or(("minecraft", name)); + Ok(Self { + mode, + salt: java_hash(namespace) + .wrapping_mul(31) + .wrapping_add(java_hash(path)), + }) + } + /// RandomSource.create(seed + hash).forkPositional().at(the chosen + /// position): the piece's position, the structure's pivot or the block. + pub(super) fn create( + &self, + seed: i64, + piece: [i32; 3], + pivot: [i32; 3], + block: [i32; 3], + ) -> LegacyRandom { + let [x, y, z] = self.mode.select(piece, pivot, block); + LegacyRandom::new(seed.wrapping_add(i64::from(self.salt))) + .fork_positional() + .at(BlockPos::new(x, y, z)) + } +} +impl Mode { + fn decode(m: Option<&str>) -> Result<Self, DecodeError> { + match m { + None | Some("per_block") => Ok(Self::Block), + Some("per_piece") => Ok(Self::Piece), + Some("per_structure") => Ok(Self::Structure), + _ => Err(DecodeError::Field("random mode")), + } + } + fn select(self, piece: [i32; 3], pivot: [i32; 3], block: [i32; 3]) -> [i32; 3] { + match self { + Self::Block => block, + Self::Piece => piece, + Self::Structure => pivot, + } + } +} + +/// SetBlockProcessor with a simple or weighted state provider and no block +/// entity change: the block becomes the state, keeping the properties it +/// shares with the old one unless `preserve_state` is off. +#[derive(Clone, Debug)] +pub struct SetBlock { + /// The states and their weights; one state alone is a simple provider, + /// which draws nothing. + states: Vec<(BlockStateId, i32)>, + weighted: bool, + preserve: bool, + mode: Mode, +} +impl SetBlock { + pub(super) fn decode( + v: &Value, + state: impl Fn(&Value) -> Result<BlockStateId, DecodeError>, + ) -> Result<Self, DecodeError> { + let provider = &v["state_provider"]; + let (states, weighted) = match provider["type"].as_str() { + Some("minecraft:simple_state_provider") => { + (vec![(state(&provider["state"])?, 1)], false) + } + Some("minecraft:weighted_state_provider") => ( + provider["entries"] + .as_array() + .ok_or(DecodeError::Field("set_block entries"))? + .iter() + .map(|e| { + let weight = e["weight"] + .as_i64() + .ok_or(DecodeError::Field("set_block weight"))?; + Ok((state(&e["data"])?, weight as i32)) + }) + .collect::<Result<_, DecodeError>>()?, + true, + ), + _ => return Err(DecodeError::Field("set_block state_provider")), + }; + if states.is_empty() { + return Err(DecodeError::Field("set_block entries")); + } + Ok(Self { + states, + weighted, + preserve: v["preserve_state"].as_bool().unwrap_or(true), + mode: Mode::decode(v["random_mode"].as_str())?, + }) + } + /// The state to set, before `preserve`: drawn with + /// RandomSource.create(seed).forkPositional().at(the chosen position). + pub(super) fn state( + &self, + seed: i64, + piece: [i32; 3], + pivot: [i32; 3], + block: [i32; 3], + ) -> BlockStateId { + if !self.weighted { + return self.states[0].0; + } + let [x, y, z] = self.mode.select(piece, pivot, block); + let mut random = LegacyRandom::new(seed) + .fork_positional() + .at(BlockPos::new(x, y, z)); + let total: i32 = self.states.iter().map(|s| s.1).sum(); + let mut value = random.next_int_bound(total.max(1)).unwrap_or(0); + for (state, weight) in &self.states { + if value < *weight { + return *state; + } + value -= weight; + } + self.states[0].0 + } + pub(super) fn preserves(&self) -> bool { + self.preserve + } +} + +/// String.hashCode over UTF-16 units. +fn java_hash(s: &str) -> i32 { + s.encode_utf16() + .fold(0i32, |h, c| h.wrapping_mul(31).wrapping_add(i32::from(c))) +} + +fn list( + v: &Value, + resources: &StructureResources, + bindings: &FeatureBlockBindings<'_>, +) -> Result<ProcessorList, DecodeError> { + ProcessorList::decode(&v.to_string(), resources, bindings) +} + +/// ApplyRandomStructureProcessor: a weighted list of processor lists, one +/// drawn per block with `nextInt(total)`. +#[derive(Clone, Debug)] +pub struct ApplyRandom { + pub(super) random: RandomSettings, + lists: Vec<(ProcessorList, i32)>, + total: i32, +} +impl ApplyRandom { + pub(super) fn decode( + v: &Value, + resources: &StructureResources, + bindings: &FeatureBlockBindings<'_>, + ) -> Result<Self, DecodeError> { + let lists = v["processor_lists"] + .as_array() + .ok_or(DecodeError::Field("apply_random processor_lists"))? + .iter() + .map(|e| { + let weight = e["weight"] + .as_i64() + .ok_or(DecodeError::Field("apply_random weight"))?; + Ok((list(&e["data"], resources, bindings)?, weight as i32)) + }) + .collect::<Result<Vec<_>, DecodeError>>()?; + Ok(Self { + random: RandomSettings::decode(v.get("mode"))?, + total: lists.iter().map(|l| l.1).sum(), + lists, + }) + } + /// WeightedList.getRandom: none when the weights add up to 0. + pub(super) fn pick(&self, random: &mut impl RandomSource) -> Option<&ProcessorList> { + if self.total <= 0 { + return None; + } + let mut value = random.next_int_bound(self.total).unwrap_or(0); + for (list, weight) in &self.lists { + if value < *weight { + return Some(list); + } + value -= weight; + } + None + } +} + +/// ConditionProcessor: `then` when the condition holds for the block, else +/// `else`. +#[derive(Clone, Debug)] +pub struct Conditional { + pub(super) random: RandomSettings, + pub(super) condition: Condition, + pub(super) then: ProcessorList, + pub(super) otherwise: ProcessorList, +} +impl Conditional { + pub(super) fn decode( + v: &Value, + resources: &StructureResources, + bindings: &FeatureBlockBindings<'_>, + ) -> Result<Self, DecodeError> { + // A processor alone or a list of them. + let processors = |key: &str| -> Result<ProcessorList, DecodeError> { + match v.get(key) { + None => Ok(ProcessorList::default()), + Some(Value::Object(p)) if p.contains_key("processor_type") => Ok(ProcessorList( + vec![Processor::decode(&v[key], resources, bindings)?], + )), + Some(other) => list(other, resources, bindings), + } + }; + Ok(Self { + random: RandomSettings::decode(v.get("random_mode"))?, + condition: Condition::decode(&v["if_true"], bindings)?, + then: processors("then")?, + otherwise: processors("else")?, + }) + } +} + +/// Lithostitched's processor conditions the game runs. +#[derive(Clone, Debug)] +pub(super) enum Condition { + True, + AllOf(Vec<Condition>), + AnyOf(Vec<Condition>), + Not(Box<Condition>), + RandomChance(f32), + /// The block placed (`input`) or the one in the world (`location`) is + /// one of these, with these property values. + MatchingBlocks { + blocks: Arc<BTreeSet<BlockStateId>>, + properties: Vec<(String, String)>, + location: bool, + }, +} +impl Condition { + fn decode(v: &Value, bindings: &FeatureBlockBindings<'_>) -> Result<Self, DecodeError> { + let all = |a: &Value| -> Result<Vec<Condition>, DecodeError> { + a.as_array() + .ok_or(DecodeError::Field("processor conditions"))? + .iter() + .map(|c| Self::decode(c, bindings)) + .collect() + }; + if v.is_array() { + return Ok(Self::AllOf(all(v)?)); + } + let kind = v["type"].as_str().unwrap_or_default(); + Ok(match kind.strip_prefix("lithostitched:").unwrap_or(kind) { + "true" => Self::True, + "all_of" => Self::AllOf(all(&v["conditions"])?), + "any_of" => Self::AnyOf(all(&v["conditions"])?), + "not" => Self::Not(Box::new(Self::decode(&v["condition"], bindings)?)), + "random_chance" => Self::RandomChance(super::float(v, "chance")?), + "matching_blocks" => Self::MatchingBlocks { + blocks: super::holder_set(&v["blocks"], bindings)?, + properties: match v.get("properties") { + None => Vec::new(), + Some(p) => p + .as_object() + .ok_or(DecodeError::Field("matching_blocks properties"))? + .iter() + .map(|(k, x)| { + let x = x + .as_str() + .ok_or(DecodeError::Field("matching_blocks property"))?; + Ok((k.clone(), x.to_owned())) + }) + .collect::<Result<_, DecodeError>>()?, + }, + location: match v["match_type"].as_str() { + None | Some("input") => false, + Some("location") => true, + _ => return Err(DecodeError::Field("matching_blocks match_type")), + }, + }, + _ => return Err(DecodeError::Field("processor condition type")), + }) + } + /// ProcessorCondition.test with the block placed and the one there. + pub(super) fn test( + &self, + input: BlockStateId, + location: BlockStateId, + registry: &BlockRegistry, + random: &mut impl RandomSource, + ) -> bool { + match self { + Self::True => true, + Self::AllOf(all) => all + .iter() + .all(|c| c.test(input, location, registry, random)), + Self::AnyOf(any) => any + .iter() + .any(|c| c.test(input, location, registry, random)), + Self::Not(c) => !c.test(input, location, registry, random), + Self::RandomChance(chance) => random.next_float() < *chance, + Self::MatchingBlocks { + blocks, + properties, + location: at_location, + } => { + let state = if *at_location { location } else { input }; + blocks.contains(&state) + && properties.iter().all(|(k, x)| { + registry + .state(state) + .and_then(|s| s.properties.get(k)) + .is_some_and(|v| v == x) + }) + } + } + } +} + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn random_settings_salt_and_position() { + // ResourceLocation.hashCode: 31 * namespace + path. + let default = RandomSettings::decode(Some(&"per_piece".into())).unwrap(); + assert_eq!( + default.salt, + java_hash("lithostitched") + .wrapping_mul(31) + .wrapping_add(java_hash("default")) + ); + assert_eq!(java_hash("default"), 1544803905); + let (seed, piece, pivot, block) = (12345, [16, 64, -32], [8, 70, 8], [17, 65, -30]); + let mut ours = default.create(seed, piece, pivot, block); + let mut theirs = LegacyRandom::new(seed + i64::from(default.salt)) + .fork_positional() + .at(BlockPos::new(16, 64, -32)); + assert_eq!(ours.next_long(), theirs.next_long()); + let named: Value = serde_json::json!({"mode": "per_structure", "name": "v:roof"}); + let named = RandomSettings::decode(Some(&named)).unwrap(); + assert_eq!(named.mode, Mode::Structure); + assert_eq!( + named.salt, + java_hash("v") + .wrapping_mul(31) + .wrapping_add(java_hash("roof")) + ); + } + + #[test] + fn apply_random_draws_by_weight() { + let apply = ApplyRandom { + random: RandomSettings { + mode: Mode::Block, + salt: 0, + }, + lists: vec![ + (ProcessorList(vec![Processor::Nop]), 3), + (ProcessorList::default(), 1), + ], + total: 4, + }; + let mut ours = LegacyRandom::new(9); + let mut theirs = LegacyRandom::new(9); + for _ in 0..32 { + let draw = theirs.next_int_bound(4).unwrap(); + let picked = apply.pick(&mut ours).unwrap(); + assert_eq!(picked.0.len(), usize::from(draw < 3)); + } + } + + #[test] + fn set_block_draws_from_the_unsalted_seed() { + let (a, b) = (BlockStateId(1), BlockStateId(2)); + let set = SetBlock::decode( + &serde_json::json!({"state_provider": {"type": "minecraft:weighted_state_provider", + "entries": [{"weight": 1, "data": 1}, {"weight": 2, "data": 2}]}, + "random_mode": "per_piece"}), + |v| Ok(BlockStateId(v.as_u64().unwrap() as u32)), + ) + .unwrap(); + assert!(set.preserves()); + for x in 0..16 { + let mut java = LegacyRandom::new(77) + .fork_positional() + .at(BlockPos::new(x, 5, 3)); + let want = if java.next_int_bound(3).unwrap() < 1 { + a + } else { + b + }; + assert_eq!(set.state(77, [x, 5, 3], [0; 3], [9, 9, 9]), want); + } + } +} From bb24420df222d11517a2a1141b867f7eaff9dc93 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Mon, 19 Oct 2026 04:25:18 +0200 Subject: [PATCH 110/112] Carry: Lithostitched's apply_random, condition and set_block as the game's apply_random becomes horizon:apply_random: its weighted lists, or its set of lists at weight 1, with the inline lists carried like any other (their Java processors dropped and counted). condition becomes horizon:condition when the game runs every condition in it (true, all_of, any_of, not, random_chance, matching_blocks with plain property values), with its then and else lists carried. set_block with a simple or weighted state provider and no block entity change becomes horizon:set_block. Anything else stays Java and is dropped as before. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-port-pack/src/processors.rs | 226 +++++++++++++++++++-- crates/horizon-port-pack/src/worldgen.rs | 24 ++- 2 files changed, 233 insertions(+), 17 deletions(-) diff --git a/crates/horizon-port-pack/src/processors.rs b/crates/horizon-port-pack/src/processors.rs index db099972f..5dd9c9730 100644 --- a/crates/horizon-port-pack/src/processors.rs +++ b/crates/horizon-port-pack/src/processors.rs @@ -12,7 +12,10 @@ //! preset is on; one that ships off is a no-op and is taken out. //! - Lithostitched's `reference` runs other processor lists in turn: their //! processors are written in its place (Choice Theorem's Overhauled -//! Villages builds most of its lists so). +//! Villages builds most of its lists so). Its `apply_random` and +//! `condition` become the game's `horizon:apply_random` and +//! `horizon:condition`, with the lists inside them carried the same way, +//! and its `set_block` (simple or weighted states) `horizon:set_block`. //! //! 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 @@ -142,26 +145,142 @@ pub fn carry( let Some(list) = processors(list) else { return false; }; - let mut changed = false; - let expanded = references(std::mem::take(list), data, carried, 0); - changed |= expanded.1; - let mut out = Vec::with_capacity(expanded.0.len()); - for p in expanded.0 { - 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), - } - } + let (out, changed) = carry_all(std::mem::take(list), data, carried); *list = out; changed }) } +/// The processors of one list carried: references written in, then each +/// one with a data form replaced by it. Whether anything changed. +fn carry_all( + list: Vec<Value>, + data: &ProcessorData, + carried: &mut BTreeMap<String, usize>, +) -> (Vec<Value>, bool) { + let (expanded, mut changed) = references(list, data, carried, 0); + let mut out = Vec::with_capacity(expanded.len()); + for p in expanded { + let kind = p["processor_type"].as_str().unwrap_or_default().to_owned(); + let replacement = match kind.as_str() { + "lithostitched:apply_random" => apply_random(&p, data, carried).map(|p| vec![p]), + "lithostitched:condition" => condition(&p, data, carried).map(|p| vec![p]), + _ => as_data(&kind, &p, data), + }; + match replacement { + Some(replacement) => { + *carried.entry(kind).or_default() += 1; + out.extend(replacement); + changed = true; + } + None => out.push(p), + } + } + (out, changed) +} + +/// A processor list inside a carried processor: an id stays (the game reads +/// that file, carried on its own); an inline one is carried here. +fn nested(list: &Value, data: &ProcessorData, carried: &mut BTreeMap<String, usize>) -> Value { + let mut list = list.clone(); + if let Some(ps) = processors(&mut list) { + *ps = carry_all(std::mem::take(ps), data, carried).0; + } + list +} + +/// Lithostitched's `apply_random` as `horizon:apply_random`: its weighted +/// lists, or its set of lists at weight 1. A tag is not carried. +fn apply_random( + p: &Value, + data: &ProcessorData, + carried: &mut BTreeMap<String, usize>, +) -> Option<Value> { + let lists = &p["processor_lists"]; + let weighted = lists.as_array().is_some_and(|a| { + a.iter() + .all(|e| e.get("weight").is_some() && e.get("data").is_some()) + }); + let entries: Vec<(Value, Value)> = if weighted { + lists + .as_array()? + .iter() + .map(|e| (e["weight"].clone(), e["data"].clone())) + .collect() + } else { + match lists { + Value::String(id) if !id.starts_with('#') => vec![(1.into(), lists.clone())], + Value::Array(a) if a.iter().any(|x| x.get("processor_type").is_some()) => { + vec![(1.into(), lists.clone())] + } + Value::Array(a) + if a.iter() + .all(|x| x.as_str().is_some_and(|s| !s.starts_with('#')) || x.is_object()) => + { + a.iter().map(|x| (1.into(), x.clone())).collect() + } + Value::Object(_) => vec![(1.into(), lists.clone())], + _ => return None, + } + }; + let lists: Vec<Value> = entries + .into_iter() + .map(|(weight, list)| json!({"weight": weight, "data": nested(&list, data, carried)})) + .collect(); + let mut out = json!({"processor_type": "horizon:apply_random", "processor_lists": lists}); + if let Some(mode) = p.get("mode") { + out["mode"] = mode.clone(); + } + Some(out) +} + +/// Lithostitched's `condition` as `horizon:condition`, when the game runs +/// every condition in it (true, all_of, any_of, not, random_chance, +/// matching_blocks with plain property values); else it stays Java. +fn condition( + p: &Value, + data: &ProcessorData, + carried: &mut BTreeMap<String, usize>, +) -> Option<Value> { + fn runs(c: &Value) -> bool { + if let Some(all) = c.as_array() { + return all.iter().all(runs); + } + let kind = c["type"].as_str().unwrap_or_default(); + match kind.strip_prefix("lithostitched:").unwrap_or(kind) { + "true" | "random_chance" => true, + "all_of" | "any_of" => c["conditions"] + .as_array() + .is_some_and(|a| a.iter().all(runs)), + "not" => runs(&c["condition"]), + "matching_blocks" => c.get("properties").is_none_or(|p| { + p.as_object() + .is_some_and(|o| o.values().all(Value::is_string)) + }), + _ => false, + } + } + if !runs(&p["if_true"]) { + return None; + } + // One processor or a list of them. + let mut branch = |key: &str| -> Value { + let list = match p.get(key) { + None => Vec::new(), + Some(Value::Array(a)) => a.clone(), + Some(one) => vec![one.clone()], + }; + carry_all(list, data, carried).0.into() + }; + let (then, otherwise) = (branch("then"), branch("else")); + let mut out = json!({"processor_type": "horizon:condition", "if_true": p["if_true"], + "then": then, "else": otherwise}); + if let Some(mode) = p.get("random_mode") { + out["random_mode"] = mode.clone(); + } + Some(out) +} + /// 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] = [ @@ -355,6 +474,28 @@ fn as_data(kind: &str, p: &Value, data: &ProcessorData) -> Option<Vec<Value>> { p["blocks"].as_object()?; vec![json!({"processor_type": "horizon:block_swap", "blocks": p["blocks"]})] } + "lithostitched:set_block" => { + // A simple or weighted state provider, the block entity left as + // it is. + let provider = p["state_provider"]["type"].as_str()?; + let modifier = p["block_entity_modifier"]["type"].as_str(); + let plain = + modifier.is_none_or(|m| m.trim_start_matches("minecraft:") == "passthrough"); + if !plain + || !matches!( + provider, + "minecraft:simple_state_provider" | "minecraft:weighted_state_provider" + ) + { + return None; + } + let mut out = p.clone(); + out["processor_type"] = "horizon:set_block".into(); + if let Some(o) = out.as_object_mut() { + o.remove("block_entity_modifier"); + } + vec![out] + } "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. @@ -1059,6 +1200,59 @@ mod tests { assert_eq!(carried["lithostitched:reference"], 2); } + #[test] + fn lithostitched_random_and_condition_become_the_games() { + let mut data = data(); + let swap = json!({"processor_type": "lithostitched:block_swap", + "blocks": {"minecraft:dirt": "minecraft:grass_block"}}); + data.lists + .insert("v:green".into(), json!({"processors": [swap.clone()]})); + let mut list = json!({"processors": [ + {"processor_type": "lithostitched:apply_random", "mode": "per_piece", "processor_lists": [ + {"weight": 3, "data": "minecraft:empty"}, + {"weight": 1, "data": {"processors": [ + {"processor_type": "lithostitched:reference", "processor_lists": "v:green"}, + {"processor_type": "v:java"}]}}]}, + {"processor_type": "lithostitched:apply_random", "mode": "per_block", + "processor_lists": ["v:green", "v:red"]}, + {"processor_type": "lithostitched:apply_random", "mode": "per_block", + "processor_lists": "#v:colours"}, + {"processor_type": "lithostitched:condition", + "if_true": [{"type": "lithostitched:matching_blocks", "blocks": "minecraft:cobblestone"}], + "then": swap, "else": {"processor_type": "lithostitched:set_block", "state_provider": + {"type": "minecraft:simple_state_provider", "state": {"Name": "minecraft:stone"}}}}, + {"processor_type": "lithostitched:condition", + "if_true": {"type": "lithostitched:matching_biomes", "biomes": "#c:is_cold"}, + "then": []}]}); + let mut carried = BTreeMap::new(); + assert!(carry("processor_list", &mut list, &data, &mut carried)); + let p = list["processors"].as_array().unwrap(); + let green = json!({"processor_type": "horizon:block_swap", + "blocks": {"minecraft:dirt": "minecraft:grass_block"}}); + // Inline lists are carried; Java left in them is dropped later. + assert_eq!( + p[0], + json!({"processor_type": "horizon:apply_random", "mode": "per_piece", "processor_lists": [ + {"weight": 3, "data": "minecraft:empty"}, + {"weight": 1, "data": {"processors": [green.clone(), {"processor_type": "v:java"}]}}]}) + ); + assert_eq!( + p[1]["processor_lists"], + json!([{"weight": 1, "data": "v:green"}, {"weight": 1, "data": "v:red"}]) + ); + assert_eq!(p[2]["processor_type"], "lithostitched:apply_random"); + assert_eq!( + p[3], + json!({"processor_type": "horizon:condition", + "if_true": [{"type": "lithostitched:matching_blocks", "blocks": "minecraft:cobblestone"}], + "then": [green], "else": [{"processor_type": "horizon:set_block", "state_provider": + {"type": "minecraft:simple_state_provider", "state": {"Name": "minecraft:stone"}}}]}) + ); + assert_eq!(p[4]["processor_type"], "lithostitched:condition"); + assert_eq!(carried["lithostitched:apply_random"], 2); + assert_eq!(carried["lithostitched:condition"], 1); + } + #[test] fn repurposed_rule_tests_become_the_games() { let rule = |input: Value, position: Value| { diff --git a/crates/horizon-port-pack/src/worldgen.rs b/crates/horizon-port-pack/src/worldgen.rs index a6adc2000..4449e9f5b 100644 --- a/crates/horizon-port-pack/src/worldgen.rs +++ b/crates/horizon-port-pack/src/worldgen.rs @@ -382,7 +382,29 @@ fn drop_java_processors(list: &mut Value, dropped: &mut BTreeMap<String, usize>) } !java }); - processors.len() != before + let mut changed = processors.len() != before; + // The inline lists inside the game's apply_random and condition. + for p in processors.iter_mut() { + let inner: Vec<&mut Value> = match p["processor_type"].as_str() { + Some("horizon:apply_random") => p["processor_lists"] + .as_array_mut() + .into_iter() + .flatten() + .map(|e| &mut e["data"]) + .collect(), + Some("horizon:condition") => { + let o = p.as_object_mut().into_iter().flat_map(|o| o.iter_mut()); + o.filter(|(k, _)| *k == "then" || *k == "else") + .map(|(_, v)| v) + .collect() + } + _ => Vec::new(), + }; + for list in inner { + changed |= drop_java_processors(list, dropped); + } + } + changed } /// 1.21.1 writes a block or fluid state as `{"Name": ..., "Properties": From f62e07c36ae955c5bb025ea70a731c8b693e38e0 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Mon, 19 Oct 2026 04:40:00 +0200 Subject: [PATCH 111/112] Read GPU readbacks without assuming the mapping's alignment A Vega 11 on Windows (Vulkan) panicked at launch in bytemuck's cast_slice with TargetAlignmentGreaterAndInputNotAligned, starting with the release that shipped occlusion culling. The section-test results and the GPU timer's timestamps were cast in place from the mapped range, which isn't guaranteed to be 4- or 8-byte aligned. Copy the words out instead. Fixes #953 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- crates/horizon-client/src/gfx/cull.rs | 6 ++++-- crates/horizon-client/src/gfx/timing.rs | 3 ++- 2 files changed, 6 insertions(+), 3 deletions(-) diff --git a/crates/horizon-client/src/gfx/cull.rs b/crates/horizon-client/src/gfx/cull.rs index 6926aab70..bcb738de3 100644 --- a/crates/horizon-client/src/gfx/cull.rs +++ b/crates/horizon-client/src/gfx/cull.rs @@ -273,7 +273,9 @@ impl Cull { } 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); + // The mapping isn't guaranteed to be 4-byte aligned (a Vega 11 + // on Windows panicked in cast_slice), so copy the words out. + let results: Vec<u32> = bytemuck::pod_collect_to_vec(&data); let (mut hidden, mut indices) = (0, 0u64); for (&result, &n) in results.iter().zip(&r.indices) { if result != r.stamp { @@ -283,7 +285,7 @@ impl Cull { } 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) { + 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); diff --git a/crates/horizon-client/src/gfx/timing.rs b/crates/horizon-client/src/gfx/timing.rs index 5d2354234..8f8eee6ee 100644 --- a/crates/horizon-client/src/gfx/timing.rs +++ b/crates/horizon-client/src/gfx/timing.rs @@ -147,7 +147,8 @@ impl GpuTimer { continue; } if let Ok(data) = slot.buffer.slice(..).get_mapped_range() { - let stamps: &[u64] = bytemuck::cast_slice(&data); + // Read unaligned: the mapping isn't guaranteed to be 8-byte aligned. + let stamps: [u64; 2] = bytemuck::pod_read_unaligned(&data[..16]); let ticks = stamps[1].saturating_sub(stamps[0]); out.push((ticks as f64 * f64::from(self.period_ns) / 1e6) as f32); } From 4b28390f720968c11f75ba9bb3efafa3aafde766 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Mon, 19 Oct 2026 04:42:21 +0200 Subject: [PATCH 112/112] docs/modpacks.md: Lithostitched's processors carried, and what they change Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --- docs/modpacks.md | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/docs/modpacks.md b/docs/modpacks.md index 48e2a28e8..acc354f30 100644 --- a/docs/modpacks.md +++ b/docs/modpacks.md @@ -464,9 +464,16 @@ Two cases the oracle fills in: 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). + leaves the block as it is, as the mod does. Lithostitched's `reference` (CTOV builds most + of its lists from others) has the referenced lists' processors written in its place; its + `apply_random`, `condition` and `set_block` are the game's `horizon:apply_random`, + `horizon:condition` and `horizon:set_block`, with Lithostitched's random (the world seed + plus the name's hash, at the block, piece or structure). In a CTOV plains village at seed + 1234 the farms now grow carrots, potatoes and beetroot besides wheat, and 1,655 + cobblestone blocks become paths, grass, mossy cobblestone and planks. No Lithostitched processor is + dropped now (130 before), only CTOV's compat hooks for other mods inside them (142 copies). + Still taken out: Formations' biome replacements, Repurposed's pillars and fluid fixes, + 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