Litematica

• Bump 1.21.8

• fix: a material list 'missing' count was missing
• update: Allow material list to have better error control when a player Inventory is not available.
• add: material list player inventory scan to support nested Bundles.
• add: defaultSelectionMode for selecting the default mode when loading a server, world/dimension for the first time.
• update: remove default renderThrough (Without holding the renderThrough Hotkey) for Schematic Verifier, and Single Overlapping Selection Box.
• feat: 'Raw Material List' outputs in JSON format. This is very complex new code that should be considered BETA at this state. Please test this feature against your schematics for accuracy and post discrepancies / questions under Issues.

NOTE: The Raw Material List output REQUIRES the Recipe's to be unlocked before the results show properly. I have tried code to "Shadow Unlock" recipe's for it to only cause problems with other people's mods; so I removed it.

• GuiSchematicSaveBase: Change a couple of text field method usages
  • This is related to a fix for Lunar compatibility (that fix also needs malilib 0.18.3-alpha.1 or later, and the changes in that malilib version need the changes in this Litematica release)

Original build time: 2025-07-15 19:25:13 +0300

• 1.21.7 (Supports 1.21.6)

• Port to 1.21.6
• REMOVE schematicOverlayEnableResorting.
• REMOVE schematicVerifierUseBlockModels -- because it is not currently able to be ported to 1.21.6.

• Update EntityDataStorage to be in line with MiniHUD / Tweakeroo.
• REMOVE schematicOverlayEnableResorting.

NOTE: This is the source of more recent crashes under 1.21.5+.

• Update EntityDataStorage to be in line with MiniHUD / Tweakeroo.
• Disable schematicOverlayEnableResorting by default.

NOTE: This is the source of more recent crashes under 1.21.5+.

• fix: entityDataSyncBackup mode not querying for data
• fix: Skull Profile parsing for 1.20.4 (V6) Export tool (Downgrade) to better support Vanilla Tweaks' More Mob Heads Data Pack.
• fix: Padding for Manual Origin for langs with narrow widths such as Chinese in the Area Selection screen.
• fix: reading file metadata while browsing files
• various i18n language updates; primarily for Chinese & Korean.

• Port to 1.21.5
• See Sakura's Github / JavaDocs for Changelogs; a lot has changed, particularly with Rendering Topics.

• Placement Configs: Fix the origin text field inputs not taking effect
  • Note: This change requires malilib 0.60.2+
• Placement Configs: Fix Reset Sub-Region not working in sub-region configs

Original build time: 2025-04-02 18:35:27 +0300

critical fix: Server Task Scheduler not in mixins.litematica.json (due to work under 1.21.3+ based on attempting to fix Lunar)

• various lang file updates (For contributing, see Sakura Ryoko Translate)
• feat: schematicVcsDeleteMode and related hotkey / config for the VCS system by @maruohon 's upstream branch
• Cleanup entityDataSync cache timings, convert it into a Boolean Hotkey, & make the config disabled by default.
• add a small MinecraftDataVersion warning message when loading a schematic more than +100 Schema ID's ahead of your current version of Minecraft. This is important since Mojang is adding a lot more Data Components and stuff under the 1.21.5+ snapshot particularly for Equipment and Entity Data.
• Sync up various MaLiLib-based fixes including the NbtUtils, etc fixes.
• fix: Litematic Preview Image ARGB color swaps & Scaling of image.
• migrate some configs to a newer Path-based system capable of reading / writing files using Unicode characters, such as when using Chinese world names.

