Litematica

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

• fix: Convert all Pair objects to Apache Commons.

• fix: Convert all Pair objects to Apache Commons.

NOTE: Release was tagged as 0.19.54 incorrectly.

• Add Sponge Schematic v3 (.schem) support (by Sakura-Ryoko)
• Fix Redstone Wire Dot Block State from previous DataVersions (by Sakura-Ryoko)
• Fix Item Frame floor / ceiling Yaw values (by Sakura-Ryoko)
• Add a "delete blocks by placement" feature and hotkey for the VCS
• Fix VCS not keeping track of file extensions (by emilyavi)

Original build time: 2024-12-29 00:28:26 +0200

• Add Italian, & Ukrainian from Humans
• Add File Info for when you are browsing Sponge and Vanilla Structure files.
• fix: InfoOverlay getting confused with the ClientWorld
• feat/fix: add switchable AO Processor config,renderAOModernEnabled in order to disable / enable the 'new' AO Processor code; or continue using the older code from 2018 without the "Shadows" that it creates in between block layers.
• fix: Info Overlay not being able to see Empty Block Entities.
• Update Chinese lang files, thanks to @DreamingLri and @snowlinouo, and @zly2006
• feat: renderInfoOverlay Hotkey is now defaulted to allow an Empty Keybinding to match the Config Comment; this allows you to 'empty' the key bind, and have Info Overlay to always be active.
• Includes Config Gui Registration code
• fix: Easy Place Protocol not applying all possible rotation Directional Block States.
• fix: Easy Place V3 for AXIS BlockStates; meaning this fixes Logs, Froglights, Basalt, Hyphae, etc.
• fix: The Info Overlay within the Materials List sometimes gets overwritten by the Ignore button. There are other instances of this that were also fixed.
• fix: Invalid Stair Shape's when Mirroring Schematics with Stair Corners, using the config fixStairsMirror. This is simillar to the fixRailRotation that fixes Vanilla bugs in their Rotation / Mirroring code.
• feat: Make it so that the entityDataSyncBackup mode is capable of saving Litematics with Server-side NBT data, similar to how Servux functions.

NOTE: This requires Litematica 'marking' your game session as safe to do so before hand. It does this by marking it safe after Requesting and Receiving a QueryNBT packet successfully. You can do this by going up to any simple Chest and pressing I (Info Overlay) once. This is because the operation involves potentially dozens of Packets being sent without OP status and that can be problematic, and can cause long delays in saving your Litematic without having OP.

SHADERS COMPAT: Not currently working with Schematic Rendering.

• Add Italian, & Ukrainian from Humans
• Add File Info for when you are browsing Sponge and Vanilla Structure files.
• fix: InfoOverlay getting confused with the ClientWorld
• feat/fix: add switchable AO Processor config,renderAOModernEnabled in order to disable / enable the 'new' AO Processor code; or continue using the older code from 2018 without the "Shadows" that it creates in between block layers.
• fix: Info Overlay not being able to see Empty Block Entities.
• Update Chinese lang files, thanks to @DreamingLri and @snowlinouo, and @zly2006
• feat: renderInfoOverlay Hotkey is now defaulted to allow an Empty Keybinding to match the Config Comment; this allows you to 'empty' the key bind, and have Info Overlay to always be active.
• Includes Config Gui Registration code
• fix: Easy Place Protocol not applying all possible rotation Directional Block States.
• fix: Easy Place V3 for AXIS BlockStates; meaning this fixes Logs, Froglights, Basalt, Hyphae, etc.
• fix: The Info Overlay within the Materials List sometimes gets overwritten by the Ignore button. There are other instances of this that were also fixed.
• fix: Invalid Stair Shape's when Mirroring Schematics with Stair Corners, using the config fixStairsMirror. This is simillar to the fixRailRotation that fixes Vanilla bugs in their Rotation / Mirroring code.
• feat: Make it so that the entityDataSyncBackup mode is capable of saving Litematics with Server-side NBT data, similar to how Servux functions.

