[WhereisFff]

将结构渲染、隔离沙盒、相机拾取和只读 GUI 浮窗移入砧库，让手册与机器界面共用实现，避免机器功能依赖手册模组。

• 提供特殊方块 GUI 注册、减少动态效果参数及附加模型和后处理接口
• 适配 26.1 的原生渲染与透明度补丁，保留结构中的方块实体和实体
• 提供通用翻译、接口说明和只读作用域回归检查

验证：:anvillib-rendering-neoforge-26.1:build（含 previewTest）与 git diff --check 通过；已对照当前版本源码核查 Mixin 目标。客户端画面尚未实测。

[Gugle2308]

🌿 Roseau API Breaking Change Report

Module	Status	Breaking Changes
codec	✅ Compatible	0
collision	✅ Compatible	0
cube	✅ Compatible	0
config	✅ Compatible	0
integration	✅ Compatible	0
moveable-entity-block	✅ Compatible	0
network	✅ Compatible	0
rendering	✅ Compatible	0
space-select	✅ Compatible	0
font	✅ Compatible	0
util	✅ Compatible	0
explosion	✅ Compatible	0
rpc	✅ Compatible	0
math	✅ Compatible	0
multiblock	✅ Compatible	0
recipe	✅ Compatible	0
registrum	✅ Compatible	0
sync	✅ Compatible	0
ui	✅ Compatible	0
wheel	✅ Compatible	0
main	✅ Compatible	0

Full CSVs: see the Artifacts section of this workflow run.

[Gugle2308]

结论：PR #287 已合并（squash 6ae5db92，dev/26.1 tip，合并树与 head b8899558 完全一致，2026-11-14T18:43:32Z）。26.1 的 6 处注入我逐个用未混淆 client.jar 的方法表 + 字节码核对过：全部命中，且两个 @ModifyArgs �� args.set(11, color) 都精确落在 BlitRenderState 的 14 参规范构造器上；需要跟进的是「复用真实相机剔除实体」「沙盒染色/海平面与旧线不一致」「时钟注册表缺席时静默无时钟」三点。

一、合并态与范围

判据	结果
state / merged / merged_at	closed / true / 2026-11-14T18:43:32Z
merge_commit_sha	6ae5db924e462dd8f88a3c3d2a29e1ef572f5e77 = dev/26.1 tip
合并树 vs head	空 diff ⇒ 进主干的就是 b8899558
规模	34 文件 +3317/−0，与收到的 diff 一致
head CI	build / build ✅
既有评论	仅 Roseau API 报告
语言文件	en_us / en_ud / zh_cn 各 107 条 ✅

二、注入点逐条核实（26.1.2 未混淆 jar）

注入	核对结果
innerBlit(RenderPipeline, GpuTextureView, GpuSampler, IIII, FFFF, I) ordinal=4	该方法在 GuiGraphicsExtractor 里有两个重载（Identifier 版与 GpuTextureView+GpuSampler 版），mixin 用了完整描述符锁定后者 ✅；int 位序 = 4 坐标 + color，ordinal=4 = 第 5 个 int = color ✅
innerFill(…, IIIII, Integer) 两个 handler	单重载（code=59）⇒ ordinal=4 = color ✅；尾部 Integer handler 匹配渐变参数 ✅
innerTiledBlit(…, IIIIII, FFFF, I) ordinal=6	code=61；共 7 个 int（6 坐标 + color）⇒ ordinal=6 = 第 7 个 = color ✅
text(Font, FormattedCharSequence, IIIZ) ordinal=2	类里有 III 与 IIIZ 两个 text 重载，mixin 按描述符锁定 IIIZ ✅；ordinal=2 = 第 3 个 int = color ✅
Screen.extractBackground(GuiGraphicsExtractor, int, int, float)	public code=53 ✅（26.1 的 extract 体系，替代 1.21.11 的 renderBackground）
RecipeBookComponent.isVisibleAccordingToBookData()Z	private code=15 ✅
GuiRenderer.submitBlitFromItemAtlas(GuiItemRenderState, GuiItemAtlas$SlotView)	private code=82 ✅（26.1 改了签名，mixin 只按方法名 + 内部 INVOKE 定位，不受影响）
PictureInPictureRenderer.blitTexture(PictureInPictureRenderState, GuiRenderState)	protected code=73 ✅，父类构造器 (BufferSource) ✅
BlitRenderState.<init> 14 参 + args.set(11, …)	字节码显示 submitBlitFromItemAtlas 与 blitTexture 各自只调用一次 14 参规范构造器，参数序 …IIII、FFFF、I(color, index 11)、两个 ScreenRectangle ⇒ 下标与注入点都正确 ✅

三、需要跟进（合并后）

