1.20.4 Update

This patch is pretty straightforward -- a simple update to 1.20.4 MrNavaStar. I've also cleaned up some of the base build code.

Not much has changed in the main repo for this update because I've been focused on re-writing the world exporter in a separate repository.

Bugfixes and Stability

There aren't many user-facing features in this update, but it contains numerous critical fixes and backend improvements. The most prominent is the major rewrite of some of the base model adapters, greatly improving entity renderer compatibility.

Changes

• Update to 1.20.1

  Special shoutout to MrNavaStar for pulling the heavy lifting for this update! As with most Minecraft updates, there were a variety of underlying changes to address, and he did a superb job.

• Base model adapters were improved, leading to much better compatibility with complex models.

  • Moved shared logic from AnimalModelAdapter and SinglePartModelAdapter into single parent class.

  • Fixed mathematical mistakes regarding the coordinate space of child model parts. As a result, many previously broken entities (such as horses) are now fixed.

  • Exporter now respects model part visibility.

  • Proper fix for y-offset issue.

  • Re-organized model adapter files in the repo.

• Fixed a critical issue where block colors would appear black when imported into Blender 3.5+.

A Critical Bug

There is currently an issue in some versions of Blender where updated blocks will appear in the wrong place. As far as I can tell, this is an issue with Blender itself, and I'm still unable to determine how to fix it.

If this happens, simply save your file and re-open it. This is a problem with the render cache, therefore reloading the file is a reliable resolution.

The Anti-Jank Update (Part 2)

This update builds on the groundwork released in 0.7.0 to make a better overall user experience. This includes a complete re-write of the export UI, and various quality of life improvements. The exporter is no-longer reliant on single "radius" and "lower depth" sliders. Instead, a new Bounds Editor allows the user to customize their export region with chunk-level precision.

Additionally, the replay export screen now saves the export settings to disk for re-use, just like the video export screen.

Changes

• UI Overhaul
  • Re-wrote the export settings screen from scratch.
  • Added new Bounds Editor for easy export region selection.
  • Export screen is now an actual screen rather than a popup.
  • Export settings now get saved to file.
  • Re-organized all UI code.
• Bug Fixes
  • Fixed crash when exporting replays containing shulkers.
  • Bullshit workaround for issue regarding player skin loading.
  • Fixed incorrect shield texture in export.
  • Fixed crash when previous replay export directory is no longer valid.
• Misc
  • Updated world exporter to use bounding box rather than radius/lower depth internally.
  • Replaced (broken) fluid exporter with a prototype one that works with multithreading.
  • Made vcap exporter use section coordinates all the way through the export pipeline.
  • Living model adapters can now write custom material behavior.
  • Naming scheme for unknown bones in animal model adapter is now somewhat deterministic. It no longer calls Java's native toString method, which uses the object's internal location in memory.
  • Properly marked incompatibility with Sodium.

The Anti-Jank Update (Part 1)

This update is quite ambitious, so I had to pull a Caves and Cliffs and split it into two. 0.7.0 lays the technical groundwork for 0.8.0, which will be focused on the UI and making a better user experience.

In this update, the world exporter has been almost completely re-written. If you've been following the GitHub repo, this is what's been happening in the async_world_capture branch.

The new exporter is written in a way such that it can be executed off of the main thread, with all block updates during the export being properly accounted for. This works using a proxy, "snapshot" object, which uses a client-side block update detector to create a thread-safe view of the world at a given time, without any overhead upon creation. This means that, along with some internal optimizations, the initial world exporter can now operate concurrently with the frame exporter to improve export times and make the UI more responsive.

Additionally, the export pipeline has been re-written as to not piggyback off of the Replay Mod's render pipeline. A custom pipeline that's built for the unique needs of the replay exporter rather than a video exporter significantly improves code cleanliness and paves the way for better UI clarity (some of which is already implemented.)

I also updated the mod to 1.19.3 because some people were asking for that.

Changes

• Updated to 1.19.3

  • Removed Joml as a jar-in-jar dependency as that's now provided by Minecraft.

  • Updated model adapters to use Joml types where relevant.

• Overhauled world exporter

  • Wrote ChunkView abstract class which represents a block view that declares which chunks are loaded.

  • All Vcap capture classes now use this ChunkView abstraction, allowing them to be used on things other than World instances.

  • Created WorldSnapshot class, a thread-safe view of a world at a specific point in time.

  • World exporter works asynchronously, exporting chunks in parallel to drastically improve export time.

• Re-wrote replay export pipeline

  • Created new ReplayExporter, an adaption of VideoRenderer designed specifically for exporting replays.

  • Removed all the janky workarounds that were in use to get VideoRenderer to export replays.

  • Implemented backend for better UI feedback about export "phases." This replaces the prints to console that were in use before.

  • Fixed an issue where entities wouldn't export properly if the export region started at the very beginning of the replay.

  • Fixed an issue where player skins wouldn't export if the playhead was in the middle of the export region.

  • Moved replay finalization and serialization off of the main thread.

• Small UI update

  • New export progress screen displays world export progress as well as replay export progress.

  • Added warning about the fluid exporter's memory issues to export screen.

• Misc.

  • Made the Blender addon camera export start at frame zero, regardless of the starting frame.

• Fixed an issue where updates to the player's crouch state would not get exported.

• Made the exporter encode the mod version into the replay metadata.

• Added model adapter for arrow entities (model by TheDuckCow)

• Added a cache in the vcap context for fluid meshes. In practice, this means that the 1x1 lava pockets in the nether won't spam the file with thousands of identical meshes.

• Added model adapters for Wither Skeleton and Stray.
• Bandaid fix on an issue where entities with single part models would appear 1.5 blocks too low.

The Material Update

The primary focus of this update is to improve the world texture/material pipeline. This not only includes animated textures and better-looking materials by default, but a complete overhaul to the internal asset management system to make it more versatile overall.

Warning: This release updated the Vcap and Replay specifications. Older versions of the Blender addon may not be able to import files from newer versions of the mod!

Changes

• Re-organized Vcap export context

  • Instead of being hard-coded to save world materials and textures, export context now contains a "material provider" system which can save an arbitrary amount of materials and textures.

  • The same goes for models. Model entries have been replaced by model providers (which BlockModelEntry is a subclass of) that supply their own mesh writing function.

• Updated ReplayTexture

  • Replay textures may now specify "dependency" textures, which are written to disk alongside the primary texture.

    • Used for animated textures.

  • Added prepare() method to execute pre-serialization functions (such as GPU texture extraction) asynchronously.

  • Wrote TextureSerializer utility class that unifies the code of writing textures to Vcap and Replay zip files.

  • NativeImage extractor now uses a byte array rather than saving and reading from disk.

• Added support for emission in the Unified Material System.

  • emission and emission_strength fields.
  • Emissive blocks are properly exported.

• Exporter now supports animated textures

  • Unified Material System now includes a specification for animated textures.

  • Blocks with animated textures are given their own materials rather than using the atlas.

    • Detection and extraction of spritesheet.

  • Implemented spritesheet decoding in Blender

• Fixed an issue in the Blender addon where materials in subdirectories of a Vcap would not be imported properly.