X-Factor Optimization 1.0.1

X-Factor 1.0.1 is a stability and performance maintenance release focused on safer multiplayer menu transitions, more conservative client-state protection, configurable compatibility patching, and additional rendering and entity-processing optimizations.

This release updates Client State Guard from 1.0.2 to 1.0.4 and removes the overly aggressive connection-closing behavior tested during development. It also adds Async, More Culling, Cloth Config, the configurable X-Factor Compatibility Patcher, and several cleaned or retuned defaults.

Highlights

• Updated Client State Guard from 1.0.2 to 1.0.4
• Fixed a Client State Guard regression that could disconnect an active multiplayer session during menu navigation
• Added safer detection for genuinely stale packet listeners
• Added the configurable X-Factor Compatibility Patcher and its text-based rules file
• Added a complete review-and-consent wizard before compatibility changes are installed
• Added Async for conservative parallel entity ticking
• Added More Culling for additional client-side rendering reduction
• Added Cloth Config as a required supporting library
• Removed a stale Rendersnap FPS-overlay entry from the Gnetum configuration
• Raised the default render distance from 16 to 20 chunks
• Updated X-Factor branding and pack icon

---

Client State Guard 1.0.4

The largest change in X-Factor 1.0.1 is the update from Client State Guard 1.0.2 to 1.0.4.

Client State Guard was originally created to prevent crashes caused by late entity packets and invalid menu returns after the client world had already been removed. During testing, version 1.0.3 attempted to go further by closing and draining a connection that appeared stale.

That behavior was too aggressive.

A temporary missing client world or player can occur during legitimate menu and screen transitions. In particular, moving through a sequence such as:

Pause Menu
→ another settings page
→ Pause Menu
→ Video Settings

could be mistaken for a completed disconnection. Version 1.0.3 could then close an otherwise active server connection.

Version 1.0.4 removes that behavior completely.

What changed from 1.0.2

Client State Guard 1.0.4 still protects the original failure paths, but it now uses stricter rules:

• A temporarily missing client world is not treated as proof of disconnection.
• A temporarily missing player is not treated as proof of disconnection.
• Opening or closing Options, Video Settings, or another menu can never authorize the mod to close a connection.
• Client State Guard no longer calls connection, network-channel, or Netty close methods.
• It no longer broadly drains player-list, chat, or unrelated packets.
• It blocks an entity packet only when the packet listener is independently confirmed to be stale.
• A listener is considered stale only when it has been replaced by Minecraft's current listener or its underlying connection is already inactive.
• A current active multiplayer connection is always left untouched.
• Fresh login and proxy-transfer connections are not affected.
• Normal server disconnect and transfer packets are allowed to complete.

Protections retained

Version 1.0.4 continues to protect against:

• Late entity-data packets from a replaced or inactive listener
• Late entity-position updates
• Late entity-motion updates
• Other confirmed stale entity-family updates
• Options screens attempting to return to an invalid PauseScreen
• Pause-screen additions when no valid player exists

The mod prevents crashes caused by stale client state. It does not attempt to hide, cancel, or override a legitimate server kick or network failure.

Optional diagnostics

Temporary client-state events can be inspected by adding:

-Dclient.state.guard.debug=true

When Minecraft briefly reports a missing world while the current connection is still active, Client State Guard should log that it observed the state and deliberately made no networking change.

---

Configurable Compatibility Patcher

X-Factor 1.0.1 includes X-Factor Compatibility Patcher 1.1.0 together with:

mods/xfactor-compatibility-patches.txt

The patcher no longer depends only on a hard-coded list of compatibility changes. It reads the target JAR filenames and Mixin selectors from the text file in the mods folder.

The included X-Factor rules disable the tested incompatible Mixin registrations in Modernica and Rendersnap.

Current included rules

modernica-mc26.2-26.07.1.jar: model_optimizations
modernica-mc26.2-26.07.1.jar: blockstate_propertyaccess
modernica-mc26.2-26.07.1.jar: =perf.remove_biome_temperature_cache.BiomeMixin
Rendersnap-mc26.2-1.2-fabric.jar: =world.ChunkGraph

New review wizard

Before anything is changed, the patcher now lists:

• Every target mod JAR
• Every matching Mixin configuration
• The exact mixins, client, or server section
• Every exact Mixin registration that will be disabled
• Missing configured JARs
• Rules that did not match anything

The player can then choose:

Agree and install changes
Deny and close Minecraft

Choosing Agree starts the external helper, closes Minecraft, creates backups, applies only the reviewed changes, verifies the resulting JARs, and asks for one additional launch.