• PiP 里复用真实世界相机做剔除（与 1.21.8 / 1.21.11 同源问题）：renderToTexture 取 gameRenderState.levelRenderState.cameraRenderState 传给 entityRenderDispatcher.submit(...) 与 blockEntityRenderer.submit(state, pose, nodes, camera)，实体裁剪距离、shouldRender、阴影判定都按玩家真实视角算 ⇒ 结构里位于玩家背后或超出视距的实体不会出现在预览窗。建议构造与预览 state.transform() 对齐的 CameraRenderState。
• SandboxRenderLevel 的染色与海平面：本线 implements BlockAndTintGetter 且 getBlockTint(...) 恒返回 -1、cardinalLighting() 恒返回 CardinalLighting.DEFAULT、getSeaLevel() 返回 0（1.21.4 / 1.21.8 是 63）。渲染走 ProjectionScene(mc.level) 所以当前观感可能没问题，但任何直接以沙盒为 BlockAndTintGetter 的扩展都会拿到「无染色 + 默认朝向光照」；海平面 0 也会让依赖它的流体/高度逻辑与旧线不一致。
• createClientClockManager 在注册表缺席时静默无时钟：registryAccess.lookup(Registries.WORLD_CLOCK).flatMap(lookup -> lookup.get(WorldClocks.OVERWORLD)) 为空时 clockManager 里没有任何时钟数据，依赖 clockManager() 的渲染会拿到空/默认值且没有任何日志。建议 else 打一条 warn（一次性），否则这类「预览里时间相关表现怪」的问题很难定位。
• defaultRequire: 1 + required: true 下 pin 死 record 构造器没有运行时保险：两个 @ModifyArgs 精确绑定 BlitRenderState 的 14 参构造器，而 build / previewTest 不加载 mixin，CI 绿不能证明命中（本次由字节码手工证）。建议给这两个纯视觉注入加 require = 0。
• mixins.json 的 compatibilityLevel 在本线也是 JAVA_8（1.21.1 / 1.21.4 / 1.21.8 为 JAVA_21；1.21.11 同样 JAVA_8）——既有配置，但新增 6 个 mixin 后建议跨线统一，避免以后有人用 record/pattern 等新特性踩坑。
• 每帧新建渲染器对象：renderToTexture 里 new ProjectionScene(...)、new ModelBlockRenderer(...)、new FluidRenderer(...) 每帧一次；建议提到字段（ModelBlockRenderer 依赖 ambientOcclusion 选项，可在配置变更时重建）。
• 既有项（跨线通病）：getFilledBlocks() 返回复用的 MutableBlockPos；StructureGuiProviders.register 冲突直接抛 IllegalStateException（客户端初始化期）；StructureBlockEntityDetails.describe / StructureDetailsPager 仍无生产调用方（107×3 条 lang 随之闲置）。

四、与 1.21.11 的差异对照（26.1 适配点，均已核实）

维度	1.21.11	26.1（本 PR）
GUI 上下文	GuiGraphics	GuiGraphicsExtractor（submit* → inner*，drawString → text，renderBackground → extractBackground）
纹理提交	submitBlit / submitTiledBlit / submitColoredRectangle	innerBlit（两个重载）/ innerTiledBlit / innerFill
BlitRenderState 位置	client.gui.render.state	client.renderer.state.gui
PiP 包	client.gui.render.pip	client.gui.render.pip（状态类迁到 client.renderer.state.gui.pip）
GUI 缩放	window.getGuiScale()	gameRenderState.windowRenderState.guiScale
亮度常量	LightTexture.FULL_BRIGHT	LightCoordsUtil.FULL_BRIGHT
方块/流体渲染	BlockRenderDispatcher.renderBatched/renderLiquid	new ModelBlockRenderer(...) + FluidRenderer，按 quad.materialInfo().itemRenderType().hasBlending() 分流，并使用 Sheets.translucentBlockSheet() ✅（比 1.21.8 只有 item sheet 更好）
沙盒	无时钟	新增 ClientClockManager / EnvironmentAttributeSystem / CardinalLighting
语言文件	107 × 3	107 × 3（一致）

五、验证边界

未执行 Gradle 构建、runClient 与游戏内实测（PR 自述「客户端画面尚未实测」）；previewTest 只覆盖 provider 注册、renderOnly 嵌套/异常恢复与缓动函数，不加载 mixin、不渲染。本文结论来自静态读码 + 26.1.2 未混淆 client.jar 的方法表与字节码（上表逐项给出方法/描述符/code= 与构造器调用唯一性）+ 合并树/head 对账 + head CI + 三份 lang 键数比对。建议实机补测：真实容器屏在不同 GUI scale 下的浮窗裁剪与层级、F3 隐藏 GUI、结构内实体位于玩家背后/远处的可见性（对应第三节第一条）、大尺寸物品淡出、时钟/时间相关渲染（对应第三节第三条），以及同一结构在 1.21.11 与 26.1 上的观感一致性。