ButcherCraft: Farm to Table

ButcherCraft v0.10.6-alpha.1

Checkpoint Recovery & Continuous Processing Update

This update significantly expands machine operation while adding a major new persistence and crash-recovery foundation to ButcherCraft.

Continuous Processing

• Grinder now supports continuous processing after being explicitly started.
• Patty Former now supports continuous processing.
• Machines continue processing available material until stopped, the input is empty, or the output is blocked.
• Empty machines remain running and automatically resume when valid material is added.
• Full outputs pause processing without consuming input.
• Machines can be safely stopped during operation, with the current processing cycle completing before shutdown.
• Grinder and Patty Former now use persistent Machine Runs with explicit START, STOP, and restart behavior.

Improved Machine Interfaces

• Improved Grinder and Patty Former GUIs.
• Machine operating state and current processing-cycle state are now displayed separately.
• Added clear states including:
  • OFF
  • RUNNING
  • RUNNING - EMPTY
  • OUTPUT BLOCKED
  • STOPPING
  • RESTART REQUIRED
• Progress bars now represent only the current processing cycle instead of remaining full after a completed cycle.
• Normal right-click opens the machine interface.
• Machine controls are available directly through the GUI.

Restart Safety

• Running machines no longer automatically resume processing after a world/server restart.
• Machines that were running enter RESTART REQUIRED.
• Existing Machine Run identity and processing state are preserved.
• This prevents processing from restarting before the saved state has been safely reconciled.

Persistence Reliability

• Added a shared Windows-safe atomic persistence system.
• Improved protection against temporary Windows file-lock and sharing conflicts.
• Persistence writes now use unique temporary publication files and bounded retry behavior.
• Reduced unnecessary duplicate Simulation Clock writes.
• Persistence failures remain fail-visible rather than silently risking save corruption.

Coordinated Checkpoints

• Added coordinated live world checkpoints across ButcherCraft's durable systems.
• Checkpoints capture a coherent state across 17 authoritative systems.
• Checkpoints use immutable generations and crash-safe dual-head publication.
• Incomplete or damaged checkpoint generations cannot become authoritative.
• Checkpoints can be created while continuous machines and Material Handling are active.
• Checkpoint creation does not require stopping machines or replaying operations.

Durable Workstation State

• Workstations now maintain exact durable state independently of whether their chunks are loaded.
• Grinder, Patty Former, Cutting Table, and other Workstation inventories can be represented without force-loading their chunks.
• Exact item counts and item components are preserved.
• Workstation replacements cannot inherit the identity or recovery state of the previous machine.
• Retired Workstations retain recovery-safe tombstone evidence.
• Checkpoints can now include hundreds of unloaded Workstations without loading their chunks.

Crash Recovery

• Added startup detection of coherent and incoherent ButcherCraft save state.
• Healthy live save state is always preferred when it is coherent.
• When live state is damaged by an interrupted save, ButcherCraft can select the latest valid complete checkpoint.
• Added owner-native restoration across ButcherCraft's durable systems.
• Interrupted restoration can safely resume after another crash.
• Restoration does not replay completed machine operations, transfers, recipes, or other consequential actions.
• Extensive hard-crash and Windows persistence testing was added.

Legacy Recovery Foundation

• Added evidence-based recovery support for certain split-snapshot saves created by interrupted persistence.
• Recovery only reconstructs state that can be proven from existing authoritative evidence.
• Unknown or ambiguous consequences remain blocked rather than guessed.
• Historical machine operations proven complete are never executed a second time.

Validation

• 1,742 Java tests passed during final release validation.
• 300/300 GameTests passed.
• Full clean build passed.
• Repeated Windows persistence/restoration stress testing passed.
• Separate-process hard-crash recovery validation passed.
• Client initialization and resource loading passed.

Known Limitations

• Employee Machine START/STOP operation is not implemented yet.
• Machine wear, damage, maintenance, lubrication, and breakdown systems are not implemented yet.
• Production Orders do not yet control machine operation.
• Checkpoint retention/compaction is not implemented, so checkpoint disk usage can grow over time.
• Ambiguous recovery outcomes remain intentionally blocked rather than guessed.

Version: 0.10.6-alpha.1
Minecraft: 1.21.1
Loader: NeoForge