Gunwood

Gunwood Update

This update focuses on performance improvements, safer compatibility behavior, and better schematic support for painted/hidden blocks.

Performance Improvements

• Migrated Gunwood painted/hidden block storage from BlockPos sets to packed long position storage.
• Reduced overhead from BlockPos.hashCode() collisions when many blocks are hidden.
• Optimized high-frequency client lookups used by rendering, lighting, Sodium compatibility, and Create/Flywheel compatibility.
• Optimized network sync packets to send packed long positions instead of full BlockPos lists.

Fixes

• Fixed a crash that could happen when painting blocks on Sable physical bodies.
• Gunwood now safely skips unsafe light refresh operations in invalid or virtual holders instead of crashing.
• Added safer checks before refreshing lighting, including world bounds and loaded chunk validation.
• Old saved Gunwood painted block data remains readable and will migrate to the new long-array format automatically.

Sable / Schematic Compatibility

• Added optional support for saving Gunwood hidden block data into structure/schematic data.
• Hidden block positions are stored as relative packed coordinates inside schematic NBT.
• When schematics are placed, Gunwood hidden state is restored at the new location.
• Rotation and mirror transforms are handled through Minecraft’s structure placement logic.
• Gunwood does not require Sable to be installed and will still start normally without it.

Compatibility Notes

The following existing features should continue to work as before:

• Spray brush single-block painting
• Scraper single-block scraping
• Selection-based batch painting and scraping
• FTB Ultimine paint/scrape support
• Glasses visibility behavior
• Sodium rendering compatibility
• Create/Flywheel and Create Contraption compatibility
• Curios glasses support
• Light transparency behavior

Testing Recommended

Please test the following if you use large builds or Sable:

• Large hidden block areas and client FPS
• Old worlds with existing Gunwood hidden blocks
• Multiplayer sync after joining a server
• Sable physical bodies
• Sable schematic save/load
• Schematic rotation and mirroring
• Startup without optional mods such as Sable, Sodium, Create, FTB Ultimine, or Curios