X-Factor Optimization 1.0.2

X-Factor 1.0.2 expands the pack into several performance areas that were still lightly covered in 1.0.1: memory usage, lighting updates, client-side micro-optimizations, sign rendering, packet-to-tick responsiveness, and latency compensation.

No existing core optimization mod was removed in this release. Instead, 1.0.2 adds seven new components on top of the 1.0.1 stack and introduces tuned configurations intended to complement the existing Sodium, Lithium, Rendersnap, ImmediatelyFast, Async, Ferrite, More Culling, OBE, Particle Core, Modernica, and X-Factor compatibility layers.

Highlights

• Added BadOptimizations 2.4.1
• Added FerriteCore 9.0.0
• Added ScalableLux 0.3.0-alpha.0.3
• Added Signs Faster 1.0.3
• Added Tick Sync 1.4.0
• Added Eslium 4.5.0-beta
• Added Put A Plug In it! (PAPI) 1.2.0
• Added dedicated memory-usage and leak-mitigation coverage
• Added dedicated lighting-engine optimization
• Added additional client-side micro-optimizations
• Added optimized sign-text rendering
• Added packet-to-client-tick responsiveness improvements
• Added optional client prediction for selected latency-sensitive actions
• Disabled Gnetum HUD downscaling while retaining its other HUD optimizations
• Removed a runtime Quantified API log from the distributed pack
• Retains Client State Guard 1.0.4 and the existing X-Factor compatibility system

---

Added: BadOptimizations

X-Factor 1.0.2 adds:

BadOptimizations 2.4.1

BadOptimizations targets smaller client-side costs that are not the main focus of large rendering mods.

The included configuration enables:

• Lightmap caching
• Debug-renderer skipping when unused
• Particle-manager short-circuiting when no particles are present
• Toast-manager optimizations
• Entity-renderer caching
• Block-entity-renderer caching
• Redundant FOV-calculation removal
• Tutorial ticking removal outside demo mode
• Automatic mod compatibility checks

The pack keeps BadOptimizations' compatibility protections enabled rather than forcing optimizations that another installed mod reports as incompatible.

This complements Sodium, ImmediatelyFast, Rendersnap, and More Culling rather than replacing them.

---

Added: FerriteCore

X-Factor 1.0.2 now includes:

FerriteCore 9.0.0

FerriteCore adds a dedicated memory-optimization layer to the pack.

The configured optimizations include:

• Block-state neighbor lookup replacement
• Block-state property-map replacement
• Block-state cache deduplication
• More compact handling of empty data-component patches

The more aggressive small threading-detector replacement remains disabled.

This is separate from the existing Ferrite mod: Ferrite and FerriteCore target different areas and are both included.

The goal is lower Java heap pressure and less duplicated block-state data, particularly during longer sessions and larger worlds.

---

Added: ScalableLux

X-Factor 1.0.2 adds:

ScalableLux 0.3.0-alpha.0.3

ScalableLux provides a dedicated optimization layer for Minecraft's lighting engine.

The included configuration uses automatic parallelism:

parallelism=-1

This allows the lighting implementation to select an appropriate level of parallel work rather than forcing a fixed thread count.

ScalableLux is most relevant during:

• Fast chunk loading
• Fresh terrain generation
• Large lighting changes
• Rapid world traversal
• Situations where lighting work becomes a chunk-generation bottleneck

This fills a performance area that was not directly covered by the previous X-Factor release.

---

Added: Signs Faster

X-Factor 1.0.2 adds:

Signs Faster 1.0.3

Signs Faster optimizes sign-text rendering.

This is especially useful in:

• Multiplayer hubs
• Shops
• PvP lobbies
• Maps containing large numbers of signs
• Areas where sign text becomes a noticeable rendering cost

It complements the pack's existing block-entity and rendering optimizations by targeting the text-rendering side of signs specifically.

---

Added: Tick Sync

X-Factor 1.0.2 includes:

Tick Sync 1.4.0

Tick Sync is configured to reduce the delay between incoming server packets and the client tick that processes them.

The included configuration enables:

Tick Sync: ON
Automatic margin: ON
Fast Sync: ON
Netty criteria: OFF

This is primarily a responsiveness optimization rather than an FPS optimization.

It is intended to make multiplayer state updates feel more immediate without replacing Minecraft's normal networking or server authority.

---

Added: Eslium

X-Factor 1.0.2 adds:

Eslium 4.5.0-beta

Eslium uses client-side prediction for selected actions that would otherwise wait for server confirmation.

The included configuration enables prediction for:

• End crystals
• Minecarts

The configured simulated-desync value is:

50 ms

This addition is aimed at reducing the perceived effect of latency during supported interactions.

Multiplayer notice

Eslium is different from the pack's normal FPS and memory optimizations because it predicts selected server actions locally.

Server rules and anti-cheat policies can vary. Players using X-Factor on competitive servers should make sure the server permits this type of client-side prediction.

---

Added: Put A Plug In it! (PAPI)

X-Factor 1.0.2 adds:

Put A Plug In it! (PAPI) 1.2.0

PAPI adds memory-leak mitigation and compatibility safeguards.

The included configuration enables:

• Client-side cache leak mitigation
• Baked-model cache cleanup on client-world unload
• Compatibility handling for ImmediatelyFast
• Intel-GPU safeguards for selected ImmediatelyFast options
• Compatibility-layer detection and logging
• Additional cache cleanup integrations when supported mods are present

Heap-dump generation remains disabled by default.

This gives X-Factor another layer of protection for long-running sessions and repeated world/server transitions.

---

Memory Optimization Is Now More Complete

X-Factor 1.0.1 already optimized a large amount of rendering, game logic, entities, block entities, particles, and native processing.

