Port all 1.21 new features to 26.1 把1.21的所有新特性移植到26.1

.gitignore

@@ -128,3 +128,6 @@ reference/
 
 libs/
 /AGENT.md
+
+# Python cache from port validation tools
+/dev/porting/__pycache__/

AGENTS.md

@@ -13,6 +13,7 @@
 - Follow nearby project patterns and existing APIs before introducing new abstractions.
 - Preserve unrelated working-tree changes. Do not revert, clean up, or reformat files outside the requested scope.
 - Do not broaden a file-specific request into a repository-wide refactor unless explicitly asked.
+- Do not write manual
 
 ## Code Style
 

dependencies.gradle

@@ -1,6 +1,9 @@
 dependencies {
     // AnvilLib
     api(libs.anvillib)
+    api(libs.anvillib.cube)
+    api(libs.anvillib.multiblock) { transitive = false }
+    api(libs.anvillib.math) { transitive = false }
     interfaceInjectionData(libs.anvillib.recipe)
     interfaceInjectionData(libs.anvillib.moveableEntityBlock)
     // jarJar(libs.anvillib)

dev/porting/cfa-mun.gradle

@@ -0,0 +1,8 @@
+gradle.projectsEvaluated {
+    rootProject.tasks.named('runClient') {
+        systemProperty 'anvilcraft.portVisualScene', 'true'
+        systemProperty 'anvilcraft.portCfaItemScene', 'true'
+        systemProperty 'anvilcraft.portCelestialTravelScene', 'true'
+        systemProperty 'anvilcraft.portCfaMunScene', 'true'
+    }
+}

dev/porting/check_source_updates.py

@@ -0,0 +1,18 @@
+"""在提交节点前只读核对本地源分支，列出新提交与已发现但未移植的增量。"""
+import json
+import subprocess
+import sys
+from pathlib import Path
+
+root = Path(__file__).resolve().parents[2]
+sys.stdout.reconfigure(encoding="utf-8")
+tracking = json.loads((root / "docs/porting/source-updates.json").read_text(encoding="utf-8"))
+current = subprocess.check_output(["git", "rev-parse", tracking["branch"]], cwd=root, text=True).strip()
+observed = tracking["latest_observed"]
+ancestor = subprocess.run(["git", "merge-base", "--is-ancestor", observed, current], cwd=root, check=False).returncode == 0
+new = subprocess.check_output(["git", "log", "--reverse", "--format=%H%x09%s", f"{observed}..{current}"], cwd=root).decode("utf-8")
+changed = subprocess.check_output(["git", "diff", "--name-only", observed, current], cwd=root).decode("utf-8").splitlines()
+print(json.dumps({"branch": tracking["branch"], "current": current, "observed": observed, "fast_forward": ancestor,
+                  "new_commits": new.splitlines(), "changed_files": changed,
+                  "pending": [entry for entry in tracking["updates"] if entry["status"] != "ported"]},
+                 ensure_ascii=False, indent=2))

dev/porting/checkstyle.gradle

@@ -0,0 +1,154 @@
+allprojects {
+    apply plugin: 'checkstyle'
+    checkstyle {
+        toolVersion = '13.4.2'
+        configFile = file('style.xml')
+    }
+    tasks.register('checkPortJava', Checkstyle) {
+        source = fileTree('src/main/java') {
+            include '**/*BigRedButton*.java', '**/*RedstoneDice*.java', '**/BuildingRodLang.java'
+            include '**/client/selection/*.java', '**/mixin/client/*SelectionMixin.java', '**/mixin/client/CubeHighlightEventsMixin.java'
+            include '**/PowerProducerRenderer.java', '**/AdvancedComparatorRenderer.java', '**/HeliostatsRenderer.java'
+            include '**/ControlValveBlockEntityRenderer.java', '**/PipeCheckValveBERenderer.java', '**/PumpBlockEntityRenderer.java'
+            include '**/OverseerBlockEntityRenderer.java', '**/WipBlockEntityRenderer.java', '**/PulseGeneratorBlockEntityRenderer.java'
+            include '**/block/placement/*.java', '**/api/pointer/*.java', '**/api/block/BlockPlacementRules.java'
+            include '**/api/block/IBlockPlacementRule.java', '**/api/block/ICauldron.java', '**/api/item/IBlockItem.java'
+            include '**/BlockPlacementUtil.java', '**/BlockStateAndEntity.java', '**/ModBlockPlacementFallbacks.java'
+            include '**/ModBlockPlacementRuleProvider.java', '**/ModTargetPointers.java', '**/FireCauldronBlock.java', '**/OilCauldronBlock.java'
+            include '**/SmartBlockPlacer*.java', '**/SmartPlacer*.java', '**/StructureBookUtil.java'
+            include '**/mixin/client/ItemLayerTransformInvoker.java', '**/mixin/client/ItemStackRenderStateAccessor.java'
+            include '**/BlockPlacementPicking.java', '**/BlockPlaceContextMixin.java', '**/UseOnContextMixin.java', '**/ItemStackMixin.java'
+            include '**/LargeBlockPlacePreviewEventListener.java', '**/ChuteBlockItem.java', '**/CelestialForgingAnvilAmplifierBlockItem.java'
+            include '**/ItemSplitter*.java'
+            include '**/OverflowChute*.java', '**/BaseChuteBlockEntity.java'
+            include '**/IStoragePort.java', '**/StoragePortManager.java', '**/StoragePortType.java', '**/AbstractStoragePortBlock.java'
+            include '**/StoragePort*.java', '**/BlockEntityItemUtil.java'
+            include '**/ClientStoragePortTooltip.java'
+            include '**/GatewayGuiProjection.java', '**/GatewayItem*Mixin.java'
+            include '**/ScaledGuiItem*.java'
+            include '**/StorageFluidPort*.java', '**/FluidBottleInteraction.java'
+            include '**/FluidTankTooltip.java', '**/ClientFluidTankTooltip.java'
+            include '**/api/plasma/*.java', '**/PlasmaJetsBlock*.java', '**/IEmptyCauldron.java', '**/EmptyCauldronMixin.java'
+            include '**/saved/storage/category/FluidCategory.java', '**/saved/storage/category/ICategory.java'
+            include '**/saved/storage/category/AndCategory.java', '**/saved/storage/category/OrCategory.java'
+            include '**/saved/storage/category/NamespaceCategory.java'
+            include '**/saved/storage/category/HasComponentCategory.java', '**/saved/storage/category/FilterCategory.java'
+            include '**/saved/storage/category/CreativeModeTabCategory.java', '**/saved/storage/category/RecipeBookCategoryCategory.java'
+            include '**/client/gui/component/category/CategoryButton.java', '**/client/gui/component/category/CategoryList.java'
+            include '**/EquipmentArmorItem.java', '**/EquipmentAbilities.java', '**/AmuletAbilities.java'
+            include '**/ModModelLayers.java', '**/EquipmentHelmetModel.java', '**/EquipmentClientEvents.java', '**/SwitchEquipmentAbilityPacket.java'
+            include '**/EquipmentFluidOverlayMixin.java', '**/EquipmentBootsModel.java', '**/EquipmentLiquidBlockMixin.java'
+            include '**/sliding/SlidingBlockInfo.java'
+            include '**/AnimateAscendingBlockEntity.java', '**/SlidingBlockEntity.java', '**/CauldronOutletEntity.java'
+            include '**/building/*.java'
+            include '**/BuildingRodPacket.java', '**/BuildingRodResultPacket.java', '**/BuildingRodKeyboardMixin.java'
+            include '**/ItemStackMixin.java', '**/BuildingRodArmedStateMixin.java'
+            include '**/BuildingRodItemLayerAccessor.java', '**/ItemInHandRendererMixin.java', '**/ItemInHandRendererManager.java'
+            include '**/StructureDiskData.java'
+            include '**/StructureFileTransfer.java', '**/StructureBlueprintFiles.java', '**/StructureScannerFiles.java'
+            include '**/StructureSaveUtil.java', '**/StructureScannerMenu.java', '**/StructureScannerBlockEntity.java'
+            include '**/StructureScannerActionPacket.java', '**/StructureScanner*Packet.java'
+            include '**/StructureScannerScreen.java', '**/StructureScannerButtonState.java', '**/SimpleIconButton.java'
+            include '**/TexturedButton.java', '**/LevelLike.java', '**/SmartPlacerPreviewRenderer.java'
+            include '**/BuildingRodObstructionPacket.java', '**/BuildingRodObstructionGlowMixin.java'
+            include '**/LargeCakeBlock.java', '**/LargeCakeBlockItem.java'
+            include '**/BuildingRodItem.java', '**/StoredEnergyEmptyProperty.java', '**/BuildingRodLang.java'
+            include '**/BlueprintUndoChunkMixin.java', '**/BlueprintEntityDropsMixin.java', '**/BlueprintTntOriginMixin.java'
+            include '**/BlueprintLevelMixin.java', '**/BlueprintServerLevelMixin.java', '**/BlueprintTicksMixin.java'
+            include '**/BlueprintBlockEventsAccessor.java'
+            include '**/InWorldRecipeEventListener.java', '**/MeshRecipe.java', '**/UnpackRecipe.java', '**/ItemCrushRecipe.java'
+            include '**/ProcessingItemStackRenderer.java', '**/ProcessingModel*.java'
+            include '**/*ProcessingTable*.java', '**/StampingPlatform*.java', '**/CrushingTable*.java', '**/SiftingTable*.java', '**/UnpackingTable*.java'
+            include '**/UseItemOnBlock.java', '**/ProcessingTablePlacement.java', '**/ModBlockPlacementRuleProvider.java'
+            include '**/BlockItemHandlerPointer.java', '**/ItemEntityPointer.java'
+            include '**/ItemDetectorBlockEntity.java', '**/PulseGeneratorBlockEntity.java'
+            include '**/VanillaStructureSetLookup.java'
+            include '**/VanillaOverworldBiomeSource.java', '**/ModBiomeSources.java'
+            include '**/*Monolith*.java', '**/CementFluid*.java'
+            include '**/Mun*.java', '**/CraterDensityFunction.java', '**/ModDensityFunctionTypes.java'
+            include '**/OrbitalSky*.java', '**/ClientLevelMixin.java'
+            include '**/OverworldLike*.java', '**/MinecraftServerAccessor.java', '**/WormholeNetwork.java', '**/ModDamageTypes.java'
+            include '**/CelestialTravelManager.java', '**/CelestialBackGate*.java', '**/CelestialForgingAnvilPortalBlockEntity.java'
+            include '**/CelestialBodyInfoFormatter.java'
+            include '**/CelestialBodyRenderer.java', '**/CelestialBodyTextureBakery.java', '**/SpecialCelestialBodyRecipeLoader.java'
+            include '**/SpecialCelestialBodyData.java', '**/SpecialCelestialBodyRecipe.java', '**/CelestialTravelData.java'
+            include '**/DysonSphereHandler.java', '**/BaseMegastructureHandler.java', '**/GiantPlanetData.java', '**/CelestialBodyMatcher.java', '**/ModMegastructures.java', '**/CelestialForgingAnvilFluidInterfaceBlockEntity.java'
+            include '**/AcceleratorHandler.java', '**/CelestialForgingAnvilBlockEntity.java', '**/StarData.java', '**/CelestialBodyData.java', '**/CelestialBodyClass.java', '**/CFARenderState.java', '**/FullBrightNoOpLighter.java'
+            include '**/QuenchedOut*.java', '**/IMegastructureHandler.java', '**/CfaMegastructureManager.java', '**/WormholeStabilizerHandler.java', '**/ModSoundEvents.java', '**/ModSoundDefinitionsProvider.java'
+            include '**/CelestialMapsGuideWidget.java', '**/CelestialForgingAnvilScreen.java', '**/CfaPreviewPipRenderer.java', '**/CelestialShellRenderer.java'
+            include '**/Stellar*.java', '**/PhaseNode.java', '**/CelestialMassTable.java', '**/CelestialForgingAnvilMenu.java', '**/ReloadEventListener.java'
+            include '**/PlanetAtmosphereRenderer.java', '**/StellarEmissionRenderer.java', '**/StellarRadiance.java', '**/StellarVisualState.java'
+            include '**/CelestialForgingAnvilItemRenderer.java', '**/CelestialAnvilItemExtensions.java', '**/CFARenderer.java'
+            include '**/CelestialForgingAnvilBlock.java', '**/CelestialForgingAnvilBlockItem.java', '**/CelestialAnvilPickDataMixin.java'
+            include '**/ItemDetectorMenu.java', '**/ItemDetectorScreen.java'
+            include '**/AutoEnchanting*.java', '**/PrimerEnchantmentsEvent.java', '**/FluidHandlerWrapper.java'
+            include '**/ClientModFluidModels.java', '**/LiquidEnchantmentClientFluidTypeExtension.java', '**/LiquidEnchantmentUtil.java'
+            include '**/FluidDisplayWidget.java', '**/TransparentItemRenderer.java', '**/FluidUtil.java', '**/AnvilMenuResult.java'
+            include '**/WheelGuiBlurMixin.java', '**/GuiBlurBoundaryAccessor.java', '**/WheelWidgetMixin.java'
+            include '**/WheelBackgroundCapture.java', '**/WheelBackgroundFrameMixin.java', '**/WheelFrostedBackgroundMixin.java'
+            include '**/LensBlock.java'
+            include '**/WheelLifecycleEventListener.java'
+            include '**/DragonRodItem.java', '**/SwitchDragonRodProtectContainersPacket.java', '**/DevourUtil.java'
+            include '**/DevouringLevelReader.java', '**/BlockDevourerBlock.java'
+            include '**/ResonanceMiningClientEventListener.java', '**/ItemDefaultComponentsEventListener.java', '**/Multiphase.java'
+            include '**/TranscendenceHeavyHalberdItem.java', '**/TranscendenceAnvilHammerItem.java'
+            include '**/ResonatorItem.java', '**/TranscendenceResonatorItem.java', '**/ResonatorItemTypeMixin.java'
+            include '**/WeaponChargeProgressPacket.java'
+            include '**/EnergyWeapon*.java', '**/EnergyReload*.java', '**/SpectralWeaponLauncherItem.java'
+            include '**/ICapacitorChargeable.java', '**/IFullCapacitor.java', '**/WeatherproofChestplate*.java'
+            include '**/EquipmentChestModel.java', '**/EquipmentPoweredProperty.java', '**/EquipmentLayerTextureMixin.java'
+            include '**/IonoCraftBackpackItem.java', '**/IonoCraftBackpackToggleDescentPacket.java'
+            include '**/IonoCraftBackpackClientHandler.java', '**/CapacitorItem.java', '**/SuperCapacitorItem.java'
+            include '**/BufferBootsChargeHUD.java', '**/Pocket*.java', '**/CreativePocket*.java'
+            include '**/EquipmentLeggingsModel.java', '**/EquipmentPocketLockMixin.java', '**/SlotPositionAccessor.java'
+            include '**/ArmorSlotMixin.java', '**/InventoryMenuMixin.java', '**/JeiPocketEffectAreaMixin.java', '**/SwapPocketPacket.java'
+            include '**/Atmosphere*.java', '**/ModLevelKeys.java', '**/GravityManager.java'
+            include '**/EntityMixin.java', '**/ItemEntityMixin.java', '**/ExperienceOrbMixin.java', '**/FallingBlockEntityMixin.java'
+            include '**/projectile/AbstractArrowMixin.java', '**/projectile/AbstractHurtingProjectileMixin.java', '**/projectile/ThrowableProjectileMixin.java'
+            include '**/api/amulet/AmuletManager.java', '**/item/property/component/amulet/*.java', '**/Comrades.java'
+            include '**/ComradeAmuletItem.java', '**/ModAmulets.java', '**/BoxContents.java'
+            include '**/BoxSelection*.java', '**/PillSelectorSupport.java', '**/AmuletSelectorSupport.java'
+            include '**/client/event/ClientEventListener.java'
+            include '**/BundleLike*.java', '**/InvertedActionEventListener.java', '**/PillBoxItem.java', '**/AmuletBoxItem.java'
+            include '**/PillBoxContents.java', '**/event/PlayerTickEventHandler.java'
+            include '**/data/lang/CategoryLang.java'
+            include '**/ReadOnlyItemResourceHandler.java', '**/ModCapabilities.java'
+            include '**/recipe/frost/*.java', '**/FrostSmithingMenu.java', '**/FrostSmithingTransfer.java', '**/FrostRecipeTransferHandler.java', '**/FrostSmithingCategory.java', '**/SpiderMixin.java'
+            include '**/FrostSmithingScreen.java', '**/SmithingPreview.java', '**/PermutationTemplateItem.java', '**/DeformationRecipeLoader.java'
+            include '**/PermutationRecipeLoader.java', '**/FrostSmithingPackets.java', '**/ModFrostMaterialPredicateTypes.java', '**/ModMathFunctions.java'
+            include '**/AdjacentSmithingMenu.java', '**/EmberSmithingMenu.java', '**/TranscendenceSmithingMenu.java'
+            include '**/SmithingServerStub.java', '**/SmithingRecipeTransferHandler.java', '**/JeiSmithingTransferMixin.java'
+            include '**/MultipleToOneSmithingCategory.java'
+            include '**/TerminalSnapshotLoader.java', '**/TerminalJei*.java', '**/JeiBasicRecipeTransferHandlerMixin.java'
+            include '**/TerminalInsertionDecoration.java', '**/event/TooltipEventListener.java', '**/client/AnvilCraftClient.java'
+            include '**/TerminalReachabilityCache.java', '**/TerminalRemoteOverlay.java', '**/TerminalOverlayEventListener.java'
+            include '**/TerminalKeyMappingEventListener.java', '**/ModKeyMappings.java', '**/KeyMappingLang.java'
+            include '**/PlayerBalanceHandler.java', '**/TerminalBalanceModePacket.java'
+            include '**/TerminalUpgradeRecipe.java', '**/TerminalUnbindRecipe.java', '**/data/lang/MessageLang.java'
+            include '**/TerminalSessions.java', '**/TerminalItem.java', '**/*TerminalItem.java', '**/TerminalBinding.java'
+            include '**/StorageTerminal*Stub.java', '**/BalanceMode.java', '**/HyperdimensionStorageStationBlock.java'
+            include '**/TerminalSourceManager.java', '**/block/entity/storage/StorageBlockEntity.java'
+            include '**/event/LevelEventListener.java', '**/event/ServerLifecycleEventListener.java'
+            include '**/StorageRecipeTransferPlan.java', '**/StorageJeiBridge.java', '**/StorageJeiSupport.java'
+            include '**/StorageSetting.java', '**/SettingClientStub.java', '**/SettingServerStub.java', '**/CategorySettingsScreen.java'
+            include '**/StorageServerStub.java', '**/StorageClientStub.java', '**/StorageInput.java', '**/StorageScreen.java', '**/StorageMenu.java'
+            include '**/FluidAmountUtil.java'
+            include '**/StructureScannerRecipe*.java'
+            include '**/StructureLoadUtil.java', '**/StructureDisk*Packet.java', '**/StructureDiskPreviewSupport.java'
+            include '**/item/utility/DiskItem.java', '**/StructureDiskData.java'
+            include '**/recipe/multiblock/Multiblock*.java', '**/IMultiblockRecipe.java', '**/LevelLikeDisplaySupport.java'
+            include '**/GiantAnvilLandingEventListener.java'
+            include '**/BlockStatePredicateMixin.java'
+            include '**/FittedItemRenderer.java', '**/FilterItemRenderer.java', '**/DiskItemRenderer.java', '**/DiskDisplaySupport.java'
+            include '**/FormattingUtil.java', '**/ItemResourceHelper.java'
+            include '**/unlimited/UnlimitedItemStacksResourceHandler.java'
+            include '**/saved/storage/*Storage.java'
+        } + fileTree('dev/porting/java')
+        classpath = files()
+        maxWarnings = 0
+        reports {
+            xml.required = true
+            html.required = true
+        }
+    }
+}