NOTE: This requires Litematica 'marking' your game session as safe to do so before hand. It does this by marking it safe after Requesting and Receiving a QueryNBT packet successfully. You can do this by going up to any simple Chest and pressing I (Info Overlay) once. This is because the operation involves potentially dozens of Packets being sent without OP status and that can be problematic, and can cause long delays in saving your Litematic without having OP.

SHADERS COMPAT: Not currently working with Schematic Rendering.

• Add Italian, & Ukrainian from Humans
• Add File Info for when you are browsing Sponge and Vanilla Structure files.
• fix: InfoOverlay getting confused with the ClientWorld
• feat/fix: add switchable AO Processor config,renderAOModernEnabled in order to disable / enable the 'new' AO Processor code; or continue using the older code from 2018 without the "Shadows" that it creates in between block layers.
• fix: Info Overlay not being able to see Empty Block Entities.
• Update Chinese lang files, thanks to @DreamingLri and @snowlinouo, and @zly2006
• feat: renderInfoOverlay Hotkey is now defaulted to allow an Empty Keybinding to match the Config Comment; this allows you to 'empty' the key bind, and have Info Overlay to always be active.
• Includes Config Gui Registration code
• fix: Invalid Stair Shape's when Mirroring Schematics with Stair Corners, using the config fixStairsMirror. This is simillar to the fixRailRotation that fixes Vanilla bugs in their Rotation / Mirroring code.
• feat: Make it so that the entityDataSyncBackup mode is capable of saving Litematics with Server-side NBT data, similar to how Servux functions.

NOTE: This requires Litematica 'marking' your game session as safe to do so before hand. It does this by marking it safe after Requesting and Receiving a QueryNBT packet successfully. You can do this by going up to any simple Chest and pressing I (Info Overlay) once. This is because the operation involves potentially dozens of Packets being sent without OP status and that can be problematic, and can cause long delays in saving your Litematic without having OP.

• Removed Crowdin files

This is due to the unpopularity of Machine Translations. If you want a language supported, translate it and post under Sakura's Litematica Issues -- With that said, if you wish to become more of a permanent language translator for these mods, I can invite you to my crowdin account. Until then, any Machine translations that I could find / recall from recent memory have been removed; which will also revert some existing lang files, such as various additions under Chinese to English until I can gain that support more consistantly. Note that as various configs get added to the mod, this will also mean that languages without a proper human maintainer WILL NOT BE FULLY TRANSLATED. I have tried and spent my own money on these Crowdin projects in order to be more open for more of the top 30 languages to be represented, only for this to be the result due to the poor quality of Machine Translations. I assume that you understand that it's better to have NO translation instead of a poor translation.

• Port to 1.21.3
• Note that various Shader changes from Vanilla effects the Schematic World.
• Updates the SchematicBlockModelRenderer with modern AO code that processes both Light Levels and Dimension/Fog types. This should add "Shadows" to the schematics, which is much more obvious in Layer Mode.

• Add apply() i18n handling for configs from the 1.21.2+ code.
• Add entityDataSyncCacheTimeout to be able to adjust the EntityCache ticks. Note, that for Litematica, the length of these ticks can be much longer; especially when using Servux to save litematics. For large builds, you may need to adjust this value for your needs in order to ensure all NBT data is saved.
• Adds various Crowdin-based lang files. Please report issues and fixes to my GitHub.

• Code merges from Development Branch (1.21.3+) particularly for the EntityDataSync and Info Overlay code.
• Rewrite of the EntityDataSync Cache that is used for the Info Overlay, and Saving Litematics using the Cache.
• Info Overlay code now makes use of the OverlayContext system which is simillar to the other implementations of inventoryPreview, using NBT tags whenever possible.
• Other various Bug fixes and polish related to Iris / Shader support.
• Adds enableSchematicFluidRendering to be able to disable Fluid rendering.
• Fixes the Import .schem file code to function correctly.
• Adds V6 (1.20.4) Litematic downgrade tool and Litematic Version / Schema display in File Browser.
• fixes vanilla breaking "unpowered/unconnected" redstone wires in uncommon situations.
• Requires MaLiLib 0.21.1

