Voxy Enhanced Stability Compatibility

# Voxy Enhanced Stability Compatibility

Targeted integration fixes for the mod versions used by **Voxy Enhanced** on **Minecraft 1.21.11 / Fabric**.

This original compatibility addon addresses specific errors encountered while generating structures, loading entities and using JEI. It preserves the installed mods and their content, applying targeted runtime adaptations to their integration paths.

## Included fixes

- **Guard Villagers:** defers guard creation from the entity-load callback to the end of the server tick, preserving the original selection and equipment logic.
- **Just Potion Rings + JEI:** skips an invalid ingredient-removal call when its collection is empty.
- **FTB XMod Compat + JEI:** avoids accessing FTB Quests classes when FTB Quests is absent. The Waystones integration remains available.
- **Structure data:** adapts the affected Waystone inventory data, filters the unsupported NeoForge swim-speed attribute and empty entity placeholders, and corrects painting/item-frame attachment positions under structure rotations and mirrors.
- **Friends & Foes:** handles its custom structure-entity processing path while retaining its potion data, frame rotations and cached templates.
- **Missing structure pools:** supplies the missing references using the templates already provided by the installed content mods.
- **Resource metadata:** normalizes the identified metadata fields for AmbientSounds, CreativeCore, Better Statistics and TCDCommons.
- **Voice Physics:** adapts material-resource enumeration to the Fabric resource API used by this version.
- **Tectonic / C2ME / Lithostitched:** restores the targeted noise integration bindings for the tested versions.

## Required versions

- Minecraft **1.21.11**, Fabric Loader **0.20.1 or newer**, Java **21 or newer**.
- Fabric API for Minecraft 1.21.11.
- Guard Villagers **2.1.2-1.21.11**.
- Just Potion Rings **2.0**.
- FTB XMod Compat **21.11.0**, with its normal dependencies.
- Tectonic **3.0.19**.
- Lithostitched **1.7.2**.
- C2ME **0.4.0-alpha.0.28+1.21.11**.
- Friends & Foes **5.0.4**.

These versions are declared in the addon metadata. This beta is tailored to this combination; other releases need a new compatibility assessment. The JEI adaptations activate only when JEI is installed. FTB Quests is not required.

## Installation and scope

Close Minecraft and place the JAR in the instance's `mods` folder. Keep only one version of this addon. It contains shared/server integration fixes and client-only JEI adaptations; it was tested with the Voxy Enhanced client and integrated server. A separate dedicated-server deployment has not been independently validated.

The addon adjusts data as it is loaded or placed. It does not rewrite existing world files or retroactively repair entities already saved in a world. No general FPS improvement is claimed.

## Validation

Native isolated Fabric tests covered transformed structure attachments, real entity/JEI paths and the targeted noise APIs. Tectonic and Lithostitched outputs matched the original calculations at 2,673 sampled points each. The user also tested complete Friends & Foes structures in game; the targeted error signatures were absent in the recorded session.

These checks cover the reported scenarios, not every seed, mod combination or multiplayer setup.

## Credits and license

Original integration code: **Chris Heverton**, for Voxy Enhanced.

The addon does not bundle the original mods' classes, artwork or structure templates. All integrated projects retain their respective authorship and licenses. This is an independent addon, not an official release of those projects.

The original integration code is provided under the **Custom License / All Rights Reserved** included in `LICENSE.txt`.

**Avatar:** the supplied image reuses Voxy Enhanced's original AI-generated branding artwork. It is a project logo, not a screenshot or a demonstration of the fixes.