Version 1.0.2 strengthens the memory side of the pack with:

FerriteCore
+
Put A Plug In it!
+
existing Modernica / Lithium / Ferrite optimizations

The intention is not simply to lower an idle RAM number.

The more important goals are:

• Less duplicated data
• Lower allocation pressure
• Fewer retained caches across world transitions
• Better behavior during long play sessions
• Reduced garbage-collection pressure

---

Lighting and Chunk Work

ScalableLux now handles the lighting side of chunk processing while the existing stack continues to cover other parts of world and chunk performance.

The relevant X-Factor stack now includes:

Lithium
Ferrite
Async
ScalableLux
Sodium
Rendersnap
More Culling

Each targets a different part of the workload.

X-Factor does not enable every experimental option available in these mods. The included configurations favor automatic or conservative settings where possible.

---

Rendering Changes

Gnetum

Gnetum remains enabled, but HUD downscaling has been changed from:

ON

to:

OFF

Fast FBO blitting remains enabled.

This keeps Gnetum's HUD optimization features while avoiding the global downscale path in the new default configuration.

Existing rendering stack

The following major rendering components remain in the pack:

• Sodium
• Rendersnap
• Rendersnap Sodium Menu Compat
• ImmediatelyFast
• More Culling
• Optimized Block Entities
• Particle Core
• Iris
• Gnetum
• Chloride

No shader pack is forced by default.

---

Client State Guard

X-Factor 1.0.2 retains:

Client State Guard 1.0.4

This is the safer connection-state implementation introduced in X-Factor 1.0.1.

It continues to protect against confirmed stale entity packets and invalid menu returns without treating a temporary missing world or player as proof of disconnection.

The guard does not intentionally close an active Minecraft or Netty connection.

---

X-Factor Compatibility Patcher

The configurable X-Factor Compatibility Patcher remains included together with:

mods/xfactor-compatibility-patches.txt

The patcher continues to:

• Read compatibility rules from the text file
• Resolve the exact target Mixins
• Show every proposed change before patching
• Require explicit user approval
• Back up original JARs
• Verify modified archives
• Refuse to patch if the reviewed rules file changes
• Reopen the wizard after denial or when original files return

Existing X-Factor compatibility rules for Modernica and Rendersnap remain part of the pack.

---

Package Cleanup

The previous release contained a generated:

quantified-api.log

inside the exported overrides.

That runtime log is no longer included in X-Factor 1.0.2.

Runtime logs should be generated by each user's own installation rather than distributed as part of the modpack.

---

Performance Validation

This release was profiled with Spark using several different workloads, including:

• Unlimited-FPS rendering
• A fully loaded flat-world baseline
• Chunk traversal / chunk-render workload
• Multiplayer gameplay

The profiles were used to look for large CPU hotspots, excessive waiting or lock contention, and individual mod paths dominating the client.

No specific FPS multiplier is claimed from these tests because performance varies heavily by hardware, world complexity, server conditions, resolution, and graphics settings.

The goal of X-Factor remains consistent frame delivery and broad optimization coverage rather than optimizing only for a single synthetic FPS number.

---

Compared with X-Factor 1.0.1

Added

BadOptimizations 2.4.1
FerriteCore 9.0.0
ScalableLux 0.3.0-alpha.0.3
Signs Faster 1.0.3
Tick Sync 1.4.0
Eslium 4.5.0-beta
Put A Plug In it! (PAPI) 1.2.0

Changed

• Gnetum HUD downscaling is now disabled
• New configurations added for all new optimization components
• Memory/leak protection is substantially expanded
• Lighting updates now have a dedicated optimization layer
• Multiplayer responsiveness receives additional packet/tick and prediction optimizations
• Exported runtime-log cleanup

Retained

• Client State Guard 1.0.4
• Rendersnap Sodium Menu Compat 1.0.13
• X-Factor Compatibility Patcher
• Async
• More Culling
• Sodium
• Lithium
• ImmediatelyFast
• Rendersnap
• Iris
• Ferrite
• Modernica
• OBE
• Particle Core
• ViaFabricPlus
• The existing X-Factor compatibility rules

---

Updating from X-Factor 1.0.1

A clean instance is recommended for the most predictable result.

For an existing instance:

1. Back up worlds, screenshots, and personal configuration changes.
2. Update the pack through your launcher.
3. Make sure old duplicate mod versions are not left in the mods folder.
4. Keep only the versions supplied by X-Factor 1.0.2.
5. Launch the pack.
6. Review the X-Factor Compatibility Patcher wizard if it appears.
7. Allow the compatibility helper to finish before relaunching.
8. Launch the pack again after an approved compatibility patch.

Do not use a launcher-wide Update All Mods action on X-Factor.

Individual mod updates can change Mixins, compatibility requirements, or tuned configuration behavior and may not match the version tested with the pack.

---

Compatibility

• Minecraft: 26.2
• Mod loader: Fabric
• Environment: Client-focused
• Shaders: Iris support included
• Server installation: Not normally required for the client optimization stack

---

Reporting Problems

When reporting an issue, include:

• X-Factor version
• Minecraft version
• Fabric Loader version
• Java version
• GPU and CPU
• Full latest.log
• Exact steps to reproduce
• Whether the issue occurs in singleplayer, multiplayer, or both

For performance reports, also include:

• Render distance
• Simulation distance
• Resolution
• FPS cap / VSync state
• Shader status
• Spark profile link when available

For menu/disconnect problems, include the exact screen sequence used before the issue occurred.

For compatibility-patcher problems, include:

• xfactor-compatibility-patches.txt
• Target JAR filenames
• Patcher logs
• Whether Agree or Deny was selected

Join the X-Factor Discord