Another update by Sakura-Ryoko, zly2006 and other contributors

0.19.2

• fix: vanilla breaking "unpowered/unconnected" redstone wires in uncommon situations.
• Added and tested V6 Export features in 1.20.4. Lore and Custom Names / Entity Attributes, etc have been tested more in depth.

All remaining Data Components added to the Downgrade Tool; such as Maps, Projectiles, Pots/Brewing, Suspicious Stews, Horns, and Armor Trims are now all supported as well. Only one that I didn't outright test is the "loot_table" Data Component; but who cares about that one? The code exists to convert it anyways in case someone wants that in their V6 litematic for some reason.

To use the V6 1.20.4 Export feature, access it using the Schematic Manager, and select the correct option, and pick the name of the litematic to save.

0.19.2-alpha.1

• Experimental V6 Litematic Export Tool added (Access from SchematicManager). Not all NBT is supported, but this revision should cover the most common tags. Alpha designation due to the complexity of this feature.
• NBT Supported thus far:
  • Item/Items (Entity / TE)
  • HandItems/ArmorItems/Inventory (Entity)
  • Attributes (Entity) --> Needs some testing, as some Modifer tags don't specifically transfer easily.
  • Bees
  • Banners
  • 'Block State' (Primarily used for Beehives?)
  • Books / Lectern / Bookshelves
  • Bundles
  • Custom Data (Other)
  • Custom Name --> Needs additional testing
  • Custom Model Data
  • Damage
  • Enchantments (Entity /TE)
  • Stored Enchantments (Such as for Enchanted Books)
  • Lore --> Needs additional testing
  • Fireworks
  • Records
  • SkullOwner

0.19.1

• Update EasyPlace to accept BlockReach values higher than 6 (via Tweakeroo, etc)
• Add toolItemComponents to accept a Data Component /give string for your Tool Item; such as having a CustomName on a stick. Setting this to empty disables this functionality. EXAMPLE: stick[minecraft:custom_name="TOOL"]

0.18.999-sakura.29

• Entity Data Sync Protocol was missing from the Info Overlay Renderer.

0.18.999-sakura.28

• Add a setting easyPlaceSwingHand to enable / disable the swinging of the Player's hand while using Easy Place

0.18.999-sakura.27

• Add Hotkey bindings for schematicRotate and schematicMirror
• Removed Russian, French, and Ukrainian translation files.
• Migrate to Masa's Maven for Malilib.

0.18.999-sakura.26

• Bump malilib to 0.20.0

0.18.999-sakura.25

• Additional 'Wall Torch' easy place fixes
• fix: Legacy 'Items' tags containing null 'tag' entries from 1.19.x

0.18.999-sakura.23/24

• more Easy Place Fix attempts.

0.18.999-sakura.22

• fix missing translation entries

0.18.999-sakura.21

• fix Redstone Torches & Chests via Easy Place Protocol (fixed my mms)
• fix Materials List sorting & not showing up when first opening the Materials List screen
• fix the Vanilla F1 key not disabling the Litematica HUD objects.

0.18.999-sakura.20

• fix: Servux paste for Sub Regions (Requires Servux 0.3.3)
• fix: Blocks not being rendered in Single Layer mode.
• REVERT --> Removed Schematic World Render Thread Factory in favor of the 'more stable' single thread sakura.4 render system with the Original ReentrantLock system. This change will eliminate the 'flashing sun and moon' and other rendering related instability problems. This change basically removes the 'testing' nature of the threaded rendering system that was originally put in by a third party via PR.
• Merge full translations features which adds a better Chinese translation. More translations to come, such as Spanish.
• Bump requires malilib sakura.8 based on Gradle 8.9, Loom 1.7, and FAPI 100.7

