patch variety

Automatic Wood Discovery

• Completely redesigned the external wood detection system.
• Added a multi-stage discovery pipeline using:
  • Minecraft and mod tags
  • Registries
  • Block relationships
  • Recipes
  • Assets and models
  • Naming conventions as a fallback
• Added support for detecting common wood-family naming patterns such as:
  • Planks / Boards
  • Logs / Wood / Trunks / Bark
  • Stems / Hyphae
  • Fungus-based wood families
  • Derived wooden blocks
• Improved detection of unconventional modded wood families.
• Wood families are now deduplicated using their plank identity to prevent duplicate registrations.
• Added confidence and family-signal checks to reduce false-positive wood detection.

Expanded Mod Compatibility

• Significantly improved automatic compatibility with biome, vegetation, and wood-content mods.
• Added recognition rules for many popular wood ecosystems and naming conventions.
• Improved handling of mods that use unusual registry names or resource layouts.
• Added better detection of external wood blocks without requiring individual hardcoded patches for every mod.
• Improved compatibility data for storage, automation, pipe, technology, and utility mods used alongside Variants & More.

Variants & More Integration

• Introduced Patch Variety API v3.
• Improved communication between Patch Variety and Variants & More.
• Added a faster external wood catalog for VAM.
• External wood families can now be discovered once and reused by Variants & More instead of repeatedly scanning registries.
• Improved handling of virtual and dynamically generated VAM resources.
• Added better support for generated recipes, models, textures, and variant data.
• API v3 is designed for the VAM 1.1.x generation system.

Performance

• Major reduction in repeated registry and resource scanning.
• Added in-memory caching for discovered mod data.
• Added persistent disk caching.
• Detection results can now be reused between game launches.
• Expensive discovery work is avoided when installed mods have not changed.
• Improved startup performance in large modpacks.
• Reduced unnecessary processing for mods that do not contain compatible wood content.

Persistent Incremental Cache

• Added a new persistent cache system for Patch Variety.
• Each installed mod now receives its own cached compatibility data.
• Added mod fingerprints to detect when a mod has actually changed.
• Only changed, added, or removed mods need to be rescanned.
• Unchanged mods can reuse their previous results.
• Removed mods are automatically cleaned from the cache.
• Added a persistent registry snapshot.
• Added RAM + disk cache layers.
• Added selective cache invalidation.
• Added atomic cache writing to reduce the chance of corrupted cache files.
• Added recovery behavior when cached data is invalid or damaged.
• Added PersistentCacheApi support for generated JSON/PNG and compatibility resources.

Diagnostics & Reliability

• Expanded compatibility diagnostics.
• Added more information about detected wood families and why they were accepted or rejected.
• Improved detection of duplicate ownership between mods.
• Added protection against incorrectly classifying unrelated decorative blocks as wood families.
• Improved handling of incomplete or unusual mod registrations.
• Added fail-open behavior so an unsupported mod should not prevent the game from loading.
• Improved error isolation so one problematic mod is less likely to break the entire discovery process.

Resource & Recipe Handling

• Improved scanning of client resources and server data.
• Improved detection through crafting recipes and resource relationships.
• Better support for dynamically generated VAM recipes.
• Improved handling of external textures and models.
• Expanded support for generated variant resources without requiring the original mod to provide VAM-specific assets.

Internal Architecture

• Reworked the wood catalog into a faster reusable compatibility layer.
• Separated wood discovery, validation, caching, and VAM integration into clearer systems.
• Reduced duplicated work between Patch Variety and Variants & More.
• Added stronger fallback behavior for unknown mods.
• Improved scalability for larger modpacks containing many biome and wood mods.
• General code cleanup and stability improvements.

General

• Numerous compatibility improvements.
• Multiple performance improvements.
• Improved automatic wood-family detection.
• Improved behavior with large modpacks.
• Improved reliability when mods are added, removed, or updated.
• Prepared Patch Variety for future compatibility expansion without requiring a dedicated patch for every supported mod.