WorldOptimiser

Word Optimizer

Automatic World Optimization for ReplayMod Compatibility

This Minecraft Forge addon automatically adjusts worlds upon detecting mod changes, specifically designed to resolve ReplayMod block ID mismatch issues.

Purpose

This mod emerged in response to a significant issue with ReforgedPlay Mod (version 0.3.1), where adding or removing mods containing blocks, models, or textures caused display errors of textures and models in ReplayMod recordings.

Challenges Users Faced

• ReplayMod works perfectly when a world is created with a fixed set of mods
• Problems arise when changing the list of mods that have blocks, models, or textures
• This alters the identifier directory, causing ReplayMod to display incorrect blocks
• Manual correction required world download → opening in singleplayer → manual optimization → re-upload
• The process was cumbersome and risky, especially on servers where mods can be updated regularly

How the Solution Works

WorldOptimizer independently monitors changes in the installed mod list and initiates the world optimization procedure previously done manually via the "Optimize World" button in singleplayer. This reconfigures ID mappings and restores ReplayMod's proper functionality.

Key Features

• Independent Monitoring: Tracks mod additions, removals, and updates
• Smart Optimization: Runs only upon actual mod changes
• Server Operation: Functions on both dedicated and local servers
• Unobtrusive Operation: Works in the background during world launch
• Recording Safety: Ensures correct ReplayMod playback after mod changes

Operation Principle

1. Launch Check: When a world starts, the mod reads the saved mod list from level.dat
2. Data Comparison: Matches the saved list with current active mods
3. Change Detection: Identifies additions, removals, or component updates
4. Optimization Launch: Automatically performs world optimization upon change detection
5. Process Completion: World launches normally with updated ID mapping

Installation

Download the latest version from the releases page and place the worldoptimiser-1.0.jar file in the mods folder. Start the game or launch the server — the mod will automatically perform necessary actions when detecting mod changes.

Usage

No additional configuration needed! The mod operates autonomously.

In the log, you will see messages like:

[Server thread/WARN] [worldoptimiser]: Detected new mods world will be optimised on startup
[Server thread/INFO] [worldoptimiser/worldupgrader]: World will be optimised it may take a while, please wait...
[Server thread/INFO] [worldoptimiser/worldupgrader]: World optimisation complete

Specifications

• Optimization may take some time for large worlds
• The process blocks world launch until completion (this is necessary for proper ID changes)

Compatibility

The problem was characteristic of ReforgedPlay Mod v0.3.1 on Forge 1.20.1. Previous versions (Forge 1.16.5 and Fabric variants) handled ID changes automatically, but this functionality was lost in the Forge version for 1.20.1.

Technical Parameters

• Mod Identifier: worldoptimiser
• Minecraft: 1.20.1
• Required Forge: 47.4.0 or higher
• Required Java Version: 17+

This mod resolves a specific technical issue with ReplayMod compatibility. If you encounter similar block ID or texture mapping difficulties after mod changes, this tool automates the manual optimization process.