0.18.999-sakura.19

• Fix for missing Hopper and Horizontal Rotation Block States via AccuratePlacementProtocol

0.18.999-sakura.18

• fix: highlightBlockInInventory setting now works again after fixing a strange issue with the Vanilla Inventory Screen handling.
• feat: datafixerMode setting. This Setting allows a user to Disable or restrict the Vanilla Data Fixer code to Minecraft Data Versions below the X value. This is in order to help cut down on Schematic load times if a user intends to use this feature. But be advised that doing so can create SEVERE data loss if attempting to upgrade from anything below 1.20.5.
• feat: in order to help "smooth" over the transition to Version 7 Litematic's (Which basically means anything beyond 1.20.5+), You can now IMPORT a .litematic file from previous versions, and save it as a new file, or overwrite the old file using the SCHEMATIC MANAGER's IMPORT feature. But also, be advised that in doing so, the NEW files will not be readable by litematica for any versions BELOW 1.20.6.

0.18.999-sakura.17

• Reset some Default Visual settings as per Masa
• Restrict renderSchematicMaxThreads to 8. Setting it any higher can cause instability, but 2-4 is a good middle ground.
• Moved all rendering buffers to using ConcurrentHashMap instead of the regular HashMap methods.
• fix: Swinging of your hand while using EasyPlace

0.18.999-sakura.16

• Update accuratePlacementProtocol V3 to disallow invalid block placements.
• Update handling of Enabling / Disabling entityDataSync to unregister / re-register with Servux.

0.18.999-sakura.15

• Fix Litematics not Saving using ENTITY_DATA_SYNC via Servux. Litematica will now verify that the Chunks are loaded, and then give Servux 5 seconds for each Chunk to respond; or else save those Chunks without the Entity Data (Original behavior).
• Test Fix: for invalid Accurate Block Placement V3 in Single Player (More fixes coming later)

0.18.999-sakura.14

• Fix for the Invalid BlockState for Redstone Dots from previous MinecraftDataVersions

0.18.999-sakura.13

• Fix for paintingVariant Offset due to 1.21 changes to the Painting Variant methods.

0.18.999-sakura.12 - Another massive update!

• Adds Direct-to-Servux support for Litematica pasting and Saving schematics with Full Entity Data Sync capabilities, like pca-protocol, or Server Paster.
• Adds Servux V3 accuratePlacement Protocol Support, without needing Carpet Extra. This means that with Servux, Litematica should function as if you are in Single Player, (V3) mode.
• Fixes the issue when rotating litematic's with Floor / Ceiling mounted Item Frames.

0.18.999-sakura.11 & 10

• Fixes loading of older Litematic files that do not include the "id" tag under TileEntities
• sakura.11 adds additional Tile Entities to be fixed to the Fixer Code.

0.18.999-sakura.9

• Fixes "VOID_AIR" issue from Lithium's raycast code
• Updates to malilib sakura.4

0.18.999-sakura.8

• Fix easyPlaceProtocol for carpet extra servers; the carpet:hello packet wasn't showing up on the network handler interface. Note that this fix is only required if you don't have Carpet Mod installed on your client.

0.18.999-sakura.7

• Some polish for cleaning up rendering workers / buffers
• Bump for malilb

0.18.999-sakura.6

• Adds SCHEMATIC_OVERLAY_ENABLE_RESORTING to allow a user to try to disable the "translucent resorting" of the Overlays. It would help improve performance.
• *** REVERTED*** Changes "reduceInnerSides" to default: true

Original build time: 2024-08-20 20:53:46 +0300

Original build time: 2024-07-12 00:39:06 +0300

Original build time: 2024-07-11 18:51:03 +0300

Original build time: 2024-06-20 19:08:33 +0300