From 1ee64ded5547bd16971650e4cd10e64e3b3e6d09 Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 12:10:45 -0400 Subject: [PATCH 01/59] Show equipment attributes in hover tooltips --- crates/horizon-client/src/game/stations.rs | 28 +++++ crates/horizon-client/src/item_tooltip.rs | 130 ++++++++++++++++++--- 2 files changed, 140 insertions(+), 18 deletions(-) diff --git a/crates/horizon-client/src/game/stations.rs b/crates/horizon-client/src/game/stations.rs index d8a5d1416..c6cfd6d82 100644 --- a/crates/horizon-client/src/game/stations.rs +++ b/crates/horizon-client/src/game/stations.rs @@ -1977,6 +1977,34 @@ impl Game<'_> { } } } + if let Some(info) = self.res.items.get(&stack.item) { + let base = |name: &str, default| { + self.player + .as_ref() + .and_then(|player| { + let key = player.attributes.key(name)?; + let handle = player.attributes.lookup(Some(&key))?; + player + .attributes + .instance(&handle) + .ok() + .map(|value| value.base_value()) + }) + .unwrap_or(default) + }; + let player_base = [ + base("minecraft:attack_damage", 1.0), + base( + "minecraft:attack_speed", + horizon_client::attack_strength::BASE_ATTACK_SPEED, + ), + ]; + lines.extend(horizon_client::item_tooltip::attribute_lines( + &info.modifiers, + Some(player_base), + &translate, + )); + } if let Some(info) = self.res.items.get(&stack.item) && info.max_damage > 0 && stack.damage > 0 diff --git a/crates/horizon-client/src/item_tooltip.rs b/crates/horizon-client/src/item_tooltip.rs index cd827d411..dc669e5ea 100644 --- a/crates/horizon-client/src/item_tooltip.rs +++ b/crates/horizon-client/src/item_tooltip.rs @@ -1,8 +1,9 @@ -//! The lines of an item's tooltip as `ItemStack.getTooltipLines` writes them -//! without a player and without advanced tooltips, for stacks as recipes -//! produce them. The recipe book's search tree matches them, so recipes of -//! tools and armour answer to "attack speed" or "when on head". -use crate::items::{ItemInfo, ItemStack}; +//! Item tooltip formatting: equipment modifiers with a player's base values, +//! and lines without player context for the recipe book's search tree. +use crate::{ + hud::rgba, + items::{ItemInfo, ItemStack}, +}; /// `EquipmentSlotGroup` in declaration order, the order tooltips list them in. const SLOT_GROUPS: [&str; 11] = [ @@ -25,6 +26,7 @@ fn modifier_line( attribute: &str, amount: f64, operation: usize, + total: bool, ) -> Option { let text = |key: &str| translate(key).unwrap_or_else(|| key.to_owned()); let scale = match operation { @@ -32,7 +34,9 @@ fn modifier_line( 0 => 1.0, _ => 100.0, }; - let (kind, shown) = if amount > 0.0 { + let (kind, shown) = if total { + ("equals", amount * scale) + } else if amount > 0.0 { ("plus", amount * scale) } else if amount < 0.0 { ("take", -amount * scale) @@ -47,22 +51,27 @@ fn modifier_line( ) } -/// `ItemStack.addAttributeTooltips` for the item's own modifiers: per slot -/// group an empty line, the group's heading and a line per modifier. -fn attribute_lines(info: &ItemInfo, translate: &dyn Fn(&str) -> Option) -> Vec { +/// `ItemStack.addAttributeTooltips`: slot groups, colors and optional player +/// attack damage/speed bases. Recipe search has no player context. +pub fn attribute_lines( + modifiers: &[(String, String, f64, String, String)], + player_base: Option<[f64; 2]>, + translate: &dyn Fn(&str) -> Option, +) -> Vec<(String, u32)> { let mut lines = Vec::new(); for group in SLOT_GROUPS { let mut first = true; - for (attribute, _, amount, operation, slot) in &info.modifiers { + for (attribute, modifier, amount, operation, slot) in modifiers { if slot != group { continue; } if std::mem::take(&mut first) { - lines.push(String::new()); - lines.push( + lines.push((String::new(), u32::MAX)); + lines.push(( translate(&format!("item.modifiers.{group}")) .unwrap_or_else(|| format!("item.modifiers.{group}")), - ); + rgba(170, 170, 170, 255), + )); } let id = match operation.as_str() { "add_multiplied_base" => 1, @@ -70,7 +79,27 @@ fn attribute_lines(info: &ItemInfo, translate: &dyn Fn(&str) -> Option) _ => 0, }; let path = attribute.strip_prefix("minecraft:").unwrap_or(attribute); - lines.extend(modifier_line(translate, path, *amount, id)); + let base = player_base.and_then(|[damage, speed]| match modifier.as_str() { + "minecraft:base_attack_damage" => Some(damage), + "minecraft:base_attack_speed" => Some(speed), + _ => None, + }); + if let Some(line) = modifier_line( + translate, + path, + amount + base.unwrap_or(0.0), + id, + base.is_some(), + ) { + let (line, color) = if base.is_some() { + (format!(" {line}"), rgba(0, 170, 0, 255)) + } else if *amount > 0.0 { + (line, rgba(85, 85, 255, 255)) + } else { + (line, rgba(255, 85, 85, 255)) + }; + lines.push((line, color)); + } } } lines @@ -211,6 +240,7 @@ pub fn detail_lines( attribute, amount * (*amplifier + 1) as f64, operation, + false, ) }) .collect(); @@ -242,7 +272,11 @@ pub fn detail_lines( lines.push(text("item.dyed")); } if let Some(info) = info { - lines.extend(attribute_lines(info, translate)); + lines.extend( + attribute_lines(&info.modifiers, None, translate) + .into_iter() + .map(|(line, _)| line), + ); } lines } @@ -335,6 +369,66 @@ mod tests { assert_eq!(format_amount(0.375), "0.38"); } + #[test] + fn equipment_attributes_use_player_totals_and_slot_group_colors() { + let modifiers = [ + ("attack_damage", "base_attack_damage", 6.0, "mainhand"), + ("attack_speed", "base_attack_speed", -2.4, "mainhand"), + ("armor", "armor", 3.0, "head"), + ] + .map(|(attribute, id, amount, slot)| { + ( + format!("minecraft:{attribute}"), + format!("minecraft:{id}"), + amount, + "add_value".to_owned(), + slot.to_owned(), + ) + }); + let lang = |key: &str| { + Some( + match key { + "item.modifiers.mainhand" => "When in Main Hand:", + "item.modifiers.head" => "When on Head:", + "attribute.modifier.equals.0" => "%s %s", + "attribute.modifier.plus.0" => "+%s %s", + "attribute.modifier.take.0" => "-%s %s", + "attribute.name.attack_damage" => "Attack Damage", + "attribute.name.attack_speed" => "Attack Speed", + "attribute.name.armor" => "Armor", + _ => return None, + } + .to_owned(), + ) + }; + let green = rgba(0, 170, 0, 255); + let gray = rgba(170, 170, 170, 255); + let blue = rgba(85, 85, 255, 255); + let red = rgba(255, 85, 85, 255); + assert_eq!( + attribute_lines(&modifiers, Some([1.0, 4.0]), &lang), + [ + (String::new(), u32::MAX), + ("When in Main Hand:".into(), gray), + (" 7 Attack Damage".into(), green), + (" 1.6 Attack Speed".into(), green), + (String::new(), u32::MAX), + ("When on Head:".into(), gray), + ("+3 Armor".into(), blue), + ] + ); + let recipe = attribute_lines(&modifiers, None, &lang); + assert_eq!(recipe[2], ("+6 Attack Damage".into(), blue)); + assert_eq!(recipe[3], ("-2.4 Attack Speed".into(), red)); + let custom_base = attribute_lines(&modifiers, Some([2.0, 6.0]), &lang); + assert_eq!(custom_base[2].0, " 8 Attack Damage"); + assert_eq!(custom_base[3].0, " 3.6 Attack Speed"); + assert_eq!( + modifier_line(&lang, "attack_damage", 0.0, 0, true).as_deref(), + Some("0 Attack Damage") + ); + } + #[test] fn modifier_lines_follow_the_sign_and_operation() { let lang = |k: &str| { @@ -349,13 +443,13 @@ mod tests { ) }; assert_eq!( - modifier_line(&lang, "movement_speed", 0.2, 2).as_deref(), + modifier_line(&lang, "movement_speed", 0.2, 2, false).as_deref(), Some("+20% Speed") ); assert_eq!( - modifier_line(&lang, "movement_speed", -0.6, 2).as_deref(), + modifier_line(&lang, "movement_speed", -0.6, 2, false).as_deref(), Some("-60% Speed") ); - assert_eq!(modifier_line(&lang, "movement_speed", 0.0, 2), None); + assert_eq!(modifier_line(&lang, "movement_speed", 0.0, 2, false), None); } } From 4218a496b2756bb9f9261bb4025b6f1a9711c582 Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 14:40:28 -0400 Subject: [PATCH 02/59] Preserve ominous banner components through placement and drops --- crates/horizon-client/src/containers.rs | 2 + crates/horizon-client/src/game/spill.rs | 74 +++++++++++++++++++++++-- crates/horizon-client/src/save.rs | 12 +++- 3 files changed, 81 insertions(+), 7 deletions(-) diff --git a/crates/horizon-client/src/containers.rs b/crates/horizon-client/src/containers.rs index 46e73f067..9cdac1463 100644 --- a/crates/horizon-client/src/containers.rs +++ b/crates/horizon-client/src/containers.rs @@ -132,6 +132,8 @@ impl Crafter { pub struct Banner { pub layers: Vec, pub name: Option, + /// Components not consumed by BannerBlockEntity's implicit fields. + pub components: horizon_world::nbt::Compound, } /// `CreakingHeartBlockEntity` (the logic is in `game/creaking.rs`). #[derive(Clone, Debug, Default)] diff --git a/crates/horizon-client/src/game/spill.rs b/crates/horizon-client/src/game/spill.rs index ac508dfb8..5f10622f5 100644 --- a/crates/horizon-client/src/game/spill.rs +++ b/crates/horizon-client/src/game/spill.rs @@ -6,6 +6,7 @@ use super::{Game, GameLevel, Screen, dispenser::new_item_motion, storage::is_shulker_box}; use horizon_client::{ containers::{Banner, BlockEntity}, + item_data, items::ItemStack, }; use horizon_core::position::BlockPos; @@ -15,6 +16,7 @@ use horizon_world::{ LevelEvent, removal::{self, PreRemove}, }, + nbt::{JavaString, Tag}, registry::BlockStateId, }; use std::collections::HashMap; @@ -80,14 +82,37 @@ impl Pending { stack.data_mut().pot_decorations = Some(Box::new(sides)); } if stack.item.ends_with("_banner") - && let Some(Banner { layers, name }) = self.banner.remove(&pos) + && let Some(Banner { + layers, + name, + components, + }) = self.banner.remove(&pos) { - let data = stack.data_mut(); - data.banner_patterns = layers; - if name.is_some() { - data.custom_name = name; + let mut patch = match item_data::encode_components(stack) { + Some(Tag::Compound(c)) => c, + _ => Default::default(), + }; + // The remaining components in the banner loot table's copy_components. + for key in [ + "minecraft:item_name", + "minecraft:rarity", + "minecraft:tooltip_display", + ] { + if let Some(value) = components.get(&JavaString::from(key)) { + patch.insert(key.into(), value.clone()); + } } - stack.tidy(); + patch.insert( + "minecraft:banner_patterns".into(), + horizon_client::banner::layers_to_nbt(&layers), + ); + if let Some(name) = name { + patch.insert( + "minecraft:custom_name".into(), + Tag::String(name.as_str().into()), + ); + } + (stack.damage, stack.extra) = item_data::decode_components(Some(&Tag::Compound(patch))); } } /// Remember a decorated pot's sherds from its saved block entity. @@ -553,3 +578,40 @@ impl Game<'_> { } } } + +#[cfg(test)] +mod tests { + use super::*; + use horizon_client::{block_entity_item, item_data, mobs::raider, save}; + use horizon_world::nbt::Tag; + + #[test] + fn ominous_banner_survives_placement_save_and_drop() { + let original = raider::ominous_banner(); + let Tag::Compound(components) = item_data::encode_components(&original).unwrap() else { + panic!("banner components"); + }; + for block in ["minecraft:white_banner", "minecraft:white_wall_banner"] { + let pos = (1, 64, 2); + let fresh = BlockEntity::for_block(block).unwrap(); + let fresh = save::encode_block_entity(pos, &fresh, block); + let placed = block_entity_item::place(&fresh, &components, false); + let (_, placed) = save::decode_block_entity(&placed).unwrap(); + let saved = save::encode_block_entity(pos, &placed, block); + let (_, loaded) = save::decode_block_entity(&saved).unwrap(); + let BlockEntity::Banner(banner) = &loaded else { + panic!("placed banner"); + }; + assert_eq!(banner.layers.len(), item_data::OMINOUS_LAYERS.len()); + let mut pending = Pending::default(); + pending.record([pos.0, pos.1, pos.2], &loaded, block, None); + let mut dropped = ItemStack::new("minecraft:white_banner", 1); + pending.attach([pos.0, pos.1, pos.2], &mut dropped); + assert!(dropped.data().unwrap().ominous_banner); + assert_eq!( + item_data::encode_components(&dropped), + Some(Tag::Compound(components.clone())) + ); + } + } +} diff --git a/crates/horizon-client/src/save.rs b/crates/horizon-client/src/save.rs index a3ee81912..61317c8aa 100644 --- a/crates/horizon-client/src/save.rs +++ b/crates/horizon-client/src/save.rs @@ -449,13 +449,17 @@ pub fn encode_block_entity( block: &str, ) -> Tag { use crate::containers::BlockEntity; + let components = match e { + BlockEntity::Banner(b) => b.components.clone(), + _ => Compound::new(), + }; let mut entries = vec![ ("id", string(&block_entity_id(e, block))), ("x", Tag::Int(p.0)), ("y", Tag::Int(p.1)), ("z", Tag::Int(p.2)), ("keepPacked", Tag::Byte(0)), - ("components", Tag::Compound(Compound::new())), + ("components", Tag::Compound(components)), ]; match e { BlockEntity::Chest(items) => entries.push(("Items", encode_items(items))), @@ -583,6 +587,10 @@ pub fn decode_block_entity(tag: &Tag) -> Option<((i32, i32, i32), crate::contain BlockEntity::Banner(crate::containers::Banner { layers: crate::banner::layers_from_nbt(tag.get("patterns")), name: text(tag.get("CustomName")), + components: match tag.get("components") { + Some(Tag::Compound(c)) => c.clone(), + _ => Compound::new(), + }, }), )); } @@ -2984,6 +2992,7 @@ mod tests { let banner = crate::containers::Banner { layers: vec![crate::banner::BannerLayer::new("minecraft:creeper", "lime")], name: Some("Flag".into()), + components: [("minecraft:rarity".into(), string("uncommon"))].into(), }; let tag = encode_block_entity( (1, 2, 3), @@ -2997,6 +3006,7 @@ mod tests { }; assert_eq!(back.layers, banner.layers); assert_eq!(back.name, banner.name); + assert_eq!(back.components, banner.components); } use super::*; From 3db9a250bec7465defe041ef391c651df7244db9 Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 14:45:14 -0400 Subject: [PATCH 03/59] Keep equipment attribute tooltip translations at runtime --- crates/horizon-client/src/enchant.rs | 2 + crates/horizon-client/src/item_tooltip.rs | 81 ++++++++++++++++++----- 2 files changed, 67 insertions(+), 16 deletions(-) diff --git a/crates/horizon-client/src/enchant.rs b/crates/horizon-client/src/enchant.rs index c62a67a07..86bdbe562 100644 --- a/crates/horizon-client/src/enchant.rs +++ b/crates/horizon-client/src/enchant.rs @@ -185,6 +185,8 @@ impl Enchantments { .into_iter() .filter(|(k, _)| { k.starts_with("enchantment.") + || k.starts_with("attribute.") + || k.starts_with("item.modifiers.") || k.starts_with("effect.") || k.starts_with("item.minecraft.potion") || k.starts_with("item.minecraft.splash_potion") diff --git a/crates/horizon-client/src/item_tooltip.rs b/crates/horizon-client/src/item_tooltip.rs index dc669e5ea..db561d6c4 100644 --- a/crates/horizon-client/src/item_tooltip.rs +++ b/crates/horizon-client/src/item_tooltip.rs @@ -385,22 +385,34 @@ mod tests { slot.to_owned(), ) }); - let lang = |key: &str| { - Some( - match key { - "item.modifiers.mainhand" => "When in Main Hand:", - "item.modifiers.head" => "When on Head:", - "attribute.modifier.equals.0" => "%s %s", - "attribute.modifier.plus.0" => "+%s %s", - "attribute.modifier.take.0" => "-%s %s", - "attribute.name.attack_damage" => "Attack Damage", - "attribute.name.attack_speed" => "Attack Speed", - "attribute.name.armor" => "Armor", - _ => return None, - } - .to_owned(), - ) - }; + let root = std::env::temp_dir().join(format!( + "horizon-tooltip-language-{}-{}", + std::process::id(), + std::time::SystemTime::now() + .duration_since(std::time::UNIX_EPOCH) + .unwrap() + .as_nanos(), + )); + let dir = root.join("assets/minecraft/lang"); + std::fs::create_dir_all(&dir).unwrap(); + std::fs::write( + dir.join("en_us.json"), + serde_json::to_vec(&serde_json::json!({ + "item.modifiers.mainhand": "When in Main Hand:", + "item.modifiers.head": "When on Head:", + "attribute.modifier.equals.0": "%s %s", + "attribute.modifier.plus.0": "+%s %s", + "attribute.modifier.take.0": "-%s %s", + "attribute.name.attack_damage": "Attack Damage", + "attribute.name.attack_speed": "Attack Speed", + "attribute.name.armor": "Armor", + })) + .unwrap(), + ) + .unwrap(); + let enchantments = crate::enchant::Enchantments::load(&root); + std::fs::remove_dir_all(&root).unwrap(); + let lang = |key: &str| enchantments.translate(key).map(str::to_owned); let green = rgba(0, 170, 0, 255); let gray = rgba(170, 170, 170, 255); let blue = rgba(85, 85, 255, 255); @@ -429,6 +441,43 @@ mod tests { ); } + #[test] + #[ignore = "requires prepared items/language in HORIZON_TEST_RESOURCES"] + fn equipment_attributes_with_prepared_items_and_language() { + let root = std::path::PathBuf::from( + std::env::var_os("HORIZON_TEST_RESOURCES").expect("HORIZON_TEST_RESOURCES"), + ); + let items = crate::items::Items::catalog(&root).unwrap(); + let enchantments = crate::enchant::Enchantments::load(&root); + let translate = |key: &str| enchantments.translate(key).map(str::to_owned); + for (item, expected) in [ + ( + "minecraft:diamond_sword", + [ + "", + "When in Main Hand:", + " 7 Attack Damage", + " 1.6 Attack Speed", + ], + ), + ( + "minecraft:diamond_helmet", + ["", "When on Head:", "+3 Armor", "+2 Armor Toughness"], + ), + ] { + let info = items.get(item).unwrap(); + let lines = attribute_lines(&info.modifiers, Some([1.0, 4.0]), &translate); + assert_eq!( + lines + .iter() + .map(|(text, _)| text.as_str()) + .collect::>(), + expected, + "{item}" + ); + } + } + #[test] fn modifier_lines_follow_the_sign_and_operation() { let lang = |k: &str| { From a2cce7486ddb847d5455894e7e7f00ef75fa76c7 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 16 Oct 2026 20:48:50 +0200 Subject: [PATCH 04/59] Villagers search an index of POI blocks instead of scanning every block AcquirePoi (job sites, beds, meeting points) and the bed searches read every block of the sections in a 48-block sphere. Like vanilla's PoiManager, each section now keeps the list of its POI blocks, rebuilt from its blocks after an edit (a weak reference detects edited and replaced sections). The searches visit the same positions in the same order. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/lib.rs | 1 + .../horizon-client/src/mobs/villager_brain.rs | 108 ++++++-------- crates/horizon-client/src/poi_sections.rs | 134 ++++++++++++++++++ crates/horizon-client/src/world.rs | 3 + 4 files changed, 185 insertions(+), 61 deletions(-) create mode 100644 crates/horizon-client/src/poi_sections.rs diff --git a/crates/horizon-client/src/lib.rs b/crates/horizon-client/src/lib.rs index b56891996..0e37214b0 100644 --- a/crates/horizon-client/src/lib.rs +++ b/crates/horizon-client/src/lib.rs @@ -130,6 +130,7 @@ pub mod particles; pub mod patrol; pub mod perf_overlay; pub mod pick_item; +pub mod poi_sections; pub mod pose; pub mod post; pub mod projectiles; diff --git a/crates/horizon-client/src/mobs/villager_brain.rs b/crates/horizon-client/src/mobs/villager_brain.rs index 942afd233..5b8500c0d 100644 --- a/crates/horizon-client/src/mobs/villager_brain.rs +++ b/crates/horizon-client/src/mobs/villager_brain.rs @@ -924,8 +924,35 @@ fn tickets(m: &Mob, w: &MobWorld, p: [i32; 3]) -> usize { } n } +/// The POIs of chunk `(qx, qz)` from `y0` to `y1` (within the world), in +/// scan order: y, then z, then x. Only the indexed POI blocks of the sections +/// are visited (`PoiManager.getInChunk`). +fn chunk_pois( + w: &MobWorld, + (qx, qz): (i32, i32), + y0: i32, + y1: i32, + mut visit: impl FnMut(Poi, [i32; 3]), +) { + let Some(chunk) = w.world.chunks.get(&(qx, qz)) else { + return; + }; + let kind = |state: u32| poi_of_state(w, horizon_world::registry::BlockStateId(state)); + let min = crate::chunk::MIN_Y; + for s in (y0 - min) >> 4..=(y1 - min) >> 4 { + let section = &chunk.sections[s as usize]; + for &(i, poi) in w.world.pois.get((qx, s, qz), section, kind).iter() { + let i = i32::from(i); + let y = min + s * 16 + (i >> 8); + if (y0..=y1).contains(&y) { + visit(poi, [qx * 16 + (i & 15), y, qz * 16 + (i >> 4 & 15)]); + } + } + } +} /// `PoiManager.getInRange` with `HAS_SPACE`, nearest first (`distSqr` to the -/// block, ties in scan order), filtered by `accept`. +/// block, ties in scan order: chunk by chunk, z then x, and y, z, x within), +/// filtered by `accept`. fn pois_in_range( m: &Mob, w: &MobWorld, @@ -940,62 +967,24 @@ fn pois_in_range( let chunks = radius.div_euclid(16) + 1; let y0 = (c[1] - radius).max(crate::chunk::MIN_Y); let y1 = (c[1] + radius).min(crate::chunk::MIN_Y + crate::chunk::HEIGHT - 1); - // Sections whose palette holds no POI state are skipped whole, as - // PoiManager only visits sections with records: the same positions in - // the same order, without reading and naming every block of the sphere. - let kind = |state: u32| poi_of_state(w, horizon_world::registry::BlockStateId(state)); for qz in cz - chunks..=cz + chunks { for qx in cx - chunks..=cx + chunks { - let Some(chunk) = w.world.chunks.get(&(qx, qz)) else { - continue; - }; - let holds: Vec = chunk - .sections - .iter() - .map(|s| s.blocks.maybe_has(|v| kind(v).is_some())) - .collect(); - for y in y0..=y1 { - if !holds[((y - crate::chunk::MIN_Y) >> 4) as usize] { - continue; + chunk_pois(w, (qx, qz), y0, y1, |poi, p| { + if (p[0] - c[0]).abs() > radius + || (p[2] - c[2]).abs() > radius + || dist_sqr(p, c) > r2 + || !poi_matches(m, f, poi) + || tickets(m, w, p) >= poi.max_tickets() + { + return; } - for z in qz * 16..qz * 16 + 16 { - for x in qx * 16..qx * 16 + 16 { - if (x - c[0]).abs() > radius || (z - c[2]).abs() > radius { - continue; - } - let d = i64::from(x - c[0]).pow(2) - + i64::from(y - c[1]).pow(2) - + i64::from(z - c[2]).pow(2); - if d > r2 { - continue; - } - let state = chunk.block(x & 15, y, z & 15); - if w.facts.is_air(state) { - continue; - } - let Some(poi) = kind(state.0) else { - continue; - }; - if !poi_matches(m, f, poi) { - continue; - } - let p = [x, y, z]; - if tickets(m, w, p) >= poi.max_tickets() { - continue; - } - if accept(p) { - found.push((poi, p)); - } - } + if accept(p) { + found.push((poi, p)); } - } + }); } } - found.sort_by_key(|(_, p)| { - i64::from(p[0] - c[0]).pow(2) - + i64::from(p[1] - c[1]).pow(2) - + i64::from(p[2] - c[2]).pow(2) - }); + found.sort_by_key(|&(_, p)| dist_sqr(p, c)); found } /// `PoiManager.exists(pos, predicate)`. @@ -3389,26 +3378,23 @@ fn dist_sqr(a: [i32; 3], b: [i32; 3]) -> i64 { manhattan_sq(a, b) } /// Every bed head within `radius` (`PoiManager.getInRange(HOME, ..., ANY)`), -/// in scan order. +/// in the order of a scan of the cube: y, then z, then x. fn homes_in_range(m: &Mob, w: &MobWorld, radius: i32) -> Vec<[i32; 3]> { let c = block_of(m.position); let r2 = i64::from(radius) * i64::from(radius); let mut out = Vec::new(); let y0 = (c[1] - radius).max(crate::chunk::MIN_Y); let y1 = (c[1] + radius).min(crate::chunk::MIN_Y + crate::chunk::HEIGHT - 1); - for y in y0..=y1 { - for z in c[2] - radius..=c[2] + radius { - for x in c[0] - radius..=c[0] + radius { - let p = [x, y, z]; - if dist_sqr(p, c) <= r2 - && w.world.loaded(x, z) - && poi_at(w, x, y, z) == Some(Poi::Home) - { + for qz in (c[2] - radius) >> 4..=(c[2] + radius) >> 4 { + for qx in (c[0] - radius) >> 4..=(c[0] + radius) >> 4 { + chunk_pois(w, (qx, qz), y0, y1, |poi, p| { + if poi == Poi::Home && dist_sqr(p, c) <= r2 { out.push(p); } - } + }); } } + out.sort_unstable_by_key(|p| (p[1], p[2], p[0])); out } /// `MoveToSkySeeingSpot.hasNoBlocksAbove`. diff --git a/crates/horizon-client/src/poi_sections.rs b/crates/horizon-client/src/poi_sections.rs new file mode 100644 index 000000000..2116362e0 --- /dev/null +++ b/crates/horizon-client/src/poi_sections.rs @@ -0,0 +1,134 @@ +//! The points of interest of each resident section (`PoiSection`), so a +//! search visits the few POI blocks of the sections in range instead of +//! reading every block of them. +//! +//! Vanilla keeps its records up to date from `onBlockStateChange`; here a +//! section's list is rebuilt from its blocks after any edit. Resident +//! sections are immutable behind `Arc` and edited through `Arc::make_mut`, so +//! a weak reference tells an edited or replaced section from the one the list +//! was built from (see `random_tick_sections`), without keeping its blocks. +use crate::{chunk::Section, fast_hash::FxHashMap}; +use std::sync::{Arc, Mutex, Weak}; + +/// A section's POIs: the block index in the section (`y << 8 | z << 4 | x`) +/// and its kind, in ascending index order. +pub type SectionPois = Arc<[(u16, T)]>; + +struct Cached { + section: Weak
, + pois: SectionPois, +} +/// Cached POI lists by section, `(chunk x, section index, chunk z)`. +pub struct PoiSections { + sections: Mutex>, +} +struct Lists { + by_section: FxHashMap<(i32, i32, i32), Cached>, + /// Size above which lists of sections no longer resident are dropped. + prune_at: usize, +} +const MIN_PRUNE: usize = 4096; +impl Default for PoiSections { + fn default() -> Self { + Self { + sections: Mutex::new(Lists { + by_section: FxHashMap::default(), + prune_at: MIN_PRUNE, + }), + } + } +} +impl PoiSections { + /// The POIs of `section`, whose block states `kind` classifies. `kind` + /// must give the same answer for a state on every call. + pub fn get( + &self, + key: (i32, i32, i32), + section: &Arc
, + mut kind: impl FnMut(u32) -> Option, + ) -> SectionPois { + let mut lists = self.sections.lock().unwrap_or_else(|e| e.into_inner()); + if let Some(cached) = lists.by_section.get(&key) + && cached.section.as_ptr() == Arc::as_ptr(section) + { + return cached.pois.clone(); + } + let pois: SectionPois = if section.blocks.maybe_has(|v| kind(v).is_some()) { + let mut states = [0u16; 4096]; + section.unpack(&mut states); + states + .iter() + .enumerate() + .filter_map(|(i, &state)| kind(u32::from(state)).map(|poi| (i as u16, poi))) + .collect() + } else { + Arc::from([]) + }; + if lists.by_section.len() >= lists.prune_at { + lists.by_section.retain(|_, c| c.section.strong_count() > 0); + lists.prune_at = (lists.by_section.len() * 2).max(MIN_PRUNE); + } + lists.by_section.insert( + key, + Cached { + section: Arc::downgrade(section), + pois: pois.clone(), + }, + ); + pois + } +} + +#[cfg(test)] +mod tests { + use super::*; + use crate::chunk::{Chunk, MIN_Y}; + + #[test] + fn lists_follow_edits_and_replacement() { + let index = PoiSections::::default(); + let kind = |v: u32| (v == 5 || v == 6).then_some(v as u8); + let mut chunk = Arc::new(Chunk::empty(0, 0)); + assert!(index.get((0, 0, 0), &chunk.sections[0], kind).is_empty()); + Arc::make_mut(&mut chunk).set(3, MIN_Y + 2, 1, 6); + Arc::make_mut(&mut chunk).set(0, MIN_Y, 0, 5); + let found = index.get((0, 0, 0), &chunk.sections[0], kind); + assert_eq!(&*found, &[(0, 5), (2 << 8 | 1 << 4 | 3, 6)]); + // Unchanged: the cached list, not a rescan. + let again = index.get((0, 0, 0), &chunk.sections[0], |_| panic!("rescanned")); + assert!(Arc::ptr_eq(&found, &again)); + // An edit in place (no other owner) still invalidates the list. + Arc::make_mut(&mut chunk).set(0, MIN_Y, 0, 1); + assert_eq!( + &*index.get((0, 0, 0), &chunk.sections[0], kind), + &[(2 << 8 | 1 << 4 | 3, 6)] + ); + // So does replacing the section, or the chunk. + Arc::make_mut(&mut chunk).sections[0] = Arc::new(Section::default()); + assert!(index.get((0, 0, 0), &chunk.sections[0], kind).is_empty()); + let mut other = Chunk::empty(0, 0); + other.set(1, MIN_Y, 1, 5); + chunk = Arc::new(other); + assert_eq!( + &*index.get((0, 0, 0), &chunk.sections[0], kind), + &[(1 << 4 | 1, 5)] + ); + // An unused palette entry alone yields no POI. + Arc::make_mut(&mut chunk).set(1, MIN_Y, 1, 2); + assert!(index.get((0, 0, 0), &chunk.sections[0], kind).is_empty()); + } + + #[test] + fn unloaded_sections_are_dropped() { + let index = PoiSections::::default(); + let kind = |v: u32| (v == 5).then_some(5); + let kept = Arc::new(Section::default()); + index.get((0, 0, 0), &kept, kind); + for i in 0..MIN_PRUNE as i32 { + index.get((1, i, 0), &Arc::new(Section::default()), kind); + } + let lists = index.sections.lock().unwrap(); + assert!(lists.by_section.len() <= 2); + assert!(lists.by_section.contains_key(&(0, 0, 0))); + } +} diff --git a/crates/horizon-client/src/world.rs b/crates/horizon-client/src/world.rs index 2d8213905..44e442ec1 100644 --- a/crates/horizon-client/src/world.rs +++ b/crates/horizon-client/src/world.rs @@ -46,6 +46,8 @@ pub struct World { /// Every block position written since the log was last drained, kept /// only while the world is open to the network (see `lan`). pub block_log: Option>, + /// The villager POIs of each section (`PoiManager`'s sections). + pub pois: crate::poi_sections::PoiSections, } /// ServerLevel weather state (advanceWeatherCycle). #[derive(Clone, Copy, Debug, Default)] @@ -130,6 +132,7 @@ impl World { day_time: 1000, weather: Weather::default(), block_log: None, + pois: Default::default(), } } /// A controlled blockstate scene for the native scene probes: material From 8f86098a02ffb3101fa35bcf1cff6a14b8bb3582 Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 15:07:19 -0400 Subject: [PATCH 05/59] Show ominous banner names and rarity in HUD and Creative tooltips --- crates/horizon-client/src/game.rs | 10 +++--- crates/horizon-client/src/game/spill.rs | 8 +++++ crates/horizon-client/src/game/stations.rs | 16 +++------ crates/horizon-client/src/game/titles.rs | 21 ++++------- crates/horizon-client/src/item_tooltip.rs | 42 ++++++++++++++++++++++ 5 files changed, 66 insertions(+), 31 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 7072abeb5..c65c00d25 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -7999,7 +7999,7 @@ impl Game<'_> { self.creative_screen.search_focused.elapsed().as_millis(), ); } - let mut hovered: Option = None; + let mut hovered: Option = None; if tab.inventory { self.draw_player_preview( batch, @@ -8049,7 +8049,7 @@ impl Game<'_> { && self.cursor.1 < y + 16.0 { batch.fill(&self.res.atlas, x, y, 16.0, 16.0, rgba(255, 255, 255, 128)); - hovered = Some(stack.item.to_string()); + hovered = Some(stack.clone()); } } } @@ -8064,7 +8064,7 @@ impl Game<'_> { && self.cursor.1 >= y && self.cursor.1 < y + 16.0 { - hovered = Some(stack.item.to_string()); + hovered = Some(stack); } } let scrollable = self.creative_screen.rows(&self.res.names) > 5; @@ -8100,8 +8100,8 @@ impl Game<'_> { } else if self.carried.is_none() && let Some(item) = hovered { - let name = self.res.names.item(&item); - self.tooltip(batch, &name, self.cursor.0, self.cursor.1); + let lines = self.stack_tooltip(&item); + self.draw_tooltip_lines(batch, &lines, self.cursor.0, self.cursor.1); } self.draw_inventory_effects(batch, (ox, oy), Creative::WIDTH as i32); } diff --git a/crates/horizon-client/src/game/spill.rs b/crates/horizon-client/src/game/spill.rs index 5f10622f5..b64bcb9d7 100644 --- a/crates/horizon-client/src/game/spill.rs +++ b/crates/horizon-client/src/game/spill.rs @@ -608,6 +608,14 @@ mod tests { let mut dropped = ItemStack::new("minecraft:white_banner", 1); pending.attach([pos.0, pos.1, pos.2], &mut dropped); assert!(dropped.data().unwrap().ominous_banner); + assert_eq!( + horizon_client::item_tooltip::name_line(&dropped, &|_| None), + "Ominous Banner" + ); + assert_eq!( + horizon_client::item_tooltip::rarity(&dropped, "common"), + "uncommon" + ); assert_eq!( item_data::encode_components(&dropped), Some(Tag::Compound(components.clone())) diff --git a/crates/horizon-client/src/game/stations.rs b/crates/horizon-client/src/game/stations.rs index d8a5d1416..1c253757d 100644 --- a/crates/horizon-client/src/game/stations.rs +++ b/crates/horizon-client/src/game/stations.rs @@ -1860,18 +1860,10 @@ impl Game<'_> { pub(super) fn stack_tooltip(&self, stack: &ItemStack) -> Vec<(String, u32)> { let e: &Enchantments = &self.res.stations.enchantments; let props = e.props(&stack.item); - let mut rarity = props.map_or("common", |p| p.rarity.as_str()); - // The ominous banner's rarity component. - if stack.data().is_some_and(|d| d.ominous_banner) { - rarity = "uncommon"; - } - if !stack.enchantments().is_empty() { - rarity = match rarity { - "common" | "uncommon" => "rare", - "rare" => "epic", - r => r, - }; - } + let rarity = horizon_client::item_tooltip::rarity( + stack, + props.map_or("common", |p| p.rarity.as_str()), + ); let color = match rarity { "uncommon" => rgba(255, 255, 85, 255), "rare" => rgba(85, 255, 255, 255), diff --git a/crates/horizon-client/src/game/titles.rs b/crates/horizon-client/src/game/titles.rs index 89e50c0d0..f0de6ad9e 100644 --- a/crates/horizon-client/src/game/titles.rs +++ b/crates/horizon-client/src/game/titles.rs @@ -6,6 +6,7 @@ use horizon_client::{ hud::HudBatch, hud_layout, hud_overlays::HeldName, + item_tooltip, text::{self, Text}, }; @@ -24,22 +25,14 @@ impl Game<'_> { fn held_name(&self) -> Option { let stack = self.inventory.get(self.selected)?.as_ref()?; let custom = stack.custom_name(); - // ItemStack.getRarity: enchanting raises common and uncommon to rare - // and rare to epic. - let mut rarity = self.item_rarity(&stack.item); - if !stack.enchantments().is_empty() { - rarity = match rarity.as_str() { - "common" | "uncommon" => "rare".into(), - "rare" => "epic".into(), - _ => rarity, - }; - } + let default_rarity = self.item_rarity(&stack.item); + let rarity = item_tooltip::rarity(stack, &default_rarity); Some(HeldName { item: stack.item.to_string(), - hover_name: Text::literal( - custom.map_or_else(|| self.res.names.item(&stack.item), str::to_owned), - ), - rarity_color: match rarity.as_str() { + hover_name: Text::literal(item_tooltip::name_line(stack, &|key| { + self.res.names.get(key).map(str::to_owned) + })), + rarity_color: match rarity { "uncommon" => text::YELLOW, "rare" => text::AQUA, "epic" => text::LIGHT_PURPLE, diff --git a/crates/horizon-client/src/item_tooltip.rs b/crates/horizon-client/src/item_tooltip.rs index cd827d411..a039edfc5 100644 --- a/crates/horizon-client/src/item_tooltip.rs +++ b/crates/horizon-client/src/item_tooltip.rs @@ -102,6 +102,10 @@ pub fn name_line(stack: &ItemStack, translate: &dyn Fn(&str) -> Option) if let Some(name) = stack.custom_name() { return name.to_owned(); } + if stack.data().is_some_and(|d| d.ominous_banner) { + return translate("block.minecraft.ominous_banner") + .unwrap_or_else(|| "Ominous Banner".to_owned()); + } let key = if is_potion_item(&stack.item) { Some(crate::brewing::potion_name_key(&stack.item, stack.potion())) } else if let Some(pattern) = path.strip_suffix("_armor_trim_smithing_template") { @@ -120,6 +124,24 @@ pub fn name_line(stack: &ItemStack, translate: &dyn Fn(&str) -> Option) .unwrap_or_else(|| path.replace('_', " ")) } +/// ItemStack.getRarity: the ominous banner override, then the enchantment upgrade. +pub fn rarity<'a>(stack: &ItemStack, default: &'a str) -> &'a str { + let rarity = if stack.data().is_some_and(|d| d.ominous_banner) { + "uncommon" + } else { + default + }; + if stack.enchantments().is_empty() { + rarity + } else { + match rarity { + "common" | "uncommon" => "rare", + "rare" => "epic", + r => r, + } + } +} + /// The lines of `stack` below its name that its components give, in /// `ItemStack.addDetailsToTooltip` order. pub fn detail_lines( @@ -292,6 +314,26 @@ pub fn lines( mod tests { use super::*; + #[test] + fn ominous_banner_name_and_rarity_use_the_stack() { + let translate = |key: &str| match key { + "block.minecraft.ominous_banner" => Some("Ominous Banner".to_owned()), + "block.minecraft.white_banner" => Some("White Banner".to_owned()), + _ => None, + }; + let mut banner = crate::mobs::raider::ominous_banner(); + assert_eq!(name_line(&banner, &translate), "Ominous Banner"); + assert_eq!(name_line(&banner, &|_| None), "Ominous Banner"); + assert_eq!(rarity(&banner, "common"), "uncommon"); + banner.data_mut().custom_name = Some("Captain's Standard".into()); + assert_eq!(name_line(&banner, &translate), "Captain's Standard"); + banner.enchant("minecraft:unbreaking", 1); + assert_eq!(rarity(&banner, "common"), "rare"); + let plain = ItemStack::new("minecraft:white_banner", 1); + assert_eq!(name_line(&plain, &translate), "White Banner"); + assert_eq!(rarity(&plain, "common"), "common"); + } + #[test] fn container_lines_list_five_stacks_then_how_many_more() { let mut chest = ItemStack::new("minecraft:chest", 1); From 86ccd5d299b2752aca6c29cafd3d88601af9bf66 Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 16:40:29 -0400 Subject: [PATCH 06/59] Render banner breaking cracks and oak-plank particles --- .../horizon-client/src/block_entity_render.rs | 155 +++++++++++++++++- crates/horizon-client/src/breaking.rs | 48 ++++++ crates/horizon-client/src/game.rs | 24 ++- crates/horizon-client/src/models/catalog.rs | 7 + 4 files changed, 227 insertions(+), 7 deletions(-) diff --git a/crates/horizon-client/src/block_entity_render.rs b/crates/horizon-client/src/block_entity_render.rs index 9ffd888a1..85107c1cb 100644 --- a/crates/horizon-client/src/block_entity_render.rs +++ b/crates/horizon-client/src/block_entity_render.rs @@ -876,7 +876,7 @@ impl BlockEntityRenderer { .as_vec3(); let base = Mat4::from_translation(origin); let packed = scene.world.light(pos[0], pos[1], pos[2]); - self.render_one(scene, *pos, kind, base, packed, lights, out); + self.render_one(scene, *pos, kind, base, packed, lights, false, out); } } /// One block entity at `pos` drawn under `base` with the given packed light @@ -892,12 +892,39 @@ impl BlockEntityRenderer { ) { let kind = self.kind(state); let lights = diffuse_lights(scene.nether); - self.render_one(scene, pos, kind, base, packed, lights, out); + self.render_one(scene, pos, kind, base, packed, lights, false, out); } /// Whether this block state has a block-entity renderer here. pub fn renders(&self, state: u32) -> bool { !matches!(self.kind(state), Kind::None) } + /// BannerRenderer submits the support and animated flag once for crumbling. + pub fn render_banner_breaking( + &self, + scene: &Scene, + pos: [i32; 3], + state: u32, + out: &mut Vec, + ) { + if !matches!(self.kind(state), Kind::Banner { .. }) { + return; + } + let origin = (DVec3::new(f64::from(pos[0]), f64::from(pos[1]), f64::from(pos[2])) + - scene.camera) + .as_vec3(); + let start = out.len(); + self.render_one( + scene, + pos, + self.kind(state), + Mat4::from_translation(origin), + 0xff, + diffuse_lights(scene.nether), + true, + out, + ); + crate::breaking::entity_geometry(&mut out[start..], origin); + } /// `ChestRenderer.extractRenderState`'s openness for the chest of `state` /// at `pos`: `ChestBlock.combine` (`DoubleBlockCombiner.combineWithNeigbour`) /// pairs a double half with its neighbour only when that is the same @@ -970,7 +997,7 @@ impl BlockEntityRenderer { let kind = self.kind(state); if !matches!(kind, Kind::None) { let lights = diffuse_lights(scene.nether); - self.render_one(scene, [i32::MAX; 3], kind, base, packed, lights, out); + self.render_one(scene, [i32::MAX; 3], kind, base, packed, lights, false, out); } } #[allow(clippy::too_many_arguments)] @@ -982,11 +1009,24 @@ impl BlockEntityRenderer { base: Mat4, packed: u8, lights: (Vec3, Vec3), + crumbling: bool, out: &mut Vec, ) { let sprite = |name: &str| scene.sprites.get(name).copied(); let paint = |name: &str, tint: u32, packed: u8| { - sprite(name).map(|s| Paint { + let rect = if crumbling { + Some(Rect { + u0: 0.0, + v0: 0.0, + u1: 1.0, + v1: 1.0, + w: 16, + h: 16, + }) + } else { + sprite(name) + }; + rect.map(|s| Paint { sprite: s, tint, light: vertex_light(packed), @@ -1145,6 +1185,10 @@ impl BlockEntityRenderer { draw_part(main, "root", m, &none, paint, out); draw_part(flag, "root", m, &wave, paint, out); } + // Pattern passes must not multiply the crumbling decal. + if crumbling { + return; + } // BannerRenderer.submitPatterns: the base pattern layer in the dye colour, // then up to 16 pattern layers in order. if let Some(paint) = paint("entity/banner/base", *color, packed) { @@ -1673,6 +1717,109 @@ fn portal_cube(m: Mat4, faces: &[Direction], layer: u32, out: &mut Vec) #[cfg(test)] mod tests { use super::*; + #[test] + #[ignore = "requires prepared models/textures in HORIZON_TEST_RESOURCES"] + fn banner_particle_and_breaking_use_exported_models() -> crate::Result<()> { + use crate::{models::catalog::StateModels, sprites::Sprites}; + use horizon_world::{DATA_VERSION, chunk::BlockState, nbt::Tag}; + let root = std::path::PathBuf::from( + std::env::var_os("HORIZON_TEST_RESOURCES").expect("HORIZON_TEST_RESOURCES"), + ); + let names = ["white_banner", "white_wall_banner"]; + let mut facts: std::collections::BTreeMap = + serde_json::from_slice(&std::fs::read(root.join("model-states.json"))?)?; + let states = names.map(|name| { + let name = format!("minecraft:{name}"); + let first = facts[&name]["states"][0].clone(); + facts.get_mut(&name).unwrap()["states"] = serde_json::json!([first.clone()]); + BlockState { + name, + properties: serde_json::from_value(first).unwrap(), + } + .to_nbt() + }); + let registry = BlockRegistry::from_nbt(&Tag::compound([ + ("DataVersion", Tag::Int(DATA_VERSION)), + ("states", Tag::List(states.into())), + ( + "defaults", + Tag::compound([ + ("minecraft:white_banner", Tag::Int(0)), + ("minecraft:white_wall_banner", Tag::Int(1)), + ]), + ), + ]))?; + let mut sprites = Sprites::default(); + let catalog = StateModels::from_facts(&root, ®istry, &names, &mut sprites, &facts)?; + for id in 0..2 { + let models = catalog.collect( + BlockStateId(id), + horizon_core::position::BlockPos::default(), + )?; + assert!(models.iter().all(|(_, model)| model.faces.is_empty())); + assert_eq!( + models[0].1.particle, + Some(sprites.layers["minecraft:block/oak_planks"]) + ); + } + let all: Value = serde_json::from_slice(&std::fs::read(root.join("entity-models.json"))?)?; + let renderer = BlockEntityRenderer::new( + MODELS + .iter() + .filter_map(|(key, layer)| all.get(*layer).map(|v| (*key, ModelPart::parse(v)))) + .collect(), + ®istry, + ); + let world = World::new(BlockStateId(0), 1); + let base_sprites = HashMap::from([( + "entity/banner/banner_base".to_owned(), + Rect { + u0: 0.0, + v0: 0.0, + u1: 1.0, + v1: 1.0, + w: 16, + h: 16, + }, + )]); + let mut scene = Scene { + camera: DVec3::ZERO, + orientation: Quat::IDENTITY, + anim: &|_| BlockAnim::default(), + texts: None, + partial: 0.5, + game_time: 0, + max_y: 320, + world: &world, + sprites: &base_sprites, + nether: false, + lid: &|_| 0.0, + sign: &|_| None, + banner: &|_| Vec::new(), + glyph: &|_| (None, 0.0), + }; + for state in 0..2 { + let mut base = Vec::new(); + renderer.render_block(&scene, [0; 3], state, Mat4::IDENTITY, 0xff, &mut base); + let mut cracks = Vec::new(); + renderer.render_banner_breaking(&scene, [0; 3], state, &mut cracks); + assert!(!cracks.is_empty()); + assert_eq!( + base.iter().map(|v| v.pos).collect::>(), + cracks.iter().map(|v| v.pos).collect::>() + ); + assert!(cracks.iter().all(|v| v.layer == 11 + && v.color == u32::MAX + && v.uv.iter().all(|u| u.is_finite()))); + scene.game_time = 20; + let mut animated = Vec::new(); + renderer.render_banner_breaking(&scene, [0; 3], state, &mut animated); + assert!(cracks.iter().zip(&animated).any(|(a, b)| a.pos != b.pos)); + scene.game_time = 0; + } + Ok(()) + } + #[test] fn classifies_vanilla_block_names() { let props = |pairs: &'static [(&'static str, &'static str)]| { diff --git a/crates/horizon-client/src/breaking.rs b/crates/horizon-client/src/breaking.rs index 9dc948ae3..c7ee19206 100644 --- a/crates/horizon-client/src/breaking.rs +++ b/crates/horizon-client/src/breaking.rs @@ -41,6 +41,35 @@ pub fn geometry(model: &BakedModel, origin: glam::Vec3, translucent: bool, out: } } +/// Project a block entity's transformed quads onto the same destroy-stage pass. +pub fn entity_geometry(vertices: &mut [Vertex], origin: glam::Vec3) { + for quad in vertices.as_chunks_mut::<4>().0 { + let positions = [0, 1, 2].map(|i| glam::Vec3::from(quad[i].pos)); + let normal = (positions[1] - positions[0]).cross(positions[2] - positions[0]); + let mut facing = Direction::North; + let mut best = f32::from_bits(1); + for (direction, dot) in [ + (Direction::Down, -normal.y), + (Direction::Up, normal.y), + (Direction::North, -normal.z), + (Direction::South, normal.z), + (Direction::West, -normal.x), + (Direction::East, normal.x), + ] { + if dot > best { + facing = direction; + best = dot; + } + } + for vertex in quad { + vertex.uv = decal_uv((glam::Vec3::from(vertex.pos) - origin).to_array(), facing); + vertex.layer = 11; + vertex.color = 0xffff_ffff; + vertex.light = 240 | (240 << 8); + } + } +} + #[cfg(test)] mod tests { use super::*; @@ -49,6 +78,7 @@ mod tests { fn slab_top() -> BakedModel { BakedModel { ambient_occlusion: true, + particle: None, cube: None, faces: vec![BakedFace { layer: 0, @@ -86,6 +116,24 @@ mod tests { assert_eq!(v.color, 0xffff_ffff); } } + #[test] + fn entity_overlay_uses_block_local_projected_uvs() { + let origin = glam::Vec3::new(12.0, -3.0, 8.0); + let mut expected = Vec::new(); + geometry(&slab_top(), origin, false, &mut expected); + let mut actual = expected.clone(); + for vertex in &mut actual { + vertex.uv = [0.0; 2]; + vertex.layer = 0; + vertex.color = 0; + } + entity_geometry(&mut actual, origin); + assert_eq!( + bytemuck::cast_slice::<_, u8>(&actual), + bytemuck::cast_slice::<_, u8>(&expected) + ); + } + #[test] fn small_faces_use_projected_not_stretched_uvs() { let a = decal_uv([0.0, 0.0, 0.0], Direction::North); diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index c65c00d25..21f59af94 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -1377,9 +1377,13 @@ impl Game<'_> { .iter() .flat_map(|(_, m)| m.faces.iter()) .find(|f| f.quad.facing == horizon_assets::model::Direction::Up) - .or_else(|| models.iter().flat_map(|(_, m)| m.faces.iter()).next())?; - let name = self.res.layer_names.get(&face.layer)?.clone(); - let tint = if face.quad.tint_index >= 0 { + .or_else(|| models.iter().flat_map(|(_, m)| m.faces.iter()).next()); + // Entity-rendered blocks may have a particle texture without any faces. + let layer = face + .map(|face| face.layer) + .or_else(|| models.iter().find_map(|(_, model)| model.particle))?; + let name = self.res.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; if n.contains("leaves") || n.contains("vine") { 0x48B518 @@ -5515,6 +5519,20 @@ impl Game<'_> { .block_entity_render .render(&scene, visible, &mut out); } + if let Some(mining) = &self.mining + && mining.progress > 0.0 + && self.res.atlas.sprites.contains_key(&format!( + "block/destroy_stage_{}", + ((mining.progress * 10.0) as u32).min(9) + )) + { + let state = self + .world + .block(mining.pos[0], mining.pos[1], mining.pos[2]); + self.res + .block_entity_render + .render_banner_breaking(&scene, mining.pos, state.0, &mut out); + } } // Experience orbs (ExperienceOrbRenderer): pulsing billboards from a 4x4 icon sheet. if let Some(r) = self diff --git a/crates/horizon-client/src/models/catalog.rs b/crates/horizon-client/src/models/catalog.rs index 59a885821..abb9e6c50 100644 --- a/crates/horizon-client/src/models/catalog.rs +++ b/crates/horizon-client/src/models/catalog.rs @@ -34,6 +34,8 @@ pub struct BakedFace { } pub struct BakedModel { pub ambient_occlusion: bool, + /// The model's particle slot also exists for models without block faces. + pub particle: Option, pub faces: Vec, pub cube: Option<[super::cube::CubeStyle; 6]>, } @@ -188,6 +190,10 @@ impl StateModels { let mut baked = BTreeMap::new(); for (name, turns, lock) in variants { let model = library.resolve(&name)?; + let particle = model + .material("particle")? + .map(|material| sprites.insert(root, &material.sprite)) + .transpose()?; let faces: Vec = bake_block_model(&model, BlockModelTransform::new(turns, lock))? .into_iter() @@ -207,6 +213,7 @@ impl StateModels { (name, turns, lock), BakedModel { ambient_occlusion: model.ambient_occlusion, + particle, faces, cube, }, From 53955abf99941128c2c263cd046deb0a92958957 Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 16:56:14 -0400 Subject: [PATCH 07/59] Hide ominous banner pattern descriptions in tooltips --- crates/horizon-client/src/banner.rs | 26 ++++++++++++++++++++++ crates/horizon-client/src/game/spill.rs | 1 + crates/horizon-client/src/game/stations.rs | 2 +- 3 files changed, 28 insertions(+), 1 deletion(-) diff --git a/crates/horizon-client/src/banner.rs b/crates/horizon-client/src/banner.rs index d2bc33fba..861294722 100644 --- a/crates/horizon-client/src/banner.rs +++ b/crates/horizon-client/src/banner.rs @@ -199,6 +199,14 @@ pub fn dye_rgb(name: &str) -> u32 { pub fn layers(stack: &ItemStack) -> &[BannerLayer] { stack.data().map_or(&[], |d| &d.banner_patterns) } +/// The ominous banner's component patch hides its pattern tooltip. +pub fn tooltip_layers(stack: &ItemStack) -> &[BannerLayer] { + if stack.data().is_some_and(|d| d.ominous_banner) { + &[] + } else { + layers(stack) + } +} /// `LoomMenu.setupResultSlot`: one banner with the pattern added in the dye colour. pub fn loom_result(banner: &ItemStack, dye: &str, pattern: &str) -> ItemStack { let mut result = ItemStack { @@ -302,6 +310,24 @@ mod tests { } assert!(has_max_layers(&banner)); } + #[test] + fn ominous_banner_hides_tooltip_layers_but_keeps_its_patterns() { + let mut banner = crate::mobs::raider::ominous_banner(); + (banner.damage, banner.extra) = crate::item_data::decode_components( + crate::item_data::encode_components(&banner).as_ref(), + ); + assert_eq!( + layers(&banner).len(), + crate::item_data::OMINOUS_LAYERS.len() + ); + assert!(tooltip_layers(&banner).is_empty()); + banner.data_mut().custom_name = Some("Captain's Standard".into()); + assert!(tooltip_layers(&banner).is_empty()); + banner.data_mut().ominous_banner = false; + assert_eq!(tooltip_layers(&banner), layers(&banner)); + assert!(!tooltip_layers(&banner).is_empty()); + } + #[test] fn layers_round_trip_through_nbt() { let l = vec![ diff --git a/crates/horizon-client/src/game/spill.rs b/crates/horizon-client/src/game/spill.rs index b64bcb9d7..20dcdf0de 100644 --- a/crates/horizon-client/src/game/spill.rs +++ b/crates/horizon-client/src/game/spill.rs @@ -608,6 +608,7 @@ mod tests { let mut dropped = ItemStack::new("minecraft:white_banner", 1); pending.attach([pos.0, pos.1, pos.2], &mut dropped); assert!(dropped.data().unwrap().ominous_banner); + assert!(horizon_client::banner::tooltip_layers(&dropped).is_empty()); assert_eq!( horizon_client::item_tooltip::name_line(&dropped, &|_| None), "Ominous Banner" diff --git a/crates/horizon-client/src/game/stations.rs b/crates/horizon-client/src/game/stations.rs index 1c253757d..5e8952901 100644 --- a/crates/horizon-client/src/game/stations.rs +++ b/crates/horizon-client/src/game/stations.rs @@ -1944,7 +1944,7 @@ impl Game<'_> { )); } // BannerPatternLayers.addToTooltip: up to six layer names. - for layer in horizon_client::banner::layers(stack).iter().take(6) { + for layer in horizon_client::banner::tooltip_layers(stack).iter().take(6) { let key = self.res.stations.banners.layer_key(layer); lines.push((self.translate(&key, &key), rgba(170, 170, 170, 255))); } From ddc115e969690c3a868283b540af534cc9465310 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 16 Oct 2026 23:24:34 +0200 Subject: [PATCH 08/59] Content mods: load real carried-over mods (large tables, convention tags, mod recipes) Loading seven real NeoForge mods carried over by horizon-port-pack (about 1,000 blocks) broke the content root in four places: - The per-state NBT tables (cached collision, occlusion, movement, worldgen block properties and support) passed the NBT reader's 1M-node cap once mod states were appended. They are trusted prepared tables with a row per state, so they now read and write with Limits::tables() (16M nodes, 256 MiB) everywhere they are loaded. - The overlay linked the base root by the path it was given, so a relative base gave dangling links. The base is made absolute first. - Carried-over tags name blocks the port left out and other mods' items. Vanilla fails such a tag as a whole; entries naming ids nobody registers (or tags nobody defines) are now dropped, so the rest loads. - Mods use the convention tags (c:dyes/red, c:glass_blocks/colorless). Content mods may add to data/c/tags/ as to vanilla's, and with content mods loaded the tag loaders read the c namespace and the mods' own. Stonecutter and smithing recipes in mod namespaces load too (ids :), as crafting and cooking ones already did. With no content mod nothing changes: the loaders read the minecraft namespace only. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/collisions.rs | 2 +- crates/horizon-client/src/items.rs | 20 +++-- crates/horizon-client/src/light.rs | 2 +- crates/horizon-client/src/mod_content.rs | 83 ++++++++++++++++++- .../horizon-client/src/mod_content_tests.rs | 22 ++++- crates/horizon-client/src/models.rs | 2 +- crates/horizon-client/src/motion.rs | 2 +- crates/horizon-client/src/stations.rs | 27 +++--- crates/horizon-mods/src/content.rs | 16 ++-- crates/horizon-world/src/nbt.rs | 12 +++ .../src/worldgen/generator_blocks.rs | 14 ++-- docs/mods.md | 9 +- 12 files changed, 168 insertions(+), 43 deletions(-) diff --git a/crates/horizon-client/src/collisions.rs b/crates/horizon-client/src/collisions.rs index 39fde56b5..d3e00daca 100644 --- a/crates/horizon-client/src/collisions.rs +++ b/crates/horizon-client/src/collisions.rs @@ -28,7 +28,7 @@ use std::{fs, io, path::Path, sync::Arc}; pub fn load<'r>(root: &Path, registry: &'r BlockRegistry) -> Result> { let data = nbt::read_named( &fs::read(root.join("cached-collision.nbt"))?, - Limits::default(), + Limits::tables(), )? .0 .tag; diff --git a/crates/horizon-client/src/items.rs b/crates/horizon-client/src/items.rs index 0aca99cef..54a505ab9 100644 --- a/crates/horizon-client/src/items.rs +++ b/crates/horizon-client/src/items.rs @@ -274,16 +274,20 @@ pub(crate) fn load_tags(root: &Path, kind: &str) -> Result Result>> { - let dir = root.join(format!("data/minecraft/tags/{kind}")); let mut raw: HashMap> = HashMap::new(); - fn walk(dir: &Path, base: &Path, raw: &mut HashMap>) -> Result<()> { + fn walk( + dir: &Path, + base: &Path, + namespace: &str, + raw: &mut HashMap>, + ) -> Result<()> { for entry in fs::read_dir(dir)?.flatten() { let p = entry.path(); if p.is_dir() { - walk(&p, base, raw)?; + walk(&p, base, namespace, raw)?; } else if p.extension().is_some_and(|e| e == "json") { let name = format!( - "minecraft:{}", + "{namespace}:{}", p.strip_prefix(base)? .with_extension("") .to_string_lossy() @@ -301,8 +305,12 @@ pub(crate) fn load_tag_lists(root: &Path, kind: &str) -> Result>, out: &mut Vec, depth: u32) { if depth > 32 { diff --git a/crates/horizon-client/src/light.rs b/crates/horizon-client/src/light.rs index 936bc9655..fd271f40f 100644 --- a/crates/horizon-client/src/light.rs +++ b/crates/horizon-client/src/light.rs @@ -71,7 +71,7 @@ impl LightTables { }; let data = nbt::read_named( &std::fs::read(root.join("occlusion.nbt"))?, - Limits::default(), + Limits::tables(), )? .0 .tag; diff --git a/crates/horizon-client/src/mod_content.rs b/crates/horizon-client/src/mod_content.rs index 3a8c2920e..4556a4d6c 100644 --- a/crates/horizon-client/src/mod_content.rs +++ b/crates/horizon-client/src/mod_content.rs @@ -638,6 +638,19 @@ pub fn namespaces(root: &Path) -> Vec { .unwrap_or_default() } +/// The namespaces whose tags loaders read in `root`: `minecraft`, and in a +/// root built by [`build`] the convention tags (`c`, shared between mods as +/// on NeoForge and Fabric) and the content mods' own. +pub fn tag_namespaces(root: &Path) -> Vec { + let mods = namespaces(root); + let mut out = vec!["minecraft".to_owned()]; + if !mods.is_empty() { + out.push("c".to_owned()); + out.extend(mods); + } + out +} + /// Bundles of block tag files (tag id → the tag file's text). const TAG_BUNDLES: [&str; 2] = ["block-tags.json", "worldgen/block_tags.json"]; @@ -735,8 +748,67 @@ fn merge_tag(text: Option<&str>, more: &[J], what: &str) -> Result { Ok(serde_json::to_string_pretty(&doc)?) } +/// The block and item ids and tags a content root has, for tag entries. +struct Known { + blocks: std::collections::BTreeSet, + items: std::collections::BTreeSet, + /// `data//tags//.json` files the mods add. + tag_files: std::collections::BTreeSet, +} +impl Known { + fn new(base: &Path, plan: &Plan, tags: &BTreeMap>) -> Result { + let mut blocks: std::collections::BTreeSet = + plan.defaults.keys().cloned().collect(); + blocks.extend(plan.blocks.iter().map(|b| b.decl.id.clone())); + let mut items = std::collections::BTreeSet::new(); + if let J::Obj(o) = read_json(&base.join("items.json"))? { + items.extend(o.into_iter().map(|(k, _)| k)); + } + items.extend(plan.items.iter().map(|i| i.rename.to.clone())); + Ok(Known { + blocks, + items, + tag_files: tags.keys().cloned().collect(), + }) + } + /// Whether tag `file` keeps entry `v`: a known id or an existing tag, + /// for block and item tags (other registries are kept as they are). + fn keeps(&self, file: &str, v: &J) -> bool { + let id = match v { + J::Str(s) => s.as_str(), + J::Obj(_) => match v.get("id") { + Some(J::Str(s)) => s.as_str(), + _ => return true, + }, + _ => return true, + }; + let Some(kind) = file + .strip_prefix("data/") + .and_then(|r| r.split_once("/tags/")) + .and_then(|(_, rest)| Some(rest.split_once('/')?.0)) + else { + return true; + }; + let ids = match kind { + "block" => &self.blocks, + "item" => &self.items, + _ => return true, + }; + match id.strip_prefix('#') { + Some(tag) => { + let (tns, path) = tag.split_once(':').unwrap_or(("minecraft", tag)); + let rel = format!("data/{tns}/tags/{kind}/{path}.json"); + self.tag_files.contains(&rel) || tns == "minecraft" + } + None => ids.contains(id), + } + } +} + /// Builds the content root for `mods` over `base` in `out`. pub fn build(base: &Path, mods: &[ContentMod], out: &Path) -> Result<()> { + // The overlay links to the base: a relative base would leave them dangling. + let base = &std::path::absolute(base)?; let plan = Plan::new(base, mods)?; let overlay = Overlay::new(base, out)?; for name in JSON_TABLES { @@ -754,11 +826,11 @@ pub fn build(base: &Path, mods: &[ContentMod], out: &Path) -> Result<()> { if !path.exists() { continue; } - let (mut named, _) = nbt::read_named(&fs::read(&path)?, Limits::default()) + let (mut named, _) = nbt::read_named(&fs::read(&path)?, Limits::tables()) .map_err(|e| format!("{name}: {e}"))?; plan.nbt(&mut named.tag); let bytes = - nbt::write_named(&named, Limits::default()).map_err(|e| format!("{name}: {e}"))?; + nbt::write_named(&named, Limits::tables()).map_err(|e| format!("{name}: {e}"))?; overlay.write(name, &bytes)?; } // Mod files, and every tag addition gathered per tag file. @@ -788,6 +860,13 @@ pub fn build(base: &Path, mods: &[ContentMod], out: &Path) -> Result<()> { } } } + // A tag naming an id nobody registers fails as a whole in vanilla, and + // carried-over mods name blocks left out or other mods' ids: such + // entries are dropped instead, so the rest of the tag holds. + let known = Known::new(base, &plan, &tags)?; + for (file, values) in &mut tags { + values.retain(|v| known.keeps(file, v)); + } let mut bundles: Vec<(&str, J)> = Vec::new(); for name in TAG_BUNDLES { if base.join(name).exists() { diff --git a/crates/horizon-client/src/mod_content_tests.rs b/crates/horizon-client/src/mod_content_tests.rs index 6dd92ecfd..d7627fa27 100644 --- a/crates/horizon-client/src/mod_content_tests.rs +++ b/crates/horizon-client/src/mod_content_tests.rs @@ -56,7 +56,7 @@ fn prepared() -> Option { /// A content mod folder: a full block, a door and an item-less glass from /// templates, an item, a vanilla tag addition and a language file. fn ruby_mod(dir: &Path) -> ContentMod { - let files: [(&str, &str); 7] = [ + let files: [(&str, &str); 8] = [ ( "horizon-mod.toml", "id = \"ruby\"\nname = \"Ruby\"\nversion = \"0.1.0\"\napi = \"0.2\"\nside = \"both\"\ncapabilities = [\"registries\"]\n", @@ -78,9 +78,15 @@ fn ruby_mod(dir: &Path) -> ContentMod { "data/ruby/horizon/item/ruby.json", r#"{"template": "minecraft:diamond", "max_stack_size": 16, "rarity": "rare"}"#, ), + // Carried-over tags name blocks left out and other mods' ids too. ( "data/minecraft/tags/block/mineable/pickaxe.json", - r#"{"values": ["ruby:ruby_block"]}"#, + r##"{"values": ["ruby:ruby_block", "ruby:left_out", "othermod:thing", + {"id": "othermod:optional", "required": false}, "#c:storage_blocks/ruby"]}"##, + ), + ( + "data/c/tags/item/gems/ruby.json", + r#"{"values": ["ruby:ruby", "othermod:ruby"]}"#, ), ( "assets/ruby/lang/en_us.json", @@ -110,7 +116,10 @@ fn content_root_loads_with_every_table() { let scratch = std::env::temp_dir().join(format!("horizon-mod-content-{}", std::process::id())); let _ = fs::remove_dir_all(&scratch); let m = ruby_mod(&scratch.join("ruby")); - let root = resource_root(&base, std::slice::from_ref(&m), &scratch.join("cache")).unwrap(); + // The base as a relative path (cargo runs tests in the crate's folder): + // the overlay's links still resolve. + let relative = Path::new("../../.local/horizon-client/26.3"); + let root = resource_root(relative, std::slice::from_ref(&m), &scratch.join("cache")).unwrap(); assert_ne!(root, base); let vanilla = Assets::load(&base).unwrap(); @@ -169,7 +178,12 @@ fn content_root_loads_with_every_table() { let gem = &items.items["ruby:ruby"]; assert_eq!(gem.max_stack, 16); assert!(!items.items.contains_key("ruby:ruby_glass")); - assert!(items.block_tags["minecraft:mineable/pickaxe"].contains("ruby:ruby_block")); + let pickaxe = &items.block_tags["minecraft:mineable/pickaxe"]; + assert!(pickaxe.contains("ruby:ruby_block")); + assert!(!pickaxe.contains("ruby:left_out") && !pickaxe.contains("othermod:thing")); + assert!(pickaxe.contains("minecraft:stone")); + // Convention tags load, with the ids nobody registers dropped. + assert_eq!(items.item_tag_order["c:gems/ruby"], ["ruby:ruby"]); crate::collisions::load(&root, new).unwrap(); crate::models::load_visibility(&root, new).unwrap(); diff --git a/crates/horizon-client/src/models.rs b/crates/horizon-client/src/models.rs index ba5bffefb..110166f29 100644 --- a/crates/horizon-client/src/models.rs +++ b/crates/horizon-client/src/models.rs @@ -120,7 +120,7 @@ pub fn load_visibility( nbt::{self, Limits}, }; use std::{collections::BTreeMap, fs}; - let data = nbt::read_named(&fs::read(root.join("occlusion.nbt"))?, Limits::default())? + let data = nbt::read_named(&fs::read(root.join("occlusion.nbt"))?, Limits::tables())? .0 .tag; let occlusion = CachedCollisionRegistry::from_nbt(&data, registry)?; diff --git a/crates/horizon-client/src/motion.rs b/crates/horizon-client/src/motion.rs index b098142dc..ae2486351 100644 --- a/crates/horizon-client/src/motion.rs +++ b/crates/horizon-client/src/motion.rs @@ -63,7 +63,7 @@ impl MotionResources { )?)?)?); let data = nbt::read_named( &fs::read(root.join("movement-properties.nbt"))?, - Limits::default(), + Limits::tables(), )? .0 .tag; diff --git a/crates/horizon-client/src/stations.rs b/crates/horizon-client/src/stations.rs index 35b02c12e..613086112 100644 --- a/crates/horizon-client/src/stations.rs +++ b/crates/horizon-client/src/stations.rs @@ -481,23 +481,30 @@ fn ingredient(v: &Value, items: &Items) -> Ingredient { } impl StationRecipes { pub fn load(root: &Path, items: &Items) -> Self { - let mut files: Vec<_> = fs::read_dir(root.join("data/minecraft/recipe")) - .into_iter() - .flatten() - .flatten() - .map(|e| e.path()) - .filter(|p| p.extension().is_some_and(|e| e == "json")) - .collect(); - files.sort(); + // Vanilla's recipes, then the content mods' (docs/modpacks.md). + let mut files = Vec::new(); + let namespaces = + std::iter::once("minecraft".to_owned()).chain(crate::mod_content::namespaces(root)); + for namespace in namespaces { + let mut more: Vec<_> = fs::read_dir(root.join(format!("data/{namespace}/recipe"))) + .into_iter() + .flatten() + .flatten() + .map(|e| e.path()) + .filter(|p| p.extension().is_some_and(|e| e == "json")) + .collect(); + more.sort(); + files.extend(more.into_iter().map(|p| (namespace.clone(), p))); + } let mut smithing = Vec::new(); let mut stonecutting = Vec::new(); - for p in files { + for (namespace, p) in files { let Ok(bytes) = fs::read(&p) else { continue }; let Ok(v) = serde_json::from_slice::(&bytes) else { continue; }; let id = format!( - "minecraft:{}", + "{namespace}:{}", p.file_stem().and_then(|s| s.to_str()).unwrap_or("") ); match v["type"].as_str().unwrap_or("") { diff --git a/crates/horizon-mods/src/content.rs b/crates/horizon-mods/src/content.rs index 411fa7277..40b641759 100644 --- a/crates/horizon-mods/src/content.rs +++ b/crates/horizon-mods/src/content.rs @@ -4,7 +4,7 @@ //! //! Content is data, not code: nothing here runs in the sandbox. What a mod //! may add is fenced instead. Its own namespace, plus additions to vanilla -//! tags. Paths are plain, files and totals are capped, and vanilla ids +//! tags and to the convention tags (`c`, which NeoForge and Fabric mods share). Paths are plain, files and totals are capped, and vanilla ids //! cannot be redefined. use crate::manifest::{Capability, MANIFEST, Manifest}; use serde::Deserialize; @@ -242,12 +242,13 @@ impl Content { parts.next().unwrap_or(""), ); let own = namespace == id; - // Vanilla's own files stay vanilla's; a mod may only add to its tags. - let allowed = - own || (top == "data" && namespace == "minecraft" && rest.starts_with("tags/")); + // Vanilla's own files stay vanilla's; a mod may only add to its + // tags, and to the convention tags mods share. + let shared = matches!(namespace, "minecraft" | "c"); + let allowed = own || (top == "data" && shared && rest.starts_with("tags/")); if !allowed { return Err(format!( - "{name}: a mod adds files in its own namespace ({top}/{id}/) or to vanilla tags" + "{name}: a mod adds files in its own namespace ({top}/{id}/) or to vanilla and convention (c) tags" )); } let Some(decl) = (own && top == "data") @@ -417,10 +418,11 @@ capabilities = ["registries"] ("data/ruby/horizon/item/ruby.json", ITEM), ("data/ruby/recipe/ruby_block.json", b"{}"), ("data/minecraft/tags/block/mineable/pickaxe.json", b"{}"), + ("data/c/tags/item/gems/ruby.json", b"{}"), ("assets/ruby/textures/block/ruby_block.png", b"png"), ]; let content = hmod("ok", MANIFEST_TEXT, files).unwrap(); - assert_eq!(content.files.len(), 5); + assert_eq!(content.files.len(), 6); assert_eq!( content.blocks, [Block { @@ -471,6 +473,8 @@ capabilities = ["registries"] "vanilla-recipe", &[("data/minecraft/recipe/stone.json", b"{}")], ); + refused("convention-recipe", &[("data/c/recipe/stone.json", b"{}")]); + refused("convention-asset", &[("assets/c/lang/en_us.json", b"{}")]); let e = refused( "modded-template", &[( diff --git a/crates/horizon-world/src/nbt.rs b/crates/horizon-world/src/nbt.rs index 9d5b9355a..7e4d76a41 100644 --- a/crates/horizon-world/src/nbt.rs +++ b/crates/horizon-world/src/nbt.rs @@ -97,6 +97,18 @@ impl Default for Limits { } } } +impl Limits { + /// The prepared per-state block tables (`cached-collision.nbt`, + /// `block-properties.nbt`, ...): trusted files with a row per block + /// state, which content mods' states grow past the default caps. + pub fn tables() -> Self { + Self { + max_bytes: 1 << 28, + max_nodes: 16_000_000, + max_depth: 512, + } + } +} #[derive(Clone, Debug, PartialEq, Eq)] pub struct Error { diff --git a/crates/horizon-world/src/worldgen/generator_blocks.rs b/crates/horizon-world/src/worldgen/generator_blocks.rs index 6085183ec..dc7db7d20 100644 --- a/crates/horizon-world/src/worldgen/generator_blocks.rs +++ b/crates/horizon-world/src/worldgen/generator_blocks.rs @@ -103,14 +103,12 @@ impl BlockBehavior { return Ok(None); } let read = |name: &str| -> Result { - let limits = Limits { - max_bytes: 1 << 28, - ..Limits::default() - }; - Ok(nbt::read_named(&fs::read(dir.join(name))?, limits) - .map_err(|e| resource(format!("{name}: {e:?}")))? - .0 - .tag) + Ok( + nbt::read_named(&fs::read(dir.join(name))?, Limits::tables()) + .map_err(|e| resource(format!("{name}: {e:?}")))? + .0 + .tag, + ) }; let json = |name: &str| -> Result { Ok(serde_json::from_str(&fs::read_to_string(dir.join(name))?)?) diff --git a/docs/mods.md b/docs/mods.md index 6203c4066..d1556abd7 100644 --- a/docs/mods.md +++ b/docs/mods.md @@ -277,12 +277,15 @@ blocks and items by declaring them in `data//horizon/block/*.json` and ``` The fence: files go in the mod's own namespace (`assets//`, -`data//`), plus additions to vanilla tags (`data/minecraft/tags/`). +`data//`), plus additions to vanilla tags (`data/minecraft/tags/`) and +to the convention tags NeoForge and Fabric mods share (`data/c/tags/`). Templates and `sounds` name vanilla blocks; unknown keys are refused. Paths use vanilla's resource characters, at most 65,536 files, 16 MiB each and 512 MiB in all. A mod whose content is refused stays off, with the reason on -its row. The game reading this content into its block and item tables comes -next (docs/modpacks.md). +its row. The game reads this content into its block and item tables +(`horizon_client::mod_content`, docs/modpacks.md). A tag entry naming an id +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. ## Versions and compatibility From 886def4360a904802f30d1e053281ef35cf6b4d6 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 16 Oct 2026 23:25:54 +0200 Subject: [PATCH 09/59] horizon-port-pack carry: templates and numbers from the NeoForge oracle, 1.21.1 loot upgraded Carrying over seven real ATM10 mods (Cloud Glass, Factory Blocks, Glassential, Macaw's Doors, Fences, Paths and Trapdoors) showed what the guesses missed: - Loot tables: 1.21.1's `conditions` lists, `functions` and `condition`/`function` kinds are now 26.3's single `condition`, `modifier` and `type`; silk-touch and shears tool matches become `minecraft:tool/can_silk_touch` and `can_shear`. Before, every drop condition was ignored (glass dropped itself by hand, upper door halves dropped doors, double slabs dropped one). - With the oracle's facts (/oracle/facts.json, from tools/neoforge_oracle.py in the next PR), every registered block gets the vanilla template of the same vanilla class and states that matches its shapes, sounds, BlockSetType and WoodType best, and the mod's own hardness, blast resistance, light, tool need, friction, map colour and sounds. Items get stack size and rarity. The carry report lists what a template does not reproduce and why a block was left out. - Convention tags a recipe uses (c:dyes/red) are written from the oracle's tags, vanilla and own members only; the jar's own c tags stay inside the mod. - Without the oracle, blockstates that omit properties their models ignore (powered, waterlogged) still find their template, and names pick between fences and panes, doors and trapdoors. - `version = "${file.jarVersion}"` is read from MANIFEST.MF. - `--resources ` limits templates to blocks Horizon has. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-port-pack/src/carry.rs | 393 ++++++++++++++++++++++--- crates/horizon-port-pack/src/jar.rs | 16 + crates/horizon-port-pack/src/main.rs | 63 +++- crates/horizon-port-pack/src/oracle.rs | 384 ++++++++++++++++++++++++ docs/modpacks.md | 29 +- 5 files changed, 835 insertions(+), 50 deletions(-) create mode 100644 crates/horizon-port-pack/src/oracle.rs diff --git a/crates/horizon-port-pack/src/carry.rs b/crates/horizon-port-pack/src/carry.rs index 42c457f02..a637d6246 100644 --- a/crates/horizon-port-pack/src/carry.rs +++ b/crates/horizon-port-pack/src/carry.rs @@ -3,7 +3,7 @@ //! upgraded from 1.21.1 to 26.3, item models get their `items/` client //! definitions, and each blockstate gets a vanilla template guessed from its //! properties until the oracle's facts replace the guess. -use crate::jar::JarInfo; +use crate::{jar::JarInfo, oracle::Facts}; use serde::Serialize; use serde_json::{Value, json}; use std::{ @@ -20,14 +20,26 @@ pub struct Report { /// data other than tags), kept in `outside/` for review. pub outside: Vec, pub recipes_upgraded: usize, + pub loot_tables_upgraded: usize, + /// Worldgen and structure files (`data//worldgen/`, `structure/`). + pub worldgen: usize, /// Recipes left as they were: custom types, NeoForge conditions. pub recipes_kept: Vec, pub item_definitions_added: usize, - /// Declared blocks and their guessed templates. + /// Templates and properties came from the NeoForge oracle's facts, not + /// from guesses. + pub oracle: bool, + /// Declared blocks and their templates. pub blocks: BTreeMap, - /// Blockstates whose properties match no template. - pub blocks_unknown: Vec, + /// What a declared block's template does not reproduce (oracle only). + pub differences: BTreeMap>, + /// Blocks left out, and why. + pub blocks_unknown: BTreeMap, pub items: usize, + /// Items left out, and why (oracle only). + pub items_unknown: BTreeMap, + /// Convention (`c:`) tags the recipes use, filled in from the oracle. + pub convention_tags: usize, } /// Vanilla blocks by their sorted property names. @@ -42,6 +54,7 @@ const TEMPLATES: &[(&str, &str)] = &[ "minecraft:oak_trapdoor", ), ("east,north,south,waterlogged,west", "minecraft:oak_fence"), + ("east,north,south,waterlogged,west", "minecraft:glass_pane"), ( "east,north,south,up,waterlogged,west", "minecraft:cobblestone_wall", @@ -58,9 +71,24 @@ const TEMPLATES: &[(&str, &str)] = &[ ("stage", "minecraft:oak_sapling"), ]; -pub fn template(properties: &BTreeSet) -> Option<&'static str> { - let key = properties.iter().cloned().collect::>().join(","); - TEMPLATES.iter().find(|(k, _)| *k == key).map(|(_, t)| *t) +/// A guess without the oracle: the template whose properties include the +/// blockstate's with the fewest left over (a blockstate may leave out what +/// its models ignore, such as `powered` or `waterlogged`), the block's name +/// breaking ties (`_pane`, `_gate`, `_trapdoor`). +pub fn template(name: &str, properties: &BTreeSet) -> Option<&'static str> { + let fits = TEMPLATES.iter().filter_map(|(k, t)| { + let have: BTreeSet<&str> = k.split(',').filter(|p| !p.is_empty()).collect(); + properties + .iter() + .all(|p| have.contains(p.as_str())) + .then(|| (have.len() - properties.len(), *t)) + }); + let hint = |t: &str| { + let kind = t.rsplit('_').next().unwrap_or(t); + !name.ends_with(&format!("_{kind}")) + }; + fits.min_by_key(|&(extra, t)| (extra, hint(t))) + .map(|(_, t)| t) } /// The property names a blockstate file uses. @@ -165,7 +193,92 @@ pub fn upgrade_recipe(recipe: &mut Value) -> bool { true } -/// Where a jar entry goes: `Some(true)` inside the content mod, `Some(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 +/// silk touch alone, or on shears alone, becomes 26.3's +/// `minecraft:tool/can_silk_touch` or `minecraft:tool/can_shear`. +pub fn upgrade_loot(v: &mut Value) { + match v { + Value::Array(a) => a.iter_mut().for_each(upgrade_loot), + Value::Object(o) => { + if let Some(Value::Array(mut list)) = o.remove("conditions") { + list.iter_mut().for_each(upgrade_condition); + let one = match <[Value; 1]>::try_from(list) { + Ok([c]) => c, + Err(list) => json!({"type": "minecraft:all_of", "terms": list}), + }; + o.insert("condition".to_owned(), one); + } + if let Some(Value::Array(mut list)) = o.remove("functions") { + for f in &mut list { + rename_kind(f, "function"); + upgrade_loot(f); + } + o.insert("modifier".to_owned(), Value::Array(list)); + } + for (k, x) in o.iter_mut() { + if k != "condition" && k != "modifier" { + upgrade_loot(x); + } + } + } + _ => {} + } +} + +/// `{"": kind, ...}` as `{"type": kind, ...}`. +fn rename_kind(v: &mut Value, key: &str) { + if let Some(o) = v.as_object_mut() + && !o.contains_key("type") + && let Some(kind) = o.remove(key) + { + o.insert("type".to_owned(), kind); + } +} + +/// One 1.21.1 loot condition in 26.3's shape. +fn upgrade_condition(c: &mut Value) { + rename_kind(c, "condition"); + if let Some(term) = c.get_mut("term") { + upgrade_condition(term); + } + if let Some(Value::Array(terms)) = c.get_mut("terms") { + terms.iter_mut().for_each(upgrade_condition); + } + if c["type"] == "minecraft:match_tool" + && let Some(named) = named_tool_condition(&c["predicate"]) + { + *c = json!(named); + } +} + +/// 26.3's named tool conditions for the 1.21.1 predicates they replace. +fn named_tool_condition(predicate: &Value) -> Option<&'static str> { + let keys: Vec<&str> = predicate.as_object()?.keys().map(String::as_str).collect(); + match keys.as_slice() { + ["predicates"] => { + let list = predicate["predicates"]["minecraft:enchantments"].as_array()?; + let [e] = list.as_slice() else { + return None; + }; + let silk = e["enchantments"] == "minecraft:silk_touch" + && e["levels"]["min"].as_u64().unwrap_or(1) <= 1 + && e["levels"].get("max").is_none() + && predicate["predicates"].as_object()?.len() == 1; + silk.then_some("minecraft:tool/can_silk_touch") + } + ["items"] => { + let items = &predicate["items"]; + let shears = items == "minecraft:shears" || *items == json!(["minecraft:shears"]); + shears.then_some("minecraft:tool/can_shear") + } + _ => None, + } +} + +/// Where a jar entry goes: `Some(true)` inside the content mod (its own +/// namespace, additions to vanilla and convention tags), `Some(false)` /// to `outside/`, `None` not carried (code, metadata). fn place(name: &str, id: &str) -> Option { let mut parts = name.splitn(3, '/'); @@ -173,10 +286,21 @@ fn place(name: &str, id: &str) -> Option { if !(root == "assets" || root == "data") || rest.is_empty() || name.ends_with('/') { return None; } - Some(ns == id || (root == "data" && ns == "minecraft" && rest.starts_with("tags/"))) + let shared_tags = + root == "data" && (ns == "minecraft" || ns == "c") && rest.starts_with("tags/"); + Some(ns == id || shared_tags) } -pub fn carry(jar: &Path, info: &JarInfo, out: &Path) -> Result { +/// 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. +pub fn carry( + jar: &Path, + info: &JarInfo, + out: &Path, + facts: Option<&Facts>, + allowed: &dyn Fn(&str) -> bool, +) -> Result { let id = &info.mod_id; if id.is_empty() || id.len() > 64 @@ -196,6 +320,7 @@ pub fn carry(jar: &Path, info: &JarInfo, out: &Path) -> Result { let mut report = Report::default(); let mut blockstates: BTreeMap = BTreeMap::new(); let mut item_models = BTreeSet::new(); + let mut convention = BTreeSet::new(); for i in 0..zip.len() { let mut entry = zip.by_index(i).map_err(|e| e.to_string())?; let name = entry.name().to_owned(); @@ -218,11 +343,17 @@ pub fn carry(jar: &Path, info: &JarInfo, out: &Path) -> Result { }; if keep { let rel = name.split_once(&format!("/{id}/")).map_or("", |(_, r)| r); + if name.starts_with("data/") + && (rel.starts_with("worldgen/") || rel.starts_with("structure/")) + { + report.worldgen += 1; + } if let Some(file) = rel .strip_prefix("recipe/") .filter(|_| name.starts_with("data/")) { if let Ok(mut recipe) = serde_json::from_slice::(&bytes) { + tags_used(&recipe, &mut convention); if upgrade_recipe(&mut recipe) { report.recipes_upgraded += 1; bytes = serde_json::to_vec_pretty(&recipe).unwrap_or(bytes); @@ -230,6 +361,15 @@ pub fn carry(jar: &Path, info: &JarInfo, out: &Path) -> Result { report.recipes_kept.push(file.to_owned()); } } + } else if rel.starts_with("loot_table/") && name.starts_with("data/") { + if let Ok(mut table) = serde_json::from_slice::(&bytes) { + let before = table.clone(); + upgrade_loot(&mut table); + if table != before { + report.loot_tables_upgraded += 1; + bytes = serde_json::to_vec_pretty(&table).unwrap_or(bytes); + } + } } else if let Some(b) = rel .strip_prefix("blockstates/") .and_then(|b| b.strip_suffix(".json")) @@ -257,25 +397,116 @@ pub fn carry(jar: &Path, info: &JarInfo, out: &Path) -> Result { } } let decl = inside.join(format!("data/{id}/horizon")); - for (b, state) in &blockstates { - match template(&properties(state)) { - Some(t) => { - write( - &decl.join(format!("block/{b}.json")), - json!({"template": t}).to_string().as_bytes(), - )?; - report.blocks.insert(b.clone(), t.to_owned()); + let write_decl = |kind: &str, name: &str, v: &Value| { + let text = serde_json::to_vec_pretty(v).unwrap_or_default(); + write(&decl.join(format!("{kind}/{name}.json")), &text) + }; + if let Some(facts) = facts { + report.oracle = true; + let prefix = format!("{id}:"); + let mut declared = BTreeSet::new(); + for (full, block) in facts.blocks.range(prefix.clone()..) { + let Some(b) = full.strip_prefix(&prefix) else { + break; + }; + let Some(choice) = facts.template(full, allowed) else { + let props: Vec<&str> = block.properties.keys().map(String::as_str).collect(); + let why = format!( + "no vanilla {} with properties [{}]", + block.vanilla_class().rsplit('.').next().unwrap_or(""), + props.join(", ") + ); + report.blocks_unknown.insert(b.to_owned(), why); + continue; + }; + let mut v = json!({"template": choice.template, "properties": choice.properties}); + if block.item == "minecraft:air" { + v["item"] = json!(false); + } else if block.item != *full { + v["item"] = json!(false); + report + .differences + .entry(b.to_owned()) + .or_default() + .push(format!("its item is {}", block.item)); + } else { + declared.insert(full.clone()); + } + write_decl("block", b, &v)?; + report.blocks.insert(b.to_owned(), choice.template); + if !choice.differences.is_empty() { + report + .differences + .entry(b.to_owned()) + .or_default() + .extend(choice.differences); } - None => report.blocks_unknown.push(b.clone()), } - } - for m in item_models.iter().filter(|m| !blockstates.contains_key(*m)) { - let item = json!({"template": "minecraft:stick"}); - write( - &decl.join(format!("item/{m}.json")), - item.to_string().as_bytes(), - )?; - report.items += 1; + for (full, item) in facts.items.range(prefix.clone()..) { + let Some(name) = full.strip_prefix(&prefix) else { + break; + }; + if declared.contains(full) { + continue; + } + if item + .block + .as_ref() + .is_some_and(|b| facts.blocks.contains_key(b)) + && report.blocks_unknown.contains_key(name) + { + report + .items_unknown + .insert(name.to_owned(), "its block is left out".into()); + continue; + } + match facts.item(full) { + Ok((v, differences)) => { + write_decl("item", name, &v)?; + report.items += 1; + if !differences.is_empty() { + report.differences.insert(name.to_owned(), differences); + } + } + Err(e) => { + report.items_unknown.insert(name.to_owned(), e); + } + } + } + // Convention tags are NeoForge's and the pack's: the recipes get the + // members the oracle saw, those of vanilla and of this mod. + for tag in &convention { + let Some(path) = tag.strip_prefix("c:") else { + continue; + }; + let file = inside.join(format!("data/c/tags/item/{path}.json")); + if file.exists() { + continue; + } + if let Some(members) = facts.tag_members("item", tag, id) { + let v = json!({"values": members}); + write(&file, &serde_json::to_vec_pretty(&v).unwrap_or_default())?; + report.convention_tags += 1; + } + } + } else { + for (b, state) in &blockstates { + match template(b, &properties(state)) { + Some(t) => { + write_decl("block", b, &json!({"template": t}))?; + report.blocks.insert(b.clone(), t.to_owned()); + } + None => { + let props: Vec = properties(state).into_iter().collect(); + let why = format!("no template for properties [{}]", props.join(", ")); + report.blocks_unknown.insert(b.clone(), why); + } + } + } + for m in item_models.iter().filter(|m| !blockstates.contains_key(*m)) { + write_decl("item", m, &json!({"template": "minecraft:stick"}))?; + report.items += 1; + } } let q = |s: &str| toml::Value::String(s.to_owned()).to_string(); let name = if info.name.is_empty() { id } else { &info.name }; @@ -299,6 +530,30 @@ pub fn carry(jar: &Path, info: &JarInfo, out: &Path) -> Result { Ok(report) } +/// The tags a recipe's ingredients name (`#ns:path` or `{"tag": ...}`). +fn tags_used(v: &Value, out: &mut BTreeSet) { + match v { + Value::String(s) => { + if let Some(t) = s.strip_prefix('#') { + out.insert(t.to_owned()); + } + } + Value::Array(a) => a.iter().for_each(|x| tags_used(x, out)), + Value::Object(o) => { + for (k, x) in o { + match (k.as_str(), x) { + ("tag", Value::String(t)) => { + out.insert(t.clone()); + } + ("result", _) => {} + _ => tags_used(x, out), + } + } + } + _ => {} + } +} + fn write(path: &Path, bytes: &[u8]) -> Result<(), String> { if let Some(dir) = path.parent() { fs::create_dir_all(dir).map_err(|e| format!("{}: {e}", dir.display()))?; @@ -325,21 +580,86 @@ mod tests { assert!(!upgrade_recipe(&mut tag_list)); } + #[test] + fn upgrades_loot_tables() { + let mut slab = json!({"type": "minecraft:block", "pools": [{"rolls": 1.0, "entries": [{ + "type": "minecraft:item", "name": "m:slab", + "functions": [{"function": "minecraft:set_count", "count": 2.0, "add": false, + "conditions": [{"condition": "minecraft:block_state_property", "block": "m:slab", + "properties": {"type": "double"}}]}, + {"function": "minecraft:explosion_decay"}]}]}]}); + upgrade_loot(&mut slab); + assert_eq!( + slab["pools"][0]["entries"][0]["modifier"][0], + json!({"type": "minecraft:set_count", "count": 2.0, "add": false, + "condition": {"type": "minecraft:block_state_property", "block": "m:slab", + "properties": {"type": "double"}}}) + ); + let silk = json!({"condition": "minecraft:match_tool", "predicate": {"predicates": { + "minecraft:enchantments": [{"enchantments": "minecraft:silk_touch", "levels": {"min": 1}}]}}}); + let shears = json!({"condition": "minecraft:match_tool", "predicate": {"items": "minecraft:shears"}}); + let mut glass = json!({"pools": [{"conditions": [silk.clone()], "entries": []}, + {"conditions": [{"condition": "minecraft:any_of", "terms": [silk, shears]}, + {"condition": "minecraft:survives_explosion"}], "entries": []}]}); + upgrade_loot(&mut glass); + assert_eq!( + glass["pools"][0]["condition"], + "minecraft:tool/can_silk_touch" + ); + assert_eq!( + glass["pools"][1]["condition"], + json!({"type": "minecraft:all_of", "terms": [ + {"type": "minecraft:any_of", "terms": ["minecraft:tool/can_silk_touch", "minecraft:tool/can_shear"]}, + {"type": "minecraft:survives_explosion"}]}) + ); + // A loot table already in 26.3's shape stays as it is. + let mut new = glass.clone(); + upgrade_loot(&mut new); + assert_eq!(new, glass); + } + #[test] fn templates_from_blockstate_properties() { let door = json!({"variants": {"facing=east,half=lower,hinge=left,open=false,powered=false": {}}}); - assert_eq!(template(&properties(&door)), Some("minecraft:oak_door")); + assert_eq!( + template("gem_door", &properties(&door)), + Some("minecraft:oak_door") + ); + // Models that ignore `powered`: still a door. + let door = json!({"variants": {"facing=east,half=lower,hinge=left,open=false": {}}}); + assert_eq!( + template("gem_door", &properties(&door)), + Some("minecraft:oak_door") + ); + let trapdoor = json!({"variants": {"facing=east,half=top,open=false": {}}}); + assert_eq!( + template("gem_trapdoor", &properties(&trapdoor)), + Some("minecraft:oak_trapdoor") + ); + let sides = json!({"multipart": [{"when": {"north": "true"}}, {"when": {"east": "true"}}, + {"when": {"south": "true"}}, {"when": {"west": "true"}}]}); + assert_eq!( + template("gem_pane", &properties(&sides)), + Some("minecraft:glass_pane") + ); + assert_eq!( + template("gem_fence", &properties(&sides)), + Some("minecraft:oak_fence") + ); let fence = json!({"multipart": [{"apply": {}}, {"when": {"north": "true"}, "apply": {}}, {"when": {"east": "true"}}, {"when": {"south": "true"}}, {"when": {"west": "true"}}, {"when": {"OR": [{"waterlogged": "true"}]}}]}); - assert_eq!(template(&properties(&fence)), Some("minecraft:oak_fence")); assert_eq!( - template(&properties(&json!({"variants": {"": {}}}))), + template("gem_fence", &properties(&fence)), + Some("minecraft:oak_fence") + ); + assert_eq!( + template("gem_block", &properties(&json!({"variants": {"": {}}}))), Some("minecraft:stone") ); let odd = json!({"variants": {"charge=1,mode=fast": {}}}); - assert_eq!(template(&properties(&odd)), None); + assert_eq!(template("gem_core", &properties(&odd)), None); } /// A small NeoForge jar carried over is a content mod Horizon loads. @@ -411,14 +731,17 @@ mod tests { ); assert_eq!(info.census.classes, 1); let out = dir.join("work/mods/gem"); - let report = carry(&jar, &info, &out).unwrap(); - assert_eq!(report.copied, 11); - assert_eq!(report.outside, ["data/c/tags/item/gems.json"]); + let report = carry(&jar, &info, &out, None, &|_| true).unwrap(); + assert_eq!(report.copied, 12); + assert!(report.outside.is_empty()); assert_eq!((report.recipes_upgraded, report.recipes_kept.len()), (1, 1)); assert_eq!(report.item_definitions_added, 2); assert_eq!(report.blocks["gem_door"], "minecraft:oak_door"); assert_eq!(report.blocks["gem_block"], "minecraft:stone"); - assert_eq!(report.blocks_unknown, ["gem_core"]); + assert_eq!( + report.blocks_unknown.keys().collect::>(), + ["gem_core"] + ); assert_eq!(report.items, 1); let carried = out.join("carry"); assert!(!carried.join("com").exists()); diff --git a/crates/horizon-port-pack/src/jar.rs b/crates/horizon-port-pack/src/jar.rs index 67028755e..86e936e44 100644 --- a/crates/horizon-port-pack/src/jar.rs +++ b/crates/horizon-port-pack/src/jar.rs @@ -50,6 +50,12 @@ pub fn read(path: &Path) -> Result { } else { JarInfo::default() }; + // `version = "${file.jarVersion}"` is filled in from the manifest at load. + if info.version.starts_with("${") { + info.version = text(&mut zip, "META-INF/MANIFEST.MF") + .and_then(|m| manifest_value(&m, "Implementation-Version")) + .unwrap_or_default(); + } let names: Vec = zip.file_names().map(str::to_owned).collect(); info.census = census(&names); if info.mod_id.is_empty() { @@ -61,6 +67,16 @@ pub fn read(path: &Path) -> Result { Ok(info) } +/// A main-section attribute of `META-INF/MANIFEST.MF`. +fn manifest_value(manifest: &str, key: &str) -> Option { + manifest + .lines() + .take_while(|l| !l.trim().is_empty()) + .find_map(|l| l.strip_prefix(key)?.strip_prefix(':')) + .map(|v| v.trim().to_owned()) + .filter(|v| !v.is_empty()) +} + /// `[[mods]]` (the first one is the jar's mod), the top-level `license`, and /// `[[dependencies.]]` with `type = "required"` (or the older /// `mandatory = true`). diff --git a/crates/horizon-port-pack/src/main.rs b/crates/horizon-port-pack/src/main.rs index 4df3ef3ca..74178f503 100644 --- a/crates/horizon-port-pack/src/main.rs +++ b/crates/horizon-port-pack/src/main.rs @@ -6,8 +6,11 @@ //! `/modrinth.json`), the jars in the instance or `/jars/`, //! classes, tiers and dependency layers in `/inventory.json` and //! `inventory.csv`. -//! - `carry [...]`: the content mods' data and assets into -//! `/mods//carry/`, a folder mod for local use. +//! - `carry [--resources ] [...]`: the content +//! mods' data and assets into `/mods//carry/`, a folder mod for +//! local use. With the NeoForge oracle's `/oracle/facts.json` +//! (`tools/neoforge_oracle.py`), blocks and items come from its facts; +//! `--resources` limits templates to the blocks Horizon's tables have. //! //! The work folder belongs to the user: jars and carried-over files stay //! there and are never uploaded or committed. @@ -17,10 +20,11 @@ mod import; mod inventory; mod jar; mod modrinth; +mod oracle; use std::{fs, path::Path, process::ExitCode}; -const USAGE: &str = "usage: horizon-port-pack import | inventory [--offline] | carry [...]"; +const USAGE: &str = "usage: horizon-port-pack import | inventory [--offline] | carry [--resources ] [...]"; fn main() -> ExitCode { let args: Vec = std::env::args().skip(1).collect(); @@ -32,7 +36,19 @@ fn main() -> ExitCode { Some("inventory") => { path(1).and_then(|w| inventory(w, args.iter().any(|a| a == "--offline"))) } - Some("carry") => path(1).and_then(|w| carry(w, &args[2..])), + Some("carry") => path(1).and_then(|w| { + let mut rest = args[2..].to_vec(); + let resources = match rest.iter().position(|a| a == "--resources") { + Some(i) if i + 1 < rest.len() => { + let r = rest.remove(i + 1); + rest.remove(i); + Some(std::path::PathBuf::from(r)) + } + Some(_) => return Err(USAGE.to_owned()), + None => None, + }; + carry(w, resources.as_deref(), &rest) + }), _ => Err(USAGE.to_owned()), }; match result { @@ -107,8 +123,31 @@ fn inventory(work: &Path, offline: bool) -> Result<(), String> { Ok(()) } -fn carry(work: &Path, only: &[String]) -> Result<(), String> { +/// The vanilla blocks a prepared resource root has (`facts.json`'s defaults). +fn vanilla_blocks(resources: &Path) -> Result, String> { + let facts: serde_json::Value = read_json(&resources.join("facts.json"))?; + let defaults = facts["defaults"] + .as_object() + .ok_or("facts.json: no defaults")?; + Ok(defaults.keys().cloned().collect()) +} + +fn carry(work: &Path, resources: Option<&Path>, only: &[String]) -> Result<(), String> { let records: Vec = read_json(&work.join("inventory.json"))?; + let facts_path = work.join("oracle/facts.json"); + let facts = if facts_path.exists() { + let f = oracle::Facts::read(&facts_path)?; + println!( + "oracle facts: {} blocks, {} items", + f.blocks.len(), + f.items.len() + ); + Some(f) + } else { + None + }; + let vanilla = resources.map(vanilla_blocks).transpose()?; + let allowed = |b: &str| vanilla.as_ref().is_none_or(|v| v.contains(b)); let mut done = 0; for r in &records { let chosen = if only.is_empty() { @@ -125,19 +164,29 @@ fn carry(work: &Path, only: &[String]) -> Result<(), String> { if !chosen { continue; } - match carry::carry(jar, info, &work.join("mods").join(&r.key)) { + match carry::carry( + jar, + info, + &work.join("mods").join(&r.key), + facts.as_ref(), + &allowed, + ) { Ok(report) => { done += 1; println!( - "{}: {} files, {} recipes upgraded ({} kept), {} item definitions added, {} blocks ({} without a template), {} items, {} outside", + "{}: {} files, {} recipes upgraded ({} kept), {} loot tables upgraded, {} item definitions added, {} blocks ({} left out, {} with differences), {} items ({} left out), {} convention tags, {} outside", r.key, report.copied, report.recipes_upgraded, report.recipes_kept.len(), + report.loot_tables_upgraded, report.item_definitions_added, report.blocks.len(), report.blocks_unknown.len(), + report.differences.len(), report.items, + report.items_unknown.len(), + report.convention_tags, report.outside.len() ); } diff --git a/crates/horizon-port-pack/src/oracle.rs b/crates/horizon-port-pack/src/oracle.rs new file mode 100644 index 000000000..1fa9a717c --- /dev/null +++ b/crates/horizon-port-pack/src/oracle.rs @@ -0,0 +1,384 @@ +//! The NeoForge oracle's facts (`tools/neoforge_oracle.py export`, in +//! `/oracle/facts.json`): every block, item, recipe and tag the pack's +//! mods register, read from the running game, and the vanilla blocks beside +//! them. Carry-over uses them in place of guesses: a block's template is the +//! vanilla block of the same class and states whose shapes and sounds match +//! best, and the declared properties are the mod's own numbers. +use serde::Deserialize; +use serde_json::{Map, Value, json}; +use std::{ + collections::{BTreeMap, BTreeSet}, + path::Path, +}; + +#[derive(Debug, Deserialize)] +pub struct Facts { + pub blocks: BTreeMap, + pub items: BTreeMap, + #[serde(default)] + pub tags: Tags, +} + +#[derive(Debug, Default, Deserialize)] +pub struct Tags { + #[serde(default)] + pub block: BTreeMap>, + #[serde(default)] + pub item: BTreeMap>, +} + +#[derive(Debug, Deserialize)] +pub struct Block { + /// The class and its superclasses, most derived first. + pub class: Vec, + pub properties: BTreeMap>, + pub default: String, + pub item: String, + pub explosion_resistance: f32, + pub friction: f32, + pub speed_factor: f32, + pub jump_factor: f32, + #[serde(default)] + pub block_set_type: Option, + #[serde(default)] + pub wood_type: Option, + pub states: BTreeMap, +} + +#[derive(Debug, Deserialize)] +pub struct SetType { + pub name: String, + pub can_open_by_hand: bool, +} + +#[derive(Debug, Deserialize)] +pub struct State { + pub hardness: f32, + pub emission: u8, + pub requires_tool: bool, + pub map_color_id: u8, + pub sound: Value, + pub outline: Value, + pub collision: Value, +} + +#[derive(Debug, Deserialize)] +pub struct Item { + pub class: String, + pub max_stack_size: u8, + pub rarity: String, + #[serde(default)] + pub block: Option, + #[serde(default)] + pub food: Option, +} + +const VANILLA_PACKAGE: &str = "net.minecraft."; + +/// A state key with its properties sorted, so keys compare across blocks. +pub fn state_key(key: &str) -> String { + let mut parts: Vec<&str> = key.split(',').filter(|p| !p.is_empty()).collect(); + parts.sort_unstable(); + parts.join(",") +} + +impl Block { + /// The first vanilla class in the chain. + pub fn vanilla_class(&self) -> &str { + self.class + .iter() + .find(|c| c.starts_with(VANILLA_PACKAGE)) + .map_or("", String::as_str) + } + /// Its own class is a mod class: behaviour code the template may not have. + pub fn custom_class(&self) -> bool { + self.class + .first() + .is_some_and(|c| !c.starts_with(VANILLA_PACKAGE)) + } + fn default_state(&self) -> Option<&State> { + self.states + .get(&self.default) + .or_else(|| self.states.values().next()) + } + fn same_states(&self, other: &Block) -> bool { + self.properties.len() == other.properties.len() + && self.properties.iter().all(|(k, v)| { + other.properties.get(k).is_some_and(|w| { + v.iter().collect::>() == w.iter().collect::>() + }) + }) + } + fn by_key(&self) -> BTreeMap { + self.states.iter().map(|(k, s)| (state_key(k), s)).collect() + } +} + +/// The template carry-over gives a mod block. +#[derive(Debug, Clone, PartialEq)] +pub struct Choice { + pub template: String, + /// `data//horizon/block/.json`'s `properties`. + pub properties: Map, + /// What the template does not reproduce, for the report. + pub differences: Vec, +} + +impl Facts { + pub fn read(path: &Path) -> Result { + let bytes = std::fs::read(path).map_err(|e| format!("{}: {e}", path.display()))?; + serde_json::from_slice(&bytes).map_err(|e| format!("{}: {e}", path.display())) + } + + /// The vanilla block that best stands in for `id`: the same vanilla + /// class and states, then the most states with the same outline and + /// collision, then the same sounds, set type, wood type and hardness. + /// `None` when no vanilla block has its class and states. + pub fn template(&self, id: &str, allowed: &dyn Fn(&str) -> bool) -> Option { + let block = self.blocks.get(id)?; + let class = block.vanilla_class(); + let own = block.by_key(); + let ours = block.default_state()?; + let mut best: Option<(i64, &str, &Block)> = None; + for (name, v) in &self.blocks { + if !name.starts_with("minecraft:") + || v.vanilla_class() != class + || v.custom_class() + || !block.same_states(v) + || !allowed(name) + { + continue; + } + let theirs = v.by_key(); + let shapes = own + .iter() + .filter(|(k, s)| { + theirs + .get(*k) + .is_some_and(|t| t.outline == s.outline && t.collision == s.collision) + }) + .count() as i64; + let Some(td) = v.default_state() else { + continue; + }; + let same_set = match (&block.block_set_type, &v.block_set_type) { + (Some(a), Some(b)) => { + (a.name == b.name) as i64 * 2 + + (a.can_open_by_hand == b.can_open_by_hand) as i64 * 8 + } + _ => 0, + }; + let score = shapes * 1000 + + (td.sound == ours.sound) as i64 * 100 + + same_set * 10 + + (block.wood_type.is_some() && block.wood_type == v.wood_type) as i64 * 20 + + (td.hardness == ours.hardness) as i64 * 5 + + (td.map_color_id == ours.map_color_id) as i64; + if best.is_none_or(|(s, n, _)| score > s || (score == s && name.as_str() < n)) { + best = Some((score, name, v)); + } + } + let (_, template, t) = best?; + Some(self.choice(block, template, t, allowed)) + } + + fn choice( + &self, + block: &Block, + template: &str, + t: &Block, + allowed: &dyn Fn(&str) -> bool, + ) -> Choice { + let (ours, theirs) = (block.default_state(), t.default_state()); + let mut properties = Map::new(); + let mut differences = Vec::new(); + if let Some(s) = ours { + properties.insert("hardness".into(), json!(s.hardness)); + properties.insert( + "explosion_resistance".into(), + json!(block.explosion_resistance), + ); + properties.insert("light".into(), json!(s.emission)); + properties.insert("requires_tool".into(), json!(s.requires_tool)); + properties.insert("friction".into(), json!(block.friction)); + properties.insert("map_color".into(), json!(s.map_color_id)); + if theirs.is_none_or(|t| t.sound != s.sound) { + match self.sound_block(&s.sound, allowed) { + Some(b) => { + properties.insert("sounds".into(), json!(b)); + } + None => differences.push("sounds: no vanilla block has them".into()), + } + } + } + if (block.speed_factor, block.jump_factor) != (t.speed_factor, t.jump_factor) { + differences.push(format!( + "speed and jump factors {} {} (template {} {})", + block.speed_factor, block.jump_factor, t.speed_factor, t.jump_factor + )); + } + let theirs = t.by_key(); + let mut shapes = 0; + let mut varying = BTreeSet::new(); + let first = ours.map(|s| (s.hardness, s.emission, s.requires_tool, s.map_color_id)); + for (k, s) in block.by_key() { + let Some(v) = theirs.get(&k) else { + continue; + }; + if v.outline != s.outline || v.collision != s.collision { + shapes += 1; + } + if Some((s.hardness, s.emission, s.requires_tool, s.map_color_id)) != first { + varying.insert("per-state hardness, light or map colour"); + } + } + if shapes > 0 { + differences.push(format!( + "shapes differ from {template} in {shapes} of {} states", + block.states.len() + )); + } + differences.extend(varying.into_iter().map(str::to_owned)); + if block.custom_class() { + differences.push(format!( + "class {} (behaviour beyond {})", + block.class[0], + block.vanilla_class() + )); + } + Choice { + template: template.to_owned(), + properties, + differences, + } + } + + /// A vanilla block whose default state has these sounds. + fn sound_block(&self, sound: &Value, allowed: &dyn Fn(&str) -> bool) -> Option<&str> { + self.blocks + .iter() + .filter(|(n, _)| n.starts_with("minecraft:") && allowed(n)) + .find(|(_, b)| b.default_state().is_some_and(|s| &s.sound == sound)) + .map(|(n, _)| n.as_str()) + } + + /// An item declaration for a mod item that is not a declared block's: + /// a vanilla template item with its stack size and rarity, and what it + /// does not reproduce. + pub fn item(&self, id: &str) -> Result<(Value, Vec), String> { + let item = self.items.get(id).ok_or("not in the oracle")?; + if item.block.is_some() { + return Err("a block item without a block".into()); + } + let mut differences = Vec::new(); + if !item.class.starts_with(VANILLA_PACKAGE) { + differences.push(format!("class {} (behaviour beyond Item)", item.class)); + } + if item.food.is_some() { + return Err("food (no food template yet)".into()); + } + let mut decl = json!({"template": "minecraft:stick"}); + if item.max_stack_size != 64 { + decl["max_stack_size"] = json!(item.max_stack_size); + } + if item.rarity != "common" { + decl["rarity"] = json!(item.rarity); + } + Ok((decl, differences)) + } + + /// A tag's members the content mod may name: vanilla's and its own. + pub fn tag_members(&self, kind: &str, tag: &str, own: &str) -> Option> { + let map = if kind == "block" { + &self.tags.block + } else { + &self.tags.item + }; + let members = map.get(tag)?; + Some( + members + .iter() + .filter(|m| { + m.split_once(':') + .is_some_and(|(ns, _)| ns == "minecraft" || ns == own) + }) + .cloned() + .collect(), + ) + } +} + +#[cfg(test)] +mod tests { + use super::*; + + fn state(hardness: f32, sound: &str, outline: Value) -> Value { + json!({"hardness": hardness, "emission": 0, "requires_tool": false, "map_color_id": 13, + "sound": {"break": sound}, "outline": outline, "collision": outline}) + } + fn block(class: &[&str], props: Value, states: Value) -> Value { + let default = states + .as_object() + .unwrap() + .keys() + .next() + .unwrap() + .to_owned(); + json!({"class": class, "properties": props, "default": default, "item": "x", + "explosion_resistance": 3.0, "friction": 0.6, "speed_factor": 1.0, + "jump_factor": 1.0, "states": states}) + } + + #[test] + fn templates_follow_class_shapes_and_sounds() { + let cube = json!([[0, 0, 0, 1, 1, 1]]); + let low = json!([[0, 0, 0, 1, 0.9375, 1]]); + let block_class = ["net.minecraft.world.level.block.Block"]; + let path = ["net.minecraft.world.level.block.DirtPathBlock"]; + let facts: Facts = serde_json::from_value(json!({ + "blocks": { + "minecraft:stone": block(&block_class, json!({}), json!({"": state(1.5, "stone", cube.clone())})), + "minecraft:oak_planks": block(&block_class, json!({}), json!({"": state(2.0, "wood", cube.clone())})), + "minecraft:dirt_path": block(&path, json!({}), json!({"": state(0.65, "grass", low.clone())})), + "m:wood_tile": block(&["m.Tile", block_class[0]], json!({}), json!({"": state(2.5, "wood", cube.clone())})), + "m:path": block(&["m.Path", block_class[0]], json!({}), json!({"": state(1.0, "stone", low.clone())})), + "m:gadget": block(&["m.Gadget", block_class[0]], json!({"mode": ["a", "b"]}), + json!({"mode=a": state(1.0, "stone", cube.clone()), "mode=b": state(1.0, "stone", cube)})), + }, + "items": {} + })) + .unwrap(); + let any = |_: &str| true; + let tile = facts.template("m:wood_tile", &any).unwrap(); + assert_eq!(tile.template, "minecraft:oak_planks"); + assert_eq!(tile.properties["hardness"], json!(2.5)); + assert!(!tile.properties.contains_key("sounds")); + assert_eq!( + tile.differences, + ["class m.Tile (behaviour beyond net.minecraft.world.level.block.Block)"] + ); + // A plain Block is never templated on a DirtPathBlock: shapes differ, and say so. + let path = facts.template("m:path", &any).unwrap(); + assert_eq!(path.template, "minecraft:stone"); + assert!( + path.differences[0].starts_with("shapes differ"), + "{:?}", + path.differences + ); + assert_eq!(facts.template("m:gadget", &any), None); + let tile = facts + .template("m:wood_tile", &|n: &str| n != "minecraft:oak_planks") + .unwrap(); + assert_eq!(tile.template, "minecraft:stone"); + assert_eq!(tile.differences[0], "sounds: no vanilla block has them"); + } + + #[test] + fn state_keys_sort() { + assert_eq!( + state_key("half=lower,facing=north"), + "facing=north,half=lower" + ); + assert_eq!(state_key(""), ""); + } +} diff --git a/docs/modpacks.md b/docs/modpacks.md index 7951ad4d4..ed77ca411 100644 --- a/docs/modpacks.md +++ b/docs/modpacks.md @@ -268,6 +268,7 @@ inspected: cargo run -p horizon-port-pack -- import ~/Downloads/pack.mrpack ~/.horizon/ports/pack cargo run -p horizon-port-pack -- inventory ~/.horizon/ports/pack # --offline reuses modrinth.json cargo run -p horizon-port-pack -- carry ~/.horizon/ports/pack # content mods with a jar, or name them +# --resources : only templates Horizon's tables have ``` `inventory` reads metadata only: Modrinth answers by file hash, and the jars only if the user's @@ -277,14 +278,26 @@ classes come from the reviewed table, Modrinth categories and sides; with jars, only): content 54, library 33, client-ui 26, performance 25, other 14, unknown 2, server-only 1; 40 rows matched the reviewed ATM10 table; three dependency layers (93 / 57 / 5). -`carry` copies a jar's `assets//`, `data//` and `data/minecraft/tags/` into -`mods//carry/`, a folder content mod (API 0.2) the game loads with `--dev-mod`, and keeps -what a content mod may not hold (other namespaces such as `c` tags, vanilla data) in `outside/`. -No class file is copied. It upgrades vanilla-type recipes from 1.21.1 ingredients to 26.3's, -adds the `items/` definitions 1.21.4 introduced, and declares each block from a vanilla template -guessed from its blockstate properties (stone for none, a door for `facing, half, hinge, open, -powered`, ...); blocks with an unknown property set, custom recipe types and NeoForge -conditions are listed in `carry-report.json` for the oracle step. +`carry` copies a jar's `assets//`, `data//`, `data/minecraft/tags/` and `data/c/tags/` +into `mods//carry/`, a folder content mod (API 0.2) the game loads with `--dev-mod`, and +keeps what a content mod may not hold (other namespaces, vanilla data) in `outside/`. No class +file is copied. It upgrades from 1.21.1 to 26.3: vanilla-type recipes (ingredients), loot tables +(`conditions` lists become one `condition`, `functions` become `modifier`, kinds move to `type`, +tool matches on silk touch or shears become `minecraft:tool/can_silk_touch` and +`minecraft:tool/can_shear`), and the `items/` definitions 1.21.4 introduced. + +Blocks and items come from the NeoForge oracle when `/oracle/facts.json` exists (step 6): +every block the mod registers gets the vanilla template of the same vanilla class and states +whose shapes, sounds, set type and wood type match best, with the mod's own hardness, blast +resistance, light, tool need, friction, map colour and sounds as overrides. `--resources +` limits templates to blocks Horizon's tables have. `carry-report.json` lists, per +block, what the template does not reproduce (other shapes, sounds no vanilla block has, a class +of its own), and the blocks left out: those whose vanilla class has no vanilla block with the +same states (Macaw's garage doors, multi-part gates). Recipes get the convention tags they use +(`c:dyes/red`), filled from the oracle with vanilla's and the mod's own members. Without the +oracle, templates are guessed from the blockstate's properties: the template whose properties +include them with the fewest left over (models often ignore `powered` or `waterlogged`), the +block's name breaking ties (`_pane`, `_gate`, `_trapdoor`). ### 1. Import From 32f5f01e22fb4fcbb0017d4951560d27459f8525 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 16 Oct 2026 23:27:20 +0200 Subject: [PATCH 10/59] Per-mod parity harness against a dev-only NeoForge oracle The harness the modpack design calls for, for data-tier mods: - tools/neoforge_oracle.py installs a NeoForge 21.1.259 server (ATM10's) under .local/neoforge-oracle, builds the exporter in mods/horizon/src/neoforge-oracle (our code, never shipped), runs it headless with the user's jars and writes every block (class chain, states, per-state hardness, light, tool need, map colour, sounds, outline and collision; drops for hand, diamond tools, shears and silk touch; placement; BlockSetType and WoodType), item, recipe and tag of the mods' namespaces, plus the vanilla blocks for templates. About 30 s. - examples/mod_port_probe.rs builds the content root from the carried mods and dumps what Horizon's loaders make of the same things. - tools/mod_port_harness.py compares them per mod and writes /mods//harness/result.json. 1.21.1 sound events map to 26.3's through vanilla blocks both have, and vanilla items newer than 1.21.1 are not counted against a recipe. On ATM10's own jars (MIT): Macaw's Trapdoors passes everything; Doors, Fences, Paths, Glassential, Factory Blocks and Cloud Glass pass every drop, recipe, tag and placement and fail only on what API 0.2 cannot say (shapes and sound events of their own, blocks of classes no vanilla block shares). Jars, facts and results stay in the work folder. Co-Authored-By: Claude Opus 5.5 --- .../horizon-client/examples/mod_port_probe.rs | 271 +++++++++++ docs/modpacks.md | 47 +- .../horizonlab/neoforge/FactsExporter.java | 426 ++++++++++++++++++ .../resources/META-INF/neoforge.mods.toml | 11 + tools/mod_port_harness.py | 211 +++++++++ tools/neoforge_oracle.py | 164 +++++++ 6 files changed, 1128 insertions(+), 2 deletions(-) create mode 100644 crates/horizon-client/examples/mod_port_probe.rs create mode 100644 mods/horizon/src/neoforge-oracle/java/dev/horizonlab/neoforge/FactsExporter.java create mode 100644 mods/horizon/src/neoforge-oracle/resources/META-INF/neoforge.mods.toml create mode 100644 tools/mod_port_harness.py create mode 100644 tools/neoforge_oracle.py diff --git a/crates/horizon-client/examples/mod_port_probe.rs b/crates/horizon-client/examples/mod_port_probe.rs new file mode 100644 index 000000000..c78285bbb --- /dev/null +++ b/crates/horizon-client/examples/mod_port_probe.rs @@ -0,0 +1,271 @@ +//! The Horizon side of a mod port's harness (tools/mod_port_harness.py, +//! docs/modpacks.md): builds the content root for carried-over mods and +//! writes what Horizon makes of every block state, drop, recipe and tag the +//! NeoForge oracle exported. +//! +//! cargo run -p horizon-client --example mod_port_probe -- PREPARED WORK OUT.json [MOD...] +//! +//! WORK is a `horizon-port-pack` work folder: `oracle/facts.json` and +//! `mods//carry/`. The root is built in `WORK/horizon-root`. +use horizon_client::{ + Result, + assets::Assets, + blocks::BlockFacts, + crafting::{Recipe, Recipes}, + items::{ItemStack, Items}, + mod_content::{self, ContentMod}, + stations::StationRecipes, +}; +use horizon_core::{geometry::Axis, random::LegacyRandom}; +use horizon_world::chunk::BlockState; +use serde_json::{Map, Value, json}; +use std::{collections::BTreeMap, fs, path::Path}; + +fn boxes(list: impl IntoIterator) -> Value { + let mut v: Vec<[f64; 6]> = list.into_iter().collect(); + v.sort_by(|a, b| a.partial_cmp(b).unwrap_or(std::cmp::Ordering::Equal)); + json!(v) +} + +fn sound(s: &horizon_client::blocks::Sounds) -> Value { + json!({"volume": s.volume, "pitch": s.pitch, "break": &*s.break_sound, "step": &*s.step, + "place": &*s.place, "hit": &*s.hit, "fall": &*s.fall}) +} + +fn tool(name: &str) -> Option { + match name { + "hand" => None, + "silk_touch_pickaxe" => { + let mut pick = ItemStack::new("minecraft:diamond_pickaxe", 1); + pick.enchant("minecraft:silk_touch", 1); + Some(pick) + } + other => Some(ItemStack::new(&format!("minecraft:{other}"), 1)), + } +} + +fn main() -> Result<()> { + let args: Vec = std::env::args().skip(1).collect(); + let [base, work, out, wanted @ ..] = args.as_slice() else { + return Err("usage: mod_port_probe PREPARED WORK OUT.json [MOD...]".into()); + }; + let (base, work) = (Path::new(base), Path::new(work)); + let oracle: Value = serde_json::from_slice(&fs::read(work.join("oracle/facts.json"))?)?; + let mut mods = Vec::new(); + for entry in fs::read_dir(work.join("mods"))?.flatten() { + let id = entry.file_name().to_string_lossy().into_owned(); + let dir = entry.path().join("carry"); + if !(wanted.is_empty() || wanted.contains(&id)) || !dir.is_dir() { + continue; + } + let package = horizon_mods::Package::read(&dir)?; + let content = horizon_mods::Content::read(&dir, &package.manifest)?; + mods.push(ContentMod { + id: package.manifest.id.clone(), + content, + }); + } + mods.sort_by(|a, b| a.id.cmp(&b.id)); + let root = work.join("horizon-root"); + let began = std::time::Instant::now(); + let step = |what: &str| { + let what = what.to_owned(); + move |e: Box| format!("{what}: {e}") + }; + mod_content::build(base, &mods, &root).map_err(step("content root"))?; + let built = began.elapsed().as_secs_f64(); + let assets = Assets::load(&root).map_err(step("assets"))?; + let registry = assets.registry; + let facts = BlockFacts::load(&root, registry).map_err(step("block facts"))?; + let items = Items::load(&root, registry, &facts).map_err(step("items"))?; + let recipes = Recipes::load(&root, &items).map_err(step("recipes"))?; + let stations = StationRecipes::load(&root, &items); + let collisions = + horizon_client::collisions::load(&root, registry).map_err(step("collisions"))?; + let loaded = began.elapsed().as_secs_f64() - built; + let ours = |id: &str| { + id.split_once(':') + .is_some_and(|(ns, _)| mods.iter().any(|m| m.id == ns)) + }; + let tools: Vec = serde_json::from_value(oracle["tools"].clone())?; + + let mut blocks = Map::new(); + for (name, block) in oracle["blocks"].as_object().ok_or("oracle: no blocks")? { + if !ours(name) { + continue; + } + let Some(default) = registry.default_state(name) else { + blocks.insert(name.clone(), Value::Null); + continue; + }; + let mut states = Map::new(); + for (key, o) in block["states"].as_object().into_iter().flatten() { + let properties: BTreeMap = key + .split(',') + .filter(|p| !p.is_empty()) + .filter_map(|p| p.split_once('=')) + .map(|(k, v)| (k.to_owned(), v.to_owned())) + .collect(); + let descriptor = BlockState { + name: name.clone(), + properties, + }; + let Some(id) = registry.id(&descriptor) else { + states.insert(key.clone(), Value::Null); + continue; + }; + let f = facts.get(id); + let collision = collisions + .cached_shapes() + .cached_shape(id) + .ok() + .flatten() + .map(|s| { + boxes(s.boxes().iter().map(|b| { + [ + b.min(Axis::X), + b.min(Axis::Y), + b.min(Axis::Z), + b.max(Axis::X), + b.max(Axis::Y), + b.max(Axis::Z), + ] + })) + }); + let mut row = json!({ + "hardness": f.hardness, + "explosion_resistance": f.explosion_resistance, + "emission": f.emission, + "requires_tool": f.requires_tool, + "friction": f.friction, + "map_color_id": f.map_color, + "can_occlude": f.can_occlude, + "sound": sound(&f.sounds), + "outline": boxes(f.outline.iter().copied()), + "collision": collision, + "classes": f.classes.iter().map(|c| &**c).collect::>(), + }); + if o.get("drops").is_some() { + let mut drops = Map::new(); + for t in &tools { + let mut random = LegacyRandom::new(0); + let held = tool(t); + let mut counts: BTreeMap = BTreeMap::new(); + for s in items.block_drops(registry, id, held.as_ref(), &mut random) { + *counts.entry(s.item.to_string()).or_default() += s.count; + } + drops.insert(t.clone(), json!(counts)); + } + row["drops"] = Value::Object(drops); + } + states.insert(key.clone(), row); + } + let item = facts.get(default).item.to_string(); + blocks.insert( + name.clone(), + json!({"states": states, "item": item, "item_known": items.items.contains_key(&*item)}), + ); + } + + // Vanilla's sounds, by block: the harness maps the oracle's version's + // sound events to this one's through them. + let mut vanilla_sounds = Map::new(); + for name in oracle["blocks"] + .as_object() + .into_iter() + .flatten() + .map(|(k, _)| k) + { + if let Some(id) = name + .starts_with("minecraft:") + .then(|| registry.default_state(name)) + .flatten() + { + vanilla_sounds.insert(name.clone(), sound(&facts.get(id).sounds)); + } + } + + let mut item_rows = Map::new(); + for name in oracle["items"] + .as_object() + .into_iter() + .flatten() + .map(|(k, _)| k) + { + item_rows.insert( + name.clone(), + match items.items.get(name.as_str()) { + Some(i) => json!({"max_stack_size": i.max_stack, "block": i.block.map(|b| b.0)}), + None => Value::Null, + }, + ); + } + + let sorted = |list: &[String]| { + let mut v = list.to_vec(); + v.sort(); + v.dedup(); + v + }; + let mut recipe_rows = Map::new(); + for (name, recipe) in &recipes.crafting { + if !ours(name) { + continue; + } + let row = match recipe { + Recipe::Shaped { cells, result, .. } => json!({ + "result": result.item.as_deref(), "count": result.count, + "ingredients": cells.iter().flatten().map(|i| sorted(&i.1)).collect::>()}), + Recipe::Shapeless { + ingredients, + result, + } => json!({ + "result": result.item.as_deref(), "count": result.count, + "ingredients": ingredients.iter().map(|i| sorted(&i.1)).collect::>()}), + Recipe::Special(_) => json!({"special": true}), + }; + recipe_rows.insert(name.clone(), row); + } + for c in recipes.cooking.iter().filter(|c| ours(&c.id)) { + recipe_rows.insert( + c.id.clone(), + json!({"result": &*c.result.item, "count": c.result.count, + "ingredients": [sorted(&c.ingredient.1)]}), + ); + } + for s in stations.stonecutting.iter().filter(|s| ours(&s.id)) { + recipe_rows.insert( + s.id.clone(), + json!({"result": &*s.result.item, "count": s.result.count, + "ingredients": [sorted(&s.input.1)]}), + ); + } + + let mut block_tags = Map::new(); + for (tag, members) in &items.block_tags { + let mut ids: Vec<&String> = members.iter().filter(|m| ours(m)).collect(); + if !ids.is_empty() { + ids.sort(); + block_tags.insert(tag.clone(), json!(ids)); + } + } + + let report = json!({ + "states": registry.len(), + "build_seconds": built, + "load_seconds": loaded, + "blocks": blocks, + "items": item_rows, + "recipes": recipe_rows, + "block_tags": block_tags, + "vanilla_sounds": vanilla_sounds, + }); + fs::write(out, serde_json::to_vec(&report)?)?; + println!( + "{out}: {} blocks, {} items, {} recipes; root built in {built:.2} s, loaded in {loaded:.2} s", + blocks.len(), + item_rows.len(), + recipe_rows.len() + ); + Ok(()) +} diff --git a/docs/modpacks.md b/docs/modpacks.md index ed77ca411..9cdd14774 100644 --- a/docs/modpacks.md +++ b/docs/modpacks.md @@ -399,8 +399,51 @@ A **harness per mod**, generated from the tier: | deep | entity scenarios (spawn, tick N, positions and states, drops), and render captures where the look is the point, compared as images with a tolerance | The comparison skips vanilla 1.21.1-versus-26.3 differences: it normalises ids and components -through the step-4 upgrader and compares only the mod's own ids and effects. The harness format -is `tools/parity.py`'s, so the same runner, local or CI, runs vanilla and mod harnesses. +through the step-4 upgrader and compares only the mod's own ids and effects. + +**Status: the data-tier harness runs.** + +``` +python3 tools/neoforge_oracle.py export --jars --deps --out /oracle/facts.json +cargo run -p horizon-port-pack -- carry --resources .local/horizon-client/26.3 +python3 tools/mod_port_harness.py --work # or --jars/--deps to export first +``` + +- `tools/neoforge_oracle.py` installs a NeoForge server (21.1.259, ATM10's) under + `.local/neoforge-oracle/`, builds the exporter mod in `mods/horizon/src/neoforge-oracle/` (our code, dev + only), starts the server headless with the jars and writes, for every block of the mods' + namespaces and every vanilla block: the class chain, states, per-state hardness, light, tool + need, map colour, sounds, outline and collision shapes; drops for hand, diamond tools, shears + and silk touch; placement on a floor and a wall; BlockSetType and WoodType. Then items (class, + stack size, rarity, food), recipes (type, result, count, resolved ingredients) and tags. One run + with the seven mods below takes about 30 s. +- `crates/horizon-client/examples/mod_port_probe.rs` builds the content root from the carried + mods and dumps what Horizon's loaders make of the same blocks, drops, recipes and tags. +- `tools/mod_port_harness.py` compares them per mod (blocks, properties, sounds, shapes, drops, + placement against the template's in the oracle, vanilla tags, recipes, items) and writes + `/mods//harness/result.json`. It maps 1.21.1 sound events to 26.3's through the + vanilla blocks both versions have (`block.metal.*` became `block.iron.*`) and ignores vanilla + items 1.21.1 did not have (pale oak in `#minecraft:logs`). + +The oracle needs the mods' jars, so it is not a `tools/parity.py` harness: it runs where the +user's jars are, and its facts and results stay in the work folder. The first real mods +(ATM10's own jars from Modrinth, all MIT; checks passed / compared): + +| mod | blocks | properties | sounds | shapes | drops | placement | tags | recipes | items | +|---|---:|---:|---:|---:|---:|---:|---:|---:|---:| +| Macaw's Trapdoors 1.1.5 | 179/179 | 11456/11456 | 11456/11456 | 11456/11456 | 10024/10024 | 358/358 | 534/534 | 191/191 | 191/191 | +| Macaw's Doors 1.1.5 | 239/245 | 15296/15296 | 15296/15296 | 12352/15296 | 13384/13384 | 478/478 | 941/941 | 257/257 | 251/257 | +| Macaw's Fences and Walls 1.2.1 | 150/180 | 4800/4800 | 4800/4800 | 4032/4800 | 33600/33600 | 300/300 | 432/432 | 222/222 | 150/180 | +| Macaw's Paths and Pavings 1.1.1 | 234/315 | 4602/4602 | 4602/4602 | 4472/4602 | 6734/6734 | 468/468 | 416/416 | 315/315 | 234/315 | +| Glassential-renewed 3.4.7 | 105/114 | 5177/5177 | 5177/5177 | 4727/5177 | 6447/6447 | 210/210 | 105/105 | 143/143 | 106/115 | +| Factory Blocks 1.4.0 | 42/49 | 42/42 | 0/42 | 42/42 | 294/294 | 84/84 | 42/42 | 1/1 | 42/49 | +| Cloud Glass 1.1.0 | 16/16 | 16/16 | 16/16 | 0/16 | 112/112 | 32/32 | – | 31/31 | 16/16 | + +What fails is what API 0.2 cannot express yet: shapes of their own (Japanese doors, hedges, +paths a sixteenth high, glass without collision), sound events of the mod's own +(`factory_blocks:metal_sound`), and blocks whose vanilla class has no vanilla block with the +same states (garage doors, double gates, engraved and facing paths, fans). Every drop, recipe +and tag of the declared blocks matches. ### 7. Coverage report diff --git a/mods/horizon/src/neoforge-oracle/java/dev/horizonlab/neoforge/FactsExporter.java b/mods/horizon/src/neoforge-oracle/java/dev/horizonlab/neoforge/FactsExporter.java new file mode 100644 index 000000000..c452e6488 --- /dev/null +++ b/mods/horizon/src/neoforge-oracle/java/dev/horizonlab/neoforge/FactsExporter.java @@ -0,0 +1,426 @@ +package dev.horizonlab.neoforge; + +import com.google.gson.stream.JsonWriter; +import java.io.IOException; +import java.io.Writer; +import java.nio.charset.StandardCharsets; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.ArrayList; +import java.util.Arrays; +import java.util.LinkedHashSet; +import java.util.List; +import java.util.Map; +import java.util.Set; +import java.util.TreeMap; +import java.util.TreeSet; +import net.minecraft.core.BlockPos; +import net.minecraft.core.Direction; +import net.minecraft.core.registries.BuiltInRegistries; +import net.minecraft.core.registries.Registries; +import net.minecraft.resources.ResourceLocation; +import net.minecraft.server.MinecraftServer; +import net.minecraft.server.level.ServerLevel; +import net.minecraft.sounds.SoundEvent; +import net.minecraft.world.InteractionHand; +import net.minecraft.world.item.BlockItem; +import net.minecraft.world.item.Item; +import net.minecraft.world.item.ItemStack; +import net.minecraft.world.item.Items; +import net.minecraft.world.item.context.BlockPlaceContext; +import net.minecraft.world.item.crafting.Ingredient; +import net.minecraft.world.item.crafting.RecipeHolder; +import net.minecraft.world.item.enchantment.Enchantments; +import net.minecraft.world.level.EmptyBlockGetter; +import net.minecraft.world.level.block.Block; +import net.minecraft.world.level.block.Blocks; +import net.minecraft.world.level.block.SoundType; +import net.minecraft.world.level.block.state.BlockState; +import net.minecraft.world.level.block.state.properties.Property; +import net.minecraft.world.level.storage.loot.LootParams; +import net.minecraft.world.level.storage.loot.parameters.LootContextParams; +import net.minecraft.world.phys.AABB; +import net.minecraft.world.phys.BlockHitResult; +import net.minecraft.world.phys.Vec3; +import net.minecraft.world.phys.shapes.VoxelShape; +import net.neoforged.bus.api.IEventBus; +import net.neoforged.fml.common.Mod; +import net.neoforged.neoforge.common.NeoForge; +import net.neoforged.neoforge.event.server.ServerStartedEvent; + +/** + * Dev-only oracle for Horizon's mod ports (docs/modpacks.md): once the server has started, + * writes every block, item, recipe and tag of the namespaces named in {@code + * horizon.oracle.namespaces} (plus the vanilla blocks, so templates can be compared) to {@code + * horizon.oracle.out}, then stops the server. Never shipped to players. + */ +@Mod("horizon_oracle") +public final class FactsExporter { + private static final BlockPos FLOOR = new BlockPos(0, 99, 0); + + public FactsExporter(IEventBus modBus) { + NeoForge.EVENT_BUS.addListener(this::started); + } + + private void started(ServerStartedEvent event) { + MinecraftServer server = event.getServer(); + Path out = Path.of(System.getProperty("horizon.oracle.out", "horizon-oracle.json")); + Set namespaces = + new TreeSet<>(Arrays.asList(System.getProperty("horizon.oracle.namespaces", "").split(","))); + namespaces.remove(""); + try (Writer w = Files.newBufferedWriter(out, StandardCharsets.UTF_8); + JsonWriter json = new JsonWriter(w)) { + new Export(server, namespaces, json).run(); + } catch (Throwable e) { + e.printStackTrace(); + System.exit(3); + } + System.out.println("horizon-oracle: wrote " + out); + server.halt(false); + } + + private static final class Export { + final MinecraftServer server; + final ServerLevel level; + final Set namespaces; + final JsonWriter json; + final List tools = new ArrayList<>(); + final List toolNames = new ArrayList<>(); + + Export(MinecraftServer server, Set namespaces, JsonWriter json) { + this.server = server; + this.level = server.overworld(); + this.namespaces = namespaces; + this.json = json; + tool("hand", ItemStack.EMPTY); + tool("diamond_pickaxe", new ItemStack(Items.DIAMOND_PICKAXE)); + tool("diamond_axe", new ItemStack(Items.DIAMOND_AXE)); + tool("diamond_shovel", new ItemStack(Items.DIAMOND_SHOVEL)); + tool("diamond_hoe", new ItemStack(Items.DIAMOND_HOE)); + tool("shears", new ItemStack(Items.SHEARS)); + ItemStack silk = new ItemStack(Items.DIAMOND_PICKAXE); + silk.enchant( + server.registryAccess() + .registryOrThrow(Registries.ENCHANTMENT) + .getHolderOrThrow(Enchantments.SILK_TOUCH), + 1); + tool("silk_touch_pickaxe", silk); + } + + void tool(String name, ItemStack stack) { + toolNames.add(name); + tools.add(stack); + } + + boolean ours(ResourceLocation id) { + return namespaces.contains(id.getNamespace()); + } + + void run() throws IOException { + json.beginObject(); + json.name("schema").value(1); + json.name("minecraft").value(net.minecraft.SharedConstants.getCurrentVersion().getName()); + json.name("namespaces"); + json.beginArray(); + for (String n : namespaces) json.value(n); + json.endArray(); + json.name("tools"); + json.beginArray(); + for (String n : toolNames) json.value(n); + json.endArray(); + blocks(); + // Vanilla's items, so harnesses can tell later versions' additions apart. + json.name("vanilla_items"); + json.beginArray(); + for (Item item : BuiltInRegistries.ITEM) { + ResourceLocation id = BuiltInRegistries.ITEM.getKey(item); + if (id.getNamespace().equals("minecraft")) json.value(id.toString()); + } + json.endArray(); + items(); + recipes(); + tags(); + json.endObject(); + } + + void blocks() throws IOException { + level.setBlock(FLOOR, Blocks.STONE.defaultBlockState(), 3); + json.name("blocks"); + json.beginObject(); + for (Block block : BuiltInRegistries.BLOCK) { + ResourceLocation id = BuiltInRegistries.BLOCK.getKey(block); + boolean mod = ours(id); + if (!mod && !id.getNamespace().equals("minecraft")) continue; + json.name(id.toString()); + json.beginObject(); + json.name("class"); + json.beginArray(); + for (Class c = block.getClass(); c != null && c != Object.class; c = c.getSuperclass()) { + json.value(c.getName()); + } + json.endArray(); + BlockState def = block.defaultBlockState(); + json.name("properties"); + json.beginObject(); + for (Property p : block.getStateDefinition().getProperties()) { + json.name(p.getName()); + json.beginArray(); + for (Object v : p.getPossibleValues()) json.value(name(p, v)); + json.endArray(); + } + json.endObject(); + json.name("default").value(stateKey(def)); + json.name("item").value(BuiltInRegistries.ITEM.getKey(block.asItem()).toString()); + json.name("explosion_resistance").value(block.getExplosionResistance()); + json.name("friction").value(block.getFriction()); + json.name("speed_factor").value(block.getSpeedFactor()); + json.name("jump_factor").value(block.getJumpFactor()); + blockSetType(block); + json.name("states"); + json.beginObject(); + for (BlockState state : block.getStateDefinition().getPossibleStates()) { + json.name(stateKey(state)); + json.beginObject(); + json.name("hardness").value(state.getDestroySpeed(EmptyBlockGetter.INSTANCE, BlockPos.ZERO)); + json.name("emission").value(state.getLightEmission()); + json.name("requires_tool").value(state.requiresCorrectToolForDrops()); + json.name("can_occlude").value(state.canOcclude()); + json.name("replaceable").value(state.canBeReplaced()); + json.name("random_ticks").value(state.isRandomlyTicking()); + var color = state.getMapColor(EmptyBlockGetter.INSTANCE, BlockPos.ZERO); + json.name("map_color").value(color.col); + json.name("map_color_id").value(color.id); + sound(state.getSoundType(level, FLOOR.above(), null)); + json.name("outline"); + boxes(state.getShape(EmptyBlockGetter.INSTANCE, BlockPos.ZERO)); + json.name("collision"); + boxes(state.getCollisionShape(EmptyBlockGetter.INSTANCE, BlockPos.ZERO)); + if (mod && lootSample(block, state)) drops(state); + json.endObject(); + } + json.endObject(); + if (block.asItem() instanceof BlockItem bi) placement(bi); + json.endObject(); + } + json.endObject(); + } + + /** Every state of a small block; else the default and each one-property change from it. */ + boolean lootSample(Block block, BlockState state) { + if (block.getStateDefinition().getPossibleStates().size() <= 32) return true; + BlockState def = block.defaultBlockState(); + int differ = 0; + for (Property p : block.getStateDefinition().getProperties()) { + if (!state.getValue(p).equals(def.getValue(p))) differ++; + } + return differ <= 1; + } + + void drops(BlockState state) throws IOException { + json.name("drops"); + json.beginObject(); + for (int i = 0; i < tools.size(); i++) { + LootParams.Builder params = + new LootParams.Builder(level) + .withParameter(LootContextParams.ORIGIN, Vec3.atCenterOf(FLOOR.above())) + .withParameter(LootContextParams.TOOL, tools.get(i).copy()); + Map counts = new TreeMap<>(); + for (ItemStack s : state.getDrops(params)) { + counts.merge(BuiltInRegistries.ITEM.getKey(s.getItem()).toString(), s.getCount(), Integer::sum); + } + json.name(toolNames.get(i)); + json.beginObject(); + for (Map.Entry e : counts.entrySet()) json.name(e.getKey()).value(e.getValue()); + json.endObject(); + } + json.endObject(); + } + + void placement(BlockItem item) throws IOException { + BlockPos at = FLOOR.above(); + level.setBlock(at, Blocks.AIR.defaultBlockState(), 3); + json.name("placement"); + json.beginObject(); + for (Direction face : new Direction[] {Direction.UP, Direction.NORTH}) { + BlockPos clicked = face == Direction.UP ? FLOOR : at.relative(face.getOpposite()); + level.setBlock(clicked, Blocks.STONE.defaultBlockState(), 3); + Vec3 hit = Vec3.atCenterOf(clicked).add(Vec3.atLowerCornerOf(face.getNormal()).scale(0.5)); + // A player-less context (the constructor is protected, hence the subclass). + BlockPlaceContext ctx = + new BlockPlaceContext( + level, null, InteractionHand.MAIN_HAND, new ItemStack(item), + new BlockHitResult(hit, face, clicked, false)) {}; + BlockState placed = null; + try { + placed = item.getBlock().getStateForPlacement(ctx); + } catch (RuntimeException e) { + // Needs a player: recorded as no placement. + } + json.name(face.getName()).value(placed == null ? null : stateKey(placed)); + if (face != Direction.UP) level.setBlock(clicked, Blocks.AIR.defaultBlockState(), 3); + } + json.endObject(); + } + + /** The BlockSetType (doors, trapdoors, buttons, plates) and WoodType (fence gates) a block keeps. */ + void blockSetType(Block block) throws IOException { + String setType = null, woodType = null; + Boolean byHand = null; + for (Class c = block.getClass(); c != null && c != Object.class; c = c.getSuperclass()) { + for (var f : c.getDeclaredFields()) { + try { + if (f.getType() == net.minecraft.world.level.block.state.properties.BlockSetType.class && setType == null) { + f.setAccessible(true); + var t = (net.minecraft.world.level.block.state.properties.BlockSetType) f.get(block); + if (t != null) { + setType = t.name(); + byHand = t.canOpenByHand(); + } + } else if (f.getType() == net.minecraft.world.level.block.state.properties.WoodType.class && woodType == null) { + f.setAccessible(true); + var t = (net.minecraft.world.level.block.state.properties.WoodType) f.get(block); + if (t != null) woodType = t.name(); + } + } catch (ReflectiveOperationException | RuntimeException e) { + // Not readable: left out. + } + } + } + if (setType != null) { + json.name("block_set_type"); + json.beginObject(); + json.name("name").value(setType); + json.name("can_open_by_hand").value(byHand); + json.endObject(); + } + if (woodType != null) json.name("wood_type").value(woodType); + } + + void sound(SoundType s) throws IOException { + json.name("sound"); + json.beginObject(); + json.name("volume").value(s.getVolume()); + json.name("pitch").value(s.getPitch()); + event("break", s.getBreakSound()); + event("step", s.getStepSound()); + event("place", s.getPlaceSound()); + event("hit", s.getHitSound()); + event("fall", s.getFallSound()); + json.endObject(); + } + + void event(String name, SoundEvent e) throws IOException { + json.name(name).value(e.getLocation().toString()); + } + + void boxes(VoxelShape shape) throws IOException { + json.beginArray(); + for (AABB b : shape.toAabbs()) { + json.beginArray(); + json.value(b.minX).value(b.minY).value(b.minZ).value(b.maxX).value(b.maxY).value(b.maxZ); + json.endArray(); + } + json.endArray(); + } + + void items() throws IOException { + json.name("items"); + json.beginObject(); + for (Item item : BuiltInRegistries.ITEM) { + ResourceLocation id = BuiltInRegistries.ITEM.getKey(item); + if (!ours(id)) continue; + ItemStack stack = new ItemStack(item); + json.name(id.toString()); + json.beginObject(); + json.name("class").value(item.getClass().getName()); + json.name("max_stack_size").value(stack.getMaxStackSize()); + json.name("rarity").value(stack.getRarity().getSerializedName()); + if (item instanceof BlockItem bi) { + json.name("block").value(BuiltInRegistries.BLOCK.getKey(bi.getBlock()).toString()); + } + var food = stack.get(net.minecraft.core.component.DataComponents.FOOD); + if (food != null) { + json.name("food"); + json.beginObject(); + json.name("nutrition").value(food.nutrition()); + json.name("saturation").value(food.saturation()); + json.endObject(); + } + json.endObject(); + } + json.endObject(); + } + + void recipes() throws IOException { + json.name("recipes"); + json.beginObject(); + for (RecipeHolder holder : server.getRecipeManager().getRecipes()) { + if (!ours(holder.id())) continue; + var recipe = holder.value(); + json.name(holder.id().toString()); + json.beginObject(); + json.name("type").value(BuiltInRegistries.RECIPE_TYPE.getKey(recipe.getType()).toString()); + json.name("serializer").value(BuiltInRegistries.RECIPE_SERIALIZER.getKey(recipe.getSerializer()).toString()); + ItemStack result = recipe.getResultItem(server.registryAccess()); + json.name("result").value(BuiltInRegistries.ITEM.getKey(result.getItem()).toString()); + json.name("count").value(result.getCount()); + json.name("ingredients"); + json.beginArray(); + for (Ingredient ing : recipe.getIngredients()) { + Set ids = new TreeSet<>(); + for (ItemStack s : ing.getItems()) ids.add(BuiltInRegistries.ITEM.getKey(s.getItem()).toString()); + json.beginArray(); + for (String i : ids) json.value(i); + json.endArray(); + } + json.endArray(); + json.endObject(); + } + json.endObject(); + } + + /** Tags that hold one of our ids, with only those members; and every `c` tag, whole. */ + void tags() throws IOException { + json.name("tags"); + json.beginObject(); + for (String kind : new String[] {"block", "item"}) { + json.name(kind); + json.beginObject(); + Map> out = new TreeMap<>(); + var registry = kind.equals("block") ? BuiltInRegistries.BLOCK : BuiltInRegistries.ITEM; + registry.getTags().forEach(pair -> { + String tag = pair.getFirst().location().toString(); + boolean convention = pair.getFirst().location().getNamespace().equals("c"); + Set members = new LinkedHashSet<>(); + for (var holder : pair.getSecond()) { + ResourceLocation id = holder.unwrapKey().orElseThrow().location(); + if (convention || ours(id) || ours(pair.getFirst().location())) members.add(id.toString()); + } + if (!members.isEmpty()) out.put(tag, new TreeSet<>(members)); + }); + for (var e : out.entrySet()) { + json.name(e.getKey()); + json.beginArray(); + for (String m : e.getValue()) json.value(m); + json.endArray(); + } + json.endObject(); + } + json.endObject(); + } + + static String stateKey(BlockState state) { + StringBuilder b = new StringBuilder(); + for (Property p : state.getProperties()) { + if (b.length() > 0) b.append(','); + b.append(p.getName()).append('=').append(name(p, state.getValue(p))); + } + return b.toString(); + } + + @SuppressWarnings({"unchecked", "rawtypes"}) + static String name(Property p, Object v) { + return p.getName((Comparable) v); + } + } +} diff --git a/mods/horizon/src/neoforge-oracle/resources/META-INF/neoforge.mods.toml b/mods/horizon/src/neoforge-oracle/resources/META-INF/neoforge.mods.toml new file mode 100644 index 000000000..006875e95 --- /dev/null +++ b/mods/horizon/src/neoforge-oracle/resources/META-INF/neoforge.mods.toml @@ -0,0 +1,11 @@ +# Dev-only: the NeoForge oracle for Horizon's mod-port harnesses (docs/modpacks.md). +# Built and run by tools/neoforge_oracle.py; never shipped. +modLoader = "javafml" +loaderVersion = "[4,)" +license = "Apache-2.0" + +[[mods]] +modId = "horizon_oracle" +version = "1" +displayName = "Horizon oracle (dev only)" +description = "Exports block, item, recipe and tag facts for Horizon's parity harnesses." diff --git a/tools/mod_port_harness.py b/tools/mod_port_harness.py new file mode 100644 index 000000000..23f7e82b9 --- /dev/null +++ b/tools/mod_port_harness.py @@ -0,0 +1,211 @@ +#!/usr/bin/env python3 +"""Per-mod parity harness for ported mods (docs/modpacks.md, "The Java oracle and per-mod harnesses"). + + mod_port_harness.py --work WORK [--resources PREPARED] [--jars DIR --deps DIR] [MOD ...] + +WORK is a `horizon-port-pack` work folder whose mods were carried over. With --jars the NeoForge +oracle (tools/neoforge_oracle.py, dev-only) first exports WORK/oracle/facts.json. The Horizon side +is crates/horizon-client/examples/mod_port_probe.rs: the content root built from WORK/mods/*/carry +and what the game's loaders make of it. For every block and item the mod registers, compared: + +- blocks: declared in Horizon at all; per state hardness, explosion resistance, light, tool need, + friction, map colour, sounds, outline and collision shapes; +- drops: the loot of each sampled state for hand, diamond tools, shears and silk touch; +- placement: the state the block takes when placed, against its template's in the same oracle + (Horizon places the template as vanilla does, which the vanilla harnesses check); +- tags: the vanilla block tags (tool and mining tags) holding the mod's blocks; +- recipes: each recipe's result, count and ingredients; +- items: present, and their stack size. + +Writes WORK/mods//harness/result.json per mod and prints a table. Jars, facts and results stay +in WORK, outside the repository. +""" +import argparse +import json +import math +import subprocess +import sys +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[1] +CHECKS = ['blocks', 'properties', 'sounds', 'shapes', 'drops', 'placement', 'tags', 'recipes', 'items'] +EXAMPLES = 8 + + +def key(k): + return ','.join(sorted(p for p in k.split(',') if p)) + + +def cells(boxes, grid=32): + out = set() + for b in boxes: + lo = [math.floor(round(v * grid, 6)) for v in b[:3]] + hi = [math.ceil(round(v * grid, 6)) for v in b[3:]] + for x in range(lo[0], hi[0]): + for y in range(lo[1], hi[1]): + for z in range(lo[2], hi[2]): + out.add((x, y, z)) + return out + + +def same_shape(a, b): + if a is None or b is None: + return a == b + sa, sb = sorted(map(tuple, a)), sorted(map(tuple, b)) + if sa == sb: + return True + return cells(a) == cells(b) + + +class Check: + def __init__(self): + self.passed = 0 + self.failed = 0 + self.examples = [] + + def record(self, ok, what): + if ok: + self.passed += 1 + else: + self.failed += 1 + if len(self.examples) < EXAMPLES: + self.examples.append(what) + + def json(self): + return {'passed': self.passed, 'failed': self.failed, 'examples': self.examples} + + +def sound_upgrades(oracle, horizon): + """The oracle version's vanilla sound sets → this version's, through the vanilla blocks both have.""" + out = {} + for name, hs in horizon.get('vanilla_sounds', {}).items(): + ob = oracle['blocks'].get(name) + if ob: + os_ = ob['states'].get(ob['default']) or next(iter(ob['states'].values())) + out.setdefault(json.dumps(os_['sound'], sort_keys=True), []).append(hs) + return out + + +def compare_mod(mod, oracle, horizon, carry, upgrades, old_items): + checks = {c: Check() for c in CHECKS} + prefix = mod + ':' + templates = {prefix + b: t for b, t in carry.get('blocks', {}).items()} + vanilla_tags = {t: set(m) for t, m in oracle['tags']['block'].items() if t.startswith('minecraft:')} + for name, ob in oracle['blocks'].items(): + if not name.startswith(prefix): + continue + hb = horizon['blocks'].get(name) + checks['blocks'].record(hb is not None, f'{name}: not in Horizon ({carry.get("blocks_unknown", {}).get(name[len(prefix):], "left out")})') + if hb is None: + continue + for k, os_ in ob['states'].items(): + hs = hb['states'].get(k) + if hs is None: + checks['properties'].record(False, f'{name}[{k}]: no such state in Horizon') + continue + props = [('hardness', os_['hardness'], hs['hardness']), + ('explosion_resistance', ob['explosion_resistance'], hs['explosion_resistance']), + ('emission', os_['emission'], hs['emission']), + ('requires_tool', os_['requires_tool'], hs['requires_tool']), + ('friction', ob['friction'], hs['friction']), + ('map_color', os_['map_color_id'], hs['map_color_id'])] + bad = [f'{p} {o} vs {h}' for p, o, h in props + if (abs(o - h) > 1e-6 if isinstance(o, float) else o != h)] + checks['properties'].record(not bad, f'{name}[{k}]: ' + '; '.join(bad)) + upgraded = upgrades.get(json.dumps(os_['sound'], sort_keys=True), []) + checks['sounds'].record(os_['sound'] == hs['sound'] or hs['sound'] in upgraded, + f'{name}[{k}]: {os_["sound"]["break"]} vs {hs["sound"]["break"]}') + shapes_ok = same_shape(os_['outline'], hs['outline']) and same_shape(os_['collision'], hs['collision']) + checks['shapes'].record(shapes_ok, f'{name}[{k}]: outline {os_["outline"]} vs {hs["outline"]}') + for tool, odrops in os_.get('drops', {}).items(): + hdrops = (hs.get('drops') or {}).get(tool) + checks['drops'].record(odrops == hdrops, f'{name}[{k}] {tool}: {odrops} vs {hdrops}') + # Placement: the mod block against its template, both in the oracle. + template = templates.get(name) + ot = oracle['blocks'].get(template) if template else None + if ot and 'placement' in ob: + for face, placed in ob['placement'].items(): + theirs = ot.get('placement', {}).get(face) + checks['placement'].record( + placed is not None and theirs is not None and key(placed) == key(theirs), + f'{name} on {face}: {placed} vs {template} {theirs}') + for tag, members in vanilla_tags.items(): + if name in members: + checks['tags'].record(name in horizon['block_tags'].get(tag, []), f'{name}: not in #{tag}') + for rid, orec in oracle['recipes'].items(): + if not rid.startswith(prefix): + continue + hrec = horizon['recipes'].get(rid) + if hrec is None: + checks['recipes'].record(False, f'{rid} ({orec["type"]}): not loaded') + continue + # Vanilla items added after the oracle's version (pale oak in a log tag) are not the mod's. + newer = lambda i: i.startswith('minecraft:') and old_items and i not in old_items + oing = sorted(sorted(i) for i in orec['ingredients'] if i) + hing = sorted(sorted(x for x in i if not newer(x)) for i in hrec.get('ingredients', []) if i) + ok = (orec['result'], orec['count']) == (hrec.get('result'), hrec.get('count')) and oing == hing + why = f'{rid}: {orec["result"]} x{orec["count"]} vs {hrec.get("result")} x{hrec.get("count")}' + if oing != hing: + missing = [i for i in oing if i not in hing][:2] + why += f'; ingredients differ, e.g. oracle {missing}' + checks['recipes'].record(ok, why) + for iid, oi in oracle['items'].items(): + if not iid.startswith(prefix): + continue + hi = horizon['items'].get(iid) + checks['items'].record(hi is not None and hi['max_stack_size'] == oi['max_stack_size'], + f'{iid}: {"missing" if hi is None else "stack " + str(hi["max_stack_size"])}') + result = {c: v.json() for c, v in checks.items()} + failed = sum(v.failed for v in checks.values()) + total = sum(v.passed + v.failed for v in checks.values()) + return {'mod': mod, 'passed': failed == 0 and total > 0, 'checks': result, + 'blocks_with_differences': len(carry.get('differences', {}))} + + +def main(): + parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) + parser.add_argument('--work', required=True) + parser.add_argument('--resources', default=str(ROOT / '.local/horizon-client/26.3')) + parser.add_argument('--jars', help='export the oracle facts from these jars first') + parser.add_argument('--deps') + parser.add_argument('mods', nargs='*') + args = parser.parse_args() + work = Path(args.work).resolve() + facts = work / 'oracle' / 'facts.json' + if args.jars: + facts.parent.mkdir(parents=True, exist_ok=True) + command = [sys.executable, str(ROOT / 'tools/neoforge_oracle.py'), 'export', '--jars', args.jars, '--out', str(facts)] + if args.deps: + command += ['--deps', args.deps] + subprocess.run(command, check=True) + if not facts.exists(): + sys.exit(f'{facts}: no oracle facts (run with --jars, or tools/neoforge_oracle.py export)') + subprocess.run(['cargo', 'build', '--release', '-q', '-p', 'horizon-client', '--example', 'mod_port_probe'], + cwd=ROOT, check=True) + metadata = json.loads(subprocess.check_output(['cargo', 'metadata', '--no-deps', '--format-version', '1'], + cwd=ROOT, text=True)) + probe = Path(metadata['target_directory']) / 'release/examples/mod_port_probe' + out = work / 'horizon.json' + subprocess.run([str(probe), args.resources, str(work), str(out), *args.mods], check=True) + oracle = json.loads(facts.read_text()) + horizon = json.loads(out.read_text()) + upgrades = sound_upgrades(oracle, horizon) + old_items = set(oracle.get('vanilla_items', [])) + mods = args.mods or sorted(p.name for p in (work / 'mods').iterdir() if (p / 'carry').is_dir()) + print(f'{"mod":<16} {"result":<7} ' + ' '.join(f'{c:>12}' for c in CHECKS)) + for mod in mods: + carry_report = work / 'mods' / mod / 'carry-report.json' + carry = json.loads(carry_report.read_text()) if carry_report.exists() else {} + result = compare_mod(mod, oracle, horizon, carry, upgrades, old_items) + (work / 'mods' / mod / 'harness').mkdir(parents=True, exist_ok=True) + (work / 'mods' / mod / 'harness' / 'result.json').write_text(json.dumps(result, indent=1)) + cols = [] + for c in CHECKS: + r = result['checks'][c] + n = r['passed'] + r['failed'] + cols.append(f'{r["passed"]}/{n}' if n else '-') + print(f'{mod:<16} {"pass" if result["passed"] else "FAIL":<7} ' + ' '.join(f'{c:>12}' for c in cols)) + + +if __name__ == '__main__': + main() diff --git a/tools/neoforge_oracle.py b/tools/neoforge_oracle.py new file mode 100644 index 000000000..f72bbec3e --- /dev/null +++ b/tools/neoforge_oracle.py @@ -0,0 +1,164 @@ +#!/usr/bin/env python3 +"""Dev-only NeoForge oracle for Horizon's mod-port harnesses (docs/modpacks.md). + + neoforge_oracle.py export --jars DIR [--deps DIR] [--namespaces a,b] --out FACTS.json + +installs a NeoForge server under .local/neoforge-oracle (once), builds the exporter mod in +mods/horizon/src/neoforge-oracle, starts the server headless with the given mod jars, and writes every +block, item, recipe and tag of the mods' namespaces (and the vanilla blocks, for templates) to +FACTS.json. The jars are the user's own; nothing here is shipped or committed. +""" +import argparse +import json +import os +import shutil +import subprocess +import sys +import time +import urllib.request +import zipfile +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[1] +LOCAL = ROOT / '.local' / 'neoforge-oracle' +SOURCE = ROOT / 'mods' / 'horizon' / 'src' / 'neoforge-oracle' +# ATM10 8.x: Minecraft 1.21.1 on NeoForge 21.1.259 (docs/modpacks.md). +NEOFORGE = os.environ.get('HORIZON_NEOFORGE', '21.1.259') +MAVEN = 'https://maven.neoforged.net/releases/net/neoforged/neoforge' + + +def install(): + """The NeoForge server, installed once per version.""" + home = LOCAL / NEOFORGE + args = home / f'libraries/net/neoforged/neoforge/{NEOFORGE}/unix_args.txt' + if args.exists(): + return home + home.mkdir(parents=True, exist_ok=True) + installer = LOCAL / f'neoforge-{NEOFORGE}-installer.jar' + if not installer.exists(): + url = f'{MAVEN}/{NEOFORGE}/neoforge-{NEOFORGE}-installer.jar' + with urllib.request.urlopen(url, timeout=120) as r: + installer.write_bytes(r.read()) + with (LOCAL / f'install-{NEOFORGE}.log').open('w') as log: + subprocess.run(['java', '-jar', str(installer), '--installServer', str(home)], + cwd=LOCAL, stdout=log, stderr=subprocess.STDOUT, check=True) + return home + + +def classpath(home): + libs = home / 'libraries' + first = [libs / f'net/neoforged/neoforge/{NEOFORGE}/neoforge-{NEOFORGE}-server.jar', + libs / f'net/neoforged/neoforge/{NEOFORGE}/neoforge-{NEOFORGE}-universal.jar'] + rest = sorted(p for p in libs.rglob('*.jar') if p not in first and 'slim' not in p.name + and 'extra' not in p.name and not p.name.endswith('-unpacked.jar')) + return os.pathsep.join(map(str, first + rest)) + + +def build(home): + """The exporter mod jar, rebuilt when its sources change.""" + out = LOCAL / 'build' + jar = out / 'horizon-oracle.jar' + sources = sorted((SOURCE / 'java').rglob('*.java')) + resources = sorted(p for p in (SOURCE / 'resources').rglob('*') if p.is_file()) + newest = max(p.stat().st_mtime for p in sources + resources) + if jar.exists() and jar.stat().st_mtime > newest: + return jar + classes = out / 'classes' + shutil.rmtree(classes, ignore_errors=True) + classes.mkdir(parents=True) + javac = subprocess.run(['javac', '--release', '21', '-proc:none', '-nowarn', '-cp', classpath(home), + '-d', str(classes), *map(str, sources)], capture_output=True, text=True) + if javac.returncode: + sys.exit(f'the exporter does not compile:\n{javac.stdout}{javac.stderr}') + with zipfile.ZipFile(jar, 'w', zipfile.ZIP_DEFLATED) as z: + for p in sorted(classes.rglob('*.class')): + z.write(p, p.relative_to(classes).as_posix()) + for p in resources: + z.write(p, p.relative_to(SOURCE / 'resources').as_posix()) + return jar + + +SERVER_PROPERTIES = """level-type=minecraft\\:flat +online-mode=false +server-port=0 +spawn-protection=0 +view-distance=2 +simulation-distance=2 +generate-structures=false +spawn-monsters=false +spawn-animals=false +""" + + +def instance(name, jars, extra=()): + """A server folder with `jars` (and the exporter) in mods/.""" + home = install() + run = LOCAL / 'runs' / name + shutil.rmtree(run, ignore_errors=True) + (run / 'mods').mkdir(parents=True) + (run / 'libraries').symlink_to(home / 'libraries') + (run / 'eula.txt').write_text('eula=true\n') + (run / 'server.properties').write_text(SERVER_PROPERTIES) + for jar in [*jars, *extra]: + (run / 'mods' / Path(jar).name).symlink_to(Path(jar).resolve()) + return home, run + + +def start(home, run, props, log_name='server.log', timeout=900): + """Runs the server to its end; returns (seconds, the log).""" + args = home / f'libraries/net/neoforged/neoforge/{NEOFORGE}/unix_args.txt' + command = ['java', '-Xmx4G', *[f'-D{k}={v}' for k, v in props.items()], f'@{args}', 'nogui'] + began = time.monotonic() + with (run / log_name).open('w') as log: + subprocess.run(command, cwd=run, stdin=subprocess.DEVNULL, stdout=log, + stderr=subprocess.STDOUT, timeout=timeout) + return time.monotonic() - began, (run / log_name).read_text(errors='replace') + + +def mod_ids(jar): + """The mod ids a jar declares (its neoforge.mods.toml).""" + import tomllib + with zipfile.ZipFile(jar) as z: + for name in ('META-INF/neoforge.mods.toml', 'META-INF/mods.toml'): + if name in z.namelist(): + try: + toml = tomllib.loads(z.read(name).decode('utf-8', 'replace')) + except tomllib.TOMLDecodeError: + return [] + return [m.get('modId', '') for m in toml.get('mods', [])] + return [] + + +def export(args): + jars = sorted(Path(args.jars).glob('*.jar')) + deps = sorted(Path(args.deps).glob('*.jar')) if args.deps else [] + namespaces = args.namespaces or ','.join(i for j in jars for i in mod_ids(j)) + home = install() + exporter = build(home) + home, run = instance('export', jars, [*deps, exporter]) + out = Path(args.out).resolve() + out.unlink(missing_ok=True) + seconds, log = start(home, run, {'horizon.oracle.out': out, 'horizon.oracle.namespaces': namespaces}) + if not out.exists(): + tail = '\n'.join(log.splitlines()[-40:]) + sys.exit(f'the oracle wrote nothing; the end of {run / "server.log"}:\n{tail}') + facts = json.loads(out.read_text()) + mods = sum(1 for b in facts['blocks'] if not b.startswith('minecraft:')) + print(f'{out}: {mods} mod blocks, {len(facts["items"])} items, {len(facts["recipes"])} recipes ' + f'({namespaces}); server ran {seconds:.1f} s') + + +def main(): + parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) + sub = parser.add_subparsers(dest='command', required=True) + e = sub.add_parser('export', help='write the facts of the mods in --jars') + e.add_argument('--jars', required=True, help='the mods to export') + e.add_argument('--deps', help='their required libraries (loaded, not exported)') + e.add_argument('--namespaces', help='comma-separated; default: the jars\' mod ids') + e.add_argument('--out', required=True) + args = parser.parse_args() + {'export': export}[args.command](args) + + +if __name__ == '__main__': + main() From 0560bbf87607c435bab58b7005b0fe0707891fec Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 16 Oct 2026 23:28:43 +0200 Subject: [PATCH 11/59] horizon-port-pack report: coverage per mod, and ATM10 measured `report ` writes coverage.json and coverage.md: per mod ported, partial, not yet or not needed with the reason, and the totals by class, tier and licence family. It reads the inventory, each mod's carry report and its harness result: ported is a green harness with nothing left out (blocks with a class of their own are counted and named); partial lists the failing checks, the blocks left out and what the templates miss; not yet names the API tier or the dependency it waits for; not needed covers libraries, performance mods and pack tooling. Unclassified mods are not yet, never not needed. `import` also reads Crash Assistant's modlist.json, the list ATM10 publishes in its repository (mod ids, names, versions, Modrinth hashes, the loader entry), and the inventory uses its mod ids and names when there is no jar. ATM10 (496 files, the eight mods we downloaded carried and checked): ported 1, partial 7, not yet 367, not needed 121. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-port-pack/src/import.rs | 90 ++++- crates/horizon-port-pack/src/inventory.rs | 10 +- crates/horizon-port-pack/src/main.rs | 24 +- crates/horizon-port-pack/src/report.rs | 428 ++++++++++++++++++++++ docs/modpacks.md | 36 +- 5 files changed, 579 insertions(+), 9 deletions(-) create mode 100644 crates/horizon-port-pack/src/report.rs diff --git a/crates/horizon-port-pack/src/import.rs b/crates/horizon-port-pack/src/import.rs index b0f5d04c2..dd712acf1 100644 --- a/crates/horizon-port-pack/src/import.rs +++ b/crates/horizon-port-pack/src/import.rs @@ -1,5 +1,6 @@ -//! Step 1, import: a Modrinth `.mrpack`, a CurseForge zip, or an instance -//! folder (Prism / MultiMC, or a plain `mods/` folder) to `pack.json`. +//! Step 1, import: a Modrinth `.mrpack`, a CurseForge zip, an instance +//! folder (Prism / MultiMC, or a plain `mods/` folder), or a Crash Assistant +//! `modlist.json` (the list packs such as ATM10 publish) to `pack.json`. use serde::{Deserialize, Serialize}; use serde_json::Value; use std::{ @@ -37,6 +38,13 @@ pub struct PackFile { /// CurseForge project and file ids. #[serde(default, skip_serializing_if = "Option::is_none")] pub curseforge: Option<(u64, u64)>, + /// The mod id, name and version a mod list states (`modlist.json`). + #[serde(default, skip_serializing_if = "Option::is_none")] + pub mod_id: Option, + #[serde(default, skip_serializing_if = "Option::is_none")] + pub name: Option, + #[serde(default, skip_serializing_if = "Option::is_none")] + pub version: Option, /// The jar on disk (instances only). #[serde(default, skip_serializing_if = "Option::is_none")] pub jar: Option, @@ -63,6 +71,12 @@ pub fn import(path: &Path) -> Result { if path.is_dir() { return instance(path); } + if path.extension().is_some_and(|e| e == "json") { + let text = fs::read_to_string(path).map_err(|e| format!("{}: {e}", path.display()))?; + let list: Value = serde_json::from_str(text.trim_start_matches('\u{feff}')) + .map_err(|e| format!("{}: {e}", path.display()))?; + return modlist(&list); + } let file = fs::File::open(path).map_err(|e| format!("{}: {e}", path.display()))?; let mut zip = zip::ZipArchive::new(file).map_err(|e| format!("{}: {e}", path.display()))?; if let Some(index) = read_json(&mut zip, "modrinth.index.json")? { @@ -186,6 +200,54 @@ pub fn curseforge(manifest: &Value, names: &[String]) -> Pack { } } +/// Crash Assistant's `config/crash_assistant/modlist.json`: jar name → mod +/// id, name, version and Modrinth SHA-1, with the loader as an entry of its +/// own. NeoForge `21.1.x` runs Minecraft 1.21.1. +pub fn modlist(list: &Value) -> Result { + let entries = list.as_object().ok_or("modlist.json: not an object")?; + let mut pack = Pack { + name: "modlist".into(), + format: "modlist".into(), + ..Pack::default() + }; + for (key, e) in entries { + let jar = e["jarName"].as_str().unwrap_or(key); + if jar.ends_with("(modloader)") { + let version = str_of(e, "version"); + let (loader, v) = version.split_once('-').unwrap_or(("", &version)); + pack.loader = loader.to_owned(); + pack.loader_version = v.to_owned(); + if loader == "neoforge" { + let mut parts = v.split('.'); + if let (Some(a), Some(b)) = (parts.next(), parts.next()) { + pack.minecraft = if b == "0" { + format!("1.{a}") + } else { + format!("1.{a}.{b}") + }; + } + } + continue; + } + let folder = if jar.ends_with(".zip") { + "datapacks" + } else { + "mods" + }; + let text = |k: &str| e[k].as_str().filter(|v| !v.is_empty()).map(str::to_owned); + pack.files.push(PackFile { + path: format!("{folder}/{jar}"), + sha1: text("modrinthHash"), + mod_id: text("modId"), + name: text("name"), + version: text("version"), + ..PackFile::default() + }); + } + pack.files.sort_by(|a, b| a.path.cmp(&b.path)); + Ok(pack) +} + /// A Prism / MultiMC instance (`mmc-pack.json`), a game folder, or a /// folder of jars: the jars on disk, hashed. fn instance(dir: &Path) -> Result { @@ -319,6 +381,30 @@ mod tests { ); } + #[test] + fn reads_a_crash_assistant_mod_list() { + let list = serde_json::json!({ + "neoforge-21.1.259 (modloader)": {"jarName": "neoforge-21.1.259 (modloader)", + "modId": "neoforge", "version": "neoforge-21.1.259"}, + "mcw-doors-1.1.2.jar": {"jarName": "mcw-doors-1.1.2.jar", "modId": "mcwdoors", + "modrinthHash": "0123456789abcdef0123456789abcdef01234567"}, + "sawmill.zip": {"jarName": "sawmill.zip"} + }); + let pack = modlist(&list).unwrap(); + assert_eq!( + ( + pack.minecraft.as_str(), + pack.loader.as_str(), + pack.loader_version.as_str() + ), + ("1.21.1", "neoforge", "21.1.259") + ); + let paths: Vec<&str> = pack.files.iter().map(|f| f.path.as_str()).collect(); + assert_eq!(paths, ["datapacks/sawmill.zip", "mods/mcw-doors-1.1.2.jar"]); + assert!(pack.files[1].sha1.is_some()); + assert_eq!(pack.files[1].mod_id.as_deref(), Some("mcwdoors")); + } + #[test] fn reads_a_curseforge_manifest() { let manifest = json!({"name": "CF", "overrides": "overrides", diff --git a/crates/horizon-port-pack/src/inventory.rs b/crates/horizon-port-pack/src/inventory.rs index 49661f1ae..57c043ae3 100644 --- a/crates/horizon-port-pack/src/inventory.rs +++ b/crates/horizon-port-pack/src/inventory.rs @@ -78,6 +78,7 @@ pub fn build(pack: &Pack, cache: &Cache, work: &Path) -> Vec { .as_ref() .map(|i| i.mod_id.clone()) .filter(|k| !k.is_empty()) + .or_else(|| f.mod_id.clone()) .or_else(|| Some(p("slug")).filter(|s| !s.is_empty())) .unwrap_or(stem); let (client, server) = match project { @@ -97,7 +98,9 @@ pub fn build(pack: &Pack, cache: &Cache, work: &Path) -> Vec { .as_ref() .map(|i| i.name.clone()) .filter(|n| !n.is_empty()) - .unwrap_or_else(|| p("title")); + .or_else(|| Some(p("title")).filter(|t| !t.is_empty())) + .or_else(|| f.name.clone()) + .unwrap_or_default(); let (class, tier, confidence) = match known.get(&[key.as_str(), p("slug").as_str(), name.as_str()]) { Some((c, t)) => (c.clone(), t.clone(), "known".to_owned()), @@ -123,8 +126,9 @@ pub fn build(pack: &Pack, cache: &Cache, work: &Path) -> Vec { .versions .get(sha1) .and_then(|v| v["version_number"].as_str()) - .unwrap_or("") - .to_owned() + .map(str::to_owned) + .or_else(|| f.version.clone()) + .unwrap_or_default() }), path: f.path.clone(), class, diff --git a/crates/horizon-port-pack/src/main.rs b/crates/horizon-port-pack/src/main.rs index 74178f503..3e6cdf4d7 100644 --- a/crates/horizon-port-pack/src/main.rs +++ b/crates/horizon-port-pack/src/main.rs @@ -12,6 +12,10 @@ //! (`tools/neoforge_oracle.py`), blocks and items come from its facts; //! `--resources` limits templates to the blocks Horizon's tables have. //! +//! - `report `: the coverage report, per mod ported, partial, not yet +//! or not needed with the reason, in `/coverage.json` and +//! `coverage.md`. +//! //! The work folder belongs to the user: jars and carried-over files stay //! there and are never uploaded or committed. mod carry; @@ -21,10 +25,11 @@ mod inventory; mod jar; mod modrinth; mod oracle; +mod report; use std::{fs, path::Path, process::ExitCode}; -const USAGE: &str = "usage: horizon-port-pack import | inventory [--offline] | carry [--resources ] [...]"; +const USAGE: &str = "usage: horizon-port-pack import | inventory [--offline] | carry [--resources ] [...] | report "; fn main() -> ExitCode { let args: Vec = std::env::args().skip(1).collect(); @@ -49,6 +54,7 @@ fn main() -> ExitCode { }; carry(w, resources.as_deref(), &rest) }), + Some("report") => path(1).and_then(report), _ => Err(USAGE.to_owned()), }; match result { @@ -70,6 +76,22 @@ fn read_json(path: &Path) -> Result { serde_json::from_str(&text).map_err(|e| format!("{}: {e}", path.display())) } +fn report(work: &Path) -> Result<(), String> { + let pack: import::Pack = read_json(&work.join("pack.json"))?; + let records: Vec = read_json(&work.join("inventory.json"))?; + let rows = report::build(&records, work); + write_json(&work.join("coverage.json"), &rows)?; + let title = format!( + "{} ({} {}, Minecraft {})", + pack.name, pack.loader, pack.loader_version, pack.minecraft + ); + fs::write(work.join("coverage.md"), report::markdown(&title, &rows)) + .map_err(|e| format!("coverage.md: {e}"))?; + println!("{title}: {} files: {:?}", rows.len(), report::counts(&rows)); + println!("{}", work.join("coverage.md").display()); + Ok(()) +} + fn import(pack: &Path, work: &Path) -> Result<(), String> { let pack = import::import(pack)?; fs::create_dir_all(work).map_err(|e| format!("{}: {e}", work.display()))?; diff --git a/crates/horizon-port-pack/src/report.rs b/crates/horizon-port-pack/src/report.rs new file mode 100644 index 000000000..ffa025c79 --- /dev/null +++ b/crates/horizon-port-pack/src/report.rs @@ -0,0 +1,428 @@ +//! Step 7, the coverage report: per mod, ported, partial, not yet or not +//! needed, with the reason, and the totals by class, tier and licence +//! (`coverage.json`, `coverage.md`). It reads what the other steps wrote: +//! the inventory, each mod's `carry-report.json` and its harness result +//! (`tools/mod_port_harness.py`). +use crate::inventory::Record; +use serde::{Deserialize, Serialize}; +use serde_json::Value; +use std::{collections::BTreeMap, fmt::Write, path::Path}; + +#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize)] +#[serde(rename_all = "kebab-case")] +pub enum Status { + Ported, + Partial, + NotYet, + NotNeeded, +} +impl Status { + pub const ALL: [Status; 4] = [ + Status::Ported, + Status::Partial, + Status::NotYet, + Status::NotNeeded, + ]; + pub fn label(self) -> &'static str { + match self { + Status::Ported => "ported", + Status::Partial => "partial", + Status::NotYet => "not yet", + Status::NotNeeded => "not needed", + } + } +} + +#[derive(Debug, Serialize, Deserialize)] +pub struct Row { + pub key: String, + pub name: String, + pub class: String, + pub tier: String, + pub license: String, + /// `permissive`, `copyleft`, `all-rights-reserved`, `restricted` + /// (non-commercial or no-derivatives), `custom` or `unknown`. + pub license_kind: String, + pub status: Status, + pub reason: String, +} + +/// The licence family of an SPDX id or a `mods.toml` licence text. +pub fn license_kind(license: &str) -> &'static str { + let l = license.to_ascii_lowercase(); + if l.is_empty() || l.starts_with("unknown") { + "unknown" + } else if l.contains("-nc") || l.contains("-nd") || l.contains("noncommercial") { + "restricted" + } else if l.contains("all-rights-reserved") || l.contains("all rights reserved") || l == "arr" { + "all-rights-reserved" + } else if ["gpl", "mpl", "eupl", "general public"] + .iter() + .any(|k| l.contains(k)) + { + "copyleft" + } else if [ + "mit", + "apache", + "bsd", + "cc0", + "cc-by", + "unlicense", + "isc", + "zlib", + ] + .iter() + .any(|k| l.contains(k)) + { + "permissive" + } else { + "custom" + } +} + +/// What still blocks a mod of this tier that has not been carried over. +fn not_yet(tier: &str) -> &'static str { + match tier { + "data" => "data tier: carry-over only, no agent; its jar is not in the work folder", + "logic" => { + "needs mod API 0.3: behaviour callbacks (use, place, break, ticks) and server events" + } + "machines" => "needs mod API 0.4: block entities, menus, capabilities and mod networking", + "deep" => { + "needs mod API 0.5: entities, custom renderers and models, dimensions, new vanilla hooks" + } + "client" => "needs the client interfaces (keys, target, inventory-read, ui, render)", + _ => "not classified", + } +} + +fn not_needed(class: &str) -> &'static str { + match class { + "library" => "library: its API maps to Horizon's mod API and SDK", + "performance" => "performance mod: Horizon's engine is the replacement", + "other" => "pack tooling or an engine feature, folded into the pipeline or the engine", + "client-ui" => "built into Horizon", + _ => "nothing to port", + } +} + +/// A carried-over mod: ported when its harness passes with nothing left +/// out and nothing the templates miss; else partial, with what is missing. +fn carried(work: &Path, key: &str) -> Option<(Status, String)> { + let dir = work.join("mods").join(key); + let carry: Value = + serde_json::from_slice(&std::fs::read(dir.join("carry-report.json")).ok()?).ok()?; + let count = |k: &str| carry[k].as_object().map_or(0, |o| o.len()); + let (blocks, items) = (count("blocks"), carry["items"].as_u64().unwrap_or(0)); + let (left_blocks, left_items) = (count("blocks_unknown"), count("items_unknown")); + // A class of its own is code the facts cannot show; anything else the + // template misses (shapes, sounds) the harness also reports. + let mut differences = 0; + let mut own_code = 0; + for list in carry["differences"] + .as_object() + .into_iter() + .flatten() + .map(|(_, v)| v) + { + let notes: Vec<&str> = list + .as_array() + .into_iter() + .flatten() + .filter_map(Value::as_str) + .collect(); + if notes.iter().any(|n| n.starts_with("class ")) { + own_code += 1; + } + if notes.iter().any(|n| !n.starts_with("class ")) { + differences += 1; + } + } + let mut gaps = Vec::new(); + if left_blocks > 0 { + gaps.push(format!( + "{left_blocks} blocks left out (no vanilla template)" + )); + } + if left_items > 0 { + gaps.push(format!("{left_items} items left out")); + } + if differences > 0 { + gaps.push(format!( + "{differences} blocks or items differ from their templates" + )); + } + let harness: Option = std::fs::read(dir.join("harness/result.json")) + .ok() + .and_then(|b| serde_json::from_slice(&b).ok()); + let mut checked = 0; + match &harness { + Some(h) => { + for (name, c) in h["checks"].as_object().into_iter().flatten() { + let (p, f) = ( + c["passed"].as_u64().unwrap_or(0), + c["failed"].as_u64().unwrap_or(0), + ); + checked += p + f; + if f > 0 { + gaps.push(format!("{name} {p}/{}", p + f)); + } + } + } + None => gaps.push("harness not run".into()), + } + let worldgen = carry["worldgen"].as_u64().unwrap_or(0); + if blocks == 0 && items == 0 && checked == 0 { + let what = if worldgen > 0 { + format!("{worldgen} worldgen files carried, not compared yet") + } else { + "nothing registered to compare".into() + }; + return Some((Status::Partial, what)); + } + let mut summary = format!("{blocks} blocks, {items} items"); + if own_code > 0 { + let _ = write!( + summary, + " ({own_code} with code of their own, not compared)" + ); + } + if gaps.is_empty() { + Some((Status::Ported, format!("{summary}; harness green"))) + } else { + Some((Status::Partial, format!("{summary}; {}", gaps.join("; ")))) + } +} + +pub fn build(records: &[Record], work: &Path) -> Vec { + let mut rows: Vec = records + .iter() + .map(|r| { + let (status, reason) = if r.class == "unknown" { + let why = + "unclassified: its jar (mods.toml, file census) or a reviewed row decides"; + (Status::NotYet, why.to_owned()) + } else if r.tier == "none" || matches!(r.class.as_str(), "library" | "performance") { + (Status::NotNeeded, not_needed(&r.class).to_owned()) + } else if let Some(c) = carried(work, &r.key) { + c + } else { + let mut why = not_yet(&r.tier).to_owned(); + if r.tier == "data" && r.jar.is_some() { + why = "data tier: carry-over not run yet".into(); + } + if r.class == "integration" { + why = format!("after the mods it joins are ported; {why}"); + } + (Status::NotYet, why) + }; + Row { + key: r.key.clone(), + name: r.name.clone(), + class: r.class.clone(), + tier: r.tier.clone(), + license: r.license.clone(), + license_kind: license_kind(&r.license).to_owned(), + status, + reason, + } + }) + .collect(); + // A mod waits on its dependencies that are not ported. + let status: BTreeMap = rows.iter().map(|r| (r.key.clone(), r.status)).collect(); + for (row, r) in rows.iter_mut().zip(records) { + if row.status == Status::NotNeeded { + continue; + } + let waiting: Vec<&str> = r + .depends + .iter() + .filter(|d| status.get(*d) == Some(&Status::NotYet)) + .map(String::as_str) + .collect(); + if !waiting.is_empty() { + let _ = write!(row.reason, "; waits on {}", waiting.join(", ")); + } + } + rows +} + +/// Rows counted by `field` and status. +fn table(rows: &[Row], title: &str, field: fn(&Row) -> &str) -> String { + let mut counts: BTreeMap<&str, [usize; 4]> = BTreeMap::new(); + for r in rows { + let i = Status::ALL.iter().position(|s| *s == r.status).unwrap_or(0); + counts.entry(field(r)).or_default()[i] += 1; + } + let mut out = format!( + "| {title} | ported | partial | not yet | not needed | all |\n|---|---:|---:|---:|---:|---:|\n" + ); + let mut totals = [0usize; 4]; + for (k, c) in &counts { + let all: usize = c.iter().sum(); + let _ = writeln!( + out, + "| {k} | {} | {} | {} | {} | {all} |", + c[0], c[1], c[2], c[3] + ); + for (t, n) in totals.iter_mut().zip(c) { + *t += n; + } + } + let all: usize = totals.iter().sum(); + let _ = writeln!( + out, + "| **all** | **{}** | **{}** | **{}** | **{}** | **{all}** |", + totals[0], totals[1], totals[2], totals[3] + ); + out +} + +pub fn markdown(pack: &str, rows: &[Row]) -> String { + let mut out = format!("# Coverage: {pack}\n\n"); + out += &table(rows, "class", |r| &r.class); + out += "\n"; + out += &table(rows, "tier", |r| &r.tier); + out += "\n"; + out += &table(rows, "licence", |r| &r.license_kind); + out += "\nPorts stay local. Only permissive or copyleft ports could ever be published, and only after Ludovic asks the authors.\n\n"; + out += "| mod | class | tier | licence | status | why |\n|---|---|---|---|---|---|\n"; + let mut sorted: Vec<&Row> = rows.iter().collect(); + sorted.sort_by(|a, b| (a.status, &a.key).cmp(&(b.status, &b.key))); + for r in sorted { + let _ = writeln!( + out, + "| {} | {} | {} | {} | {} | {} |", + r.key, + r.class, + r.tier, + r.license.replace('|', "/"), + r.status.label(), + r.reason.replace('|', "/") + ); + } + out +} + +pub fn counts(rows: &[Row]) -> Vec<(&'static str, usize)> { + Status::ALL + .iter() + .map(|s| (s.label(), rows.iter().filter(|r| r.status == *s).count())) + .collect() +} + +#[cfg(test)] +mod tests { + use super::*; + + fn record(key: &str, class: &str, tier: &str, depends: &[&str]) -> Record { + Record { + key: key.into(), + class: class.into(), + tier: tier.into(), + license: "MIT".into(), + depends: depends.iter().map(|d| (*d).to_owned()).collect(), + ..Record::default() + } + } + + #[test] + fn statuses_and_reasons() { + let work = std::env::temp_dir().join(format!("horizon-report-{}", std::process::id())); + let _ = std::fs::remove_dir_all(&work); + let write = |key: &str, carry: Value, harness: Option| { + let dir = work.join("mods").join(key); + std::fs::create_dir_all(dir.join("harness")).unwrap(); + std::fs::write(dir.join("carry-report.json"), carry.to_string()).unwrap(); + if let Some(h) = harness { + std::fs::write(dir.join("harness/result.json"), h.to_string()).unwrap(); + } + }; + let green = serde_json::json!({"checks": {"blocks": {"passed": 3, "failed": 0}}}); + write( + "doors", + serde_json::json!({"blocks": {"a": "minecraft:oak_door"}, "items": 0, + "differences": {"a": ["class m.Door (behaviour beyond DoorBlock)"]}}), + Some(green), + ); + write( + "paths", + serde_json::json!({"blocks": {"a": "minecraft:stone"}, "items": 1, + "blocks_unknown": {"b": "no vanilla Block"}}), + Some(serde_json::json!({"checks": {"shapes": {"passed": 1, "failed": 2}}})), + ); + let records = [ + record("doors", "content", "data", &[]), + record("paths", "content", "data", &[]), + record("lib", "library", "none", &[]), + record("machine", "content", "machines", &["lib"]), + record("addon", "integration", "logic", &["machine"]), + record("mystery", "unknown", "none", &[]), + ]; + let rows = build(&records, &work); + let by: BTreeMap<&str, &Row> = rows.iter().map(|r| (r.key.as_str(), r)).collect(); + assert_eq!(by["doors"].status, Status::Ported); + assert!( + by["doors"].reason.contains("1 with code of their own"), + "{}", + by["doors"].reason + ); + assert_eq!(by["paths"].status, Status::Partial); + assert!( + by["paths"].reason.contains("1 blocks left out"), + "{}", + by["paths"].reason + ); + assert!( + by["paths"].reason.contains("shapes 1/3"), + "{}", + by["paths"].reason + ); + assert_eq!(by["lib"].status, Status::NotNeeded); + assert_eq!(by["machine"].status, Status::NotYet); + assert!(by["machine"].reason.contains("0.4")); + assert!(by["addon"].reason.starts_with("after the mods it joins")); + assert!( + by["addon"].reason.ends_with("waits on machine"), + "{}", + by["addon"].reason + ); + assert_eq!(by["mystery"].status, Status::NotYet); + assert_eq!( + counts(&rows), + [ + ("ported", 1), + ("partial", 1), + ("not yet", 3), + ("not needed", 1) + ] + ); + let md = markdown("test", &rows); + assert!( + md.contains("| **all** | **1** | **1** | **3** | **1** | **6** |"), + "{md}" + ); + std::fs::remove_dir_all(&work).unwrap(); + } + + #[test] + fn licence_families() { + assert_eq!(license_kind("MIT"), "permissive"); + assert_eq!(license_kind("CC0-1.0"), "permissive"); + assert_eq!(license_kind("LGPL-3.0-only"), "copyleft"); + assert_eq!( + license_kind("GNU Lesser General Public License v3.0"), + "copyleft" + ); + assert_eq!( + license_kind("LicenseRef-All-Rights-Reserved"), + "all-rights-reserved" + ); + assert_eq!(license_kind("CC-BY-NC-SA-4.0"), "restricted"); + assert_eq!(license_kind("LicenseRef-Stardust-Labs-License"), "custom"); + assert_eq!( + license_kind("unknown (read mods.toml at import)"), + "unknown" + ); + } +} diff --git a/docs/modpacks.md b/docs/modpacks.md index 9cdd14774..d3cb7c401 100644 --- a/docs/modpacks.md +++ b/docs/modpacks.md @@ -262,13 +262,14 @@ inspected: └── coverage.json, coverage.md ``` -**Status.** `import`, `inventory` and `carry` run today: +**Status.** `import`, `inventory`, `carry` and `report` run today: ``` cargo run -p horizon-port-pack -- import ~/Downloads/pack.mrpack ~/.horizon/ports/pack cargo run -p horizon-port-pack -- inventory ~/.horizon/ports/pack # --offline reuses modrinth.json cargo run -p horizon-port-pack -- carry ~/.horizon/ports/pack # content mods with a jar, or name them # --resources : only templates Horizon's tables have +cargo run -p horizon-port-pack -- report ~/.horizon/ports/pack # coverage.json and coverage.md ``` `inventory` reads metadata only: Modrinth answers by file hash, and the jars only if the user's @@ -307,6 +308,7 @@ block's name breaking ties (`_pane`, `_gate`, `_trapdoor`). | CurseForge zip | `manifest.json`: `minecraft.version`, `modLoaders[]`, `files[]` (`projectID`, `fileID`, `required`), `overrides` | the user's installed instance (CurseForge app `minecraftinstance.json` + `mods/`). CurseForge's API needs a key, so we take what the user already downloaded | | Prism / MultiMC instance | `mmc-pack.json` components (`net.minecraft`, `net.neoforged`, `net.fabricmc.fabric-loader`), `instance.cfg`, `.minecraft/mods/*.jar`, packwiz `.pw.toml` files if present | the instance folder | | packwiz | `pack.toml`, `index.toml`, `mods/*.pw.toml` | as listed | +| Crash Assistant `modlist.json` | jar name → mod id, name, version, Modrinth SHA-1; the loader entry (NeoForge `21.1.x` is Minecraft 1.21.1). Packs such as ATM10 publish it in their repository | metadata only; jars put in `/jars/` | `pack.json` holds the Minecraft version, the loader and its version, each file with its hashes and side, and the overrides (configs, KubeJS scripts, datapacks). @@ -458,8 +460,36 @@ and tag of the declared blocks matches. Plus the licence summary (how many ports could be published) and, for a pack, "playable?": whether every required content mod is ported or partial with its blocks and items present. -For ATM10 today: 125 of 495 are not needed. The other 370 are not yet ported; 68 of them are -data tier, so they need registries and carry-over but no agent. + +`horizon-port-pack report ` writes the per-mod rows and the class, tier and licence totals from the inventory, each mod's `carry-report.json` +and its harness result. A data-tier mod is **ported** when its harness is green and nothing was +left out (blocks with a class of their own are counted and named, since facts cannot show +their extra code); **partial** with the failing checks, the blocks left out and what the +templates miss; **not yet** with the API tier it waits for, or the dependency; **not needed** +for libraries, performance mods, pack tooling and what Horizon has built in. Unclassified mods +(the 20 CurseForge-only rows the reviewed table only guesses) count as not yet. + +**ATM10, measured** (`import` of ATM10's `modlist.json` from its repository on 2026-10-16, 496 +files; `inventory`; `carry` and the harness on the eight mods we downloaded; `report`): + +| class | ported | partial | not yet | not needed | all | +|---|---:|---:|---:|---:|---:| +| content | 1 | 7 | 268 | 0 | 276 | +| library | 0 | 0 | 0 | 77 | 77 | +| integration | 0 | 0 | 40 | 3 | 43 | +| client-ui | 0 | 0 | 27 | 2 | 29 | +| other | 0 | 0 | 1 | 23 | 24 | +| unknown | 0 | 0 | 20 | 0 | 20 | +| performance | 0 | 0 | 0 | 16 | 16 | +| server-only | 0 | 0 | 11 | 0 | 11 | +| **all** | **1** | **7** | **367** | **121** | **496** | + +By tier, the 367 not yet: data 57 (carry-over and the harness, no agent: their jars were not +downloaded), logic 66 (API 0.3), machines 97 (0.4), deep 92 (0.5), client 35, unclassified 20. +Ported: Macaw's Trapdoors. Partial: Macaw's Doors, Fences and Walls, Paths and Pavings, +Glassential, Factory Blocks, Cloud Glass (see the harness table) and MVS, whose 784 worldgen +files are carried but not yet read by the game. Of the 8, 7 are MIT and one LGPL; nothing is +published. ## Measuring "10x" From bd0dd979a014f68fdc43188ef1dcdfbfc3b98186 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 16 Oct 2026 23:45:06 +0200 Subject: [PATCH 12/59] Integrated server: build only the font, not the whole HUD atlas The integrated server draws nothing, but it built the window's full HUD atlas (GUI, item, block, entity and particle textures plus the run-time slots). It now builds an atlas of the font sheets only, reads the glyph widths from it and drops the pixels: text still measures the same (books split their pages with it), without holding the textures. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game/integrated.rs | 3 +- crates/horizon-client/src/hud.rs | 149 ++++++++++++++----- 2 files changed, 110 insertions(+), 42 deletions(-) diff --git a/crates/horizon-client/src/game/integrated.rs b/crates/horizon-client/src/game/integrated.rs index 6edbb6e40..30b9ff23f 100644 --- a/crates/horizon-client/src/game/integrated.rs +++ b/crates/horizon-client/src/game/integrated.rs @@ -282,7 +282,8 @@ fn serve( flags: &Flags, ready: &Sender>, ) -> Result<()> { - let atlas = HudAtlas::build(&options.resources)?; + // It draws nothing: only the font, which books and chat measure with. + let atlas = HudAtlas::fonts(&options.resources)?; let audio = Audio::silent(&options.resources); let mut server = Game::new(res, pack, atlas, options, settings, audio)?; server.run_integrated(launch, flags, ready) diff --git a/crates/horizon-client/src/hud.rs b/crates/horizon-client/src/hud.rs index 77ba0e342..c42f8c8bc 100644 --- a/crates/horizon-client/src/hud.rs +++ b/crates/horizon-client/src/hud.rs @@ -139,19 +139,74 @@ impl HudAtlas { (g.rect, g.advance) } pub fn build(root: &Path) -> Result { + Self::pack( + root, + &[ + "gui", + "item", + "block", + "font", + "environment", + "misc", + "painting", + "entity", + "particle", + "mob_effect", + "map", + ], + true, + ) + } + /// Empty slots written at run time: map textures (game/maps.rs), the + /// minimap, downloaded skins, world icons and the Horizon menu text. + fn slots(images: &mut Vec) { + for i in 0..MAP_SLOTS { + images.push((format!("horizon/map{i}"), 128, 128, vec![0; 128 * 128 * 4])); + } + // The minimap extra's image (game/extras.rs). + images.push(( + MINIMAP_SPRITE.into(), + crate::minimap::SIZE as u32, + crate::minimap::SIZE as u32, + vec![0; crate::minimap::SIZE * crate::minimap::SIZE * 4], + )); + // Downloaded skins (game/scoreboard.rs). + for i in 0..SKIN_SLOTS { + images.push((format!("horizon/skin{i}"), 64, 64, vec![0; 64 * 64 * 4])); + } + for i in 0..WORLD_ICON_SLOTS { + images.push(( + format!("horizon/world-icon{i}"), + 64, + 64, + vec![0; 64 * 64 * 4], + )); + } + // Horizon-style menu text and corner masks (ui_theme), rasterized at run time. + images.push(( + "horizon/ui-text".into(), + 2048, + 1024, + vec![0; 2048 * 1024 * 4], + )); + } + /// Only the font's metrics, for a game that draws nothing (the + /// integrated server): text measures as with the full atlas, without + /// holding its textures. The pixels are dropped once the glyph widths are + /// read, since nothing uploads them. + pub fn fonts(root: &Path) -> Result { + let mut atlas = Self::pack(root, &["font"], false)?; + atlas.pixels = Vec::new(); + Ok(atlas) + } + /// Pack the textures under these folders of `textures/`, and for the + /// `full` atlas the generated sprites and the run-time slots too. + fn pack(root: &Path, folders: &[&str], full: bool) -> Result { let textures = root.join("assets/minecraft/textures"); let mut files = Vec::new(); - walk(&textures.join("gui"), &mut files); - walk(&textures.join("item"), &mut files); - walk(&textures.join("block"), &mut files); - walk(&textures.join("font"), &mut files); - walk(&textures.join("environment"), &mut files); - walk(&textures.join("misc"), &mut files); - walk(&textures.join("painting"), &mut files); - walk(&textures.join("entity"), &mut files); - walk(&textures.join("particle"), &mut files); - walk(&textures.join("mob_effect"), &mut files); - walk(&textures.join("map"), &mut files); + for folder in folders { + walk(&textures.join(folder), &mut files); + } files.retain(|p| { let s = p.to_string_lossy(); !s.contains("title/background") && !s.contains("realms") && !s.contains("presets") @@ -187,7 +242,9 @@ impl HudAtlas { .flat_map(|h| h.join().unwrap_or_default()) .collect() }); - images.extend(atlas_sprites(root, &images)); + if full { + images.extend(atlas_sprites(root, &images)); + } // The title screen's "JAVA EDITION" banner reads "RUST EDITION". if let Some(edition) = images .iter_mut() @@ -198,36 +255,9 @@ impl HudAtlas { edition.3 = pixels; } images.push(("horizon/white".into(), 4, 4, vec![255; 64])); - // Map textures (game/maps.rs) are written into these slots at run time. - for i in 0..MAP_SLOTS { - images.push((format!("horizon/map{i}"), 128, 128, vec![0; 128 * 128 * 4])); + if full { + Self::slots(&mut images); } - // The minimap extra's image (game/extras.rs). - images.push(( - MINIMAP_SPRITE.into(), - crate::minimap::SIZE as u32, - crate::minimap::SIZE as u32, - vec![0; crate::minimap::SIZE * crate::minimap::SIZE * 4], - )); - // Downloaded skins (game/scoreboard.rs) likewise. - for i in 0..SKIN_SLOTS { - images.push((format!("horizon/skin{i}"), 64, 64, vec![0; 64 * 64 * 4])); - } - for i in 0..WORLD_ICON_SLOTS { - images.push(( - format!("horizon/world-icon{i}"), - 64, - 64, - vec![0; 64 * 64 * 4], - )); - } - // Horizon-style menu text and corner masks (ui_theme), rasterized at run time. - images.push(( - "horizon/ui-text".into(), - 2048, - 1024, - vec![0; 2048 * 1024 * 4], - )); images.sort_by(|a, b| b.2.cmp(&a.2).then(b.1.cmp(&a.1))); let width = 4096u32; let mut placements = Vec::with_capacity(images.len()); @@ -1023,6 +1053,43 @@ impl HudRenderer { mod tests { use super::*; + #[test] + fn the_fonts_only_atlas_measures_text_like_the_full_one() { + // A synthetic default font: two 8x8 glyphs, 3 and 5 pixels wide. + let root = std::env::temp_dir().join(format!("horizon-fonts-atlas-{}", std::process::id())); + let font = root.join("assets/minecraft/font"); + let textures = root.join("assets/minecraft/textures/font"); + fs::create_dir_all(&font).unwrap(); + fs::create_dir_all(&textures).unwrap(); + fs::write( + font.join("default.json"), + r#"{"providers":[{"type":"bitmap","file":"minecraft:font/test.png","ascent":7,"chars":["ab"]}]}"#, + ) + .unwrap(); + let mut pixels = vec![0u8; 16 * 8 * 4]; + for y in 0..8 { + for x in (0..3).chain(8..13) { + pixels[(y * 16 + x) * 4 + 3] = 255; + } + } + let mut encoder = + png::Encoder::new(fs::File::create(textures.join("test.png")).unwrap(), 16, 8); + encoder.set_color(png::ColorType::Rgba); + encoder.set_depth(png::BitDepth::Eight); + encoder + .write_header() + .unwrap() + .write_image_data(&pixels) + .unwrap(); + let full = HudAtlas::build(&root).unwrap(); + let fonts = HudAtlas::fonts(&root).unwrap(); + let _ = fs::remove_dir_all(&root); + assert!(fonts.pixels.is_empty()); + let width = full.font.width("abba"); + assert!(width > 0.0); + assert_eq!(fonts.font.width("abba"), width); + } + #[test] fn effect_icons_are_painted_from_the_mob_effect_directory() { use crate::{effects::EffectInstance, hud_layout, hud_overlays, inventory_effects}; From 30d11d6a2e87cb5cf4e64ec1c19d04be9f0fddc5 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Fri, 16 Oct 2026 23:45:19 +0200 Subject: [PATCH 13/59] Integrated server: single-player pause menu labels On its server thread a single-player world is joined like a server, so the Horizon pause menu named it "Multiplayer" with a "Disconnect" button, and F3+Escape opened the full menu as on a server. The server thread now hands the window the world's name with its connection, the pause menu shows that name and "Save and quit", and `has_singleplayer_server` (Minecraft.hasSingleplayerServer) covers both ways of running a world for the pause checks. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game.rs | 2 +- crates/horizon-client/src/game/debug_keys.rs | 2 +- crates/horizon-client/src/game/integrated.rs | 25 ++++++++++++++++---- crates/horizon-client/src/game/screens.rs | 17 ++++++------- 4 files changed, 29 insertions(+), 17 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 6b1c09b60..4429a88cb 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -3643,7 +3643,7 @@ impl Game<'_> { } /// `Minecraft.pause`: a single-player game with a pausing screen open. fn pauses_game(&self) -> bool { - (self.remote.is_none() || self.integrated.is_some()) + self.has_singleplayer_server() && self.lan.is_none() && self.title.is_none() && (matches!( diff --git a/crates/horizon-client/src/game/debug_keys.rs b/crates/horizon-client/src/game/debug_keys.rs index 3aac02ae7..4008c33d9 100644 --- a/crates/horizon-client/src/game/debug_keys.rs +++ b/crates/horizon-client/src/game/debug_keys.rs @@ -38,7 +38,7 @@ impl DebugHost for Host<'_, '_> { // the menu as it always has (key_pressed). let g = &mut *self.game; if without_menu && g.screen == Screen::Playing { - g.pause_menu = !(g.remote.is_none() && g.lan.is_none()); + g.pause_menu = !(g.has_singleplayer_server() && g.lan.is_none()); g.screen = Screen::Paused; g.capture(false); g.mining = None; diff --git a/crates/horizon-client/src/game/integrated.rs b/crates/horizon-client/src/game/integrated.rs index 30b9ff23f..0366627e3 100644 --- a/crates/horizon-client/src/game/integrated.rs +++ b/crates/horizon-client/src/game/integrated.rs @@ -45,6 +45,8 @@ struct Flags { pub(super) struct Integrated { flags: Arc, thread: Option>, + /// The world's name (`level.dat`'s `LevelName`), for the pause menu. + pub world_name: String, } impl Integrated { /// `IntegratedServer.tickServer` skips the world while the game is paused. @@ -68,6 +70,10 @@ impl Drop for Integrated { } } +/// What the server thread hands the window once the world is open: its end +/// of the connection and the world's name, or why it failed. +type Ready = std::result::Result<(Pipe, String), String>; + /// The world to open and the player who owns it. struct Launch { folder: String, @@ -88,6 +94,11 @@ pub(super) fn wanted(options: &Options, world: &Path) -> bool { } impl Game<'_> { + /// `Minecraft.hasSingleplayerServer`: a world of this window's own, run + /// in the frame or on its server thread. + pub(super) fn has_singleplayer_server(&self) -> bool { + self.remote.is_none() || self.integrated.is_some() + } /// `Minecraft.doWorldLoad`: start the server thread on the world, wait /// until it can be joined, then join it through memory. pub(super) fn open_integrated( @@ -145,12 +156,16 @@ impl Game<'_> { let _ = ready_tx.send(Err(e.to_string())); } })?; - let handle = Integrated { + let mut handle = Integrated { flags, thread: Some(thread), + world_name: String::new(), }; let pipe = match ready.recv() { - Ok(Ok(pipe)) => pipe, + Ok(Ok((pipe, world_name))) => { + handle.world_name = world_name; + pipe + } Ok(Err(e)) => return Err(e.into()), Err(_) => return Err("the integrated server stopped".into()), }; @@ -165,7 +180,7 @@ impl Game<'_> { &mut self, launch: Launch, flags: &Flags, - ready: &Sender>, + ready: &Sender, ) -> Result<()> { self.open_world( &launch.folder, @@ -223,7 +238,7 @@ impl Game<'_> { }); host.hub.lan.connect_local()? }; - let _ = ready.send(Ok(pipe)); + let _ = ready.send(Ok((pipe, self.level.name.clone()))); self.settle_spawn()?; let mut next = Instant::now(); while !flags.stop.load(Ordering::Relaxed) { @@ -280,7 +295,7 @@ fn serve( settings: Settings, launch: Launch, flags: &Flags, - ready: &Sender>, + ready: &Sender, ) -> Result<()> { // It draws nothing: only the font, which books and chat measure with. let atlas = HudAtlas::fonts(&options.resources)?; diff --git a/crates/horizon-client/src/game/screens.rs b/crates/horizon-client/src/game/screens.rs index ac4d16274..0e0d63c23 100644 --- a/crates/horizon-client/src/game/screens.rs +++ b/crates/horizon-client/src/game/screens.rs @@ -60,17 +60,14 @@ impl Game<'_> { && horizon_client::ui_theme::horizon() } fn pause_labels(&self) -> (String, &'static str) { - let world = if self.remote.is_some() { - "Multiplayer".to_owned() + if let Some(server) = &self.integrated { + return (server.world_name.clone(), "Save and quit"); + } + if self.remote.is_some() { + ("Multiplayer".to_owned(), "Disconnect") } else { - self.level.name.clone() - }; - let quit = if self.remote.is_some() { - "Disconnect" - } else { - "Save and quit" - }; - (world, quit) + (self.level.name.clone(), "Save and quit") + } } pub(super) fn draw_pause_menu(&mut self, batch: &mut HudBatch) { if horizon_client::ui_theme::horizon() { From a71d148ca5a63b06543089aa686466cd34854cd2 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 00:22:53 +0200 Subject: [PATCH 14/59] Network players have status effects A player who joins over the network, which is now single player's own player on its server thread, had no status effects: what they drank, ate or were given went to the host, and their client never heard of any. - Each guest has their own effects. `as_guest` trades them, and what their body was given for them (attribute modifiers, armor protection, enchantment modifiers), with the host's while the guest acts. - They tick on the server with the guest's body (LivingEntity.baseTick's tickEffects), spectators included. - The client is told as vanilla's ServerPlayer does: every effect when placed (PlayerList.sendActivePlayerEffects), then added (blended), updated, refreshed every 600 ticks left, and removed. An effect that only counted down is not sent again. - The client keeps its own effects from those packets (LivingEntity.forceAddEffect), counts them down (tickClient), and its predicted movement, HUD icons and night vision follow them. A respawn starts without effects on both sides. - Guests save and load them in their player file. Saving also stops writing effects that have run out: the loaded player compound kept the old `active_effects`, and they came back on reopen. Potions in flight now tick on a server without a local player too. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/effects.rs | 41 +++++++ crates/horizon-client/src/game.rs | 16 +-- crates/horizon-client/src/game/lan_actions.rs | 33 +++++- crates/horizon-client/src/game/potions.rs | 49 ++++++-- crates/horizon-client/src/game/remote.rs | 36 ++++++ crates/horizon-client/src/lan/guest.rs | 18 +++ crates/horizon-client/src/lan/hub.rs | 108 +++++++++++++++++- crates/horizon-client/src/lan/playerdata.rs | 2 + crates/horizon-client/src/save.rs | 16 +++ 9 files changed, 288 insertions(+), 31 deletions(-) diff --git a/crates/horizon-client/src/effects.rs b/crates/horizon-client/src/effects.rs index 71a9377ed..2e600333a 100644 --- a/crates/horizon-client/src/effects.rs +++ b/crates/horizon-client/src/effects.rs @@ -68,6 +68,14 @@ impl EffectInstance { } changed } + /// `MobEffectInstance.tickClient`: a client counts its effects down + /// (the server removes them). + pub fn tick_client(&mut self) { + if self.infinite() || self.duration > 0 { + self.tick_down(); + self.downgrade(); + } + } fn tick_down(&mut self) { if let Some(h) = self.hidden.as_mut() { h.tick_down(); @@ -170,6 +178,39 @@ impl PlayerEffects { pub fn clear(&mut self) { self.list.clear(); } + /// The effects of a saved player (`Player.active_effects`: id, + /// duration, amplifier, ambient, visible). + pub fn from_saved(saved: &[(String, i32, i32, bool, bool)]) -> Self { + let mut effects = Self::default(); + for (id, duration, amplifier, ambient, _) in saved { + if let Some(def) = brewing::effect(id) { + let mut e = EffectInstance::new(def.id, *duration, *amplifier); + e.ambient = *ambient; + effects.add(e); + } + } + effects + } + /// `Player.active_effects` for the save. + pub fn saved(&self) -> Vec<(String, i32, i32, bool, bool)> { + self.list + .iter() + .map(|e| { + ( + format!("minecraft:{}", e.id), + e.duration, + e.amplifier, + e.ambient, + e.visible, + ) + }) + .collect() + } + /// ClientboundUpdateMobEffectPacket's flags without blending: ambient, + /// particles visible and the icon shown (always, for these effects). + pub fn flags(e: &EffectInstance) -> i8 { + i8::from(e.ambient) | i8::from(e.visible) << 1 | 4 + } /// `LivingEntity.tickEffects` (server part) with the omens' effect ticks: /// `omen` answers `BadOmenMobEffect` (every tick) and `RaidOmenMobEffect` /// (on its last tick). Returns the actions to apply, in order, and diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 4429a88cb..e03c71a48 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -8313,21 +8313,7 @@ impl Game<'_> { self.ender_items = items.clone(); } level.ender_items = self.ender_items.clone(); - level.active_effects = self - .potions - .effects - .list - .iter() - .map(|e| { - ( - format!("minecraft:{}", e.id), - e.duration, - e.amplifier, - e.ambient, - e.visible, - ) - }) - .collect(); + level.active_effects = self.potions.effects.saved(); } fn save_game(&mut self) -> Result<()> { self.save_game_with(true) diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index 6bf76f160..1f6921e0c 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -43,6 +43,8 @@ pub(super) struct GuestPlay { pub(super) merchant: Option, /// The inventory menu and the crafting table the guest crafts in. pub(super) crafting: super::lan_crafting::GuestCrafting, + /// What the guest's body was given for its effects and enchantments. + potions: super::potions::BodyPotions, } struct ItemRules<'a>(&'a horizon_client::items::Items); @@ -92,7 +94,11 @@ impl Game<'_> { let mut play = host.play.remove(&conn).unwrap_or_default(); let g = &mut host.hub.guests[i]; // The guest's body. - let mut motion = g.motion.take()?; + let Some(mut motion) = g.motion.take() else { + host.play.insert(conn, play); + return None; + }; + self.potions.swap_player(&mut g.effects, &mut play.potions); motion.position = Vec3::new(g.position[0], g.position[1], g.position[2]); motion.ground.on_ground = g.on_ground; motion.yaw = g.yaw; @@ -188,6 +194,7 @@ impl Game<'_> { } let g = &mut host.hub.guests[i]; std::mem::swap(&mut self.ender_items, &mut g.ender_items); + self.potions.swap_player(&mut g.effects, &mut play.potions); if let Some(key) = host_ender { self.world .block_entities @@ -759,6 +766,10 @@ impl Game<'_> { g.saturation = 5.0; g.sent_health = None; g.motion = None; + // A new body: nothing given to the old one carries over. + if let Some(play) = host.play.get_mut(&conn) { + play.potions = Default::default(); + } host.hub.respawn(i, spawn); } @@ -846,12 +857,17 @@ impl Game<'_> { g.moves_from_ground }; if g.spectator() { + // Spectators' effects still run (LivingEntity.baseTick). + if !g.effects.list.is_empty() { + self.as_guest(host, conn, |game| game.tick_mob_effects()); + } return; } let in_wall = !g.sleeping && self.in_wall(g.position, g.eye_height()); let at = g.position; let sounds = self.as_guest(host, conn, |game| { - let (rules, health) = (game.world.health_rules, &game.motion.health); + let (rules, motion) = (game.world.health_rules, game.motion); + let health = &motion.health; let Some(player) = game.player.as_mut() else { return Vec::new(); }; @@ -889,9 +905,16 @@ impl Game<'_> { let _ = w.tick_environment_damage(); let _ = w.apply_fire_contact(); let _ = w.server_hazards_tick(in_wall); - let _ = w.player.peaceful_regeneration(rules); - let _ = w.player.food_tick(health, rules); - std::mem::take(&mut w.player.events) + let mut events = std::mem::take(&mut w.player.events); + // LivingEntity.baseTick ends with tickEffects. + game.tick_mob_effects(); + let Some(player) = game.player.as_mut() else { + return Vec::new(); + }; + let _ = player.peaceful_regeneration(rules); + let _ = player.food_tick(health, rules); + events.append(&mut player.events); + events .into_iter() .filter_map(|e| match e { MotionEvent::HurtSound(sound) => Some(sound), diff --git a/crates/horizon-client/src/game/potions.rs b/crates/horizon-client/src/game/potions.rs index fbc8556e7..a60926256 100644 --- a/crates/horizon-client/src/game/potions.rs +++ b/crates/horizon-client/src/game/potions.rs @@ -49,6 +49,14 @@ impl Game<'_> { }); } } +/// What a player's body was last given for its effects and enchantments: +/// a guest keeps their own while the host's are in `PotionState`. +#[derive(Default)] +pub(super) struct BodyPotions { + applied: Vec<(&'static str, &'static str, f64, &'static str)>, + protection_for: Option>>, + enchant_modifiers: Vec<(String, String, f64, String)>, +} /// Effects, thrown potions and the attribute modifiers last applied. #[derive(Default)] pub(super) struct PotionState { @@ -63,6 +71,14 @@ pub(super) struct PotionState { } impl PotionState { + /// Trade the player's own state (effects and what their body was given) + /// with a guest's, around `as_guest`. Potions in flight stay. + pub(super) fn swap_player(&mut self, effects: &mut PlayerEffects, body: &mut BodyPotions) { + std::mem::swap(&mut self.effects, effects); + std::mem::swap(&mut self.applied, &mut body.applied); + std::mem::swap(&mut self.protection_for, &mut body.protection_for); + std::mem::swap(&mut self.enchant_modifiers, &mut body.enchant_modifiers); + } /// Thrown potions in flight as (entity type, position, motion), for the /// dispenser parity fixture. pub(super) fn thrown_entities(&self) -> Vec<(&'static str, Vec3, Vec3)> { @@ -274,8 +290,16 @@ impl Game<'_> { } } } - /// `LivingEntity.tickEffects`, attribute modifiers and the status flags. + /// The local player's effects (`tick_mob_effects`), then the potions + /// in flight, which a server without a local player still has. pub(super) fn tick_effects(&mut self) { + self.tick_mob_effects(); + self.tick_thrown_potions(); + } + /// `LivingEntity.tickEffects` (server side) for `self.player`, the local + /// player or a guest acting (`as_guest`), then its attribute modifiers + /// and status flags. + pub(super) fn tick_mob_effects(&mut self) { let Some(player) = self.player.as_ref() else { return; }; @@ -294,6 +318,20 @@ impl Game<'_> { for action in actions { self.apply_effect_action(action); } + self.apply_effect_status(); + } + /// A client's own effects (`LivingEntity.tickEffects` on the client, + /// `MobEffectInstance.tickClient`): they count down, and the server + /// removes them. Their modifiers and flags move the predicted player. + pub(super) fn tick_client_effects(&mut self) { + for e in &mut self.potions.effects.list { + e.tick_client(); + } + self.apply_effect_status(); + } + /// The effects' attribute modifiers, armor protection and status flags + /// on `self.player`. + fn apply_effect_status(&mut self) { let modifiers = self.potions.effects.modifiers(); if modifiers != self.potions.applied && let Some(p) = self.player.as_mut() @@ -346,7 +384,6 @@ impl Game<'_> { status.protection = std::mem::take(&mut p.status.protection); p.status = status; } - self.tick_thrown_potions(); } fn tick_thrown_potions(&mut self) { let mut thrown = std::mem::take(&mut self.potions.thrown); @@ -606,13 +643,7 @@ impl Game<'_> { /// Effects saved in level.dat (`Player.active_effects`). pub(super) fn restore_effects(&mut self) { self.potions = PotionState::default(); - for (id, duration, amplifier, ambient, _) in self.level.active_effects.clone() { - if let Some(def) = brewing::effect(&id) { - let mut e = EffectInstance::new(def.id, duration, amplifier); - e.ambient = ambient; - self.potions.effects.add(e); - } - } + self.potions.effects = PlayerEffects::from_saved(&self.level.active_effects); } pub(super) fn effects_json(&self) -> serde_json::Value { serde_json::json!({ diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index e31e270b8..8e4e973f2 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -366,6 +366,31 @@ impl Game<'_> { .unwrap_or("minecraft:air"), ) } + /// A mob effect's network id as the effect (`brewing::EFFECTS` id). + fn remote_effect_id(&self, effect: i32) -> Option<&'static str> { + let r = self.remote.as_ref()?; + let name = r.builtin.get("minecraft:mob_effect")?.name(effect)?; + horizon_client::brewing::effect(name).map(|d| d.id) + } + /// ClientPacketListener.handleUpdateMobEffect for the player itself + /// (`LivingEntity.forceAddEffect`): the effect replaces any of its kind. + /// Other entities' effects are not shown. + fn remote_effect(&mut self, p: &play::UpdateMobEffect) { + if !self.remote.as_ref().is_some_and(|r| r.entity_id == p.id) { + return; + } + let Some(id) = self.remote_effect_id(p.effect) else { + return; + }; + let mut e = horizon_client::effects::EffectInstance::new(id, p.duration, p.amplifier); + e.ambient = p.flags & 1 != 0; + e.visible = p.flags & 2 != 0; + let list = &mut self.potions.effects.list; + match list.iter_mut().find(|x| x.id == id) { + Some(existing) => *existing = e, + None => list.push(e), + } + } fn item_id(&self, name: &str) -> i32 { let r = self.remote.as_ref().expect("remote"); r.builtin @@ -806,6 +831,8 @@ impl Game<'_> { )); } C::Respawn(p) => { + // A new player, without effects: the server sends them again. + self.potions.effects.clear(); self.enter_remote_dimension(&p.spawn, true); self.screen = Screen::Playing; if let Some(r) = self.remote.as_mut() { @@ -1120,6 +1147,14 @@ impl Game<'_> { } } C::Animate(p) if p.action == 0 => {} + C::UpdateMobEffect(p) => self.remote_effect(&p), + C::RemoveMobEffect(p) => { + if self.remote.as_ref().is_some_and(|r| r.entity_id == p.id) + && let Some(id) = self.remote_effect_id(p.effect) + { + self.potions.effects.list.retain(|e| e.id != id); + } + } C::SetHealth(p) => { if let Some(r) = self.remote.as_mut() { r.health = (p.health, p.food, p.saturation); @@ -1789,6 +1824,7 @@ impl Game<'_> { self.tick_block_entity_anims(); self.tick_hand(); self.tick_particles(); + self.tick_client_effects(); let ghast_collisions = self.happy_ghast_player_collisions(); let Some(player) = self.player.as_mut() else { return Ok(()); diff --git a/crates/horizon-client/src/lan/guest.rs b/crates/horizon-client/src/lan/guest.rs index 954ffc714..243c90d18 100644 --- a/crates/horizon-client/src/lan/guest.rs +++ b/crates/horizon-client/src/lan/guest.rs @@ -18,6 +18,16 @@ pub const CREATIVE: i32 = 1; pub const ADVENTURE: i32 = 2; pub const SPECTATOR: i32 = 3; +/// An effect as last sent in ClientboundUpdateMobEffectPacket. +#[derive(Clone, Debug, PartialEq)] +pub struct SentEffect { + pub id: &'static str, + pub amplifier: i32, + pub flags: i8, + pub duration: i32, + pub tick_count: i32, +} + pub struct Guest { pub conn: u32, /// The client's address (IP bans, `list`). @@ -92,6 +102,12 @@ pub struct Guest { pub xp_level: i32, pub xp_progress: f32, pub xp_total: i32, + /// Active status effects (`LivingEntity.activeEffects`). + pub effects: crate::effects::PlayerEffects, + /// What the client was told of each effect: id, amplifier, flags, and + /// the duration and `effects.tick_count` at the time, so a duration that + /// only counted down is not sent again (`ServerPlayer.onEffectUpdated`). + pub sent_effects: Vec, /// What the client believes the inventory menu holds (for change detection). pub menu_sent: Vec>, pub menu_state: i32, @@ -174,6 +190,8 @@ impl Guest { xp_level: 0, xp_progress: 0.0, xp_total: 0, + effects: Default::default(), + sent_effects: Vec::new(), menu_sent: vec![None; 46], menu_state: 0, sent_health: None, diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index fcae7c097..3f1f88c4a 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -9,9 +9,13 @@ use super::{ chunks::ChunkEncoder, data::SyncData, entity::EntityState, - guest::{Guest, stack_to_network}, + guest::{Guest, SentEffect, stack_to_network}, +}; +use crate::{ + effects::{EffectInstance, PlayerEffects}, + items::ItemStack, + world::World, }; -use crate::{items::ItemStack, world::World}; use horizon_protocol::ids::play::clientbound as ids; use horizon_protocol::{ entity_data::{Value, serializer}, @@ -553,11 +557,106 @@ impl Hub { })); g.center_sent = Some((cx, cz)); g.placed_at = self.ticks; + self.send_active_effects(i); // ServerPlayer.sendPostEffects and initInventoryMenu. self.guests[i].send(&raw(ids::POST_EFFECTS, vec![0])); self.send_inventory(i); } + /// ClientboundUpdateMobEffectPacket for one of the guest's effects. + fn send_effect(&mut self, i: usize, e: &EffectInstance, blend: bool) -> Option { + let effect = self + .sync + .id("minecraft:mob_effect", &format!("minecraft:{}", e.id))?; + let flags = PlayerEffects::flags(e); + let g = &self.guests[i]; + g.send(&C::UpdateMobEffect(play::UpdateMobEffect { + id: g.entity_id, + effect, + amplifier: e.amplifier, + duration: e.duration, + flags: flags | if blend { 8 } else { 0 }, + })); + Some(SentEffect { + id: e.id, + amplifier: e.amplifier, + flags, + duration: e.duration, + tick_count: g.effects.tick_count, + }) + } + + /// PlayerList.sendActivePlayerEffects: every effect, unblended, when the + /// player is placed (or respawns). + pub fn send_active_effects(&mut self, i: usize) { + let effects = self.guests[i].effects.list.clone(); + let sent = effects + .iter() + .filter_map(|e| self.send_effect(i, e, false)) + .collect(); + self.guests[i].sent_effects = sent; + } + + /// ServerPlayer.onEffectAdded (blended), onEffectUpdated and + /// 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`). + fn sync_effects(&mut self, i: usize) { + let g = &self.guests[i]; + if g.effects.list.is_empty() && g.sent_effects.is_empty() { + return; + } + let now = g.effects.tick_count; + let mut sent = Vec::with_capacity(g.effects.list.len()); + let mut changes = Vec::new(); + for e in &g.effects.list { + match g.sent_effects.iter().find(|s| s.id == e.id) { + None => changes.push((e.clone(), true)), + Some(s) => { + let ticked = now.wrapping_sub(s.tick_count); + let expected = if s.duration == -1 { + -1 + } else { + s.duration - ticked + }; + let refresh = ticked > 0 && e.duration > 0 && e.duration % 600 == 0; + if s.amplifier != e.amplifier + || s.flags != PlayerEffects::flags(e) + || e.duration != expected + || refresh + { + changes.push((e.clone(), false)); + } else { + sent.push(s.clone()); + } + } + } + } + let removed: Vec<&'static str> = g + .sent_effects + .iter() + .filter(|s| g.effects.get(s.id).is_none()) + .map(|s| s.id) + .collect(); + for id in removed { + let Some(effect) = self + .sync + .id("minecraft:mob_effect", &format!("minecraft:{id}")) + else { + continue; + }; + let g = &self.guests[i]; + g.send(&C::RemoveMobEffect(play::RemoveMobEffect { + id: g.entity_id, + effect, + })); + } + for (e, added) in changes { + sent.extend(self.send_effect(i, &e, added)); + } + self.guests[i].sent_effects = sent; + } + /// PlayerList.sendPlayerPermissionLevel: the op level as an entity event /// (24 + level), then the commands that level may use. fn send_permission_level(&self, i: usize) { @@ -789,6 +888,7 @@ impl Hub { for i in 0..self.guests.len() { if self.guests[i].placed { self.sync_player_state(i); + self.sync_effects(i); } } let latencies: Vec<_> = self @@ -1559,6 +1659,10 @@ impl Hub { spawn: info, keep: 0, })); + // The respawned player is a new one, without effects; so is the + // client's (ClientPacketListener.handleRespawn). + g.effects = Default::default(); + g.sent_effects.clear(); g.center = None; g.sent_chunks.clear(); g.chunk_queue.clear(); diff --git a/crates/horizon-client/src/lan/playerdata.rs b/crates/horizon-client/src/lan/playerdata.rs index 3554463ea..d824683d2 100644 --- a/crates/horizon-client/src/lan/playerdata.rs +++ b/crates/horizon-client/src/lan/playerdata.rs @@ -66,6 +66,7 @@ pub fn apply(guest: &mut Guest, level: &Level) { guest.xp_level = level.xp_level; guest.xp_progress = level.xp_progress; guest.xp_total = level.xp_total; + guest.effects = crate::effects::PlayerEffects::from_saved(&level.active_effects); guest.game_mode = level.mode(); guest.selected = (level.selected_slot.max(0) as usize).min(8); guest.saved = level.player_extra.clone(); @@ -119,6 +120,7 @@ pub fn store(guest: &Guest, level: &mut Level) { level.xp_level = guest.xp_level; level.xp_progress = guest.xp_progress; level.xp_total = guest.xp_total; + level.active_effects = guest.effects.saved(); level.game_mode = guest.game_mode; level.creative = guest.game_mode == 1; level.selected_slot = guest.selected as i32; diff --git a/crates/horizon-client/src/save.rs b/crates/horizon-client/src/save.rs index a3ee81912..ab3489328 100644 --- a/crates/horizon-client/src/save.rs +++ b/crates/horizon-client/src/save.rs @@ -2361,6 +2361,7 @@ impl Level { "Inventory", "EnderItems", "equipment", + "active_effects", "Pos", "respawn", "recipeBook", @@ -3191,4 +3192,19 @@ mod tests { assert!(dir.join("data/minecraft/world_gen_settings.dat").exists()); let _ = fs::remove_dir_all(&dir); } + + #[test] + fn effects_that_ended_are_not_saved_again() { + // A player loaded with an effect that has since run out: the loaded + // compound still holds it, but the save writes only what is active. + let mut level = Level { + active_effects: vec![("minecraft:speed".into(), 200, 1, false, true)], + ..Level::default() + }; + let loaded = level.player_tag(); + assert!(loaded.get("active_effects").is_some()); + level.player_extra = Some(loaded); + level.active_effects.clear(); + assert!(level.player_tag().get("active_effects").is_none()); + } } From 361c994d98b44ae94edb8e8bc130022c8760dc72 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 00:23:01 +0200 Subject: [PATCH 15/59] Draw the columns vanilla draws: ChunkTrackingView.isInViewDistance MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Vanilla draws a section when its column is within the render distance of the camera's column with a column of slack on each axis (SectionOcclusionGraph.isInViewDistance → ChunkTrackingView): 533 columns at render distance 12. Horizon meshed a circle of radius 12 (441 columns) and drew sections whose centre lay within 16 x distance + 24 blocks, so the edge of the world, mostly in fog, missed columns vanilla shows, and fell short of vanilla's corners. `streaming::in_view_distance` is vanilla's test. Streaming meshes the columns it accepts around the player (and forced ones), and the renderer's column walk draws the ones it accepts around the camera. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/gfx.rs | 2 +- crates/horizon-client/src/gfx/resident.rs | 58 ++++++++++++----------- crates/horizon-client/src/streaming.rs | 49 ++++++++++++++++--- 3 files changed, 74 insertions(+), 35 deletions(-) diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 4401ea22d..f64200e5c 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -2217,7 +2217,7 @@ impl Renderer { visible.clear(); self.sections.visible( camera, - frame.distance, + (frame.distance / 16.0) as i32, &view, |k| !culling || reachable.contains(k), &mut visible, diff --git a/crates/horizon-client/src/gfx/resident.rs b/crates/horizon-client/src/gfx/resident.rs index 58e187090..71e6a5527 100644 --- a/crates/horizon-client/src/gfx/resident.rs +++ b/crates/horizon-client/src/gfx/resident.rs @@ -3,7 +3,7 @@ //! the render distance rejects all of its sections with one test, and the //! sections that remain are reached by index rather than by hashing keys. use super::{Frustum, SectionKey}; -use crate::fast_hash::FxHashMap; +use crate::{fast_hash::FxHashMap, streaming::in_view_distance}; use glam::{DVec3, Vec3}; /// One chunk column's resident sections. @@ -149,26 +149,28 @@ fn origin(key: SectionKey, camera: DVec3) -> DVec3 { ) - camera } -/// Whether the section at `key` is drawn: within `distance` blocks of the -/// camera horizontally (plus a section and a half), and partly inside the -/// frustum. `None` when it is not, else its squared centre distance and origin. -fn in_view( - key: SectionKey, - camera: DVec3, - distance: f32, - frustum: &Frustum, -) -> Option<(f64, Vec3)> { - let origin = origin(key, camera); - let center = origin + DVec3::splat(8.0); - let horizontal = (center.x * center.x + center.z * center.z).sqrt(); - if horizontal > f64::from(distance) + 24.0 { +/// The camera's chunk column. +fn camera_column(camera: DVec3) -> (i32, i32) { + ( + (camera.x.floor() as i32) >> 4, + (camera.z.floor() as i32) >> 4, + ) +} + +/// Whether the section at `key` is drawn: its column within the render +/// distance of the camera's (`SectionOcclusionGraph.isInViewDistance`), and +/// partly inside the frustum. `None` when it is not, else its squared centre +/// distance and origin. +fn in_view(key: SectionKey, camera: DVec3, radius: i32, frustum: &Frustum) -> Option<(f64, Vec3)> { + if !in_view_distance(camera_column(camera), radius, key.0, key.2) { return None; } + let origin = origin(key, camera); let min = origin.as_vec3(); if !frustum.intersects(min, min + Vec3::splat(16.0)) { return None; } - Some((center.length_squared(), min)) + Some(((origin + DVec3::splat(8.0)).length_squared(), min)) } impl Resident { @@ -178,22 +180,22 @@ impl Resident { /// Columns are tested first, with the same distance test (it depends /// only on x and z) and a box spanning their sections: every section box /// lies inside it and the frustum test rounds monotonically, so a column - /// the frustum rejects holds no section it would accept. + /// the frustum rejects holds no section it would accept. `radius` is the + /// render distance in chunks. pub fn visible( &self, camera: DVec3, - distance: f32, + radius: i32, frustum: &Frustum, reachable: impl Fn(SectionKey) -> bool, out: &mut Vec, ) { + let from = camera_column(camera); for column in &self.columns { - let low = origin((column.x, column.low, column.z), camera); - let center = low + DVec3::splat(8.0); - if (center.x * center.x + center.z * center.z).sqrt() > f64::from(distance) + 24.0 { + if !in_view_distance(from, radius, column.x, column.z) { continue; } - let min = low.as_vec3(); + let min = origin((column.x, column.low, column.z), camera).as_vec3(); let top = origin((column.x, column.high, column.z), camera).as_vec3(); if !frustum.intersects(min, top + Vec3::splat(16.0)) { continue; @@ -203,7 +205,7 @@ impl Resident { if !reachable(key) { continue; } - if let Some((d, o)) = in_view(key, camera, distance, frustum) { + if let Some((d, o)) = in_view(key, camera, radius, frustum) { out.push(Visible { distance: d.to_bits(), key, @@ -243,20 +245,20 @@ mod tests { (DVec3::new(8.0, 64.0, 8.0), 45.0, 89.0), ]; for (camera, yaw, pitch) in cameras { - for distance in [32.0, 96.0, 160.0] { + for radius in [2, 6, 10] { let projection = super::super::world_projection(70.0, 16.0 / 9.0, 512.0); let view = crate::camera::view_matrix(yaw, pitch); let frustum = Frustum { planes: super::super::frustum(projection * view), }; let mut fast = Vec::new(); - r.visible(camera, distance, &frustum, reachable, &mut fast); + r.visible(camera, radius, &frustum, reachable, &mut fast); let mut slow: Vec<(SectionKey, f64, [f32; 3])> = r .items .iter() .filter(|(k, _)| reachable(*k)) .filter_map(|(k, _)| { - in_view(*k, camera, distance, &frustum).map(|(d, o)| (*k, d, o.to_array())) + in_view(*k, camera, radius, &frustum).map(|(d, o)| (*k, d, o.to_array())) }) .collect(); slow.sort_unstable_by(|a, b| a.1.total_cmp(&b.1).then(a.0.cmp(&b.0))); @@ -268,7 +270,7 @@ mod tests { }) .collect(); assert!(!slow.is_empty()); - assert_eq!(fast, slow, "{camera} {yaw} {pitch} {distance}"); + assert_eq!(fast, slow, "{camera} {yaw} {pitch} {radius}"); } } } @@ -356,7 +358,7 @@ mod tests { let t = Instant::now(); keys.clear(); keys.extend(map.keys().filter_map(|&k| { - in_view(k, camera, 512.0, &frustum).map(|(d, o)| (k, d, o.to_array())) + in_view(k, camera, 32, &frustum).map(|(d, o)| (k, d, o.to_array())) })); keys.sort_unstable_by(|a, b| a.1.total_cmp(&b.1)); for (k, _, _) in &keys { @@ -365,7 +367,7 @@ mod tests { old = old.min(t.elapsed()); let t = Instant::now(); list.clear(); - r.visible(camera, 512.0, &frustum, |_| true, &mut list); + r.visible(camera, 32, &frustum, |_| true, &mut list); for v in &list { sum += i64::from(r.get(v.slot)[1] + r.get(v.slot)[0]); } diff --git a/crates/horizon-client/src/streaming.rs b/crates/horizon-client/src/streaming.rs index df1001640..994316324 100644 --- a/crates/horizon-client/src/streaming.rs +++ b/crates/horizon-client/src/streaming.rs @@ -968,7 +968,8 @@ impl Streaming { return (uploads, removed); } // Meshing once the column and its neighbours are lit, and the column - // is within the render distance. Sections set aside past it come back + // is within the render distance (`in_view_distance`, the columns + // vanilla draws). Sections set aside past it come back // when the player moves: a column that loads with its light gets no // other request (#228). let area = (self.center, self.radius, self.forced.len()); @@ -981,7 +982,7 @@ impl Streaming { forced: &self.forced, }; self.waiting.retain(|&(x, sy, z)| { - let back = ranges.in_main_range(x, z, 0); + let back = ranges.in_view(x, z); if back { world.dirty_sections.insert((x, sy, z)); } @@ -996,7 +997,7 @@ impl Streaming { world.dirty_sections.remove(&(x, sy, z)); continue; } - if !self.in_main_range(x, z, 0) { + if !self.ranges().in_view(x, z) { world.dirty_sections.remove(&(x, sy, z)); self.waiting.insert((x, sy, z)); continue; @@ -1204,9 +1205,15 @@ impl Streaming { fn in_range(&self, x: i32, z: i32, margin: i32) -> bool { self.ranges().in_range(x, z, margin) } - fn in_main_range(&self, x: i32, z: i32, margin: i32) -> bool { - self.ranges().in_main_range(x, z, margin) - } +} +/// `ChunkTrackingView.isInViewDistance`: whether the column (x, z) is drawn +/// at this render distance around `center`, the camera's column +/// (`SectionOcclusionGraph.isInViewDistance`). Each axis gets a column of +/// slack, so this reaches past the circle of `radius` columns. +pub fn in_view_distance(center: (i32, i32), radius: i32, x: i32, z: i32) -> bool { + let gap = |d: i32| i64::from((d.abs() - 1).max(0)); + let (dx, dz) = (gap(x - center.0), gap(z - center.1)); + dx * dx + dz * dz < i64::from(radius) * i64::from(radius) } /// The areas kept loaded: circles around the player and `extra`, and forced chunks. struct Ranges<'a> { @@ -1271,6 +1278,11 @@ impl Ranges<'_> { dx * dx + dz * dz <= r * r }) } + /// The columns meshed for drawing: those vanilla draws around the + /// player (`in_view_distance`), and forced ones. + fn in_view(&self, x: i32, z: i32) -> bool { + in_view_distance(self.center, self.radius, x, z) || self.forced.contains(&(x, z)) + } fn in_main_range(&self, x: i32, z: i32, margin: i32) -> bool { let r = i64::from(self.radius + margin); let (dx, dz) = (i64::from(x - self.center.0), i64::from(z - self.center.1)); @@ -1306,6 +1318,31 @@ impl Drop for Streaming { mod tests { use super::*; + #[test] + fn view_distance_is_vanillas_shape() { + // ChunkTrackingView.isInViewDistance at render distance 12: a column + // of slack on each axis, so 533 columns rather than the 441 of a + // circle of radius 12. + let count = |r: i32| { + (-40..=40) + .flat_map(|x| (-40..=40).map(move |z| (x, z))) + .filter(|&(x, z)| in_view_distance((5, -7), r, x + 5, z - 7)) + .count() + }; + assert_eq!(count(12), 533); + assert_eq!(count(2), 25); + for (x, z, inside) in [(12, 0, true), (13, 0, false), (9, 9, true), (10, 9, false)] { + assert_eq!(in_view_distance((0, 0), 12, x, z), inside, "({x}, {z})"); + assert_eq!( + in_view_distance((0, 0), 12, -z, -x), + inside, + "({}, {})", + -z, + -x + ); + } + } + struct GenerationFixture { world: World, center: (i32, i32), From e5fcdaaec658693744e5ca82e5133529e58f9ae9 Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 18:26:12 -0400 Subject: [PATCH 16/59] Show full equipment tooltips in Creative item tabs --- crates/horizon-client/src/game.rs | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 7072abeb5..c65c00d25 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -7999,7 +7999,7 @@ impl Game<'_> { self.creative_screen.search_focused.elapsed().as_millis(), ); } - let mut hovered: Option = None; + let mut hovered: Option = None; if tab.inventory { self.draw_player_preview( batch, @@ -8049,7 +8049,7 @@ impl Game<'_> { && self.cursor.1 < y + 16.0 { batch.fill(&self.res.atlas, x, y, 16.0, 16.0, rgba(255, 255, 255, 128)); - hovered = Some(stack.item.to_string()); + hovered = Some(stack.clone()); } } } @@ -8064,7 +8064,7 @@ impl Game<'_> { && self.cursor.1 >= y && self.cursor.1 < y + 16.0 { - hovered = Some(stack.item.to_string()); + hovered = Some(stack); } } let scrollable = self.creative_screen.rows(&self.res.names) > 5; @@ -8100,8 +8100,8 @@ impl Game<'_> { } else if self.carried.is_none() && let Some(item) = hovered { - let name = self.res.names.item(&item); - self.tooltip(batch, &name, self.cursor.0, self.cursor.1); + let lines = self.stack_tooltip(&item); + self.draw_tooltip_lines(batch, &lines, self.cursor.0, self.cursor.1); } self.draw_inventory_effects(batch, (ox, oy), Creative::WIDTH as i32); } From e6068b124695ca711a8d93798f6081117113aade Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 18:51:25 -0400 Subject: [PATCH 17/59] Remember Direct Connection addresses in both menus --- crates/horizon-client/src/front.rs | 25 ++++++++++++- crates/horizon-client/src/game.rs | 8 ++++- crates/horizon-client/src/game/options.rs | 11 ++++++ crates/horizon-client/src/game/pad.rs | 1 + crates/horizon-client/src/game/remote.rs | 1 + crates/horizon-client/src/title.rs | 44 ++++++++++++++++++----- crates/horizon-client/src/title/tests.rs | 35 ++++++++++++++++++ 7 files changed, 114 insertions(+), 11 deletions(-) diff --git a/crates/horizon-client/src/front.rs b/crates/horizon-client/src/front.rs index 7b1771000..5b0a2c5ab 100644 --- a/crates/horizon-client/src/front.rs +++ b/crates/horizon-client/src/front.rs @@ -318,6 +318,7 @@ impl Title { x: f32, y: f32, ) -> Action { + self.remember_direct_address(); if self.skip_opening() { return Action::None; } @@ -472,7 +473,7 @@ impl Title { _ => None, }; if let Some(id) = id { - match screen.click(Some(id), 0.0, 0.0, (0.0, 0.0), &saves) { + match self.multiplayer_click(Some(id), 0.0, 0.0, (0.0, 0.0)) { Outcome::Back => self.mode = Mode::Main, Outcome::Connect(address) => return Action::Connect { address }, Outcome::None => {} @@ -1432,6 +1433,28 @@ mod tests { } } + #[test] + fn horizon_direct_connection_remembers_the_address_after_leaving() { + let atlas = + HudAtlas::build(std::path::Path::new("/nonexistent/horizon-test-assets")).unwrap(); + let saves = + std::env::temp_dir().join(format!("horizon-front-direct-{}", std::process::id())); + let mut title = Title::new(saves.clone(), &saves); + title.last_server = "localhost:25566".into(); + title.mode = Mode::Multiplayer(Screen::list(&saves)); + press(&mut title, &atlas, DIRECT); + assert_eq!(title.focused_field().unwrap().1, "localhost:25566"); + *title.focused_field().unwrap().1 = "example.org:25567".into(); + press(&mut title, &atlas, BACK); + press(&mut title, &atlas, DIRECT); + assert_eq!(title.focused_field().unwrap().1, "example.org:25567"); + *title.focused_field().unwrap().1 = "localhost:25568".into(); + press(&mut title, &atlas, NAV); + press(&mut title, &atlas, NAV + 2); + press(&mut title, &atlas, DIRECT); + assert_eq!(title.focused_field().unwrap().1, "localhost:25568"); + } + #[test] fn horizon_world_delete_confirms_and_keeps_the_selection_in_place() { let atlas = diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index b640c789d..e552eb118 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -6637,6 +6637,9 @@ impl Game<'_> { std::env::current_dir()?.join("saves"), &self.options.resources, )); + if let Some(title) = &mut self.title { + title.last_server = self.settings.file.string("lastServer"); + } self.capture(false); Ok(()) } @@ -9304,6 +9307,7 @@ impl ApplicationHandler for Game<'_> { clicked } }); + self.save_title_options(); if sound { self.audio.play_button_click(); } @@ -9542,6 +9546,7 @@ impl ApplicationHandler for Game<'_> { if let Some(t) = self.title.as_mut() { t.escape(); } + self.save_title_options(); } _ => self.title_edit(event.text.as_deref(), false), } @@ -10325,10 +10330,11 @@ pub fn run() -> Result<()> { game.open_world(&folder, None, Some(seed), creative, None)?; } None => { - let title = Title::new( + let mut title = Title::new( std::env::current_dir()?.join("saves"), &game.options.resources, ); + title.last_server = game.settings.file.string("lastServer"); // The launcher's opening, once per session and only in Horizon's style. if horizon_client::ui_theme::horizon() && game.options.frames.is_none() { title diff --git a/crates/horizon-client/src/game/options.rs b/crates/horizon-client/src/game/options.rs index 25eb6eb96..dcc7bb23b 100644 --- a/crates/horizon-client/src/game/options.rs +++ b/crates/horizon-client/src/game/options.rs @@ -17,6 +17,17 @@ pub(super) const CONTROL_HELP: &[&str] = &[ ]; impl Game<'_> { + pub(super) fn save_title_options(&mut self) { + if let Some(title) = &self.title + && title.last_server != self.settings.file.string("lastServer") + { + self.settings.file.set( + "lastServer", + horizon_client::options_file::V::Str(title.last_server.clone()), + ); + self.settings.save(&Self::options_path()); + } + } /// `options-get` and `options-set`; None for other commands. pub(super) fn options_control(&mut self, words: &[&str], line: &str) -> Result> { match words[0] { diff --git a/crates/horizon-client/src/game/pad.rs b/crates/horizon-client/src/game/pad.rs index cae85bc6c..62d481b11 100644 --- a/crates/horizon-client/src/game/pad.rs +++ b/crates/horizon-client/src/game/pad.rs @@ -354,6 +354,7 @@ impl Game<'_> { } if let Some(title) = self.title.as_mut() { title.escape(); + self.save_title_options(); return Ok(()); } if self.sign_edit.is_some() { diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index e31e270b8..f5eeba995 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -330,6 +330,7 @@ impl Game<'_> { } let saves = std::env::current_dir()?.join("saves"); let mut title = horizon_client::title::Title::new(saves.clone(), &self.options.resources); + title.last_server = self.settings.file.string("lastServer"); if single_player && reason.is_none() { self.title = Some(title); self.capture(false); diff --git a/crates/horizon-client/src/title.rs b/crates/horizon-client/src/title.rs index 2a9f0fdf9..47a4a233d 100644 --- a/crates/horizon-client/src/title.rs +++ b/crates/horizon-client/src/title.rs @@ -125,6 +125,8 @@ pub enum Action { } pub struct Title { pub mode: Mode, + /// Direct Connection's address, synchronized with `options.txt`'s `lastServer`. + pub last_server: String, pub saves: PathBuf, pub started: std::time::Instant, search: String, @@ -232,6 +234,7 @@ impl Title { Self { shown: std::cell::Cell::new((std::mem::discriminant(&mode), now)), mode, + last_server: String::new(), saves, started: now, search: String::new(), @@ -1162,6 +1165,7 @@ impl Title { /// The action and whether to play `AbstractWidget.playButtonClickSound`. /// Navigation buttons can return `Action::None` while still sounding. pub fn click(&mut self, x: f32, y: f32, size: (f32, f32)) -> (Action, bool) { + self.remember_direct_address(); let (w, h) = (size.0.ceil(), size.1.ceil()); // MenuTabBar: a new tab clears the focus and clicks. if let Mode::Create { focus, options, .. } = &mut self.mode @@ -1195,16 +1199,14 @@ impl Title { self.mode = Mode::Multiplayer(crate::multiplayer::Screen::list(&self.saves)); Action::None } - (Mode::Multiplayer(screen), hit) => { - match screen.click(hit, x, y, (w, h), &self.saves) { - crate::multiplayer::Outcome::Back => { - self.mode = Mode::Main; - Action::None - } - crate::multiplayer::Outcome::Connect(address) => Action::Connect { address }, - crate::multiplayer::Outcome::None => Action::None, + (Mode::Multiplayer(_), hit) => match self.multiplayer_click(hit, x, y, (w, h)) { + crate::multiplayer::Outcome::Back => { + self.mode = Mode::Main; + Action::None } - } + crate::multiplayer::Outcome::Connect(address) => Action::Connect { address }, + crate::multiplayer::Outcome::None => Action::None, + }, (Mode::Main, Some(3)) => Action::Options, (Mode::Main, Some(7)) => Action::Accessibility, (Mode::Main, Some(6)) => Action::Language, @@ -1512,7 +1514,31 @@ impl Title { _ => None, } } + pub(crate) fn remember_direct_address(&mut self) { + if let Mode::Multiplayer(crate::multiplayer::Screen::Direct { address }) = &self.mode { + self.last_server.clone_from(address); + } + } + pub(crate) fn multiplayer_click( + &mut self, + hit: Option, + x: f32, + y: f32, + size: (f32, f32), + ) -> crate::multiplayer::Outcome { + let Mode::Multiplayer(screen) = &mut self.mode else { + return crate::multiplayer::Outcome::None; + }; + let outcome = screen.click(hit, x, y, size, &self.saves); + if hit == Some(41) + && let crate::multiplayer::Screen::Direct { address } = screen + { + address.clone_from(&self.last_server); + } + outcome + } pub fn escape(&mut self) { + self.remember_direct_address(); if let Mode::Multiplayer(screen) = &mut self.mode && !screen.escape(&self.saves) { diff --git a/crates/horizon-client/src/title/tests.rs b/crates/horizon-client/src/title/tests.rs index 4f759f960..572be2ef2 100644 --- a/crates/horizon-client/src/title/tests.rs +++ b/crates/horizon-client/src/title/tests.rs @@ -82,6 +82,41 @@ impl Drop for Fixture { } } +#[test] +fn direct_connection_remembers_the_address_on_cancel_escape_and_join() { + let mut f = Fixture::new(); + f.title.last_server = "localhost:25566".into(); + f.click("Multiplayer"); + f.click("Direct Connection"); + assert_eq!(f.title.focused_field().unwrap().1, "localhost:25566"); + + *f.title.focused_field().unwrap().1 = "example.org:25567".into(); + f.click("Cancel"); + f.click("Direct Connection"); + assert_eq!(f.title.focused_field().unwrap().1, "example.org:25567"); + + *f.title.focused_field().unwrap().1 = "[::1]:25568".into(); + f.title.escape(); + f.title.escape(); + f.click("Multiplayer"); + f.click("Direct Connection"); + assert_eq!(f.title.focused_field().unwrap().1, "[::1]:25568"); + + *f.title.focused_field().unwrap().1 = "localhost:25569".into(); + assert_eq!( + f.click("Join Server"), + Action::Connect { + address: "localhost:25569".into(), + } + ); + assert_eq!(f.title.last_server, "localhost:25569"); + + f.title.focused_field().unwrap().1.clear(); + f.title.escape(); + f.click("Direct Connection"); + assert!(f.title.focused_field().unwrap().1.is_empty()); +} + #[test] fn empty_singleplayer_opens_creation_and_cancel_returns_to_title() { let mut f = Fixture::new(); From 43d5ed8246043994a51b6cfbb3fc12775486ea3e Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 18:52:00 -0400 Subject: [PATCH 18/59] Play menu button clicks after world teardown --- crates/horizon-client/src/game/screens.rs | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/crates/horizon-client/src/game/screens.rs b/crates/horizon-client/src/game/screens.rs index ac4d16274..586e21879 100644 --- a/crates/horizon-client/src/game/screens.rs +++ b/crates/horizon-client/src/game/screens.rs @@ -149,9 +149,6 @@ impl Game<'_> { .find(|b| b.5 && ui::hovered(self.cursor, b.0, b.1, b.2, 20.0)) .map(|b| b.4) }; - if hit.is_some() && !horizon_client::ui_theme::horizon() { - self.audio.play_button_click(); - } match hit { Some(0) => { self.screen = Screen::Playing; @@ -171,6 +168,9 @@ impl Game<'_> { Some(2) => self.close_world()?, _ => {} } + if hit.is_some() && !horizon_client::ui_theme::horizon() { + self.audio.play_button_click(); + } Ok(()) } /// DeathScreen: gradient, the title at double size, the cause and score. @@ -263,9 +263,6 @@ impl Game<'_> { .into_iter() .find(|d| ui::hovered(self.cursor, d.0, d.1, 200.0, 20.0)) .map(|d| d.3); - if hit.is_some() { - self.audio.play_button_click(); - } match hit { Some(0) if self.remote.is_some() => { self.ui.death_text = None; @@ -295,6 +292,9 @@ impl Game<'_> { Some(1) => self.close_world()?, _ => {} } + if hit.is_some() { + self.audio.play_button_click(); + } Ok(()) } } From 7384db307d5f9be26ddd5f5a1f31cf2260c542cb Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 01:10:35 +0200 Subject: [PATCH 19/59] Block textures: share identical sprites, and draw past 2048 layers Every block sprite is a layer of one texture array, and GPUs give an array at most 2048 layers (Metal, most Vulkan drivers). Vanilla takes 1250; eight real NeoForge mods carried over (docs/modpacks.md) take 2183, and the game stopped at start with "GPU supports 2048 texture layers; 2200 required". - Sprites: a still texture with the same pixels and mip settings as one already loaded reuses its layer (mods copy vanilla's textures under their own names): 17 layers fewer for those mods, none for vanilla. - The renderer splits the layers over up to four arrays of 2048 (8192 sprites). terrain.wgsl picks the array per fragment with derivatives taken in uniform control flow; a pipeline constant keeps vanilla, which needs one array, on the same single textureSample as before. - HORIZON_SPRITE_SPLIT (dev only) forces a smaller split: vanilla drawn from three arrays of 512 renders the same blocks as from one. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/assets.rs | 2 +- crates/horizon-client/src/gfx.rs | 311 ++++++++++++++++--------- crates/horizon-client/src/sprites.rs | 136 ++++++++--- crates/horizon-client/src/terrain.wgsl | 27 ++- 4 files changed, 328 insertions(+), 148 deletions(-) diff --git a/crates/horizon-client/src/assets.rs b/crates/horizon-client/src/assets.rs index 351d57d45..b8551a059 100644 --- a/crates/horizon-client/src/assets.rs +++ b/crates/horizon-client/src/assets.rs @@ -245,7 +245,7 @@ impl Assets { material_states, sprite_size: sprites.size, sprite_minimum_size: sprites.minimum_size, - texture_layers: u32::try_from(sprites.layers.len())?, + texture_layers: u32::try_from(sprites.count())?, pixels: sprites.pixels, model_catalog: models.catalog, model_library, diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 4401ea22d..e69106e6b 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -290,7 +290,13 @@ pub struct Renderer { group: wgpu::BindGroup, globals: wgpu::Buffer, lightmap: wgpu::Texture, - sprite_texture: wgpu::Texture, + /// The block sprites, [`SPRITE_SPLIT`] layers per array (the first is + /// `sprites` in terrain.wgsl, the others `sprites_1`...). + sprite_textures: Vec, + /// A 1-layer array bound where a pack needs fewer arrays. + sprite_unused: wgpu::TextureView, + /// Layers per sprite array ([`SPRITE_SPLIT`] but in tests). + sprite_split: u32, mip_levels: u32, /// The mipmap levels sampled (the Mipmap Levels option), at most `mip_levels - 1`. mipmaps: u32, @@ -354,6 +360,79 @@ pub struct Renderer { } /// Every layer's mip levels, layer major (`first` is the first layer's /// index into `settings`), made by `MipmapGenerator`. +/// Block sprite layers per texture array: the smallest +/// `max_texture_array_layers` of the GPUs Horizon runs on. Mods add sprites +/// past it into more arrays (terrain.wgsl's `sprite`). +pub(crate) const SPRITE_SPLIT: u32 = 2048; +/// [`SPRITE_SPLIT`], or a smaller split from `HORIZON_SPRITE_SPLIT` (dev +/// only: vanilla's sprites drawn from several arrays must look the same). +fn sprite_split() -> u32 { + std::env::var("HORIZON_SPRITE_SPLIT") + .ok() + .and_then(|v| v.parse().ok()) + .filter(|&n| (1..=SPRITE_SPLIT).contains(&n)) + .unwrap_or(SPRITE_SPLIT) +} +/// Sprite arrays terrain.wgsl binds (`sprites`, `sprites_1`...). +const SPRITE_ARRAYS: u32 = 4; +/// The views of terrain.wgsl's sprite arrays, the unused ones a 1-layer +/// stand-in. +fn sprite_views( + textures: &[wgpu::Texture], + unused: &wgpu::TextureView, + mips: Option, +) -> Vec { + (0..SPRITE_ARRAYS as usize) + .map(|i| match textures.get(i) { + Some(t) => t.create_view(&wgpu::TextureViewDescriptor { + dimension: Some(wgpu::TextureViewDimension::D2Array), + mip_level_count: mips, + ..Default::default() + }), + None => unused.clone(), + }) + .collect() +} +/// terrain.wgsl's group 0. +#[allow(clippy::too_many_arguments)] +fn terrain_group( + device: &wgpu::Device, + label: &str, + layout: &wgpu::BindGroupLayout, + globals: &wgpu::Buffer, + sprites: &[wgpu::TextureView], + sprite_sampler: &wgpu::Sampler, + lightmap: &wgpu::TextureView, + lightmap_sampler: &wgpu::Sampler, +) -> wgpu::BindGroup { + let view = |binding, view| wgpu::BindGroupEntry { + binding, + resource: wgpu::BindingResource::TextureView(view), + }; + device.create_bind_group(&wgpu::BindGroupDescriptor { + label: Some(label), + layout, + entries: &[ + wgpu::BindGroupEntry { + binding: 0, + resource: globals.as_entire_binding(), + }, + view(1, &sprites[0]), + wgpu::BindGroupEntry { + binding: 2, + resource: wgpu::BindingResource::Sampler(sprite_sampler), + }, + view(3, lightmap), + wgpu::BindGroupEntry { + binding: 4, + resource: wgpu::BindingResource::Sampler(lightmap_sampler), + }, + view(5, &sprites[1]), + view(6, &sprites[2]), + view(7, &sprites[3]), + ], + }) +} fn mip_chain( pixels: &[u8], size: u32, @@ -494,10 +573,19 @@ impl Renderer { ), ); let limits = adapter.limits(); - if limits.max_texture_array_layers < layers { + let split = sprite_split(); + if layers > split * SPRITE_ARRAYS { return Err(format!( - "GPU supports {} texture layers; {layers} required", - limits.max_texture_array_layers + "{layers} block textures; Horizon draws at most {}", + split * SPRITE_ARRAYS + ) + .into()); + } + if limits.max_texture_array_layers < layers.min(split) { + return Err(format!( + "GPU supports {} texture layers; {} required", + limits.max_texture_array_layers, + layers.min(split) ) .into()); } @@ -565,6 +653,19 @@ impl Renderer { count: None, }; let vf = wgpu::ShaderStages::VERTEX_FRAGMENT; + let sprite_array = wgpu::BindingType::Texture { + sample_type: wgpu::TextureSampleType::Float { filterable: true }, + view_dimension: wgpu::TextureViewDimension::D2Array, + multisampled: false, + }; + let sprite_arrays = layers.div_ceil(split).max(1); + if sprite_arrays > 1 { + log::info!("Horizon: {layers} block textures in {sprite_arrays} arrays"); + } + let sprite_constants = [ + ("SPRITE_ARRAYS", f64::from(sprite_arrays)), + ("SPRITE_SPLIT", f64::from(split)), + ]; let bindings = device.create_bind_group_layout(&wgpu::BindGroupLayoutDescriptor { label: Some("Horizon terrain bindings"), entries: &[ @@ -605,6 +706,9 @@ impl Renderer { vf, wgpu::BindingType::Sampler(wgpu::SamplerBindingType::Filtering), ), + entry(5, vf, sprite_array), + entry(6, vf, sprite_array), + entry(7, vf, sprite_array), ], }); let layout = device.create_pipeline_layout(&wgpu::PipelineLayoutDescriptor { @@ -677,7 +781,10 @@ impl Renderer { fragment: Some(wgpu::FragmentState { module: &shader, entry_point: Some(fragment), - compilation_options: Default::default(), + compilation_options: wgpu::PipelineCompilationOptions { + constants: &sprite_constants, + ..Default::default() + }, targets: &[Some(wgpu::ColorTargetState { format: config.format.remove_srgb_suffix(), blend, @@ -784,30 +891,62 @@ impl Renderer { usage: wgpu::BufferUsages::UNIFORM | wgpu::BufferUsages::COPY_DST, mapped_at_creation: false, }); - let (mips, mip_levels) = mip_chain(sprite_pixels, sprite_size, sprite_mips, 0, layers); - let sprite_texture = device.create_texture_with_data( - &queue, - &wgpu::TextureDescriptor { - label: Some("Block sprites"), + let layer_bytes = (sprite_size * sprite_size * 4) as usize; + let mut mip_levels = 1; + let sprite_textures: Vec = (0..sprite_arrays) + .map(|array| { + let first = array * split; + let count = layers.saturating_sub(first).clamp(1, split); + let start = (first as usize * layer_bytes).min(sprite_pixels.len()); + let (mips, levels) = mip_chain( + &sprite_pixels[start..], + sprite_size, + sprite_mips, + first, + count, + ); + mip_levels = levels; + device.create_texture_with_data( + &queue, + &wgpu::TextureDescriptor { + label: Some("Block sprites"), + size: wgpu::Extent3d { + width: sprite_size, + height: sprite_size, + depth_or_array_layers: count, + }, + mip_level_count: levels, + sample_count: 1, + dimension: wgpu::TextureDimension::D2, + format: wgpu::TextureFormat::Rgba8Unorm, + usage: wgpu::TextureUsages::TEXTURE_BINDING | wgpu::TextureUsages::COPY_DST, + view_formats: &[], + }, + wgpu::util::TextureDataOrder::LayerMajor, + &mips, + ) + }) + .collect(); + let sprite_unused = device + .create_texture(&wgpu::TextureDescriptor { + label: Some("Block sprites (unused)"), size: wgpu::Extent3d { - width: sprite_size, - height: sprite_size, - depth_or_array_layers: layers, + width: 1, + height: 1, + depth_or_array_layers: 1, }, - mip_level_count: mip_levels, + mip_level_count: 1, sample_count: 1, dimension: wgpu::TextureDimension::D2, format: wgpu::TextureFormat::Rgba8Unorm, - usage: wgpu::TextureUsages::TEXTURE_BINDING | wgpu::TextureUsages::COPY_DST, + usage: wgpu::TextureUsages::TEXTURE_BINDING, view_formats: &[], - }, - wgpu::util::TextureDataOrder::LayerMajor, - &mips, - ); - let sprite_view = sprite_texture.create_view(&wgpu::TextureViewDescriptor { - dimension: Some(wgpu::TextureViewDimension::D2Array), - ..Default::default() - }); + }) + .create_view(&wgpu::TextureViewDescriptor { + dimension: Some(wgpu::TextureViewDimension::D2Array), + ..Default::default() + }); + let sprite_views = sprite_views(&sprite_textures, &sprite_unused, None); let sprite_sampler = device.create_sampler(&wgpu::SamplerDescriptor { label: Some("Block sprites"), address_mode_u: wgpu::AddressMode::Repeat, @@ -838,58 +977,26 @@ impl Renderer { min_filter: wgpu::FilterMode::Linear, ..Default::default() }); - let group = device.create_bind_group(&wgpu::BindGroupDescriptor { - label: Some("Horizon terrain resources"), - layout: &bindings, - entries: &[ - wgpu::BindGroupEntry { - binding: 0, - resource: globals.as_entire_binding(), - }, - wgpu::BindGroupEntry { - binding: 1, - resource: wgpu::BindingResource::TextureView(&sprite_view), - }, - wgpu::BindGroupEntry { - binding: 2, - resource: wgpu::BindingResource::Sampler(&sprite_sampler), - }, - wgpu::BindGroupEntry { - binding: 3, - resource: wgpu::BindingResource::TextureView(&lightmap_view), - }, - wgpu::BindGroupEntry { - binding: 4, - resource: wgpu::BindingResource::Sampler(&lightmap_sampler), - }, - ], - }); - let crosshair_group = device.create_bind_group(&wgpu::BindGroupDescriptor { - label: Some("Debug crosshair resources"), - layout: &bindings, - entries: &[ - wgpu::BindGroupEntry { - binding: 0, - resource: crosshair_globals.as_entire_binding(), - }, - wgpu::BindGroupEntry { - binding: 1, - resource: wgpu::BindingResource::TextureView(&sprite_view), - }, - wgpu::BindGroupEntry { - binding: 2, - resource: wgpu::BindingResource::Sampler(&sprite_sampler), - }, - wgpu::BindGroupEntry { - binding: 3, - resource: wgpu::BindingResource::TextureView(&lightmap_view), - }, - wgpu::BindGroupEntry { - binding: 4, - resource: wgpu::BindingResource::Sampler(&lightmap_sampler), - }, - ], - }); + let group = terrain_group( + &device, + "Horizon terrain resources", + &bindings, + &globals, + &sprite_views, + &sprite_sampler, + &lightmap_view, + &lightmap_sampler, + ); + let crosshair_group = terrain_group( + &device, + "Debug crosshair resources", + &bindings, + &crosshair_globals, + &sprite_views, + &sprite_sampler, + &lightmap_view, + &lightmap_sampler, + ); let index_quads = 1 << 16; let indices = Self::quad_indices(&device, index_quads); let instance_capacity = 4096; @@ -1575,7 +1682,9 @@ impl Renderer { group, globals, lightmap, - sprite_texture, + sprite_textures, + sprite_unused, + sprite_split: split, mip_levels, mipmaps: mip_levels - 1, terrain_layout: bindings, @@ -1864,7 +1973,7 @@ impl Renderer { pub fn set_mipmap_levels(&mut self, levels: u32) { let levels = sprite_mipmap_limit( levels, - self.sprite_texture.width(), + self.sprite_textures[0].width(), self.sprite_minimum_size, self.mip_levels, ); @@ -1872,39 +1981,17 @@ impl Renderer { return; } self.mipmaps = levels; - let sprite_view = self - .sprite_texture - .create_view(&wgpu::TextureViewDescriptor { - dimension: Some(wgpu::TextureViewDimension::D2Array), - mip_level_count: Some(levels + 1), - ..Default::default() - }); - self.group = self.device.create_bind_group(&wgpu::BindGroupDescriptor { - label: Some("Horizon terrain resources"), - layout: &self.terrain_layout, - entries: &[ - wgpu::BindGroupEntry { - binding: 0, - resource: self.globals.as_entire_binding(), - }, - wgpu::BindGroupEntry { - binding: 1, - resource: wgpu::BindingResource::TextureView(&sprite_view), - }, - wgpu::BindGroupEntry { - binding: 2, - resource: wgpu::BindingResource::Sampler(&self.sprite_sampler), - }, - wgpu::BindGroupEntry { - binding: 3, - resource: wgpu::BindingResource::TextureView(&self.lightmap_view), - }, - wgpu::BindGroupEntry { - binding: 4, - resource: wgpu::BindingResource::Sampler(&self.lightmap_sampler), - }, - ], - }); + let views = sprite_views(&self.sprite_textures, &self.sprite_unused, Some(levels + 1)); + self.group = terrain_group( + &self.device, + "Horizon terrain resources", + &self.terrain_layout, + &self.globals, + &views, + &self.sprite_sampler, + &self.lightmap_view, + &self.lightmap_sampler, + ); } pub fn view_projection(&self, frame: &Frame) -> Mat4 { self.projection( @@ -2001,12 +2088,12 @@ impl Renderer { self.uploads.texture( encoder, wgpu::TexelCopyTextureInfo { - texture: &self.sprite_texture, + texture: &self.sprite_textures[(layer / self.sprite_split) as usize], mip_level: level, origin: wgpu::Origin3d { x: 0, y: 0, - z: layer, + z: layer % self.sprite_split, }, aspect: wgpu::TextureAspect::All, }, diff --git a/crates/horizon-client/src/sprites.rs b/crates/horizon-client/src/sprites.rs index d050e5fda..c26e02ea7 100644 --- a/crates/horizon-client/src/sprites.rs +++ b/crates/horizon-client/src/sprites.rs @@ -82,6 +82,10 @@ pub struct Sprites { /// Each layer's frames at the texture's own resolution (square), and the /// frame shown first. native: Vec<(u32, Arc>>, usize)>, + /// Still textures by their pixels and mip settings: mods copy vanilla's + /// textures under their own names, and one layer serves them all (the + /// GPU's array may hold as few as 2048). + still: std::collections::HashMap<(Vec, u32, [u32; 2], [bool; 4]), u32>, } /// Edge length of vanilla's block textures: the smallest array layer. pub const SPRITE_SIZE: u32 = 16; @@ -104,6 +108,10 @@ fn resample(frame: &[u8], from: u32, to: u32) -> Vec { out } impl Sprites { + /// How many array layers the textures take. + pub fn count(&self) -> usize { + self.native.len() + } /// Lay every layer out at one size: the largest texture's (resource packs /// may ship 32x, 64x... textures, like vanilla's stitched atlas), rounded /// up to a power of two and limited to [`MAX_ARRAY_BYTES`]. Smaller @@ -152,7 +160,7 @@ impl Sprites { } }) .collect(); - let layer = u32::try_from(self.layers.len())?; + let layer = u32::try_from(self.native.len())?; self.opaque.push(true); self.translucent.push(false); self.mips.push(crate::mipmap::Settings::default()); @@ -209,7 +217,7 @@ impl Sprites { }; pixels.extend(rgba); } - let layer = u32::try_from(self.layers.len())?; + let layer = u32::try_from(self.native.len())?; let columns = info.width / width; let count = columns * (info.height / height); // Layers are square; a frame of another shape is nearest-resampled to @@ -230,6 +238,46 @@ impl Sprites { } frames.push(frame); } + let settings = crate::mipmap::Settings { + native_size: side, + strategy: texture_section(metadata.as_ref()) + .as_ref() + .and_then(|t| t["mipmap_strategy"].as_str()) + .and_then(crate::mipmap::Strategy::parse) + .unwrap_or_default(), + alpha_cutoff_bias: texture_section(metadata.as_ref()) + .as_ref() + .and_then(|t| t["alpha_cutoff_bias"].as_f64()) + .unwrap_or(0.0) as f32, + has_transparent: pixels.as_chunks::<4>().0.iter().any(|p| p[3] == 0), + item: name + .split_once(':') + .is_some_and(|(_, p)| p.starts_with("item/")), + }; + let opaque = pixels.as_chunks::<4>().0.iter().all(|p| p[3] == 255); + let translucent = pixels + .as_chunks::<4>() + .0 + .iter() + .any(|p| p[3] != 0 && p[3] != 255); + let still = (animation.is_none() && frames.len() == 1).then(|| { + ( + frames[0].clone(), + side, + [ + settings.strategy as u32, + settings.alpha_cutoff_bias.to_bits(), + ], + [settings.has_transparent, settings.item, opaque, translucent], + ) + }); + if let Some(&same) = still.as_ref().and_then(|k| self.still.get(k)) { + self.layers.insert(name.to_owned(), same); + return Ok(same); + } + if let Some(key) = still { + self.still.insert(key, layer); + } let frames = Arc::new(frames); let mut initial = 0; if let Some(clip) = animation @@ -245,43 +293,25 @@ impl Sprites { clip: Arc::new(clip), }); } - // SpriteContents: TextureMetadataSection's mipmap strategy and alpha - // cutoff bias, and the whole image's NativeImage.computeTransparency. - let texture = metadata - .as_ref() - .and_then(|v| v.get("texture")) - .and_then(|v| serde_json::from_str::(v.get()).ok()); - self.mips.push(crate::mipmap::Settings { - native_size: side, - strategy: texture - .as_ref() - .and_then(|t| t["mipmap_strategy"].as_str()) - .and_then(crate::mipmap::Strategy::parse) - .unwrap_or_default(), - alpha_cutoff_bias: texture - .as_ref() - .and_then(|t| t["alpha_cutoff_bias"].as_f64()) - .unwrap_or(0.0) as f32, - has_transparent: pixels.as_chunks::<4>().0.iter().any(|p| p[3] == 0), - item: name - .split_once(':') - .is_some_and(|(_, p)| p.starts_with("item/")), - }); - self.opaque - .push(pixels.as_chunks::<4>().0.iter().all(|p| p[3] == 255)); - self.translucent.push( - pixels - .as_chunks::<4>() - .0 - .iter() - .any(|p| p[3] != 0 && p[3] != 255), - ); + self.mips.push(settings); + self.opaque.push(opaque); + self.translucent.push(translucent); self.layers.insert(name.to_owned(), layer); self.native.push((side, frames, initial)); Ok(layer) } } +/// SpriteContents: the `.mcmeta` `texture` section (TextureMetadataSection's +/// mipmap strategy and alpha cutoff bias). +fn texture_section( + metadata: Option<&BTreeMap>>, +) -> Option { + metadata + .and_then(|v| v.get("texture")) + .and_then(|v| serde_json::from_str(v.get()).ok()) +} + #[cfg(test)] pub(crate) fn test_animation(size: u32, layer: u32) -> SpriteAnimation { test_clip(size, layer, r#"{"frametime":1,"frames":[0,1]}"#) @@ -305,6 +335,46 @@ pub(crate) fn test_clip(size: u32, layer: u32, metadata: &str) -> SpriteAnimatio mod tests { use super::*; #[test] + fn identical_still_textures_share_a_layer() { + let root = + std::env::temp_dir().join(format!("horizon-sprite-share-{}", std::process::id())); + let directory = root.join("assets/a/textures/block"); + fs::create_dir_all(&directory).unwrap(); + let write = |name: &str, red: u8| { + let mut encoder = + png::Encoder::new(File::create(directory.join(name)).unwrap(), 16, 16); + encoder.set_color(png::ColorType::Rgba); + encoder.set_depth(png::BitDepth::Eight); + let pixels: Vec = (0..256).flat_map(|i| [red, i as u8, 0, 255]).collect(); + encoder + .write_header() + .unwrap() + .write_image_data(&pixels) + .unwrap(); + }; + write("one.png", 10); + write("copy.png", 10); + write("other.png", 20); + let mut sprites = Sprites::default(); + let one = sprites.insert(&root, "a:block/one").unwrap(); + let copy = sprites.insert(&root, "a:block/copy").unwrap(); + let other = sprites.insert(&root, "a:block/other").unwrap(); + // The same pixels as an item sprite mip differently: a layer of its own. + fs::create_dir_all(root.join("assets/a/textures/item")).unwrap(); + fs::copy( + directory.join("one.png"), + root.join("assets/a/textures/item/one.png"), + ) + .unwrap(); + let item = sprites.insert(&root, "a:item/one").unwrap(); + fs::remove_dir_all(&root).unwrap(); + assert_eq!((one, copy, other, item), (0, 0, 1, 2)); + assert_eq!((sprites.count(), sprites.layers.len()), (3, 4)); + assert_eq!((sprites.opaque.len(), sprites.mips.len()), (3, 3)); + sprites.finish(); + assert_eq!(sprites.pixels.len(), 3 * 16 * 16 * 4); + } + #[test] fn a_32px_only_atlas_does_not_add_an_extra_mipmap() { let mut sprites = Sprites { native: vec![ diff --git a/crates/horizon-client/src/terrain.wgsl b/crates/horizon-client/src/terrain.wgsl index 26e32cb89..4689e7d2b 100644 --- a/crates/horizon-client/src/terrain.wgsl +++ b/crates/horizon-client/src/terrain.wgsl @@ -27,6 +27,29 @@ struct Globals { @group(0) @binding(2) var sprite_sampler: sampler; @group(0) @binding(3) var lightmap: texture_2d; @group(0) @binding(4) var lightmap_sampler: sampler; +// Layers past the first array's SPRITE_SPLIT (2048, gfx.rs): mods' sprites. +@group(0) @binding(5) var sprites_1: texture_2d_array; +@group(0) @binding(6) var sprites_2: texture_2d_array; +@group(0) @binding(7) var sprites_3: texture_2d_array; +// How many sprite arrays hold layers (a pipeline constant): 1 for vanilla, +// which then samples exactly as before. +override SPRITE_ARRAYS: u32 = 1u; +override SPRITE_SPLIT: u32 = 2048u; +fn sprite(uv: vec2, layer: u32) -> vec4 { + if SPRITE_ARRAYS == 1u { + return textureSample(sprites, sprite_sampler, uv, i32(layer)); + } + // The array is chosen per fragment: sample with the derivatives taken here. + let dx = dpdx(uv); + let dy = dpdy(uv); + let l = i32(layer % SPRITE_SPLIT); + switch layer / SPRITE_SPLIT { + case 0u: { return textureSampleGrad(sprites, sprite_sampler, uv, l, dx, dy); } + case 1u: { return textureSampleGrad(sprites_1, sprite_sampler, uv, l, dx, dy); } + case 2u: { return textureSampleGrad(sprites_2, sprite_sampler, uv, l, dx, dy); } + default: { return textureSampleGrad(sprites_3, sprite_sampler, uv, l, dx, dy); } + } +} struct TerrainOut { @builtin(position) clip: vec4, @@ -67,12 +90,12 @@ fn apply_fog(color: vec4, spherical: f32, cylindrical: f32) -> vec4 { } @fragment fn fs_solid(in: TerrainOut) -> @location(0) vec4 { // Bit 15 of the layer marks opaque leaves (forceOpaque): no alpha cutout. - let color = textureSample(sprites, sprite_sampler, in.uv, i32(in.layer & 0x7fffu)) * in.color; + let color = sprite(in.uv, in.layer & 0x7fffu) * in.color; if color.a < 0.5 && (in.layer & 0x8000u) == 0u { discard; } return apply_fog(vec4(color.rgb, 1.0), in.spherical, in.cylindrical); } @fragment fn fs_translucent(in: TerrainOut) -> @location(0) vec4 { - let color = textureSample(sprites, sprite_sampler, in.uv, i32(in.layer & 0x7fffu)) * in.color; + let color = sprite(in.uv, in.layer & 0x7fffu) * in.color; if color.a < 0.01 { discard; } return apply_fog(color, in.spherical, in.cylindrical); } From d652b25ead328d505596e585091276181a8b246e Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 19:12:40 -0400 Subject: [PATCH 20/59] Package registry reports and recover from incomplete server resources --- crates/horizon-client/src/game/remote.rs | 17 +++- crates/horizon-client/src/title.rs | 2 +- crates/horizon-prepare/src/lib.rs | 98 ++++++++++++++++++++---- 3 files changed, 97 insertions(+), 20 deletions(-) diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index e31e270b8..a7b23bf32 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -153,7 +153,20 @@ 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_server(address, name, None) + if let Err(error) = self.join_server(address, name, None) { + log::warn!("Horizon: could not join server: {error}"); + if self.title.is_none() { + self.title = Some(horizon_client::title::Title::new( + std::env::current_dir()?.join("saves"), + &self.options.resources, + )); + } + if let Some(title) = &mut self.title { + title.failed(error); + } + self.capture(false); + } + Ok(()) } /// Join single player's integrated server through memory. pub(super) fn connect_local( @@ -173,7 +186,7 @@ impl Game<'_> { let root = self.options.resources.clone(); let builtin = Builtin::find(&root) .and_then(|p| Builtin::load(&p).ok()) - .ok_or("registries.json not found next to the resources; run the data generator reports (horizon-prepare)")?; + .ok_or("Resources are incomplete: registries.json is missing or invalid. Repair resources in the launcher (or run horizon-prepare), then try again.")?; let lang = Arc::new(horizon_client::net::load_language(&root)); let view = self.settings.render_distance.clamp(2, 32) as i8; if local.is_none() { diff --git a/crates/horizon-client/src/title.rs b/crates/horizon-client/src/title.rs index 2a9f0fdf9..a28f401ea 100644 --- a/crates/horizon-client/src/title.rs +++ b/crates/horizon-client/src/title.rs @@ -397,7 +397,7 @@ impl Title { scroll.wheel(delta, ROW_HEIGHT / 2.0, top, bottom, content); self.scroll.set(scroll); } - fn failed(&mut self, error: impl std::fmt::Display) { + pub fn failed(&mut self, error: impl std::fmt::Display) { let return_to = Box::new(self.mode.clone()); self.mode = Mode::Error { message: error.to_string(), diff --git a/crates/horizon-prepare/src/lib.rs b/crates/horizon-prepare/src/lib.rs index f997be326..fb9df356f 100644 --- a/crates/horizon-prepare/src/lib.rs +++ b/crates/horizon-prepare/src/lib.rs @@ -762,8 +762,7 @@ fn steps( "behaviour-export.log", )?; - let items = root.join("items.json"); - if !items.exists() || !run.same("server_sha256") { + if datagen_reports_missing(root) || !run.same("server_sha256") { // Vanilla's own data generator reports every item's default components. (run.log)("Running vanilla's data generator reports"); let datagen = run.local.join("datagen"); @@ -785,21 +784,7 @@ fn steps( ) .map_err(|e| format!("{e} in the data generator; see {}", log_path.display()))?; let reports = datagen.join("out").join("reports"); - let mut components = Value::Object(Vec::new()); - for file in json_files(&reports.join("minecraft/components/item"))? { - let stem = file.file_stem().unwrap().to_string_lossy().into_owned(); - let report = read_json(&file)?; - let component = report - .get("components") - .ok_or_else(|| format!("{} has no components", file.display()))?; - components.insert(&format!("minecraft:{stem}"), component.clone()); - } - write_text(&items, &pyjson::dumps(&components, &pyjson::DEFAULT))?; - let biome_parameters = root.join("biome-parameters"); - mkdir(&biome_parameters)?; - for file in json_files(&reports.join("biome_parameters/minecraft"))? { - copy(&file, &biome_parameters.join(file.file_name().unwrap()))?; - } + install_datagen_reports(root, &reports)?; } // Biome parameter tables come from the data generator reports above. @@ -925,6 +910,37 @@ fn steps( ) } +fn datagen_reports_missing(root: &Path) -> bool { + ["items.json", "registries.json", "commands.json"] + .iter() + .any(|name| !root.join(name).is_file()) +} + +fn install_datagen_reports(root: &Path, reports: &Path) -> Result<(), String> { + for name in ["registries.json", "commands.json"] { + copy(&reports.join(name), &root.join(name))?; + } + let mut components = Value::Object(Vec::new()); + for file in json_files(&reports.join("minecraft/components/item"))? { + let stem = file.file_stem().unwrap().to_string_lossy().into_owned(); + let report = read_json(&file)?; + let component = report + .get("components") + .ok_or_else(|| format!("{} has no components", file.display()))?; + components.insert(&format!("minecraft:{stem}"), component.clone()); + } + write_text( + &root.join("items.json"), + &pyjson::dumps(&components, &pyjson::DEFAULT), + )?; + let biome_parameters = root.join("biome-parameters"); + mkdir(&biome_parameters)?; + for file in json_files(&reports.join("biome_parameters/minecraft"))? { + copy(&file, &biome_parameters.join(file.file_name().unwrap()))?; + } + Ok(()) +} + /// `sorted(directory.glob('*.json'))`: glob skips names starting with a dot. fn json_files(directory: &Path) -> Result, String> { let mut files: Vec = fs::read_dir(directory) @@ -1124,6 +1140,54 @@ fn export_block_behavior(run: &Run, export: &Path) -> Result<(), String> { mod tests { use super::*; + #[test] + fn datagen_reports_are_installed_beside_resources_and_missing_reports_need_repair() { + let dir = + std::env::temp_dir().join(format!("horizon-prepare-reports-{}", std::process::id())); + let root = dir.join("resources"); + let reports = dir.join("reports"); + mkdir(&root).unwrap(); + mkdir(&reports.join("minecraft/components/item")).unwrap(); + mkdir(&reports.join("biome_parameters/minecraft")).unwrap(); + write_text(&root.join("items.json"), "{}").unwrap(); + assert!(datagen_reports_missing(&root)); + write_text( + &reports.join("registries.json"), + "{\"minecraft:item\":{\"entries\":{}}}", + ) + .unwrap(); + write_text(&reports.join("commands.json"), "{\"type\":\"root\"}").unwrap(); + write_text( + &reports.join("minecraft/components/item/stone.json"), + "{\"components\":{\"minecraft:max_stack_size\":64}}", + ) + .unwrap(); + write_text( + &reports.join("biome_parameters/minecraft/overworld.json"), + "{}", + ) + .unwrap(); + install_datagen_reports(&root, &reports).unwrap(); + assert!(!datagen_reports_missing(&root)); + for name in ["registries.json", "commands.json"] { + assert_eq!( + read(&root.join(name)).unwrap(), + read(&reports.join(name)).unwrap() + ); + } + assert!(read_json(&root.join("items.json")) + .unwrap() + .get("minecraft:stone") + .is_some()); + assert!(root.join("biome-parameters/overworld.json").is_file()); + for name in ["registries.json", "commands.json", "items.json"] { + fs::remove_file(root.join(name)).unwrap(); + assert!(datagen_reports_missing(&root), "{name}"); + install_datagen_reports(&root, &reports).unwrap(); + } + fs::remove_dir_all(dir).unwrap(); + } + #[test] fn the_source_digest_is_the_one_build_rs_computed() { assert_eq!( From 4f2674275d1286a1b5193f2ab07666089213cc0b Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 00:34:14 +0200 Subject: [PATCH 21/59] horizon-prepare: keep the registry and command reports with the prepared files A dedicated server reads registries.json and commands.json (the data generator's reports) next to the prepared resources, and otherwise only finds them in the .local/datagen folder of a development checkout. A prepared folder copied or mounted on its own, as the Docker image expects, stopped the server at start with "registries.json not found next to the resources". The prepare step now copies both reports into the folder (again whenever the server jar changes). Co-Authored-By: Claude Opus 5.5 --- crates/horizon-prepare/src/lib.rs | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/crates/horizon-prepare/src/lib.rs b/crates/horizon-prepare/src/lib.rs index f997be326..ac1e97af8 100644 --- a/crates/horizon-prepare/src/lib.rs +++ b/crates/horizon-prepare/src/lib.rs @@ -802,6 +802,17 @@ fn steps( } } + // The registry and command reports, which the game reads next to these + // files when it serves players (a dedicated server, a LAN world): kept + // here too, so this folder works when it is copied or mounted alone. + let reports = run.local.join("datagen").join("out").join("reports"); + for name in ["registries.json", "commands.json"] { + let (from, to) = (reports.join(name), root.join(name)); + if from.is_file() && (!to.exists() || !run.same("server_sha256")) { + copy(&from, &to)?; + } + } + // Biome parameter tables come from the data generator reports above. prepare_worldgen(run)?; From dc42425c0197c5918ba3739d5aa20b8678af6199 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 01:33:24 +0200 Subject: [PATCH 22/59] Integrated server: Open to LAN Single player on its server thread could not be opened to the LAN: the window is a client of that server, and Open to LAN, /publish and `horizon-ctl lan` tried to start a second hub on the window's side. The server thread now publishes itself, as IntegratedServer.publishServer does: - The window asks its server with `Integrated::call` (executeBlocking): a task run between two ticks, while paused too, with its answer. - Publishing binds the port at once (a busy port fails right away), then the hub starts listening and announcing the world (LanServerPinger) with the MOTD " - ". Until then only the owner may log in; afterwards anyone may, and status pings are answered. - Unpublishing stops the listener and sends every player but the owner away (multiplayer.disconnect.server_shutdown). - /publish and /unpublish run on the server for the player who types them, and the integrated server's command tree (with publish, without the dedicated-only commands) is what its players get. - The owner's level follows Allow Commands; other players get game master commands only when guests may use commands and the world allows them (IntegratedServer.getCustomPermissionLevel). Every player's command runs at their own level. - The world options screen reads and applies its settings on the server: difficulty, default and personal game mode, Allow Commands and the LAN settings; the window shows the outcome. - A published world does not pause (Minecraft.pause needs !isPublished), and F3+Escape follows the same rule. - Memory connections are never compressed, whatever the threshold (Connection.isMemoryConnection), so network players get the usual 256. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/examples/lan_flat.rs | 1 + crates/horizon-client/src/game.rs | 5 +- .../horizon-client/src/game/commands/extra.rs | 26 +- crates/horizon-client/src/game/debug_keys.rs | 2 +- crates/horizon-client/src/game/dedicated.rs | 1 + crates/horizon-client/src/game/integrated.rs | 285 ++++++++++++++++-- crates/horizon-client/src/game/lan.rs | 122 +++++--- crates/horizon-client/src/game/lan_actions.rs | 25 ++ crates/horizon-client/src/game/lan_screen.rs | 86 ++++-- crates/horizon-client/src/lan/conn.rs | 3 +- crates/horizon-client/src/lan/hub.rs | 15 +- crates/horizon-client/src/lan/mod.rs | 113 ++++--- crates/horizon-client/tests/lan_bot.rs | 1 + crates/horizon-protocol/src/connection.rs | 4 + 14 files changed, 571 insertions(+), 118 deletions(-) diff --git a/crates/horizon-client/examples/lan_flat.rs b/crates/horizon-client/examples/lan_flat.rs index 63ea9f136..16fc36b95 100644 --- a/crates/horizon-client/examples/lan_flat.rs +++ b/crates/horizon-client/examples/lan_flat.rs @@ -88,6 +88,7 @@ fn main() -> Result<(), Box> { seed: 0, max_players: 8, dedicated: false, + integrated: false, }, ); let mut next_entity = 100u32; diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index e03c71a48..b63c29c29 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -1085,6 +1085,8 @@ struct Game<'a> { lan: Option, /// Single player's server thread, which `remote` is connected to. integrated: Option, + /// This game is that server thread's (game/integrated.rs). + serving: Option, /// The open world is shared behind an invite code (game/friends.rs). friends: Option, world_options: Option, @@ -3644,7 +3646,7 @@ impl Game<'_> { /// `Minecraft.pause`: a single-player game with a pausing screen open. fn pauses_game(&self) -> bool { self.has_singleplayer_server() - && self.lan.is_none() + && !self.is_published() && self.title.is_none() && (matches!( self.screen, @@ -10073,6 +10075,7 @@ impl<'a> Game<'a> { remote: None, lan: None, integrated: None, + serving: None, world_options: None, options_to_world_options: false, command_block_screen: None, diff --git a/crates/horizon-client/src/game/commands/extra.rs b/crates/horizon-client/src/game/commands/extra.rs index ab41596ee..a90648043 100644 --- a/crates/horizon-client/src/game/commands/extra.rs +++ b/crates/horizon-client/src/game/commands/extra.rs @@ -758,18 +758,25 @@ impl Game<'_> { .and_then(|l| l.local_addr()) .map_or(25564, |a| i32::from(a.port())), }; - if let Some(lan) = &self.lan { - return Err(err( - "commands.publish.alreadyPublished.lan", - &[&lan.settings.port], - )); + let published = if self.serving() { + self.published_port() + } else { + self.lan.as_ref().map(|l| l.settings.port) + }; + if let Some(port) = published { + return Err(err("commands.publish.alreadyPublished.lan", &[&port])); } let settings = super::super::lan::LanSettings { port: port as u16, guest_commands: allow, force_game_mode: false, }; - if self.lan_start(settings).is_err() { + let started = if self.serving() { + self.publish(settings).is_ok() + } else { + self.lan_start(settings).is_ok() + }; + if !started { return Err(err("commands.publish.failed", &[])); } let port_text = port.to_string(); @@ -785,6 +792,13 @@ impl Game<'_> { Ok(port) } pub(super) fn cmd_unpublish(&mut self) -> R { + if self.serving() { + if !self.unpublish() { + return Err(err("commands.unpublish.notPublished", &[])); + } + self.feedback(Text::translate("commands.unpublish.success", &[])); + return Ok(1); + } if self.lan.is_none() { return Err(err("commands.unpublish.notPublished", &[])); } diff --git a/crates/horizon-client/src/game/debug_keys.rs b/crates/horizon-client/src/game/debug_keys.rs index 4008c33d9..94fd59f61 100644 --- a/crates/horizon-client/src/game/debug_keys.rs +++ b/crates/horizon-client/src/game/debug_keys.rs @@ -38,7 +38,7 @@ impl DebugHost for Host<'_, '_> { // the menu as it always has (key_pressed). let g = &mut *self.game; if without_menu && g.screen == Screen::Playing { - g.pause_menu = !(g.has_singleplayer_server() && g.lan.is_none()); + g.pause_menu = !(g.has_singleplayer_server() && !g.is_published()); g.screen = Screen::Paused; g.capture(false); g.mining = None; diff --git a/crates/horizon-client/src/game/dedicated.rs b/crates/horizon-client/src/game/dedicated.rs index 01728b351..062bb71c8 100644 --- a/crates/horizon-client/src/game/dedicated.rs +++ b/crates/horizon-client/src/game/dedicated.rs @@ -441,6 +441,7 @@ impl Game<'_> { seed: self.level.seed, max_players: props.max_players.max(0) as usize, dedicated: true, + integrated: false, }; let settings = LanSettings { port, diff --git a/crates/horizon-client/src/game/integrated.rs b/crates/horizon-client/src/game/integrated.rs index 0366627e3..ac2121e2e 100644 --- a/crates/horizon-client/src/game/integrated.rs +++ b/crates/horizon-client/src/game/integrated.rs @@ -2,6 +2,10 @@ //! its own "Server thread", as vanilla's does, and the window joins it as a //! player through memory, so a world tick never holds up a frame. //! +//! The window asks its server for what only the server knows (Open to LAN, +//! the world's options) with [`Integrated::call`], as vanilla's client calls +//! into its `IntegratedServer`. +//! //! Opt-in for now (`--server-thread` or `HORIZON_SERVER_THREAD=1`): the //! player joins as a network player, and the server side of a network player //! does not do everything single player does yet. Worlds whose player is @@ -15,7 +19,7 @@ use horizon_client::{ Result, audio::Audio, hud::HudAtlas, - lan::{MAX_PLAYERS, NetConfig, hub::HubConfig}, + lan::{Lan, MAX_PLAYERS, NetConfig, hub::HubConfig}, save::Level, settings::Settings, title::WorldOptions, @@ -23,11 +27,12 @@ use horizon_client::{ use horizon_protocol::connection::Pipe; use horizon_protocol::{crypto::offline_uuid, text::translatable}; use std::{ + net::TcpListener, path::Path, sync::{ Arc, - atomic::{AtomicBool, Ordering}, - mpsc::{Sender, channel}, + atomic::{AtomicBool, AtomicU16, Ordering}, + mpsc::{Receiver, Sender, channel, sync_channel}, }, thread::JoinHandle, time::{Duration, Instant}, @@ -39,12 +44,19 @@ struct Flags { /// `Minecraft.pause`: a single-player pause screen is open. paused: AtomicBool, stop: AtomicBool, + /// `IntegratedServer.getPort`: the port it is open to the LAN on, 0 + /// while it is not. + published: AtomicU16, } +/// Work the window hands its server thread (`MinecraftServer.execute`). +type Task = Box) + Send>; + /// The window's handle on its server thread. pub(super) struct Integrated { flags: Arc, thread: Option>, + tasks: Sender, /// The world's name (`level.dat`'s `LevelName`), for the pause menu. pub world_name: String, } @@ -53,6 +65,24 @@ impl Integrated { pub fn set_paused(&self, paused: bool) { self.flags.paused.store(paused, Ordering::Relaxed); } + /// `IntegratedServer.getPort` while `isPublished`. + pub fn published(&self) -> Option { + Some(self.flags.published.load(Ordering::Relaxed)).filter(|&p| p != 0) + } + /// `executeBlocking`: run `f` on the server thread between two ticks and + /// wait for its answer; `None` once the server has stopped. + pub fn call( + &self, + f: impl FnOnce(&mut Game<'_>) -> T + Send + 'static, + ) -> Option { + let (tx, rx) = sync_channel(1); + self.tasks + .send(Box::new(move |g| { + let _ = tx.send(f(g)); + })) + .ok()?; + rx.recv_timeout(Duration::from_secs(10)).ok() + } /// `IntegratedServer.halt(true)`: returns once the world is saved and let go. pub fn stop(mut self) { self.halt(); @@ -70,6 +100,21 @@ impl Drop for Integrated { } } +/// The server thread's side of the window's handle (`Game::serving`). +pub(super) struct Serving { + flags: Arc, + tasks: Receiver, + /// The window's profile. + owner: u128, + /// Open to LAN or closed from inside a player's command, while the hub + /// is out of its place: applied after the tick. + pending: Option, +} +enum Publish { + Open(TcpListener, LanSettings), + Close, +} + /// What the server thread hands the window once the world is open: its end /// of the connection and the world's name, or why it failed. type Ready = std::result::Result<(Pipe, String), String>; @@ -81,8 +126,11 @@ struct Launch { seed: Option, creative: bool, create: Option, - /// The window's profile: the only one let in, and the world's player. + /// The window's profile: the only one let in until the world is open to + /// the LAN, and the world's player. owner: u128, + /// Its name, for the LAN's MOTD. + player: String, } /// Whether this world opens on a server thread: asked for, and its player @@ -99,6 +147,14 @@ impl Game<'_> { pub(super) fn has_singleplayer_server(&self) -> bool { self.remote.is_none() || self.integrated.is_some() } + /// `IntegratedServer.isPublished`: the world is open to the network. + pub(super) fn is_published(&self) -> bool { + self.lan.is_some() + || self + .integrated + .as_ref() + .is_some_and(|s| s.published().is_some()) + } /// `Minecraft.doWorldLoad`: start the server thread on the world, wait /// until it can be joined, then join it through memory. pub(super) fn open_integrated( @@ -121,6 +177,7 @@ impl Game<'_> { create: create.cloned(), // An offline-mode server names its players by their offline profile. owner: offline_uuid(&player), + player: player.clone(), }; let mut options = self.options.clone(); // A server without a console: no local player, no window, no control socket. @@ -138,6 +195,7 @@ impl Game<'_> { let (res, pack, settings) = (self.res.clone(), self.pack.clone(), self.settings.clone()); let flags = Arc::new(Flags::default()); let (ready_tx, ready) = channel(); + let (tasks, server_tasks) = channel(); let server_flags = flags.clone(); let thread = std::thread::Builder::new() .name("Server thread".into()) @@ -148,7 +206,8 @@ impl Game<'_> { options, settings, launch, - &server_flags, + server_flags, + server_tasks, &ready_tx, ); if let Err(e) = result { @@ -159,6 +218,7 @@ impl Game<'_> { let mut handle = Integrated { flags, thread: Some(thread), + tasks, world_name: String::new(), }; let pipe = match ready.recv() { @@ -179,7 +239,8 @@ impl Game<'_> { fn run_integrated( &mut self, launch: Launch, - flags: &Flags, + flags: Arc, + tasks: Receiver, ready: &Sender, ) -> Result<()> { self.open_world( @@ -193,7 +254,8 @@ impl Game<'_> { let view_distance = self.settings.render_distance.clamp(2, 32); let config = HubConfig { default_game_mode: self.level.mode(), - guest_commands: true, + // Only the owner until it is opened to the LAN. + guest_commands: false, force_game_mode: false, hardcore: self.level.hardcore, view_distance, @@ -203,23 +265,28 @@ impl Game<'_> { max_players: MAX_PLAYERS, // No player of its own: the hub runs without a host. dedicated: true, + integrated: true, }; let owner = launch.owner; + let published = flags.clone(); let net = NetConfig { - // No network until it is opened to the LAN. + // No network until it is opened to the LAN; the memory connection + // is not compressed (`Connection.isMemoryConnection`). listen: false, - // A memory connection is not compressed (`Connection.isMemoryConnection`). - compression_threshold: -1, - enable_status: false, - announce: false, gate: Some(Arc::new(move |_, uuid, _| { - (uuid != owner).then(|| translatable("multiplayer.disconnect.not_whitelisted", &[])) + (uuid != owner && published.published.load(Ordering::Relaxed) == 0) + .then(|| translatable("multiplayer.disconnect.not_whitelisted", &[])) })), - ..NetConfig::lan(0, self.level.name.clone(), MAX_PLAYERS) + // IntegratedServer.initServer: the MOTD names the owner and the world. + ..NetConfig::lan( + 0, + format!("{} - {}", launch.player, self.level.name), + MAX_PLAYERS, + ) }; let settings = LanSettings { port: 0, - guest_commands: true, + guest_commands: false, force_game_mode: false, }; self.lan_host(settings, net, config, None)?; @@ -238,10 +305,17 @@ impl Game<'_> { }); host.hub.lan.connect_local()? }; + self.serving = Some(Serving { + flags: flags.clone(), + tasks, + owner, + pending: None, + }); let _ = ready.send(Ok((pipe, self.level.name.clone()))); self.settle_spawn()?; let mut next = Instant::now(); while !flags.stop.load(Ordering::Relaxed) { + self.run_tasks(); self.update_dedicated_streaming(); self.update_world(); if flags.paused.load(Ordering::Relaxed) { @@ -250,6 +324,7 @@ impl Game<'_> { } else { self.tick()?; } + self.apply_publish(); let rate = self.clock.rate().max(1.0); next += Duration::from_secs_f64(1.0 / f64::from(rate)); let now = Instant::now(); @@ -265,6 +340,10 @@ impl Game<'_> { /// `MinecraftServer.stopServer`: the players are saved and sent away, /// then the world is saved. fn stop_integrated(&mut self) -> Result<()> { + // IntegratedServer.stopServer: teardownPublishedState. + if let Some(s) = self.serving.take() { + s.flags.published.store(0, Ordering::Relaxed); + } if let Some(mut host) = self.lan.take() { for g in &host.hub.guests { self.save_guest(&host, g); @@ -287,19 +366,191 @@ impl Game<'_> { } } +/// What the world options screen shows of an integrated server. +#[derive(Clone, Copy, Debug)] +pub(super) struct ServerOptions { + pub default_mode: i32, + /// The owner's own game mode. + pub personal_mode: i32, + pub cheats: bool, + pub difficulty: u8, + pub hardcore: bool, + pub difficulty_locked: bool, + pub port: Option, + pub guest_commands: bool, + pub force: bool, +} + +/// The server thread's side. +impl Game<'_> { + /// Whether this game is an integrated server's. + pub(super) fn serving(&self) -> bool { + self.serving.is_some() + } + /// The window's requests, between two ticks. + fn run_tasks(&mut self) { + let tasks: Vec = match &self.serving { + Some(s) => s.tasks.try_iter().collect(), + None => return, + }; + for task in tasks { + task(self); + self.apply_publish(); + } + } + /// `IntegratedServer.getPort` while published. + pub(super) fn published_port(&self) -> Option { + let s = self.serving.as_ref()?; + Some(s.flags.published.load(Ordering::Relaxed)).filter(|&p| p != 0) + } + /// `IntegratedServer.publishServer`: listen on `settings.port` (0 picks + /// one) and announce the world. The socket is bound at once so a busy + /// port fails here; the hub starts listening once it is at hand. + pub(super) fn publish(&mut self, settings: LanSettings) -> std::result::Result { + let Some(s) = self.serving.as_mut() else { + return Err("not an integrated server".into()); + }; + if s.flags.published.load(Ordering::Relaxed) != 0 { + return Err("already published".into()); + } + let listener = Lan::bind(None, settings.port).map_err(|e| e.to_string())?; + let port = listener.local_addr().map_err(|e| e.to_string())?.port(); + log::info!("Published LAN server on port {port}"); + s.flags.published.store(port, Ordering::Relaxed); + s.pending = Some(Publish::Open(listener, LanSettings { port, ..settings })); + self.apply_publish(); + Ok(port) + } + /// `IntegratedServer.unpublishServer`: stop listening and send every + /// player but the owner away. False when it was not published. + pub(super) fn unpublish(&mut self) -> bool { + let Some(s) = self.serving.as_mut() else { + return false; + }; + if s.flags.published.swap(0, Ordering::Relaxed) == 0 { + return false; + } + s.pending = Some(Publish::Close); + self.apply_publish(); + true + } + /// Publish or unpublish for real, once the hub is in its place (a + /// player's `/publish` runs while it is out). + fn apply_publish(&mut self) { + if self.lan.is_none() { + return; + } + let Some(s) = self.serving.as_mut() else { + return; + }; + let (Some(pending), owner) = (s.pending.take(), s.owner) else { + return; + }; + let allow_commands = self.allow_commands(); + let Some(host) = self.lan.as_mut() else { + return; + }; + match pending { + Publish::Open(listener, settings) => { + if let Err(e) = host.hub.lan.listen_on(listener, true) { + log::error!("Horizon: Open to LAN: {e}"); + } + host.settings = settings; + host.hub.config.force_game_mode = settings.force_game_mode; + // IntegratedServer.setGuestCommandAccess, then updatePermissions. + host.hub.config.guest_commands = settings.guest_commands && allow_commands; + host.hub.resend_commands(); + } + Publish::Close => { + host.hub.lan.stop_listening(); + log::info!( + "Unpublishing integrated server (was on port {})", + host.settings.port + ); + let others: Vec = host + .hub + .guests + .iter() + .filter(|g| g.uuid != owner) + .map(|g| g.conn) + .collect(); + for conn in others { + host.hub.kick( + conn, + translatable("multiplayer.disconnect.server_shutdown", &[]), + ); + } + } + } + } + /// The world options screen's state, read on the server. + pub(super) fn server_options(&self) -> ServerOptions { + let owner = self.serving.as_ref().map(|s| s.owner); + let host = self.lan.as_ref(); + let personal_mode = host + .and_then(|h| h.hub.guests.iter().find(|g| Some(g.uuid) == owner)) + .map_or(self.level.mode(), |g| g.game_mode); + let published = self.published_port(); + ServerOptions { + default_mode: self.level.mode(), + personal_mode, + cheats: self.allow_commands(), + difficulty: self.ui.difficulty, + hardcore: self.level.hardcore, + difficulty_locked: self.level.difficulty_locked, + port: published, + guest_commands: published.is_some() && host.is_some_and(|h| h.settings.guest_commands), + force: published.is_none() || host.is_some_and(|h| h.settings.force_game_mode), + } + } + /// `IntegratedServer.setPersonalGameType`: the owner's game mode. + pub(super) fn set_owner_mode(&mut self, mode: i32) { + let Some(owner) = self.serving.as_ref().map(|s| s.owner) else { + return; + }; + if let Some(host) = self.lan.as_mut() + && let Some(conn) = host + .hub + .guests + .iter() + .find(|g| g.uuid == owner) + .map(|g| g.conn) + { + host.hub.set_game_mode(conn, mode); + } + } + /// `IntegratedServer.setWorldAllowCommands`: the owner is an operator + /// while the world allows commands; everyone's level is sent again. + pub(super) fn owner_allow_commands(&mut self, allow: bool) { + let Some(owner) = self.serving.as_ref().map(|s| s.owner) else { + return; + }; + let published = self.published_port().is_some(); + if let Some(host) = self.lan.as_mut() { + host.hub.ops.insert(owner, if allow { 4 } else { 0 }); + if published { + host.hub.config.guest_commands = allow && host.settings.guest_commands; + } + host.hub.resend_commands(); + } + } +} + /// The server thread: a game of its own over the shared resources. +#[allow(clippy::too_many_arguments)] fn serve( res: &Arc, pack: PackResources, options: Options, settings: Settings, launch: Launch, - flags: &Flags, + flags: Arc, + tasks: Receiver, ready: &Sender, ) -> Result<()> { // It draws nothing: only the font, which books and chat measure with. let atlas = HudAtlas::fonts(&options.resources)?; let audio = Audio::silent(&options.resources); let mut server = Game::new(res, pack, atlas, options, settings, audio)?; - server.run_integrated(launch, flags, ready) + server.run_integrated(launch, flags, tasks, ready) } diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index c416c202f..1d00134e4 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -31,7 +31,7 @@ use std::{ static SYNC: OnceLock, String>> = OnceLock::new(); /// The settings of the open world (WorldOptionsScreen's multiplayer section). -#[derive(Clone, Debug)] +#[derive(Clone, Copy, Debug)] pub struct LanSettings { pub port: u16, pub guest_commands: bool, @@ -316,6 +316,15 @@ impl Game<'_> { if words[0] != "lan" { return Ok(None); } + if let Some(server) = &self.integrated + && words.get(1) == Some(&"status") + { + // The hub is the server thread's. + let status = server + .call(|g| g.lan_status()) + .ok_or("the integrated server stopped")?; + return Ok(Some(status)); + } match words.get(1).copied() { Some("open") => { if self.title.is_some() { @@ -337,43 +346,58 @@ impl Game<'_> { self.lan_close(true); Ok(Some(json!({ "ok": true }))) } - Some("status") => Ok(Some(match &self.lan { - Some(h) => json!({ - "open": true, - "host": h.host_name, - "port": h.settings.port, - "guests": h.hub.guests.iter().map(|g| json!({ - "name": g.name, - "position": g.position, - "placed": g.placed, - "loaded": g.loaded, - "game_mode": g.game_mode, - "sneaking": g.sneaking, - "health": g.health, - // FoodData: food level, saturation and exhaustion. - "food": [ - f64::from(g.food), - f64::from(g.saturation), - g.motion.as_ref().map_or(0.0, |m| f64::from(m.health.food.exhaustion)), - ], - "chunks": g.sent_chunks.len(), - "tracked": g.tracker.len(), - // The armour the host draws on this guest, head to feet. - "model_armor": h.models.get(&g.conn).map(|m| { - [&m.extra.head, &m.extra.chest, &m.extra.legs, &m.extra.feet] - .map(|s| s.as_deref()) - }), - })).collect::>(), - }), - None => json!({ "open": false }), - })), + Some("status") => Ok(Some(self.lan_status())), _ => Err("lan open|close|status".into()), } } + /// `horizon-ctl lan status`. + fn lan_status(&self) -> serde_json::Value { + use serde_json::json; + match &self.lan { + Some(h) if !self.serving() || self.published_port().is_some() => json!({ + "open": true, + "host": h.host_name, + "port": h.settings.port, + "guests": h.hub.guests.iter().map(|g| json!({ + "name": g.name, + "position": g.position, + "placed": g.placed, + "loaded": g.loaded, + "game_mode": g.game_mode, + "sneaking": g.sneaking, + "health": g.health, + // FoodData: food level, saturation and exhaustion. + "food": [ + f64::from(g.food), + f64::from(g.saturation), + g.motion.as_ref().map_or(0.0, |m| f64::from(m.health.food.exhaustion)), + ], + "chunks": g.sent_chunks.len(), + "tracked": g.tracker.len(), + // The armour the host draws on this guest, head to feet. + "model_armor": h.models.get(&g.conn).map(|m| { + [&m.extra.head, &m.extra.chest, &m.extra.legs, &m.extra.feet] + .map(|s| s.as_deref()) + }), + })).collect::>(), + }), + _ => json!({ "open": false }), + } + } + pub(super) fn lan_open(&mut self, settings: LanSettings) -> Result<()> { - self.lan_start(settings)?; - let port = self.lan.as_ref().map_or(0, |l| l.settings.port); + let port = if let Some(server) = &self.integrated { + // ShareToLanScreen: IntegratedServer.publishServer. + server + .call(move |g| g.publish(settings)) + .ok_or("the integrated server stopped")?? + } else if self.serving() { + return self.publish(settings).map(drop).map_err(Into::into); + } else { + self.lan_start(settings)?; + self.lan.as_ref().map_or(0, |l| l.settings.port) + }; self.system_message(Text::translate( "menu.multiplayerOptions.publish.started.lan", &[Text::literal(port.to_string())], @@ -408,6 +432,7 @@ impl Game<'_> { seed: self.level.seed, max_players: MAX_PLAYERS, dedicated: false, + integrated: false, }; let net = NetConfig::lan(settings.port, motd, MAX_PLAYERS); self.lan_host(settings, net, config, Some(host_uuid)) @@ -484,6 +509,22 @@ impl Game<'_> { /// IntegratedServer.unpublishServer: the guests are sent away. pub(super) fn lan_close(&mut self, announce: bool) { + if self.integrated.is_some() || self.serving() { + let closed = match &self.integrated { + Some(server) => server.call(|g| g.unpublish()).unwrap_or(false), + None => self.unpublish(), + }; + if closed { + self.friends_lan_closed(); + } + if closed && announce && self.integrated.is_some() { + self.system_message(Text::translate( + "menu.multiplayerOptions.publish.stopped", + &[], + )); + } + return; + } self.friends_lan_closed(); let Some(mut host) = self.lan.take() else { return; @@ -541,16 +582,29 @@ impl Game<'_> { /// New command access and game mode forcing settings of the open world. pub(super) fn lan_apply_settings(&mut self, guest_commands: bool, force: bool) { + if let Some(server) = &self.integrated { + server.call(move |g| g.lan_apply_settings(guest_commands, force)); + return; + } + // An integrated server gives guests commands only where the world + // allows them (IntegratedServer.getCustomPermissionLevel). + let effective = guest_commands && (!self.serving() || self.allow_commands()); if let Some(host) = self.lan.as_mut() { host.settings.guest_commands = guest_commands; host.settings.force_game_mode = force; - host.hub.config.guest_commands = guest_commands; + host.hub.config.guest_commands = effective; host.hub.config.force_game_mode = force; host.hub.resend_commands(); } } pub(super) fn lan_port(&self) -> Option { + if let Some(server) = &self.integrated { + return server.published(); + } + if self.serving() { + return self.published_port(); + } self.lan.as_ref().map(|h| h.settings.port) } diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index 1f6921e0c..176108372 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -676,6 +676,31 @@ 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). let allowed = self.options.dedicated.is_some() || self.allow_commands(); diff --git a/crates/horizon-client/src/game/lan_screen.rs b/crates/horizon-client/src/game/lan_screen.rs index 2402a5286..7c4533a16 100644 --- a/crates/horizon-client/src/game/lan_screen.rs +++ b/crates/horizon-client/src/game/lan_screen.rs @@ -7,6 +7,7 @@ use super::{ Game, Screen, game_rules_screen::{Exit, RulesScreen}, + integrated::ServerOptions, lan::LanSettings, }; use horizon_client::{ @@ -50,7 +51,7 @@ enum View { Restrictions, GameRules, } -#[derive(Clone, PartialEq)] +#[derive(Clone, Copy, PartialEq)] struct Snapshot { default_mode: i32, personal_mode: i32, @@ -406,28 +407,32 @@ impl Restrictions { impl Game<'_> { pub(super) fn open_world_options(&mut self) { let hint = horizon_client::lan::available_port(); - let lan = self.lan.is_some(); let mut port = EditBox::new(0.0, 0.0, 150.0, 20.0); port.max_length = 5; - let (guest_commands, force) = self.lan.as_ref().map_or((false, true), |h| { - (h.settings.guest_commands, h.settings.force_game_mode) - }); - if let Some(p) = self.lan_port() { + // The world is the server thread's when there is one. + let state = match &self.integrated { + Some(server) => match server.call(|g| g.server_options()) { + Some(state) => state, + None => return, + }, + None => self.local_server_options(), + }; + if let Some(p) = state.port { port.set_value(&p.to_string()); } let mut options = WorldOptions { - default_mode: self.level.mode(), - personal_mode: self.mode_id(), - cheats: self.allow_commands(), - difficulty: self.ui.difficulty, - lan, + default_mode: state.default_mode, + personal_mode: state.personal_mode, + cheats: state.cheats, + difficulty: state.difficulty, + lan: state.port.is_some(), port, hint, - guest_commands, - force, - hardcore: self.level.hardcore, - difficulty_locked: self.level.difficulty_locked, - locked: self.level.difficulty_locked || self.level.hardcore, + guest_commands: state.guest_commands, + force: state.force, + hardcore: state.hardcore, + difficulty_locked: state.difficulty_locked, + locked: state.difficulty_locked || state.hardcore, scroll: 0.0, view: View::Options, rules: None, @@ -808,7 +813,7 @@ impl Game<'_> { fn apply_and_close_world_options(&mut self, o: WorldOptions) { let wanted = o.snapshot(); - let before = o.initial.clone(); + let before = o.initial; self.world_options = Some(o); self.apply_world_options(&before, &wanted); self.close_world_options(); @@ -891,7 +896,47 @@ impl Game<'_> { } } + /// The world options of a world run in the frame. + fn local_server_options(&self) -> ServerOptions { + let (guest_commands, force) = self.lan.as_ref().map_or((false, true), |h| { + (h.settings.guest_commands, h.settings.force_game_mode) + }); + ServerOptions { + default_mode: self.level.mode(), + personal_mode: self.mode_id(), + cheats: self.allow_commands(), + difficulty: self.ui.difficulty, + hardcore: self.level.hardcore, + difficulty_locked: self.level.difficulty_locked, + port: self.lan_port(), + guest_commands, + force, + } + } + fn apply_world_options(&mut self, before: &Snapshot, wanted: &Snapshot) { + if let Some(server) = &self.integrated { + // The server applies them; the window tells what came of + // Open to LAN (ShareToLanScreen's messages). + let (b, w) = (*before, *wanted); + server.call(move |g| g.apply_world_options(&b, &w)); + if w.lan != b.lan || (w.lan && w.port != b.port) { + match (w.lan, self.lan_port()) { + (true, Some(port)) => self.system_message(Text::translate( + "menu.multiplayerOptions.publish.started.lan", + &[Text::literal(port.to_string())], + )), + (true, None) => { + self.system_message(Text::translate("commands.publish.failed", &[])); + } + (false, _) => self.system_message(Text::translate( + "menu.multiplayerOptions.publish.stopped", + &[], + )), + } + } + return; + } if wanted.difficulty != before.difficulty { let name = DIFFICULTIES[usize::from(wanted.difficulty) & 3]; self.as_console(|g| g.run_command(&format!("difficulty {name}"))); @@ -904,10 +949,15 @@ impl Game<'_> { self.set_default_game_mode(wanted.default_mode); } if wanted.personal_mode != before.personal_mode { - self.set_mode_id(wanted.personal_mode); + if self.serving() { + self.set_owner_mode(wanted.personal_mode); + } else { + self.set_mode_id(wanted.personal_mode); + } } if wanted.cheats != before.cheats { self.set_allow_commands(wanted.cheats); + self.owner_allow_commands(wanted.cheats); } let settings_changed = wanted.guest_commands != before.guest_commands || wanted.force != before.force; diff --git a/crates/horizon-client/src/lan/conn.rs b/crates/horizon-client/src/lan/conn.rs index 0688db0c6..a1ffac4fa 100644 --- a/crates/horizon-client/src/lan/conn.rs +++ b/crates/horizon-client/src/lan/conn.rs @@ -361,8 +361,9 @@ fn login_and_configure( name: &str, ) -> Result, String> { let e = |e: horizon_protocol::Error| e.to_string(); + // ServerLoginPacketListenerImpl: memory connections are not compressed. let threshold = shared.config.compression_threshold; - if threshold >= 0 { + if threshold >= 0 && !c.is_memory() { c.send(&login::Clientbound::Compression(login::Compression { threshold }).encode()) .map_err(e)?; c.set_compression(threshold); diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index 3f1f88c4a..cb438508e 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -48,6 +48,10 @@ pub struct HubConfig { pub max_players: usize, /// A dedicated server: operators from `ops`, the dedicated-only commands. pub dedicated: bool, + /// An integrated server (`dedicated` too, since it has no host player): + /// the owner's level from `ops`, the others' from Allow Commands and + /// the guests' command access, and the integrated-only commands. + pub integrated: bool, } /// The host player as the other players see them. @@ -445,7 +449,11 @@ impl Hub { /// (IntegratedServer.setGuestCommandAccess); a dedicated server its /// operators' level (`ops`). fn default_permission(&self, uuid: u128) -> u8 { - if self.config.dedicated { + if self.config.integrated { + // IntegratedServer.getProfilePermissions / getCustomPermissionLevel. + let guests = if self.config.guest_commands { 2 } else { 0 }; + self.ops.get(&uuid).copied().unwrap_or(guests) + } else if self.config.dedicated { self.ops.get(&uuid).copied().unwrap_or(0) } else if self.config.guest_commands { 2 @@ -682,7 +690,10 @@ impl Hub { fn send_commands(&self, i: usize) { let g = &self.guests[i]; let packet = match &self.sync.commands { - Some(tree) => tree.packet(g.permission, self.config.dedicated, &self.sync.builtin), + Some(tree) => { + let dedicated = self.config.dedicated && !self.config.integrated; + tree.packet(g.permission, dedicated, &self.sync.builtin) + } None => play::Commands { nodes: vec![play::CommandNode { kind: 0, diff --git a/crates/horizon-client/src/lan/mod.rs b/crates/horizon-client/src/lan/mod.rs index f4211c6ea..7084f20a6 100644 --- a/crates/horizon-client/src/lan/mod.rs +++ b/crates/horizon-client/src/lan/mod.rs @@ -310,6 +310,8 @@ pub struct Lan { events: Receiver, pub port: u16, listener: Option>, + /// Stops the accept loop alone: local connections stay. + listener_stop: Arc, /// The multicast announcement (LanServerPinger); absent when the socket failed. _pinger: Option, } @@ -325,26 +327,8 @@ impl Lan { } /// ServerConnectionListener.startTcpServerListener with a configuration. pub fn start_with(sync: Arc, config: NetConfig) -> io::Result { - let listener = if config.listen { - let bind = config - .bind - .unwrap_or(std::net::IpAddr::V4(std::net::Ipv4Addr::UNSPECIFIED)); - let listener = TcpListener::bind((bind, config.port))?; - listener.set_nonblocking(true)?; - Some(listener) - } else { - None - }; - let port = match &listener { - Some(l) => l.local_addr()?.port(), - None => 0, - }; - let _pinger = if config.announce && listener.is_some() { - discovery::Pinger::start(config.motd.clone(), port).ok() - } else { - None - }; let (tx, events) = channel(); + let (listen, port, announce) = (config.listen, config.port, config.announce); let shared = Arc::new(Shared { sync, events: tx, @@ -357,21 +341,77 @@ impl Lan { random: Mutex::new(crate::server::java_properties::now_millis() as u64 | 1), config, }); - let accept_shared = shared.clone(); - let listener = listener - .map(|listener| { - std::thread::Builder::new() - .name("horizon-lan-accept".into()) - .spawn(move || accept_loop(listener, accept_shared)) - }) - .transpose()?; - Ok(Self { + let mut lan = Self { shared, events, - port, - listener, - _pinger, - }) + port: 0, + listener: None, + listener_stop: Arc::new(AtomicBool::new(false)), + _pinger: None, + }; + if listen { + lan.listen(port, announce)?; + } + Ok(lan) + } + /// Start accepting connections on `port` (0 picks a free one), and + /// announce the world on the local network when `announce` + /// (`IntegratedServer.publishServer`'s LanServerPinger). Returns the port. + pub fn listen(&mut self, port: u16, announce: bool) -> io::Result { + if self.listener.is_some() { + return Err(io::Error::new( + io::ErrorKind::AlreadyExists, + "already listening", + )); + } + let listener = Self::bind(self.shared.config.bind, port)?; + self.listen_on(listener, announce) + } + /// The socket [`Lan::listen`] accepts on, bound ahead so that a failure + /// can be reported before the hub is at hand. + pub fn bind(address: Option, port: u16) -> io::Result { + let bind = address.unwrap_or(std::net::IpAddr::V4(std::net::Ipv4Addr::UNSPECIFIED)); + let listener = TcpListener::bind((bind, port))?; + listener.set_nonblocking(true)?; + Ok(listener) + } + /// [`Lan::listen`] on a socket already bound. + pub fn listen_on(&mut self, listener: TcpListener, announce: bool) -> io::Result { + if self.listener.is_some() { + return Err(io::Error::new( + io::ErrorKind::AlreadyExists, + "already listening", + )); + } + let port = listener.local_addr()?.port(); + let stop = Arc::new(AtomicBool::new(false)); + let (accept_shared, accept_stop) = (self.shared.clone(), stop.clone()); + let thread = std::thread::Builder::new() + .name("horizon-lan-accept".into()) + .spawn(move || accept_loop(listener, accept_shared, &accept_stop))?; + self._pinger = if announce { + discovery::Pinger::start(self.shared.motd(), port).ok() + } else { + None + }; + self.listener = Some(thread); + self.listener_stop = stop; + self.port = port; + Ok(port) + } + /// Stop accepting connections and announcing; connections already in + /// (the local one included) stay. + pub fn stop_listening(&mut self) { + self.listener_stop.store(true, Ordering::Relaxed); + if let Some(t) = self.listener.take() { + let _ = t.join(); + } + self._pinger = None; + self.port = 0; + } + /// Whether connections from the network are accepted. + pub fn listening(&self) -> bool { + self.listener.is_some() } /// `Connection.connectToLocalServer`: a connection through memory, its /// server end served on its own thread like an accepted socket. @@ -402,10 +442,7 @@ impl Lan { } pub fn stop(&mut self) { self.shared.stop.store(true, Ordering::Relaxed); - if let Some(t) = self.listener.take() { - let _ = t.join(); - } - self._pinger = None; + self.stop_listening(); } } impl Drop for Lan { @@ -414,8 +451,8 @@ impl Drop for Lan { } } -fn accept_loop(listener: TcpListener, shared: Arc) { - while !shared.stop.load(Ordering::Relaxed) { +fn accept_loop(listener: TcpListener, shared: Arc, stop: &AtomicBool) { + while !shared.stop.load(Ordering::Relaxed) && !stop.load(Ordering::Relaxed) { match listener.accept() { Ok((stream, addr)) => { let shared = shared.clone(); diff --git a/crates/horizon-client/tests/lan_bot.rs b/crates/horizon-client/tests/lan_bot.rs index 7a4a4a3c4..36f53444c 100644 --- a/crates/horizon-client/tests/lan_bot.rs +++ b/crates/horizon-client/tests/lan_bot.rs @@ -241,6 +241,7 @@ fn server(resources: &Path) -> Server { view_distance: 3, simulation_distance: 3, dedicated: false, + integrated: false, dimension: "minecraft:overworld".into(), seed: 1234, max_players: 8, diff --git a/crates/horizon-protocol/src/connection.rs b/crates/horizon-protocol/src/connection.rs index 3c6087f2e..687839416 100644 --- a/crates/horizon-protocol/src/connection.rs +++ b/crates/horizon-protocol/src/connection.rs @@ -227,6 +227,10 @@ impl Connection { }, }) } + /// `Connection.isMemoryConnection`: through a [`Pipe`] rather than a socket. + pub fn is_memory(&self) -> bool { + matches!(self.reader.stream, Stream::Memory(_)) + } /// ClientboundLoginCompressionPacket: negative thresholds disable compression. pub fn set_compression(&mut self, threshold: i32) { let t = usize::try_from(threshold).ok(); From ac2cc43aa663a66417739333bab5fcbf848c58e5 Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 19:35:47 -0400 Subject: [PATCH 23/59] Add mod management to Classic Options --- crates/horizon-client/src/game/control.rs | 3 +- crates/horizon-client/src/options_ui.rs | 136 +++++++++++++++++++++- 2 files changed, 137 insertions(+), 2 deletions(-) diff --git a/crates/horizon-client/src/game/control.rs b/crates/horizon-client/src/game/control.rs index e1169b2c8..495e6422b 100644 --- a/crates/horizon-client/src/game/control.rs +++ b/crates/horizon-client/src/game/control.rs @@ -29,7 +29,7 @@ const HELP: &[&str] = &[ "chat TEXT send a chat line or /command as if typed", "type TEXT type into the open chat box (key enter tap sends)", "chat-log [N] the newest N chat messages (default 10)", - "options [PAGE] open the options (video sound controls keybinds mouse chat accessibility language font packs graphics graphics-advanced)", + "options [PAGE] open the options (video sound controls keybinds mouse chat accessibility language font packs mods graphics graphics-advanced)", "stats [reset] frame-time summary since the last reset", "bench SECONDS reset stats, wait, then reply with the summary", "fly X1 Y1 Z1 X2 Y2 Z2 SECONDS [PITCH [raw]] fly the camera along a line at constant speed, then reply with the frame summary (raw: every frame time too)", @@ -462,6 +462,7 @@ impl Game<'_> { "language" => Page::Language, "font" => Page::Font, "packs" => Page::Packs, + "mods" => Page::Mods, "graphics" => Page::Graphics, "graphics-advanced" => Page::GraphicsAdvanced, other => return Err(format!("unknown options page {other}").into()), diff --git a/crates/horizon-client/src/options_ui.rs b/crates/horizon-client/src/options_ui.rs index 38be29576..71ca2d2cc 100644 --- a/crates/horizon-client/src/options_ui.rs +++ b/crates/horizon-client/src/options_ui.rs @@ -708,6 +708,7 @@ pub enum Page { Language, Font, Packs, + Mods, /// Horizon's graphics settings (`graphics_ui`). Graphics, GraphicsAdvanced, @@ -730,6 +731,7 @@ enum Act { ResetPadKeys, /// Back to Horizon's own menus (Horizon only, see `list_rows`). HorizonMenus, + ToggleMod(usize), } enum WKind { Button { @@ -971,6 +973,7 @@ impl OptionsUi { Page::Language => "options.language.title", Page::Font => "options.font.title", Page::Packs => "resourcePack.title", + Page::Mods => "Mods", Page::Graphics | Page::GraphicsAdvanced => "options.videoTitle", Page::Controller => "Controller Settings", Page::PadBinds => "Controller Binds", @@ -1161,6 +1164,36 @@ impl OptionsUi { Opt::AutoJump, ]), Page::Font => pairs(&[Opt::ForceUnicode, Opt::JapaneseGlyphs]), + Page::Mods => { + if s.mods.installed.is_empty() { + return vec![Row::Header( + "No mods: put .hmod files in the horizon-mods folder", + )]; + } + s.mods + .installed + .iter() + .enumerate() + .map(|(i, installed)| { + let mut label = Text::literal(format!("{}: ", installed.title)) + .append(on_off(s.mods.is_on(i))); + if installed.problem.is_some() { + label = label.append(" (Stopped)"); + } else if installed.dev { + label = label.append(" (Dev)"); + } + let widget = button(0.0, 0.0, 310.0, label, Act::ToggleMod(i)); + Row::Buttons( + if installed.dev || installed.id.is_empty() { + inactive(widget) + } else { + widget + }, + None, + ) + }) + .collect() + } _ => { let _ = s; Vec::new() @@ -1206,7 +1239,7 @@ impl OptionsUi { ("options.chat", Some(Page::Chat)), ("options.resourcepack", Some(Page::Packs)), ("options.accessibility", Some(Page::Accessibility)), - ("options.telemetry", None), + ("Mods...", Some(Page::Mods)), ("options.credits_and_attribution", None), ]; let gy = (61.0 + 30.0f32).min(h - 33.0 - 120.0); @@ -1650,6 +1683,21 @@ impl OptionsUi { if let Some(key) = key.filter(|key| lang::has(key)) { tooltip = Some(atlas.font.split(&tr(&key), 170.0)); } + if let WKind::Button { + act: Act::ToggleMod(i), + .. + } = &wd.kind + && let Some(installed) = s.mods.installed.get(*i) + { + let description = installed + .problem + .as_deref() + .unwrap_or(&installed.description); + tooltip = Some(atlas.font.split( + &Text::literal(format!("{}\n{description}", installed.title)), + 170.0, + )); + } } match &wd.kind { WKind::Button { label, active, act } => { @@ -1944,6 +1992,10 @@ impl OptionsUi { crate::ui_theme::save_preferences(&dir); } } + Act::ToggleMod(i) => { + s.mods.toggle(i); + events.push(Event::Changed); + } Act::None => {} } } @@ -2201,6 +2253,88 @@ mod tests { HudAtlas::build(std::path::Path::new("/nonexistent/horizon-test-assets")).unwrap() } + #[test] + fn classic_mods_page_toggles_mods_and_keeps_dev_and_invalid_entries_inactive() { + let atlas = atlas(); + let mut s = Settings::default(); + let mut ui = OptionsUi::default(); + let size = (480.0, 240.0); + assert!(ui.layout(&s, size.0, size.1).0.iter().any(|w| { + matches!( + w.kind, + WKind::Button { + active: true, + act: Act::Push(Page::Mods), + .. + } + ) + })); + ui.show(Page::Mods); + let empty = ui.layout(&s, size.0, size.1).0; + assert!(empty.iter().any(|w| { + matches!(&w.kind, WKind::Text { text, .. } if text.plain().contains(".hmod")) + })); + for (id, dev) in [("normal", false), ("dev", true), ("", false)] { + s.mods.installed.push(crate::mod_list::Installed { + id: id.into(), + title: id.into(), + description: "May show HUD panels.".into(), + problem: id.is_empty().then(|| "Invalid package".into()), + dev, + }); + } + let (widgets, ..) = ui.layout(&s, size.0, size.1); + let rows: Vec<_> = widgets + .iter() + .filter(|w| { + matches!( + w.kind, + WKind::Button { + act: Act::ToggleMod(_), + .. + } + ) + }) + .collect(); + assert_eq!(rows.len(), 3); + for (i, row) in rows.iter().enumerate() { + let events = ui.click( + &mut s, + &atlas, + row.x + 1.0, + row.y + 1.0, + size, + [480, 240], + false, + false, + ); + if i == 0 { + assert!(events.contains(&Event::Changed)); + assert!(events.contains(&Event::ButtonClick)); + } else { + assert!(events.is_empty()); + } + } + assert!(s.mods.is_on(0)); + assert!(s.mods.is_on(1)); + assert!(!s.mods.is_on(2)); + assert_eq!(s.mods.serialize(), "mod.normal:true\n"); + let row = rows[0]; + ui.click( + &mut s, + &atlas, + row.x + 1.0, + row.y + 1.0, + size, + [480, 240], + false, + false, + ); + assert!(!s.mods.is_on(0)); + assert!(!ui.back(&mut s).contains(&Event::Close)); + assert_eq!(ui.page(), Page::Main); + } + #[test] fn option_tooltip_keys_follow_value_dependent_descriptions() { let mut s = Settings::default(); From 7e430564a6d62dbc0816c735bda0bc36bb2e9cd3 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 00:11:57 +0200 Subject: [PATCH 24/59] Returning to the Overworld reuses its stronghold ring positions Each dimension change builds the destination's generator again, and with it a new structure state, so the 128 stronghold ring searches ran again on every return to the Overworld (about 1.5 s on two workers) and held up the first new chunks. The ring positions depend only on the shared generator data, the seed and the dimension's generator definition, so the generator data now keeps them by those (the last eight), and later generators for the same world and dimension share them. Co-Authored-By: Claude Opus 5.5 --- .../horizon-world/src/worldgen/generator.rs | 82 ++++++++++++++++++- .../src/worldgen/generator_structures.rs | 8 +- 2 files changed, 85 insertions(+), 5 deletions(-) diff --git a/crates/horizon-world/src/worldgen/generator.rs b/crates/horizon-world/src/worldgen/generator.rs index 65d872c85..12dfc10d9 100644 --- a/crates/horizon-world/src/worldgen/generator.rs +++ b/crates/horizon-world/src/worldgen/generator.rs @@ -51,7 +51,7 @@ use std::{ collections::{BTreeMap, BTreeSet, HashMap}, fs, io, path::Path, - sync::{Arc, Mutex}, + sync::{Arc, Mutex, OnceLock}, }; #[derive(Debug)] @@ -184,7 +184,13 @@ pub struct GeneratorData { /// Block shape-update behaviour (`block-behaviours.json` next to the /// worldgen directory) for template placement's neighbor updates. pub(super) behaviours: Option>, + /// Concentric ring positions by seed and dimension generator (see + /// `rings_for`), most recent last. + ring_cache: Mutex>, } +type RingCacheEntry = ((i64, String), Arc>); +/// Generators whose ring positions are kept: the dimensions of a few worlds. +const RING_CACHE_LIMIT: usize = 8; type Bundle = BTreeMap; fn read_bundle(dir: &Path, name: &str) -> Result { let path = dir.join(format!("{name}.json")); @@ -458,8 +464,30 @@ impl GeneratorData { block_tags, biome_tags, feature_resources, + ring_cache: Mutex::new(Vec::new()), })) } + /// The concentric ring positions (strongholds) of the generator for + /// `seed` and the dimension `generator` definition, shared by every + /// generator built for them. They depend on nothing else, so returning + /// to a dimension, which builds its generator again, finds them done. + pub(super) fn rings_for( + &self, + seed: i64, + generator: &Value, + ) -> Arc> { + let key = (seed, generator.to_string()); + let mut cache = self.ring_cache.lock().unwrap_or_else(|e| e.into_inner()); + let rings = match cache.iter().position(|(k, _)| *k == key) { + Some(i) => cache.remove(i).1, + None => Arc::new(OnceLock::new()), + }; + if cache.len() >= RING_CACHE_LIMIT { + cache.remove(0); + } + cache.push((key, rings.clone())); + rings + } pub fn registry(&self) -> &'static BlockRegistry { self.registry } @@ -821,8 +849,9 @@ where .into_iter() .filter_map(|name| pipeline.data.biome_id(name)) .collect(); + let rings = pipeline.data.rings_for(seed, generator); pipeline.structures = - super::generator_structures::StructureState::new(&pipeline.data, &possible)?; + super::generator_structures::StructureState::new(&pipeline.data, &possible, rings)?; } Ok(pipeline) } @@ -1906,6 +1935,55 @@ impl GeneratorWorker { mod tests { use super::*; + /// 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 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: &'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"); + let first = OverworldGenerator::new(data.clone(), 1234).expect("generator"); + let again = OverworldGenerator::new(data.clone(), 1234).expect("generator"); + { + let cache = data.ring_cache.lock().unwrap(); + assert_eq!(cache.len(), 1); + // The cache's handle and the two generators'. + assert_eq!(Arc::strong_count(&cache[0].1), 3); + } + drop((first, again)); + let a = data.rings_for(1, &serde_json::json!({ "settings": "a" })); + assert!(Arc::ptr_eq( + &a, + &data.rings_for(1, &serde_json::json!({ "settings": "a" })) + )); + assert!(!Arc::ptr_eq( + &a, + &data.rings_for(2, &serde_json::json!({ "settings": "a" })) + )); + assert!(!Arc::ptr_eq( + &a, + &data.rings_for(1, &serde_json::json!({ "settings": "b" })) + )); + for seed in 10..10 + RING_CACHE_LIMIT as i64 { + data.rings_for(seed, &serde_json::json!({ "settings": "a" })); + } + assert_eq!(data.ring_cache.lock().unwrap().len(), RING_CACHE_LIMIT); + assert!(!Arc::ptr_eq( + &a, + &data.rings_for(1, &serde_json::json!({ "settings": "a" })) + )); + } + #[test] fn parameter_reports_quantize_like_vanilla() { let report = r#"{"biomes":[{"biome":"minecraft:plains","parameters":{ diff --git a/crates/horizon-world/src/worldgen/generator_structures.rs b/crates/horizon-world/src/worldgen/generator_structures.rs index 4f804712f..f5487dc33 100644 --- a/crates/horizon-world/src/worldgen/generator_structures.rs +++ b/crates/horizon-world/src/worldgen/generator_structures.rs @@ -31,8 +31,9 @@ pub(super) struct StructureState { /// Structure indices of each decoration step, in registry order. pub(super) by_step: Vec>, starts: Mutex>, - /// Concentric ring positions, computed on first use. - rings: OnceLock, + /// Concentric ring positions, computed on first use and shared with + /// later generators of the same seed and dimension. + rings: Arc>, /// Their biome searches while they are computed. ring_work: OnceLock, } @@ -131,6 +132,7 @@ impl StructureState { pub(super) fn new( data: &Arc, possible_biomes: &BTreeSet, + rings: Arc>, ) -> Result, GeneratorError> { let (Some(resources), Some(raw)) = (&data.structures, &data.structure_resources) else { return Ok(None); @@ -166,7 +168,7 @@ impl StructureState { possible_sets, by_step, starts: Mutex::new(HashMap::new()), - rings: OnceLock::new(), + rings, ring_work: OnceLock::new(), })) } From 34d1ef651041e704f24cf279d3f818c6015e2596 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 01:40:47 +0200 Subject: [PATCH 25/59] Launcher: complete prepared versions that lack the run-time reports The game reads the data generator's registries.json (and commands.json) next to the resources (#573). Versions whose resources the launcher copied from another installed version, or that were prepared before the preparer put the reports there, have them only in the scratch output of the version that ran the data generator, if anywhere. At start, on `versions`/`update` and before starting the game or a server, the launcher now copies them in from the version's own scratch output or any installed version pinning the same server jar, so existing installs can join servers again without preparing again. Complements #576 (the preparer and the client side of #573). Co-Authored-By: Claude Opus 5.5 --- launcher/src/backend.rs | 130 +++++++++++++++++++++++++++++++++++++++- 1 file changed, 127 insertions(+), 3 deletions(-) diff --git a/launcher/src/backend.rs b/launcher/src/backend.rs index 898364040..4f5d00ca0 100644 --- a/launcher/src/backend.rs +++ b/launcher/src/backend.rs @@ -583,6 +583,7 @@ fn reuse_prepared(versions: &Path, tag: &str) -> Option { /// `reuse_prepared` for every installed version that is not prepared, oldest first, so a /// version prepared this way can serve the next. Launchers before 0.1.4 installed new versions /// without it; this catches those up. Returns each (version, where its resources came from). +/// Prepared versions also get the run-time reports they lack (`complete_reports`). pub fn reuse_prepared_everywhere() -> Vec<(String, String)> { reuse_prepared_in(&versions_dir()) } @@ -590,9 +591,72 @@ pub fn reuse_prepared_everywhere() -> Vec<(String, String)> { fn reuse_prepared_in(versions: &Path) -> Vec<(String, String)> { let mut tags = installed_in(versions); tags.reverse(); - tags.into_iter() - .filter_map(|tag| reuse_prepared(versions, &tag).map(|from| (tag, from))) - .collect() + let reused = tags + .iter() + .filter_map(|tag| reuse_prepared(versions, tag).map(|from| (tag.clone(), from))) + .collect(); + for tag in &tags { + complete_reports(versions, tag); + } + reused +} + +/// The data generator reports the game reads at run time: the built-in registries' network ids +/// (without them no server can be joined or hosted) and the command tree. +const RUNTIME_REPORTS: [&str; 2] = ["registries.json", "commands.json"]; + +/// Puts the data generator reports the game reads at run time (`RUNTIME_REPORTS`) into a prepared version's +/// resources when they are missing. Preparers before they shipped there left them only in the +/// scratch output of the version that ran the data generator (`.local/datagen/out/reports`), +/// and resources copied from another version (`reuse_prepared`) came without them. They depend +/// only on the server jar, so the version's own scratch output or any installed version pinning +/// the same jar serves, and no new preparation is needed. Returns whether all are there. +fn complete_reports(versions: &Path, tag: &str) -> bool { + let target = versions.join(tag); + let to = resources_at(&target); + if !to.join(RESOURCES_MANIFEST).exists() { + return false; + } + let missing: Vec<_> = RUNTIME_REPORTS + .iter() + .filter(|name| !to.join(name).is_file()) + .collect(); + if missing.is_empty() { + return true; + } + let server = |dir: &Path| { + read_json(&dir.join("research-lock.json")).and_then(|lock| { + let pins = ["version", "server_sha1"].map(|k| lock["minecraft"][k].clone()); + pins.iter().all(|v| v.is_string()).then_some(pins) + }) + }; + let Some(pins) = server(&target) else { + return false; + }; + let reports = |dir: &Path| dir.join(".local/datagen/out/reports"); + let mut sources = vec![reports(&target)]; + for other in installed_in(versions).into_iter().filter(|t| t != tag) { + let dir = versions.join(&other); + if server(&dir).as_ref() == Some(&pins) { + sources.push(resources_at(&dir)); + sources.push(reports(&dir)); + } + } + let mut complete = true; + for name in missing { + let Some(from) = sources.iter().map(|s| s.join(name)).find(|p| p.is_file()) else { + complete = false; + continue; + }; + // Copied beside it and renamed: an interrupted copy never looks complete. + let partial = to.join(format!(".{name}.partial-{}", std::process::id())); + let copied = fs::copy(&from, &partial).and_then(|_| fs::rename(&partial, to.join(name))); + if copied.is_err() { + let _ = fs::remove_file(&partial); + complete = false; + } + } + complete } /// The official launcher's game directory, else the first other launcher's found @@ -1113,6 +1177,7 @@ pub fn server_dir(requested: Option) -> PathBuf { fn need_prepared(tag: &str) -> Result<(), String> { if is_prepared(tag) { + complete_reports(&versions_dir(), tag); Ok(()) } else { Err(format!( @@ -2092,6 +2157,65 @@ mod tests { let _ = fs::remove_dir_all(&versions); } + #[test] + fn prepared_versions_get_the_run_time_reports_without_preparing_again() { + let versions = std::env::temp_dir().join(format!( + "horizon-launcher-reports-test-{}", + std::process::id() + )); + let _ = fs::remove_dir_all(&versions); + let write = |tag: &str, path: &str, text: &str| { + let path = versions.join(tag).join(path); + fs::create_dir_all(path.parent().unwrap()).unwrap(); + fs::write(path, text).unwrap(); + }; + let release = |tag: &str, server: &str| { + write(tag, COMPLETE, ""); + let lock = serde_json::json!({"minecraft": {"version": "26.3", "client_sha1": "c", "server_sha1": server}}); + write(tag, "research-lock.json", &lock.to_string()); + write( + tag, + &format!(".local/horizon-client/26.3/{RESOURCES_MANIFEST}"), + "{}", + ); + }; + let resources = |tag: &str| resources_at(&versions.join(tag)); + let datagen = |tag: &str, name: &str| { + write(tag, &format!(".local/datagen/out/reports/{name}"), tag); + }; + + // Prepared before the reports shipped with the resources: its own scratch output. + release("v2026.10.13", "s"); + datagen("v2026.10.13", "registries.json"); + datagen("v2026.10.13", "commands.json"); + // Resources copied from it: the reports come from the version that ran the generator. + release("v2026.10.14", "s"); + // Another server jar: the reports of the others would be wrong, and it has none. + release("v2026.10.15", "other"); + assert!(reuse_prepared_in(&versions).is_empty()); + for tag in ["v2026.10.13", "v2026.10.14"] { + for name in RUNTIME_REPORTS { + assert_eq!( + fs::read_to_string(resources(tag).join(name)).unwrap(), + "v2026.10.13" + ); + } + } + assert!(!resources("v2026.10.15").join("registries.json").exists()); + assert!(!complete_reports(&versions, "v2026.10.15")); + // Once there they stay as they are, even when the scratch output is gone. + fs::remove_dir_all(versions.join("v2026.10.13/.local/datagen")).unwrap(); + assert!(complete_reports(&versions, "v2026.10.13")); + let left: Vec<_> = fs::read_dir(resources("v2026.10.14")) + .unwrap() + .flatten() + .map(|e| e.file_name().into_string().unwrap()) + .filter(|n| n.contains("partial")) + .collect(); + assert!(left.is_empty()); + let _ = fs::remove_dir_all(&versions); + } + #[test] fn finds_the_app_bundle_around_the_binary() { let exe = Path::new("/Applications/Horizon.app/Contents/MacOS/horizon-launcher"); From a024409a1a66e99ee335622d0943b9e78aae9e7d Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 19:41:02 -0400 Subject: [PATCH 26/59] Show live connection packet rates and server brands in F3 --- crates/horizon-client/src/debug_chart.rs | 39 +++++++++++++++++ crates/horizon-client/src/game/debug_keys.rs | 45 +++++++++++++------- crates/horizon-client/src/game/integrated.rs | 12 +++++- crates/horizon-client/src/game/remote.rs | 7 +++ crates/horizon-client/src/net.rs | 44 ++++++++++++++++++- crates/horizon-protocol/src/connection.rs | 2 + 6 files changed, 131 insertions(+), 18 deletions(-) diff --git a/crates/horizon-client/src/debug_chart.rs b/crates/horizon-client/src/debug_chart.rs index d006a8ab6..35fd40bd4 100644 --- a/crates/horizon-client/src/debug_chart.rs +++ b/crates/horizon-client/src/debug_chart.rs @@ -74,6 +74,10 @@ pub struct DebugCharts { pub bandwidth: SampleLogger, /// `MinecraftServer.smoothedTickTimeMillis`. pub smoothed_tick_ms: f32, + /// Connection's smoothed packets per second, sent then received. + pub packet_rates: [f32; 2], + packet_totals: [i64; 2], + packet_tick: u8, previous_tick: Option, bytes_seen: Option, } @@ -113,6 +117,9 @@ impl DebugCharts { self.previous_tick = None; self.bytes_seen = None; self.smoothed_tick_ms = 0.0; + self.packet_rates = [0.0; 2]; + self.packet_totals = [0; 2]; + self.packet_tick = 0; } /// One integrated server tick that started at `started` and ran its /// tick method for `method` (`MinecraftServer.logFullTickTime` and @@ -136,6 +143,17 @@ impl DebugCharts { } self.bytes_seen = Some(total); } + /// `Connection.tickSecond`: sampled on the first tick, then every 20 ticks. + pub fn log_packets(&mut self, totals: [i64; 2]) { + if self.packet_tick == 0 { + for (i, total) in totals.into_iter().enumerate() { + let count = (total - self.packet_totals[i]).max(0) as f32; + self.packet_rates[i] = count + 0.75 * (self.packet_rates[i] - count); + } + self.packet_totals = totals; + } + self.packet_tick = (self.packet_tick + 1) % 20; + } /// The charts along the bottom of the screen (`extractRenderState`): /// frame times left and tick times right, or bandwidth left (remote /// servers only) and ping right. `mspt` is the level's milliseconds @@ -524,6 +542,27 @@ mod tests { assert!(draws.contains(&fill(361, 174, 365, 178, 0xFF0A_141E))); } + #[test] + fn packet_rates_follow_connection_smoothing_and_reset_between_worlds() { + let mut charts = DebugCharts::default(); + charts.log_packets([80, 400]); + assert_eq!(charts.packet_rates, [20.0, 100.0]); + for _ in 1..20 { + charts.log_packets([180, 800]); + } + assert_eq!(charts.packet_rates, [20.0, 100.0]); + charts.log_packets([180, 800]); + assert_eq!(charts.packet_rates, [40.0, 175.0]); + for _ in 0..20 { + charts.log_packets([180, 800]); + } + assert_eq!(charts.packet_rates, [30.0, 131.25]); + charts.reset(); + assert_eq!(charts.packet_rates, [0.0, 0.0]); + charts.log_packets([4, 8]); + assert_eq!(charts.packet_rates, [1.0, 2.0]); + } + #[test] fn ticks_and_bandwidth_log_their_differences() { let mut c = DebugCharts::default(); diff --git a/crates/horizon-client/src/game/debug_keys.rs b/crates/horizon-client/src/game/debug_keys.rs index 3aac02ae7..6eba74062 100644 --- a/crates/horizon-client/src/game/debug_keys.rs +++ b/crates/horizon-client/src/game/debug_keys.rs @@ -194,15 +194,17 @@ impl Game<'_> { } return; }; - let received = r - .session - .counters - .lock() - .unwrap() - .as_ref() - .map(|c| c.bytes_in.load(std::sync::atomic::Ordering::Relaxed)); - if let Some(total) = received { - self.debug_charts.log_bandwidth(total); + let received = r.session.counters.lock().unwrap().as_ref().map(|c| { + let order = std::sync::atomic::Ordering::Relaxed; + [ + c.bytes_in.load(order), + c.sent.load(order), + c.received.load(order), + ] + }); + if let Some([bytes, sent, received]) = received { + self.debug_charts.log_bandwidth(bytes); + self.debug_charts.log_packets([sent, received]); } if shown { use horizon_protocol::packets::{play::Serverbound, status::Ping}; @@ -403,8 +405,9 @@ impl Game<'_> { ], ); } - // tps: DebugEntryTps for the integrated server (it counts no packets). - if self.player.is_some() && self.remote.is_none() { + // tps: DebugEntryTps for local and remote connections. + if self.player.is_some() { + let [tx, rx] = self.debug_charts.packet_rates.map(|n| n.round() as i64); let (target, status) = if self.clock.sprinting() { ("-".to_owned(), " (sprinting)") } else if self.clock.stepping() { @@ -417,10 +420,22 @@ impl Game<'_> { } else { (format!("{:.1}", 1000.0 / self.clock.rate()), "") }; - d.line(format!( - "Integrated server @ {:.1}/{target} ms{status}, 0 tx, 0 rx", - self.debug_charts.smoothed_tick_ms - )); + if self.remote.is_none() || self.integrated.is_some() { + let tick_ms = self + .integrated + .as_ref() + .map_or(self.debug_charts.smoothed_tick_ms, |server| { + server.smoothed_tick_ms() + }); + d.line(format!( + "Integrated server @ {tick_ms:.1}/{target} ms{status}, {tx} tx, {rx} rx", + )); + } else if let Some(remote) = &self.remote { + d.line(format!( + "\"{}\" server{status}, {tx} tx, {rx} rx", + remote.brand + )); + } } let (left, right) = d.columns(&self.debug_chart_lines()); let atlas = &self.atlas; diff --git a/crates/horizon-client/src/game/integrated.rs b/crates/horizon-client/src/game/integrated.rs index 6edbb6e40..9c3b34e02 100644 --- a/crates/horizon-client/src/game/integrated.rs +++ b/crates/horizon-client/src/game/integrated.rs @@ -26,7 +26,7 @@ use std::{ path::Path, sync::{ Arc, - atomic::{AtomicBool, Ordering}, + atomic::{AtomicBool, AtomicU32, Ordering}, mpsc::{Sender, channel}, }, thread::JoinHandle, @@ -39,6 +39,7 @@ struct Flags { /// `Minecraft.pause`: a single-player pause screen is open. paused: AtomicBool, stop: AtomicBool, + smoothed_tick_ms: AtomicU32, } /// The window's handle on its server thread. @@ -47,6 +48,9 @@ pub(super) struct Integrated { thread: Option>, } impl Integrated { + pub fn smoothed_tick_ms(&self) -> f32 { + f32::from_bits(self.flags.smoothed_tick_ms.load(Ordering::Relaxed)) + } /// `IntegratedServer.tickServer` skips the world while the game is paused. pub fn set_paused(&self, paused: bool) { self.flags.paused.store(paused, Ordering::Relaxed); @@ -233,7 +237,13 @@ impl Game<'_> { // Only the connections run. self.tick_lan(); } else { + let started = Instant::now(); self.tick()?; + self.debug_charts.log_tick(started, started.elapsed()); + flags.smoothed_tick_ms.store( + self.debug_charts.smoothed_tick_ms.to_bits(), + Ordering::Relaxed, + ); } let rate = self.clock.rate().max(1.0); next += Duration::from_secs_f64(1.0 / f64::from(rate)); diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index e31e270b8..48435b308 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -68,6 +68,7 @@ struct Lerp { pub(super) struct Remote { pub session: Session, + pub brand: String, builtin: Arc, lang: Arc, registries: Arc, @@ -238,6 +239,7 @@ impl Game<'_> { self.apply_settings(); self.remote = Some(Remote { session, + brand: "unknown".into(), builtin: Arc::new(builtin), lang, registries: Arc::new(Dynamic::default()), @@ -442,6 +444,11 @@ impl Game<'_> { r.status = format!("Joined as {name}; loading terrain..."); } } + Event::Brand(brand) => { + if let Some(remote) = &mut self.remote { + remote.brand = brand; + } + } Event::Reconfigured(registries) => self.set_registries(registries), Event::DecodeError(e) => { if let Some(r) = self.remote.as_mut() { diff --git a/crates/horizon-client/src/net.rs b/crates/horizon-client/src/net.rs index d260498a0..f9ad5992a 100644 --- a/crates/horizon-client/src/net.rs +++ b/crates/horizon-client/src/net.rs @@ -29,6 +29,8 @@ use std::{ pub enum Event { /// Progress text for the connecting screen. Status(String), + /// The server's `minecraft:brand` custom payload. + Brand(String), /// Configuration finished: the play state begins with these registries. Joined { registries: Arc, @@ -374,7 +376,7 @@ fn run( .map_err(e)?; let (mut reader, writer) = c.split(); *shared_writer.lock().unwrap() = Some(writer); - let registries = configure(&mut reader, shared_writer, lang)?; + let registries = configure(&mut reader, shared_writer, lang, send)?; let _ = send.send(Event::Joined { registries: Arc::new(registries), uuid: profile.uuid, @@ -413,10 +415,13 @@ fn run( } play::Clientbound::StartConfiguration(_) => { reply(play::Serverbound::ConfigurationAcknowledged(Empty)); - let registries = configure(&mut reader, shared_writer, lang)?; + let registries = configure(&mut reader, shared_writer, lang, send)?; let _ = send.send(Event::Reconfigured(Arc::new(registries))); } play::Clientbound::Disconnect(d) => return Ok(plain(&d.reason, lang)), + play::Clientbound::CustomPayload(p) if p.channel == "minecraft:brand" => { + receive_brand(&p, send); + } other => { if send.send(Event::Packet(Box::new(other))).is_err() { return Ok("Disconnected".into()); @@ -432,6 +437,7 @@ fn configure( reader: &mut ConnReader, writer: &Mutex>, lang: &Language, + send: &Sender, ) -> Result { let mut registries = Dynamic::default(); let reply = |p: cfg::Serverbound| -> Result<(), String> { @@ -444,6 +450,7 @@ fn configure( let (id, payload) = reader.recv().map_err(|e| e.to_string())?; match cfg::Clientbound::decode(id, &payload).map_err(|e| e.to_string())? { cfg::Clientbound::KeepAlive(k) => reply(cfg::Serverbound::KeepAlive(k))?, + cfg::Clientbound::CustomPayload(p) => receive_brand(&p, send), cfg::Clientbound::Ping(p) => reply(cfg::Serverbound::Pong(p))?, // Know no packs: the server then sends every registry entry in full. cfg::Clientbound::SelectKnownPacks(_) => { @@ -477,6 +484,14 @@ fn configure( } } +fn receive_brand(payload: &cfg::CustomPayload, send: &Sender) { + if payload.channel == "minecraft:brand" + && let Ok(brand) = horizon_protocol::buf::Reader::new(&payload.data).string(32767) + { + let _ = send.send(Event::Brand(brand)); + } +} + /// The minecraft:brand payload: a string naming the client. fn brand() -> Vec { let mut w = horizon_protocol::buf::Writer::new(); @@ -565,3 +580,28 @@ pub fn ping(address: &str, timeout: Duration) -> Result<(serde_json::Value, u128 let _ = c.recv().map_err(e)?; Ok((json, start.elapsed().as_millis())) } + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn server_brand_payload_is_decoded_and_invalid_or_unrelated_payloads_are_ignored() { + let (send, events) = channel(); + let mut writer = horizon_protocol::buf::Writer::new(); + writer.string("vanilla"); + let mut payload = cfg::CustomPayload { + channel: "minecraft:brand".into(), + data: writer.data, + }; + receive_brand(&payload, &send); + assert!(matches!(events.try_recv(), Ok(Event::Brand(brand)) if brand == "vanilla")); + payload.channel = "example:other".into(); + receive_brand(&payload, &send); + assert!(events.try_recv().is_err()); + payload.channel = "minecraft:brand".into(); + payload.data = vec![0xff]; + receive_brand(&payload, &send); + assert!(events.try_recv().is_err()); + } +} diff --git a/crates/horizon-protocol/src/connection.rs b/crates/horizon-protocol/src/connection.rs index 3c6087f2e..8329d9360 100644 --- a/crates/horizon-protocol/src/connection.rs +++ b/crates/horizon-protocol/src/connection.rs @@ -355,6 +355,8 @@ mod tests { big.extend(std::iter::repeat_n(3u8, 1000)); c.send(&big).unwrap(); assert_eq!(c.recv().unwrap(), (9, vec![1, 2])); + assert_eq!(c.reader.counters.sent.load(Ordering::Relaxed), 1); + assert_eq!(c.reader.counters.received.load(Ordering::Relaxed), 1); server.join().unwrap(); assert!(c.recv().is_err()); } From 2b1cd3e96e6f0da1d069c805041eb6a057f738a0 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 01:42:02 +0200 Subject: [PATCH 27/59] Name the launcher's real button in the incomplete-resources error The launcher offers "Prepare again", not a Repair action. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game/remote.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 0db8cca30..aa88896e8 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -186,7 +186,7 @@ impl Game<'_> { let root = self.options.resources.clone(); let builtin = Builtin::find(&root) .and_then(|p| Builtin::load(&p).ok()) - .ok_or("Resources are incomplete: registries.json is missing or invalid. Repair resources in the launcher (or run horizon-prepare), then try again.")?; + .ok_or("Resources are incomplete: registries.json is missing or invalid. Click \"Prepare again\" in the launcher (or run horizon-prepare), then try again.")?; let lang = Arc::new(horizon_client::net::load_language(&root)); let view = self.settings.render_distance.clamp(2, 32) as i8; if local.is_none() { From f03990f663e658379dd51790342205a57b263871 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 01:45:15 +0200 Subject: [PATCH 28/59] Integrated server: control socket and chat read the server's side With single player on its server thread, the window is the server's client, and some of what it answered was its own empty side: - `horizon-ctl save` and `save-all` returned ok without saving: the window's save skips worlds it is connected to. They now save on the server thread (`Integrated::call`). - `horizon-ctl chat-log` read the window's local chat, which never showed what the server said (command feedback, joins). It reads the connection's chat, as the agent's chat query already did. - The game's own messages (Open to LAN, screenshots...) went to that local chat, which is not drawn while connected: they now join the connection's chat. - `state` names the world (the server thread's `LevelName`). - The client follows its permission level (EntityEvent 24..28, LocalPlayer.setPermissionLevel), which the commands the chat offers and checks depend on. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game/agent.rs | 5 ++- crates/horizon-client/src/game/chat.rs | 6 ++++ crates/horizon-client/src/game/control.rs | 38 ++++++++++++++++------- crates/horizon-client/src/game/remote.rs | 10 +++++- 4 files changed, 45 insertions(+), 14 deletions(-) diff --git a/crates/horizon-client/src/game/agent.rs b/crates/horizon-client/src/game/agent.rs index cd39606b3..48b24bbb3 100644 --- a/crates/horizon-client/src/game/agent.rs +++ b/crates/horizon-client/src/game/agent.rs @@ -460,7 +460,10 @@ impl Game<'_> { json!({ "screen": self.screen_label(), "menu": self.title.as_ref().map(|_| self.title_value()), - "world": (self.title.is_none()).then(|| self.level.name.clone()), + "world": (self.title.is_none()).then(|| match &self.integrated { + Some(server) => server.world_name.clone(), + None => self.level.name.clone(), + }), "dimension": self.dim.id(), "gamemode": format!("{:?}", self.mode).to_lowercase(), "time": { "day_time": self.world.day_time, "day": self.world.day_time.div_euclid(24000), "time_of_day": self.world.day_time.rem_euclid(24000) }, diff --git a/crates/horizon-client/src/game/chat.rs b/crates/horizon-client/src/game/chat.rs index 8f6bed0ca..bcf6426e1 100644 --- a/crates/horizon-client/src/game/chat.rs +++ b/crates/horizon-client/src/game/chat.rs @@ -425,6 +425,12 @@ impl Game<'_> { capture.push(text); return; } + // Connected to a server (single player's own included), the chat on + // screen is the connection's: the game's own messages join it. + if self.remote.is_some() { + self.chat_line(text.plain()); + return; + } let focused = self.screen == Screen::Chat; let heard = self.mods.mods.is_running().then(|| text.plain()); self.ui.chat.add( diff --git a/crates/horizon-client/src/game/control.rs b/crates/horizon-client/src/game/control.rs index e1169b2c8..7b51fe8ee 100644 --- a/crates/horizon-client/src/game/control.rs +++ b/crates/horizon-client/src/game/control.rs @@ -475,7 +475,10 @@ impl Game<'_> { } "chat-log" => { let n = words.get(1).map_or(Ok(10), |n| n.parse())?; - Ok(Some(json!({ "chat": self.ui.chat.recent_lines(n) }))) + let lines = self + .remote_chat(n) + .unwrap_or_else(|| self.ui.chat.recent_lines(n)); + Ok(Some(json!({ "chat": lines }))) } "stats" => { let summary = self.frame_stats.summary(); @@ -549,18 +552,20 @@ impl Game<'_> { self.leave_server(None)?; ok() } - "save" => { + "save" | "save-all" => { self.require_world()?; - self.save_game()?; - ok() - } - "save-all" => { - // Like `save-all flush`: also rewrite chunks that were not modified - // (the save round-trip harness compares them with vanilla's files). - self.require_world()?; - let keys: Vec<_> = self.world.chunks.keys().copied().collect(); - self.world.modified.extend(keys); - self.save_game()?; + // `save-all` is like `save-all flush`: it also rewrites chunks + // that were not modified (the save round-trip harness compares + // them with vanilla's files). + let all = words[0] == "save-all"; + // Single player's world is its server thread's. + if let Some(server) = &self.integrated { + server + .call(move |g| g.control_save(all).map_err(|e| e.to_string())) + .ok_or("the integrated server stopped")??; + } else { + self.control_save(all)?; + } ok() } "dragon-hurt" => { @@ -581,6 +586,15 @@ impl Game<'_> { } } + /// `horizon-ctl save` and `save-all`. + fn control_save(&mut self, all: bool) -> Result<()> { + if all { + let keys: Vec<_> = self.world.chunks.keys().copied().collect(); + self.world.modified.extend(keys); + } + self.save_game() + } + fn require_world(&self) -> Result<()> { if self.title.is_some() { return Err("no world open; use: open WORLD [SEED] [creative]".into()); diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 8e4e973f2..c0829b43b 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -426,7 +426,7 @@ impl Game<'_> { } Some(stack) } - fn chat_line(&mut self, text: String) { + pub(super) fn chat_line(&mut self, text: String) { log::info!("[chat] {text}"); if let Some(r) = self.remote.as_mut() { r.chat.push((text, Instant::now())); @@ -1133,6 +1133,14 @@ impl Game<'_> { } } C::EntityEvent(p) => { + // EntityEvent.PERMISSION_LEVEL_ALL..OWNERS (24..=28) for this + // player: LocalPlayer.setPermissionLevel, which the commands + // the chat offers and checks follow. + if (24..=28).contains(&p.event) + && self.remote.as_ref().is_some_and(|r| r.entity_id == p.id) + { + self.ui.registries.permission = (p.event - 24) as u8; + } if p.event == 1 && let Some(m) = self.mobs.iter_mut().find(|m| m.id == p.id as u32) && m.species() == horizon_client::mobs::Species::Rabbit From 1fc3f6724e11a5a9f7fcd4660151d7243b85ac78 Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 19:59:23 -0400 Subject: [PATCH 29/59] Cancel block mining immediately when opening screens --- crates/horizon-client/src/game.rs | 3 +++ crates/horizon-client/src/game/hand.rs | 12 ++++++++++++ crates/horizon-client/src/game/remote.rs | 20 ++++++++++++-------- 3 files changed, 27 insertions(+), 8 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index e552eb118..5ffcd9124 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -3648,6 +3648,9 @@ impl Game<'_> { ) || self.book.is_some()) } fn capture(&mut self, capture: bool) { + if !capture { + self.stop_mining(); + } // The real pointer takes over from an agent's. self.agent_pointer = false; let Some(window) = &self.window else { return }; diff --git a/crates/horizon-client/src/game/hand.rs b/crates/horizon-client/src/game/hand.rs index 76d626716..431e6661a 100644 --- a/crates/horizon-client/src/game/hand.rs +++ b/crates/horizon-client/src/game/hand.rs @@ -30,6 +30,18 @@ fn attack_range_contains(range: &serde_json::Value, distance: f64, creative: boo } impl Game<'_> { + /// Opening a screen stops breaking before the next game tick (which may pause). + pub(super) fn stop_mining(&mut self) { + let mut destroying = std::mem::take(&mut self.clicks.destroying); + destroying.stop(&mut GameHands { + game: self, + error: None, + }); + self.clicks.destroying = destroying; + self.attack_clicks = 0; + self.stop_remote_mining(); + self.mining = None; + } /// `LivingEntity.swing` with `getModifiedSwingDuration`. pub(super) fn swing_hand(&mut self, hand: Hand, animation: SwingAnimation) { let effects = &self.potions.effects; diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index aa88896e8..525d6d2bb 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -2071,6 +2071,17 @@ impl Game<'_> { } } + pub(super) fn stop_remote_mining(&mut self) { + if let Some((pos, _, _)) = self.remote.as_mut().and_then(|r| r.destroying.take()) { + self.send(S::PlayerAction(play::PlayerAction { + action: 2, + pos, + direction: 0, + sequence: 0, + })); + } + } + /// MultiPlayerGameMode.startDestroyBlock / continueDestroyBlock. fn remote_mining(&mut self) { let Some(r) = self.remote.as_mut() else { @@ -2081,14 +2092,7 @@ impl Game<'_> { } let chatting = r.chat_input.is_some(); if !self.left || self.screen != Screen::Playing || chatting { - if let Some((pos, _, _)) = r.destroying.take() { - self.send(S::PlayerAction(play::PlayerAction { - action: 2, - pos, - direction: 0, - sequence: 0, - })); - } + self.stop_remote_mining(); self.mining = None; return; } From a01d47f28fc9ce3868d6954b46d0d1b3ed9be8a1 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sat, 17 Oct 2026 01:01:53 +0100 Subject: [PATCH 30/59] perf: share decoded block facts during client startup --- benchmarks/shared-json-startup-20261017.json | 93 ++++++++++++++ .../examples/shared_json_startup_profile.rs | 34 +++++ crates/horizon-client/src/blocks.rs | 116 ++++++++++++++++-- crates/horizon-client/src/blocks/decode.rs | 9 +- .../horizon-client/src/blocks/decode_tests.rs | 6 +- crates/horizon-client/src/game.rs | 8 +- .../horizon-client/src/mod_content_tests.rs | 76 +++++++++++- crates/horizon-world/src/level/data.rs | 93 +++++++++----- crates/horizon-world/src/level/mod.rs | 28 +++++ tools/profile_client_startup.py | 67 ++++++++++ 10 files changed, 476 insertions(+), 54 deletions(-) create mode 100644 benchmarks/shared-json-startup-20261017.json create mode 100644 crates/horizon-client/examples/shared_json_startup_profile.rs create mode 100644 tools/profile_client_startup.py diff --git a/benchmarks/shared-json-startup-20261017.json b/benchmarks/shared-json-startup-20261017.json new file mode 100644 index 000000000..92f557b33 --- /dev/null +++ b/benchmarks/shared-json-startup-20261017.json @@ -0,0 +1,93 @@ +{ + "scope": "Assets + block facts + behaviours loader only; excludes full startup", + "resources": ".local/horizon-client/26.3", + "repeats": 5, + "metrics": { + "baseline": { + "phase_ms": { + "median": 4730.402, + "samples": [ + 3258.541, + 6539.764, + 4773.735, + 3980.032, + 4730.402 + ] + }, + "total_ms": { + "median": 6325.026, + "samples": [ + 6596.141, + 7627.893, + 6296.443, + 5435.408, + 6325.026 + ] + }, + "cpu_ms": { + "median": 3199.722, + "samples": [ + 3322.801, + 3199.722, + 3227.438, + 3042.687, + 3144.658 + ] + }, + "peak_rss_kib": { + "median": 820000, + "samples": [ + 818540, + 820400, + 819352, + 820000, + 820128 + ] + } + }, + "shared": { + "phase_ms": { + "median": 1180.588, + "samples": [ + 869.228, + 842.213, + 1180.588, + 1560.087, + 1728.575 + ] + }, + "total_ms": { + "median": 2260.709, + "samples": [ + 1632.489, + 1553.753, + 2260.709, + 2879.728, + 3388.639 + ] + }, + "cpu_ms": { + "median": 1603.393, + "samples": [ + 1568.288, + 1432.106, + 1603.393, + 1604.423, + 1619.02 + ] + }, + "peak_rss_kib": { + "median": 351728, + "samples": [ + 353256, + 353664, + 351728, + 350724, + 351668 + ] + } + } + }, + "build": "cargo build --release -p horizon-client --example shared_json_startup_profile", + "limitations": "Loader-only wall-clock timings under concurrent machine load; not full startup or time to first frame. RSS includes Assets::load." +} diff --git a/crates/horizon-client/examples/shared_json_startup_profile.rs b/crates/horizon-client/examples/shared_json_startup_profile.rs new file mode 100644 index 000000000..6c906ea83 --- /dev/null +++ b/crates/horizon-client/examples/shared_json_startup_profile.rs @@ -0,0 +1,34 @@ +//! Profile the fact and behaviour table phase of client startup. +//! Run in separate processes for baseline and shared JSON modes to capture peak RSS. +use horizon_client::{assets::Assets, blocks::BlockFacts}; +use horizon_world::level::Behaviours; +use std::{path::Path, time::Instant}; + +fn main() -> Result<(), Box> { + let mut args = std::env::args().skip(1); + let root = args.next().ok_or("expected resource directory")?; + let mode = args.next().ok_or("expected baseline or shared")?; + if mode != "baseline" && mode != "shared" { + return Err("expected baseline or shared".into()); + } + let root = Path::new(&root); + let total = Instant::now(); + let assets = Assets::load(root)?; + let started = Instant::now(); + let (facts, behaviours) = if mode == "baseline" { + ( + BlockFacts::load(root, assets.registry)?, + Behaviours::load(assets.registry, root)?, + ) + } else { + let json: serde_json::Value = serde_json::from_reader(std::io::BufReader::new( + std::fs::File::open(root.join("block-behaviours.json"))?, + ))?; + BlockFacts::load_with_behaviours(root, assets.registry, &json)? + }; + println!("phase_ms={:.3}", started.elapsed().as_secs_f64() * 1000.0); + println!("total_ms={:.3}", total.elapsed().as_secs_f64() * 1000.0); + println!("states={}", facts.states.len()); + std::hint::black_box((facts, behaviours)); + Ok(()) +} diff --git a/crates/horizon-client/src/blocks.rs b/crates/horizon-client/src/blocks.rs index 521d389bc..63d451437 100644 --- a/crates/horizon-client/src/blocks.rs +++ b/crates/horizon-client/src/blocks.rs @@ -2,7 +2,10 @@ //! (`gameplay-facts.json`), indexed by registry state ID. mod decode; use crate::Result; -use horizon_world::registry::{BlockRegistry, BlockStateId}; +use horizon_world::{ + level::{Behaviours, GameplayStateSource}, + registry::{BlockRegistry, BlockStateId}, +}; use serde_json::Value; use std::{ collections::HashMap, @@ -113,6 +116,39 @@ pub struct BlockFacts { } impl BlockFacts { pub fn load(root: &Path, registry: &BlockRegistry) -> Result { + let behaviours: Value = serde_json::from_reader(BufReader::new(File::open( + root.join("block-behaviours.json"), + )?))?; + Self::load_with_behaviour_json(root, registry, &behaviours) + } + + pub fn load_with_behaviour_json( + root: &Path, + registry: &BlockRegistry, + behaviours: &Value, + ) -> Result { + Ok(Self::load_with_callback(root, registry, behaviours, |_| Ok(()))?.0) + } + + /// Build both tables from the same behaviour document and gameplay decoder. + pub fn load_with_behaviours( + root: &Path, + registry: &BlockRegistry, + behaviours: &Value, + ) -> Result<(Self, Behaviours)> { + Self::load_with_callback(root, registry, behaviours, |entries| { + Ok(Behaviours::load_with_gameplay( + registry, root, behaviours, entries, + )?) + }) + } + + fn load_with_callback( + root: &Path, + registry: &BlockRegistry, + behaviours: &Value, + callback: impl FnOnce(&[decode::Entry<'_>]) -> Result, + ) -> Result<(Self, T)> { let bytes = fs::read(root.join("gameplay-facts.json"))?; serde_json::from_slice::(&bytes)?; let raw: decode::Gameplay<'_> = serde_json::from_slice(&bytes)?; @@ -125,9 +161,6 @@ impl BlockFacts { return Err("gameplay facts do not match the block registry".into()); } // Class chains and per-state behaviour flags exported from the actual block objects. - let behaviours: Value = serde_json::from_reader(BufReader::new(File::open( - root.join("block-behaviours.json"), - )?))?; let behaviour_states = behaviours["states"] .as_array() .filter(|s| s.len() == registry.len()) @@ -221,13 +254,13 @@ impl BlockFacts { outline, outline_edges, name: intern(&state.name), - emission: entry.emission as u8, - dampening: entry.dampening as u8, + emission: entry.emission.as_f64().unwrap_or(0.0) as u8, + dampening: entry.dampening.as_f64().unwrap_or(0.0) as u8, skylight_down: entry.skylight_down, shape_occlusion: entry.shape_occlusion, can_occlude: entry.can_occlude, solid_render: entry.solid_render, - hardness: entry.hardness as f32, + hardness: entry.hardness.as_f64().unwrap_or(0.0) as f32, requires_tool: entry.requires_tool, replaceable: entry.replaceable, random_ticks: entry.random_ticks, @@ -264,12 +297,16 @@ impl BlockFacts { .ok_or("missing block behaviour class chain")?, }); } - Ok(Self { - states, - air: registry - .default_state("minecraft:air") - .ok_or("missing air")?, - }) + let extra = callback(entries)?; + Ok(( + Self { + states, + air: registry + .default_state("minecraft:air") + .ok_or("missing air")?, + }, + extra, + )) } pub fn get(&self, id: BlockStateId) -> &StateFacts { &self.states[id.0 as usize] @@ -281,3 +318,56 @@ impl BlockFacts { ) } } + +impl GameplayStateSource for decode::Entry<'_> { + fn flag(&self, name: &str) -> bool { + match name { + "replaceable" => self.replaceable, + "random_ticks" => self.random_ticks, + "solid_render" => self.solid_render, + "liquid" => self.liquid, + "block_entity" => self.block_entity, + "ignited_by_lava" => self.ignited_by_lava, + "can_occlude" => self.can_occlude, + "full_collision" => self.full_collision, + "skylight_down" => self.skylight_down, + "requires_tool" => self.requires_tool, + "shape_occlusion" => self.shape_occlusion, + _ => false, + } + } + fn unsigned(&self, name: &str) -> u64 { + match name { + "emission" => self.emission.as_u64().unwrap_or(0), + "dampening" => self.dampening.as_u64().unwrap_or(0), + _ => 0, + } + } + fn number(&self, name: &str) -> f64 { + match name { + "hardness" => self.hardness.as_f64().unwrap_or(0.0), + _ => 0.0, + } + } + fn text(&self, name: &str) -> &str { + match name { + "push" => self.push.as_deref().unwrap_or(""), + _ => "", + } + } + fn sound_number(&self, name: &str) -> f64 { + match name { + "volume" => self.sound.volume, + "pitch" => self.sound.pitch, + _ => 1.0, + } + } + fn sound_id(&self, name: &str) -> &str { + match name { + "place" => self.sound.place.id.as_deref().unwrap_or(""), + "break" => self.sound.r#break.id.as_deref().unwrap_or(""), + "fall" => self.sound.fall.id.as_deref().unwrap_or(""), + _ => "", + } + } +} diff --git a/crates/horizon-client/src/blocks/decode.rs b/crates/horizon-client/src/blocks/decode.rs index 967955f9e..7feb3ac41 100644 --- a/crates/horizon-client/src/blocks/decode.rs +++ b/crates/horizon-client/src/blocks/decode.rs @@ -155,17 +155,20 @@ object!(Sound<'a> { }); object!(Entry<'a> { id: Option = None => value(unsigned), - emission: f64 = 0.0 => value(number), - dampening: f64 = 0.0 => value(number), + emission: Value = Value::Null => typed, + dampening: Value = Value::Null => typed, skylight_down: bool = false => value(flag), shape_occlusion: bool = false => value(flag), can_occlude: bool = false => value(flag), solid_render: bool = false => value(flag), - hardness: f64 = 0.0 => value(number), + hardness: Value = Value::Null => typed, requires_tool: bool = false => value(flag), replaceable: bool = false => value(flag), random_ticks: bool = false => value(flag), block_entity: bool = false => value(flag), + liquid: bool = false => value(flag), + ignited_by_lava: bool = false => value(flag), + push: Option = None => value(text), render_shape: Option = None => value(text), full_collision: bool = false => value(flag), friction: f64 = 0.0 => value(number), diff --git a/crates/horizon-client/src/blocks/decode_tests.rs b/crates/horizon-client/src/blocks/decode_tests.rs index d9d0e14fd..8fdb93f4f 100644 --- a/crates/horizon-client/src/blocks/decode_tests.rs +++ b/crates/horizon-client/src/blocks/decode_tests.rs @@ -89,9 +89,9 @@ fn typed_fields_keep_defaults_duplicates_and_wrong_type_behavior() -> crate::Res assert_eq!(entries[1].id, None); let e = &entries[2]; assert_eq!(e.id, Some(2)); - assert_eq!(e.emission, 4.5); - assert_eq!(e.dampening, 0.0); - assert_eq!(e.hardness.to_bits(), (-0.0f64).to_bits()); + assert_eq!(e.emission.as_f64(), Some(4.5)); + assert_eq!(e.dampening.as_f64().unwrap_or(0.0), 0.0); + assert_eq!(e.hardness.as_f64().unwrap().to_bits(), (-0.0f64).to_bits()); assert!(e.skylight_down && e.outline_offset.unwrap_or(e.offset)); assert_eq!(e.item, None); assert_eq!(e.render_shape, None); diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index e552eb118..01c3adb1a 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -10169,7 +10169,11 @@ pub fn run() -> Result<()> { let root = options.resources.clone(); let assets = Arc::new(assets); log::info!("load assets: {:.2}s", started.elapsed().as_secs_f32()); - let facts = BlockFacts::load(&root, assets.registry)?; + let behaviour_json: serde_json::Value = serde_json::from_reader(std::io::BufReader::new( + std::fs::File::open(root.join("block-behaviours.json"))?, + ))?; + let (facts, behaviours) = + BlockFacts::load_with_behaviours(&root, assets.registry, &behaviour_json)?; 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()); @@ -10236,7 +10240,7 @@ pub fn run() -> Result<()> { 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(registry_owner.registry, &root)?, + behaviours, mob_types: MobTypes::load(&root)? .types .into_iter() diff --git a/crates/horizon-client/src/mod_content_tests.rs b/crates/horizon-client/src/mod_content_tests.rs index 6dd92ecfd..88df3b5fb 100644 --- a/crates/horizon-client/src/mod_content_tests.rs +++ b/crates/horizon-client/src/mod_content_tests.rs @@ -49,8 +49,13 @@ fn tags_merge_without_repeats() { } fn prepared() -> Option { - let root = Path::new(env!("CARGO_MANIFEST_DIR")).join("../../.local/horizon-client/26.3"); - root.join("gameplay-facts.json").exists().then_some(root) + let manifest = Path::new(env!("CARGO_MANIFEST_DIR")); + [ + manifest.join("../../.local/horizon-client/26.3"), + manifest.join("../../../../.local/horizon-client/26.3"), + ] + .into_iter() + .find(|root| root.join("gameplay-facts.json").exists()) } /// A content mod folder: a full block, a door and an item-less glass from @@ -137,6 +142,28 @@ fn content_root_loads_with_every_table() { let old_facts = BlockFacts::load(&base, old).unwrap(); let facts = BlockFacts::load(&root, new).unwrap(); + let shared_json: serde_json::Value = serde_json::from_reader(std::io::BufReader::new( + fs::File::open(root.join("block-behaviours.json")).unwrap(), + )) + .unwrap(); + let (shared_facts, shared_behaviours) = + BlockFacts::load_with_behaviours(&root, new, &shared_json).unwrap(); + let independent_behaviours = horizon_world::level::Behaviours::load(new, &root).unwrap(); + assert_eq!(shared_facts.states.len(), facts.states.len()); + for state in [ruby, ruby_door, BlockStateId(n + 65)] { + assert_eq!(shared_facts.get(state).hardness, facts.get(state).hardness); + assert_eq!(shared_facts.get(state).emission, facts.get(state).emission); + assert_eq!(shared_facts.get(state).classes, facts.get(state).classes); + assert_eq!( + shared_behaviours.facts(state).flags, + independent_behaviours.facts(state).flags, + ); + assert_eq!( + shared_behaviours.data(state).sounds.place, + independent_behaviours.data(state).sounds.place, + ); + } + let (a, b) = (old_facts.get(iron), facts.get(ruby)); assert_eq!((b.hardness, b.emission, b.friction), (4.0, 3, 0.8)); assert_eq!(b.explosion_resistance, a.explosion_resistance); @@ -216,3 +243,48 @@ fn no_content_keeps_the_base_root() { } use horizon_world::registry::BlockStateId; + +#[test] +fn shared_behaviour_document_matches_independent_loaders() { + let Some(root) = prepared() else { return }; + let assets = Assets::load(&root).expect("assets"); + let doc: serde_json::Value = serde_json::from_reader(std::io::BufReader::new( + std::fs::File::open(root.join("block-behaviours.json")).unwrap(), + )) + .unwrap(); + let original = BlockFacts::load(&root, assets.registry).unwrap(); + let (shared, b) = BlockFacts::load_with_behaviours(&root, assets.registry, &doc).unwrap(); + assert_eq!(original.states.len(), shared.states.len()); + for (a, b) in original.states.iter().zip(&shared.states) { + assert_eq!(a.classes, b.classes); + assert_eq!(a.legacy_solid, b.legacy_solid); + assert_eq!(a.sturdy_full, b.sturdy_full); + assert_eq!(a.emission, b.emission); + assert_eq!(a.dampening, b.dampening); + assert_eq!(a.hardness, b.hardness); + assert_eq!(a.sounds.volume, b.sounds.volume); + assert_eq!(a.sounds.pitch, b.sounds.pitch); + } + let a = horizon_world::level::Behaviours::load(assets.registry, &root).unwrap(); + for id in 0..assets.registry.len() { + let state = horizon_world::registry::BlockStateId(id as u32); + let (a_state, b_state) = (a.facts(state), b.facts(state)); + assert_eq!(a_state.flags, b_state.flags); + assert_eq!(a_state.sturdy, b_state.sturdy); + assert_eq!(a_state.weak, b_state.weak); + assert_eq!(a_state.strong, b_state.strong); + assert_eq!(a_state.fluid, b_state.fluid); + assert_eq!(a_state.emission, b_state.emission); + assert_eq!(a_state.dampening, b_state.dampening); + assert_eq!(a_state.hardness, b_state.hardness); + assert_eq!(a_state.push, b_state.push); + assert_eq!(a_state.instrument, b_state.instrument); + assert_eq!(a_state.shape, b_state.shape); + let (a_sound, b_sound) = (&a.data(state).sounds, &b.data(state).sounds); + assert_eq!(a_sound.volume, b_sound.volume); + assert_eq!(a_sound.pitch, b_sound.pitch); + assert_eq!(a_sound.place, b_sound.place); + assert_eq!(a_sound.break_, b_sound.break_); + assert_eq!(a_sound.fall, b_sound.fall); + } +} diff --git a/crates/horizon-world/src/level/data.rs b/crates/horizon-world/src/level/data.rs index 455a2ed57..42f8f75de 100644 --- a/crates/horizon-world/src/level/data.rs +++ b/crates/horizon-world/src/level/data.rs @@ -1,6 +1,6 @@ //! Behaviour tables built once from the pinned client resources. use super::{ - Behaviours, + Behaviours, GameplayStateSource, classes::{Class, ClassSet, Interface}, states::{BlockId, PropKey, StateTable}, }; @@ -653,20 +653,37 @@ pub fn load_registry(root: &Path) -> io::Result { } pub(super) fn load(registry: &BlockRegistry, root: &Path) -> io::Result { + let behaviour = read_json(&root.join("block-behaviours.json"))?; + load_with_behaviour_json(registry, root, &behaviour) +} + +pub(super) fn load_with_behaviour_json( + registry: &BlockRegistry, + root: &Path, + behaviour: &Value, +) -> io::Result { + let gameplay = read_json(&root.join("gameplay-facts.json"))?; + let gameplay_states = gameplay["states"] + .as_array() + .ok_or_else(|| fail("missing gameplay states"))?; + load_with_gameplay(registry, root, behaviour, gameplay_states) +} + +pub(super) fn load_with_gameplay( + registry: &BlockRegistry, + root: &Path, + behaviour: &Value, + gameplay_states: &[G], +) -> io::Result { let mut table = StateTable::new(registry)?; let props = Props::resolve(&mut table); let named = Named::resolve(&table)?; - let behaviour = read_json(&root.join("block-behaviours.json"))?; - let gameplay = read_json(&root.join("gameplay-facts.json"))?; let blocks_json = behaviour["blocks"] .as_array() .ok_or_else(|| fail("missing behaviour blocks"))?; let states_json = behaviour["states"] .as_array() .ok_or_else(|| fail("missing behaviour states"))?; - let gameplay_states = gameplay["states"] - .as_array() - .ok_or_else(|| fail("missing gameplay states"))?; if blocks_json.len() != table.block_count() || states_json.len() != table.state_count() || gameplay_states.len() != table.state_count() @@ -798,7 +815,7 @@ pub(super) fn load(registry: &BlockRegistry, root: &Path) -> io::Result io::Result PushReaction::Push, "POPPED" => PushReaction::Popped, "IMMOVEABLE" => PushReaction::Immoveable, @@ -951,23 +964,13 @@ pub(super) fn load(registry: &BlockRegistry, root: &Path) -> io::Result Direction::Up, }; let default = table.default_state(block); - let sound = &gameplay_states[default.0 as usize]["sound"]; - let sound_id = |key: &str, strings: &mut HashMap>| { - interned( - strings, - sound - .get(key) - .and_then(|s| s.get("id")) - .and_then(Value::as_str) - .unwrap_or(""), - ) - }; + let sound = &gameplay_states[default.0 as usize]; let sounds = Arc::new(Sounds { - volume: sound.get("volume").and_then(Value::as_f64).unwrap_or(1.0) as f32, - pitch: sound.get("pitch").and_then(Value::as_f64).unwrap_or(1.0) as f32, - place: sound_id("place", &mut strings), - break_: sound_id("break", &mut strings), - fall: sound_id("fall", &mut strings), + volume: sound.sound_number("volume") as f32, + pitch: sound.sound_number("pitch") as f32, + place: interned(&mut strings, sound.sound_id("place")), + break_: interned(&mut strings, sound.sound_id("break")), + fall: interned(&mut strings, sound.sound_id("fall")), }); blocks.push(BlockData { class, @@ -1145,3 +1148,31 @@ fn instrument_index(name: &str) -> u8 { .position(|n| n.eq_ignore_ascii_case(name)) .map_or(0, |i| i as u8) } + +impl GameplayStateSource for Value { + fn flag(&self, name: &str) -> bool { + self.get(name).and_then(Value::as_bool).unwrap_or(false) + } + fn unsigned(&self, name: &str) -> u64 { + self.get(name).and_then(Value::as_u64).unwrap_or(0) + } + fn number(&self, name: &str) -> f64 { + self.get(name).and_then(Value::as_f64).unwrap_or(0.0) + } + fn text(&self, name: &str) -> &str { + self.get(name).and_then(Value::as_str).unwrap_or("") + } + fn sound_number(&self, name: &str) -> f64 { + self.get("sound") + .and_then(|s| s.get(name)) + .and_then(Value::as_f64) + .unwrap_or(1.0) + } + fn sound_id(&self, name: &str) -> &str { + self.get("sound") + .and_then(|s| s.get(name)) + .and_then(|s| s.get("id")) + .and_then(Value::as_str) + .unwrap_or("") + } +} diff --git a/crates/horizon-world/src/level/mod.rs b/crates/horizon-world/src/level/mod.rs index 00dd115db..dbd877fc5 100644 --- a/crates/horizon-world/src/level/mod.rs +++ b/crates/horizon-world/src/level/mod.rs @@ -431,6 +431,17 @@ pub fn raw_brightness(level: &L, pos: BlockPos, sky_dar (level.sky_light(pos) - sky_darken).max(level.block_light(pos)) } +/// Access only the gameplay fields needed by level behaviour tables. +/// Both the JSON fallback and the client's typed decoder implement this. +pub trait GameplayStateSource { + fn flag(&self, name: &str) -> bool; + fn unsigned(&self, name: &str) -> u64; + fn number(&self, name: &str) -> f64; + fn text(&self, name: &str) -> &str; + fn sound_number(&self, name: &str) -> f64; + fn sound_id(&self, name: &str) -> &str; +} + /// Immutable vanilla block-behaviour tables. Build once with [`Behaviours::load`]. pub struct Behaviours { pub table: StateTable, @@ -456,6 +467,23 @@ impl Behaviours { pub fn load(registry: &BlockRegistry, resources_dir: &Path) -> io::Result { data::load(registry, resources_dir) } + /// Reuse the client's typed gameplay projection while it is borrowed from the JSON bytes. + pub fn load_with_gameplay( + registry: &BlockRegistry, + resources_dir: &Path, + behaviour: &serde_json::Value, + gameplay: &[G], + ) -> io::Result { + data::load_with_gameplay(registry, resources_dir, behaviour, gameplay) + } + + pub fn load_with_behaviour_json( + registry: &BlockRegistry, + resources_dir: &Path, + behaviour: &serde_json::Value, + ) -> io::Result { + data::load_with_behaviour_json(registry, resources_dir, behaviour) + } pub fn facts(&self, state: BlockStateId) -> &StateFacts { &self.facts[state.0 as usize] } diff --git a/tools/profile_client_startup.py b/tools/profile_client_startup.py new file mode 100644 index 000000000..2549146c7 --- /dev/null +++ b/tools/profile_client_startup.py @@ -0,0 +1,67 @@ +#!/usr/bin/env python3 +"""Compare baseline and shared JSON parsing in the client startup table phase. + +Build first with `cargo build --release -p horizon-client --example shared_json_startup_profile`. +This covers Assets::load plus BlockFacts::load and Behaviours::load, not full game +startup, rendering, resource pack setup, or first frame. Peak RSS includes Assets. +""" +import argparse +import json +import os +import statistics +import subprocess +import tempfile +from pathlib import Path + + +def run(binary, resources, mode): + with tempfile.TemporaryFile(mode="w+t") as output: + proc = subprocess.Popen([str(binary), str(resources), mode], stdout=output, stderr=subprocess.PIPE) + _, status, usage = os.wait4(proc.pid, 0) + proc.returncode = os.waitstatus_to_exitcode(status) + _, stderr = proc.communicate() + if os.waitstatus_to_exitcode(status): + raise RuntimeError(f"{mode}: {stderr.decode(errors='replace')}") + output.seek(0) + fields = dict(line.rstrip().split("=", 1) for line in output if "=" in line) + return { + "phase_ms": float(fields["phase_ms"]), + "total_ms": float(fields["total_ms"]), + "cpu_ms": (usage.ru_utime + usage.ru_stime) * 1000.0, + "peak_rss_kib": usage.ru_maxrss, + } + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--binary", type=Path, default=Path("target/release/examples/shared_json_startup_profile")) + parser.add_argument("--resources", type=Path, default=Path(".local/horizon-client/26.3")) + parser.add_argument("--repeats", type=int, default=5) + parser.add_argument("--output", type=Path) + args = parser.parse_args() + if args.repeats < 1: + parser.error("--repeats must be positive") + binary, resources = args.binary.resolve(), args.resources.resolve() + if not binary.is_file() or not resources.is_dir(): + parser.error("binary or resources missing; build the example and prepare resources first") + samples = {"baseline": [], "shared": []} + for i in range(args.repeats): + for mode in (("baseline", "shared") if i % 2 == 0 else ("shared", "baseline")): + samples[mode].append(run(binary, resources, mode)) + result = { + "scope": "Assets + block facts + behaviours loader only; excludes full startup", + "resources": str(resources), + "repeats": args.repeats, + "metrics": {mode: {key: {"median": round(statistics.median(row[key] for row in rows), 3), + "samples": [round(row[key], 3) for row in rows]} + for key in rows[0]} for mode, rows in samples.items()}, + } + data = json.dumps(result, indent=2) + print(data) + if args.output: + args.output.parent.mkdir(parents=True, exist_ok=True) + args.output.write_text(data + "\n") + + +if __name__ == "__main__": + main() From 5d614f1cf6b4ffaad6dad90505a0928b638da6ed Mon Sep 17 00:00:00 2001 From: LookImEcho-Rick <62575172+LookImEcho-Rick@users.noreply.github.com> Date: Fri, 16 Oct 2026 19:01:57 -0500 Subject: [PATCH 31/59] fix(rendering): correct selection outline on translucent blocks --- .../examples/translucency_fixture.rs | 47 +++++++ crates/horizon-client/src/game.rs | 14 ++- crates/horizon-client/src/gfx.rs | 101 ++++++++++++--- crates/horizon-client/src/gfx/arena.rs | 32 +++-- crates/horizon-client/src/gfx/resident.rs | 3 + crates/horizon-client/src/gfx/translucency.rs | 119 ++++++++++++++++++ docs/media/issue563-outline-after.png | Bin 0 -> 154050 bytes docs/media/issue563-outline-before.png | Bin 0 -> 237583 bytes .../parity/VanillaTranslucencyOracle.java | 63 ++++++++++ tools/test_translucency_parity.py | 66 ++++++++++ 10 files changed, 422 insertions(+), 23 deletions(-) create mode 100644 crates/horizon-client/examples/translucency_fixture.rs create mode 100644 crates/horizon-client/src/gfx/translucency.rs create mode 100644 docs/media/issue563-outline-after.png create mode 100644 docs/media/issue563-outline-before.png create mode 100644 mods/horizon/src/test/java/dev/horizonlab/parity/VanillaTranslucencyOracle.java create mode 100644 tools/test_translucency_parity.py diff --git a/crates/horizon-client/examples/translucency_fixture.rs b/crates/horizon-client/examples/translucency_fixture.rs new file mode 100644 index 000000000..11083d6b2 --- /dev/null +++ b/crates/horizon-client/examples/translucency_fixture.rs @@ -0,0 +1,47 @@ +//! Transport for the vanilla quad sorting / viewpoint parity gate. +use horizon_client::gfx::translucency::{SortState, Sorter, quad_center}; +use serde::Deserialize; +use serde_json::json; +use std::{ + fs, + io::{BufWriter, Write}, +}; + +#[derive(Deserialize)] +struct Case { + origin: [i32; 3], + quads: Vec<[[f32; 3]; 4]>, + cameras: Vec<[f64; 3]>, +} + +fn main() -> Result<(), Box> { + let args: Vec<_> = std::env::args().skip(1).collect(); + let [input, output] = args.as_slice() else { + return Err("usage: translucency_fixture INPUT OUTPUT".into()); + }; + let mut out = BufWriter::new(fs::File::create(output)?); + for line in fs::read_to_string(input)?.lines() { + let case: Case = serde_json::from_str(line)?; + let centers: Vec<_> = case.quads.iter().map(|q| quad_center(q[0], q[2])).collect(); + let mut state = SortState::new(centers.clone()); + let mut sorter = Sorter::default(); + let mut cache_sorter = Sorter::default(); + let frames: Vec<_> = case + .cameras + .iter() + .map(|&camera| { + let update = state + .update(camera, case.origin, &mut cache_sorter) + .is_some(); + let local = std::array::from_fn(|i| (camera[i] - f64::from(case.origin[i])) as f32); + json!({"indices": sorter.sort(¢ers, local), "update": update}) + }) + .collect(); + let bits: Vec<_> = centers + .iter() + .map(|c| c.map(|f| f.to_bits() as i32)) + .collect(); + writeln!(out, "{}", json!({"centers": bits, "frames": frames}))?; + } + Ok(()) +} diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index e552eb118..47b7ab27b 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -8439,12 +8439,23 @@ impl Game<'_> { let debug_lines = horizon_client::gizmos::camera_relative(&lines, at, view); let debug_lines_on_top = horizon_client::gizmos::camera_relative(&on_top, at, view); let debug_crosshair = horizon_client::gizmos::camera_relative(&crosshair.on_top, at, view); - // LevelRenderer.renderHitOutline: the outline shape's edges. + // LevelExtractor.extractBlockOutline: model translucency controls draw order. + let mut outline_after_terrain = false; let outline = if self.screen == Screen::Playing && !self.spectator() { 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); + outline_after_terrain = self + .pack + .assets + .model_catalog + .collect(state, BlockPos::new(h.pos[0], h.pos[1], h.pos[2])) + .is_ok_and(|models| { + models + .iter() + .any(|(_, model)| model.faces.iter().any(|f| f.translucent)) + }); let o = if f.outline_offset { self.pack .context @@ -8594,6 +8605,7 @@ impl Game<'_> { }), dark_disc: self.dark_disc(camera), outline, + outline_after_terrain, debug_lines: &debug_lines, debug_lines_on_top: &debug_lines_on_top, debug_crosshair: &debug_crosshair, diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 4401ea22d..92c467057 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -64,6 +64,7 @@ mod pack_stages; pub mod panorama; mod resident; mod timing; +pub mod translucency; pub(crate) mod upload; mod world_post; @@ -98,6 +99,8 @@ struct SectionGpu { translucent: u32, /// The solid quads by facing: back-facing groups are skipped. faces: crate::mesher::FaceGroups, + sort: translucency::SortState, + sorted_indices: Option<(u32, u64)>, } /// Line segments the hit outline can hold. const MAX_OUTLINE_EDGES: u64 = 256; @@ -133,6 +136,8 @@ pub struct Frame<'a> { pub dark_disc: bool, /// The hit block outline as line segments (from, to) in world space. pub outline: Vec<[f64; 6]>, + /// `BlockOutlineRenderState.isTranslucent`: draw after translucent terrain. + pub outline_after_terrain: bool, /// `lines` with a colour and pixel width (`gizmos::camera_relative`): /// the fishing line and debug gizmos, depth tested, then gizmos drawn /// over everything. @@ -311,6 +316,9 @@ pub struct Renderer { depth: wgpu::TextureView, sections: resident::Resident, arena: arena::Arena, + sorted_indices: arena::Arena, + translucent_sorter: translucency::Sorter, + translucency_cursor: usize, /// `DrawIndexedIndirectArgs` for this frame's solid then translucent draws. indirect: wgpu::Buffer, indirect_capacity: u64, @@ -322,8 +330,8 @@ pub struct Renderer { /// `DrawIndexedIndirectArgs` words: index count, instance count, first /// index, base vertex, first instance. draws: Vec<[u32; 5]>, - /// The arena page of each of `draws`. - draw_pages: Vec, + /// Vertex arena page and optional sorted index arena page of each draw. + draw_pages: Vec<(u32, Option)>, /// Block-entity blocks per meshed section (world position, state id). block_entities: HashMap>, /// VisGraph face connectivity per meshed section (cave culling). @@ -707,7 +715,7 @@ impl Renderer { &terrain_buffers, tri, Some(wgpu::Face::Back), - false, + true, true, Some(alpha_blend), ); @@ -740,7 +748,7 @@ impl Renderer { &line_buffers, wgpu::PrimitiveTopology::TriangleStrip, None, - false, + true, true, Some(alpha_blend), ); @@ -1504,6 +1512,7 @@ impl Renderer { std::mem::size_of::() as u64, 1 << 20, ); + let sorted_indices = arena::Arena::indices(&device, 1 << 16); let indirect = device.create_buffer(&wgpu::BufferDescriptor { label: Some("Section draws"), size: 1024 * 20, @@ -1594,6 +1603,9 @@ impl Renderer { depth, sections: resident::Resident::default(), arena, + sorted_indices, + translucent_sorter: translucency::Sorter::default(), + translucency_cursor: 0, indirect, indirect_capacity: 1024, multi_draw, @@ -1761,6 +1773,10 @@ impl Renderer { } let vertices = (mesh.solid.len() + mesh.translucent.len()) as u64; let (page, start) = self.arena.alloc(&self.device, &self.queue, vertices); + let sorted_indices = (translucent > 0).then(|| { + self.sorted_indices + .alloc(&self.device, &self.queue, u64::from(translucent) * 6) + }); let stride = std::mem::size_of::() as u64; for (offset, part) in [(0, &mesh.solid), (mesh.solid.len(), &mesh.translucent)] { if !part.is_empty() { @@ -1781,6 +1797,15 @@ impl Renderer { solid, translucent, faces: mesh.faces, + sort: translucency::SortState::new( + mesh.translucent + .as_chunks::<4>() + .0 + .iter() + .map(|q| translucency::quad_center(q[0].pos, q[2].pos)) + .collect(), + ), + sorted_indices, }, ); } @@ -1791,17 +1816,19 @@ impl Renderer { fn draw_sections(&self, pass: &mut wgpu::RenderPass<'_>, first: u32, count: u32) { let (mut i, end) = (first as usize, (first + count) as usize); while i < end { - let page = self.draw_pages[i]; + let (page, index_page) = self.draw_pages[i]; let run = self.draw_pages[i..end] .iter() - .take_while(|&&p| p == page) + .take_while(|&&p| p == (page, index_page)) .count(); pass.set_vertex_buffer(0, self.arena.buffer(page).slice(..)); + 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); } else { for d in &self.draws[i..i + run] { - pass.draw_indexed(0..d[0], d[3] as i32, d[4]..d[4] + 1); + pass.draw_indexed(d[2]..d[2] + d[0], d[3] as i32, d[4]..d[4] + 1); } } i += run; @@ -1809,6 +1836,10 @@ impl Renderer { } fn release_section(&mut self, key: SectionKey) { if let Some(s) = self.sections.remove(key) { + if let Some((page, start)) = s.sorted_indices { + self.sorted_indices + .release(page, start, u64::from(s.translucent) * 6); + } self.arena .release(s.page, s.start, u64::from(s.solid + s.translucent) * 4); } @@ -1821,6 +1852,8 @@ impl Renderer { self.block_entities.clear(); self.sections.clear(); self.arena.clear(); + self.sorted_indices.clear(); + self.translucency_cursor = 0; self.occlusion.clear(); } pub fn remove(&mut self, key: SectionKey) { @@ -2263,19 +2296,51 @@ impl Renderer { 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); + self.draw_pages.push((s.page, None)); }); } 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. + let count = visible.len(); + let budget = (count / 8).max(15).min(count); + self.translucency_cursor %= count.max(1); for (i, v) in visible.iter().enumerate().rev() { - let s = self.sections.get(v.slot); - if s.translucent > 0 { + let s = self.sections.get_mut(v.slot); + if let Some((index_page, index_start)) = s.sorted_indices { + let nearby = (v.key.0 - camera_section.0).abs() <= 2 + && (v.key.1 - camera_section.1).abs() <= 2 + && (v.key.2 - camera_section.2).abs() <= 2; + let scheduled = (i + count - self.translucency_cursor) % count < budget; + let origin = [ + v.key.0 * 16, + crate::chunk::MIN_Y + v.key.1 * 16, + v.key.2 * 16, + ]; + if (!s.sort.is_sorted() || nearby || scheduled) + && let Some(indices) = + s.sort + .update(camera.to_array(), origin, &mut self.translucent_sorter) + { + self.uploads.buffer( + &mut encoder, + self.sorted_indices.buffer(index_page), + index_start * 4, + bytemuck::cast_slice(indices), + ); + } let first = s.start + u64::from(s.solid) * 4; - self.draws - .push([s.translucent * 6, 1, 0, first as u32, i as u32]); - self.draw_pages.push(s.page); + self.draws.push([ + s.translucent * 6, + 1, + index_start as u32, + first as u32, + i as u32, + ]); + self.draw_pages.push((s.page, Some(index_page))); } } + self.translucency_cursor += budget; let translucent_draws = self.draws.len() as u32 - solid_draws; if self.multi_draw && !self.draws.is_empty() { if self.draws.len() as u64 > self.indirect_capacity { @@ -2537,7 +2602,7 @@ impl Renderer { pass.draw_indexed(0..additive_quads * 6, (world_quads * 4) as i32, 0..1); pass.set_bind_group(0, &self.group, &[]); } - if outline_edges > 0 { + if outline_edges > 0 && !frame.outline_after_terrain { pass.set_pipeline(&self.lines); pass.set_vertex_buffer(0, self.outline.slice(..)); pass.draw(0..4, 0..outline_edges as u32); @@ -2556,6 +2621,14 @@ impl Renderer { 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); + // LevelRenderer.executeClassicTransparency: translucent targets' + // outlines follow terrain, so its blending cannot wash them out. + if outline_edges > 0 && frame.outline_after_terrain { + pass.set_pipeline(&self.lines); + pass.set_vertex_buffer(0, self.outline.slice(..)); + pass.draw(0..4, 0..outline_edges as u32); + } + pass.set_index_buffer(self.indices.slice(..), wgpu::IndexFormat::Uint32); // LevelRenderer: the world border after translucent terrain and weather. if let Some(b) = frame.border.as_ref().filter(|_| !frame.title) { pass.set_pipeline(&self.border_pipeline); diff --git a/crates/horizon-client/src/gfx/arena.rs b/crates/horizon-client/src/gfx/arena.rs index 4793dab85..233333e04 100644 --- a/crates/horizon-client/src/gfx/arena.rs +++ b/crates/horizon-client/src/gfx/arena.rs @@ -52,31 +52,47 @@ pub struct Arena { pages: Vec, stride: u64, page_limit: u64, + usage: wgpu::BufferUsages, } impl Arena { pub fn new(device: &wgpu::Device, stride: u64, capacity: u64) -> Self { + Self::with_usage(device, stride, capacity, wgpu::BufferUsages::VERTEX) + } + pub fn indices(device: &wgpu::Device, capacity: u64) -> Self { + Self::with_usage(device, 4, capacity, wgpu::BufferUsages::INDEX) + } + fn with_usage( + device: &wgpu::Device, + stride: u64, + capacity: u64, + usage: wgpu::BufferUsages, + ) -> Self { // 256 MiB pages, or less where the device's buffers are smaller. let bytes = device.limits().max_buffer_size.min(256 << 20); let page_limit = (bytes / stride) / GRAIN * GRAIN; let capacity = capacity.next_multiple_of(GRAIN).min(page_limit); Self { pages: vec![Page { - buffer: Self::create(device, stride, capacity), + buffer: Self::create(device, stride, capacity, usage), capacity, free: FreeList::new(capacity), }], stride, page_limit, + usage, } } - fn create(device: &wgpu::Device, stride: u64, capacity: u64) -> wgpu::Buffer { + fn create( + device: &wgpu::Device, + stride: u64, + capacity: u64, + usage: wgpu::BufferUsages, + ) -> wgpu::Buffer { device.create_buffer(&wgpu::BufferDescriptor { - label: Some("Section vertex arena"), + label: Some("Section buffer arena"), size: capacity * stride, - usage: wgpu::BufferUsages::VERTEX - | wgpu::BufferUsages::COPY_DST - | wgpu::BufferUsages::COPY_SRC, + usage: usage | wgpu::BufferUsages::COPY_DST | wgpu::BufferUsages::COPY_SRC, mapped_at_creation: false, }) } @@ -121,7 +137,7 @@ impl Arena { let mut free = FreeList::new(capacity); let start = free.take(len).expect("a new page fits one section"); self.pages.push(Page { - buffer: Self::create(device, self.stride, capacity), + buffer: Self::create(device, self.stride, capacity, self.usage), capacity, free, }); @@ -133,7 +149,7 @@ impl Arena { } fn grow(&mut self, device: &wgpu::Device, queue: &wgpu::Queue, page: usize, capacity: u64) { let capacity = capacity.next_multiple_of(GRAIN).min(self.page_limit); - let buffer = Self::create(device, self.stride, capacity); + let buffer = Self::create(device, self.stride, capacity, self.usage); let old = &mut self.pages[page]; let mut encoder = device.create_command_encoder(&wgpu::CommandEncoderDescriptor { label: Some("Grow section arena"), diff --git a/crates/horizon-client/src/gfx/resident.rs b/crates/horizon-client/src/gfx/resident.rs index 58e187090..4547b3db3 100644 --- a/crates/horizon-client/src/gfx/resident.rs +++ b/crates/horizon-client/src/gfx/resident.rs @@ -58,6 +58,9 @@ impl Resident { pub fn get(&self, slot: u32) -> &T { &self.items[slot as usize].1 } + pub fn get_mut(&mut self, slot: u32) -> &mut T { + &mut self.items[slot as usize].1 + } pub fn clear(&mut self) { self.items.clear(); self.slots.clear(); diff --git a/crates/horizon-client/src/gfx/translucency.rs b/crates/horizon-client/src/gfx/translucency.rs new file mode 100644 index 000000000..927152a39 --- /dev/null +++ b/crates/horizon-client/src/gfx/translucency.rs @@ -0,0 +1,119 @@ +//! Vanilla 26.3 MeshData.SortState / VertexSorting.byDistance. +//! Keep vertex order intact; only the quad indices change as the camera moves. + +/// MeshData.decodeQuadCentroids uses the opposite corners, not all four vertices. +pub fn quad_center(a: [f32; 3], b: [f32; 3]) -> [f32; 3] { + std::array::from_fn(|i| (a[i] + b[i]) / 2.0) +} + +#[derive(Default)] +pub struct Sorter { + order: Vec<(u32, f32)>, + indices: Vec, +} + +impl Sorter { + pub fn sort(&mut self, centers: &[[f32; 3]], camera: [f32; 3]) -> &[u32] { + self.order.clear(); + self.order.extend(centers.iter().enumerate().map(|(i, c)| { + let [x, y, z] = std::array::from_fn(|j| camera[j] - c[j]); + (i as u32, x * x + y * y + z * z) + })); + // VertexSorting uses a stable merge sort, preserving mesh order for ties. + self.order.sort_by(|a, b| b.1.total_cmp(&a.1)); + self.indices.clear(); + for &(quad, _) in &self.order { + let v = quad * 4; + self.indices.extend([v, v + 1, v + 2, v + 2, v + 3, v]); + } + &self.indices + } +} + +pub struct SortState { + centers: Vec<[f32; 3]>, + last: Option<([i32; 3], [i32; 3])>, +} + +impl SortState { + pub fn new(centers: Vec<[f32; 3]>) -> Self { + Self { + centers, + last: None, + } + } + + pub fn is_sorted(&self) -> bool { + self.last.is_some() + } + + /// TranslucencyPointOfView and ResortTransparencyTask: diagonal views keep + /// their ordering until the point of view changes; aligned views also + /// resort on crossing a block boundary. Sub-block movement needs no upload. + pub fn update<'a>( + &mut self, + camera: [f64; 3], + origin: [i32; 3], + sorter: &'a mut Sorter, + ) -> Option<&'a [u32]> { + let block = camera.map(|v| v.floor() as i32); + let pov = std::array::from_fn(|i| ((block[i] >> 4) - (origin[i] >> 4)).clamp(-1, 1)); + if let Some((last_block, last_pov)) = self.last + && last_pov == pov + && (last_block == block || !pov.contains(&0)) + { + return None; + } + self.last = Some((block, pov)); + Some(sorter.sort( + &self.centers, + std::array::from_fn(|i| (camera[i] - f64::from(origin[i])) as f32), + )) + } +} + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn equal_distances_keep_mesh_order_and_triangle_winding() { + let mut sorter = Sorter::default(); + assert_eq!( + sorter.sort( + &[[1.0, 0.0, 0.0], [-1.0, 0.0, 0.0], [4.0, 0.0, 0.0]], + [0.0; 3] + ), + &[8, 9, 10, 10, 11, 8, 0, 1, 2, 2, 3, 0, 4, 5, 6, 6, 7, 4] + ); + assert!(sorter.sort(&[], [0.0; 3]).is_empty()); + } + + #[test] + fn movement_reverses_faces_without_moving_vertices() { + let centers = [[0.5, 0.5, 0.0], [0.5, 0.5, 1.0]]; + let mut sorter = Sorter::default(); + assert_eq!(sorter.sort(¢ers, [0.5, 0.5, -2.0])[0], 4); + assert_eq!(sorter.sort(¢ers, [0.5, 0.5, 3.0])[0], 0); + } + + #[test] + fn cached_viewpoint_handles_negative_and_large_coordinates() { + let origin = [-30_000_000, -64, 30_000_000]; + let mut state = SortState::new(vec![[0.5; 3]]); + let mut sorter = Sorter::default(); + let camera = [-29_999_999.5, -63.5, 30_000_000.5]; + assert!(state.update(camera, origin, &mut sorter).is_some()); + assert!(state.update(camera, origin, &mut sorter).is_none()); + assert!( + state + .update([-29_999_999.1, -63.1, 30_000_000.9], origin, &mut sorter) + .is_none() + ); + assert!( + state + .update([-29_999_998.9, -63.1, 30_000_000.9], origin, &mut sorter) + .is_some() + ); + } +} diff --git a/docs/media/issue563-outline-after.png b/docs/media/issue563-outline-after.png new file mode 100644 index 0000000000000000000000000000000000000000..ac1041b9669b375fbce63e497290ea9ddcb0dff9 GIT binary patch literal 154050 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
    GVua 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�B4)0k^}>~qDf2ynfiU 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
    IGdQ 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
      j@8*sG*pdKtgVO`3Tc8sd(v`E5e!s( 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 literal 0 HcmV?d00001 diff --git a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaTranslucencyOracle.java b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaTranslucencyOracle.java new file mode 100644 index 000000000..0dd308d45 --- /dev/null +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaTranslucencyOracle.java @@ -0,0 +1,63 @@ +package dev.horizonlab.parity; + +import com.google.gson.*; +import com.mojang.blaze3d.vertex.*; +import com.mojang.renderpearl.api.pipeline.IndexType; +import java.nio.*; +import java.nio.file.*; +import net.minecraft.client.renderer.chunk.TranslucencyPointOfView; +import net.minecraft.core.BlockPos; +import net.minecraft.core.SectionPos; +import net.minecraft.world.phys.Vec3; + +/** Original probe calling the pinned game's centroid, sorting and index writers. */ +public final class VanillaTranslucencyOracle { + public static void main(String[] args) throws Exception { + try (var out = Files.newBufferedWriter(Path.of(args[1]))) { + for (String line : Files.readAllLines(Path.of(args[0]))) { + JsonObject input = JsonParser.parseString(line).getAsJsonObject(); + JsonArray quads = input.getAsJsonArray("quads"); + ByteBuffer vertices = ByteBuffer.allocate(quads.size() * 48).order(ByteOrder.nativeOrder()); + for (JsonElement quad : quads) + for (JsonElement vertex : quad.getAsJsonArray()) + for (JsonElement component : vertex.getAsJsonArray()) vertices.putFloat(component.getAsFloat()); + vertices.flip(); + CompactVectorArray centers = new CompactVectorArray(quads.size()); + MeshData.decodeQuadCentroids(vertices, quads.size() * 4, DefaultVertexFormat.POSITION, centers, 0); + JsonArray centerBits = new JsonArray(); + for (int i = 0; i < centers.size(); i++) { + JsonArray c = new JsonArray(); + c.add(Float.floatToIntBits(centers.getX(i))); + c.add(Float.floatToIntBits(centers.getY(i))); + c.add(Float.floatToIntBits(centers.getZ(i))); + centerBits.add(c); + } + JsonArray origin = input.getAsJsonArray("origin"); + int ox = origin.get(0).getAsInt(), oy = origin.get(1).getAsInt(), oz = origin.get(2).getAsInt(); + long section = SectionPos.asLong(ox >> 4, oy >> 4, oz >> 4); + BlockPos lastBlock = null; + TranslucencyPointOfView lastPov = null; + JsonArray frames = new JsonArray(); + for (JsonElement element : input.getAsJsonArray("cameras")) { + JsonArray c = element.getAsJsonArray(); + Vec3 camera = new Vec3(c.get(0).getAsDouble(), c.get(1).getAsDouble(), c.get(2).getAsDouble()); + BlockPos block = BlockPos.containing(camera); + TranslucencyPointOfView pov = TranslucencyPointOfView.of(camera, section); + boolean update = lastPov == null || !lastPov.equals(pov) || (!block.equals(lastBlock) && pov.isAxisAligned()); + if (update) { lastPov = pov; lastBlock = block; } + var sorting = VertexSorting.byDistance((float)(camera.x - ox), (float)(camera.y - oy), (float)(camera.z - oz)); + ByteBuffer buffer = ByteBuffer.allocate(quads.size() * 24).order(ByteOrder.nativeOrder()); + new MeshData.SortState(centers, IndexType.INT).writeSortedIndexBuffer(buffer, sorting); + buffer.flip(); + JsonArray indices = new JsonArray(); + while (buffer.hasRemaining()) indices.add(buffer.getInt()); + JsonObject frame = new JsonObject(); + frame.add("indices", indices); frame.addProperty("update", update); frames.add(frame); + } + JsonObject result = new JsonObject(); + result.add("centers", centerBits); result.add("frames", frames); + out.write(result.toString()); out.newLine(); + } + } + } +} diff --git a/tools/test_translucency_parity.py b/tools/test_translucency_parity.py new file mode 100644 index 000000000..fcf8d3842 --- /dev/null +++ b/tools/test_translucency_parity.py @@ -0,0 +1,66 @@ +#!/usr/bin/env python3 +"""Compare quad centroids, sorted triangle indices and cached viewpoints with vanilla 26.3.""" +import argparse +import json +import os +import random +import subprocess + +try: + from . import lab, test_rust_parity as base, test_model_baking_parity as baking +except ImportError: + import lab, test_rust_parity as base, test_model_baking_parity as baking + + +def cases(): + rng = random.Random(563) + # Equal distances and a skewed quad detect unstable ties and averaging all four corners. + yield {'origin': [0, 0, 0], 'quads': [ + [[-1, 0, 0]] * 4, [[1, 0, 0]] * 4, + [[0, 0, 0], [100, 100, 100], [2, 2, 2], [200, 200, 200]]], + 'cameras': [[0, 0, 0], [0.1, 0.1, 0.1], [1, 0, 0], [-1, 0, 0]]} + for count in [0, 1, 2, 64, *[rng.randrange(3, 100) for _ in range(200)]]: + origin = [rng.choice([-30000000, -64, -16, 0, 16, 30000000]) for _ in range(3)] + # SectionPos packs Y into fewer bits; world-border coordinates apply to X/Z. + origin[1] = rng.choice([-64, -16, 0, 16, 304]) + quads = [[[rng.uniform(-1, 17) for _ in range(3)] for _ in range(4)] for _ in range(count)] + # Walk through block and section boundaries, including negative and diagonal viewpoints. + cameras = [[o + d for o in origin] for d in [-32.5, -32.1, -31.9, -16, -0.1, 0, 0.9, 1.1, 15.9, 16, 32, 48]] + cameras += [[origin[i] + rng.uniform(-64, 64) for i in range(3)] for _ in range(8)] + yield {'origin': origin, 'quads': quads, 'cameras': cameras} + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument('--profile', default='fast', help='Cargo build profile') + args = parser.parse_args() + lock, jars, _ = base.verify_artifacts() + build = lab.LOCAL / 'translucency-parity' + classes = build / 'classes' + classes.mkdir(parents=True, exist_ok=True) + inputs = build / 'inputs.jsonl' + inputs.write_text(''.join(json.dumps(c) + '\n' for c in cases()), encoding='utf-8') + dependencies = os.pathsep.join(map(str, [jars['client'], *baking.client_libraries()])) + + def run(command, name): + with (build / (name + '.log')).open('w', encoding='utf-8') as log: + result = subprocess.run(list(map(str, command)), cwd=lab.ROOT, stdout=log, stderr=subprocess.STDOUT, timeout=600) + if result.returncode: + raise RuntimeError((build / (name + '.log')).read_text()[-4000:]) + + run(['javac', '--release', lock['minecraft']['java_major'], '-proc:none', '-cp', dependencies, '-d', classes, + lab.ROOT / 'mods/horizon/src/test/java/dev/horizonlab/parity/VanillaTranslucencyOracle.java'], 'compile-java') + vanilla, rust = build / 'vanilla.jsonl', build / 'rust.jsonl' + run(['java', '-cp', str(classes) + os.pathsep + dependencies, 'dev.horizonlab.parity.VanillaTranslucencyOracle', inputs, vanilla], 'vanilla') + run(['cargo', 'run', '--quiet', '--locked', '--profile', args.profile, '-p', 'horizon-client', '--example', 'translucency_fixture', '--', inputs, rust], 'rust') + expected = [json.loads(line) for line in vanilla.read_text().splitlines()] + actual = [json.loads(line) for line in rust.read_text().splitlines()] + assert len(expected) == len(actual), 'case count differs' + for i, (a, b) in enumerate(zip(expected, actual)): + assert a == b, f'sorting mismatch in case {i}; inspect {build}' + frames = sum(len(c['frames']) for c in expected) + print(f'translucency parity ok: {len(expected)} cases, {frames} camera views; centroids, indices and cache decisions match exactly') + + +if __name__ == '__main__': + main() From cf837118e98eae9b96e664d418c16bcc36091187 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sat, 17 Oct 2026 01:18:24 +0100 Subject: [PATCH 32/59] perf: defer behaviour construction and test fresh resource loads --- ...shared-json-startup-followup-20261017.json | 227 ++++++++++++++++++ .../examples/shared_json_startup_profile.rs | 22 +- crates/horizon-client/src/blocks.rs | 121 ++++++++++ crates/horizon-client/src/game.rs | 11 +- .../horizon-client/src/mod_content_tests.rs | 104 ++++++++ .../src/random_tick_sections.rs | 5 +- tools/profile_client_startup.py | 13 +- 7 files changed, 487 insertions(+), 16 deletions(-) create mode 100644 benchmarks/shared-json-startup-followup-20261017.json diff --git a/benchmarks/shared-json-startup-followup-20261017.json b/benchmarks/shared-json-startup-followup-20261017.json new file mode 100644 index 000000000..c828ac7b4 --- /dev/null +++ b/benchmarks/shared-json-startup-followup-20261017.json @@ -0,0 +1,227 @@ +{ + "scope": "Assets + block facts + behaviours loader only; excludes full startup", + "resources": ".local/horizon-client/26.3", + "repeats": 5, + "metrics": { + "baseline": { + "phase_ms": { + "median": 1996.921, + "samples": [ + 2213.335, + 1453.207, + 1637.901, + 1996.921, + 2010.335 + ], + "range": [ + 1453.207, + 2213.335 + ] + }, + "total_ms": { + "median": 4728.136, + "samples": [ + 5628.975, + 2147.329, + 2162.696, + 4728.136, + 6404.524 + ], + "range": [ + 2147.329, + 6404.524 + ] + }, + "cpu_ms": { + "median": 2514.776, + "samples": [ + 2919.908, + 2088.239, + 2212.892, + 2716.104, + 2514.776 + ], + "range": [ + 2088.239, + 2919.908 + ] + }, + "peak_rss_kib": { + "median": 819824, + "samples": [ + 819824, + 820872, + 820744, + 818980, + 818816 + ] + } + }, + "pr607": { + "phase_ms": { + "median": 586.707, + "samples": [ + 464.424, + 739.67, + 586.707, + 1373.307, + 509.266 + ], + "range": [ + 464.424, + 1373.307 + ] + }, + "total_ms": { + "median": 1128.6, + "samples": [ + 954.73, + 1764.614, + 1128.6, + 4312.528, + 1030.735 + ], + "range": [ + 954.73, + 4312.528 + ] + }, + "cpu_ms": { + "median": 1145.826, + "samples": [ + 981.058, + 1465.79, + 1145.826, + 1736.807, + 1056.992 + ], + "range": [ + 981.058, + 1736.807 + ] + }, + "peak_rss_kib": { + "median": 351900, + "samples": [ + 352164, + 351816, + 351900, + 352348, + 350492 + ] + } + }, + "shared": { + "phase_ms": { + "median": 560.117, + "samples": [ + 522.284, + 1255.75, + 560.117, + 2151.064, + 479.329 + ], + "range": [ + 479.329, + 2151.064 + ] + }, + "total_ms": { + "median": 1101.305, + "samples": [ + 1011.715, + 2565.449, + 1101.305, + 2960.186, + 1006.817 + ], + "range": [ + 1006.817, + 2960.186 + ] + }, + "cpu_ms": { + "median": 1128.214, + "samples": [ + 1035.19, + 1565.383, + 1128.214, + 1494.36, + 1031.198 + ], + "range": [ + 1031.198, + 1565.383 + ] + }, + "peak_rss_kib": { + "median": 351532, + "samples": [ + 351624, + 350540, + 351532, + 351716, + 350076 + ] + } + }, + "deferred": { + "phase_ms": { + "median": 564.046, + "samples": [ + 433.35, + 665.149, + 587.456, + 564.046, + 497.422 + ], + "range": [ + 433.35, + 665.149 + ] + }, + "total_ms": { + "median": 1143.129, + "samples": [ + 885.053, + 1143.129, + 1195.869, + 1074.27, + 1162.103 + ], + "range": [ + 885.053, + 1195.869 + ] + }, + "cpu_ms": { + "median": 1114.261, + "samples": [ + 910.946, + 1128.96, + 1194.638, + 1114.261, + 1073.823 + ], + "range": [ + 910.946, + 1194.638 + ] + }, + "peak_rss_kib": { + "median": 273776, + "samples": [ + 274320, + 273860, + 272548, + 273776, + 272520 + ] + } + } + }, + "baseline_commit": "e422bd13", + "pr607_commit": "a01d47f2", + "measurement": "same optimized binary, isolated processes in alternating forward/reverse four-mode runs", + "limitations": "Includes Assets::load, BlockFacts, Behaviours; excludes complete client startup, pack/mod root resolution, graphics and first frame. Different modes emulate the original independent, PR #607 at a01d47f2, paired and deferred startup sequences in the same release build. Machine was not idle. Elapsed times show high variance; no statistically established gain between PR, paired and deferred modes." +} diff --git a/crates/horizon-client/examples/shared_json_startup_profile.rs b/crates/horizon-client/examples/shared_json_startup_profile.rs index 6c906ea83..d6d4ba2fe 100644 --- a/crates/horizon-client/examples/shared_json_startup_profile.rs +++ b/crates/horizon-client/examples/shared_json_startup_profile.rs @@ -1,5 +1,7 @@ //! Profile the fact and behaviour table phase of client startup. -//! Run in separate processes for baseline and shared JSON modes to capture peak RSS. +//! Run each mode in a separate process to capture CPU usage and peak RSS. +//! The deferred mode evaluates both phases contiguously for fair loader comparison; +//! actual client startup performs other initialization between these phases. use horizon_client::{assets::Assets, blocks::BlockFacts}; use horizon_world::level::Behaviours; use std::{path::Path, time::Instant}; @@ -7,9 +9,9 @@ use std::{path::Path, time::Instant}; fn main() -> Result<(), Box> { let mut args = std::env::args().skip(1); let root = args.next().ok_or("expected resource directory")?; - let mode = args.next().ok_or("expected baseline or shared")?; - if mode != "baseline" && mode != "shared" { - return Err("expected baseline or shared".into()); + let mode = args.next().ok_or("expected baseline, pr607 or shared")?; + if !["baseline", "pr607", "shared", "deferred"].contains(&mode.as_str()) { + return Err("expected baseline, pr607 or shared".into()); } let root = Path::new(&root); let total = Instant::now(); @@ -20,11 +22,21 @@ fn main() -> Result<(), Box> { BlockFacts::load(root, assets.registry)?, Behaviours::load(assets.registry, root)?, ) - } else { + } else if mode == "pr607" { + // Original PR #607 sequence at a01d47f2, retained as a same-build comparator. let json: serde_json::Value = serde_json::from_reader(std::io::BufReader::new( std::fs::File::open(root.join("block-behaviours.json"))?, ))?; BlockFacts::load_with_behaviours(root, assets.registry, &json)? + } else if mode == "shared" { + BlockFacts::load_pair(root, assets.registry)? + } else { + let json: serde_json::Value = serde_json::from_reader(std::io::BufReader::new( + std::fs::File::open(root.join("block-behaviours.json"))?, + ))?; + let (facts, gameplay) = BlockFacts::load_with_projection(root, assets.registry, &json)?; + let behaviours = Behaviours::load_with_gameplay(assets.registry, root, &json, &gameplay)?; + (facts, behaviours) }; println!("phase_ms={:.3}", started.elapsed().as_secs_f64() * 1000.0); println!("total_ms={:.3}", total.elapsed().as_secs_f64() * 1000.0); diff --git a/crates/horizon-client/src/blocks.rs b/crates/horizon-client/src/blocks.rs index 63d451437..7c0b64f8d 100644 --- a/crates/horizon-client/src/blocks.rs +++ b/crates/horizon-client/src/blocks.rs @@ -110,6 +110,107 @@ impl StateFacts { self.classes.iter().any(|c| &**c == name) } } +/// Compact, owned behaviour inputs retained until the normal behaviour startup stage. +/// No borrowed gameplay JSON or process-wide cache survives the fact loader. +pub struct GameplayProjection { + flags: u16, + emission: u64, + dampening: u64, + hardness: f64, + push: Box, + volume: f64, + pitch: f64, + place: Box, + break_sound: Box, + fall: Box, +} + +impl GameplayProjection { + fn from_entry(entry: &decode::Entry<'_>) -> Self { + const FLAGS: [&str; 11] = [ + "replaceable", + "random_ticks", + "solid_render", + "liquid", + "block_entity", + "ignited_by_lava", + "can_occlude", + "full_collision", + "skylight_down", + "requires_tool", + "shape_occlusion", + ]; + Self { + flags: FLAGS.iter().enumerate().fold(0, |flags, (i, name)| { + flags | ((u16::from(entry.flag(name))) << i) + }), + emission: entry.unsigned("emission"), + dampening: entry.unsigned("dampening"), + hardness: entry.number("hardness"), + push: entry.text("push").into(), + volume: entry.sound_number("volume"), + pitch: entry.sound_number("pitch"), + place: entry.sound_id("place").into(), + break_sound: entry.sound_id("break").into(), + fall: entry.sound_id("fall").into(), + } + } +} + +impl GameplayStateSource for GameplayProjection { + fn flag(&self, name: &str) -> bool { + const FLAGS: [&str; 11] = [ + "replaceable", + "random_ticks", + "solid_render", + "liquid", + "block_entity", + "ignited_by_lava", + "can_occlude", + "full_collision", + "skylight_down", + "requires_tool", + "shape_occlusion", + ]; + FLAGS + .iter() + .position(|field| *field == name) + .is_some_and(|index| self.flags & (1 << index) != 0) + } + fn unsigned(&self, name: &str) -> u64 { + match name { + "emission" => self.emission, + "dampening" => self.dampening, + _ => 0, + } + } + fn number(&self, name: &str) -> f64 { + if name == "hardness" { + self.hardness + } else { + 0.0 + } + } + fn text(&self, name: &str) -> &str { + if name == "push" { &self.push } else { "" } + } + fn sound_number(&self, name: &str) -> f64 { + match name { + "volume" => self.volume, + "pitch" => self.pitch, + _ => 1.0, + } + } + fn sound_id(&self, name: &str) -> &str { + match name { + "place" => &self.place, + "break" => &self.break_sound, + "fall" => &self.fall, + _ => "", + } + } +} + pub struct BlockFacts { pub states: Vec, pub air: BlockStateId, @@ -122,6 +223,26 @@ impl BlockFacts { Self::load_with_behaviour_json(root, registry, &behaviours) } + /// Load both tables from one resource root, sharing each JSON decode. + /// No data is cached across calls: changes to prepared packs or mods are read again. + pub fn load_pair(root: &Path, registry: &BlockRegistry) -> Result<(Self, Behaviours)> { + let behaviours: Value = serde_json::from_reader(BufReader::new(File::open( + root.join("block-behaviours.json"), + )?))?; + Self::load_with_behaviours(root, registry, &behaviours) + } + + /// Decode state facts once, retaining only the small owned fields needed later. + pub fn load_with_projection( + root: &Path, + registry: &BlockRegistry, + behaviours: &Value, + ) -> Result<(Self, Vec)> { + Self::load_with_callback(root, registry, behaviours, |entries| { + Ok(entries.iter().map(GameplayProjection::from_entry).collect()) + }) + } + pub fn load_with_behaviour_json( root: &Path, registry: &BlockRegistry, diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 01c3adb1a..aa39019e5 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -10172,8 +10172,8 @@ pub fn run() -> Result<()> { let behaviour_json: serde_json::Value = serde_json::from_reader(std::io::BufReader::new( std::fs::File::open(root.join("block-behaviours.json"))?, ))?; - let (facts, behaviours) = - BlockFacts::load_with_behaviours(&root, assets.registry, &behaviour_json)?; + let (facts, gameplay_projection) = + BlockFacts::load_with_projection(&root, assets.registry, &behaviour_json)?; 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()); @@ -10240,7 +10240,12 @@ pub fn run() -> Result<()> { 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: Behaviours::load_with_gameplay( + registry_owner.registry, + &root, + &behaviour_json, + &gameplay_projection, + )?, mob_types: MobTypes::load(&root)? .types .into_iter() diff --git a/crates/horizon-client/src/mod_content_tests.rs b/crates/horizon-client/src/mod_content_tests.rs index 88df3b5fb..1ed154f33 100644 --- a/crates/horizon-client/src/mod_content_tests.rs +++ b/crates/horizon-client/src/mod_content_tests.rs @@ -149,9 +149,27 @@ fn content_root_loads_with_every_table() { let (shared_facts, shared_behaviours) = BlockFacts::load_with_behaviours(&root, new, &shared_json).unwrap(); let independent_behaviours = horizon_world::level::Behaviours::load(new, &root).unwrap(); + let (deferred_facts, gameplay) = + BlockFacts::load_with_projection(&root, new, &shared_json).unwrap(); + let deferred_behaviours = + horizon_world::level::Behaviours::load_with_gameplay(new, &root, &shared_json, &gameplay) + .unwrap(); assert_eq!(shared_facts.states.len(), facts.states.len()); for state in [ruby, ruby_door, BlockStateId(n + 65)] { assert_eq!(shared_facts.get(state).hardness, facts.get(state).hardness); + assert_eq!( + deferred_facts.get(state).hardness, + facts.get(state).hardness + ); + assert_eq!(deferred_facts.get(state).classes, facts.get(state).classes); + assert_eq!( + deferred_behaviours.facts(state).flags, + independent_behaviours.facts(state).flags + ); + assert_eq!( + deferred_behaviours.data(state).sounds.place, + independent_behaviours.data(state).sounds.place + ); assert_eq!(shared_facts.get(state).emission, facts.get(state).emission); assert_eq!(shared_facts.get(state).classes, facts.get(state).classes); assert_eq!( @@ -254,6 +272,16 @@ fn shared_behaviour_document_matches_independent_loaders() { .unwrap(); let original = BlockFacts::load(&root, assets.registry).unwrap(); let (shared, b) = BlockFacts::load_with_behaviours(&root, assets.registry, &doc).unwrap(); + let (deferred_facts, projection) = + BlockFacts::load_with_projection(&root, assets.registry, &doc).unwrap(); + let deferred = horizon_world::level::Behaviours::load_with_gameplay( + assets.registry, + &root, + &doc, + &projection, + ) + .unwrap(); + assert_eq!(deferred_facts.states.len(), shared.states.len()); assert_eq!(original.states.len(), shared.states.len()); for (a, b) in original.states.iter().zip(&shared.states) { assert_eq!(a.classes, b.classes); @@ -269,6 +297,12 @@ fn shared_behaviour_document_matches_independent_loaders() { for id in 0..assets.registry.len() { let state = horizon_world::registry::BlockStateId(id as u32); let (a_state, b_state) = (a.facts(state), b.facts(state)); + let deferred_state = deferred.facts(state); + assert_eq!(b_state.flags, deferred_state.flags); + assert_eq!(b_state.emission, deferred_state.emission); + assert_eq!(b_state.dampening, deferred_state.dampening); + assert_eq!(b_state.hardness, deferred_state.hardness); + assert_eq!(b_state.push, deferred_state.push); assert_eq!(a_state.flags, b_state.flags); assert_eq!(a_state.sturdy, b_state.sturdy); assert_eq!(a_state.weak, b_state.weak); @@ -288,3 +322,73 @@ fn shared_behaviour_document_matches_independent_loaders() { assert_eq!(a_sound.fall, b_sound.fall); } } + +#[cfg(unix)] +#[test] +fn independent_reloads_read_changed_behaviour_json_and_report_invalid_files() { + let Some(base) = prepared() else { return }; + let scratch = std::env::temp_dir().join(format!("horizon-json-reloads-{}", std::process::id())); + let _ = fs::remove_dir_all(&scratch); + fs::create_dir_all(&scratch).unwrap(); + // Keep the remaining resource tree intact without copying a huge prepared client. + for entry in fs::read_dir(&base).unwrap() { + let entry = entry.unwrap(); + #[cfg(unix)] + std::os::unix::fs::symlink(entry.path(), scratch.join(entry.file_name())).unwrap(); + } + let assets = Assets::load(&base).unwrap(); + let registry = assets.registry; + let original = fs::read(base.join("block-behaviours.json")).unwrap(); + fs::remove_file(scratch.join("block-behaviours.json")).unwrap(); + fs::write(scratch.join("block-behaviours.json"), &original).unwrap(); + let (facts, _) = BlockFacts::load_pair(&scratch, registry).unwrap(); + assert_eq!(facts.states.len(), registry.len()); + assert_eq!( + BlockFacts::load(&scratch, registry).unwrap().states.len(), + registry.len() + ); + assert!(horizon_world::level::Behaviours::load(registry, &scratch).is_ok()); + + fs::write(scratch.join("block-behaviours.json"), b"{").unwrap(); + assert!(BlockFacts::load_pair(&scratch, registry).is_err()); + assert!(BlockFacts::load(&scratch, registry).is_err()); + assert!(horizon_world::level::Behaviours::load(registry, &scratch).is_err()); + + fs::write(scratch.join("block-behaviours.json"), b"{}").unwrap(); + assert!(BlockFacts::load_pair(&scratch, registry).is_err()); + assert!(BlockFacts::load(&scratch, registry).is_err()); + assert!(horizon_world::level::Behaviours::load(registry, &scratch).is_err()); + + fs::write(scratch.join("block-behaviours.json"), original).unwrap(); + assert_eq!( + BlockFacts::load_pair(&scratch, registry) + .unwrap() + .0 + .states + .len(), + registry.len() + ); + fs::remove_file(scratch.join("gameplay-facts.json")).unwrap(); + fs::write(scratch.join("gameplay-facts.json"), b"{\"states\":[]}").unwrap(); + assert!(BlockFacts::load_pair(&scratch, registry).is_err()); + assert!(BlockFacts::load(&scratch, registry).is_err()); + assert!(horizon_world::level::Behaviours::load(registry, &scratch).is_err()); + fs::write(scratch.join("gameplay-facts.json"), b"{").unwrap(); + assert!(BlockFacts::load_pair(&scratch, registry).is_err()); + assert!(BlockFacts::load(&scratch, registry).is_err()); + assert!(horizon_world::level::Behaviours::load(registry, &scratch).is_err()); + fs::write( + scratch.join("gameplay-facts.json"), + fs::read(base.join("gameplay-facts.json")).unwrap(), + ) + .unwrap(); + assert_eq!( + BlockFacts::load_pair(&scratch, registry) + .unwrap() + .0 + .states + .len(), + registry.len() + ); + fs::remove_dir_all(&scratch).unwrap(); +} diff --git a/crates/horizon-client/src/random_tick_sections.rs b/crates/horizon-client/src/random_tick_sections.rs index d455c9e77..647636fd6 100644 --- a/crates/horizon-client/src/random_tick_sections.rs +++ b/crates/horizon-client/src/random_tick_sections.rs @@ -155,7 +155,7 @@ mod tick_parity { position::{BlockPos, ChunkPos}, random::{LegacyRandom, RandomSource}, }; - use horizon_world::level::{Behaviours, LevelAccess, LevelEvent, Ticks, data}; + use horizon_world::level::{LevelAccess, LevelEvent, Ticks, data}; use std::{cell::RefCell, path::PathBuf}; #[derive(Clone)] @@ -218,8 +218,7 @@ mod tick_parity { return; } let registry = data::load_registry(&root).unwrap(); - let mut facts = BlockFacts::load(&root, ®istry).unwrap(); - let behaviours = Behaviours::load(®istry, &root).unwrap(); + let (mut facts, behaviours) = BlockFacts::load_pair(&root, ®istry).unwrap(); let grass = registry.default_state("minecraft:grass_block").unwrap(); let chunk = |x| { let mut c = Chunk::empty(x, 0); diff --git a/tools/profile_client_startup.py b/tools/profile_client_startup.py index 2549146c7..1a9442e62 100644 --- a/tools/profile_client_startup.py +++ b/tools/profile_client_startup.py @@ -1,9 +1,12 @@ #!/usr/bin/env python3 -"""Compare baseline and shared JSON parsing in the client startup table phase. +"""Compare four JSON loading sequences in the client startup table phase. Build first with `cargo build --release -p horizon-client --example shared_json_startup_profile`. -This covers Assets::load plus BlockFacts::load and Behaviours::load, not full game -startup, rendering, resource pack setup, or first frame. Peak RSS includes Assets. +Modes: baseline uses independent public loaders, pr607 reproduces a01d47f2, +shared uses the paired wrapper, and deferred retains the projection until the +normal behaviour stage. All modes use one optimized executable. This covers +Assets::load plus BlockFacts and Behaviours loading; it excludes full startup, +rendering, resource-pack resolution and first frame. Peak RSS includes Assets. """ import argparse import json @@ -44,9 +47,9 @@ def main(): binary, resources = args.binary.resolve(), args.resources.resolve() if not binary.is_file() or not resources.is_dir(): parser.error("binary or resources missing; build the example and prepare resources first") - samples = {"baseline": [], "shared": []} + samples = {"baseline": [], "pr607": [], "shared": [], "deferred": []} for i in range(args.repeats): - for mode in (("baseline", "shared") if i % 2 == 0 else ("shared", "baseline")): + for mode in (("baseline", "pr607", "shared", "deferred") if i % 2 == 0 else ("deferred", "shared", "pr607", "baseline")): samples[mode].append(run(binary, resources, mode)) result = { "scope": "Assets + block facts + behaviours loader only; excludes full startup", From 3230b6b88d52e3de3474d596ecd67e4ce1c2a1c2 Mon Sep 17 00:00:00 2001 From: LookImEcho-Rick <62575172+LookImEcho-Rick@users.noreply.github.com> Date: Fri, 16 Oct 2026 19:24:05 -0500 Subject: [PATCH 33/59] Fix mouse capture when world loading completes --- crates/horizon-client/src/game.rs | 15 +++ crates/horizon-client/src/game/remote.rs | 1 + tests/test_world_input_capture.py | 149 +++++++++++++++++++++++ 3 files changed, 165 insertions(+) create mode 100644 tests/test_world_input_capture.py diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index e552eb118..690fedd2c 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -3091,6 +3091,7 @@ impl Game<'_> { self.eye = 1.62; self.previous_eye = 1.62; self.clock.reset(); + self.capture_loaded_world(); Ok(()) } fn tick(&mut self) -> Result<()> { @@ -3648,6 +3649,10 @@ impl Game<'_> { ) || self.book.is_some()) } fn capture(&mut self, capture: bool) { + // MouseHandler.grabMouse never captures an inactive window. + if capture && !self.focused { + return; + } // The real pointer takes over from an agent's. self.agent_pointer = false; let Some(window) = &self.window else { return }; @@ -3663,6 +3668,16 @@ impl Game<'_> { } window.set_cursor_visible(!self.captured); } + /// LevelLoadingScreen.onClose -> Gui.setScreen(null) -> grabMouse. + fn capture_loaded_world(&mut self) { + // Loading may finish after focus was lost or another screen opened. + if self.title.is_none() + && self.screen == Screen::Playing + && !self.remote.as_ref().is_some_and(|r| r.chat_input.is_some()) + { + self.capture(true); + } + } fn draw_item(&mut self, batch: &mut HudBatch, stack: &ItemStack, x: f32, y: f32) { // `GuiGraphics.renderItem`: the resolved item model (tints, foil and // special renderers included), then the decorations. diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index aa88896e8..4b51e9170 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -1820,6 +1820,7 @@ impl Game<'_> { if let Some(r) = self.remote.as_mut() { r.loaded_sent = true; } + self.capture_loaded_world(); } let stick = self.pad_move(); let Some(player) = self.player.as_mut() else { diff --git a/tests/test_world_input_capture.py b/tests/test_world_input_capture.py new file mode 100644 index 000000000..f4fa07b91 --- /dev/null +++ b/tests/test_world_input_capture.py @@ -0,0 +1,149 @@ +"""Exercise the client's capture methods without opening or focusing an OS window. + +The fixture substitutes only winit and mouse state. Method bodies come from the +client, so the assertions observe grab attempts, visibility and stored capture +state. Native Windows delivery remains a manual check. Vanilla 26.3 reference: +LevelLoadingScreen.tick/onClose, Gui.setScreen, MouseHandler.grabMouse/releaseMouse. +""" +from pathlib import Path +import os +import shutil +import subprocess +import tempfile +import unittest + + +ROOT = Path(__file__).resolve().parents[1] + + +def method(source, name): + start = source.index(f" fn {name}(") + opening = source.index("{", start) + depth = 1 + end = opening + 1 + while depth: + depth += (source[end] == "{") - (source[end] == "}") + end += 1 + return source[start:end] + + +class WorldInputCaptureTests(unittest.TestCase): + def test_loading_completion_wiring(self): + game = (ROOT / "crates/horizon-client/src/game.rs").read_text(encoding="utf-8") + remote = (ROOT / "crates/horizon-client/src/game/remote.rs").read_text(encoding="utf-8") + spawn = method(game, "spawn_player") + self.assertLess(spawn.index("self.player = Some(player)"), + spawn.index("self.capture_loaded_world()")) + tick = remote[remote.index(" pub(super) fn tick_remote("):] + ready = tick[tick.index("if self.remote.as_ref().is_some_and(|r| !r.loaded_sent)"):] + self.assertLess(ready.index("r.loaded_sent = true"), + ready.index("self.capture_loaded_world()")) + self.assertLess(ready.index("self.capture_loaded_world()"), + ready.index("let stick = self.pad_move()")) + + @unittest.skipUnless(shutil.which("rustc"), "requires Rust") + def test_capture_lifecycle(self): + source = (ROOT / "crates/horizon-client/src/game.rs").read_text(encoding="utf-8") + fixture = r''' +use std::cell::Cell; +#[derive(Clone, Copy, PartialEq)] +enum Screen { Playing, Paused, Inventory } +enum CursorGrabMode { Locked, Confined, None } +#[derive(Default)] +struct Window { grabs: Cell, visible: Cell, fail: bool } +impl Window { + fn set_cursor_grab(&self, mode: CursorGrabMode) -> Result<(), ()> { + if !matches!(mode, CursorGrabMode::None) { + self.grabs.set(self.grabs.get() + 1); + } + if self.fail { Err(()) } else { Ok(()) } + } + fn set_cursor_visible(&self, visible: bool) { self.visible.set(visible); } +} +#[derive(Default)] +struct Mouse { ignore_first: bool } +impl Mouse { fn set_ignore_first_move(&mut self) { self.ignore_first = true; } } +struct Remote { chat_input: Option<()> } +struct Game { + focused: bool, agent_pointer: bool, window: Option, mouse: Mouse, + captured: bool, title: Option<()>, screen: Screen, remote: Option, +} +impl Default for Game { + fn default() -> Self { + Self { focused: true, agent_pointer: false, window: Some(Window::default()), + mouse: Mouse::default(), captured: false, title: None, + screen: Screen::Playing, remote: None } + } +} +impl Game { +METHODS +} +fn main() { + // New and existing worlds, returning to title, and reopening a world. + for remote in [false, true] { + let mut game = Game::default(); + if remote { game.remote = Some(Remote { chat_input: None }); } + for _ in 0..3 { + game.title = Some(()); + game.capture(false); + game.capture_loaded_world(); + assert!(!game.captured); + game.title = None; + game.capture_loaded_world(); + assert!(game.captured); + assert!(game.mouse.ignore_first); + assert!(!game.window.as_ref().unwrap().visible.get()); + for screen in [Screen::Paused, Screen::Inventory] { + game.screen = screen; + game.capture(false); + game.capture_loaded_world(); + assert!(!game.captured); + assert!(game.window.as_ref().unwrap().visible.get()); + game.screen = Screen::Playing; + game.capture(true); + assert!(game.captured); + } + } + // Alt+Tab during loading: no native grab or agent-pointer reset. + game.focused = false; + game.capture(false); + assert!(!game.captured); + assert!(game.window.as_ref().unwrap().visible.get()); + game.agent_pointer = true; + let grabs = game.window.as_ref().unwrap().grabs.get(); + game.capture_loaded_world(); + game.capture(true); + assert!(!game.captured); + assert!(game.agent_pointer); + assert_eq!(game.window.as_ref().unwrap().grabs.get(), grabs); + game.focused = true; + assert!(!game.captured); // Focus alone does not resume gameplay. + game.capture(true); // Click or resume action. + assert!(game.captured); + } + let mut game = Game::default(); + game.remote = Some(Remote { chat_input: Some(()) }); + game.capture_loaded_world(); + assert!(!game.captured); + assert_eq!(game.window.as_ref().unwrap().grabs.get(), 0); + game.remote = None; + game.window.as_mut().unwrap().fail = true; + game.capture_loaded_world(); + assert!(!game.captured); + assert!(game.window.as_ref().unwrap().visible.get()); +} +''' + fixture = fixture.replace("METHODS", method(source, "capture") + "\n" + + method(source, "capture_loaded_world")) + with tempfile.TemporaryDirectory(prefix="horizon-input-") as folder: + folder = Path(folder) + rust = folder / "capture.rs" + binary = folder / ("capture.exe" if os.name == "nt" else "capture") + rust.write_text(fixture, encoding="utf-8") + subprocess.run(["rustc", "--edition=2024", str(rust), "-o", str(binary)], + check=True, capture_output=True, text=True, timeout=60) + subprocess.run([str(binary)], check=True, capture_output=True, text=True, timeout=10) + + +if __name__ == "__main__": + unittest.main() From cd61e11b566637372e2f259eebf12f486626e10e Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sat, 17 Oct 2026 01:42:34 +0100 Subject: [PATCH 34/59] perf: intern gameplay projection strings and verify resource overrides --- .../shared-json-historical-20261017.json | 188 ++++++++++++++++++ .../examples/shared_json_startup_profile.rs | 6 +- crates/horizon-client/src/blocks.rs | 32 ++- .../horizon-client/src/mod_content_tests.rs | 29 +++ tools/profile_client_startup.py | 25 ++- 5 files changed, 265 insertions(+), 15 deletions(-) create mode 100644 benchmarks/shared-json-historical-20261017.json diff --git a/benchmarks/shared-json-historical-20261017.json b/benchmarks/shared-json-historical-20261017.json new file mode 100644 index 000000000..2e0e7538f --- /dev/null +++ b/benchmarks/shared-json-historical-20261017.json @@ -0,0 +1,188 @@ +{ + "scope": "Assets + block facts + behaviours loader only; excludes full startup", + "resources": ".local/horizon-client/26.3", + "repeats": 5, + "comparison": "historical cf837118 release binary", + "reference_binary": "target/release/examples/shared_json_startup_profile-cf837118", + "metrics": { + "baseline": { + "phase_ms": { + "median": 1462.003, + "samples": [ + 1639.999, + 1506.864, + 1429.844, + 1462.003, + 1346.061 + ] + }, + "total_ms": { + "median": 1922.795, + "samples": [ + 3383.516, + 1990.554, + 1912.354, + 1922.795, + 1777.912 + ] + }, + "cpu_ms": { + "median": 1961.459, + "samples": [ + 2419.086, + 2021.457, + 1951.587, + 1961.459, + 1839.984 + ] + }, + "peak_rss_kib": { + "median": 820912, + "samples": [ + 819956, + 821052, + 820912, + 821792, + 820424 + ] + } + }, + "pr607": { + "phase_ms": { + "median": 486.715, + "samples": [ + 460.738, + 442.013, + 623.053, + 486.715, + 550.652 + ] + }, + "total_ms": { + "median": 948.089, + "samples": [ + 923.057, + 935.599, + 1109.64, + 948.089, + 1052.546 + ] + }, + "cpu_ms": { + "median": 968.424, + "samples": [ + 928.489, + 946.932, + 1128.431, + 968.424, + 1079.642 + ] + }, + "peak_rss_kib": { + "median": 351796, + "samples": [ + 351796, + 351844, + 351536, + 351532, + 351988 + ] + } + }, + "cf837118": { + "phase_ms": { + "median": 474.268, + "samples": [ + 443.122, + 474.268, + 520.497, + 433.525, + 532.058 + ] + }, + "total_ms": { + "median": 945.87, + "samples": [ + 934.722, + 945.87, + 1006.539, + 888.201, + 1032.6 + ] + }, + "cpu_ms": { + "median": 953.668, + "samples": [ + 941.957, + 953.668, + 1029.122, + 903.574, + 1065.025 + ] + }, + "peak_rss_kib": { + "median": 274476, + "samples": [ + 273448, + 274844, + 274476, + 274556, + 274252 + ] + } + }, + "current": { + "phase_ms": { + "median": 445.924, + "samples": [ + 472.165, + 427.797, + 419.288, + 445.924, + 524.211 + ] + }, + "total_ms": { + "median": 999.669, + "samples": [ + 999.669, + 892.616, + 1051.427, + 940.595, + 1112.158 + ] + }, + "cpu_ms": { + "median": 1001.24, + "samples": [ + 1001.24, + 887.874, + 1051.732, + 951.495, + 1132.208 + ] + }, + "peak_rss_kib": { + "median": 267604, + "samples": [ + 267716, + 267920, + 267448, + 267604, + 267344 + ] + } + } + }, + "builds": { + "current": "release example built at cf837118 + current uncommitted delta in PR #607 worktree", + "historical": "release example built at exact cf837118 commit, with same Cargo release profile and shared dependency target" + }, + "mode_commits": { + "baseline": "independent loader algorithm at e422bd13, executed in current binary", + "pr607": "shared early construction algorithm at a01d47f2, executed in current binary", + "cf837118": "exact historical binary at cf837118, deferred mode", + "current": "current PR worktree, deferred mode with interned strings" + }, + "limitations": "Loader-only (Assets + BlockFacts + Behaviours), no full client startup or first-frame timing. Same release profile but different compilation contexts for historical binary; hardware activity and cache warmth vary. CPU and elapsed differences between cf837118 and current are mixed and may be noise. Peak RSS is whole-process Linux ru_maxrss." +} diff --git a/crates/horizon-client/examples/shared_json_startup_profile.rs b/crates/horizon-client/examples/shared_json_startup_profile.rs index d6d4ba2fe..108e8b29d 100644 --- a/crates/horizon-client/examples/shared_json_startup_profile.rs +++ b/crates/horizon-client/examples/shared_json_startup_profile.rs @@ -9,9 +9,11 @@ use std::{path::Path, time::Instant}; fn main() -> Result<(), Box> { let mut args = std::env::args().skip(1); let root = args.next().ok_or("expected resource directory")?; - let mode = args.next().ok_or("expected baseline, pr607 or shared")?; + let mode = args + .next() + .ok_or("expected baseline, pr607, shared or deferred")?; if !["baseline", "pr607", "shared", "deferred"].contains(&mode.as_str()) { - return Err("expected baseline, pr607 or shared".into()); + return Err("expected baseline, pr607, shared or deferred".into()); } let root = Path::new(&root); let total = Instant::now(); diff --git a/crates/horizon-client/src/blocks.rs b/crates/horizon-client/src/blocks.rs index 7c0b64f8d..27a36396a 100644 --- a/crates/horizon-client/src/blocks.rs +++ b/crates/horizon-client/src/blocks.rs @@ -117,16 +117,24 @@ pub struct GameplayProjection { emission: u64, dampening: u64, hardness: f64, - push: Box, + push: Arc, volume: f64, pitch: f64, - place: Box, - break_sound: Box, - fall: Box, + place: Arc, + break_sound: Arc, + fall: Arc, } impl GameplayProjection { - fn from_entry(entry: &decode::Entry<'_>) -> Self { + fn from_entry(entry: &decode::Entry<'_>, strings: &mut HashMap>) -> Self { + fn intern(strings: &mut HashMap>, value: &str) -> Arc { + if let Some(existing) = strings.get(value) { + return Arc::clone(existing); + } + let value_arc: Arc = Arc::from(value); + strings.insert(value.to_owned(), Arc::clone(&value_arc)); + value_arc + } const FLAGS: [&str; 11] = [ "replaceable", "random_ticks", @@ -147,12 +155,12 @@ impl GameplayProjection { emission: entry.unsigned("emission"), dampening: entry.unsigned("dampening"), hardness: entry.number("hardness"), - push: entry.text("push").into(), + push: intern(strings, entry.text("push")), volume: entry.sound_number("volume"), pitch: entry.sound_number("pitch"), - place: entry.sound_id("place").into(), - break_sound: entry.sound_id("break").into(), - fall: entry.sound_id("fall").into(), + place: intern(strings, entry.sound_id("place")), + break_sound: intern(strings, entry.sound_id("break")), + fall: intern(strings, entry.sound_id("fall")), } } } @@ -239,7 +247,11 @@ impl BlockFacts { behaviours: &Value, ) -> Result<(Self, Vec)> { Self::load_with_callback(root, registry, behaviours, |entries| { - Ok(entries.iter().map(GameplayProjection::from_entry).collect()) + let mut strings = HashMap::new(); + Ok(entries + .iter() + .map(|entry| GameplayProjection::from_entry(entry, &mut strings)) + .collect()) }) } diff --git a/crates/horizon-client/src/mod_content_tests.rs b/crates/horizon-client/src/mod_content_tests.rs index 1ed154f33..66ad8eb2f 100644 --- a/crates/horizon-client/src/mod_content_tests.rs +++ b/crates/horizon-client/src/mod_content_tests.rs @@ -349,6 +349,35 @@ fn independent_reloads_read_changed_behaviour_json_and_report_invalid_files() { ); assert!(horizon_world::level::Behaviours::load(registry, &scratch).is_ok()); + // Override one exported state bit at the same path and verify that a later + // independent and paired read sees it while the original resource root does not. + let mut changed: serde_json::Value = serde_json::from_slice(&original).unwrap(); + let original_bits = changed["states"][0][1].as_u64().unwrap(); + changed["states"][0][1] = (original_bits ^ 1).into(); + fs::write( + scratch.join("block-behaviours.json"), + serde_json::to_vec(&changed).unwrap(), + ) + .unwrap(); + let changed_pair = BlockFacts::load_pair(&scratch, registry).unwrap(); + let changed_independent = BlockFacts::load(&scratch, registry).unwrap(); + let base_facts = BlockFacts::load(&base, registry).unwrap(); + let state = horizon_world::registry::BlockStateId(0); + assert_ne!( + changed_pair.0.get(state).legacy_solid, + base_facts.get(state).legacy_solid + ); + assert_eq!( + changed_pair.0.get(state).legacy_solid, + changed_independent.get(state).legacy_solid + ); + // The world loader sees the same overridden legacy solidity flag. + let changed_world = horizon_world::level::Behaviours::load(registry, &scratch).unwrap(); + assert_eq!( + changed_world.facts(state).flags & 1 != 0, + changed_pair.0.get(state).legacy_solid + ); + fs::write(scratch.join("block-behaviours.json"), b"{").unwrap(); assert!(BlockFacts::load_pair(&scratch, registry).is_err()); assert!(BlockFacts::load(&scratch, registry).is_err()); diff --git a/tools/profile_client_startup.py b/tools/profile_client_startup.py index 1a9442e62..bd648b7c9 100644 --- a/tools/profile_client_startup.py +++ b/tools/profile_client_startup.py @@ -40,6 +40,8 @@ def main(): parser.add_argument("--binary", type=Path, default=Path("target/release/examples/shared_json_startup_profile")) parser.add_argument("--resources", type=Path, default=Path(".local/horizon-client/26.3")) parser.add_argument("--repeats", type=int, default=5) + parser.add_argument("--reference-binary", type=Path, + help="Release binary built from cf837118; compare its deferred mode against current") parser.add_argument("--output", type=Path) args = parser.parse_args() if args.repeats < 1: @@ -47,14 +49,31 @@ def main(): binary, resources = args.binary.resolve(), args.resources.resolve() if not binary.is_file() or not resources.is_dir(): parser.error("binary or resources missing; build the example and prepare resources first") - samples = {"baseline": [], "pr607": [], "shared": [], "deferred": []} + if args.reference_binary: + reference = args.reference_binary.resolve() + if not reference.is_file(): + parser.error("reference binary missing") + modes = ["baseline", "pr607", "cf837118", "current"] + commands = { + "baseline": (binary, "baseline"), + "pr607": (binary, "pr607"), + "cf837118": (reference, "deferred"), + "current": (binary, "deferred"), + } + else: + modes = ["baseline", "pr607", "shared", "deferred"] + commands = {mode: (binary, mode) for mode in modes} + samples = {mode: [] for mode in modes} for i in range(args.repeats): - for mode in (("baseline", "pr607", "shared", "deferred") if i % 2 == 0 else ("deferred", "shared", "pr607", "baseline")): - samples[mode].append(run(binary, resources, mode)) + for mode in (modes if i % 2 == 0 else list(reversed(modes))): + executable, binary_mode = commands[mode] + samples[mode].append(run(executable, resources, binary_mode)) result = { "scope": "Assets + block facts + behaviours loader only; excludes full startup", "resources": str(resources), "repeats": args.repeats, + "comparison": "historical cf837118 release binary" if args.reference_binary else "same binary loading modes", + "reference_binary": str(args.reference_binary) if args.reference_binary else None, "metrics": {mode: {key: {"median": round(statistics.median(row[key] for row in rows), 3), "samples": [round(row[key], 3) for row in rows]} for key in rows[0]} for mode, rows in samples.items()}, From 66d187ed06e904a2937ef6da51189f8193fc6d37 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 02:12:08 +0200 Subject: [PATCH 35/59] Respawn on a server in vanilla's order, so vanilla clients leave the loading screen A vanilla 26.3 client that died on a Horizon server stayed on its loading screen after pressing Respawn (#566): ClientPacketListener.handleRespawn starts a LevelLoadTracker that waits for the level info's "level chunks load start" game event and the chunk under the player, and Horizon's respawn sent neither the level info nor the chunk cache centre. The hub's respawn now follows PlayerList.respawn: the entities paired with the dead player are removed (one packet each), its chunks are dropped without ForgetLevelChunk (as PlayerChunkSender does for a dead player) and sent again, the abilities, then Respawn (with the last death location), the teleport to the spawn facing its direction, the default spawn, difficulty, experience, post effects, the level info, the permission level, the chunk cache centre and the inventory. A dying guest also gets the death animation event and no health update while dead, as vanilla's ServerPlayer.die does. Guests' commands also ran at the host's permission level: an operator on a dedicated server could not run operator commands (and LAN guests ran the host's level). They now run at the guest's own level, as the command tree they are sent says. The dedicated server harness covers it: after trading, the vanilla-codec client is made an operator by the console, runs /kill, respawns, and the packets from the death screen to the respawned inventory are compared with vanilla's, then the level must load where it respawned. The client also stops sending a movement packet beside each teleport acceptance during the respawn: the 26.3 client sends the acceptance alone, and vanilla's server kicks a second position in the same tick. Fixes #566 Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game/lan_actions.rs | 33 +++++- crates/horizon-client/src/lan/guest.rs | 3 + crates/horizon-client/src/lan/hub.rs | 96 +++++++++++---- .../parity/VanillaProtocolClient.java | 112 +++++++++++++++++- tools/test_dedicated_server_parity.py | 40 ++++++- 5 files changed, 250 insertions(+), 34 deletions(-) diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index 6bf76f160..e192ef088 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -13,6 +13,7 @@ use horizon_client::{ items::ItemStack, lan::{ guest::SPECTATOR, + hub::TickCtx, menu::{Rules, Slots}, }, motion::{MotionEvent, MotionWorld, PlayerMotion}, @@ -683,9 +684,14 @@ 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() @@ -759,7 +765,23 @@ impl Game<'_> { g.saturation = 5.0; g.sent_health = None; g.motion = None; - host.hub.respawn(i, spawn); + let ctx = TickCtx { + world: &mut self.world, + host: None, + entities: &[], + next_entity: &mut self.next_entity, + 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 + }, + tick_rate: self.clock.rate(), + tick_frozen: self.clock.frozen(), + }; + host.hub.respawn(i, spawn, &ctx); } /// Per tick, for every guest: dig, use items, pick up drops, die. @@ -812,14 +834,15 @@ impl Game<'_> { let g = &mut host.hub.guests[gi]; if g.health <= 0.0 && !g.dead { g.dead = true; + g.last_death = Some(g.position.map(|v| v.floor() as i32)); + let (id, at) = (g.entity_id, g.position); let message = literal(&format!("{} died", g.name)); host.hub.send_to( conn, - &C::PlayerCombatKill(play::PlayerCombatKill { - id: host.hub.guests[gi].entity_id, - message, - }), + &C::PlayerCombatKill(play::PlayerCombatKill { id, message }), ); + // LivingEntity.die: the death animation, the dying player included. + host.hub.entity_event(id, 3, at); } } } diff --git a/crates/horizon-client/src/lan/guest.rs b/crates/horizon-client/src/lan/guest.rs index 954ffc714..03fbb33c2 100644 --- a/crates/horizon-client/src/lan/guest.rs +++ b/crates/horizon-client/src/lan/guest.rs @@ -97,6 +97,8 @@ pub struct Guest { pub menu_state: i32, pub sent_health: Option<(f32, i32, f32)>, pub sent_xp: Option<(f32, i32, i32)>, + /// Where the player last died (Player.lastDeathLocation), sent with the respawn. + pub last_death: Option<[i32; 3]>, pub sent_selected: usize, pub inbox: VecDeque, pub joined_tick: u64, @@ -178,6 +180,7 @@ impl Guest { menu_state: 0, sent_health: None, sent_xp: None, + last_death: None, sent_selected: 0, inbox: VecDeque::new(), joined_tick: 0, diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index fcae7c097..fdce46fd7 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -621,6 +621,22 @@ impl Hub { })); } + /// ClientboundSetDefaultSpawnPositionPacket for the level's respawn data. + fn default_spawn(&self, spawn: [f64; 3]) -> C { + C::SetDefaultSpawnPosition(play::SetDefaultSpawnPosition { + pos: play::GlobalPos { + dimension: self.config.dimension.clone(), + pos: [ + spawn[0].floor() as i32, + spawn[1].floor() as i32, + spawn[2].floor() as i32, + ], + }, + yaw: 0.0, + pitch: 0.0, + }) + } + /// PlayerList.sendLevelInfo. fn send_level_info(&mut self, i: usize, ctx: &TickCtx) { let spawn = ctx.spawn; @@ -637,18 +653,7 @@ impl Hub { warning_time: 300, })); g.send(&self.time_packet(ctx.world, ctx.clock_rate)); - g.send(&C::SetDefaultSpawnPosition(play::SetDefaultSpawnPosition { - pos: play::GlobalPos { - dimension: self.config.dimension.clone(), - pos: [ - spawn[0].floor() as i32, - spawn[1].floor() as i32, - spawn[2].floor() as i32, - ], - }, - yaw: 0.0, - pitch: 0.0, - })); + g.send(&self.default_spawn(spawn)); let w = &ctx.world.weather; if w.raining { g.send(&C::GameEvent(play::GameEvent { @@ -1297,7 +1302,8 @@ impl Hub { let g = &self.guests[i]; (g.health, g.food, g.saturation) }; - if self.guests[i].sent_health != Some(health) { + // A dead player's health isn't sent (the death screen shows from the combat kill). + if self.guests[i].sent_health != Some(health) && !self.guests[i].dead { let g = &mut self.guests[i]; g.send(&C::SetHealth(play::SetHealth { health: health.0, @@ -1547,23 +1553,73 @@ impl Hub { .map(str::to_owned) } - /// ServerPlayer.respawn: back to `at` with a fresh start. - pub fn respawn(&mut self, i: usize, at: [f64; 3]) { + /// 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. + pub fn respawn(&mut self, i: usize, at: [f64; 3], ctx: &TickCtx) { let mode = self.guests[i].game_mode; - let info = self.spawn_info(mode); + let mut info = self.spawn_info(mode); + // Player.getLastDeathLocation, set where the player died. + info.last_death = self.guests[i].last_death.map(|pos| play::GlobalPos { + dimension: self.config.dimension.clone(), + pos, + }); self.close_container_for(i); let g = &mut self.guests[i]; + // ServerLevel.removePlayerImmediately: every entity paired with the dead player is + // removed (ServerEntity.removePairing, one packet each). Its chunks are dropped + // without ForgetLevelChunk (PlayerChunkSender.dropChunk skips dead players): the + // client keeps them and they are all sent again. + for id in g.tracker.ids() { + g.send(&C::RemoveEntities(play::RemoveEntities { ids: vec![id] })); + } + g.tracker.clear(); + g.sent_chunks.clear(); + g.chunk_queue.clear(); + // ServerPlayer.restoreFrom: the game mode again (onUpdateAbilities). + g.send(&C::PlayerAbilities(play::PlayerAbilities { + flags: g.ability_flags(), + flying_speed: 0.05, + walking_speed: 0.1, + })); + // The new player faces the level's respawn direction (snapTo). + g.yaw = 0.0; + g.pitch = 0.0; g.position = at; g.previous_position = at; g.send(&C::Respawn(play::Respawn { spawn: info, keep: 0, })); - g.center = None; - g.sent_chunks.clear(); - g.chunk_queue.clear(); - g.tracker.clear(); self.teleport(i, None); + let spawn = self.default_spawn(ctx.spawn); + let g = &mut self.guests[i]; + g.send(&spawn); + g.send(&C::ChangeDifficulty(play::ChangeDifficulty { + difficulty: ctx.difficulty, + locked: ctx.difficulty_locked, + })); + let xp = (g.xp_progress, g.xp_level, g.xp_total); + g.send(&C::SetExperience(play::SetExperience { + progress: xp.0, + level: xp.1, + total: xp.2, + })); + g.sent_xp = Some(xp); + // ServerPlayer.sendPostEffects. + g.send(&raw(ids::POST_EFFECTS, vec![0])); + self.send_level_info(i, ctx); + self.send_permission_level(i); + // ServerLevel.addRespawnedPlayer: the chunk tracking starts again at the player. + let g = &mut self.guests[i]; + let (cx, cz) = g.chunk(); + g.send(&C::SetChunkCacheCenter(play::SetChunkCacheCenter { + x: cx, + z: cz, + })); + g.center = None; + g.center_sent = Some((cx, cz)); + // ServerPlayer.initInventoryMenu. self.send_inventory(i); } } 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 109f33b66..66a363dfe 100644 --- a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaProtocolClient.java +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaProtocolClient.java @@ -430,6 +430,16 @@ public final class VanillaProtocolClient { long deadline = System.currentTimeMillis() + 90_000; int step = 0; long stepAt = 0; + // The death the console deals and the respawn after it (PlayerList.respawn): from the + // client's PERFORM_RESPAWN until its level is loaded again (LevelLoadTracker: the level + // info's "level chunks load start" event, then the chunk under the player). + boolean respawning = false; + boolean respawned = false; + boolean loadStart = false; + boolean respawnChunk = false; + String runType = null; + int run = 0; + PositionMoveRotation respawnAt = null; // The villager the server's console summoned beside the spawn. int villager = -1; net.minecraft.world.phys.Vec3 villagerAt = null; @@ -445,6 +455,22 @@ public final class VanillaProtocolClient { Packet packet = r.packet; counts.merge(r.type, 1, Integer::sum); if (r.type.equals("minecraft:chunk_batch_start")) ordered = false; + if (respawning && !respawned) { + String line = respawnLine(r); + // PlayerList.respawn ends with initInventoryMenu: what follows is the + // next ticks' (health, entity data, chunks), in each server's own order. + respawned = r.type.equals("minecraft:container_set_content") && respawnAt != null; + if (line != null && !line.equals(runType)) { + if (runType != null) record("play-respawn", runLine(runType, run)); + runType = line; + run = 0; + } + if (line != null) run++; + if (packet instanceof net.minecraft.network.protocol.game.ClientboundGameEventPacket p + && p.getEvent() == net.minecraft.network.protocol.game.ClientboundGameEventPacket.LEVEL_CHUNKS_LOAD_START) { + loadStart = true; + } + } if (packet instanceof ClientboundKeepAlivePacket p) { send(new ServerboundKeepAlivePacket(p.getId())); } else if (packet instanceof ClientboundPingPacket p) { @@ -452,9 +478,14 @@ public final class VanillaProtocolClient { } else if (packet instanceof ClientboundPlayerPositionPacket p) { position = PositionMoveRotation.calculateAbsolute(position, p.change(), p.relatives()); record("play-move", text(position.position()) + " " + position.yRot() + " " + position.xRot()); + if (respawning) respawnAt = position; send(new ServerboundAcceptTeleportationPacket(p.id(), position.position().x, position.position().y, position.position().z, position.yRot(), position.xRot())); - send(new ServerboundMovePlayerPacket.PosRot(position.position(), position.yRot(), position.xRot(), false, false)); + // The 26.3 client answers with the acceptance alone; a second position in the + // same tick is an invalid move to vanilla's server once the player is loaded. + if (!respawning) { + send(new ServerboundMovePlayerPacket.PosRot(position.position(), position.yRot(), position.xRot(), false, false)); + } if (!loaded) { send(new ServerboundPlayerLoadedPacket()); loaded = true; @@ -467,15 +498,27 @@ public final class VanillaProtocolClient { lastChunk = now; int px = (int) Math.floor(position.position().x) >> 4; int pz = (int) Math.floor(position.position().z) >> 4; - if (p.x() == px && p.z() == pz) chunkParts(p); - } else if (packet instanceof ClientboundSystemChatPacket p && step > 0) { + if (p.x() == px && p.z() == pz && !respawning) chunkParts(p); + if (p.x() == px && p.z() == pz && respawnAt != null) respawnChunk = true; + } else if (packet instanceof net.minecraft.network.protocol.game.ClientboundEntityEventPacket p + && step == 5 + REPLIES.length && (int) (byte) field(p, "eventId") == 28) { + // Operator (level 4, as the console made it): it may run /kill on itself. + send(new ServerboundChatCommandPacket("kill")); + step++; + } else if (packet instanceof net.minecraft.network.protocol.game.ClientboundPlayerCombatKillPacket p && step > 0) { + // The death message is left out: guests' death messages aren't Horizon's yet. + record("play-death", "death screen"); + send(new net.minecraft.network.protocol.game.ServerboundClientCommandPacket( + net.minecraft.network.protocol.game.ServerboundClientCommandPacket.Action.PERFORM_RESPAWN)); + respawning = true; + } else if (packet instanceof ClientboundSystemChatPacket p && step > 0 && step < 5 + REPLIES.length) { record("play-chat", "system " + p.overlay() + " " + json(p.content())); - } else if (packet instanceof ClientboundPlayerChatPacket p && step > 0) { + } else if (packet instanceof ClientboundPlayerChatPacket p && step > 0 && step < 5 + REPLIES.length) { record("play-chat", "player " + p.sender() + " " + p.index() + " " + p.body().content() + " " + p.signature().isPresent() + " " + p.unsignedContent().map(VanillaProtocolClient::json) + " " + text(p.filterMask()) + " " + p.chatType().chatType().getRegisteredName() + " " + json(p.chatType().name()) + " " + p.chatType().targetName().map(VanillaProtocolClient::json)); - } else if (packet instanceof ClientboundDisguisedChatPacket p && step > 0) { + } else if (packet instanceof ClientboundDisguisedChatPacket p && step > 0 && step < 5 + REPLIES.length) { record("play-chat", "disguised " + json(p.message()) + " " + p.chatType().chatType().getRegisteredName()); } else if (packet instanceof net.minecraft.network.protocol.game.ClientboundAddEntityPacket p && p.getType() == net.minecraft.world.entity.EntityTypes.VILLAGER) { @@ -561,12 +604,71 @@ public final class VanillaProtocolClient { } else if (step == 4 + REPLIES.length && now - stepAt > 1500) { send(new net.minecraft.network.protocol.game.ServerboundContainerClosePacket(1)); record("play-counts", "chunks " + counts.getOrDefault("minecraft:level_chunk_with_light", 0)); + // The harness's console makes the player an operator once it reads this line. + send(new ServerboundChatPacket("ready to respawn", Instant.now(), 0L, Optional.empty(), + new LastSeenMessages.Update(0, new BitSet(), (byte) 0))); + step++; + stepAt = now; + } else if (step == 6 + REPLIES.length && loadStart && respawnChunk) { + // LevelLoadTracker is done: the vanilla client leaves the loading screen. + if (runType != null) record("play-respawn", runLine(runType, run)); + record("play-respawn", "level loaded at " + text(respawnAt.position())); + send(new ServerboundPlayerLoadedPacket()); return; } } + if (respawning) { + if (runType != null) record("play-respawn", runLine(runType, run)); + record("play-respawn", "level never loaded: load start " + loadStart + ", chunk under the player " + respawnChunk); + } record("error", "timed out in play, step " + step + ", chunks " + chunks.size()); } + /** + * A run of the same packet: counted, but for the entities removed with the dead player + * (which mobs are tracked near the spawn at that moment varies). + */ + private static String runLine(String type, int run) { + return type + (run > 1 && !type.equals("minecraft:remove_entities") ? " x" + run : ""); + } + + /** + * A packet after the respawn request, as compared: entity ids and periodic or streamed + * packets (time, keep-alive, chunk data and light, whose batching follows each server's + * timing) left out; null to skip it. + */ + private String respawnLine(Received r) { + String t = r.type; + // Entities moving and the dead player's health land in the window between the death + // and the respawn as each server's ticks fall: left out. + if (t.startsWith("minecraft:move_entity") || t.equals("minecraft:rotate_head") || t.equals("minecraft:set_entity_motion") + || t.equals("minecraft:set_entity_data") || t.equals("minecraft:entity_position_sync") || t.equals("minecraft:set_health")) { + return null; + } + if (t.equals("minecraft:keep_alive") || t.equals("minecraft:ping") || t.equals("minecraft:level_chunk_with_light") + || t.equals("minecraft:chunk_batch_start") || t.equals("minecraft:chunk_batch_finished") + || t.equals("minecraft:light_update") || t.equals("minecraft:bundle_delimiter") + // Chat (the death message and /kill's feedback) is compared before the death. + || t.equals("minecraft:system_chat") || t.equals("minecraft:player_chat") || t.equals("minecraft:disguised_chat")) { + return null; + } + if (r.packet instanceof net.minecraft.network.protocol.game.ClientboundSetTimePacket p && p.clockUpdates().isEmpty()) { + return null; + } + if (r.packet instanceof net.minecraft.network.protocol.game.ClientboundEntityEventPacket p) { + return t + " " + field(p, "eventId"); + } + if (r.packet instanceof net.minecraft.network.protocol.game.ClientboundRemoveEntitiesPacket p) { + return t; + } + if (t.equals("minecraft:respawn") || t.equals("minecraft:game_event") || t.equals("minecraft:set_default_spawn_position") + || t.equals("minecraft:change_difficulty") || t.equals("minecraft:set_experience") || t.equals("minecraft:set_health") + || t.equals("minecraft:set_chunk_cache_center") || t.equals("minecraft:initialize_border")) { + return t + " " + text(r.packet); + } + return t; + } + /** * A chunk's blocks, biomes, heightmaps and block entities (its * ClientboundLevelChunkPacketData bytes). The light is left out: both servers relight around chunks diff --git a/tools/test_dedicated_server_parity.py b/tools/test_dedicated_server_parity.py index 7861b1157..5c55f7a18 100644 --- a/tools/test_dedicated_server_parity.py +++ b/tools/test_dedicated_server_parity.py @@ -10,8 +10,11 @@ read is an error), pings each server, joins it in offline mode through login, configuration and play, accepts the spawn teleport, receives the chunks around the spawn (their bytes are compared: the world is loaded from the same files), chats, runs /list and commands that fail (`/random value -7..7`, `/random value x`, `/trigger nope`) and leaves. The console then -runs `list` and `say` and `stop`. Compared, all of them exactly: +7..7`, `/random value x`, `/trigger nope`), trades, is made an operator by +the console, runs /kill, respawns (as vanilla's LevelLoadTracker waits: until the "level +chunks load start" event and the chunk under the player) and leaves. The +console then runs `list` and `say` and `stop`. Compared, all of them +exactly: - the status response (MOTD, players, version, favicon) and the ping; - the legacy (pre-1.7, 0xFE) ping reply; @@ -22,6 +25,10 @@ runs `list` and `say` and `stop`. Compared, all of them exactly: advancements, which vanilla keeps in hash maps, sorted); the command tree node by node; the chunks sent and their bytes; the replies to the chat message, /list and the failing commands, as text components; +- after /kill, the packets from the death screen to the respawned + inventory (PlayerList.respawn; chat, chunk data, light and keep-alives + left out, runs of a packet counted), then that the level loads where the + player respawned (guests' death messages aren't Horizon's yet: left out); - the console lines about the player, the chat, `list`, `say` and `stop`; - the files the servers leave: server.properties (but the date line), eula.txt, ops.json, whitelist.json, banned-players.json, banned-ips.json. @@ -197,12 +204,17 @@ CONSOLE_LINE = re.compile(r'^\[\d\d:\d\d:\d\d\] \[([^\]]+)\]: (.*)$') KEPT = re.compile(r'Tester|\[Server\]|\[Not Secure\]|There are|Stopping|Saving|ThreadedAnvilChunkStorage|All dimensions|Unknown or incomplete') +# Guests' death messages and the op's command feedback broadcast to the console aren't +# Horizon's yet (the client's own transcript leaves the death message out as well). +NOT_YET = re.compile(r'Tester was killed|Killed Tester|^\[Tester: ') + + def console_lines(lines): """The console lines the comparison covers, timestamps and ports aside.""" out = [] for line in lines: m = CONSOLE_LINE.match(line) - if not m or not KEPT.search(m.group(2)): + if not m or not KEPT.search(m.group(2)) or NOT_YET.search(m.group(2)): continue text = re.sub(r'/127\.0\.0\.1:\d+', '/127.0.0.1:_', m.group(2)) text = re.sub(r'entity id \d+', 'entity id _', text) @@ -246,7 +258,27 @@ def run_side(label, command, directory, client): '{profession:"minecraft:librarian",level:2,type:"minecraft:plains"}}') port = int(PROPERTIES_PORTS[label]) legacy = legacy_ping(port) - client(port, directory.parent / f'{label}-client.txt') + # The client asks to be made an operator once it has traded, runs /kill and respawns. + failure = [] + + def join(): + try: + client(port, directory.parent / f'{label}-client.txt') + except BaseException as error: # noqa: BLE001 - reported on the main thread + failure.append(error) + + joined = threading.Thread(target=join) + joined.start() + deadline = time.time() + 300 + while joined.is_alive() and not any(' ready to respawn' in l for l in server.lines): + if time.time() > deadline: + break + time.sleep(0.2) + if joined.is_alive(): + server.console(f'op {PLAYER}') + joined.join() + if failure: + raise failure[0] time.sleep(1) server.console('list') server.console('say console says hi') From 256ecc4daafd90d8455d0e37f09e34897d1a1b64 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 03:16:38 +0200 Subject: [PATCH 36/59] Keep server blocks in sync with what guests dig A guest's STOP_DESTROY_BLOCK cleared the digging before the host's own count was done, so a block the client broke stayed on the server and the player fell through or froze on it. The host now follows ServerPlayerGameMode: it breaks the block when its progress since START is at least 0.7 and otherwise finishes the dig alone (the delayed destroy). Block acks go out after the tick's block updates, and the client keeps predicted blocks until the server acknowledges them (BlockStatePredictionHandler), so a refused break comes back instead of being lost. Fixes #500 Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game/lan_actions.rs | 131 +++++++++++++++--- crates/horizon-client/src/game/remote.rs | 64 ++++++++- crates/horizon-client/src/lan/guest.rs | 3 + crates/horizon-client/src/lan/hub.rs | 13 +- 4 files changed, 181 insertions(+), 30 deletions(-) diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index 6bf76f160..051b77dd4 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -36,6 +36,11 @@ pub(super) struct GuestPlay { swing: horizon_client::first_person::SwingState, /// The block being dug and the face the client aimed at. digging: Option<([i32; 3], [i32; 3])>, + /// The server tick the digging started (ServerPlayerGameMode.destroyProgressStart). + dig_start: u64, + /// A block the client stopped digging before the server's time was up: it breaks once + /// 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, @@ -350,35 +355,41 @@ impl Game<'_> { let face = direction(i32::from(a.direction)); let play = host.play.entry(conn).or_default(); play.digging = Some((a.pos, face)); + play.dig_start = host.hub.ticks; play.last_progress = -1; + // The pause between two blocks is the client's (MultiPlayerGameMode's + // destroyDelay); the server digs from the START it receives. + play.destroy_delay = 0; } 1 => {} - 2 | 3 => { + 3 => { + host.hub.ack(conn, a.sequence); + self.guest_stop_digging(host, conn, a.pos); + } + 2 => { host.hub.ack(conn, a.sequence); let play = host.play.entry(conn).or_default(); play.digging = None; play.mining = None; - if a.action == 2 { - let state = self.world.block(a.pos[0], a.pos[1], a.pos[2]).0 as i32; - host.hub.send_to( - conn, - &C::BlockUpdate(play::BlockUpdate { pos: a.pos, state }), - ); - host.hub.broadcast_near( - [ - f64::from(a.pos[0]), - f64::from(a.pos[1]), - f64::from(a.pos[2]), - ], - 64.0, - &C::BlockDestruction(play::BlockDestruction { - id: host.hub.guests[gi].entity_id, - pos: a.pos, - progress: 255, - }), - Some(conn), - ); - } + let state = self.world.block(a.pos[0], a.pos[1], a.pos[2]).0 as i32; + host.hub.send_to( + conn, + &C::BlockUpdate(play::BlockUpdate { pos: a.pos, state }), + ); + host.hub.broadcast_near( + [ + f64::from(a.pos[0]), + f64::from(a.pos[1]), + f64::from(a.pos[2]), + ], + 64.0, + &C::BlockDestruction(play::BlockDestruction { + id: host.hub.guests[gi].entity_id, + pos: a.pos, + progress: 255, + }), + Some(conn), + ); } 4 | 5 => { if !spectator { @@ -806,6 +817,7 @@ impl Game<'_> { } }); } + self.guest_delayed_destroy(host, conn); self.guest_server_tick(host, conn); self.guest_dig_feedback(host, conn); self.guest_pickups(host, gi); @@ -919,6 +931,81 @@ impl Game<'_> { }) } + /// ServerPlayerGameMode.handleBlockBreakAction, STOP_DESTROY_BLOCK: the client finished + /// digging `pos` (and predicted the break). The server breaks it if its own count of the + /// digging since START is at least 70 % done; otherwise it keeps digging alone and breaks + /// it when done (`guest_delayed_destroy`), so the client's broken block is never left + /// standing on the server. + fn guest_stop_digging(&mut self, host: &mut LanHost, conn: u32, pos: [i32; 3]) { + let ticks = host.hub.ticks; + let play = host.play.entry(conn).or_default(); + let dug = play.digging.take().is_some_and(|(p, _)| p == pos); + 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) { + return; + } + let progress = self + .as_guest(host, conn, |g| g.destroy_progress(pos)) + .map_or(0.0, |p| p * (ticks - start + 1) as f32); + if progress >= 0.7 { + self.guest_destroy(host, conn, pos); + } else { + let play = host.play.entry(conn).or_default(); + if play.delayed.is_none() { + play.delayed = Some((pos, start)); + } + } + } + + /// ServerPlayerGameMode.tick's delayed destroy: the block breaks once its progress since + /// the digging started is complete, unless something else removed it first. + fn guest_delayed_destroy(&mut self, host: &mut LanHost, conn: u32) { + let Some((pos, start)) = host.play.get(&conn).and_then(|p| p.delayed) else { + return; + }; + 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) { + None + } else { + self.as_guest(host, conn, |g| g.destroy_progress(pos)) + .map(|p| p * (ticks - start + 1) as f32) + }; + match progress { + Some(p) if p < 1.0 => {} + done => { + if let Some(play) = host.play.get_mut(&conn) { + play.delayed = None; + } + if done.is_some() { + self.guest_destroy(host, conn, pos); + } + } + } + } + + /// ServerPlayerGameMode.destroyBlock for a guest, its crack cleared for the others + /// (`destroyBlockProgress(id, pos, -1)`). + fn guest_destroy(&mut self, host: &mut LanHost, conn: u32, pos: [i32; 3]) { + self.as_guest(host, conn, |g| { + let _ = g.break_block(pos); + }); + if let Some(g) = host.hub.guest(conn) { + host.hub.broadcast_near( + [f64::from(pos[0]), f64::from(pos[1]), f64::from(pos[2])], + 64.0, + &C::BlockDestruction(play::BlockDestruction { + id: g.entity_id, + pos, + progress: 255, + }), + Some(conn), + ); + } + } + /// The crack animation other players see. fn guest_dig_feedback(&mut self, host: &mut LanHost, conn: u32) { let Some(gi) = host.hub.guests.iter().position(|g| g.conn == conn) else { diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index aa88896e8..d70021eab 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -88,6 +88,11 @@ pub(super) struct Remote { was_sprinting: bool, carried: Option, loaded_sent: bool, + /// BlockStatePredictionHandler: blocks changed ahead of the server (a predicted break), + /// with the sequence of the last action that changed them and the state the server + /// last said they have. Until the server acknowledges that sequence its block updates + /// only replace the remembered state; then the block takes it. + predictions: HashMap<[i32; 3], (i32, i32)>, /// Open container: (window id, menu name). menu: Option<(i32, String)>, /// The open menu's title as the server named it. @@ -271,6 +276,7 @@ impl Game<'_> { was_sprinting: false, carried: None, loaded_sent: false, + predictions: HashMap::new(), menu: None, menu_title: None, state_id: 0, @@ -509,6 +515,7 @@ impl Game<'_> { r.dimension = dimension; r.game_mode = spawn.game_type; r.loaded_sent = false; + r.predictions.clear(); self.set_mode_id(spawn.game_type); self.dim = if spawn.dimension == "minecraft:the_nether" { Dim::Nether @@ -636,6 +643,42 @@ impl Game<'_> { } } } + /// ClientLevel.setServerVerifiedBlockState: a block the client predicted keeps its + /// predicted state until the server acknowledges the action; the server's state is + /// remembered for then. + fn server_block(&mut self, pos: [i32; 3], state: i32) { + if let Some((_, known)) = self + .remote + .as_mut() + .and_then(|r| r.predictions.get_mut(&pos)) + { + *known = state; + return; + } + self.set_block(pos, state); + } + /// BlockStatePredictionHandler.endPredictionsUpTo (ClientboundBlockChangedAckPacket): the + /// actions up to `sequence` are settled, so the blocks they predicted take the state the + /// server gave them (a break the server refused comes back). + fn end_predictions(&mut self, sequence: i32) { + let Some(r) = self.remote.as_mut() else { + return; + }; + let settled: Vec<_> = r + .predictions + .iter() + .filter(|(_, (s, _))| *s <= sequence) + .map(|(&pos, &(_, state))| (pos, state)) + .collect(); + for (pos, state) in settled { + if let Some(r) = self.remote.as_mut() { + r.predictions.remove(&pos); + } + if self.world.block(pos[0], pos[1], pos[2]).0 as i32 != state { + self.set_block(pos, state); + } + } + } fn set_block(&mut self, pos: [i32; 3], state: i32) { let state = BlockStateId(state.max(0) as u32); if self.world.loaded(pos[0], pos[2]) @@ -879,7 +922,7 @@ impl Game<'_> { chunks_per_tick: 64.0, })); } - C::BlockUpdate(p) => self.set_block(p.pos, p.state), + C::BlockUpdate(p) => self.server_block(p.pos, p.state), C::SectionBlocksUpdate(p) => { let [sx, sy, sz] = p.section; for change in p.changes { @@ -889,10 +932,10 @@ impl Game<'_> { sy * 16 + (local & 15), sz * 16 + (local >> 4 & 15), ]; - self.set_block(pos, (change >> 12) as i32); + self.server_block(pos, (change >> 12) as i32); } } - C::BlockChangedAck(_) => {} + C::BlockChangedAck(p) => self.end_predictions(p.sequence), // ClientLevel.blockEvent: BlockEntity.triggerEvent (chest lids, // shulker boxes, bells) when the block is still the one it names. C::BlockEvent(p) => { @@ -2108,7 +2151,7 @@ impl Game<'_> { self.send(S::Punch(Empty)); if self.creative { let seq = self.next_sequence(); - self.predict_break(hit.pos, state); + self.predict_break(hit.pos, state, seq); self.send(S::PlayerAction(play::PlayerAction { action: 0, pos: hit.pos, @@ -2157,7 +2200,7 @@ impl Game<'_> { sequence: seq, })); if progress >= 1.0 { - self.predict_break(hit.pos, state); + self.predict_break(hit.pos, state, seq); if let Some(r) = self.remote.as_mut() { r.destroy_delay = 5; } @@ -2194,7 +2237,7 @@ impl Game<'_> { self.crack_particle(pos, hit.face, state); if done >= 1.0 { let seq = self.next_sequence(); - self.predict_break(pos, state); + self.predict_break(pos, state, seq); self.send(S::PlayerAction(play::PlayerAction { action: 3, pos, @@ -2226,7 +2269,14 @@ impl Game<'_> { } } /// MultiPlayerGameMode.destroyBlock: the predicted break. - fn predict_break(&mut self, pos: [i32; 3], state: BlockStateId) { + fn predict_break(&mut self, pos: [i32; 3], state: BlockStateId, sequence: i32) { + // BlockStatePredictionHandler.retainKnownServerState. + if let Some(r) = self.remote.as_mut() { + r.predictions + .entry(pos) + .and_modify(|p| p.0 = sequence) + .or_insert((sequence, state.0 as i32)); + } let s = self.res.facts.get(state).sounds.clone(); let at = [ f64::from(pos[0]) + 0.5, diff --git a/crates/horizon-client/src/lan/guest.rs b/crates/horizon-client/src/lan/guest.rs index 954ffc714..00f346b07 100644 --- a/crates/horizon-client/src/lan/guest.rs +++ b/crates/horizon-client/src/lan/guest.rs @@ -97,6 +97,8 @@ pub struct Guest { pub menu_state: i32, pub sent_health: Option<(f32, i32, f32)>, pub sent_xp: Option<(f32, i32, i32)>, + /// The last action sequence to acknowledge at the next tick (-1: none). + pub ack_up_to: std::cell::Cell, pub sent_selected: usize, pub inbox: VecDeque, pub joined_tick: u64, @@ -178,6 +180,7 @@ impl Guest { menu_state: 0, sent_health: None, sent_xp: None, + ack_up_to: std::cell::Cell::new(-1), sent_selected: 0, inbox: VecDeque::new(), joined_tick: 0, diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index fcae7c097..602a540b7 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -784,6 +784,15 @@ impl Hub { } } self.broadcast_block_changes(ctx.world); + // ServerGamePacketListenerImpl.tick: the actions handled since the last tick are + // acknowledged after the block changes they made were sent, so a client's predicted + // blocks settle on the server's states. + for g in &self.guests { + let sequence = g.ack_up_to.replace(-1); + if sequence >= 0 { + g.send(&C::BlockChangedAck(play::BlockChangedAck { sequence })); + } + } self.sync_containers(ctx.world); self.track_entities(ctx); for i in 0..self.guests.len() { @@ -1478,11 +1487,13 @@ impl Hub { } /// Acknowledge a block interaction (ClientboundBlockChangedAckPacket). + /// ServerGamePacketListenerImpl.ackBlockChangesUpTo: sent with the next tick's block + /// changes (`tick`). pub fn ack(&self, conn: u32, sequence: i32) { if sequence >= 0 && let Some(g) = self.guest(conn) { - g.send(&C::BlockChangedAck(play::BlockChangedAck { sequence })); + g.ack_up_to.set(g.ack_up_to.get().max(sequence)); } } From 24ac4e149bac81e29676bc9175c264f4012b9b42 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 02:13:21 +0200 Subject: [PATCH 37/59] Swap and sync the off hand on a server On a server the F key swapped the hands only on the client, and the inventory menu's off-hand slot (InventoryMenu slot 45) was missing from the client's slot table, so clicks on it went nowhere and the server's updates of it were dropped (#543). - F sends ServerboundPlayerActionPacket SWAP_ITEM_WITH_OFFHAND and predicts nothing, as vanilla's Minecraft.handleKeybinds does (not for spectators). - Inventory menu slot 45 is the off hand; SetPlayerInventory slot 40 too. - The server swaps only for non-spectators and stops the item in use (ServerGamePacketListenerImpl.handlePlayerAction). Fixes #543 Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game.rs | 8 ++++- crates/horizon-client/src/game/lan_actions.rs | 7 +++- crates/horizon-client/src/game/remote.rs | 32 +++++++++++++++++++ 3 files changed, 45 insertions(+), 2 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 5ffcd9124..ffec6b6f8 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -8860,7 +8860,13 @@ impl Game<'_> { } _ => {} }, - // key.swapOffhand: ServerboundPlayerActionPacket SWAP_ITEM_WITH_OFFHAND. + // key.swapOffhand: on a server, ServerboundPlayerActionPacket SWAP_ITEM_WITH_OFFHAND + // (the server swaps the hands and sends both slots back; spectators can't). + KeyCode::KeyF if self.screen == Screen::Playing && self.remote.is_some() => { + if !self.spectator() { + self.remote_swap_hands(); + } + } KeyCode::KeyF if self.screen == Screen::Playing => { std::mem::swap(&mut self.offhand, &mut self.inventory[self.selected]); self.using = None; diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index 6bf76f160..aab414156 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -395,10 +395,15 @@ impl Game<'_> { } }); } - 7 => { + // SWAP_ITEM_WITH_OFFHAND: the hands swap and the item in use stops + // (ServerGamePacketListenerImpl.handlePlayerAction), not for spectators. + 7 if !spectator => { let g = &mut host.hub.guests[gi]; let slot = g.selected; std::mem::swap(&mut g.inventory[slot], &mut g.offhand); + if let Some(play) = host.play.get_mut(&conn) { + play.using = None; + } } _ => {} }, diff --git a/crates/horizon-client/src/game/remote.rs b/crates/horizon-client/src/game/remote.rs index 525d6d2bb..438854e87 100644 --- a/crates/horizon-client/src/game/remote.rs +++ b/crates/horizon-client/src/game/remote.rs @@ -746,6 +746,8 @@ impl Game<'_> { 5..=8 => Some(500 + s - 5), 9..=35 => Some(s), 36..=44 => Some(s - 36), + // InventoryMenu.SHIELD_SLOT: the off hand. + 45 => Some(504), _ => None, }, "minecraft:crafting" => match s { @@ -1245,6 +1247,8 @@ impl Game<'_> { match p.slot { 0..=35 => self.inventory[p.slot as usize] = stack, 36..=39 => self.armor[3 - (p.slot - 36) as usize] = stack, + // Inventory.SLOT_OFFHAND. + 40 => self.offhand = stack, _ => {} } self.remote_synced(); @@ -2521,6 +2525,17 @@ impl Game<'_> { })); } } + /// Minecraft.handleKeybinds, key.swapOffhand: the server swaps the hands + /// (ServerboundPlayerActionPacket SWAP_ITEM_WITH_OFFHAND at BlockPos.ZERO, facing down) and + /// sends both slots back; nothing is predicted. + pub(super) fn remote_swap_hands(&mut self) { + self.send(S::PlayerAction(play::PlayerAction { + action: 7, + pos: [0; 3], + direction: 0, + sequence: 0, + })); + } /// A container click: the server answers with the authoritative slots. pub(super) fn remote_click(&mut self, right: bool) { let Some(size) = self @@ -2941,3 +2956,20 @@ impl Game<'_> { })) } } + +#[cfg(test)] +mod tests { + use super::Game; + + #[test] + fn every_inventory_menu_slot_is_a_game_slot_and_45_is_the_off_hand() { + // InventoryMenu: result, 2x2 grid, armour, 27 + 9 inventory slots, then the off hand. + assert_eq!(Game::menu_slot("inventory", 45), Some(504)); + let mut seen = std::collections::HashSet::new(); + for slot in 0..46 { + let internal = Game::menu_slot("inventory", slot); + assert!(internal.is_some_and(|i| seen.insert(i)), "slot {slot}"); + } + assert_eq!(Game::menu_slot("inventory", 46), None); + } +} From 73ac737ccf59453c1ce569cfdadea6aa890603e4 Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sat, 17 Oct 2026 02:26:56 +0100 Subject: [PATCH 38/59] perf: release startup decode buffers and profile parsing tradeoffs --- .../shared-json-decoder-phases-20261017.json | 176 +++++++ benchmarks/shared-json-five-way-20261017.json | 453 ++++++++++++++++++ ...hared-json-variant-isolation-20261017.json | 453 ++++++++++++++++++ .../examples/gameplay_decode_profile.rs | 33 ++ .../examples/shared_json_startup_profile.rs | 34 +- crates/horizon-client/src/game.rs | 4 + .../horizon-client/src/mod_content_tests.rs | 37 +- tools/profile_client_startup.py | 123 +++-- tools/profile_gameplay_decode.py | 64 +++ 9 files changed, 1335 insertions(+), 42 deletions(-) create mode 100644 benchmarks/shared-json-decoder-phases-20261017.json create mode 100644 benchmarks/shared-json-five-way-20261017.json create mode 100644 benchmarks/shared-json-variant-isolation-20261017.json create mode 100644 crates/horizon-client/examples/gameplay_decode_profile.rs create mode 100644 tools/profile_gameplay_decode.py diff --git a/benchmarks/shared-json-decoder-phases-20261017.json b/benchmarks/shared-json-decoder-phases-20261017.json new file mode 100644 index 000000000..8c5880124 --- /dev/null +++ b/benchmarks/shared-json-decoder-phases-20261017.json @@ -0,0 +1,176 @@ +{ + "scope": "Isolated gameplay-facts.json validation/typed decoding; includes JSON file read", + "resources": "/srv/bob-data/horizon/.local/horizon-client/26.3", + "repeats": 10, + "load_averages_before_after": [ + [ + 14.7451171875, + 8.8994140625, + 6.89599609375 + ], + [ + 14.7451171875, + 8.8994140625, + 6.89599609375 + ] + ], + "binary_sha256": "c2be9140c792720499d70c5806b8def0472734264ad72486d01365447e0cc2d7", + "metrics": { + "validate": { + "phase_ms": { + "median": 117.417, + "p25": 114.101, + "p75": 158.855, + "min": 109.199, + "max": 173.408, + "samples": [ + 109.199, + 113.958, + 110.195, + 118.987, + 171.275, + 124.701, + 170.24, + 173.408, + 115.848, + 114.531 + ] + }, + "total_ms": { + "median": 139.933, + "p25": 133.863, + "p75": 193.565, + "min": 129.75, + "max": 276.311, + "samples": [ + 276.311, + 135.448, + 129.75, + 138.452, + 195.127, + 141.413, + 188.88, + 199.802, + 133.335, + 132.094 + ] + }, + "cpu_ms": { + "median": 138.849, + "p25": 134.285, + "p75": 168.881, + "min": 129.089, + "max": 190.82, + "samples": [ + 140.962, + 136.06, + 129.089, + 139.059, + 189.478, + 138.639, + 178.187, + 190.82, + 133.693, + 132.716 + ] + }, + "peak_rss_kib": { + "median": 56654.0, + "p25": 56642.0, + "p75": 56704.0, + "min": 56616, + "max": 56724, + "samples": [ + 56620, + 56656, + 56640, + 56720, + 56616, + 56724, + 56652, + 56720, + 56648, + 56656 + ] + } + }, + "typed": { + "phase_ms": { + "median": 115.873, + "p25": 109.422, + "p75": 129.67, + "min": 100.872, + "max": 183.923, + "samples": [ + 116.965, + 132.071, + 100.872, + 105.098, + 122.468, + 170.777, + 107.997, + 183.923, + 113.699, + 114.781 + ] + }, + "total_ms": { + "median": 133.883, + "p25": 126.939, + "p75": 155.913, + "min": 117.54, + "max": 210.164, + "samples": [ + 135.04, + 159.38, + 117.54, + 122.391, + 145.512, + 189.132, + 125.846, + 210.164, + 130.217, + 132.727 + ] + }, + "cpu_ms": { + "median": 134.375, + "p25": 126.231, + "p75": 154.675, + "min": 118.132, + "max": 204.242, + "samples": [ + 135.633, + 157.961, + 118.132, + 122.77, + 144.816, + 178.293, + 124.755, + 204.242, + 130.661, + 133.117 + ] + }, + "peak_rss_kib": { + "median": 83974.0, + "p25": 82744.0, + "p75": 84490.0, + "min": 82332, + "max": 84596, + "samples": [ + 83596, + 84596, + 82332, + 82424, + 84288, + 82460, + 84532, + 83660, + 84364, + 84536 + ] + } + } + } +} diff --git a/benchmarks/shared-json-five-way-20261017.json b/benchmarks/shared-json-five-way-20261017.json new file mode 100644 index 000000000..61dcb7c3d --- /dev/null +++ b/benchmarks/shared-json-five-way-20261017.json @@ -0,0 +1,453 @@ +{ + "scope": "Assets + BlockFacts + Behaviours loader only; no full startup or first frame", + "resources": "/srv/bob-data/horizon/.local/horizon-client/26.3", + "repeats": 8, + "ordering": [ + [ + "baseline", + "a01d47f2", + "cf837118", + "cd61e11b", + "current" + ], + [ + "current", + "cd61e11b", + "cf837118", + "a01d47f2", + "baseline" + ], + [ + "baseline", + "a01d47f2", + "cf837118", + "cd61e11b", + "current" + ], + [ + "current", + "cd61e11b", + "cf837118", + "a01d47f2", + "baseline" + ], + [ + "baseline", + "a01d47f2", + "cf837118", + "cd61e11b", + "current" + ], + [ + "current", + "cd61e11b", + "cf837118", + "a01d47f2", + "baseline" + ], + [ + "baseline", + "a01d47f2", + "cf837118", + "cd61e11b", + "current" + ], + [ + "current", + "cd61e11b", + "cf837118", + "a01d47f2", + "baseline" + ] + ], + "load_average_before": [ + 10.57958984375, + 8.45947265625, + 6.8134765625 + ], + "load_average_after": [ + 7.158203125, + 7.7998046875, + 6.66455078125 + ], + "executables": { + "baseline": { + "path": "/srv/bob-data/horizon/.worktrees/shared-block-json-20261017/target/release/examples/shared_json_startup_profile-e422bd13", + "mode": "baseline", + "sha256": "bf61f2e6c92e001be3c3bc93cf8072cc6af6fd1d7bcfa7273045960948ec89e7" + }, + "a01d47f2": { + "path": "/srv/bob-data/horizon/.worktrees/shared-block-json-20261017/target/release/examples/shared_json_startup_profile-a01d47f2", + "mode": "shared", + "sha256": "88be56f8dbd28d0b4abd6c672486ba758df96ba18f68da45b94db14231dd3eea" + }, + "cf837118": { + "path": "/srv/bob-data/horizon/.worktrees/shared-block-json-20261017/target/release/examples/shared_json_startup_profile-cf837118", + "mode": "deferred", + "sha256": "f1b044cd9ac2f67c644fb40bd7ecbe38128ec739a8112d57fc36f05fe9036a52" + }, + "cd61e11b": { + "path": "/srv/bob-data/horizon/.worktrees/shared-block-json-20261017/target/release/examples/shared_json_startup_profile-cd61e11b", + "mode": "deferred", + "sha256": "fb2d3725b09ee38f85b49901f7053a6fe339b980a2b2dac6930a8ded22c139e8" + }, + "current": { + "path": "/srv/bob-data/horizon/.worktrees/shared-block-json-20261017/target/release/examples/shared_json_startup_profile-new", + "mode": "deferred", + "sha256": "84eb1baae8e138f52e300b0b44f1339fca38e70db6e06126e78db776ea3e5cd0" + } + }, + "metrics": { + "baseline": { + "phase_ms": { + "median": 1277.781, + "p25": 1271.23, + "p75": 1296.157, + "min": 1223.341, + "max": 1338.745, + "samples": [ + 1265.934, + 1223.341, + 1274.931, + 1289.177, + 1338.745, + 1317.096, + 1272.995, + 1280.631 + ] + }, + "total_ms": { + "median": 1711.802, + "p25": 1695.745, + "p75": 1754.276, + "min": 1645.69, + "max": 2887.078, + "samples": [ + 2887.078, + 1645.69, + 1690.413, + 1711.459, + 1761.859, + 1751.748, + 1697.522, + 1712.144 + ] + }, + "cpu_ms": { + "median": 1769.996, + "p25": 1748.925, + "p75": 1807.254, + "min": 1705.167, + "max": 1950.463, + "samples": [ + 1950.463, + 1705.167, + 1749.023, + 1768.05, + 1804.543, + 1815.386, + 1771.942, + 1748.632 + ] + }, + "peak_rss_kib": { + "median": 820180.0, + "p25": 820030.0, + "p75": 820502.0, + "min": 819472, + "max": 820884, + "samples": [ + 819472, + 820416, + 820060, + 820096, + 820264, + 820884, + 819940, + 820760 + ] + } + }, + "a01d47f2": { + "phase_ms": { + "median": 430.783, + "p25": 427.542, + "p75": 451.763, + "min": 423.035, + "max": 550.345, + "samples": [ + 491.599, + 423.035, + 428.85, + 427.694, + 432.715, + 427.084, + 438.484, + 550.345 + ] + }, + "total_ms": { + "median": 868.457, + "p25": 863.709, + "p75": 932.066, + "min": 837.75, + "max": 997.779, + "samples": [ + 911.935, + 837.75, + 865.419, + 868.626, + 858.578, + 997.779, + 868.288, + 992.46 + ] + }, + "cpu_ms": { + "median": 897.639, + "p25": 887.661, + "p75": 944.363, + "min": 865.497, + "max": 1001.635, + "samples": [ + 925.321, + 865.497, + 899.505, + 895.774, + 876.929, + 1001.635, + 891.239, + 1001.488 + ] + }, + "peak_rss_kib": { + "median": 351906.0, + "p25": 351505.0, + "p75": 352181.0, + "min": 351176, + "max": 352440, + "samples": [ + 352008, + 352120, + 351352, + 351556, + 351804, + 351176, + 352440, + 352364 + ] + } + }, + "cf837118": { + "phase_ms": { + "median": 408.459, + "p25": 398.987, + "p75": 428.585, + "min": 387.999, + "max": 524.425, + "samples": [ + 433.521, + 387.999, + 412.195, + 397.366, + 404.724, + 399.527, + 426.939, + 524.425 + ] + }, + "total_ms": { + "median": 851.294, + "p25": 823.291, + "p75": 890.55, + "min": 801.356, + "max": 1030.737, + "samples": [ + 892.054, + 801.356, + 840.381, + 818.285, + 862.208, + 824.96, + 890.049, + 1030.737 + ] + }, + "cpu_ms": { + "median": 870.765, + "p25": 850.849, + "p75": 907.922, + "min": 825.718, + "max": 1041.996, + "samples": [ + 906.657, + 825.718, + 866.472, + 843.591, + 875.058, + 853.268, + 911.715, + 1041.996 + ] + }, + "peak_rss_kib": { + "median": 274172.0, + "p25": 273909.0, + "p75": 274438.0, + "min": 273668, + "max": 274964, + "samples": [ + 274372, + 274964, + 273668, + 273972, + 274552, + 274400, + 273840, + 273932 + ] + } + }, + "cd61e11b": { + "phase_ms": { + "median": 419.114, + "p25": 404.191, + "p75": 460.634, + "min": 388.557, + "max": 735.687, + "samples": [ + 457.971, + 418.303, + 388.557, + 405.041, + 419.925, + 401.64, + 468.624, + 735.687 + ] + }, + "total_ms": { + "median": 840.723, + "p25": 835.398, + "p75": 917.995, + "min": 811.43, + "max": 1565.471, + "samples": [ + 906.328, + 837.706, + 811.43, + 835.727, + 843.74, + 834.412, + 952.996, + 1565.471 + ] + }, + "cpu_ms": { + "median": 863.404, + "p25": 858.916, + "p75": 934.2, + "min": 833.955, + "max": 1550.132, + "samples": [ + 916.017, + 864.82, + 833.955, + 859.057, + 861.989, + 858.494, + 988.748, + 1550.132 + ] + }, + "peak_rss_kib": { + "median": 267508.0, + "p25": 267310.0, + "p75": 267890.0, + "min": 267172, + "max": 268412, + "samples": [ + 267304, + 268292, + 267312, + 267756, + 267340, + 267676, + 267172, + 268412 + ] + } + }, + "current": { + "phase_ms": { + "median": 406.779, + "p25": 397.839, + "p75": 413.957, + "min": 385.028, + "max": 552.051, + "samples": [ + 387.136, + 385.028, + 409.317, + 404.242, + 401.407, + 411.451, + 421.476, + 552.051 + ] + }, + "total_ms": { + "median": 819.787, + "p25": 814.211, + "p75": 855.69, + "min": 800.867, + "max": 1128.453, + "samples": [ + 808.685, + 800.867, + 816.053, + 817.907, + 821.667, + 843.26, + 892.982, + 1128.453 + ] + }, + "cpu_ms": { + "median": 847.078, + "p25": 836.598, + "p75": 877.524, + "min": 826.002, + "max": 1134.369, + "samples": [ + 834.665, + 826.002, + 837.243, + 842.86, + 851.296, + 864.892, + 915.419, + 1134.369 + ] + }, + "peak_rss_kib": { + "median": 267956.0, + "p25": 267612.0, + "p75": 268326.0, + "min": 267308, + "max": 268428, + "samples": [ + 268428, + 267308, + 268260, + 267516, + 267652, + 268312, + 268368, + 267644 + ] + } + } + }, + "experiment_note": "Experimental projection variant (reused sounds, Arc-keyed string pools and direct flags); reverted after mixed CPU/RSS evidence. Current in this file is not the final PR version." +} diff --git a/benchmarks/shared-json-variant-isolation-20261017.json b/benchmarks/shared-json-variant-isolation-20261017.json new file mode 100644 index 000000000..e399c7ba1 --- /dev/null +++ b/benchmarks/shared-json-variant-isolation-20261017.json @@ -0,0 +1,453 @@ +{ + "scope": "Assets + BlockFacts + Behaviours loader only; no full startup or first frame", + "resources": "/srv/bob-data/horizon/.local/horizon-client/26.3", + "repeats": 8, + "ordering": [ + [ + "cf837118", + "cd61e11b", + "arc-key", + "reused-sounds", + "current" + ], + [ + "current", + "reused-sounds", + "arc-key", + "cd61e11b", + "cf837118" + ], + [ + "cf837118", + "cd61e11b", + "arc-key", + "reused-sounds", + "current" + ], + [ + "current", + "reused-sounds", + "arc-key", + "cd61e11b", + "cf837118" + ], + [ + "cf837118", + "cd61e11b", + "arc-key", + "reused-sounds", + "current" + ], + [ + "current", + "reused-sounds", + "arc-key", + "cd61e11b", + "cf837118" + ], + [ + "cf837118", + "cd61e11b", + "arc-key", + "reused-sounds", + "current" + ], + [ + "current", + "reused-sounds", + "arc-key", + "cd61e11b", + "cf837118" + ] + ], + "load_average_before": [ + 10.9873046875, + 8.37646484375, + 6.91015625 + ], + "load_average_after": [ + 8.6962890625, + 8.1591796875, + 6.90087890625 + ], + "executables": { + "cf837118": { + "path": "/srv/bob-data/horizon/.worktrees/shared-block-json-20261017/target/release/examples/shared_json_startup_profile-cf837118", + "mode": "deferred", + "sha256": "f1b044cd9ac2f67c644fb40bd7ecbe38128ec739a8112d57fc36f05fe9036a52" + }, + "cd61e11b": { + "path": "/srv/bob-data/horizon/.worktrees/shared-block-json-20261017/target/release/examples/shared_json_startup_profile-cd61e11b", + "mode": "deferred", + "sha256": "fb2d3725b09ee38f85b49901f7053a6fe339b980a2b2dac6930a8ded22c139e8" + }, + "arc-key": { + "path": "/srv/bob-data/horizon/.worktrees/shared-block-json-20261017/target/release/examples/shared_json_startup_profile-arcpool", + "mode": "deferred", + "sha256": "8cbb53d01afedf5c7a5da0e36c9f8c3569f34def9bc51488fe8699e7f615a131" + }, + "reused-sounds": { + "path": "/srv/bob-data/horizon/.worktrees/shared-block-json-20261017/target/release/examples/shared_json_startup_profile-reusesounds", + "mode": "deferred", + "sha256": "f45794bfbdbb3f9b5d34c375d397191ac67984b3ae91268aa3fdd02f2c1b7b98" + }, + "current": { + "path": "/srv/bob-data/horizon/.worktrees/shared-block-json-20261017/target/release/examples/shared_json_startup_profile-new", + "mode": "deferred", + "sha256": "84eb1baae8e138f52e300b0b44f1339fca38e70db6e06126e78db776ea3e5cd0" + } + }, + "metrics": { + "cf837118": { + "phase_ms": { + "median": 424.082, + "p25": 417.508, + "p75": 430.923, + "min": 395.439, + "max": 948.609, + "samples": [ + 948.609, + 425.085, + 425.571, + 417.945, + 395.439, + 416.197, + 423.078, + 446.98 + ] + }, + "total_ms": { + "median": 853.026, + "p25": 839.421, + "p75": 867.731, + "min": 813.144, + "max": 1906.081, + "samples": [ + 1906.081, + 861.641, + 864.233, + 844.411, + 813.144, + 830.783, + 842.3, + 878.226 + ] + }, + "cpu_ms": { + "median": 876.143, + "p25": 862.934, + "p75": 891.4, + "min": 837.769, + "max": 1517.372, + "samples": [ + 1517.372, + 885.13, + 887.888, + 865.404, + 837.769, + 855.526, + 867.157, + 901.937 + ] + }, + "peak_rss_kib": { + "median": 273904.0, + "p25": 273717.0, + "p75": 274142.0, + "min": 273648, + "max": 274836, + "samples": [ + 273648, + 273936, + 273872, + 274836, + 274064, + 274376, + 273740, + 273648 + ] + } + }, + "cd61e11b": { + "phase_ms": { + "median": 422.356, + "p25": 406.294, + "p75": 425.846, + "min": 394.111, + "max": 472.536, + "samples": [ + 425.832, + 420.666, + 472.536, + 425.886, + 400.588, + 394.111, + 424.047, + 408.196 + ] + }, + "total_ms": { + "median": 852.475, + "p25": 828.474, + "p75": 876.413, + "min": 817.3, + "max": 951.587, + "samples": [ + 951.587, + 865.442, + 899.564, + 868.696, + 823.74, + 817.3, + 839.508, + 830.052 + ] + }, + "cpu_ms": { + "median": 875.04, + "p25": 850.012, + "p75": 900.57, + "min": 837.672, + "max": 938.285, + "samples": [ + 938.285, + 888.533, + 926.846, + 891.812, + 845.956, + 837.672, + 861.548, + 851.364 + ] + }, + "peak_rss_kib": { + "median": 268086.0, + "p25": 267719.0, + "p75": 268486.0, + "min": 267444, + "max": 268920, + "samples": [ + 267776, + 268660, + 267752, + 268920, + 268428, + 268396, + 267444, + 267620 + ] + } + }, + "arc-key": { + "phase_ms": { + "median": 421.422, + "p25": 401.781, + "p75": 451.774, + "min": 394.041, + "max": 472.337, + "samples": [ + 446.155, + 472.337, + 468.632, + 420.636, + 400.91, + 394.041, + 422.207, + 402.072 + ] + }, + "total_ms": { + "median": 866.601, + "p25": 822.563, + "p75": 918.038, + "min": 817.092, + "max": 1001.287, + "samples": [ + 1001.287, + 918.457, + 917.898, + 892.666, + 817.092, + 824.225, + 840.536, + 817.576 + ] + }, + "cpu_ms": { + "median": 887.84, + "p25": 844.533, + "p75": 937.331, + "min": 838.687, + "max": 991.212, + "samples": [ + 991.212, + 949.048, + 933.425, + 911.921, + 838.687, + 845.021, + 863.759, + 843.069 + ] + }, + "peak_rss_kib": { + "median": 267728.0, + "p25": 267598.0, + "p75": 268039.0, + "min": 267452, + "max": 268636, + "samples": [ + 268264, + 267616, + 267840, + 267964, + 268636, + 267452, + 267580, + 267604 + ] + } + }, + "reused-sounds": { + "phase_ms": { + "median": 421.683, + "p25": 412.913, + "p75": 439.098, + "min": 395.338, + "max": 487.446, + "samples": [ + 487.446, + 434.111, + 402.815, + 416.279, + 424.524, + 454.058, + 395.338, + 418.842 + ] + }, + "total_ms": { + "median": 879.846, + "p25": 845.021, + "p75": 901.166, + "min": 823.721, + "max": 1013.539, + "samples": [ + 1013.539, + 892.033, + 928.565, + 884.284, + 847.853, + 875.407, + 823.721, + 836.527 + ] + }, + "cpu_ms": { + "median": 894.546, + "p25": 871.499, + "p75": 921.844, + "min": 844.891, + "max": 1028.688, + "samples": [ + 1028.688, + 913.48, + 946.935, + 903.785, + 868.684, + 885.308, + 844.891, + 872.438 + ] + }, + "peak_rss_kib": { + "median": 267960.0, + "p25": 267678.0, + "p75": 268133.0, + "min": 267212, + "max": 268404, + "samples": [ + 267212, + 267888, + 268404, + 267692, + 268096, + 267636, + 268244, + 268032 + ] + } + }, + "current": { + "phase_ms": { + "median": 411.403, + "p25": 406.814, + "p75": 452.869, + "min": 391.768, + "max": 532.402, + "samples": [ + 532.402, + 442.563, + 408.857, + 410.202, + 483.788, + 391.768, + 400.683, + 412.604 + ] + }, + "total_ms": { + "median": 905.017, + "p25": 851.488, + "p75": 937.934, + "min": 818.206, + "max": 1075.445, + "samples": [ + 1075.445, + 878.155, + 837.627, + 955.655, + 932.027, + 818.206, + 856.108, + 931.88 + ] + }, + "cpu_ms": { + "median": 922.9, + "p25": 874.849, + "p75": 956.282, + "min": 839.639, + "max": 1067.693, + "samples": [ + 1067.693, + 900.18, + 862.137, + 970.356, + 951.591, + 839.639, + 879.086, + 945.62 + ] + }, + "peak_rss_kib": { + "median": 268354.0, + "p25": 267889.0, + "p75": 268492.0, + "min": 267056, + "max": 268820, + "samples": [ + 268008, + 268384, + 268564, + 268820, + 267056, + 267532, + 268324, + 268468 + ] + } + } + }, + "experiment_note": "Exploratory variants (Arc-key pool, reused sounds, combined proposal) alongside cd61e11b; none gave a robust consistent improvement and all were reverted." +} diff --git a/crates/horizon-client/examples/gameplay_decode_profile.rs b/crates/horizon-client/examples/gameplay_decode_profile.rs new file mode 100644 index 000000000..60260452f --- /dev/null +++ b/crates/horizon-client/examples/gameplay_decode_profile.rs @@ -0,0 +1,33 @@ +//! Profile the two mandatory passes over gameplay-facts.json independently. +//! Build with `cargo build --release -p horizon-client --example gameplay_decode_profile`. +//! Each invocation runs one phase in a separate process for CPU/RSS measurements. +#[allow(dead_code)] +#[path = "../src/blocks/decode.rs"] +mod decode; + +use std::{hint::black_box, path::Path, time::Instant}; + +// The included private decoder expects the parent crate Result alias. +type Result = std::result::Result>; + +fn main() -> Result<()> { + let mut args = std::env::args().skip(1); + let root = args.next().ok_or("expected resource directory")?; + let mode = args.next().ok_or("expected validate or typed")?; + if mode != "validate" && mode != "typed" { + return Err("expected validate or typed".into()); + } + let total = Instant::now(); + let bytes = std::fs::read(Path::new(&root).join("gameplay-facts.json"))?; + let started = Instant::now(); + if mode == "validate" { + let parsed: decode::Validate = serde_json::from_slice(&bytes)?; + black_box(parsed); + } else { + let parsed: decode::Gameplay<'_> = serde_json::from_slice(&bytes)?; + black_box(parsed); + } + println!("phase_ms={:.3}", started.elapsed().as_secs_f64() * 1000.0); + println!("total_ms={:.3}", total.elapsed().as_secs_f64() * 1000.0); + Ok(()) +} diff --git a/crates/horizon-client/examples/shared_json_startup_profile.rs b/crates/horizon-client/examples/shared_json_startup_profile.rs index 108e8b29d..7b7d896b2 100644 --- a/crates/horizon-client/examples/shared_json_startup_profile.rs +++ b/crates/horizon-client/examples/shared_json_startup_profile.rs @@ -6,19 +6,27 @@ use horizon_client::{assets::Assets, blocks::BlockFacts}; use horizon_world::level::Behaviours; use std::{path::Path, time::Instant}; +fn resident_kib() -> Option { + let status = std::fs::read_to_string("/proc/self/status").ok()?; + let line = status.lines().find(|line| line.starts_with("VmRSS:"))?; + line.split_whitespace().nth(1)?.parse().ok() +} + fn main() -> Result<(), Box> { let mut args = std::env::args().skip(1); let root = args.next().ok_or("expected resource directory")?; let mode = args .next() - .ok_or("expected baseline, pr607, shared or deferred")?; - if !["baseline", "pr607", "shared", "deferred"].contains(&mode.as_str()) { - return Err("expected baseline, pr607, shared or deferred".into()); + .ok_or("expected baseline, pr607, shared, deferred or deferred-held")?; + if !["baseline", "pr607", "shared", "deferred", "deferred-held"].contains(&mode.as_str()) { + return Err("expected baseline, pr607, shared, deferred or deferred-held".into()); } let root = Path::new(&root); let total = Instant::now(); let assets = Assets::load(root)?; let started = Instant::now(); + let mut retained_inputs = None; + let mut subphases = None; let (facts, behaviours) = if mode == "baseline" { ( BlockFacts::load(root, assets.registry)?, @@ -33,16 +41,34 @@ fn main() -> Result<(), Box> { } else if mode == "shared" { BlockFacts::load_pair(root, assets.registry)? } else { + let parse_started = Instant::now(); let json: serde_json::Value = serde_json::from_reader(std::io::BufReader::new( std::fs::File::open(root.join("block-behaviours.json"))?, ))?; + let parse_ms = parse_started.elapsed().as_secs_f64() * 1000.0; + let facts_started = Instant::now(); let (facts, gameplay) = BlockFacts::load_with_projection(root, assets.registry, &json)?; + let facts_ms = facts_started.elapsed().as_secs_f64() * 1000.0; + let behaviours_started = Instant::now(); let behaviours = Behaviours::load_with_gameplay(assets.registry, root, &json, &gameplay)?; + let behaviours_ms = behaviours_started.elapsed().as_secs_f64() * 1000.0; + subphases = Some((parse_ms, facts_ms, behaviours_ms)); + if mode == "deferred-held" { + retained_inputs = Some((json, gameplay)); + } (facts, behaviours) }; println!("phase_ms={:.3}", started.elapsed().as_secs_f64() * 1000.0); println!("total_ms={:.3}", total.elapsed().as_secs_f64() * 1000.0); println!("states={}", facts.states.len()); - std::hint::black_box((facts, behaviours)); + if let Some((parse, facts, behaviours)) = subphases { + println!("behaviour_json_ms={parse:.3}"); + println!("facts_ms={facts:.3}"); + println!("behaviours_ms={behaviours:.3}"); + } + if let Some(rss) = resident_kib() { + println!("post_rss_kib={rss}"); + } + std::hint::black_box((facts, behaviours, retained_inputs)); Ok(()) } diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index aa39019e5..21bf3c3ac 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -10257,6 +10257,10 @@ pub fn run() -> Result<()> { 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); let mut settings = Settings::load(&std::env::current_dir()?.join("options.txt")); horizon_client::ui_theme::load_preferences(&std::env::current_dir()?); // Scripted and frame-limited runs (the parity harnesses) see vanilla's diff --git a/crates/horizon-client/src/mod_content_tests.rs b/crates/horizon-client/src/mod_content_tests.rs index 66ad8eb2f..5027bc236 100644 --- a/crates/horizon-client/src/mod_content_tests.rs +++ b/crates/horizon-client/src/mod_content_tests.rs @@ -341,13 +341,27 @@ fn independent_reloads_read_changed_behaviour_json_and_report_invalid_files() { let original = fs::read(base.join("block-behaviours.json")).unwrap(); fs::remove_file(scratch.join("block-behaviours.json")).unwrap(); fs::write(scratch.join("block-behaviours.json"), &original).unwrap(); - let (facts, _) = BlockFacts::load_pair(&scratch, registry).unwrap(); + // Independent facts and behaviours can load first, followed by paired data. + let independent_first = BlockFacts::load(&scratch, registry).unwrap(); + let independent_world_first = + horizon_world::level::Behaviours::load(registry, &scratch).unwrap(); + let (facts, paired_world) = BlockFacts::load_pair(&scratch, registry).unwrap(); assert_eq!(facts.states.len(), registry.len()); - assert_eq!( - BlockFacts::load(&scratch, registry).unwrap().states.len(), - registry.len() - ); - assert!(horizon_world::level::Behaviours::load(registry, &scratch).is_ok()); + for state in [0, 1, registry.len() - 1] { + let state = horizon_world::registry::BlockStateId(state as u32); + assert_eq!( + facts.get(state).classes, + independent_first.get(state).classes + ); + assert_eq!( + facts.get(state).sounds.place, + independent_first.get(state).sounds.place + ); + assert_eq!( + paired_world.facts(state).flags, + independent_world_first.facts(state).flags + ); + } // Override one exported state bit at the same path and verify that a later // independent and paired read sees it while the original resource root does not. @@ -379,8 +393,15 @@ fn independent_reloads_read_changed_behaviour_json_and_report_invalid_files() { ); fs::write(scratch.join("block-behaviours.json"), b"{").unwrap(); - assert!(BlockFacts::load_pair(&scratch, registry).is_err()); - assert!(BlockFacts::load(&scratch, registry).is_err()); + let paired_error = BlockFacts::load_pair(&scratch, registry) + .err() + .unwrap() + .to_string(); + let independent_error = BlockFacts::load(&scratch, registry) + .err() + .unwrap() + .to_string(); + assert_eq!(paired_error, independent_error); assert!(horizon_world::level::Behaviours::load(registry, &scratch).is_err()); fs::write(scratch.join("block-behaviours.json"), b"{}").unwrap(); diff --git a/tools/profile_client_startup.py b/tools/profile_client_startup.py index bd648b7c9..c82417067 100644 --- a/tools/profile_client_startup.py +++ b/tools/profile_client_startup.py @@ -1,14 +1,15 @@ #!/usr/bin/env python3 -"""Compare four JSON loading sequences in the client startup table phase. +"""Profile the asset/block-facts/behaviour loading phase in release executables. -Build first with `cargo build --release -p horizon-client --example shared_json_startup_profile`. -Modes: baseline uses independent public loaders, pr607 reproduces a01d47f2, -shared uses the paired wrapper, and deferred retains the projection until the -normal behaviour stage. All modes use one optimized executable. This covers -Assets::load plus BlockFacts and Behaviours loading; it excludes full startup, -rendering, resource-pack resolution and first frame. Peak RSS includes Assets. +Build `shared_json_startup_profile` with the same Cargo release profile at each +revision. With --a01-binary, --cf-binary and --cd-binary, the script compares +five versions in alternated separate processes; --baseline-binary optionally +supplies a build from the original pre-PR checkout. Without historical inputs, +legacy baseline/pr607/shared/deferred same-binary comparisons are supported. +The measurement excludes full client startup, renderer and first frame. """ import argparse +import hashlib import json import os import statistics @@ -19,20 +20,32 @@ from pathlib import Path def run(binary, resources, mode): with tempfile.TemporaryFile(mode="w+t") as output: - proc = subprocess.Popen([str(binary), str(resources), mode], stdout=output, stderr=subprocess.PIPE) + proc = subprocess.Popen([str(binary), str(resources), mode], stdout=output, + stderr=subprocess.PIPE) _, status, usage = os.wait4(proc.pid, 0) proc.returncode = os.waitstatus_to_exitcode(status) _, stderr = proc.communicate() - if os.waitstatus_to_exitcode(status): - raise RuntimeError(f"{mode}: {stderr.decode(errors='replace')}") + if proc.returncode: + raise RuntimeError(f"{binary} {mode}: {stderr.decode(errors='replace')}") output.seek(0) fields = dict(line.rstrip().split("=", 1) for line in output if "=" in line) - return { + measurements = { "phase_ms": float(fields["phase_ms"]), "total_ms": float(fields["total_ms"]), "cpu_ms": (usage.ru_utime + usage.ru_stime) * 1000.0, "peak_rss_kib": usage.ru_maxrss, } + for field in ("behaviour_json_ms", "facts_ms", "behaviours_ms", "post_rss_kib"): + if field in fields: + measurements[field] = float(fields[field]) + return measurements + + +def percentile(values, percent): + ordered = sorted(values) + position = (len(ordered) - 1) * percent + low = int(position) + return ordered[low] + (ordered[min(low + 1, len(ordered) - 1)] - ordered[low]) * (position - low) def main(): @@ -40,43 +53,93 @@ def main(): parser.add_argument("--binary", type=Path, default=Path("target/release/examples/shared_json_startup_profile")) parser.add_argument("--resources", type=Path, default=Path(".local/horizon-client/26.3")) parser.add_argument("--repeats", type=int, default=5) - parser.add_argument("--reference-binary", type=Path, - help="Release binary built from cf837118; compare its deferred mode against current") + parser.add_argument("--reference-binary", type=Path, help="Legacy comparison to cf837118") + parser.add_argument("--baseline-binary", type=Path, help="Optional original main build; expects baseline mode") + parser.add_argument("--a01-binary", type=Path, help="Release executable built at a01d47f2") + parser.add_argument("--cf-binary", type=Path, help="Release executable built at cf837118") + parser.add_argument("--cd-binary", type=Path, help="Release executable built at cd61e11b") + parser.add_argument("--variant", action="append", metavar="LABEL=PATH@MODE", + help="Compare arbitrary release variants, e.g. pool=target/...@deferred") parser.add_argument("--output", type=Path) args = parser.parse_args() if args.repeats < 1: parser.error("--repeats must be positive") binary, resources = args.binary.resolve(), args.resources.resolve() - if not binary.is_file() or not resources.is_dir(): - parser.error("binary or resources missing; build the example and prepare resources first") - if args.reference_binary: - reference = args.reference_binary.resolve() - if not reference.is_file(): - parser.error("reference binary missing") - modes = ["baseline", "pr607", "cf837118", "current"] + if not resources.is_dir(): + parser.error("resources directory missing") + + historical = any((args.a01_binary, args.cf_binary, args.cd_binary, args.baseline_binary)) + if args.variant: + if historical or args.reference_binary: + parser.error("--variant cannot be mixed with historical comparison flags") + commands = {} + for specification in args.variant: + if "=" not in specification or "@" not in specification: + parser.error("--variant must be LABEL=PATH@MODE") + name, executable_mode = specification.split("=", 1) + executable, binary_mode = executable_mode.rsplit("@", 1) + if not name or not executable or not binary_mode or name in commands: + parser.error("variant names must be unique and all fields nonempty") + commands[name] = (Path(executable).resolve(), binary_mode) + elif historical: + if not all((args.a01_binary, args.cf_binary, args.cd_binary)): + parser.error("historical comparisons require --a01-binary, --cf-binary and --cd-binary") + commands = { + "baseline": ((args.baseline_binary or args.a01_binary).resolve(), "baseline"), + "a01d47f2": (args.a01_binary.resolve(), "shared"), + "cf837118": (args.cf_binary.resolve(), "deferred"), + "cd61e11b": (args.cd_binary.resolve(), "deferred"), + "current": (binary, "deferred"), + } + elif args.reference_binary: commands = { "baseline": (binary, "baseline"), "pr607": (binary, "pr607"), - "cf837118": (reference, "deferred"), + "cf837118": (args.reference_binary.resolve(), "deferred"), "current": (binary, "deferred"), } else: - modes = ["baseline", "pr607", "shared", "deferred"] - commands = {mode: (binary, mode) for mode in modes} + commands = {mode: (binary, mode) for mode in ("baseline", "pr607", "shared", "deferred")} + for executable, _ in commands.values(): + if not executable.is_file(): + parser.error(f"release executable missing: {executable}") + modes = list(commands) samples = {mode: [] for mode in modes} + orders = [] + initial_load = os.getloadavg() for i in range(args.repeats): - for mode in (modes if i % 2 == 0 else list(reversed(modes))): + order = modes if i % 2 == 0 else list(reversed(modes)) + orders.append(list(order)) + for mode in order: executable, binary_mode = commands[mode] samples[mode].append(run(executable, resources, binary_mode)) result = { - "scope": "Assets + block facts + behaviours loader only; excludes full startup", + "scope": "Assets + BlockFacts + Behaviours loader only; no full startup or first frame", "resources": str(resources), "repeats": args.repeats, - "comparison": "historical cf837118 release binary" if args.reference_binary else "same binary loading modes", - "reference_binary": str(args.reference_binary) if args.reference_binary else None, - "metrics": {mode: {key: {"median": round(statistics.median(row[key] for row in rows), 3), - "samples": [round(row[key], 3) for row in rows]} - for key in rows[0]} for mode, rows in samples.items()}, + "ordering": orders, + "load_average_before": initial_load, + "load_average_after": os.getloadavg(), + "executables": { + mode: {"path": str(executable), "mode": binary_mode, + "sha256": hashlib.sha256(executable.read_bytes()).hexdigest()} + for mode, (executable, binary_mode) in commands.items() + }, + "metrics": { + mode: { + key: { + "median": round(statistics.median(values), 3), + "p25": round(percentile(values, .25), 3), + "p75": round(percentile(values, .75), 3), + "min": round(min(values), 3), + "max": round(max(values), 3), + "samples": [round(value, 3) for value in values], + } + for key in rows[0] + for values in [[row[key] for row in rows]] + } + for mode, rows in samples.items() + }, } data = json.dumps(result, indent=2) print(data) diff --git a/tools/profile_gameplay_decode.py b/tools/profile_gameplay_decode.py new file mode 100644 index 000000000..06e2ff5fb --- /dev/null +++ b/tools/profile_gameplay_decode.py @@ -0,0 +1,64 @@ +#!/usr/bin/env python3 +"""Profile the validation and typed-deserialization passes in separate processes. + +Build `cargo build --release -p horizon-client --example gameplay_decode_profile` +then run this tool with the matching prepared resources. These passes are +both currently required for exact JSON error classification/precedence. +""" +import argparse +import hashlib +import json +import os +import statistics +from pathlib import Path +from profile_client_startup import percentile, run + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--binary", type=Path, + default=Path("target/release/examples/gameplay_decode_profile")) + parser.add_argument("--resources", type=Path, default=Path(".local/horizon-client/26.3")) + parser.add_argument("--repeats", type=int, default=8) + parser.add_argument("--output", type=Path) + args = parser.parse_args() + if args.repeats < 1: + parser.error("--repeats must be positive") + binary, resources = args.binary.resolve(), args.resources.resolve() + if not binary.is_file() or not resources.is_dir(): + parser.error("release example or resources missing") + modes = ("validate", "typed") + samples = {mode: [] for mode in modes} + loads = [os.getloadavg()] + for i in range(args.repeats): + for mode in (modes if i % 2 == 0 else reversed(modes)): + samples[mode].append(run(binary, resources, mode)) + loads.append(os.getloadavg()) + result = { + "scope": "Isolated gameplay-facts.json validation/typed decoding; includes JSON file read", + "resources": str(resources), + "repeats": args.repeats, + "load_averages_before_after": loads, + "binary_sha256": hashlib.sha256(binary.read_bytes()).hexdigest(), + "metrics": { + mode: { + key: {"median": round(statistics.median(values), 3), + "p25": round(percentile(values, .25), 3), + "p75": round(percentile(values, .75), 3), + "min": round(min(values), 3), "max": round(max(values), 3), + "samples": [round(x, 3) for x in values]} + for key in rows[0] + for values in [[row[key] for row in rows]] + } + for mode, rows in samples.items() + }, + } + data = json.dumps(result, indent=2) + print(data) + if args.output: + args.output.parent.mkdir(parents=True, exist_ok=True) + args.output.write_text(data + "\n") + + +if __name__ == "__main__": + main() From b2f0af559b3244dc07caedd1cfcbd33b0cc92bb1 Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 21:34:18 -0400 Subject: [PATCH 39/59] Accept and handle mouse bindings for Extras --- crates/horizon-client/src/game.rs | 3 + crates/horizon-client/src/game/extras.rs | 6 +- crates/horizon-client/src/game/options.rs | 11 +-- crates/horizon-client/src/game/tweaks.rs | 10 ++- crates/horizon-client/src/options_horizon.rs | 11 ++- crates/horizon-client/src/options_ui.rs | 83 +++++++++++++++++--- 6 files changed, 100 insertions(+), 24 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index e552eb118..4496e6e73 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -9360,6 +9360,9 @@ impl ApplicationHandler for Game<'_> { } WindowEvent::MouseInput { state, button, .. } => { let pressed = state == ElementState::Pressed; + if pressed && self.sort_mouse_press(button) { + return Ok(()); + } match self.screen { Screen::Playing => { if pressed && !self.captured { diff --git a/crates/horizon-client/src/game/extras.rs b/crates/horizon-client/src/game/extras.rs index c6ac6d25e..712796a81 100644 --- a/crates/horizon-client/src/game/extras.rs +++ b/crates/horizon-client/src/game/extras.rs @@ -58,8 +58,12 @@ impl Game<'_> { pub(super) fn extras_scroll(&mut self, steps: f32) -> bool { self.settings.extras.zoom && self.extras.zoom.scroll(steps) } - /// Mouse buttons while playing, for the keystroke overlay. + /// Mouse buttons while playing, for zoom and the keystroke overlay. pub(super) fn extras_mouse(&mut self, button: MouseButton, pressed: bool) { + let e = &self.settings.extras; + if e.zoom && e.zoom_key == keybinds::mouse_name(button) { + self.extras.zoom.key(pressed, false, true, e.zoom_level); + } let i = match button { MouseButton::Left => 0, MouseButton::Right => 1, diff --git a/crates/horizon-client/src/game/options.rs b/crates/horizon-client/src/game/options.rs index dcc7bb23b..e8057cf31 100644 --- a/crates/horizon-client/src/game/options.rs +++ b/crates/horizon-client/src/game/options.rs @@ -186,16 +186,11 @@ impl Game<'_> { } /// Mouse buttons pressed while a key is being bound. pub(super) fn options_waiting_for_key(&self) -> bool { - self.ui.options.selected_key.is_some() && self.ui.options.page() == Page::KeyBinds + self.ui.options.selected_key.is_some() } pub(super) fn options_bind_mouse(&mut self, button: MouseButton) -> Result<()> { - if let Some(name) = self.ui.options.selected_key.take() { - self.settings - .keys - .set(name, &horizon_client::keybinds::mouse_name(button)); - self.handle_option_events(vec![Event::Changed])?; - } - Ok(()) + let events = self.ui.options.bind_mouse(&mut self.settings, button); + self.handle_option_events(events) } pub(super) fn handle_option_events(&mut self, events: Vec) -> Result<()> { for e in events { diff --git a/crates/horizon-client/src/game/tweaks.rs b/crates/horizon-client/src/game/tweaks.rs index dc87a13bf..018b6640b 100644 --- a/crates/horizon-client/src/game/tweaks.rs +++ b/crates/horizon-client/src/game/tweaks.rs @@ -28,7 +28,7 @@ use horizon_client::{ menu::Input, stations::hover_name, }; -use winit::keyboard::KeyCode; +use winit::{event::MouseButton, keyboard::KeyCode}; /// A sort button's side in GUI pixels. const SORT_BUTTON: f32 = 9.0; @@ -377,8 +377,14 @@ impl Game<'_> { /// The sort key: sorts the part under the cursor (the container when /// the cursor is over no slot). pub(super) fn sort_key_press(&mut self, key: KeyCode) -> bool { + keybinds::key_name(key).is_some_and(|name| self.sort_input(name)) + } + pub(super) fn sort_mouse_press(&mut self, button: MouseButton) -> bool { + self.sort_input(&keybinds::mouse_name(button)) + } + fn sort_input(&mut self, name: &str) -> bool { let e = &self.settings.extras; - if !e.sort || keybinds::key_code(&e.sort_key) != Some(key) || self.recipe_search_focused() { + if !e.sort || e.sort_key != name || self.recipe_search_focused() { return false; } let buttons = self.sort_buttons(); diff --git a/crates/horizon-client/src/options_horizon.rs b/crates/horizon-client/src/options_horizon.rs index bfaf05c9b..634bb8d75 100644 --- a/crates/horizon-client/src/options_horizon.rs +++ b/crates/horizon-client/src/options_horizon.rs @@ -587,9 +587,16 @@ impl OptionsUi { } return events; } - // A click anywhere stops waiting for an extra's key. + // Rebinding consumes the click before sidebar or widget actions. if matches!(self.selected_key, Some(extras::ZOOM_KEY | extras::SORT_KEY)) { - self.selected_key = None; + return self.bind_mouse( + s, + if right { + winit::event::MouseButton::Right + } else { + winit::event::MouseButton::Left + }, + ); } match self.horizon_target(s, atlas, x, y) { Some(Target::Nav(i)) => { diff --git a/crates/horizon-client/src/options_ui.rs b/crates/horizon-client/src/options_ui.rs index 38be29576..6606d31fd 100644 --- a/crates/horizon-client/src/options_ui.rs +++ b/crates/horizon-client/src/options_ui.rs @@ -1876,15 +1876,13 @@ impl OptionsUi { return events; } // Key Binds: a mouse button pressed while waiting binds it. - if let Some(name) = self.selected_key.take() { + if self.selected_key.is_some() { let button = if right { - "key.mouse.right" + winit::event::MouseButton::Right } else { - "key.mouse.left" + winit::event::MouseButton::Left }; - s.keys.set(name, button); - events.push(Event::Changed); - return events; + return self.bind_mouse(s, button); } // AbstractWidget accepts only the primary button. Rebinding above // accepts other mouse buttons, but is not a widget activation. @@ -2126,6 +2124,23 @@ impl OptionsUi { } false } + fn bind_key(&mut self, s: &mut Settings, value: String) -> Vec { + let Some(name) = self.selected_key.take() else { + return Vec::new(); + }; + if !s.extras.set_key(name, value.clone()) { + s.keys.set(name, &value); + } + vec![Event::Changed] + } + /// Mouse bindings use the same settings and persistence as keyboard bindings. + pub fn bind_mouse( + &mut self, + s: &mut Settings, + button: winit::event::MouseButton, + ) -> Vec { + self.bind_key(s, keybinds::mouse_name(button)) + } /// Keys while the options are open. Returns events; `handled` false lets /// Escape fall through. pub fn key( @@ -2160,7 +2175,7 @@ impl OptionsUi { } return vec![Event::Changed]; } - if let Some(name) = self.selected_key.take() { + if self.selected_key.is_some() { // KeyBindsScreen.keyPressed: Escape unbinds. let value = if key == K::Escape { "key.keyboard.unknown".to_owned() @@ -2169,10 +2184,7 @@ impl OptionsUi { .unwrap_or("key.keyboard.unknown") .to_owned() }; - if !s.extras.set_key(name, value.clone()) { - s.keys.set(name, &value); - } - return vec![Event::Changed]; + return self.bind_key(s, value); } if key == K::Escape { return self.back(s); @@ -2831,6 +2843,55 @@ mod tests { } } + #[test] + fn extras_and_vanilla_bindings_accept_mouse_buttons() { + use crate::extras::{Extras, SORT_KEY, ZOOM_KEY}; + use winit::event::MouseButton; + for button in [ + MouseButton::Left, + MouseButton::Right, + MouseButton::Middle, + MouseButton::Back, + MouseButton::Forward, + ] { + for name in [SORT_KEY, ZOOM_KEY, "key.jump"] { + let mut ui = OptionsUi::default(); + let mut s = Settings::default(); + ui.selected_key = Some(name); + assert_eq!(ui.bind_mouse(&mut s, button), vec![Event::Changed]); + assert_eq!(ui.selected_key, None); + let value = keybinds::mouse_name(button); + match name { + SORT_KEY => assert_eq!(s.extras.sort_key, value), + ZOOM_KEY => assert_eq!(s.extras.zoom_key, value), + _ => assert_eq!(s.keys.get(name), value), + } + assert_eq!(Extras::parse(&s.extras.serialize()), s.extras); + if name != "key.jump" { + assert_eq!(s.keys, Settings::default().keys); + } + assert!(ui.bind_mouse(&mut s, button).is_empty()); + } + } + } + + #[test] + fn horizon_extra_mouse_binding_consumes_the_click() { + let atlas = atlas(); + let mut s = Settings::default(); + let mut ui = OptionsUi::default(); + for (right, expected) in [(false, "key.mouse.left"), (true, "key.mouse.right")] { + ui.selected_key = Some(crate::extras::SORT_KEY); + assert_eq!( + ui.click_horizon(&mut s, &atlas, 2.0, 2.0, [960, 480], false, right), + vec![Event::Changed] + ); + assert_eq!(s.extras.sort_key, expected); + assert_eq!(ui.selected_key, None); + assert_eq!(ui.section, 0); + } + } + #[test] fn key_rebinding_takes_precedence_over_scrollbar_dragging() { let atlas = atlas(); From b174299f2527fd55cd5d988c2a16ad9040131c8d Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 21:37:36 -0400 Subject: [PATCH 40/59] Match vanilla player render scale and inventory title height --- crates/horizon-client/src/game.rs | 9 +-------- crates/horizon-client/src/game/perspective.rs | 17 +++++++++++++++++ crates/horizon-client/src/mobs/render.rs | 4 ++++ 3 files changed, 22 insertions(+), 8 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 5ffcd9124..e4fd53062 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -4336,14 +4336,7 @@ impl Game<'_> { } else { ("Crafting", 97.0) }; - batch.text( - atlas, - title, - ox + tx, - oy + if self.craft_size == 3 { 6.0 } else { 8.0 }, - grey, - false, - ); + batch.text(atlas, title, ox + tx, oy + 6.0, grey, false); if self.craft_size == 3 { batch.text(atlas, "Inventory", ox + 8.0, oy + 72.0, grey, false); } diff --git a/crates/horizon-client/src/game/perspective.rs b/crates/horizon-client/src/game/perspective.rs index a66ca487d..e09d06244 100644 --- a/crates/horizon-client/src/game/perspective.rs +++ b/crates/horizon-client/src/game/perspective.rs @@ -619,6 +619,23 @@ fn player_preview_quads( #[cfg(test)] mod preview_tests { use super::*; + #[test] + #[ignore = "requires prepared model data in HORIZON_TEST_RESOURCES"] + fn player_render_transform_uses_vanilla_avatar_scale() { + let root = std::path::PathBuf::from( + std::env::var_os("HORIZON_TEST_RESOURCES").expect("HORIZON_TEST_RESOURCES"), + ); + let mut m = Mob::new(1, player_type(&root).unwrap(), Vec3::ZERO, 0.0); + for (id, expected) in [("minecraft:player", 0.9375), ("minecraft:zombie", 1.0)] { + Arc::make_mut(&mut m.kind).id = id.into(); + let transform = + horizon_client::mobs::render::base_transform_at(&m, 1.0, glam::Mat4::IDENTITY); + for axis in [glam::Vec3::X, glam::Vec3::Y, glam::Vec3::Z] { + assert!((transform.transform_vector3(axis).length() - expected).abs() < 1e-6); + } + } + } + #[test] fn burning_inventory_preview_keeps_visible_fullbright_flames() { let rect = |u0| horizon_client::hud::Rect { diff --git a/crates/horizon-client/src/mobs/render.rs b/crates/horizon-client/src/mobs/render.rs index 4c312e5fd..e8120e92e 100644 --- a/crates/horizon-client/src/mobs/render.rs +++ b/crates/horizon-client/src/mobs/render.rs @@ -847,6 +847,10 @@ fn red_overlay(m: &Mob) -> bool { m.hurt_time > 0 || (m.death_time > 0 && !super::creaking::tearing_down(m)) } fn species_scale(m: &Mob, alpha: f32) -> glam::Mat4 { + if m.kind.id == "minecraft:player" { + // AvatarRenderer.scale, shared by the inventory and world renderer. + return glam::Mat4::from_scale(glam::Vec3::splat(0.9375)); + } match m.species() { Species::Wither => { glam::Mat4::from_scale(glam::Vec3::splat(super::wither::scale(m, alpha))) From ef633b252f61a1562b7355554ae015ee1ffd635a Mon Sep 17 00:00:00 2001 From: rdbtCVS <87152661+rdbtCVS@users.noreply.github.com> Date: Sat, 17 Oct 2026 02:37:44 +0100 Subject: [PATCH 41/59] test: run parity from worktrees and document startup profiles --- .../shared-json-buffer-lifetime-20261017.json | 379 ++++++++++++ .../shared-json-five-way-final-20261017.json | 582 ++++++++++++++++++ .../src/random_tick_sections.rs | 9 +- tools/PROFILE_SHARED_JSON.md | 85 +++ tools/baseline_loader_profile.rs | 23 + 5 files changed, 1077 insertions(+), 1 deletion(-) create mode 100644 benchmarks/shared-json-buffer-lifetime-20261017.json create mode 100644 benchmarks/shared-json-five-way-final-20261017.json create mode 100644 tools/PROFILE_SHARED_JSON.md create mode 100644 tools/baseline_loader_profile.rs diff --git a/benchmarks/shared-json-buffer-lifetime-20261017.json b/benchmarks/shared-json-buffer-lifetime-20261017.json new file mode 100644 index 000000000..d618906ed --- /dev/null +++ b/benchmarks/shared-json-buffer-lifetime-20261017.json @@ -0,0 +1,379 @@ +{ + "scope": "Assets + BlockFacts + Behaviours loader only; no full startup or first frame", + "resources": "/srv/bob-data/horizon/.local/horizon-client/26.3", + "repeats": 10, + "ordering": [ + [ + "released", + "retained" + ], + [ + "retained", + "released" + ], + [ + "released", + "retained" + ], + [ + "retained", + "released" + ], + [ + "released", + "retained" + ], + [ + "retained", + "released" + ], + [ + "released", + "retained" + ], + [ + "retained", + "released" + ], + [ + "released", + "retained" + ], + [ + "retained", + "released" + ] + ], + "load_average_before": [ + 8.2421875, + 6.56396484375, + 6.39208984375 + ], + "load_average_after": [ + 7.98095703125, + 6.6455078125, + 6.4248046875 + ], + "executables": { + "released": { + "path": "/srv/bob-data/horizon/.worktrees/shared-block-json-20261017/target/release/examples/shared_json_startup_profile-integrated", + "mode": "deferred", + "sha256": "a52d6a7efc7b3198ef0dd8150325f56a3fe5d0c5883fd6d14c4b0c281866ce7c" + }, + "retained": { + "path": "/srv/bob-data/horizon/.worktrees/shared-block-json-20261017/target/release/examples/shared_json_startup_profile-integrated", + "mode": "deferred-held", + "sha256": "a52d6a7efc7b3198ef0dd8150325f56a3fe5d0c5883fd6d14c4b0c281866ce7c" + } + }, + "metrics": { + "released": { + "phase_ms": { + "median": 482.591, + "p25": 444.276, + "p75": 586.92, + "min": 430.128, + "max": 736.543, + "samples": [ + 529.244, + 606.146, + 449.23, + 442.624, + 669.108, + 511.519, + 736.543, + 432.616, + 430.128, + 453.663 + ] + }, + "total_ms": { + "median": 987.004, + "p25": 932.885, + "p75": 1134.876, + "min": 914.242, + "max": 1201.759, + "samples": [ + 1055.119, + 1161.462, + 968.629, + 914.242, + 1201.759, + 1005.379, + 1200.01, + 928.249, + 935.775, + 931.921 + ] + }, + "cpu_ms": { + "median": 1004.675, + "p25": 936.465, + "p75": 1116.791, + "min": 908.327, + "max": 1241.168, + "samples": [ + 1074.425, + 1130.913, + 984.832, + 931.205, + 1186.169, + 1024.519, + 1241.168, + 908.327, + 952.245, + 927.15 + ] + }, + "peak_rss_kib": { + "median": 268124.0, + "p25": 267753.0, + "p75": 268455.0, + "min": 267708, + "max": 268700, + "samples": [ + 268268, + 268500, + 267744, + 267724, + 267708, + 267780, + 268700, + 268496, + 268332, + 267980 + ] + }, + "behaviour_json_ms": { + "median": 24.371, + "p25": 22.469, + "p75": 28.486, + "min": 20.662, + "max": 35.297, + "samples": [ + 33.387, + 35.297, + 24.732, + 24.011, + 27.699, + 28.748, + 23.623, + 22.084, + 20.662, + 21.266 + ] + }, + "facts_ms": { + "median": 292.77, + "p25": 270.649, + "p75": 383.193, + "min": 264.691, + "max": 443.291, + "samples": [ + 346.613, + 398.468, + 274.673, + 264.691, + 443.291, + 292.926, + 395.387, + 267.232, + 269.308, + 292.615 + ] + }, + "behaviours_ms": { + "median": 148.635, + "p25": 141.329, + "p75": 181.741, + "min": 136.361, + "max": 307.004, + "samples": [ + 145.009, + 168.982, + 146.535, + 150.736, + 194.604, + 185.994, + 307.004, + 140.102, + 136.785, + 136.361 + ] + }, + "post_rss_kib": { + "median": 268668.0, + "p25": 268246.0, + "p75": 268922.0, + "min": 268048.0, + "max": 269012.0, + "samples": [ + 268668.0, + 268936.0, + 268108.0, + 268088.0, + 268048.0, + 268668.0, + 268880.0, + 269012.0, + 268960.0, + 268660.0 + ] + } + }, + "retained": { + "phase_ms": { + "median": 487.954, + "p25": 471.456, + "p75": 531.586, + "min": 401.516, + "max": 834.154, + "samples": [ + 486.974, + 613.755, + 540.535, + 470.333, + 488.934, + 474.825, + 834.154, + 504.74, + 401.516, + 440.381 + ] + }, + "total_ms": { + "median": 1038.875, + "p25": 989.724, + "p75": 1079.197, + "min": 880.933, + "max": 1746.386, + "samples": [ + 996.407, + 1067.467, + 1082.69, + 1103.131, + 1010.283, + 1068.719, + 1746.386, + 987.496, + 890.46, + 880.933 + ] + }, + "cpu_ms": { + "median": 1035.537, + "p25": 982.276, + "p75": 1082.698, + "min": 908.774, + "max": 1660.068, + "samples": [ + 1011.712, + 1087.688, + 1076.523, + 1084.757, + 998.654, + 1059.363, + 1660.068, + 976.817, + 912.849, + 908.774 + ] + }, + "peak_rss_kib": { + "median": 268150.0, + "p25": 267537.0, + "p75": 268614.0, + "min": 267268, + "max": 268848, + "samples": [ + 268748, + 267968, + 267268, + 268332, + 267540, + 268560, + 267492, + 268632, + 267536, + 268848 + ] + }, + "behaviour_json_ms": { + "median": 23.208, + "p25": 22.305, + "p75": 26.544, + "min": 20.059, + "max": 32.669, + "samples": [ + 32.669, + 22.62, + 22.2, + 27.331, + 25.088, + 27.029, + 23.488, + 20.977, + 22.928, + 20.059 + ] + }, + "facts_ms": { + "median": 304.44, + "p25": 291.562, + "p75": 330.991, + "min": 244.758, + "max": 384.634, + "samples": [ + 307.936, + 374.145, + 336.931, + 300.944, + 290.81, + 293.817, + 384.634, + 313.171, + 244.758, + 279.303 + ] + }, + "behaviours_ms": { + "median": 162.285, + "p25": 143.135, + "p75": 179.31, + "min": 133.83, + "max": 426.031, + "samples": [ + 146.367, + 216.988, + 181.402, + 142.058, + 173.036, + 153.978, + 426.031, + 170.592, + 133.83, + 141.017 + ] + }, + "post_rss_kib": { + "median": 268694.0, + "p25": 268116.0, + "p75": 269056.0, + "min": 267988.0, + "max": 269212.0, + "samples": [ + 269212.0, + 268564.0, + 268096.0, + 268824.0, + 268176.0, + 269032.0, + 267988.0, + 269064.0, + 268044.0, + 269120.0 + ] + } + } + } +} diff --git a/benchmarks/shared-json-five-way-final-20261017.json b/benchmarks/shared-json-five-way-final-20261017.json new file mode 100644 index 000000000..ce92b7b61 --- /dev/null +++ b/benchmarks/shared-json-five-way-final-20261017.json @@ -0,0 +1,582 @@ +{ + "scope": "Assets + BlockFacts + Behaviours loader only; no full startup or first frame", + "resources": "/srv/bob-data/horizon/.local/horizon-client/26.3", + "repeats": 10, + "ordering": [ + [ + "baseline", + "a01d47f2", + "cf837118", + "cd61e11b", + "current" + ], + [ + "current", + "cd61e11b", + "cf837118", + "a01d47f2", + "baseline" + ], + [ + "baseline", + "a01d47f2", + "cf837118", + "cd61e11b", + "current" + ], + [ + "current", + "cd61e11b", + "cf837118", + "a01d47f2", + "baseline" + ], + [ + "baseline", + "a01d47f2", + "cf837118", + "cd61e11b", + "current" + ], + [ + "current", + "cd61e11b", + "cf837118", + "a01d47f2", + "baseline" + ], + [ + "baseline", + "a01d47f2", + "cf837118", + "cd61e11b", + "current" + ], + [ + "current", + "cd61e11b", + "cf837118", + "a01d47f2", + "baseline" + ], + [ + "baseline", + "a01d47f2", + "cf837118", + "cd61e11b", + "current" + ], + [ + "current", + "cd61e11b", + "cf837118", + "a01d47f2", + "baseline" + ] + ], + "load_average_before": [ + 11.4921875, + 7.46875, + 6.69677734375 + ], + "load_average_after": [ + 17.763671875, + 11.39013671875, + 8.20556640625 + ], + "executables": { + "baseline": { + "path": "/srv/bob-data/horizon/.worktrees/shared-block-json-20261017/target/release/examples/shared_json_startup_profile-e422bd13", + "mode": "baseline", + "sha256": "bf61f2e6c92e001be3c3bc93cf8072cc6af6fd1d7bcfa7273045960948ec89e7" + }, + "a01d47f2": { + "path": "/srv/bob-data/horizon/.worktrees/shared-block-json-20261017/target/release/examples/shared_json_startup_profile-a01d47f2", + "mode": "shared", + "sha256": "88be56f8dbd28d0b4abd6c672486ba758df96ba18f68da45b94db14231dd3eea" + }, + "cf837118": { + "path": "/srv/bob-data/horizon/.worktrees/shared-block-json-20261017/target/release/examples/shared_json_startup_profile-cf837118", + "mode": "deferred", + "sha256": "f1b044cd9ac2f67c644fb40bd7ecbe38128ec739a8112d57fc36f05fe9036a52" + }, + "cd61e11b": { + "path": "/srv/bob-data/horizon/.worktrees/shared-block-json-20261017/target/release/examples/shared_json_startup_profile-cd61e11b", + "mode": "deferred", + "sha256": "fb2d3725b09ee38f85b49901f7053a6fe339b980a2b2dac6930a8ded22c139e8" + }, + "current": { + "path": "/srv/bob-data/horizon/.worktrees/shared-block-json-20261017/target/release/examples/shared_json_startup_profile-integrated", + "mode": "deferred", + "sha256": "a52d6a7efc7b3198ef0dd8150325f56a3fe5d0c5883fd6d14c4b0c281866ce7c" + } + }, + "metrics": { + "baseline": { + "phase_ms": { + "median": 1506.588, + "p25": 1388.314, + "p75": 2119.85, + "min": 1319.319, + "max": 3143.124, + "samples": [ + 3143.124, + 2483.307, + 2124.952, + 2104.544, + 1525.153, + 1396.75, + 1381.771, + 1488.022, + 1385.502, + 1319.319 + ] + }, + "total_ms": { + "median": 1962.122, + "p25": 1858.188, + "p75": 3152.608, + "min": 1804.713, + "max": 4136.912, + "samples": [ + 4136.912, + 3250.285, + 3134.13, + 3158.767, + 2001.229, + 1883.076, + 1849.892, + 1923.016, + 1818.34, + 1804.713 + ] + }, + "cpu_ms": { + "median": 1969.296, + "p25": 1893.348, + "p75": 2694.824, + "min": 1842.049, + "max": 3059.824, + "samples": [ + 3059.824, + 2765.392, + 2698.837, + 2682.786, + 2026.89, + 1911.703, + 1888.282, + 1908.545, + 1859.233, + 1842.049 + ] + }, + "peak_rss_kib": { + "median": 819952.0, + "p25": 819778.0, + "p75": 820164.0, + "min": 818944, + "max": 820304, + "samples": [ + 819956, + 819744, + 818944, + 818984, + 820128, + 820176, + 819948, + 820236, + 819880, + 820304 + ] + } + }, + "a01d47f2": { + "phase_ms": { + "median": 666.765, + "p25": 520.278, + "p75": 1156.022, + "min": 450.677, + "max": 1882.249, + "samples": [ + 1001.208, + 1309.911, + 1207.627, + 1882.249, + 747.233, + 544.933, + 512.06, + 450.677, + 466.596, + 586.298 + ] + }, + "total_ms": { + "median": 1141.968, + "p25": 974.723, + "p75": 2326.553, + "min": 922.496, + "max": 3158.114, + "samples": [ + 2374.699, + 2275.18, + 2343.677, + 3158.114, + 1267.594, + 1006.411, + 964.16, + 922.496, + 936.687, + 1016.342 + ] + }, + "cpu_ms": { + "median": 1106.901, + "p25": 973.629, + "p75": 1525.998, + "min": 929.573, + "max": 1568.573, + "samples": [ + 1545.278, + 1568.573, + 1468.158, + 1563.377, + 1196.236, + 1017.565, + 960.219, + 929.573, + 946.096, + 1013.861 + ] + }, + "peak_rss_kib": { + "median": 351564.0, + "p25": 351148.0, + "p75": 352106.0, + "min": 350416, + "max": 353368, + "samples": [ + 351572, + 351268, + 351108, + 350416, + 351656, + 353368, + 352256, + 351556, + 350964, + 352308 + ] + } + }, + "cf837118": { + "phase_ms": { + "median": 505.124, + "p25": 435.315, + "p75": 1103.87, + "min": 417.056, + "max": 1875.147, + "samples": [ + 1875.147, + 1129.722, + 1066.305, + 1116.391, + 461.019, + 423.38, + 417.056, + 445.353, + 549.229, + 431.969 + ] + }, + "total_ms": { + "median": 1209.375, + "p25": 895.862, + "p75": 2133.144, + "min": 872.434, + "max": 2936.234, + "samples": [ + 2936.234, + 2215.538, + 1885.964, + 2695.131, + 1378.495, + 879.351, + 897.968, + 895.16, + 1040.255, + 872.434 + ] + }, + "cpu_ms": { + "median": 1068.41, + "p25": 896.926, + "p75": 1488.578, + "min": 882.398, + "max": 1570.652, + "samples": [ + 1530.601, + 1520.851, + 1391.76, + 1570.652, + 1116.403, + 900.779, + 894.039, + 895.642, + 1020.417, + 882.398 + ] + }, + "peak_rss_kib": { + "median": 273832.0, + "p25": 273592.0, + "p75": 274131.0, + "min": 272732, + "max": 274976, + "samples": [ + 274080, + 272732, + 273560, + 273468, + 274200, + 274148, + 273728, + 273936, + 274976, + 273688 + ] + } + }, + "cd61e11b": { + "phase_ms": { + "median": 429.481, + "p25": 410.043, + "p75": 1178.091, + "min": 399.576, + "max": 1644.881, + "samples": [ + 1194.624, + 1128.491, + 1644.881, + 1428.78, + 405.544, + 434.62, + 424.341, + 414.829, + 408.447, + 399.576 + ] + }, + "total_ms": { + "median": 902.865, + "p25": 868.889, + "p75": 2443.447, + "min": 827.16, + "max": 2961.261, + "samples": [ + 2682.056, + 2199.278, + 2524.837, + 2961.261, + 884.838, + 885.282, + 848.79, + 863.573, + 920.448, + 827.16 + ] + }, + "cpu_ms": { + "median": 920.917, + "p25": 869.777, + "p75": 1475.629, + "min": 840.036, + "max": 1626.459, + "samples": [ + 1518.201, + 1496.456, + 1413.149, + 1626.459, + 893.762, + 899.049, + 861.782, + 861.417, + 942.785, + 840.036 + ] + }, + "peak_rss_kib": { + "median": 267762.0, + "p25": 267612.0, + "p75": 267966.0, + "min": 266300, + "max": 268636, + "samples": [ + 266672, + 268636, + 266300, + 267596, + 267660, + 268280, + 267968, + 267680, + 267960, + 267844 + ] + } + }, + "current": { + "phase_ms": { + "median": 460.489, + "p25": 429.004, + "p75": 986.935, + "min": 404.103, + "max": 1300.033, + "samples": [ + 992.891, + 1126.098, + 1300.033, + 969.067, + 443.604, + 408.397, + 472.429, + 424.137, + 448.549, + 404.103 + ] + }, + "total_ms": { + "median": 935.623, + "p25": 874.18, + "p75": 2282.679, + "min": 839.642, + "max": 2965.198, + "samples": [ + 2320.566, + 2169.019, + 2965.198, + 2531.591, + 924.347, + 839.642, + 946.899, + 873.617, + 875.87, + 854.328 + ] + }, + "cpu_ms": { + "median": 950.702, + "p25": 892.992, + "p75": 1540.918, + "min": 861.669, + "max": 1586.478, + "samples": [ + 1557.765, + 1503.564, + 1553.369, + 1586.478, + 931.391, + 861.669, + 970.013, + 888.14, + 907.549, + 868.73 + ] + }, + "peak_rss_kib": { + "median": 268010.0, + "p25": 267013.0, + "p75": 268385.0, + "min": 266144, + "max": 268876, + "samples": [ + 266824, + 267580, + 266516, + 266144, + 267976, + 268304, + 268044, + 268480, + 268412, + 268876 + ] + }, + "behaviour_json_ms": { + "median": 34.288, + "p25": 23.085, + "p75": 37.474, + "min": 20.137, + "max": 70.397, + "samples": [ + 37.07, + 70.397, + 37.609, + 38.225, + 34.568, + 21.094, + 23.469, + 22.957, + 34.008, + 20.137 + ] + }, + "facts_ms": { + "median": 272.839, + "p25": 256.553, + "p75": 618.472, + "min": 248.146, + "max": 780.388, + "samples": [ + 625.908, + 693.735, + 780.388, + 596.165, + 272.718, + 249.954, + 272.959, + 264.913, + 253.767, + 248.146 + ] + }, + "behaviours_ms": { + "median": 162.633, + "p25": 133.345, + "p75": 326.117, + "min": 132.828, + "max": 476.9, + "samples": [ + 325.198, + 356.28, + 476.9, + 326.424, + 132.828, + 133.946, + 167.929, + 133.144, + 157.337, + 132.934 + ] + }, + "post_rss_kib": { + "median": 268408.0, + "p25": 267369.0, + "p75": 268861.0, + "min": 267052.0, + "max": 269072.0, + "samples": [ + 267084.0, + 268056.0, + 267052.0, + 267140.0, + 268184.0, + 268632.0, + 268660.0, + 269072.0, + 268928.0, + 268960.0 + ] + } + } + } +} diff --git a/crates/horizon-client/src/random_tick_sections.rs b/crates/horizon-client/src/random_tick_sections.rs index 647636fd6..97a1f02fa 100644 --- a/crates/horizon-client/src/random_tick_sections.rs +++ b/crates/horizon-client/src/random_tick_sections.rs @@ -208,7 +208,14 @@ mod tick_parity { let root = std::env::var_os("HORIZON_RESOURCES") .map(PathBuf::from) .unwrap_or_else(|| { - PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("../../.local/horizon-client/26.3") + let manifest = PathBuf::from(env!("CARGO_MANIFEST_DIR")); + let local = manifest.join("../../.local/horizon-client/26.3"); + if local.join("gameplay-facts.json").exists() { + local + } else { + // The branch worktree lives below the main checkout. + manifest.join("../../../../.local/horizon-client/26.3") + } }); if !root.join("gameplay-facts.json").exists() { eprintln!( diff --git a/tools/PROFILE_SHARED_JSON.md b/tools/PROFILE_SHARED_JSON.md new file mode 100644 index 000000000..7712dda32 --- /dev/null +++ b/tools/PROFILE_SHARED_JSON.md @@ -0,0 +1,85 @@ +# Reproducing PR #607 block-facts startup profiles + +These are loader-only measurements. They include `Assets::load`, `BlockFacts`, and +`Behaviours` and exclude content root preparation, graphics, input setup, first +frame, and the rest of the client startup sequence. No full-client startup gain +has been measured. The prepared `26.3` resource root must match the revision. + +## Historical release builds + +From the PR branch checkout, use an absolute prepared resource-root path and a +single, explicit Cargo release profile for each detached historical worktree: + +```sh +PR_ROOT="$(pwd)" +BENCH_ROOT="$(mktemp -d)" +mkdir -p "$BENCH_ROOT/bin" +CARGO_TARGET_DIR="$BENCH_ROOT/target" +export CARGO_TARGET_DIR + +for entry in baseline:e422bd13 a01:a01d47f2 cf:cf837118 cd:cd61e11b; do + name="${entry%%:*}" + revision="${entry#*:}" + git worktree add --detach "$BENCH_ROOT/$name" "$revision" +done + +# e422bd13 predates the profiler; add the same baseline example source used +# for the benchmark, without changing any production implementation. +cp "$PR_ROOT/tools/baseline_loader_profile.rs" \ + "$BENCH_ROOT/baseline/crates/horizon-client/examples/shared_json_startup_profile.rs" + +for name in baseline a01 cf cd; do + (cd "$BENCH_ROOT/$name" && \ + cargo build --offline --release -p horizon-client --example shared_json_startup_profile) + cp "$CARGO_TARGET_DIR/release/examples/shared_json_startup_profile" \ + "$BENCH_ROOT/bin/$name" +done + +cargo build --offline --release -p horizon-client --example shared_json_startup_profile +cp "$CARGO_TARGET_DIR/release/examples/shared_json_startup_profile" "$BENCH_ROOT/bin/current" + +python3 tools/profile_client_startup.py \ + --resources /absolute/path/to/.local/horizon-client/26.3 \ + --baseline-binary "$BENCH_ROOT/bin/baseline" \ + --a01-binary "$BENCH_ROOT/bin/a01" \ + --cf-binary "$BENCH_ROOT/bin/cf" \ + --cd-binary "$BENCH_ROOT/bin/cd" \ + --binary "$BENCH_ROOT/bin/current" \ + --repeats 10 --output "$BENCH_ROOT/five-way.json" +``` + +The source tree of each historical revision is exact. The baseline profiler is +an added standalone measurement example, and therefore does not alter its +historical loader logic. Comparisons use alternating forward/reverse process +order, separate processes, Linux `wait4` CPU time and peak RSS, and saved raw +samples with 25th/75th percentiles, extrema, build hashes and system load. +Keep concurrent compilation and other CPU-intensive jobs idle if possible. +`ru_maxrss` records process peak residency and cannot establish the real game's +memory usage after rendering begins. If system load rises, preserve rather than +discard outliers and report the uncertainty. + +## Decoding passes and buffer lifetime + +```sh +cargo build --offline --release -p horizon-client --example gameplay_decode_profile +python3 tools/profile_gameplay_decode.py \ + --resources /absolute/path/to/.local/horizon-client/26.3 \ + --repeats 10 --output "$BENCH_ROOT/decode.json" + +python3 tools/profile_client_startup.py \ + --resources /absolute/path/to/.local/horizon-client/26.3 \ + --variant released="$BENCH_ROOT/bin/current"@deferred \ + --variant retained="$BENCH_ROOT/bin/current"@deferred-held \ + --repeats 10 --output "$BENCH_ROOT/lifetime.json" +``` + +The decoder profile measures the `Validate` pass and typed `Gameplay` pass +separately, including the JSON read in `total_ms`. The primary facts loader +continues both passes to preserve JSON validation, error precedence and useful +diagnostics, including overwritten fields and raw geometry. The lifetime +comparison measures current process `VmRSS` after materialisation, plus peak +RSS across the process. An explicit `drop` releases owned Rust values, but the +allocator may retain physical pages, so immediate RSS savings are not implied. + +When finished, `git worktree remove` each temporary historical worktree. Do +not `git clean` or reset the active PR working tree. diff --git a/tools/baseline_loader_profile.rs b/tools/baseline_loader_profile.rs new file mode 100644 index 000000000..f966301b8 --- /dev/null +++ b/tools/baseline_loader_profile.rs @@ -0,0 +1,23 @@ +//! Historical baseline comparator for PR #607; one normal independent loading sequence. +use horizon_client::{assets::Assets, blocks::BlockFacts}; +use horizon_world::level::Behaviours; +use std::{path::Path, time::Instant}; + +fn main() -> Result<(), Box> { + let mut args = std::env::args().skip(1); + let root = args.next().ok_or("expected prepared resource directory")?; + if args.next().as_deref() != Some("baseline") { + return Err("expected baseline".into()); + } + let root = Path::new(&root); + let total = Instant::now(); + let assets = Assets::load(root)?; + let started = Instant::now(); + let facts = BlockFacts::load(root, assets.registry)?; + let behaviours = Behaviours::load(assets.registry, root)?; + println!("phase_ms={:.3}", started.elapsed().as_secs_f64() * 1000.0); + println!("total_ms={:.3}", total.elapsed().as_secs_f64() * 1000.0); + println!("states={}", facts.states.len()); + std::hint::black_box((facts, behaviours)); + Ok(()) +} From fab2a7cb0607e84f7d7b339e2407f7a17d97595c Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 21:40:07 -0400 Subject: [PATCH 42/59] Expose Horizon Extras in Classic Options --- crates/horizon-client/src/game/control.rs | 1 + crates/horizon-client/src/options_ui.rs | 113 +++++++++++++++++++++- 2 files changed, 113 insertions(+), 1 deletion(-) diff --git a/crates/horizon-client/src/game/control.rs b/crates/horizon-client/src/game/control.rs index e1169b2c8..87b6de5de 100644 --- a/crates/horizon-client/src/game/control.rs +++ b/crates/horizon-client/src/game/control.rs @@ -464,6 +464,7 @@ impl Game<'_> { "packs" => Page::Packs, "graphics" => Page::Graphics, "graphics-advanced" => Page::GraphicsAdvanced, + "extras" => Page::Extras, other => return Err(format!("unknown options page {other}").into()), }; if self.screen == Screen::Playing && self.title.is_none() { diff --git a/crates/horizon-client/src/options_ui.rs b/crates/horizon-client/src/options_ui.rs index 38be29576..11a398cc6 100644 --- a/crates/horizon-client/src/options_ui.rs +++ b/crates/horizon-client/src/options_ui.rs @@ -714,6 +714,7 @@ pub enum Page { /// Horizon's controller settings and button binds. Controller, PadBinds, + Extras, } #[derive(Clone, Debug, PartialEq)] enum Act { @@ -721,6 +722,7 @@ enum Act { Push(Page), Done, Cycle(Opt), + Extra(crate::extras::Item), Key(&'static str), ResetKey(&'static str), ResetKeys, @@ -974,6 +976,7 @@ impl OptionsUi { Page::Graphics | Page::GraphicsAdvanced => "options.videoTitle", Page::Controller => "Controller Settings", Page::PadBinds => "Controller Binds", + Page::Extras => "Horizon Extras", } } fn scrollbar_x(&self, width: f32) -> f32 { @@ -986,6 +989,22 @@ impl OptionsUi { } fn list_rows(&self, s: &Settings) -> Vec { match self.page() { + Page::Extras => crate::extras::rows() + .into_iter() + .map(|row| match row { + Err(header) => Row::Header(header), + Ok(item) => { + let value = format!("{}: {}", item.caption(), item.value(&s.extras)); + let label = + if item.key_name().is_some() && self.selected_key == item.key_name() { + Text::literal(format!("> {value} <")).with_color(text::YELLOW) + } else { + Text::literal(value) + }; + Row::Buttons(button(0.0, 0.0, 310.0, label, Act::Extra(item)), None) + } + }) + .collect(), Page::Video => { // Horizon's graphics screens, Simple and Advanced. let mut rows = vec![Row::Buttons( @@ -1207,7 +1226,7 @@ impl OptionsUi { ("options.resourcepack", Some(Page::Packs)), ("options.accessibility", Some(Page::Accessibility)), ("options.telemetry", None), - ("options.credits_and_attribution", None), + ("Horizon Extras...", Some(Page::Extras)), ]; let gy = (61.0 + 30.0f32).min(h - 33.0 - 120.0); for (i, (key, page)) in entries.iter().enumerate() { @@ -1631,6 +1650,13 @@ impl OptionsUi { let hover = ui::hovered(cursor, wd.x, wd.y, wd.w, wd.h) && (!wd.list || cursor.1 >= top && cursor.1 < bottom); if hover { + if let WKind::Button { + act: Act::Extra(item), + .. + } = &wd.kind + { + tooltip = Some(atlas.font.split(&Text::literal(item.description()), 170.0)); + } let key = match &wd.kind { WKind::Button { act: Act::Cycle(opt), @@ -1919,6 +1945,14 @@ impl OptionsUi { } events.push(Event::Changed); } + Act::Extra(item) => { + if let Some(name) = item.key_name() { + self.selected_key = Some(name); + } else { + item.cycle(&mut s.extras, right); + events.push(Event::Changed); + } + } Act::Key(name) => self.selected_key = Some(name), Act::ResetKey(name) => { s.keys.set(name, KeyBinds::default_of(name)); @@ -2316,6 +2350,83 @@ mod tests { } } + #[test] + fn classic_extras_entry_edits_shared_settings_and_returns_without_changing_style() { + let previous_style = style(); + set_style(MenuStyle::Classic); + let atlas = atlas(); + let mut s = Settings::default(); + let mut ui = OptionsUi::default(); + let size = (480.0, 480.0); + let click = |ui: &mut OptionsUi, s: &mut Settings, act: Act| { + let (widgets, _, _, _) = ui.layout(s, size.0, size.1); + let widget = widgets + .iter() + .find( + |w| matches!(&w.kind, WKind::Button { act: a, active: true, .. } if *a == act), + ) + .unwrap(); + ui.click( + s, + &atlas, + widget.x + 1.0, + widget.y + 1.0, + size, + [960, 960], + false, + false, + ) + }; + assert_eq!( + click(&mut ui, &mut s, Act::Push(Page::Extras)), + vec![Event::ButtonClick] + ); + assert_eq!(ui.page(), Page::Extras); + let (widgets, _, _, _) = ui.layout(&s, size.0, size.1); + assert_eq!( + widgets + .iter() + .filter(|w| matches!( + w.kind, + WKind::Button { + act: Act::Extra(_), + .. + } + )) + .count(), + crate::extras::rows().iter().filter(|r| r.is_ok()).count() + ); + assert_eq!( + click(&mut ui, &mut s, Act::Extra(crate::extras::Item::Zoom)), + vec![Event::ButtonClick, Event::Changed] + ); + assert!(s.extras.zoom); + assert_eq!( + click(&mut ui, &mut s, Act::Extra(crate::extras::Item::ZoomKey)), + vec![Event::ButtonClick] + ); + assert_eq!(ui.selected_key, Some(crate::extras::ZOOM_KEY)); + assert_eq!( + ui.key(&mut s, &atlas, winit::keyboard::KeyCode::KeyC, None), + vec![Event::Changed] + ); + assert_eq!(s.extras.zoom_key, "key.keyboard.c"); + assert_eq!( + crate::extras::Extras::parse(&s.extras.serialize()), + s.extras + ); + ui.scroll(&s, size, -1000.0); + let (_, top, bottom, content) = ui.layout(&s, size.0, size.1); + assert_eq!(ui.scroll, content - (bottom - top)); + assert_eq!( + ui.key(&mut s, &atlas, winit::keyboard::KeyCode::Escape, None), + vec![Event::Changed] + ); + assert_eq!(ui.page(), Page::Main); + assert_eq!(style(), MenuStyle::Classic); + set_style(previous_style); + } + #[test] fn classic_graphics_presets_set_the_distances() { let atlas = atlas(); From 8fa5c3866328ea6ae2879a0b750f3726a9a4eeba Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 21:42:01 -0400 Subject: [PATCH 43/59] Add an optional Fullbright extra --- crates/horizon-client/src/extras.rs | 18 ++++++++++++++++-- crates/horizon-client/src/game/options.rs | 1 + crates/horizon-client/src/gfx.rs | 6 ++++++ docs/extras.md | 7 ++++++- 4 files changed, 29 insertions(+), 3 deletions(-) diff --git a/crates/horizon-client/src/extras.rs b/crates/horizon-client/src/extras.rs index 264456c1a..ee142486c 100644 --- a/crates/horizon-client/src/extras.rs +++ b/crates/horizon-client/src/extras.rs @@ -68,6 +68,7 @@ impl Corner { #[derive(Clone, Debug, PartialEq)] pub struct Extras { + pub fullbright: bool, pub zoom: bool, /// A vanilla key name (`key.keyboard.z`). pub zoom_key: String, @@ -108,6 +109,7 @@ pub struct Extras { impl Default for Extras { fn default() -> Self { Self { + fullbright: false, zoom: false, zoom_key: "key.keyboard.z".into(), zoom_level: 4, @@ -155,6 +157,7 @@ impl Extras { _ => d, }; match key.trim() { + "fullbright" => e.fullbright = flag(e.fullbright), "zoom" => e.zoom = flag(e.zoom), "zoomKey" if value.starts_with("key.") => e.zoom_key = value.to_owned(), "zoomLevel" => { @@ -198,7 +201,8 @@ impl Extras { } pub fn serialize(&self) -> String { format!( - "zoom:{}\nzoomKey:{}\nzoomLevel:{}\nzoomSmooth:{}\nzoomSensitivity:{}\nfps:{}\nfpsCorner:{}\nfpsLows:{}\nkeystrokes:{}\nkeystrokesCorner:{}\nkeystrokesCps:{}\nminimap:{}\nminimapCorner:{}\nminimapSize:{}\nminimapShape:{}\nminimapZoom:{}\nminimapRotate:{}\nautoReconnect:{}\nmouseTweaks:{}\nmouseTweaksWheel:{}\nsort:{}\nsortKey:{}\n", + "fullbright:{}\nzoom:{}\nzoomKey:{}\nzoomLevel:{}\nzoomSmooth:{}\nzoomSensitivity:{}\nfps:{}\nfpsCorner:{}\nfpsLows:{}\nkeystrokes:{}\nkeystrokesCorner:{}\nkeystrokesCps:{}\nminimap:{}\nminimapCorner:{}\nminimapSize:{}\nminimapShape:{}\nminimapZoom:{}\nminimapRotate:{}\nautoReconnect:{}\nmouseTweaks:{}\nmouseTweaksWheel:{}\nsort:{}\nsortKey:{}\n", + bool_text(self.fullbright), bool_text(self.zoom), self.zoom_key, self.zoom_level, @@ -418,6 +422,7 @@ impl Cps { /// The settings the Extras page shows, one per row. #[derive(Clone, Copy, Debug, PartialEq, Eq)] pub enum Item { + Fullbright, Zoom, ZoomKey, ZoomLevel, @@ -445,6 +450,8 @@ pub enum Item { pub fn rows() -> Vec> { use Item::*; vec![ + Err("Lighting"), + Ok(Fullbright), Err("Zoom"), Ok(Zoom), Ok(ZoomKey), @@ -493,6 +500,7 @@ fn next(all: &[T], current: T, back: bool) -> T { impl Item { pub fn caption(self) -> &'static str { match self { + Item::Fullbright => "Fullbright", Item::Zoom => "Zoom", Item::ZoomKey => "Zoom key", Item::ZoomLevel => "Starting zoom", @@ -518,6 +526,7 @@ impl Item { /// What the row says under its caption. pub fn description(self) -> &'static str { match self { + Item::Fullbright => "Show blocks and entities at full light, even in dark areas.", Item::Zoom => "Hold the zoom key to zoom; the wheel changes it while held.", Item::ZoomKey => "Click, then press a key. Escape unbinds it.", Item::ZoomLevel => "The zoom the key starts at.", @@ -556,7 +565,7 @@ impl Item { pub fn cost(self) -> Option { use crate::graphics_style::Cost; match self { - Item::Zoom | Item::Fps | Item::Keystrokes => Some(Cost::None), + Item::Fullbright | Item::Zoom | Item::Fps | Item::Keystrokes => Some(Cost::None), Item::Minimap => Some(Cost::Low), Item::AutoReconnect | Item::MouseTweaks | Item::Sort => Some(Cost::None), _ => None, @@ -565,6 +574,7 @@ impl Item { /// On/off items and their value. pub fn switch(self, e: &Extras) -> Option { Some(match self { + Item::Fullbright => e.fullbright, Item::Zoom => e.zoom, Item::ZoomSmooth => e.zoom_smooth, Item::ZoomSensitivity => e.zoom_sensitivity, @@ -606,6 +616,7 @@ impl Item { /// A click (`back` for the right button). The zoom key binds instead. pub fn cycle(self, e: &mut Extras, back: bool) { match self { + Item::Fullbright => e.fullbright = !e.fullbright, Item::Zoom => e.zoom = !e.zoom, Item::ZoomSmooth => e.zoom_smooth = !e.zoom_smooth, Item::ZoomSensitivity => e.zoom_sensitivity = !e.zoom_sensitivity, @@ -651,11 +662,14 @@ mod tests { #[test] fn everything_is_off_by_default_and_round_trips() { let d = Extras::default(); + assert!(!d.fullbright); assert!(!d.zoom && !d.fps && !d.keystrokes && !d.minimap && !d.auto_reconnect); assert!(!d.mouse_tweaks && !d.sort); assert_eq!(Extras::parse(""), d); assert_eq!(Extras::parse(&d.serialize()), d); let mut e = d.clone(); + Item::Fullbright.cycle(&mut e, false); + assert_eq!(Item::Fullbright.switch(&e), Some(true)); e.zoom = true; e.zoom_key = "key.keyboard.c".into(); e.zoom_level = 6; diff --git a/crates/horizon-client/src/game/options.rs b/crates/horizon-client/src/game/options.rs index dcc7bb23b..86a2f789e 100644 --- a/crates/horizon-client/src/game/options.rs +++ b/crates/horizon-client/src/game/options.rs @@ -244,6 +244,7 @@ impl Game<'_> { let s = &self.settings; if let Some(r) = self.renderer.as_mut() { r.gamma = s.gamma; + r.fullbright = s.extras.fullbright; r.set_present_mode(s.vsync, s.horizon.present_mode); r.animated_textures = s.horizon.animated_textures; r.set_mipmap_levels(s.mipmap_levels.max(0) as u32); diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 4401ea22d..26f596185 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -348,6 +348,8 @@ pub struct Renderer { pub screenshot_result: Option>, /// Brightness option (lightmap gamma), 0..1. pub gamma: f32, + /// Optional full-light lightmap (Horizon Extras). + pub fullbright: bool, /// Advance animated block textures (Horizon setting; vanilla always does). pub animated_textures: bool, present_modes: Vec, @@ -1616,6 +1618,7 @@ impl Renderer { screenshot: None, screenshot_result: None, gamma: 0.5, + fullbright: false, animated_textures: true, present_modes, }) @@ -1972,6 +1975,9 @@ impl Renderer { pixels[i + 3] = 255; } } + if self.fullbright { + pixels.fill(255); + } // The lightmap changes with the time of day, flicker and effects, // not every frame: upload only what differs from the texture. if pixels == self.lightmap_pixels && self.lightmap_uploaded { diff --git a/docs/extras.md b/docs/extras.md index 4129a88eb..3c952d5ac 100644 --- a/docs/extras.md +++ b/docs/extras.md @@ -1,6 +1,6 @@ # Horizon extras -Optional conveniences built into the client: zoom, a minimap, an FPS counter, a +Optional conveniences built into the client: fullbright, zoom, a minimap, an FPS counter, a keystroke overlay, auto-reconnect, Mouse Tweaks-style inventory controls and inventory sorting. **Every one is off by default**: a fresh install looks and behaves exactly like vanilla 26.3, and turning an extra off @@ -36,6 +36,11 @@ Horizon category in Controls, and adding one would put a non-vanilla mapping int ## The extras +### Fullbright (`fullbright`, default off) +- Displays blocks and entities with a fully bright lightmap, including in dark caves. +- Turning it off restores the normal lightmap using the current brightness, + time of day and effects. The brightness slider keeps its normal range. + ### Zoom (`zoom`, default off) - Hold the zoom key (default **Z**, unused by every vanilla 26.3 key mapping; C is `key.saveToolbarActivator`) to zoom. The key does nothing while zoom is off. From d98ee9a7603f9220239cbcb059664311e12526c3 Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 21:44:57 -0400 Subject: [PATCH 44/59] Route mouse-bound hotbar keys through container swaps --- crates/horizon-client/src/game.rs | 12 +++++++ crates/horizon-client/src/keybinds.rs | 49 +++++++++++++++++++++++++++ 2 files changed, 61 insertions(+) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 5ffcd9124..3d17c0f74 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -9363,6 +9363,18 @@ impl ApplicationHandler for Game<'_> { } WindowEvent::MouseInput { state, button, .. } => { let pressed = state == ElementState::Pressed; + if matches!(self.screen, Screen::Inventory | Screen::Creative) + && let Some(key) = self + .settings + .keys + .container_mouse_key(button, self.creative) + { + if pressed && self.carried.is_none() { + self.inventory_hotkey(key); + } + // Neither edge of a bound button is an ordinary slot click. + return Ok(()); + } match self.screen { Screen::Playing => { if pressed && !self.captured { diff --git a/crates/horizon-client/src/keybinds.rs b/crates/horizon-client/src/keybinds.rs index 155ffcc24..5f8c0876b 100644 --- a/crates/horizon-client/src/keybinds.rs +++ b/crates/horizon-client/src/keybinds.rs @@ -373,11 +373,60 @@ impl KeyBinds { } Some(Err(button)) } + /// `AbstractContainerScreen.checkHotbarMouseClicked`: off hand, then hotbar. + pub fn container_mouse_key(&self, button: MouseButton, creative: bool) -> Option { + let name = mouse_name(button); + if matches!(button, MouseButton::Left | MouseButton::Right) + || (creative && self.get("key.pickItem") == name) + { + return None; + } + std::iter::once("key.swapOffhand") + .chain( + MAPPINGS + .iter() + .map(|m| m.0) + .filter(|n| n.starts_with("key.hotbar.")), + ) + .find(|mapping| self.get(mapping) == name) + .and_then(|mapping| key_code(Self::default_of(mapping))) + } } #[cfg(test)] mod tests { use super::*; + #[test] + fn container_mouse_hotkeys_follow_slot_bindings_and_pick_item_priority() { + for button in [MouseButton::Back, MouseButton::Forward, MouseButton::Middle] { + for (mapping, default, _) in MAPPINGS.iter().filter(|m| m.0.starts_with("key.hotbar.")) + { + let mut keys = KeyBinds::default(); + keys.set(mapping, &mouse_name(button)); + assert_eq!(keys.container_mouse_key(button, false), key_code(default)); + assert_eq!( + keys.container_mouse_key(button, true), + if button == MouseButton::Middle { + None + } else { + key_code(default) + } + ); + } + } + let mut keys = KeyBinds::default(); + keys.set("key.hotbar.1", "key.mouse.4"); + keys.set("key.swapOffhand", "key.mouse.4"); + assert_eq!( + keys.container_mouse_key(MouseButton::Back, false), + Some(KeyCode::KeyF) + ); + keys.set("key.hotbar.2", "key.mouse.left"); + assert_eq!(keys.container_mouse_key(MouseButton::Left, false), None); + assert_eq!(keys.container_mouse_key(MouseButton::Right, false), None); + assert_eq!(keys.container_mouse_key(MouseButton::Forward, false), None); + } + #[test] fn rebinding_translates_to_defaults() { let mut k = KeyBinds::default(); From cf7ed868b90cdd64c7434708ca8a9d9fa5585644 Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 21:46:47 -0400 Subject: [PATCH 45/59] Light redstone ore when mining begins --- crates/horizon-client/src/game.rs | 7 +++++++ crates/horizon-client/src/game/hand.rs | 5 ++++- crates/horizon-world/src/level/interact.rs | 16 ++++++++++++++++ crates/horizon-world/src/level/tests.rs | 21 +++++++++++++++++++++ 4 files changed, 48 insertions(+), 1 deletion(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 5ffcd9124..cc17dc64a 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -1777,6 +1777,12 @@ impl Game<'_> { }); self.process_level_events() } + fn attack_block(&mut self, pos: [i32; 3]) -> Result<()> { + self.with_level(|b, level, ticks| { + b.attack_block(level, ticks, BlockPos::new(pos[0], pos[1], pos[2])); + }); + self.process_level_events() + } /// Track which chunks are ticking (Ticks needs chunk load/unload). fn sync_tick_chunks(&mut self) { if !self.tick_chunks.synchronize(&self.world.chunks) { @@ -2885,6 +2891,7 @@ impl Game<'_> { return Ok(()); } if self.mining.as_ref().is_none_or(|m| m.pos != hit.pos) { + self.attack_block(hit.pos)?; self.mining = Some(Mining { pos: hit.pos, progress: 0.0, diff --git a/crates/horizon-client/src/game/hand.rs b/crates/horizon-client/src/game/hand.rs index 431e6661a..a932913af 100644 --- a/crates/horizon-client/src/game/hand.rs +++ b/crates/horizon-client/src/game/hand.rs @@ -409,7 +409,10 @@ impl HandWorld for GameHands<'_, '_> { fn within_border(&mut self, _: [i32; 3]) -> bool { true } - fn attack_block(&mut self, _: [i32; 3]) {} + fn attack_block(&mut self, pos: [i32; 3]) { + let result = self.game.attack_block(pos); + self.keep(result); + } fn destroy_progress(&mut self, pos: [i32; 3]) -> f32 { self.game.destroy_progress(pos) } diff --git a/crates/horizon-world/src/level/interact.rs b/crates/horizon-world/src/level/interact.rs index 791daf7c2..c38d81f26 100644 --- a/crates/horizon-world/src/level/interact.rs +++ b/crates/horizon-world/src/level/interact.rs @@ -513,6 +513,22 @@ impl Behaviours { sim.game_event_state(pos, "minecraft:block_change", next); } + /// The state change of `RedStoneOreBlock.attack` when mining begins. + pub fn attack_block( + &self, + level: &mut L, + ticks: &mut Ticks, + pos: BlockPos, + ) { + let mut sim = self.sim(level, ticks); + let state = sim.state(pos); + if self.data(state).chain.contains(&Class::RedStoneOre) + && !self.table.bool(state, self.props.lit) + { + sim.set_block_and_update(pos, self.table.set_bool(state, self.props.lit, true)); + } + } + /// `BlockState.useWithoutItem` for a right-click on `pos` (hit face and /// absolute hit location as in `BlockHitResult`). pub fn use_without_item( diff --git a/crates/horizon-world/src/level/tests.rs b/crates/horizon-world/src/level/tests.rs index 270ee48fa..c0ceddc6f 100644 --- a/crates/horizon-world/src/level/tests.rs +++ b/crates/horizon-world/src/level/tests.rs @@ -634,6 +634,27 @@ impl World<'_> { } } +#[test] +fn mining_lights_redstone_ore_until_its_random_tick() { + let mut w = world!(); + let pos = BlockPos::new(0, 1, 0); + for ore in ["redstone_ore", "deepslate_redstone_ore"] { + let unlit = w.id(ore, &[("lit", "false")]); + let lit = w.id(ore, &[("lit", "true")]); + w.put(pos, unlit); + w.b().attack_block(&mut w.level, &mut w.ticks, pos); + assert_eq!(w.get(pos), lit); + w.b().attack_block(&mut w.level, &mut w.ticks, pos); + assert_eq!(w.get(pos), lit); + w.b().random_tick(&mut w.level, &mut w.ticks, pos); + assert_eq!(w.get(pos), unlit); + } + let stone = w.id("stone", &[]); + w.put(pos, stone); + w.b().attack_block(&mut w.level, &mut w.ticks, pos); + assert_eq!(w.get(pos), stone); +} + #[test] fn placement_orients_blocks() { let mut w = world!(); From 6d8b1742167d79e619aa3abe34367c377072f4e6 Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 22:03:57 -0400 Subject: [PATCH 46/59] Depth-test inventory preview equipment and clip it with a scissor --- crates/horizon-client/src/game/perspective.rs | 51 +++++- crates/horizon-client/src/gfx.rs | 1 + crates/horizon-client/src/hud.rs | 166 +++++++++++++++--- crates/horizon-client/src/hud.wgsl | 4 +- crates/horizon-client/src/ui_theme.rs | 1 + 5 files changed, 194 insertions(+), 29 deletions(-) diff --git a/crates/horizon-client/src/game/perspective.rs b/crates/horizon-client/src/game/perspective.rs index e09d06244..bb463547f 100644 --- a/crates/horizon-client/src/game/perspective.rs +++ b/crates/horizon-client/src/game/perspective.rs @@ -427,7 +427,7 @@ impl Game<'_> { } /// `extractEntityInInventoryFollowsMouse`: the player in the box /// `[x0, x1) x [y0, y1)`, `size` pixels per block, turned toward the - /// cursor; drawn as depth-sorted, back-face-culled quads. + /// cursor; drawn with a depth buffer and back-face culling. #[allow(clippy::too_many_arguments)] pub(super) fn draw_player_preview( &self, @@ -495,9 +495,9 @@ impl Game<'_> { let quads = player_preview_quads(verts, gui, fire, &atlas.sprites); let start = batch.vertices.len(); for (_, p, uv, color) in quads { - batch.quad(p, uv, color); + batch.quad_3d(p, uv, color); } - batch.clip_since(start, x0, y0, x1, y1); + batch.depth_since(start, [x0, y0, x1, y1]); } /// The survival inventory's player box (`InventoryScreen`). pub(super) fn draw_inventory_player(&self, batch: &mut HudBatch, ox: f32, oy: f32) { @@ -570,7 +570,7 @@ fn player_preview_quads( gui: glam::Mat4, fire: Option<(f32, f32)>, sprites: &std::collections::HashMap, -) -> Vec<(f32, [[f32; 2]; 4], [[f32; 2]; 4], u32)> { +) -> Vec<(f32, [[f32; 3]; 4], [[f32; 2]; 4], u32)> { let flame_start = verts.len(); if let Some((width, height)) = fire { horizon_client::fire_render::flames( @@ -584,7 +584,7 @@ fn player_preview_quads( &mut verts, ); } - let mut quads: Vec<(f32, [[f32; 2]; 4], [[f32; 2]; 4], u32)> = Vec::new(); + let mut quads: Vec<(f32, [[f32; 3]; 4], [[f32; 2]; 4], u32)> = Vec::new(); for (index, q) in verts.as_chunks::<4>().0.iter().enumerate() { let p: [glam::Vec3; 4] = std::array::from_fn(|i| gui.transform_point3(glam::Vec3::from_array(q[i].pos))); @@ -606,12 +606,12 @@ fn player_preview_quads( let depth = p.iter().map(|v| v.z).sum::() / 4.0; quads.push(( depth, - p.map(|v| [v.x, v.y]), + p.map(|v| v.to_array()), std::array::from_fn(|i| q[i].uv), color, )); } - // Far (low z) first: the viewer is on the +z side. + // Keep far-to-near order for translucent faces; opaque overlap uses depth. quads.sort_by(|a, b| a.0.total_cmp(&b.0)); quads } @@ -619,6 +619,43 @@ fn player_preview_quads( #[cfg(test)] mod preview_tests { use super::*; + #[test] + fn preview_keeps_crossing_faces_depth_and_clips_without_dropping_faces() { + use horizon_client::{ + hud::{Blend, HudBatch}, + mesher::Vertex, + }; + let face = |z: [f32; 4]| { + [[-2.0, -1.0], [-2.0, 1.0], [2.0, 1.0], [2.0, -1.0]] + .into_iter() + .zip(z) + .map(|([x, y], z)| Vertex { + pos: [x, y, z], + uv: [0.0; 2], + layer: 0, + color: u32::MAX, + light: 0, + normal: [0; 4], + }) + }; + // A shield and arm can intersect: neither average depth orders both ends. + let verts = face([1.0, 1.0, -1.0, -1.0]).chain(face([0.0; 4])).collect(); + let quads = player_preview_quads(verts, glam::Mat4::IDENTITY, None, &Default::default()); + assert_eq!(quads.len(), 2); + let mut batch = HudBatch::new([320, 240]); + for (_, p, uv, color) in quads { + batch.quad_3d(p, uv, color); + } + // Its centre is outside this scissor; the visible part must still be drawn. + batch.depth_since(0, [1.0, 0.0, 2.0, 1.0]); + assert_eq!(batch.vertices.len(), 12); + let shield = &batch.vertices[..6]; + let arm = &batch.vertices[6..]; + assert!(shield[0].depth < arm[0].depth); + assert!(shield[2].depth > arm[2].depth); + assert_eq!(batch.runs(), vec![(0..12, Blend::Depth([1, 0, 1, 1]))]); + } + #[test] #[ignore = "requires prepared model data in HORIZON_TEST_RESOURCES"] fn player_render_transform_uses_vanilla_avatar_scale() { diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 4401ea22d..0e1ccb920 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -2776,6 +2776,7 @@ impl Renderer { &mut self.uploads, &mut encoder, &view_target, + &self.depth, frame.hud, [self.config.width, self.config.height], ); diff --git a/crates/horizon-client/src/hud.rs b/crates/horizon-client/src/hud.rs index 77ba0e342..c5462eaee 100644 --- a/crates/horizon-client/src/hud.rs +++ b/crates/horizon-client/src/hud.rs @@ -319,6 +319,7 @@ pub struct HudVertex { pub pos: [f32; 2], pub uv: [f32; 2], pub color: u32, + pub depth: f32, } /// The GUI Scale option (0 = auto). pub static GUI_SCALE: std::sync::atomic::AtomicU32 = std::sync::atomic::AtomicU32::new(0); @@ -330,10 +331,10 @@ pub struct HudBatch { pub height: f32, /// Glyph pixels to upload into the atlas before drawing. pub patches: Vec, - /// Vertex ranges drawn with another blend than alpha blending, in order. + /// Vertex ranges with another blend or depth/scissor state, in order. pub blends: Vec<(std::ops::Range, Blend)>, } -/// How a run of HUD vertices blends with what is under it. +/// How a run of HUD vertices blends and tests depth. #[derive(Clone, Copy, PartialEq, Eq, Debug)] pub enum Blend { /// `BlendFunction.TRANSLUCENT`. @@ -342,6 +343,8 @@ pub enum Blend { Invert, /// `BlendFunction.ADDITIVE` (`RenderPipelines.GUI_TEXT_HIGHLIGHT`). Additive, + /// Alpha blending with an isolated depth buffer and a pixel scissor. + Depth([u32; 4]), } pub fn rgba(r: u8, g: u8, b: u8, a: u8) -> u32 { u32::from(a) << 24 | u32::from(b) << 16 | u32::from(g) << 8 | u32::from(r) @@ -430,9 +433,44 @@ impl HudBatch { pos: p[i], uv: uv[i], color, + depth: 0.0, }); } } + pub fn quad_3d(&mut self, p: [[f32; 3]; 4], uv: [[f32; 2]; 4], color: u32) { + for i in [0, 1, 2, 0, 2, 3] { + self.vertices.push(HudVertex { + pos: [p[i][0], p[i][1]], + uv: uv[i], + color, + depth: p[i][2], + }); + } + } + /// Keep per-vertex depth for an orthographic GUI model, with +z toward the viewer. + pub fn depth_since(&mut self, start: usize, clip: [f32; 4]) { + let vertices = &mut self.vertices[start..]; + if vertices.is_empty() { + return; + } + let min = vertices + .iter() + .map(|v| v.depth) + .fold(f32::INFINITY, f32::min); + let max = vertices + .iter() + .map(|v| v.depth) + .fold(f32::NEG_INFINITY, f32::max); + for v in vertices { + v.depth = (max - v.depth) / (max - min).max(f32::EPSILON); + } + let [x0, y0, x1, y1] = clip.map(|v| (v * self.scale).max(0.0) as u32); + // Separate previews clear depth independently, even if their scissors match. + self.blends.push(( + start as u32..self.vertices.len() as u32, + Blend::Depth([x0, y0, x1.saturating_sub(x0), y1.saturating_sub(y0)]), + )); + } pub fn rect_uv(&mut self, x: f32, y: f32, w: f32, h: f32, r: Rect, color: u32) { self.quad( [[x, y], [x + w, y], [x + w, y + h], [x, y + h]], @@ -569,6 +607,7 @@ impl HudBatch { pos: p[i], uv, color: c[i], + depth: 0.0, }); } } @@ -729,6 +768,7 @@ pub struct HudRenderer { /// `RenderPipelines.CROSSHAIR`. invert_pipeline: wgpu::RenderPipeline, additive_pipeline: wgpu::RenderPipeline, + depth_pipeline: wgpu::RenderPipeline, group: wgpu::BindGroup, uniform: wgpu::Buffer, buffer: wgpu::Buffer, @@ -808,8 +848,8 @@ impl HudRenderer { bind_group_layouts: &[Some(&layout)], ..Default::default() }); - let attributes = wgpu::vertex_attr_array![0=>Float32x2,1=>Float32x2,2=>Unorm8x4]; - let create = |label, blend, fragment_entry| { + let attributes = wgpu::vertex_attr_array![0=>Float32x2,1=>Float32x2,2=>Unorm8x4,3=>Float32]; + let create = |label, blend, fragment_entry, depth: bool| { device.create_render_pipeline(&wgpu::RenderPipelineDescriptor { label: Some(label), layout: Some(&pipeline_layout), @@ -824,7 +864,13 @@ impl HudRenderer { })], }, primitive: Default::default(), - depth_stencil: None, + depth_stencil: depth.then_some(wgpu::DepthStencilState { + format: wgpu::TextureFormat::Depth32Float, + depth_write_enabled: Some(true), + depth_compare: Some(wgpu::CompareFunction::LessEqual), + stencil: Default::default(), + bias: Default::default(), + }), multisample: Default::default(), fragment: Some(wgpu::FragmentState { module: &shader, @@ -840,7 +886,13 @@ impl HudRenderer { cache: None, }) }; - let pipeline = create("HUD", wgpu::BlendState::ALPHA_BLENDING, "fs_main"); + let pipeline = create("HUD", wgpu::BlendState::ALPHA_BLENDING, "fs_main", false); + let depth_pipeline = create( + "HUD model", + wgpu::BlendState::ALPHA_BLENDING, + "fs_main", + true, + ); // BlendFunction.INVERT: ONE_MINUS_DST_COLOR, ONE_MINUS_SRC_COLOR, // ONE, ZERO. let invert_pipeline = create( @@ -858,6 +910,7 @@ impl HudRenderer { }, }, "fs_crosshair", + false, ); // BlendFunction.ADDITIVE: ONE, ONE. let add = wgpu::BlendComponent { @@ -872,6 +925,7 @@ impl HudRenderer { alpha: add, }, "fs_main", + false, ); let capacity = 1 << 16; let buffer = device.create_buffer(&wgpu::BufferDescriptor { @@ -886,6 +940,7 @@ impl HudRenderer { pipeline, invert_pipeline, additive_pipeline, + depth_pipeline, group, uniform, buffer, @@ -935,6 +990,7 @@ impl HudRenderer { uploads: &mut crate::gfx::upload::Uploads, encoder: &mut wgpu::CommandEncoder, target: &wgpu::TextureView, + depth: &wgpu::TextureView, batch: &HudBatch, size: [u32; 2], ) { @@ -965,7 +1021,7 @@ impl HudRenderer { ); } } - if batch.vertices.is_empty() { + if batch.vertices.is_empty() || size.contains(&0) { return; } let count = batch.vertices.len() as u64; @@ -1001,20 +1057,55 @@ impl HudRenderer { store: wgpu::StoreOp::Store, }, })]; - let mut pass = encoder.begin_render_pass(&wgpu::RenderPassDescriptor { - label: Some("HUD"), - color_attachments: &attachments, - ..Default::default() - }); - pass.set_bind_group(0, &self.group, &[]); - pass.set_vertex_buffer(0, self.buffer.slice(..)); - for (range, blend) in batch.runs() { - pass.set_pipeline(match blend { - Blend::Alpha => &self.pipeline, - Blend::Invert => &self.invert_pipeline, - Blend::Additive => &self.additive_pipeline, + let runs = batch.runs(); + let mut at = 0; + while at < runs.len() { + let clip = match runs[at].1 { + Blend::Depth(clip) => Some(clip), + _ => None, + }; + let end = if clip.is_some() { + at + 1 + } else { + runs[at..] + .iter() + .position(|(_, b)| matches!(b, Blend::Depth(_))) + .map_or(runs.len(), |n| at + n) + }; + let mut pass = encoder.begin_render_pass(&wgpu::RenderPassDescriptor { + label: Some("HUD"), + color_attachments: &attachments, + depth_stencil_attachment: clip.map(|_| wgpu::RenderPassDepthStencilAttachment { + view: depth, + depth_ops: Some(wgpu::Operations { + load: wgpu::LoadOp::Clear(1.0), + store: wgpu::StoreOp::Discard, + }), + stencil_ops: None, + }), + ..Default::default() }); - pass.draw(range, 0..1); + pass.set_bind_group(0, &self.group, &[]); + pass.set_vertex_buffer(0, self.buffer.slice(..)); + if let Some([x, y, w, h]) = clip { + let (x, y) = (x.min(size[0]), y.min(size[1])); + let (w, h) = (w.min(size[0] - x), h.min(size[1] - y)); + if w == 0 || h == 0 { + at = end; + continue; + } + pass.set_scissor_rect(x, y, w, h); + } + for (range, blend) in &runs[at..end] { + pass.set_pipeline(match blend { + Blend::Alpha => &self.pipeline, + Blend::Invert => &self.invert_pipeline, + Blend::Additive => &self.additive_pipeline, + Blend::Depth(_) => &self.depth_pipeline, + }); + pass.draw(range.clone(), 0..1); + } + at = end; } } } @@ -1092,6 +1183,41 @@ mod tests { fs::remove_dir_all(root).unwrap(); } + #[test] + fn gui_models_keep_separate_depth_runs_between_overlay_draws() { + let mut batch = HudBatch::new([640, 480]); + batch.scale = 2.0; + let p = [ + [0.0, 0.0, 2.0], + [0.0, 1.0, 2.0], + [1.0, 1.0, 2.0], + [1.0, 0.0, 2.0], + ]; + let uv = [[0.0; 2]; 4]; + batch.quad([[0.0; 2]; 4], uv, u32::MAX); + for _ in 0..2 { + let start = batch.vertices.len(); + batch.quad_3d(p, uv, u32::MAX); + batch.depth_since(start, [1.0, 2.0, 4.0, 6.0]); + } + batch.quad([[0.0; 2]; 4], uv, u32::MAX); + assert_eq!( + batch.runs(), + vec![ + (0..6, Blend::Alpha), + (6..12, Blend::Depth([2, 4, 6, 8])), + (12..18, Blend::Depth([2, 4, 6, 8])), + (18..24, Blend::Alpha), + ] + ); + assert!( + batch + .vertices + .iter() + .all(|v| v.depth.is_finite() && (0.0..=1.0).contains(&v.depth)) + ); + } + #[test] fn hud_shader_validates_both_fragment_entries() { let module = naga::front::wgsl::parse_str(include_str!("hud.wgsl")).unwrap(); diff --git a/crates/horizon-client/src/hud.wgsl b/crates/horizon-client/src/hud.wgsl index 055bfc1f1..17d50d51a 100644 --- a/crates/horizon-client/src/hud.wgsl +++ b/crates/horizon-client/src/hud.wgsl @@ -7,10 +7,10 @@ struct Out { @location(0) uv: vec2, @location(1) color: vec4, } -@vertex fn vs_main(@location(0) pos: vec2, @location(1) uv: vec2, @location(2) color: vec4) -> Out { +@vertex fn vs_main(@location(0) pos: vec2, @location(1) uv: vec2, @location(2) color: vec4, @location(3) depth: f32) -> Out { let pixels = pos * hud.size.z; var out: Out; - out.clip = vec4(pixels.x / hud.size.x * 2.0 - 1.0, 1.0 - pixels.y / hud.size.y * 2.0, 0.0, 1.0); + out.clip = vec4(pixels.x / hud.size.x * 2.0 - 1.0, 1.0 - pixels.y / hud.size.y * 2.0, depth, 1.0); out.uv = uv; out.color = color; return out; diff --git a/crates/horizon-client/src/ui_theme.rs b/crates/horizon-client/src/ui_theme.rs index 1c41add9d..d5073bec9 100644 --- a/crates/horizon-client/src/ui_theme.rs +++ b/crates/horizon-client/src/ui_theme.rs @@ -690,6 +690,7 @@ impl<'a> Ui<'a> { pos: p[i], uv: [cu, cv], color: c[i], + depth: 0.0, }); } } From 0da61e660b3dc636e1583c5ebf687d54f9c6e923 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 04:08:08 +0200 Subject: [PATCH 47/59] CI parity: raise the per-harness timeout to 2400 s world_spawn now takes about 1480 s on a loaded Mac mini runner, just under the old 1500 s limit, so PRs failed on a timeout rather than a mismatch (#567, #514). Co-Authored-By: Claude Opus 5.5 --- .github/workflows/ci.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index bbb8b3b84..5d5e285c5 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -83,7 +83,7 @@ jobs: - name: The harnesses this change can affect env: PARITY_HOSTS: '' - run: python3 tools/parity.py --changed ${{ github.event.pull_request.base.sha }} --timeout 1500 + run: python3 tools/parity.py --changed ${{ github.event.pull_request.base.sha }} --timeout 2400 # world_spawn takes ~1480 s on a busy runner - name: Logs of the failed harnesses if: failure() uses: actions/upload-artifact@v4 From 40970589bef33063caff17618b2325646f978ba0 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 04:07:21 +0200 Subject: [PATCH 48/59] Wrap mixed translation arguments once, so vanilla clients can read /give component_nbt wrapped the numbers of a mixed list under the empty key, and the NBT writer then wrapped those wrappers again, as ListTag.wrapIfNeeded does. A vanilla client reading /give's reply ("Gave 1 [Raw Iron] to ...") unwrapped once, found a {"": 1} argument and dropped the connection. The list is now left to the writer. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/lan/data.rs | 46 +++++++++++++++++---------- 1 file changed, 30 insertions(+), 16 deletions(-) diff --git a/crates/horizon-client/src/lan/data.rs b/crates/horizon-client/src/lan/data.rs index 85c4894a9..8de0e53d3 100644 --- a/crates/horizon-client/src/lan/data.rs +++ b/crates/horizon-client/src/lan/data.rs @@ -109,24 +109,14 @@ pub fn json_to_nbt(v: &Value) -> Tag { } } -/// A component's JSON as NbtOps writes it: a list whose elements differ in -/// type (translation arguments mixing numbers and components) holds each -/// element that isn't a compound wrapped in one under the empty key. +/// A component's JSON as NbtOps writes it. A list whose elements differ in type +/// (translation arguments mixing numbers and components) stays one list: the NBT +/// writer wraps each element that isn't a compound under the empty key, as +/// `ListTag.wrapIfNeeded` does, so wrapping it here too would leave the client a +/// `{"": 1}` argument it cannot read. pub fn component_nbt(v: &Value) -> Tag { match v { - Value::Array(a) => { - let kind = |v: &Value| std::mem::discriminant(&json_to_nbt(v)); - let mixed = a.windows(2).any(|w| kind(&w[0]) != kind(&w[1])); - Tag::List( - a.iter() - .map(|e| match component_nbt(e) { - t @ Tag::Compound(_) => t, - t if mixed => Tag::compound([("", t)]), - t => t, - }) - .collect(), - ) - } + Value::Array(a) => Tag::List(a.iter().map(component_nbt).collect()), Value::Object(o) => Tag::compound(o.iter().map(|(k, v)| (k.as_str(), component_nbt(v)))), other => json_to_nbt(other), } @@ -313,3 +303,27 @@ mod tests { assert!(matches!(t.get("b"), Some(Tag::List(l)) if l.len() == 2)); } } + +#[cfg(test)] +mod component_tests { + use super::*; + use horizon_world::nbt::{Limits, read_network, write_network}; + + /// `/give`'s reply: a count, then components. On the wire each element is wrapped + /// once, and read back (ListTag.addAndUnwrap) it is the number again. + #[test] + fn mixed_translation_arguments_are_wrapped_once() { + let json = serde_json::json!({ + "translate": "commands.give.success.single", + "with": [1, {"text": "Raw Iron"}, {"text": "Tester"}], + }); + let tag = component_nbt(&json); + let Some(Tag::List(args)) = tag.get("with") else { + panic!("no arguments: {tag:?}"); + }; + assert_eq!(args[0], Tag::Int(1)); + // Read back as ListTag.addAndUnwrap does: a wrapper wrapped twice stays a compound. + let bytes = write_network(&tag, Limits::default()).unwrap(); + assert_eq!(read_network(&bytes, Limits::default()).unwrap().0, tag); + } +} From e7f7236c342f1bb3e160308f154590bf125f0495 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 03:28:28 +0200 Subject: [PATCH 49/59] Open furnaces, blast furnaces and smokers on a server Right-clicking a furnace as a guest did nothing: the host only handed chests, barrels, hoppers, dispensers and shulker boxes over. It now opens the furnace's own menu (minecraft:furnace, blast_furnace or smoker), runs the guest's clicks through the host's AbstractFurnaceMenu (fuel slot, take-only result, shift-clicks by recipe and fuel, a new input restarts cooking) and keeps the client's progress arrows in step with ContainerSetData. The dedicated server harness now opens a furnace and smelts an ore in it on both servers. Fixes #540 Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game/lan_actions.rs | 9 +++ .../horizon-client/src/game/lan_crafting.rs | 74 ++++++++++++++++++- crates/horizon-client/src/lan/containers.rs | 46 +++++++++++- crates/horizon-client/src/lan/menu.rs | 2 + .../parity/VanillaProtocolClient.java | 57 +++++++++++++- tools/test_dedicated_server_parity.py | 13 +++- 6 files changed, 193 insertions(+), 8 deletions(-) diff --git a/crates/horizon-client/src/game/lan_actions.rs b/crates/horizon-client/src/game/lan_actions.rs index e192ef088..82c6174ec 100644 --- a/crates/horizon-client/src/game/lan_actions.rs +++ b/crates/horizon-client/src/game/lan_actions.rs @@ -275,6 +275,14 @@ impl Game<'_> { "container.enderchest", Slots::Ender, ) + } else if let Some(BlockEntity::Furnace(f)) = self.world.block_entities.get(&pos) { + // AbstractFurnaceBlock.openContainer: FurnaceMenu, BlastFurnaceMenu, SmokerMenu. + let (menu, title) = match f.kind.recipe_type() { + "minecraft:blasting" => ("minecraft:blast_furnace", "container.blast_furnace"), + "minecraft:smoking" => ("minecraft:smoker", "container.smoker"), + _ => ("minecraft:furnace", "container.furnace"), + }; + (menu, title, 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 { @@ -475,6 +483,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::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 02db51586..9841fa879 100644 --- a/crates/horizon-client/src/game/lan_crafting.rs +++ b/crates/horizon-client/src/game/lan_crafting.rs @@ -6,8 +6,9 @@ //! closes (`AbstractContainerMenu.clearContainer`). use super::{Game, lan::LanHost}; use horizon_client::{ + containers::BlockEntity, items::ItemStack, - lan::guest::Guest, + lan::{guest::Guest, menu::Slots}, menu::{Env, Input, Kind, Menu}, }; use horizon_protocol::packets::play::{self, Clientbound as C}; @@ -20,6 +21,9 @@ pub(super) struct GuestCrafting { inventory: Option>, /// The open crafting table: its window, state id and menu. table: Option<(i32, i32, Box)>, + /// 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)>, } /// ServerboundContainerClickPacket's input. @@ -153,6 +157,74 @@ 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( + &mut self, + host: &mut LanHost, + conn: u32, + p: &play::ContainerClick, + ) -> bool { + let Some(gi) = host.hub.guests.iter().position(|g| g.conn == conn) else { + return false; + }; + let Some(pos) = host.hub.guests[gi] + .menu + .as_ref() + .filter(|m| p.container != 0 && m.window == p.container) + .and_then(|m| match m.slots { + Slots::Block(pos) => Some(pos), + _ => None, + }) + else { + return false; + }; + let Some(BlockEntity::Furnace(f)) = self.world.block_entities.get(&pos) else { + 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; + } + let mut menu = host + .play + .entry(conn) + .or_default() + .crafting + .furnace + .take() + .filter(|(window, _)| *window == p.container) + .map_or_else(|| Box::new(Menu::new(Kind::Furnace(recipe))), |(_, 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()); + } + let before: Vec<_> = (0..menu.slot_count()) + .map(|s| menu.slot(s).cloned()) + .collect(); + let _ = menu.click(env, i32::from(p.slot), i32::from(p.button), input(p.input)); + (0..menu.slot_count()) + .filter(|&s| menu.slot(s) != before[s].as_ref()) + .collect::>() + }); + 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(); + } + // AbstractFurnaceBlockEntity.setItem: only a new input restarts cooking. + 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); + true + } + /// The guest opened a crafting table (`CraftingTableBlock.getMenuProvider`). pub(super) fn lan_open_crafting(&mut self, host: &mut LanHost, conn: u32) { self.lan_crafting_closed(host, conn, None); diff --git a/crates/horizon-client/src/lan/containers.rs b/crates/horizon-client/src/lan/containers.rs index e9bfe7fbe..0fa47510a 100644 --- a/crates/horizon-client/src/lan/containers.rs +++ b/crates/horizon-client/src/lan/containers.rs @@ -4,7 +4,7 @@ use super::{ hub::Hub, menu::{self, Menu, Rules, Slots, View}, }; -use crate::{items::ItemStack, world::World}; +use crate::{containers::BlockEntity, items::ItemStack, world::World}; use horizon_protocol::{ item::Hashed, packets::play::{self, Clientbound as C}, @@ -175,6 +175,7 @@ impl Hub { state: 0, sent: Vec::new(), drag: None, + sent_data: Vec::new(), }); self.send_menu_content(i, items); } @@ -416,6 +417,47 @@ impl Hub { } } + /// AbstractContainerMenu.broadcastChanges' data slots: a furnace's + /// AbstractFurnaceBlockEntity.dataAccess (lit time left, lit total, cooking + /// timer, cooking total), each sent when it changes. + fn sync_container_data(&mut self, i: usize, world: &World) { + let g = &mut self.guests[i]; + let Some(m) = g.menu.as_mut() else { + return; + }; + 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, + ] + .map(|v| v as i16); + m.sent_data.resize(data.len(), i16::MIN); + let window = m.window; + let changed: Vec<(usize, i16)> = data + .iter() + .enumerate() + .filter(|&(k, v)| m.sent_data[k] != *v) + .map(|(k, &v)| (k, v)) + .collect(); + for &(k, value) in &changed { + m.sent_data[k] = value; + } + for (k, value) in changed { + g.send(&C::ContainerSetData(play::ContainerSetData { + container: window, + id: k as i16, + value, + })); + } + } + /// Slot changes of open containers (AbstractContainerMenu.broadcastChanges). pub fn sync_containers(&mut self, world: &World) { for i in 0..self.guests.len() { @@ -457,6 +499,8 @@ impl Hub { })); } } + // Then the data slots, as broadcastChanges does. + self.sync_container_data(i, world); } } } diff --git a/crates/horizon-client/src/lan/menu.rs b/crates/horizon-client/src/lan/menu.rs index a2e40bf3d..d37874bc8 100644 --- a/crates/horizon-client/src/lan/menu.rs +++ b/crates/horizon-client/src/lan/menu.rs @@ -28,6 +28,8 @@ pub struct Menu { pub sent: Vec>, /// An unfinished drag: (mode, slots). pub drag: Option<(u8, Vec)>, + /// The data slots the client was last sent (ContainerSetData), a furnace's progress. + pub sent_data: Vec, } /// Where the slots of a container menu live. 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 66a363dfe..bb438b735 100644 --- a/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaProtocolClient.java +++ b/mods/horizon/src/test/java/dev/horizonlab/parity/VanillaProtocolClient.java @@ -125,7 +125,10 @@ public final class VanillaProtocolClient { client.status(host, port); client.join(host, port, name); } catch (Exception e) { - client.lines.add("error " + client.state + " " + e); + // With its causes: a decoder error names the field it could not read there. + StringBuilder line = new StringBuilder("error " + client.state + " " + e); + for (Throwable c = e.getCause(); c != null; c = c.getCause()) line.append(" / caused by ").append(c); + client.lines.add(line.toString()); } finally { if (client.socket != null) client.socket.close(); } @@ -427,7 +430,7 @@ public final class VanillaProtocolClient { boolean loaded = false; PositionMoveRotation position = new PositionMoveRotation(Vec3.ZERO, Vec3.ZERO, 0, 0); long lastChunk = 0; - long deadline = System.currentTimeMillis() + 90_000; + long deadline = System.currentTimeMillis() + 150_000; int step = 0; long stepAt = 0; // The death the console deals and the respawn after it (PlayerList.respawn): from the @@ -440,6 +443,10 @@ public final class VanillaProtocolClient { String runType = null; int run = 0; PositionMoveRotation respawnAt = null; + // The furnace set beside the respawn point: its window and the menu's state id. + net.minecraft.core.BlockPos furnace = null; + int furnaceWindow = -1; + int furnaceState = 0; // The villager the server's console summoned beside the spawn. int villager = -1; net.minecraft.world.phys.Vec3 villagerAt = null; @@ -500,6 +507,18 @@ public final class VanillaProtocolClient { int pz = (int) Math.floor(position.position().z) >> 4; if (p.x() == px && p.z() == pz && !respawning) chunkParts(p); if (p.x() == px && p.z() == pz && respawnAt != null) respawnChunk = true; + } else if (packet instanceof net.minecraft.network.protocol.game.ClientboundContainerSetContentPacket p + && furnaceWindow > 0 && p.containerId() == furnaceWindow) { + furnaceState = p.stateId(); + record("play-furnace", "content " + p.items() + " carried " + p.carriedItem()); + } else if (packet instanceof net.minecraft.network.protocol.game.ClientboundContainerSetSlotPacket p + && furnaceWindow > 0 && p.getContainerId() == furnaceWindow) { + furnaceState = p.getStateId(); + record("play-furnace", "slot " + p.getSlot() + " " + p.getItem()); + } else if (packet instanceof net.minecraft.network.protocol.game.ClientboundContainerSetDataPacket p + && furnaceWindow > 0 && p.getContainerId() == furnaceWindow && (p.getId() == 1 || p.getId() == 3)) { + // Lit total and cooking total; the time left and the cooking timer follow the ticks. + record("play-furnace", "data " + p.getId() + " " + p.getValue()); } else if (packet instanceof net.minecraft.network.protocol.game.ClientboundEntityEventPacket p && step == 5 + REPLIES.length && (int) (byte) field(p, "eventId") == 28) { // Operator (level 4, as the console made it): it may run /kill on itself. @@ -524,6 +543,10 @@ public final class VanillaProtocolClient { && p.getType() == net.minecraft.world.entity.EntityTypes.VILLAGER) { villager = p.getId(); villagerAt = new net.minecraft.world.phys.Vec3(p.getX(), p.getY(), p.getZ()); + } else if (packet instanceof net.minecraft.network.protocol.game.ClientboundOpenScreenPacket p && step > 6 + REPLIES.length) { + furnaceWindow = p.getContainerId(); + record("play-furnace", "open " + net.minecraft.core.registries.BuiltInRegistries.MENU.getKey(p.getType()) + " " + + json(p.getTitle())); } else if (packet instanceof net.minecraft.network.protocol.game.ClientboundOpenScreenPacket p && step > 0) { record("play-trade", "open " + p.getContainerId() + " " + net.minecraft.core.registries.BuiltInRegistries.MENU.getKey(p.getType()) + " " @@ -614,6 +637,36 @@ public final class VanillaProtocolClient { if (runType != null) record("play-respawn", runLine(runType, run)); record("play-respawn", "level loaded at " + text(respawnAt.position())); send(new ServerboundPlayerLoadedPacket()); + // A furnace two blocks south, an ore and its fuel. + furnace = net.minecraft.core.BlockPos.containing(respawnAt.position()).south(2); + send(new ServerboundChatCommandPacket("setblock " + furnace.getX() + " " + furnace.getY() + " " + furnace.getZ() + + " minecraft:furnace")); + send(new ServerboundChatCommandPacket("give @s minecraft:raw_iron")); + send(new ServerboundChatCommandPacket("give @s minecraft:coal")); + step++; + stepAt = now; + } else if (step == 7 + REPLIES.length && now - stepAt > 1500) { + // Right-click it with an empty hand (AbstractFurnaceBlock.useWithoutItem). + send(new net.minecraft.network.protocol.game.ServerboundUseItemOnPacket(net.minecraft.world.InteractionHand.MAIN_HAND, + new net.minecraft.world.phys.BlockHitResult(net.minecraft.world.phys.Vec3.atCenterOf(furnace), + net.minecraft.core.Direction.NORTH, furnace, false), 1)); + step++; + stepAt = now; + } else if (step >= 8 + REPLIES.length && step <= 10 + REPLIES.length && furnaceWindow > 0 + && now - stepAt > (step == 10 + REPLIES.length ? 12_000 : 1500)) { + // Shift-click the ore (hotbar 0) into the input, the coal (hotbar 1) into the + // fuel slot, and the smelted ingot out of the result; nothing claimed, so the + // server sends every slot the click changed. + int slot = step == 8 + REPLIES.length ? 30 : step == 9 + REPLIES.length ? 31 : 2; + record("play-furnace", "quick move " + slot); + send(new net.minecraft.network.protocol.game.ServerboundContainerClickPacket(furnaceWindow, furnaceState, (short) slot, + (byte) 0, net.minecraft.world.inventory.ContainerInput.QUICK_MOVE, + new it.unimi.dsi.fastutil.ints.Int2ObjectOpenHashMap<>(), net.minecraft.network.HashedStack.EMPTY)); + step++; + stepAt = now; + } else if (step == 11 + REPLIES.length && now - stepAt > 1500) { + send(new net.minecraft.network.protocol.game.ServerboundContainerClosePacket(furnaceWindow)); + record("play-furnace", "closed"); return; } } diff --git a/tools/test_dedicated_server_parity.py b/tools/test_dedicated_server_parity.py index 5c55f7a18..c30abe4b0 100644 --- a/tools/test_dedicated_server_parity.py +++ b/tools/test_dedicated_server_parity.py @@ -12,7 +12,9 @@ chunks around the spawn (their bytes are compared: the world is loaded from the same files), chats, runs /list and commands that fail (`/random value 7..7`, `/random value x`, `/trigger nope`), trades, is made an operator by the console, runs /kill, respawns (as vanilla's LevelLoadTracker waits: until the "level -chunks load start" event and the chunk under the player) and leaves. The +chunks load start" event and the chunk under the player), sets a furnace +beside itself, gives itself raw iron and coal, opens the furnace, shift-clicks +the ore and the coal in and the ingot out, and leaves. The console then runs `list` and `say` and `stop`. Compared, all of them exactly: @@ -29,6 +31,8 @@ exactly: inventory (PlayerList.respawn; chat, chunk data, light and keep-alives left out, runs of a packet counted), then that the level loads where the player respawned (guests' death messages aren't Horizon's yet: left out); +- the furnace menu: its type and title, its contents, the slots each + shift-click changes and its lit and cooking totals; - the console lines about the player, the chat, `list`, `say` and `stop`; - the files the servers leave: server.properties (but the date line), eula.txt, ops.json, whitelist.json, banned-players.json, banned-ips.json. @@ -204,9 +208,10 @@ CONSOLE_LINE = re.compile(r'^\[\d\d:\d\d:\d\d\] \[([^\]]+)\]: (.*)$') KEPT = re.compile(r'Tester|\[Server\]|\[Not Secure\]|There are|Stopping|Saving|ThreadedAnvilChunkStorage|All dimensions|Unknown or incomplete') -# Guests' death messages and the op's command feedback broadcast to the console aren't -# Horizon's yet (the client's own transcript leaves the death message out as well). -NOT_YET = re.compile(r'Tester was killed|Killed Tester|^\[Tester: ') +# Guests' death messages, the op's command feedback broadcast to the console and guests' +# advancement announcements aren't Horizon's yet (the client's own transcript leaves the +# death message out as well). +NOT_YET = re.compile(r'Tester was killed|Killed Tester|System chat: \[Tester: |Tester has made the advancement') def console_lines(lines): From 5515cbab33d2fd3d64558ec269d10649a55f5d2f Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 22:34:01 -0400 Subject: [PATCH 50/59] Handle resource pack reload failures and reset menu atlas cache --- crates/horizon-client/src/game.rs | 32 +++++-- crates/horizon-client/src/game/options.rs | 1 + crates/horizon-client/src/game/packs.rs | 26 +++-- crates/horizon-client/src/options_ui.rs | 112 +++++++++++++++++++++- crates/horizon-client/src/packs.rs | 16 ++-- crates/horizon-client/src/packs/cache.rs | 49 ++++++---- crates/horizon-client/src/ui_theme.rs | 37 +++++++ 7 files changed, 233 insertions(+), 40 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 0454a0d69..728049172 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -7650,7 +7650,15 @@ impl Game<'_> { /// The renderer for the window, with the current block sprites, shared /// atlas and world border texture. fn new_renderer(&self, window: Arc) -> Result { - let assets = &self.pack.assets; + self.renderer_for(window, &self.pack, &self.atlas) + } + fn renderer_for( + &self, + window: Arc, + pack: &PackResources, + atlas: &HudAtlas, + ) -> Result { + let assets = &pack.assets; let mut renderer = pollster::block_on(Renderer::new( window, self.options.offscreen, @@ -7660,12 +7668,11 @@ impl Game<'_> { assets.texture_layers, &assets.sprite_mips, &assets.animations, - (&self.atlas.pixels, self.atlas.width, self.atlas.height), - (&self.pack.forcefield.2, self.pack.forcefield.0), - &self.pack.panorama, + (&atlas.pixels, atlas.width, atlas.height), + (&pack.forcefield.2, pack.forcefield.0), + &pack.panorama, ))?; - renderer.hud.fire_animations = self - .atlas + renderer.hud.fire_animations = atlas .fire_animations .iter() .map(|(rect, animation)| (*rect, animation.clone(), usize::MAX)) @@ -10136,7 +10143,13 @@ pub fn run() -> Result<()> { horizon_client::spans::enable(options.spikes.is_some()); let vanilla_root = options.resources.clone(); let early_settings = Settings::load(&std::env::current_dir()?.join("options.txt")); - options.resources = packs::startup_root(&vanilla_root, &early_settings.resource_packs); + let mut pack_error = None; + options.resources = packs::startup_root(&vanilla_root, &early_settings.resource_packs) + .unwrap_or_else(|e| { + log::warn!("Horizon: resource packs not applied: {e}"); + pack_error = Some(e.to_string()); + vanilla_root.clone() + }); options.resources = mods::content_root( &options.resources, &early_settings.mods.enabled, @@ -10148,6 +10161,7 @@ pub fn run() -> Result<()> { // with the game's own resources. Err(e) if options.resources != vanilla_root => { log::warn!("Horizon: resource packs failed to load ({e}); using the default resources"); + pack_error = Some(e.to_string()); options.resources = vanilla_root.clone(); Assets::load(&vanilla_root)? } @@ -10254,6 +10268,10 @@ pub fn run() -> Result<()> { } let mut game = Game::new(&resources, pack, atlas, 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); + game.ui.options.resource_error = Some(error); + } if game.options.benchmark.is_some() { // The same conditions on every machine: no VSync, no frame cap, no // pause or idle limit without focus. In memory only, never saved. diff --git a/crates/horizon-client/src/game/options.rs b/crates/horizon-client/src/game/options.rs index dcc7bb23b..da1017e8e 100644 --- a/crates/horizon-client/src/game/options.rs +++ b/crates/horizon-client/src/game/options.rs @@ -206,6 +206,7 @@ impl Game<'_> { self.apply_settings(); self.sync_mods(); } + Event::Close if self.ui.options.resource_error.is_some() => {} Event::Close => { self.settings.save(&Self::options_path()); self.screen = if std::mem::take(&mut self.options_to_world_options) { diff --git a/crates/horizon-client/src/game/packs.rs b/crates/horizon-client/src/game/packs.rs index 4a80bee48..8e068e59b 100644 --- a/crates/horizon-client/src/game/packs.rs +++ b/crates/horizon-client/src/game/packs.rs @@ -35,7 +35,7 @@ pub fn open_folder(dir: &Path) { } } /// The resource root to load from, given the vanilla root and the selection. -pub fn startup_root(vanilla: &Path, selected: &[String]) -> PathBuf { +pub fn startup_root(vanilla: &Path, selected: &[String]) -> std::io::Result { let all = packs::discover(vanilla, &packs_dir()); let enabled = packs::enabled(&all, selected); packs::resource_root(vanilla, &enabled, &cache_dir()) @@ -104,9 +104,18 @@ impl Game<'_> { if self.ui.vanilla_root.as_os_str().is_empty() { self.ui.vanilla_root = vanilla.clone(); } - let root = startup_root(&vanilla, &self.settings.resource_packs); - if let Err(e) = self.reload_resources(&root) { + let result = startup_root(&vanilla, &self.settings.resource_packs) + .map_err(Into::into) + .and_then(|root| self.reload_resources(&root)); + if let Err(e) = result { log::warn!("Horizon: resource reload failed: {e}"); + if self.screen != super::Screen::Options { + self.open_options_at( + self.title.is_some(), + horizon_client::options_ui::Page::Packs, + ); + } + self.ui.options.resource_error = Some(e.to_string()); } } fn reload_resources(&mut self, root: &Path) -> horizon_client::Result<()> { @@ -121,12 +130,18 @@ impl Game<'_> { self.pack.context.biomes.clone(), self.pack.context.light.clone(), )?; + let renderer = self + .window + .clone() + .map(|window| self.renderer_for(window, &pack, &atlas)) + .transpose()?; // Everything loaded: switch over. self.random_tick_sections.clear(); self.options.resources = root.to_path_buf(); let context = pack.context.clone(); self.pack = pack; self.atlas = atlas; + horizon_client::ui_theme::reset_atlas(); // Villager hats come from the pack's texture metadata (shared data, swapped in place). *self .res @@ -142,9 +157,8 @@ impl Game<'_> { self.pending_uploads.clear(); // New GPU textures: a renderer built from the reloaded resources; the // sections are uploaded again as they are meshed. - if let Some(window) = self.window.clone() { - self.renderer = None; - self.renderer = Some(self.new_renderer(window)?); + if let Some(renderer) = renderer { + self.renderer = Some(renderer); self.apply_ui_settings(); } self.ui.chat.rescale(&self.atlas); diff --git a/crates/horizon-client/src/options_ui.rs b/crates/horizon-client/src/options_ui.rs index 38be29576..86d1fca43 100644 --- a/crates/horizon-client/src/options_ui.rs +++ b/crates/horizon-client/src/options_ui.rs @@ -824,6 +824,8 @@ pub struct OptionsUi { pub pack_selection: Vec, /// The open pack screen, made at its first frame. pub pack_screen: Option, + /// A reload failure, dismissed before returning to the current page. + pub resource_error: Option, /// When the pack screen's search box took the focus (its cursor blink). pack_focus: Instant, pub in_world: bool, @@ -854,6 +856,7 @@ impl Default for OptionsUi { pack_infos: Vec::new(), pack_selection: Vec::new(), pack_screen: None, + resource_error: None, pack_focus: Instant::now(), in_world: false, center_language: false, @@ -1596,6 +1599,42 @@ impl OptionsUi { cursor: (f32, f32), ) { let (w, h) = (batch.width, batch.height); + if let Some(error) = &self.resource_error { + ui::menu_background(batch, atlas, 0.0, 0.0, w, h, self.in_world); + let title = tr("resourcePack.load_fail"); + batch.text_styled( + atlas, + &title, + ((w - atlas.font.width_text(&title)) / 2.0).floor(), + 30.0, + u32::MAX, + true, + ); + let lines = atlas.font.split(&Text::literal(error), (w - 50.0).max(1.0)); + let limit = ((h - 110.0) / 9.0).max(1.0) as usize; + for (i, line) in lines.iter().take(limit).enumerate() { + batch.text_styled( + atlas, + line, + ((w - atlas.font.width_text(line)) / 2.0).floor(), + 60.0 + i as f32 * 9.0, + u32::MAX, + true, + ); + } + ui::button( + batch, + atlas, + w / 2.0 - 100.0, + h - 28.0, + 200.0, + 20.0, + &tr("gui.done"), + true, + ui::hovered(cursor, w / 2.0 - 100.0, h - 28.0, 200.0, 20.0), + ); + return; + } if crate::ui_theme::horizon() && self.page() == Page::Main { self.draw_horizon(s, batch, atlas, cursor); return; @@ -1784,6 +1823,16 @@ impl OptionsUi { drag: bool, right: bool, ) -> Vec { + if self.resource_error.is_some() { + if !drag + && !right + && ui::hovered((x, y), size.0 / 2.0 - 100.0, size.1 - 28.0, 200.0, 20.0) + { + self.resource_error = None; + return vec![Event::ButtonClick]; + } + return Vec::new(); + } if crate::ui_theme::horizon() && self.page() == Page::Main { return self.click_horizon(s, atlas, x, y, framebuffer, drag, right); } @@ -2012,6 +2061,9 @@ impl OptionsUi { } /// The mouse wheel at the cursor. pub fn scroll_at(&mut self, s: &Settings, size: (f32, f32), cursor: (f32, f32), amount: f32) { + if self.resource_error.is_some() { + return; + } if crate::ui_theme::horizon() && self.page() == Page::Main { self.scroll_horizon(amount); return; @@ -2090,6 +2142,9 @@ impl OptionsUi { } /// Typed text (the language search box). pub fn type_text(&mut self, atlas: &HudAtlas, text: &str) { + if self.resource_error.is_some() { + return; + } if self.page() == Page::Packs && let Some(p) = &mut self.pack_screen { @@ -2109,7 +2164,7 @@ impl OptionsUi { shortcut: crate::clipboard::EditShortcut, clipboard: &mut dyn crate::clipboard::Clipboard, ) -> bool { - if self.selected_key.is_some() { + if self.resource_error.is_some() || self.selected_key.is_some() { return false; } if self.page() == Page::Packs @@ -2136,6 +2191,12 @@ impl OptionsUi { text: Option<&str>, ) -> Vec { use winit::keyboard::KeyCode as K; + if self.resource_error.is_some() { + if matches!(key, K::Escape | K::Enter | K::NumpadEnter) { + self.resource_error = None; + } + return Vec::new(); + } if self.page() == Page::Packs && let Some(p) = &mut self.pack_screen { @@ -2201,6 +2262,55 @@ mod tests { HudAtlas::build(std::path::Path::new("/nonexistent/horizon-test-assets")).unwrap() } + #[test] + fn resource_reload_error_blocks_options_until_dismissed() { + use winit::keyboard::KeyCode; + let atlas = atlas(); + let mut settings = Settings::default(); + let mut ui = OptionsUi { + resource_error: Some("broken pack".into()), + ..Default::default() + }; + let stack = ui.stack.clone(); + assert!( + ui.click( + &mut settings, + &atlas, + 10.0, + 10.0, + (480.0, 270.0), + [960, 540], + false, + false + ) + .is_empty() + ); + assert!(ui.resource_error.is_some()); + assert!( + ui.key(&mut settings, &atlas, KeyCode::KeyW, None) + .is_empty() + ); + assert!(ui.resource_error.is_some()); + ui.key(&mut settings, &atlas, KeyCode::Escape, None); + assert!(ui.resource_error.is_none()); + assert_eq!(ui.stack, stack); + ui.resource_error = Some("broken pack".into()); + assert_eq!( + ui.click( + &mut settings, + &atlas, + 240.0, + 250.0, + (480.0, 270.0), + [960, 540], + false, + false + ), + vec![Event::ButtonClick] + ); + assert!(ui.resource_error.is_none()); + } + #[test] fn option_tooltip_keys_follow_value_dependent_descriptions() { let mut s = Settings::default(); diff --git a/crates/horizon-client/src/packs.rs b/crates/horizon-client/src/packs.rs index 917bad561..4c3972291 100644 --- a/crates/horizon-client/src/packs.rs +++ b/crates/horizon-client/src/packs.rs @@ -369,7 +369,8 @@ fn pack_files(pack: &Pack) -> io::Result> { } #[cfg(unix)] fn link(target: &Path, at: &Path) -> io::Result<()> { - std::os::unix::fs::symlink(target, at) + // Relative sources are relative to the process, not the overlay directory. + std::os::unix::fs::symlink(std::path::absolute(target)?, at) } #[cfg(not(unix))] fn link(target: &Path, at: &Path) -> io::Result<()> { @@ -635,9 +636,9 @@ pub fn enabled(all: &[Pack], ids: &[String]) -> Vec { .collect() } /// Resource root for a pack selection: vanilla itself when no pack is on. -pub fn resource_root(vanilla: &Path, packs: &[Pack], cache: &Path) -> PathBuf { +pub fn resource_root(vanilla: &Path, packs: &[Pack], cache: &Path) -> io::Result { if packs.is_empty() { - return vanilla.to_path_buf(); + return Ok(vanilla.to_path_buf()); } let key: String = packs .iter() @@ -648,13 +649,8 @@ pub fn resource_root(vanilla: &Path, packs: &[Pack], cache: &Path) -> PathBuf { (h ^ u64::from(b)).wrapping_mul(0x100_0000_01b3) }); let out = cache.join(format!("{hash:016x}")); - match build_overlay(vanilla, packs, &out) { - Ok(()) => out, - Err(e) => { - log::warn!("Horizon: resource packs not applied: {e}"); - vanilla.to_path_buf() - } - } + build_overlay(vanilla, packs, &out)?; + Ok(out) } /// `Pack.Position`: where a pack goes when it is added to a list. diff --git a/crates/horizon-client/src/packs/cache.rs b/crates/horizon-client/src/packs/cache.rs index 1f17c018b..efcf01e4a 100644 --- a/crates/horizon-client/src/packs/cache.rs +++ b/crates/horizon-client/src/packs/cache.rs @@ -8,7 +8,7 @@ use std::io::Read; use std::{collections::BTreeSet, fs, io, path::Path, path::PathBuf}; // Bump when overlay/merge semantics change. Markers are disposable cache data. -const VERSION: u32 = 2; +const VERSION: u32 = 3; #[derive(Default, Serialize, Deserialize)] pub(super) struct Dependencies { @@ -275,7 +275,6 @@ pub(super) fn build(vanilla: &Path, packs: &[Pack], out: &Path) -> io::Result<() .truncate(false) .open(lock_path(out))?; lock.lock()?; - // Resolve marker identity only; preserve the builder's original link targets. let vanilla_key = absolute(vanilla)?; let marker_path = marker_path(out); let signature = pack_signature(packs); @@ -484,7 +483,9 @@ mod tests { // a cache tree changed outside the builder. packs::build_overlay(&f.0.join("vanilla"), std::slice::from_ref(&low), &out).unwrap(); assert_eq!(fs::read(out.join(resource)).unwrap(), b"corrupt"); - fs::remove_file(&marker).unwrap(); + let mut old: Marker = serde_json::from_slice(&fs::read(&marker).unwrap()).unwrap(); + old.version = VERSION - 1; + fs::write(&marker, serde_json::to_vec(&old).unwrap()).unwrap(); f.rebuild_matches(std::slice::from_ref(&low)); fs::remove_file(out.join(resource)).unwrap(); fs::remove_file(&marker).unwrap(); @@ -564,8 +565,14 @@ mod tests { f.write("pack.zip", &archive(&files(b"ddd"), true)); f.rebuild_matches(std::slice::from_ref(&pack)); fs::remove_file(f.0.join("pack.zip")).unwrap(); - assert!(packs::build_overlay(&f.0.join("vanilla"), &[pack], &out).is_err()); + assert!( + packs::build_overlay(&f.0.join("vanilla"), std::slice::from_ref(&pack), &out).is_err() + ); assert!(!marker_path(&out).exists()); + assert!( + packs::resource_root(&f.0.join("vanilla"), &[pack], &f.0.join("selection-cache")) + .is_err() + ); } #[cfg(unix)] @@ -758,7 +765,7 @@ mod tests { #[cfg(unix)] #[test] - fn relative_builder_targets_are_preserved() { + fn relative_sources_are_readable_through_cached_and_uncached_overlays() { let f = Fixture::new(); f.write("vanilla/facts.json", b"[]"); let mut pack = f.dir_pack("pack"); @@ -777,15 +784,21 @@ mod tests { let out = f.0.join("cached"); let reference = f.0.join("reference"); packs::build_overlay(&vanilla, std::slice::from_ref(&pack), &out).unwrap(); - build_overlay_uncached(&vanilla, &[pack], &reference, &mut Dependencies::default()) - .unwrap(); - let expected = relative.join("pack").join(name); - assert_eq!(fs::read_link(out.join(name)).unwrap(), expected); - assert_eq!(fs::read_link(reference.join(name)).unwrap(), expected); - assert_eq!( - fs::read_link(out.join("facts.json")).unwrap(), - vanilla.join("facts.json") - ); + build_overlay_uncached( + &vanilla, + std::slice::from_ref(&pack), + &reference, + &mut Dependencies::default(), + ) + .unwrap(); + for root in [&out, &reference] { + assert!(fs::read_link(root.join(name)).unwrap().is_absolute()); + assert_eq!(fs::read(root.join(name)).unwrap(), b"pack"); + assert_eq!(fs::read(root.join("facts.json")).unwrap(), b"[]"); + } + packs::build_overlay(&vanilla, &[pack], &out).unwrap(); + assert_eq!(fs::read(out.join(name)).unwrap(), b"pack"); + assert_eq!(fs::read(out.join("facts.json")).unwrap(), b"[]"); } #[test] @@ -827,14 +840,17 @@ mod tests { let cached_cache = f.0.join("cached"); fs::create_dir_all(&reference_cache).unwrap(); let reference = original(&vanilla, selected, &reference_cache); - let out = packs::resource_root(&vanilla, selected, &cached_cache); + let out = packs::resource_root(&vanilla, selected, &cached_cache).unwrap(); assert_ne!(out, vanilla, "resource_root must not fall back to vanilla"); assert!(marker_path(&out).exists()); let expected = output_signature(&reference).unwrap(); assert_eq!(output_signature(&out).unwrap(), expected); for _ in 0..2 { original(&vanilla, selected, &reference_cache); - assert_eq!(packs::resource_root(&vanilla, selected, &cached_cache), out); + assert_eq!( + packs::resource_root(&vanilla, selected, &cached_cache).unwrap(), + out + ); } let mut baseline = Vec::new(); let mut cold = Vec::new(); @@ -861,6 +877,7 @@ mod tests { black_box(selected), black_box(&cached_cache), ) + .unwrap() }; black_box(&result); let ms = started.elapsed().as_secs_f64() * 1000.0; diff --git a/crates/horizon-client/src/ui_theme.rs b/crates/horizon-client/src/ui_theme.rs index 1c41add9d..1d57e5ada 100644 --- a/crates/horizon-client/src/ui_theme.rs +++ b/crates/horizon-client/src/ui_theme.rs @@ -267,6 +267,10 @@ struct Cache { thread_local! { static CACHE: RefCell> = const { RefCell::new(None) }; } +/// Reloaded atlases can occupy the same address with empty run-time slots. +pub fn reset_atlas() { + CACHE.with(|cache| *cache.borrow_mut() = None); +} fn with_cache(atlas: &HudAtlas, f: impl FnOnce(&mut Cache) -> R) -> R { CACHE.with(|c| { let mut c = c.borrow_mut(); @@ -1366,3 +1370,36 @@ pub const fn id(name: &str, index: u64) -> u64 { } h ^ index.wrapping_mul(0x9e37_79b9_7f4a_7c15) } + +#[cfg(test)] +mod tests { + use super::*; + + #[test] + fn atlas_reload_regenerates_text_and_corners_at_the_same_address() { + let atlas = HudAtlas::build(Path::new("/nonexistent/horizon-test-assets")).unwrap(); + reset_atlas(); + let draw = |cache: &mut Cache| { + let glyph = cache.fonts.face(Face::Regular).glyph_id('A'); + assert!( + cache + .glyph(&atlas, Face::Regular, glyph, 16.0) + .rect + .is_some() + ); + assert!(cache.corner(&atlas, 8, false).is_some()); + std::mem::take(&mut cache.pending) + }; + let before = with_cache(&atlas, draw); + assert_eq!(before.len(), 2); + assert!(with_cache(&atlas, draw).is_empty()); + reset_atlas(); + let after = with_cache(&atlas, draw); + assert_eq!(after.len(), 2); + for (a, b) in before.iter().zip(&after) { + assert_eq!((a.x, a.y, a.width, a.height), (b.x, b.y, b.width, b.height)); + assert_eq!(a.rgba, b.rgba); + } + reset_atlas(); + } +} From e0d6e562810d882afd87c8800df63d8c28dcc9e0 Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 22:41:33 -0400 Subject: [PATCH 51/59] Release Wayland surface before replacing the pack renderer --- crates/horizon-client/src/game/packs.rs | 21 +++++++++++++++++++-- crates/horizon-client/src/gfx.rs | 20 +++++++++++++++++--- 2 files changed, 36 insertions(+), 5 deletions(-) diff --git a/crates/horizon-client/src/game/packs.rs b/crates/horizon-client/src/game/packs.rs index 8e068e59b..0b95dd2ad 100644 --- a/crates/horizon-client/src/game/packs.rs +++ b/crates/horizon-client/src/game/packs.rs @@ -130,11 +130,28 @@ impl Game<'_> { self.pack.context.biomes.clone(), self.pack.context.light.clone(), )?; - let renderer = self + // Keep the working GPU resources, but release its exclusive window surface. + if let Some(renderer) = &mut self.renderer { + renderer.release_surface(); + } + let renderer = match self .window .clone() .map(|window| self.renderer_for(window, &pack, &atlas)) - .transpose()?; + .transpose() + { + Ok(renderer) => renderer, + Err(error) => { + if let Some(renderer) = &mut self.renderer { + renderer.recreate_surface().map_err(|restore| { + format!( + "{error}; could not restore the previous rendering surface: {restore}" + ) + })?; + } + return Err(error); + } + }; // Everything loaded: switch over. self.random_tick_sections.clear(); self.options.resources = root.to_path_buf(); diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index f64200e5c..9fcc8ae39 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -1656,6 +1656,22 @@ impl Renderer { pub fn is_offscreen(&self) -> bool { self.surface.is_none() } + /// Release the window surface before another renderer uses the same window. + pub fn release_surface(&mut self) { + self.surface = None; + } + /// Reattach a window after surface loss or a failed renderer replacement. + pub fn recreate_surface(&mut self) -> Result<()> { + if self.offscreen.is_some() { + return Ok(()); + } + // Wayland allows only one tearing-control object per window surface. + self.release_surface(); + let surface = self.instance.create_surface(self.window.clone())?; + surface.configure(&self.device, &self.config); + self.surface = Some(surface); + Ok(()) + } fn depth(device: &wgpu::Device, config: &wgpu::SurfaceConfiguration) -> wgpu::TextureView { device .create_texture(&wgpu::TextureDescriptor { @@ -2039,9 +2055,7 @@ impl Renderer { return Ok(false); } Some(wgpu::CurrentSurfaceTexture::Lost) => { - let surface = self.instance.create_surface(self.window.clone())?; - surface.configure(&self.device, &self.config); - self.surface = Some(surface); + self.recreate_surface()?; return Ok(false); } Some(wgpu::CurrentSurfaceTexture::Validation) => { From 7575719d11257cd7b72e64b4e35f13d992f52927 Mon Sep 17 00:00:00 2001 From: Cosmic <84875247+Online5277@users.noreply.github.com> Date: Fri, 16 Oct 2026 22:46:47 -0400 Subject: [PATCH 52/59] Reuse the GPU device and presentation mode across pack reloads --- crates/horizon-client/src/game.rs | 1 + crates/horizon-client/src/gfx.rs | 69 ++++++++++++++++++++----------- 2 files changed, 46 insertions(+), 24 deletions(-) diff --git a/crates/horizon-client/src/game.rs b/crates/horizon-client/src/game.rs index 728049172..a579f44ff 100644 --- a/crates/horizon-client/src/game.rs +++ b/crates/horizon-client/src/game.rs @@ -7671,6 +7671,7 @@ impl Game<'_> { (&atlas.pixels, atlas.width, atlas.height), (&pack.forcefield.2, pack.forcefield.0), &pack.panorama, + self.renderer.as_ref(), ))?; renderer.hud.fire_animations = atlas .fire_animations diff --git a/crates/horizon-client/src/gfx.rs b/crates/horizon-client/src/gfx.rs index 9fcc8ae39..6c8a5272f 100644 --- a/crates/horizon-client/src/gfx.rs +++ b/crates/horizon-client/src/gfx.rs @@ -222,6 +222,7 @@ struct BorderUniform { } pub struct Renderer { instance: wgpu::Instance, + adapter: wgpu::Adapter, /// The window's swapchain; `None` when rendering offscreen (`--offscreen`). surface: Option>, /// The offscreen colour target, sized like `config`. @@ -454,8 +455,14 @@ impl Renderer { hud_atlas: (&[u8], u32, u32), forcefield: (&[u8], u32), panorama_faces: &panorama::Faces, + previous: Option<&Self>, ) -> Result { - let instance = wgpu::Instance::new(instance_descriptor()); + // Reload resources on the same device; replacing live Vulkan devices + // can invalidate the driver's swapchain state on the same window. + let instance = previous.map_or_else( + || wgpu::Instance::new(instance_descriptor()), + |renderer| renderer.instance.clone(), + ); // Offscreen rendering needs no surface, so it can use a GPU the // window's display cannot present from (a headless compositor). let surface = if offscreen { @@ -463,15 +470,18 @@ impl Renderer { } else { Some(instance.create_surface(window.clone())?) }; - let adapter = instance - .request_adapter(&wgpu::RequestAdapterOptions { - power_preference: wgpu::PowerPreference::HighPerformance, - compatible_surface: surface.as_ref(), - force_fallback_adapter: false, - ..Default::default() - }) - .await - .map_err(|e| format!("{NO_GPU_DRIVER} ({e})"))?; + let adapter = match previous { + Some(renderer) => renderer.adapter.clone(), + None => instance + .request_adapter(&wgpu::RequestAdapterOptions { + power_preference: wgpu::PowerPreference::HighPerformance, + compatible_surface: surface.as_ref(), + force_fallback_adapter: false, + ..Default::default() + }) + .await + .map_err(|e| format!("{NO_GPU_DRIVER} ({e})"))?, + }; let info = adapter.get_info(); log::info!( "Horizon renderer: {} ({:?}, {:?})", @@ -501,15 +511,20 @@ impl Renderer { ) .into()); } - let (device, queue) = adapter - .request_device(&wgpu::DeviceDescriptor { - label: Some("Horizon device"), - required_features: timing::GpuTimer::features(&adapter) - | (adapter.features() & wgpu::Features::INDIRECT_FIRST_INSTANCE), - required_limits: limits.clone(), - ..Default::default() - }) - .await?; + let (device, queue) = match previous { + Some(renderer) => (renderer.device.clone(), renderer.queue.clone()), + None => { + adapter + .request_device(&wgpu::DeviceDescriptor { + label: Some("Horizon device"), + required_features: timing::GpuTimer::features(&adapter) + | (adapter.features() & wgpu::Features::INDIRECT_FIRST_INSTANCE), + required_limits: limits.clone(), + ..Default::default() + }) + .await? + } + }; let size = window.inner_size(); let (config, present_modes) = if let Some(surface) = &surface { let mut config = surface @@ -528,11 +543,16 @@ impl Renderer { if caps.usages.contains(wgpu::TextureUsages::COPY_SRC) { config.usage |= wgpu::TextureUsages::COPY_SRC; } - config.present_mode = if caps.present_modes.contains(&wgpu::PresentMode::Mailbox) { - wgpu::PresentMode::Mailbox - } else { - wgpu::PresentMode::Fifo - }; + config.present_mode = previous + .map(|renderer| renderer.config.present_mode) + .filter(|mode| caps.present_modes.contains(mode)) + .unwrap_or_else(|| { + if caps.present_modes.contains(&wgpu::PresentMode::Mailbox) { + wgpu::PresentMode::Mailbox + } else { + wgpu::PresentMode::Fifo + } + }); surface.configure(&device, &config); (config, caps.present_modes.clone()) } else { @@ -1523,6 +1543,7 @@ impl Renderer { ); Ok(Self { instance, + adapter, surface, offscreen, in_flight: std::collections::VecDeque::new(), From 5118d824a688a8ae3e4fb0ee25406b65f57aef5b Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 04:47:35 +0200 Subject: [PATCH 53/59] LAN hub: hand a tick's packets to each connection together Every packet sent to a guest woke its writer thread, and at 25 walking bots those wake-ups (mpsc notify, semaphore_signal) were about a quarter of the server thread's tick. While tick_lan runs, packets for each guest are held and handed over in one Out::Packets at the end; a send outside a tick, or a disconnect, first hands over what is held, so the bytes and their order are unchanged. Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/game/lan.rs | 6 ++ crates/horizon-client/src/game/scoreboard.rs | 5 +- crates/horizon-client/src/lan/conn.rs | 108 +++++++++++++++++-- crates/horizon-client/src/lan/hub.rs | 4 +- crates/horizon-client/src/lan/mod.rs | 4 +- 5 files changed, 111 insertions(+), 16 deletions(-) diff --git a/crates/horizon-client/src/game/lan.rs b/crates/horizon-client/src/game/lan.rs index 1d00134e4..f6fc1e860 100644 --- a/crates/horizon-client/src/game/lan.rs +++ b/crates/horizon-client/src/game/lan.rs @@ -684,6 +684,8 @@ impl Game<'_> { let Some(mut host) = self.lan.take() else { return; }; + // What the tick sends a guest goes to its connection at the end. + let holding = lan::Holding::start(); let state = self.lan_host_state(&host); // A dedicated server runs the hub without a host player. if state.is_some() || host.hub.config.dedicated { @@ -783,6 +785,10 @@ impl Game<'_> { self.lan_swings(&mut host); self.lan_update_streaming(&host); self.lan_update_models(&mut host); + drop(holding); + for g in &host.hub.guests { + g.sender.flush(); + } self.lan = Some(host); } diff --git a/crates/horizon-client/src/game/scoreboard.rs b/crates/horizon-client/src/game/scoreboard.rs index 16297e930..ff1f602a4 100644 --- a/crates/horizon-client/src/game/scoreboard.rs +++ b/crates/horizon-client/src/game/scoreboard.rs @@ -737,10 +737,7 @@ mod tab_list_tests { name: name.into(), info: ClientInformation::new(8), brand: "test".into(), - sender: PlayerSender { - tx, - pending: Arc::default(), - }, + sender: PlayerSender::new(tx, Arc::default()), latency: Arc::new(AtomicI32::new(42)), address: "127.0.0.1:25565".parse().unwrap(), }, diff --git a/crates/horizon-client/src/lan/conn.rs b/crates/horizon-client/src/lan/conn.rs index a1ffac4fa..fa31f2275 100644 --- a/crates/horizon-client/src/lan/conn.rs +++ b/crates/horizon-client/src/lan/conn.rs @@ -21,9 +21,10 @@ use horizon_protocol::{ text::translatable, }; use std::{ + cell::Cell, net::TcpStream, sync::{ - Arc, + Arc, Mutex, PoisonError, atomic::{AtomicI32, AtomicI64, AtomicUsize, Ordering}, mpsc::{Receiver, RecvTimeoutError, Sender, channel}, }, @@ -122,16 +123,64 @@ pub fn valid_name(name: &str) -> bool { (1..=16).contains(&name.len()) && name.chars().all(|c| c as u32 > 32 && (c as u32) < 127) } +thread_local! { + static HOLDING: Cell = const { Cell::new(false) }; +} + +/// While one is alive, the packets this thread sends to each player are held +/// and handed to the player's writer thread together by +/// [`PlayerSender::flush`]: one wake-up per player per tick rather than one +/// per packet. The bytes and their order don't change. +pub struct Holding(bool); +impl Holding { + pub fn start() -> Self { + Self(HOLDING.replace(true)) + } +} +impl Drop for Holding { + fn drop(&mut self) { + HOLDING.set(self.0); + } +} + /// The sending half given to the game thread. #[derive(Clone)] pub struct PlayerSender { pub tx: Sender, pub pending: Arc, + held: Arc>>>, } impl PlayerSender { + pub fn new(tx: Sender, pending: Arc) -> Self { + Self { + tx, + pending, + held: Arc::default(), + } + } + fn held(&self) -> std::sync::MutexGuard<'_, Vec>> { + self.held.lock().unwrap_or_else(PoisonError::into_inner) + } pub fn send(&self, body: Vec) { self.pending.fetch_add(body.len(), Ordering::Relaxed); - let _ = self.tx.send(Out::Packet(body)); + if HOLDING.get() { + self.held().push(body); + } else { + self.flush(); + let _ = self.tx.send(Out::Packet(body)); + } + } + /// Hand the held packets to the writer thread. + pub fn flush(&self) { + let held = std::mem::take(&mut *self.held()); + if !held.is_empty() { + let _ = self.tx.send(Out::Packets(held)); + } + } + /// Send a play disconnect with this reason after what was sent before. + pub fn disconnect(&self, reason: horizon_world::nbt::Tag) { + self.flush(); + let _ = self.tx.send(Out::Disconnect(reason)); } } @@ -466,10 +515,7 @@ fn play(c: Connection, shared: &Arc, parts: Parts, address: std::net::So let pending = Arc::new(AtomicUsize::new(0)); let latency = Arc::new(AtomicI32::new(0)); let alive = Arc::new(AtomicI64::new(-1)); - let sender = PlayerSender { - tx: tx.clone(), - pending: pending.clone(), - }; + let sender = PlayerSender::new(tx.clone(), pending.clone()); let writer_thread = { let (alive, latency, pending) = (alive.clone(), latency.clone(), pending.clone()); std::thread::Builder::new() @@ -544,13 +590,18 @@ fn write_loop( let mut sent_at: Option<(i64, Instant)> = None; let mut next = Instant::now() + KEEP_ALIVE_EVERY; loop { + let mut write = |body: Vec| { + pending.fetch_sub(body.len(), Ordering::Relaxed); + writer.send(&body).is_ok() && pending.load(Ordering::Relaxed) <= MAX_PENDING + }; match rx.recv_timeout(Duration::from_millis(200)) { Ok(Out::Packet(body)) => { - pending.fetch_sub(body.len(), Ordering::Relaxed); - if writer.send(&body).is_err() { + if !write(body) { break; } - if pending.load(Ordering::Relaxed) > MAX_PENDING { + } + Ok(Out::Packets(bodies)) => { + if !bodies.into_iter().all(&mut write) { break; } } @@ -594,3 +645,42 @@ fn write_loop( } writer.shutdown(); } + +#[cfg(test)] +mod tests { + use super::*; + + fn bodies(rx: &Receiver) -> Vec>> { + rx.try_iter() + .map(|out| match out { + Out::Packet(body) => vec![body], + Out::Packets(bodies) => bodies, + Out::Disconnect(_) => vec![b"disconnect".to_vec()], + Out::Close => vec![b"close".to_vec()], + }) + .collect() + } + + #[test] + fn held_packets_go_together_and_in_order() { + let (tx, rx) = channel(); + let sender = PlayerSender::new(tx, Arc::default()); + sender.send(vec![1]); + assert_eq!(bodies(&rx), [vec![vec![1]]]); + let holding = Holding::start(); + sender.send(vec![2]); + sender.send(vec![3]); + assert!(bodies(&rx).is_empty()); + drop(holding); + // A packet sent after the tick still follows the held ones. + sender.send(vec![4]); + assert_eq!(bodies(&rx), [vec![vec![2], vec![3]], vec![vec![4]]]); + let holding = Holding::start(); + sender.send(vec![5]); + sender.disconnect(horizon_world::nbt::Tag::Byte(0)); + drop(holding); + sender.flush(); + assert_eq!(bodies(&rx), [vec![vec![5]], vec![b"disconnect".to_vec()]]); + assert_eq!(sender.pending.load(Ordering::Relaxed), 5); + } +} diff --git a/crates/horizon-client/src/lan/hub.rs b/crates/horizon-client/src/lan/hub.rs index cb438508e..414979a87 100644 --- a/crates/horizon-client/src/lan/hub.rs +++ b/crates/horizon-client/src/lan/hub.rs @@ -389,7 +389,7 @@ impl Hub { /// Disconnect a guest with a reason (ServerGamePacketListenerImpl.disconnect). pub fn kick(&mut self, conn: u32, reason: Tag) { if let Some(g) = self.guest(conn) { - let _ = g.sender.tx.send(super::Out::Disconnect(reason)); + g.sender.disconnect(reason); } } @@ -1638,7 +1638,7 @@ impl Hub { pub fn disconnect_all(&mut self) { let reason = translatable("multiplayer.disconnect.server_shutdown", &[]); for g in &self.guests { - let _ = g.sender.tx.send(super::Out::Disconnect(reason.clone())); + g.sender.disconnect(reason.clone()); } } } diff --git a/crates/horizon-client/src/lan/mod.rs b/crates/horizon-client/src/lan/mod.rs index 7084f20a6..6af4a1fef 100644 --- a/crates/horizon-client/src/lan/mod.rs +++ b/crates/horizon-client/src/lan/mod.rs @@ -21,7 +21,7 @@ pub mod playerdata; mod recipes; pub mod tracking; -pub use conn::PlayerSender; +pub use conn::{Holding, PlayerSender}; use horizon_protocol::packets::play; use horizon_protocol::{ GAME_VERSION, PROTOCOL_VERSION, crypto::uuid_string, packets::configuration::ClientInformation, @@ -69,6 +69,8 @@ pub struct Joined { pub enum Out { /// A packet body: VarInt id and payload. Packet(Vec), + /// Packet bodies held during a tick, in order. + Packets(Vec>), /// Send a play disconnect with this component, then close. Disconnect(horizon_world::nbt::Tag), Close, From 2822d4e1b7146a1a41392421d3ddb818452fb522 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sat, 17 Oct 2026 01:17:09 +0200 Subject: [PATCH 54/59] Content mods: refuse more block states than chunks hold; the pack against NeoForge, measured Loading the eight carried-over mods in the game (not only the probe) showed two limits real packs reach. Block textures past 2048 layers are another PR; this one handles block states and measures a pack. - Chunk sections store a block state in 16 bits. Vanilla 26.3 has 35,723 states; Macaw's four mods add 36,154, the eight 41,389. Past 65,536 ids wrapped onto other blocks (a trapdoor became a hanging sign). mod_content::build now refuses a set of mods past MAX_STATES and names the states per mod; the game then starts without content mods, as for any refused content. - tools/mod_port_harness.py probes each mod on its own against vanilla, as a player adding it would load it. - tools/perf_bench.py --game neoforge: Minecraft 1.21.1 on NeoForge 21.1.259 with --mod-jars and --deps, driven by a dev-only NeoForge port of the bench mod (mods/horizon/src/neoforge-bench); --port-work loads a work folder's carried-over mods into Horizon. tools/neoforge_oracle.py installs the client once under .local/neoforge-oracle (the installer, then the vanilla libraries it inherits, sha1-checked) and builds the driver. A NeoForge start that crashes before the driver loads (FML reading fml.toml while creating it) is retried once. Measured (docs/modpacks.md): six ported mods in Horizon against the same mods on NeoForge, Mac mini M4 Pro, 2 games per row on a loaded machine. The world is ready 3.1x sooner at 8 and 16 chunks, the flights run 1.7x and 3.6x the frames, and Horizon's RSS is not lower (+1.1 GB with the mods). Co-Authored-By: Claude Opus 5.5 --- crates/horizon-client/src/mod_content.rs | 19 ++ .../horizon-client/src/mod_content_tests.rs | 26 ++ docs/modpacks.md | 52 +++- .../neoforgebench/NeoForgeBench.java | 275 ++++++++++++++++++ .../resources/META-INF/neoforge.mods.toml | 11 + tools/mod_port_harness.py | 20 +- tools/neoforge_oracle.py | 96 +++++- tools/perf_bench.py | 99 ++++++- 8 files changed, 571 insertions(+), 27 deletions(-) create mode 100644 mods/horizon/src/neoforge-bench/java/dev/horizonlab/neoforgebench/NeoForgeBench.java create mode 100644 mods/horizon/src/neoforge-bench/resources/META-INF/neoforge.mods.toml diff --git a/crates/horizon-client/src/mod_content.rs b/crates/horizon-client/src/mod_content.rs index 4556a4d6c..f78808da7 100644 --- a/crates/horizon-client/src/mod_content.rs +++ b/crates/horizon-client/src/mod_content.rs @@ -314,6 +314,22 @@ impl<'a> Plan<'a> { }); } } + if next > MAX_STATES { + let mut by_mod: BTreeMap<&str, u32> = BTreeMap::new(); + for b in &blocks { + *by_mod + .entry(&b.decl.id[..b.decl.id.find(':').unwrap_or(0)]) + .or_default() += b.rename.states.len() as u32; + } + let list: Vec = by_mod.iter().map(|(m, n)| format!("{m} {n}")).collect(); + return Err(format!( + "{next} block states, more than the {MAX_STATES} chunks can hold ({} in the game; \ + the mods: {})", + names.len(), + list.join(", ") + ) + .into()); + } // Block items copy the template block's item. let gameplay = read_json(&base.join("gameplay-facts.json"))?; let rows = match gameplay.get("states") { @@ -628,6 +644,9 @@ const NBT_TABLES: [&str; 6] = [ /// In a root built here: the content mods' ids, the namespaces loaders /// read besides `minecraft`. const MARKER: &str = "horizon-mod-content.json"; +/// Block states a world can hold: chunk sections store a state in 16 bits +/// (crate::chunk). Mods past it are refused, not wrapped onto other blocks. +pub const MAX_STATES: u32 = 1 << 16; /// The content mods' namespaces in a root built by [`build`]; none in any /// other root, so vanilla's loaders read exactly what they did. diff --git a/crates/horizon-client/src/mod_content_tests.rs b/crates/horizon-client/src/mod_content_tests.rs index d7627fa27..eff9ddeaa 100644 --- a/crates/horizon-client/src/mod_content_tests.rs +++ b/crates/horizon-client/src/mod_content_tests.rs @@ -220,6 +220,32 @@ fn refuses_unknown_templates_and_vanilla_ids() { fs::remove_dir_all(&scratch).unwrap(); } +#[test] +fn refuses_more_states_than_chunks_hold() { + let Some(base) = prepared() else { + return; + }; + let scratch = std::env::temp_dir().join(format!("horizon-mod-states-{}", std::process::id())); + let _ = fs::remove_dir_all(&scratch); + let mut m = ruby_mod(&scratch.join("ruby")); + // Redstone wire has 1296 states: 40 copies pass any game's 65536. + let mut wire = m.content.blocks[0].clone(); + wire.template = "minecraft:redstone_wire".into(); + for i in 0..40 { + let mut b = wire.clone(); + b.id = format!("ruby:wire_{i}"); + m.content.blocks.push(b); + } + let e = build(&base, std::slice::from_ref(&m), &scratch.join("out")).unwrap_err(); + assert!( + e.to_string() + .contains("more than the 65536 chunks can hold"), + "{e}" + ); + assert!(e.to_string().contains("the mods: ruby "), "{e}"); + fs::remove_dir_all(&scratch).unwrap(); +} + #[test] fn no_content_keeps_the_base_root() { let base = Path::new("/nonexistent/base"); diff --git a/docs/modpacks.md b/docs/modpacks.md index d3cb7c401..1d8609cef 100644 --- a/docs/modpacks.md +++ b/docs/modpacks.md @@ -237,6 +237,11 @@ How the game loads them, without touching vanilla's path: - Loaders that read only `data/minecraft/` (recipes, loot, tags) read every namespace, as vanilla does. With no mods there is only `minecraft`, so nothing changes. - The overlay is cached like the resource-pack overlay and rebuilt when a mod file changes. +- **Limits.** Chunk sections store a block state in 16 bits: vanilla 26.3 has 35,723 states, + so mods may add 29,813. Past that the content root is refused with the states per mod + (Macaw's Doors, Fences, Paths and Trapdoors alone add 36,154: not all four fit). Block + sprites fill texture arrays of 2048 layers, four at most (8,192; vanilla takes 1,250, + identical textures share a layer). Wider state ids are the next step for big packs. - Not in 0.2: multiplayer registry sync (single player and the integrated server first), worlds opened without a mod they used (vanilla turns unknown blocks into air; we will ask first), vanilla ids redefined by a mod (refused). @@ -494,10 +499,12 @@ published. ## Measuring "10x" `tools/perf_bench.py` already measures Horizon against vanilla and vanilla with performance -mods on the same machine, world and camera path ([benchmark.md](benchmark.md)). It gains -`--game pack --pack `: the pack on its own loader (NeoForge 21.1.259 for -ATM10), launched with the pack's recommended JVM arguments, driven by the same dev-only bench -mod, ported to that loader. +mods on the same machine, world and camera path ([benchmark.md](benchmark.md)). With +`--game neoforge --mod-jars --deps ` it runs the mods on their own loader (NeoForge +21.1.259 for ATM10, installed under `.local/neoforge-oracle`, `-Xmx2G` like the launcher), +driven by the same steps through a dev-only NeoForge port of the bench mod +(`mods/horizon/src/neoforge-bench`). `--game horizon --port-work ` loads a work folder's +carried-over mods into Horizon. A whole pack (`--pack`, its recommended JVM arguments) is next. | Metric | How | Horizon side | |---|---|---| @@ -520,6 +527,37 @@ confidence interval. Other ratios are reported as they come out. Caveat (in ever the pack runs Minecraft 1.21.1 and Horizon runs 26.3, so the vanilla parts differ by a few versions. +### Measured: six ported mods against the same mods on NeoForge + +Cloud Glass, Factory Blocks, Glassential, Macaw's Fences, Paths and Trapdoors (Doors left out: +with Trapdoors it passes the block states chunks hold, see Limits), carried over and loaded as +dev mods in Horizon, against their jars plus Architectury and Fusion on NeoForge 21.1.259. +Mac mini M4 Pro, 1280x720, seed 1234, the four flight scenes, 2 games per row, 2026-10-17. +Means; FPS is the mean of the four scenes. "Title" is start to title screen, "world" start to +a fresh world drawn around the spawn, "scene load" a teleport to every chunk drawn. + +| RD | game | title s | world s | scene load s | FPS | RSS steady / peak MB | load avg | +|---|---|---:|---:|---:|---:|---:|---:| +| 8 | Horizon + 6 mods | 9.8 | 16.2 | 4.0 | 122 | 2,644 / 2,771 | 32 | +| 8 | NeoForge + 6 mods | 19.5 | 50.0 | 30.2 | 72 | 2,325 / 2,592 | 56 | +| 8 | Horizon | 5.0 | 11.0 | 4.0 | 124 | 1,559 / 1,629 | 51 | +| 8 | NeoForge | 12.8 | 36.1 | 21.9 | 104 | 2,334 / 2,558 | 30 | +| 16 | Horizon + 6 mods | 10.8 | 27.0 | 11.3 | 90 | 2,925 / 3,032 | 40 | +| 16 | NeoForge + 6 mods | 26.4 | 82.5 | 64.3 | 25 | 3,016 / 3,519 | 45 | +| 16 | Horizon | 3.5 | 10.0 | 7.4 | 119 | 1,732 / 1,871 | 56 | +| 16 | NeoForge | 16.9 | 73.7 | 43.2 | 36 | 2,748 / 3,425 | 48 | + +Same content, Horizon against NeoForge: the world is ready 3.1x sooner at 8 chunks and 3.1x at +16, the title screen 2.0x and 2.4x sooner, and the flights run 1.7x and 3.6x the frames. RAM is +not lower: Horizon's steady RSS grows 1.1 GB with the mods (61,816 block states against +vanilla's 35,723; the per-state tables are the next thing to measure), while the JVM stays +inside its 2 GB heap. Caveats, so none of this is a "10x" claim yet: other sessions and CI +runners kept the machine's load average between 30 and 56 on 14 threads, so the confidence +intervals are as wide as the means (`perf_bench.py --table`); Horizon's frames are paced near +the display's 144 Hz at 8 chunks; Horizon's title time includes building the content overlay on +a first start (about 5 s, cached afterwards); and the pack runs 1.21.1 against Horizon's 26.3. +A quiet rerun with more games is the next measurement. + ## The working version for 2026-10-23 In scope (each is a PR or a small stack): @@ -545,7 +583,11 @@ In scope (each is a PR or a small stack): 6. **Measured:** load time, RAM and FPS of that pack on NeoForge 1.21.1 against Horizon, with the full ATM10 on NeoForge as the reference row. -Out of scope for that date, and next in order: worldgen carry-over (the 30 or so structure and biome mods), +Out of scope for that date, and next in order: worldgen carry-over (the 30 or so structure and biome mods; +the first one looked at, Moog's Voyager Structures, declares all 130 structures and 116 structure +sets with MoogsStructureLib's own `generic_jigsaw_structure` and `advanced_random_spread` types and +NeoForge's `c:` biome tags, so its carry needs a mapping to vanilla's jigsaw and random spread +types plus the oracle's biome tags, not only bundle merging), behaviour callbacks and server events (0.3), block entities, menus, capabilities and net (0.4), the first agent-ported logic-tier mod as the pilot of step 5, then machines. Porting all of ATM10 is a campaign. Each step publishes its coverage number; we make no claim beyond what diff --git a/mods/horizon/src/neoforge-bench/java/dev/horizonlab/neoforgebench/NeoForgeBench.java b/mods/horizon/src/neoforge-bench/java/dev/horizonlab/neoforgebench/NeoForgeBench.java new file mode 100644 index 000000000..5992ed27a --- /dev/null +++ b/mods/horizon/src/neoforge-bench/java/dev/horizonlab/neoforgebench/NeoForgeBench.java @@ -0,0 +1,275 @@ +package dev.horizonlab.neoforgebench; + +import com.google.gson.JsonArray; +import com.google.gson.JsonObject; +import com.google.gson.JsonParser; +import com.mojang.blaze3d.platform.GlUtil; +import java.io.IOException; +import java.io.UncheckedIOException; +import java.nio.charset.StandardCharsets; +import java.nio.file.Files; +import java.nio.file.Path; +import java.nio.file.StandardOpenOption; +import java.util.ArrayList; +import java.util.List; +import net.minecraft.client.Minecraft; +import net.minecraft.client.gui.screens.TitleScreen; +import net.minecraft.client.player.LocalPlayer; +import net.minecraft.world.Difficulty; +import net.minecraft.world.level.GameRules; +import net.minecraft.world.level.GameType; +import net.minecraft.world.level.LevelSettings; +import net.minecraft.world.level.WorldDataConfiguration; +import net.minecraft.world.level.levelgen.WorldOptions; +import net.minecraft.world.level.levelgen.presets.WorldPresets; +import net.minecraft.world.phys.Vec3; +import net.neoforged.api.distmarker.Dist; +import net.neoforged.fml.common.Mod; +import net.neoforged.neoforge.client.event.RenderFrameEvent; +import net.neoforged.neoforge.common.NeoForge; + +/** + * Dev-only benchmark driver for a NeoForge 1.21.1 client (tools/perf_bench.py + * --game neoforge): the steps of mods/horizon/src/bench's VanillaBench, on + * NeoForge's events. From the title screen it creates a fresh creative world + * with the script's seed, waits for the spawn area, then per scene teleports, + * waits for the chunks, settles and flies a straight line at constant speed, + * recording every frame time. Events go to horizon.bench.out as JSON lines; + * the game quits after the last scene. Never shipped. + */ +@Mod(value = "horizon_bench", dist = Dist.CLIENT) +public final class NeoForgeBench { + private enum Phase { TITLE, WORLD, TELEPORT, LOAD, SETTLE, FLY, DONE } + + private final JsonObject script; + private final Path out; + private final List scenes = new ArrayList<>(); + private Phase phase = Phase.TITLE; + private int scene = -1; + private long phaseStart; + private long lastFrame; + private long readyCheck; + private int lastLoaded = -1; + private long lastChange; + private final List frames = new ArrayList<>(); + + public NeoForgeBench() { + String scriptPath = System.getProperty("horizon.bench.script"); + String outPath = System.getProperty("horizon.bench.out"); + if (scriptPath == null || outPath == null) { + script = null; + out = null; + return; + } + try { + script = JsonParser.parseString(Files.readString(Path.of(scriptPath))).getAsJsonObject(); + } catch (IOException e) { + throw new UncheckedIOException(e); + } + out = Path.of(outPath); + for (var element : script.getAsJsonArray("scenes")) scenes.add(element.getAsJsonObject()); + NeoForge.EVENT_BUS.addListener(RenderFrameEvent.Pre.class, e -> step(Minecraft.getInstance())); + event("init"); + } + + private void step(Minecraft mc) { + long now = System.nanoTime(); + float frameMs = lastFrame == 0 ? 0 : (now - lastFrame) / 1e6f; + lastFrame = now; + double elapsed = (now - phaseStart) / 1e9; + if (phase != Phase.TITLE && phase != Phase.DONE && elapsed > script.get("timeout").getAsDouble() + && phase != Phase.FLY && phase != Phase.SETTLE) { + JsonObject e = new JsonObject(); + e.addProperty("phase", phase.name()); + event("timeout", e); + finish(mc); + return; + } + switch (phase) { + case TITLE -> { + if (mc.screen instanceof TitleScreen && mc.getOverlay() == null) { + event("title", renderer(mc)); + LevelSettings settings = new LevelSettings(script.get("world").getAsString(), GameType.CREATIVE, + false, Difficulty.NORMAL, true, new GameRules(), WorldDataConfiguration.DEFAULT); + WorldOptions options = new WorldOptions(script.get("seed").getAsLong(), true, false); + enter(Phase.WORLD, now); + mc.createWorldOpenFlows().createFreshLevel(script.get("world").getAsString(), settings, options, + WorldPresets::createNormalWorldDimensions, mc.screen); + } + } + case WORLD -> { + if (ready(mc, null, now)) { + JsonObject e = new JsonObject(); + e.addProperty("ready_epoch_ms", epochMs(lastChange)); + e.addProperty("chunks", lastLoaded); + event("world", e); + mc.player.connection.sendCommand("weather clear"); + next(mc, now); + } + } + case TELEPORT -> { + JsonObject s = scenes.get(scene); + Vec3 from = vec(s.getAsJsonArray("from")); + LocalPlayer player = mc.player; + player.connection.sendCommand("time set 6000"); + player.connection.sendCommand(String.format(java.util.Locale.ROOT, "tp @s %.3f %.3f %.3f %.3f %.3f", + from.x, from.y, from.z, yaw(s), s.get("pitch").getAsFloat())); + event("teleport", named(s)); + enter(Phase.LOAD, now); + } + case LOAD -> { + JsonObject s = scenes.get(scene); + Vec3 from = vec(s.getAsJsonArray("from")); + if (mc.player != null && mc.player.position().distanceToSqr(from) < 1024.0) place(mc, s, 0); + if (ready(mc, from, now)) { + JsonObject e = named(s); + e.addProperty("load_ms", (lastChange - phaseStart) / 1e6); + e.addProperty("chunks", lastLoaded); + event("loaded", e); + enter(Phase.SETTLE, now); + } + } + case SETTLE -> { + place(mc, scenes.get(scene), 0); + if (elapsed >= script.get("settle").getAsDouble()) { + frames.clear(); + event("fly", named(scenes.get(scene))); + enter(Phase.FLY, now); + } + } + case FLY -> { + frames.add(frameMs); + double t = Math.min(1.0, elapsed / script.get("seconds").getAsDouble()); + place(mc, scenes.get(scene), t); + if (t >= 1.0) { + JsonObject e = named(scenes.get(scene)); + JsonArray times = new JsonArray(); + frames.forEach(times::add); + e.add("frame_ms", times); + e.addProperty("chunks", mc.level.getChunkSource().getLoadedChunksCount()); + event("flown", e); + next(mc, now); + } + } + case DONE -> { } + } + } + + private void next(Minecraft mc, long now) { + scene++; + if (scene >= scenes.size()) { + finish(mc); + } else { + enter(Phase.TELEPORT, now); + } + } + + private void finish(Minecraft mc) { + phase = Phase.DONE; + event("done"); + mc.stop(); + } + + private void enter(Phase next, long now) { + phase = next; + phaseStart = now; + lastLoaded = -1; + lastChange = now; + } + + /** As VanillaBench.ready: spawned (near {@code at}), no screen, every chunk around, nothing to compile, 1 s stable. */ + private boolean ready(Minecraft mc, Vec3 at, long now) { + if (now - readyCheck < 10_000_000L) return false; + readyCheck = now; + if (mc.level == null || mc.player == null || mc.screen != null || mc.getOverlay() != null + || (at != null && mc.player.position().distanceToSqr(at) > 4.0)) { + lastChange = now; + lastLoaded = -1; + return false; + } + int loaded = mc.level.getChunkSource().getLoadedChunksCount(); + if (loaded != lastLoaded || !mc.levelRenderer.hasRenderedAllSections() || !chunksAround(mc)) { + lastLoaded = loaded; + lastChange = now; + return false; + } + return now - lastChange >= 1_000_000_000L; + } + + private static boolean chunksAround(Minecraft mc) { + int r = Math.max(1, mc.options.getEffectiveRenderDistance() - 1); + var center = mc.player.chunkPosition(); + var chunks = mc.level.getChunkSource(); + for (int dx = -r; dx <= r; dx++) { + for (int dz = -r; dz <= r; dz++) { + if (dx * dx + dz * dz <= r * r && !chunks.hasChunk(center.x + dx, center.z + dz)) return false; + } + } + return true; + } + + private static void place(Minecraft mc, JsonObject s, double t) { + LocalPlayer player = mc.player; + if (player == null) return; + Vec3 a = vec(s.getAsJsonArray("from")), b = vec(s.getAsJsonArray("to")); + Vec3 at = a.add(b.subtract(a).scale(t)); + player.setPos(at.x, at.y, at.z); + player.setYRot(yaw(s)); + player.setXRot(s.get("pitch").getAsFloat()); + player.setOldPosAndRot(); + player.setDeltaMovement(Vec3.ZERO); + player.fallDistance = 0; + if (!player.getAbilities().flying) { + player.getAbilities().flying = true; + player.onUpdateAbilities(); + } + } + + private static float yaw(JsonObject s) { + Vec3 a = vec(s.getAsJsonArray("from")), b = vec(s.getAsJsonArray("to")); + return (float) Math.toDegrees(Math.atan2(-(b.x - a.x), b.z - a.z)); + } + + private static Vec3 vec(JsonArray a) { + return new Vec3(a.get(0).getAsDouble(), a.get(1).getAsDouble(), a.get(2).getAsDouble()); + } + + private static JsonObject named(JsonObject s) { + JsonObject e = new JsonObject(); + e.addProperty("scene", s.get("name").getAsString()); + return e; + } + + private static JsonObject renderer(Minecraft mc) { + JsonObject e = new JsonObject(); + e.addProperty("gpu", GlUtil.getRenderer()); + e.addProperty("vendor", GlUtil.getVendor()); + e.addProperty("backend", "OpenGL"); + e.addProperty("driver", GlUtil.getOpenGLVersion()); + JsonArray size = new JsonArray(); + size.add(mc.getWindow().getWidth()); + size.add(mc.getWindow().getHeight()); + e.add("size", size); + e.addProperty("render_distance", mc.options.renderDistance().get()); + e.addProperty("simulation_distance", mc.options.simulationDistance().get()); + return e; + } + + private static long epochMs(long nanos) { + return System.currentTimeMillis() - (System.nanoTime() - nanos) / 1_000_000L; + } + + private void event(String name) { + event(name, new JsonObject()); + } + + private void event(String name, JsonObject e) { + e.addProperty("event", name); + e.addProperty("epoch_ms", System.currentTimeMillis()); + try { + Files.writeString(out, e + "\n", StandardCharsets.UTF_8, StandardOpenOption.CREATE, StandardOpenOption.APPEND); + } catch (IOException error) { + throw new UncheckedIOException(error); + } + } +} diff --git a/mods/horizon/src/neoforge-bench/resources/META-INF/neoforge.mods.toml b/mods/horizon/src/neoforge-bench/resources/META-INF/neoforge.mods.toml new file mode 100644 index 000000000..0fb0c3029 --- /dev/null +++ b/mods/horizon/src/neoforge-bench/resources/META-INF/neoforge.mods.toml @@ -0,0 +1,11 @@ +# Dev-only: the benchmark driver for a NeoForge client (tools/perf_bench.py --game neoforge). +# Built and run by tools/perf_bench.py; never shipped. +modLoader = "javafml" +loaderVersion = "[4,)" +license = "MIT" + +[[mods]] +modId = "horizon_bench" +version = "1" +displayName = "Horizon benchmark driver (dev only)" +description = "Flies the client along tools/perf_bench.py's paths and records frame times." diff --git a/tools/mod_port_harness.py b/tools/mod_port_harness.py index 23f7e82b9..181e6533b 100644 --- a/tools/mod_port_harness.py +++ b/tools/mod_port_harness.py @@ -17,7 +17,8 @@ and what the game's loaders make of it. For every block and item the mod registe - recipes: each recipe's result, count and ingredients; - items: present, and their stack size. -Writes WORK/mods//harness/result.json per mod and prints a table. Jars, facts and results stay +Each mod is probed on its own, against vanilla. Writes WORK/mods//harness/{horizon,result}.json +per mod and prints a table. Jars, facts and results stay in WORK, outside the repository. """ import argparse @@ -185,18 +186,23 @@ def main(): metadata = json.loads(subprocess.check_output(['cargo', 'metadata', '--no-deps', '--format-version', '1'], cwd=ROOT, text=True)) probe = Path(metadata['target_directory']) / 'release/examples/mod_port_probe' - out = work / 'horizon.json' - subprocess.run([str(probe), args.resources, str(work), str(out), *args.mods], check=True) oracle = json.loads(facts.read_text()) - horizon = json.loads(out.read_text()) - upgrades = sound_upgrades(oracle, horizon) old_items = set(oracle.get('vanilla_items', [])) mods = args.mods or sorted(p.name for p in (work / 'mods').iterdir() if (p / 'carry').is_dir()) - print(f'{"mod":<16} {"result":<7} ' + ' '.join(f'{c:>12}' for c in CHECKS)) + rows = [] for mod in mods: + # One mod at a time: each against vanilla, as a player adding it would load it (and a pack's + # sum may pass the block states a world holds, which the probe would refuse). + out = work / 'mods' / mod / 'harness' / 'horizon.json' + out.parent.mkdir(parents=True, exist_ok=True) + subprocess.run([str(probe), args.resources, str(work), str(out), mod], check=True) + horizon = json.loads(out.read_text()) carry_report = work / 'mods' / mod / 'carry-report.json' carry = json.loads(carry_report.read_text()) if carry_report.exists() else {} - result = compare_mod(mod, oracle, horizon, carry, upgrades, old_items) + rows.append(compare_mod(mod, oracle, horizon, carry, sound_upgrades(oracle, horizon), old_items)) + print(f'{"mod":<16} {"result":<7} ' + ' '.join(f'{c:>12}' for c in CHECKS)) + for result in rows: + mod = result['mod'] (work / 'mods' / mod / 'harness').mkdir(parents=True, exist_ok=True) (work / 'mods' / mod / 'harness' / 'result.json').write_text(json.dumps(result, indent=1)) cols = [] diff --git a/tools/neoforge_oracle.py b/tools/neoforge_oracle.py index f72bbec3e..7410c1fb5 100644 --- a/tools/neoforge_oracle.py +++ b/tools/neoforge_oracle.py @@ -45,6 +45,84 @@ def install(): return home +def client(): + """The NeoForge client (tools/perf_bench.py --game neoforge), installed once per version: the installer's + own files, then the vanilla libraries its version inherits, fetched as the launcher does (sha1-checked).""" + sys.path.insert(0, str(ROOT / 'tools')) + import hashlib + import lab + home = LOCAL / f'client-{NEOFORGE}' + profile = home / 'versions' / f'neoforge-{NEOFORGE}' / f'neoforge-{NEOFORGE}.json' + if not profile.exists(): + install() # the installer jar + home.mkdir(parents=True, exist_ok=True) + (home / 'launcher_profiles.json').write_text('{"profiles":{}}') + with (LOCAL / f'install-client-{NEOFORGE}.log').open('w') as log: + subprocess.run(['java', '-jar', str(LOCAL / f'neoforge-{NEOFORGE}-installer.jar'), '--installClient', + str(home)], cwd=LOCAL, stdout=log, stderr=subprocess.STDOUT, check=True) + neo = json.loads(profile.read_text()) + base = json.loads((home / 'versions' / neo['inheritsFrom'] / f'{neo["inheritsFrom"]}.json').read_text()) + jars = [] + for manifest in (neo, base): + names = {library['name'] for library in manifest['libraries']} + for library in manifest['libraries']: + artifact = library.get('downloads', {}).get('artifact') + if not artifact or not lab.library_allowed(library) or not lab.native_library_matches(library, None, names): + continue + path = home / 'libraries' / artifact['path'] + if not path.exists(): + with urllib.request.urlopen(artifact['url'], timeout=120) as r: + data = r.read() + if hashlib.sha1(data).hexdigest() != artifact['sha1']: + sys.exit(f'{artifact["url"]}: sha1 mismatch') + path.parent.mkdir(parents=True, exist_ok=True) + path.write_bytes(data) + if path not in jars: + jars.append(path) + return home, neo, base, jars + + +def client_command(java, heap, game_dir, natives, assets, jvm=(), game=()): + """The command the launcher would run for the NeoForge client profile, with no account.""" + home, neo, base, jars = client() + import lab + values = {'library_directory': str(home / 'libraries'), 'classpath_separator': os.pathsep, + 'version_name': f'neoforge-{NEOFORGE}', 'natives_directory': str(natives), + 'launcher_name': 'horizon-bench', 'launcher_version': '1'} + expand = lambda s: s.replace('${', '{').format(**values) + command = [str(java), f'-Xmx{heap}'] + for argument in base['arguments']['jvm']: + if isinstance(argument, dict): + if lab.library_allowed(argument): + command += [argument['value']] if isinstance(argument['value'], str) else argument['value'] + elif argument == '${classpath}': + # Every library; not the vanilla jar, which NeoForge's patched client replaces. + command.append(os.pathsep.join(map(str, jars))) + else: + command.append(expand(argument)) + command += [expand(a) for a in neo['arguments']['jvm']] + command += [*jvm, neo['mainClass']] + command += ['--username', 'Bench', '--uuid', '00000000000000000000000000000000', '--accessToken', '0', + '--version', f'neoforge-{NEOFORGE}', '--gameDir', str(game_dir), '--assetsDir', str(assets), + '--assetIndex', base['assetIndex']['id'], '--userType', 'msa', '--versionType', 'release', + *neo['arguments']['game'], *game] + return home, command + + +def build_bench(home): + """The NeoForge benchmark driver (mods/horizon/src/neoforge-bench), against the client.""" + return build(home, ROOT / 'mods/horizon/src/neoforge-bench', 'horizon-bench-neoforge.jar', client_classpath(home)) + + +def client_classpath(home): + libs = home / 'libraries' + first = [libs / f'net/neoforged/neoforge/{NEOFORGE}/neoforge-{NEOFORGE}-client.jar', + libs / f'net/neoforged/neoforge/{NEOFORGE}/neoforge-{NEOFORGE}-universal.jar'] + rest = sorted(p for p in libs.rglob('*.jar') if p not in first and 'slim' not in p.name + and 'extra' not in p.name and not p.name.endswith('-unpacked.jar')) + return os.pathsep.join(map(str, first + rest)) + + def classpath(home): libs = home / 'libraries' first = [libs / f'net/neoforged/neoforge/{NEOFORGE}/neoforge-{NEOFORGE}-server.jar', @@ -54,27 +132,27 @@ def classpath(home): return os.pathsep.join(map(str, first + rest)) -def build(home): - """The exporter mod jar, rebuilt when its sources change.""" +def build(home, source=SOURCE, name='horizon-oracle.jar', cp=None): + """A dev-only mod jar (by default the exporter), rebuilt when its sources change.""" out = LOCAL / 'build' - jar = out / 'horizon-oracle.jar' - sources = sorted((SOURCE / 'java').rglob('*.java')) - resources = sorted(p for p in (SOURCE / 'resources').rglob('*') if p.is_file()) + jar = out / name + sources = sorted((source / 'java').rglob('*.java')) + resources = sorted(p for p in (source / 'resources').rglob('*') if p.is_file()) newest = max(p.stat().st_mtime for p in sources + resources) if jar.exists() and jar.stat().st_mtime > newest: return jar - classes = out / 'classes' + classes = out / f'classes-{Path(name).stem}' shutil.rmtree(classes, ignore_errors=True) classes.mkdir(parents=True) - javac = subprocess.run(['javac', '--release', '21', '-proc:none', '-nowarn', '-cp', classpath(home), + javac = subprocess.run(['javac', '--release', '21', '-proc:none', '-nowarn', '-cp', cp or classpath(home), '-d', str(classes), *map(str, sources)], capture_output=True, text=True) if javac.returncode: - sys.exit(f'the exporter does not compile:\n{javac.stdout}{javac.stderr}') + sys.exit(f'{name} does not compile:\n{javac.stdout}{javac.stderr}') with zipfile.ZipFile(jar, 'w', zipfile.ZIP_DEFLATED) as z: for p in sorted(classes.rglob('*.class')): z.write(p, p.relative_to(classes).as_posix()) for p in resources: - z.write(p, p.relative_to(SOURCE / 'resources').as_posix()) + z.write(p, p.relative_to(source / 'resources').as_posix()) return jar diff --git a/tools/perf_bench.py b/tools/perf_bench.py index 96fb7c8e7..013df41d6 100644 --- a/tools/perf_bench.py +++ b/tools/perf_bench.py @@ -13,6 +13,11 @@ for every game. RSS is sampled from outside the process for every game too. python3 tools/perf_bench.py --game vanilla-mods --label mods-m4 python3 tools/perf_bench.py --table horizon-m4 vanilla-m4 mods-m4 +A ported mod pack against the same mods on their own loader (docs/modpacks.md, "Measured"): + + python3 tools/perf_bench.py --game horizon --port-work WORK --label pack-horizon + python3 tools/perf_bench.py --game neoforge --mod-jars JARS --deps DEPS --label pack-neoforge + Games: horizon target/release/horizon-client, driven over its control socket vanilla your own 26.3 client.jar + Fabric Loader + a dev-only driver @@ -20,6 +25,13 @@ Games: is redistributed vanilla-mods the same + Sodium, Lithium, FerriteCore and ImmediatelyFast (pinned in packs/mods.lock.json) + neoforge Minecraft 1.21.1 on NeoForge (dev-only, tools/neoforge_oracle.py + installs it under .local/neoforge-oracle) + a driver mod + (mods/horizon/src/neoforge-bench) + the jars of --mod-jars and + --deps, the user's own; 26.3 options it does not know are ignored + +--port-work loads the mods a horizon-port-pack work folder carried over into +Horizon as dev mods. Results: benchmarks/perf/