ReForgedPlay Fix

An unofficial patch fork of ReForgedPlay for Minecraft 1.21.1 on NeoForge.

ReForgedPlay Fix adds targeted stability and compatibility fixes on top of ReForgedPlay, which is itself an unofficial NeoForge port based on the original Replay Mod.

This project is intended primarily for modded Minecraft 1.21.1 NeoForge clients, especially environments where replay playback can fail because of incompatible block entities or network compatibility issues.

What does this fork fix?

Block Entity Replay Crashes / Disconnects

Some modded block entities may contain data that cannot be restored correctly during replay playback.

Normally, an exception while processing one of these block entities can interrupt replay packet handling and disconnect the replay client.

ReForgedPlay Fix changes this behavior.

If an individual block entity fails while replay data is being restored:

• The failing block entity update is skipped.
• The exception is contained instead of terminating the entire replay.
• Replay playback is allowed to continue whenever possible.
• The error is still logged as a warning for troubleshooting.

This protection applies to both:

• Block entities restored from chunk data.
• Standalone block entity update packets.

The fix does not repair incompatible block entity data itself. A problematic block entity may still appear incorrectly or fail to update during playback, but it should no longer automatically make the entire replay unusable.

Optional replaymod:restrict Network Channel

This fork also changes the NeoForge registration of the replaymod:restrict payload so that the channel is optional.

This helps avoid unnecessary compatibility or connection problems when the other side does not provide that channel.

Why use ReForgedPlay Fix?

ReForgedPlay Fix may be useful if you experience:

• Replay playback disconnects caused by modded block entities.
• Recordings that stop loading because of one incompatible block entity.
• Problems restoring custom block entity NBT during replay playback.
• NeoForge networking compatibility issues involving the Replay Mod restriction channel.
• Replay instability in large modpacks.

The goal of this fork is not to redesign Replay Mod or ReForgedPlay.

Changes are kept as small and focused as possible so that behavior remains close to upstream while improving stability in the target environment.

Requirements

• Minecraft: 1.21.1
• Mod Loader: NeoForge
• Built against NeoForge: 21.1.82
• Java: 21

Other Minecraft or NeoForge versions are not specifically maintained or guaranteed to work.

Project Lineage

ReplayMod/ReplayMod Original Replay Mod project

↓

ferriarnus/ReForgedPlay Unofficial NeoForge port

↓

ARTS-Night/ReForgedPlay-Fix Additional stability and compatibility fixes

ReForgedPlay is the direct upstream of this project.

ReForgedPlay Fix is not a separate implementation or a new NeoForge port of Replay Mod.

Issues

If you encounter a problem that appears to be specific to ReForgedPlay Fix, please report it through the ReForgedPlay Fix GitHub Issues page.

When reporting an issue, please include relevant information when possible:

• Minecraft version
• NeoForge version
• ReForgedPlay Fix version
• Relevant logs
• Crash reports
• Related installed mods
• Steps to reproduce the problem

If possible, also check whether the same issue occurs with the upstream ReForgedPlay version.

Please do not request support for ReForgedPlay Fix from the Replay Mod or ReForgedPlay maintainers. Changes made specifically in this fork are not their responsibility.

Credits

ReForgedPlay Fix is built on the work of the upstream projects and their contributors.

• Replay Mod / ReplayMod contributors — original Replay Mod project and codebase
• CrushedPixel and johni0702 — original Replay Mod development
• Ferri_Arnus / ferriarnus — ReForgedPlay NeoForge port and direct upstream
• ARTS-Night — additional fixes and maintenance changes in ReForgedPlay Fix

ReForgedPlay Fix does not claim ownership of upstream code.

Source & License

ReForgedPlay Fix is open source.

Source code, issue tracking, development information, and license details are available from the project repository:

https://github.com/ARTS-Night/ReForgedPlay-Fix

This project is derived from ReForgedPlay and Replay Mod and preserves attribution to the upstream projects and contributors.

Please see the repository license files and applicable upstream license notices for licensing information.

Unofficial project: ReForgedPlay Fix is maintained independently and is not affiliated with, endorsed by, or officially supported by the Replay Mod project or the ReForgedPlay maintainer.