FPSCompress

This mod requires the Compact Machines mod, but it hasn't been published into modrinth, so I cannot register it as a dependency.

FPSCompress

A NeoForge 1.21.1 Minecraft mod that enables factory compression through intelligent rate caching. Run your factories without chunk loading overhead by caching production rates and simulating them mathematically.

What Does It Do?

FPSCompress allows you to build factories inside Compact Machines rooms and run them virtually without keeping those chunks loaded. The mod measures your factory's actual production rates during a calibration period, then uses fractional math to simulate production while the factory dimension stays unloaded.

The Result: Massive server performance gains for factory-heavy builds.

Core Concept: PreFabs

PreFabs (Prefabricated Factories) are cross-dimensional conduits that enable factory input/output caching. The mod's primary purpose is to cache production rates so factories can run "virtually" without chunk loading.

Three-Block System:

1. PreFab Block (Overworld) - Routes resources, controls state machine
2. Importer Block (CM dimension) - Input gates where resources enter factory
3. Exporter Block (CM dimension) - Output gates where resources exit factory

How It Works:

• Player places Importers/Exporters inside CM factory room
• PreFab faces link to specific Importers/Exporters (UUID-based)
• PULL face: Overworld chest → PreFab → Importer → Factory machines
• PUSH face: Factory machines → Exporter → PreFab → Overworld chest
• During SIMULATING: Measure actual rates while CM chunks loaded
• During CACHED: Simulate production using fractional math, CM chunks unloaded

Player Experience:

1. Build factory inside a Compact Machine room
2. Place Importer/Exporter blocks inside CM room (input/output gates)
3. Right-click CM block with "PreFab Upgrade Template" item → becomes PreFab
4. Shift+Right-click PreFab with Simulation Wrench → Open face config GUI

5. Configure each face:

   • Set mode (PULL/PUSH/DISABLED)
   • Set filter (ITEMS/FLUIDS/ENERGY)
   • Link to specific Importer/Exporter (select from dropdown)
6. Connect chests/hoppers to PreFab faces in Overworld
7. Right-click PreFab with empty hand → Open control menu → Start SIMULATION
8. PreFab observes actual production rates (CM chunks loaded)
9. Right-click PreFab with empty hand → Stop simulation → Enters CACHED mode (CM chunks unload)
10. CACHED mode: PreFab uses math to simulate production based on cached rates

State Machine

BUILDING    → Player configures faces, places Importers/Exporters
SIMULATING  → PreFab measures actual production rates (CM chunks LOADED)
CACHED      → PreFab simulates production mathematically (CM chunks UNLOADED ← Performance!)
HALTED      → Input starved or output blocked (CM stays unloaded, player fixes Overworld side)

Example Setup

Overworld:
  [Coal Chest] → [PreFab NORTH face: PULL ITEMS → Importer #1]

CM Dimension (while SIMULATING):
  [Importer #1] → [Furnace] → [Exporter #1]
  (PreFab measures: 0.213 iron ingots/tick)

Overworld:
  [PreFab SOUTH face: PUSH ITEMS ← Exporter #1] → [Iron Chest]

During CACHED mode:
  - CM dimension chunks unload
  - PreFab accumulates fractional production (0.213/tick)
  - Every ~5 ticks, PreFab pushes 1 iron ingot to output chest
  - No chunk loading = Better server TPS!

Current Status

⚠️ This mod is in active development.

Core systems implemented:

• ✅ Face configuration system with GUI
• ✅ Importer/Exporter blocks with UUID linking
• ✅ Resource transport (PULL/PUSH modes)
• ✅ Rate measurement with delta accounting
• ✅ Cached production with fractional math
• ✅ PreFab-as-Item portability system
• ✅ Enhanced GUI with live status and resource display
• ✅ HALTED state recovery with preserved rates
• ✅ Vanilla block support (chests, furnaces, hoppers)

In progress:

• 🔨 AE2/Refined Storage integration
• 🔨 Factory Controller block
• 🔨 Multiple PreFab management
• 🔨 Anti-cheat validation
• 🔨 Polish and bug fixes
• 🔨 Performance optimizations