Note: that for Litematica; this fix is very extensive so it will be added in all future Minecraft version releases for all files; because there are many GUI elements that Litematica uses that are hard-tied to the old 'File' system; and these changes will HARD BREAK all previous versions, and perhaps many dependent mods for anything related to loading and saving Litematic files, so I will save the full fix for 1.21.5+ (It's already been completed in SNAP)

• fix: info overlay background, & add Jade compat class for adjusting Info Overlay Box slightly lower so it clashes less with the Jade box.
• Adjusts schematicOverlayEnableResorting and schematicOverlayModelSides defaults to TRUE.
• Update Schematic 1.20.4 Downgrade converter to add new 1.21.5+ Entity Equipment handling, and a few other minor entity NBT fixes and tag renames.
• Improve Vanilla Profiler data points (F3+1 pie chart) for properly tracking statistics.
• fix / enhancement: Importing Sponge & Vanilla structure files by using temporary Schematic Worlds & add Schematic Descriptions / additional Metadata when using the Import function.
• feat: enableDifferentBlocks system for highlighting blocks in the Schematic in a new Overlay Color when they are in the same Block Tags Group. It is recommended to disable this feature when not in use, as it will add to the overall Overlay Computation time during Litematic Rendering; and as you know, this process can already be someway laggy depending on the size of your build.

Note: that this feature isn't foolproof, and not configurable as Block Tags are generated ahead of mod compile time using MaLiLib. In the future it may be able to make use of a "List" type of config for including or excluding various Block Tags. When enabled, this system also is presented in the Schematic Verifier as it's own Group separated from WRONG_STATE or WRONG_BLOCK. It will display WRONG_STATE if the Block Placed is in the same Block Tags Group; but the Block State is wrong instead of simply showing WRONG_BLOCK like it would originally. To disable this functionality, simply disable enableDifferentBlocks to return to the original functionality.

• update entityDataSync cache requeue system & add checks for OP.
• feat: add a toggle for the Fake Lighting provider enableSchematicFakeLighting, and Fake Lighting Level renderFakeLightingLevel -- please read the config comments.
• fix: the blocked loading of Sponge files without a proper BlockEntities tag.

NOTE: This will be the last feature build for 1.21, as I will referr it as being LTS

• various lang file updates (For contributing, see Sakura Ryoko Translate)
• feat: schematicVcsDeleteMode and related hotkey / config for the VCS system by @maruohon 's upstream branch
• Cleanup entityDataSync cache timings, convert it into a Boolean Hotkey, & make the config disabled by default.
• add a small MinecraftDataVersion warning message when loading a schematic more than +100 Schema ID's ahead of your current version of Minecraft. This is important since Mojang is adding a lot more Data Components and stuff under the 1.21.5+ snapshot particularly for Equipment and Entity Data.
• Sync up various MaLiLib-based fixes including the NbtUtils, etc fixes.
• fix: Litematic Preview Image ARGB color swaps & Scaling of image.
• migrate some configs to a newer Path-based system capable of reading / writing files using Unicode characters, such as when using Chinese world names.

Note: that for Litematica; this fix is very extensive so it will be added in all future Minecraft version releases for all files; because there are many GUI elements that Litematica uses that are hard-tied to the old 'File' system; and these changes will HARD BREAK all previous versions, and perhaps many dependent mods for anything related to loading and saving Litematic files, so I will save the full fix for 1.21.5+ (It's already been completed in SNAP)

• fix: info overlay background, & add Jade compat class for adjusting Info Overlay Box slightly lower so it clashes less with the Jade box.
• Adjusts schematicOverlayEnableResorting and schematicOverlayModelSides defaults to TRUE.
• Update Schematic 1.20.4 Downgrade converter to add new 1.21.5+ Entity Equipment handling, and a few other minor entity NBT fixes and tag renames.
• Improve Vanilla Profiler data points (F3+1 pie chart) for properly tracking statistics.
• fix / enhancement: Importing Sponge & Vanilla structure files by using temporary Schematic Worlds & add Schematic Descriptions / additional Metadata when using the Import function.
• feat: enableDifferentBlocks system for highlighting blocks in the Schematic in a new Overlay Color when they are in the same Block Tags Group. It is recommended to disable this feature when not in use, as it will add to the overall Overlay Computation time during Litematic Rendering; and as you know, this process can already be someway laggy depending on the size of your build.

Note: that this feature isn't foolproof, and not configurable as Block Tags are generated ahead of mod compile time using MaLiLib. In the future it may be able to make use of a "List" type of config for including or excluding various Block Tags. When enabled, this system also is presented in the Schematic Verifier as it's own Group separated from WRONG_STATE or WRONG_BLOCK. It will display WRONG_STATE if the Block Placed is in the same Block Tags Group; but the Block State is wrong instead of simply showing WRONG_BLOCK like it would originally. To disable this functionality, simply disable enableDifferentBlocks to return to the original functionality.

• fix: Missing BlockStateFlattening conversion maps. This will solve the "my old Schematica type file won't load!" issue.
• fix Sodium / Shaders compat.
• fix player == null crashes (?) -- now checks for this condition before trying player.getInventory() calls.
• fix unloading of placements not resetting the verifier.
• update entityDataSync cache requeue system & add checks for OP.
• feat: add a toggle for the Fake Lighting provider enableSchematicFakeLighting, and Fake Lighting Level renderFakeLightingLevel -- please read the config comments.
• fix: the blocked loading of Sponge files without a proper BlockEntities tag.

• various lang file updates (For contributing, see Sakura Ryoko Translate)
• feat: schematicVcsDeleteMode and related hotkey / config for the VCS system by @maruohon 's upstream branch
• Cleanup entityDataSync cache timings, convert it into a Boolean Hotkey, & make the config disabled by default.
• add a small MinecraftDataVersion warning message when loading a schematic more than +100 Schema ID's ahead of your current version of Minecraft. This is important since Mojang is adding a lot more Data Components and stuff under the 1.21.5+ snapshot particularly for Equipment and Entity Data.
• Sync up various MaLiLib-based fixes including the NbtUtils, etc fixes.
• fix: Litematic Preview Image ARGB color swaps & Scaling of image.
• migrate some configs to a newer Path-based system capable of reading / writing files using Unicode characters, such as when using Chinese world names.

Note: that for Litematica; this fix is very extensive so it will be added in all future Minecraft version releases for all files; because there are many GUI elements that Litematica uses that are hard-tied to the old 'File' system; and these changes will HARD BREAK all previous versions, and perhaps many dependent mods for anything related to loading and saving Litematic files, so I will save the full fix for 1.21.5+ (It's already been completed in SNAP)

• fix: info overlay background, & add Jade compat class for adjusting Info Overlay Box slightly lower so it clashes less with the Jade box.
• Adjusts schematicOverlayEnableResorting and schematicOverlayModelSides defaults to TRUE.
• Update Schematic 1.20.4 Downgrade converter to add new 1.21.5+ Entity Equipment handling, and a few other minor entity NBT fixes and tag renames.
• Improve Vanilla Profiler data points (F3+1 pie chart) for properly tracking statistics.
• fix / enhancement: Importing Sponge & Vanilla structure files by using temporary Schematic Worlds & add Schematic Descriptions / additional Metadata when using the Import function.
• feat: enableDifferentBlocks system for highlighting blocks in the Schematic in a new Overlay Color when they are in the same Block Tags Group. It is recommended to disable this feature when not in use, as it will add to the overall Overlay Computation time during Litematic Rendering; and as you know, this process can already be someway laggy depending on the size of your build.

Note: that this feature isn't foolproof, and not configurable as Block Tags are generated ahead of mod compile time using MaLiLib. In the future it may be able to make use of a "List" type of config for including or excluding various Block Tags. When enabled, this system also is presented in the Schematic Verifier as it's own Group separated from WRONG_STATE or WRONG_BLOCK. It will display WRONG_STATE if the Block Placed is in the same Block Tags Group; but the Block State is wrong instead of simply showing WRONG_BLOCK like it would originally. To disable this functionality, simply disable enableDifferentBlocks to return to the original functionality.

• fix: Missing BlockStateFlattening conversion maps. This will solve the "my old Schematica type file won't load!" issue.
• fix Sodium / Shaders compat.
• fix player == null crashes (?) -- now checks for this condition before trying player.getInventory() calls.
• fix unloading of placements not resetting the verifier.
• update entityDataSync cache requeue system & add checks for OP.
• feat: add a toggle for the Fake Lighting provider enableSchematicFakeLighting, and Fake Lighting Level renderFakeLightingLevel -- please read the config comments.
• fix: the blocked loading of Sponge files without a proper BlockEntities tag.

NOTE: This will be the last feature build for 1.21.3, as I will referr it as being LTS

PLEASE USE 0.19.57