Patchwork

1.2.0 - 2026-08-03

Added

• Added the marker-free neutral Patchwork language for Server/Patchwork/Patches, with closed structural validation, neutral authoring schema/capabilities, and structural failures reported as installation/version errors rather than optional-operation skips; explicit format 1/2 files remain lossless.
• Added beginner-facing documentation for every native Patchwork definition and operation field, plus documented editor dropdowns for operation type, array position, and match policy.
• Added guided recursive native-editor schemas for When conditions, $Equals/$Contains matchers, arbitrary JSON Value fields, and object-only macro Options. This changes editor guidance only; portable patch JSON and runtime behavior are unchanged.
• Added neutral MergeMatching and UpsertMatching operations for deep-merging object entries selected by recursive matchers, with deterministic zero-match insertion for upserts.
• Added neutral OverlayFromAsset and MergeObjectFromAsset operations for exact-path, immutable-snapshot cross-asset object merges with source-wins semantics and optional applicability failures.
• Added sanitized mutation effects with canonical JSON SHA-256 fingerprints for tracing successful writes, array membership changes, and array order changes without retaining raw values.
• Added explicit glob: target selectors with *, **, and ? tokens, deterministic immutable-snapshot expansion, generated-pack exclusion, deduplication, and zero-match warnings.
• Added generation dependency metadata for definition files, expanded targets, exact cross-asset sources, and glob stable prefixes; the index is descriptive and does not start a watcher.
• Added deterministic, value-redacted conflict reports for overlapping concrete effects, including same-pack/cross-pack scope and redundant-identical/material classifications; /patchwork conflicts [target] shows bounded detail rows.
• Added neutral ConflictPolicy choices Report, Allow, and Reject. Reject is target-local, stops later definitions for that target, retains prior generated bytes during normal reload when available, and never acts as ownership or authorization.
• Added elected, one-second-debounced automatic regeneration for relevant directory-pack definitions and asset changes, with one queued follow-up for changes that arrive during generation and generated-pack feedback exclusion.
• Added conservative built-in Hytale reload confirmation for monitored server asset stores: hot-reloaded now requires matching generated-provider, asset-path, and generated-byte evidence. Unsupported or unconfirmed routes remain restart-required.
• Expanded /patchwork selftest with isolated fixtures for neutral matching merge/upsert, both cross-asset operations, explicit glob targets, and an Allow conflict-policy application.
• Added the install-plugin Maven profile for installing the standalone jar directly into Hytale's user Mods directory.

Fixed

• Fixed recursive Patchwork authoring schemas failing to mount in Hytale's Asset Editor because their shared definitions were placed in the editor-omitted other.json schema file.
• Fixed target resolution for registered asset packs installed through symbolic links or Windows junctions.
• Fixed recoverable scan failures and rejected targets incorrectly failing server startup after valid generated targets were published; warnings now identify each skipped file and reason.
• Fixed /patchwork selftest when standalone and embedded Patchwork copies are loaded by different Hytale plugin classloaders.
• Restored unversioned patch compatibility for root $Comment notes, object-based Find/Existing anchors, and path-based macro inputs.
• Refreshed the HyCreator handoff schema and test mod with marker-free examples for every neutral operation, including matching merge/upsert and cross-asset merge operations.
• Hardened generation snapshots against source-root identity and path races, and isolated condition-source resolution to the captured snapshot.