Choosing Deny, closing the wizard, or dismissing it changes nothing and closes Minecraft. The wizard will return on the next launch because no approval is stored.

The helper also verifies the SHA-256 digest of the exact rules file shown in the wizard. If the file changes after approval, patching is cancelled before any target JAR is modified.

---

Added: Async

X-Factor 1.0.1 adds:

Async 0.2.4+alpha-26.2

Async allows supported entity ticking work to be processed across worker threads.

The included configuration is intentionally conservative:

• Automatic worker-thread selection is enabled
• TNT remains synchronized on the main thread
• Experience orbs remain synchronized on the main thread
• Item entities remain synchronized on the main thread
• Async entity spawning is disabled
• Async random ticks are disabled

This keeps the pack focused on safer parallel entity processing without enabling its more experimental spawning or random-tick options.

Because this is an alpha release of Async, unusual entity behavior should be reported with a complete log and reproduction steps.

---

Added: More Culling

X-Factor 1.0.1 adds:

More Culling 1.8.0

More Culling reduces rendering work for objects and effects that are not visible.

The included configuration enables:

• Sodium menu integration
• Cloud culling
• Sign-text culling
• Rain culling
• Block-state culling
• Custom item-frame rendering
• Three-face item-frame culling
• Painting culling
• Default leaf culling
• Culling support for modded blocks by default

Item-frame level of detail and map culling remain disabled in the default configuration.

Cloth Config 26.2.155 is also included as a supporting dependency.

---

Configuration and Default Changes

Gnetum cleanup

A stale configuration entry for:

rendersnap:fps_overlay

was removed from the Gnetum element map.

The standard miscellaneous-overlay entry remains enabled in automatic mode.

Rendering defaults

The default render distance has been raised:

Previous: 16 chunks
Current:  20 chunks

Simulation distance remains at 12 chunks.

This gives the default profile a longer visual range while preserving a lower simulation radius. Players seeking the highest possible frame rate on lower-end systems can reduce render distance from the Video Settings screen.

The graphics preset is now stored as custom, reflecting the pack's tuned combination of individual settings.

Sodium and Iris

Sodium remains configured with:

• Three chunk-builder threads
• One-frame chunk-build deferral
• Visible-texture-only animation
• Entity culling
• Fog occlusion
• Block-face culling
• Safe quad splitting
• Memory tracing disabled

Iris remains installed and shader support remains available. No shader pack is forced by the modpack.

---

Included Custom Components

X-Factor 1.0.1 includes:

• Client State Guard 1.0.4
• Rendersnap Sodium Menu Compat 1.0.13
• X-Factor Compatibility Patcher 1.1.0
• xfactor-compatibility-patches.txt

Rendersnap Sodium Menu Compat continues to redirect Rendersnap's video page into Sodium and places Rendersnap's controls inside Sodium's settings interface.

---

Updating from X-Factor 1.0.0

A clean instance is recommended because this release changes custom compatibility components and introduces the patch-rules file.

For an existing instance:

1. Back up worlds, screenshots, and any personal configuration changes.
2. Remove the previous Client State Guard JAR.
3. Make sure only Client State Guard 1.0.4 is installed.
4. Make sure only one X-Factor Compatibility Patcher JAR is installed.
5. Add xfactor-compatibility-patches.txt to the mods folder.
6. Launch the pack.
7. Review the compatibility wizard carefully.
8. Approve the listed changes or deny them and close the game.
9. After approval completes, launch the pack one more time.

Do not use a launcher-wide Update All Mods action on X-Factor. Individual mod updates may require new compatibility rules or different tested settings.

---

Important First-Launch Notice

The compatibility patcher may intentionally close Minecraft after the player approves or denies the proposed changes.

After approval:

• Wait for the patch-completion message
• Do not terminate the helper process
• Launch X-Factor again

After denial:

• No target JAR is modified
• The pack remains closed
• The review wizard appears again on the next launch

---

Compatibility

• Minecraft: 26.2
• Fabric Loader: 0.19.3
• Environment: Client
• Recommended Java: Java 25
• Rendering stack: Sodium with Iris support
• Server installation: Not required

---

Reporting Problems

For Client State Guard menu-transition issues, include:

• The exact screen sequence used
• Whether the client returned to the title screen or disconnect screen
• Whether server chat continued afterward
• Whether a reconnect was possible
• The complete log from before entering the server through the failure
• Client State Guard debug output when available

For patcher problems, include:

• The complete xfactor-compatibility-patches.txt
• The target JAR filenames
• Patcher logs
• The normal Minecraft log
• Whether Agree or Deny was selected

Support and community:

Join the X-Factor Discord