# WorldOptimiser<\/p>\n
**Automatic World Optimization for ReplayMod Compatibility**<\/p>\n
A Minecraft Forge mod that automatically optimizes worlds when mod changes are detected, specifically designed to solve ReplayMod block ID mismatch issues.<\/p>\n
## \ud83c\udfaf Purpose<\/p>\n
This mod was created to solve a critical issue with ReforgedPlay Mod (version 0.3.1) where adding or removing mods that contain blocks, models, or textures causes ReplayMod to display incorrect textures and models in replay recordings.<\/p>\n
### The Problem
\n– **ReplayMod works perfectly** when a world is generated with a fixed set of mods
\n– **Issues arise** when you add or remove mods containing blocks, models, or textures
\n– This changes the reference ID list, causing ReplayMod to jumble block IDs
\n– **Previous manual fix**: Download world \u2192 Open in singleplayer \u2192 Manually optimize \u2192 Re-upload
\n– **This was tedious and risky** for server environments where mods need to be changed on-the-fly<\/p>\n
### The Solution
\nWorldOptimiser automatically detects mod list changes and triggers the world optimization process that you would normally do manually through the “Optimize World” button in singleplayer. This recalibrates the ID mappings and fixes ReplayMod compatibility issues.<\/p>\n
## \u2728 Features<\/p>\n
– **Automatic Detection**: Monitors for mod additions, removals, and version changes
\n– **Smart Optimization**: Only runs when actual mod changes are detected
\n– **Server-Side**: Works on both dedicated servers and integrated servers
\n– **Non-Intrusive**: Runs seamlessly in the background during world startup
\n– **Replay-Safe**: Ensures your ReplayMod recordings display correctly after mod changes<\/p>\n
## \ud83d\udd27 How It Works<\/p>\n
1. **Startup Check**: When a world loads, the mod reads the saved mod list from `level.dat`
\n2. **Comparison**: Compares the saved mod list with currently loaded mods
\n3. **Detection**: Identifies any additions, removals, or version changes
\n4. **Optimization**: Automatically runs the world optimization process if changes are detected
\n5. **Completion**: World starts normally with updated ID mappings<\/p>\n
## \ud83d\udccb Requirements<\/p>\n
– **Minecraft**: 1.20.1
\n– **Forge**: 47.4.0 or higher
\n– **Java**: 17+<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
1. Download the latest release from the releases page
\n2. Place `worldoptimiser-1.0.jar` in your `mods` folder
\n3. Start your server\/world – the mod will automatically handle optimization when needed<\/p>\n
## \ud83c\udfae Usage<\/p>\n
No configuration required! The mod works automatically:<\/p>\n
– Install the mod
\n– Add\/remove other mods as needed
\n– Start your world – optimization happens automatically if mod changes are detected
\n– Your ReplayMod recordings will now display correctly<\/p>\n
## \ud83d\udcdd Log Output<\/p>\n
When the mod detects changes, you’ll see messages like:
\n“`
\n[Server thread\/WARN] [worldoptimiser]: Detected new mods world will be optimised on startup
\n[Server thread\/INFO] [worldoptimiser\/worldupgrader]: World will be optimised it may take a while, please wait…
\n[Server thread\/INFO] [worldoptimiser\/worldupgrader]: World optimisation complete
\n“`<\/p>\n
## \ud83d\udc1b Known Issues<\/p>\n
– World optimization can take some time for large worlds
\n– The process blocks world startup until completion (this is necessary for proper ID remapping)<\/p>\n
## \ud83d\udc68\u200d\ud83d\udcbb Created For<\/p>\n
This mod was specifically created for **@protagnst** to solve ReplayMod compatibility issues in their content creation workflow.<\/p>\n
## \ud83d\udcbc Custom Development<\/p>\n
Need a custom mod solution for your specific use case? I’m available for hire for custom Minecraft mod development and similar technical solutions.<\/p>\n
**Contact**: Available for custom development work – reach out if you have similar issues that need solving!<\/p>\n
## \ud83d\udcc4 Technical Details<\/p>\n
– **Mod ID**: `worldoptimiser`
\n– **Version**: 1.0
\n– **Author**: Pelotrio
\n– **License**: All Rights Reserved<\/p>\n
### Compatibility Note
\nThis issue was specific to ReforgedPlay Mod v0.3.1 on Forge 1.20.1. Previous versions (Forge 1.16.5 and Fabric versions) handled ID changes automatically, but this functionality was lost in the 1.20.1 Forge version.<\/p>\n
## \ud83d\udd27 For Developers<\/p>\n
The mod hooks into Forge’s mod loading events and world startup to:
\n– Detect mod list changes via `ModMismatchEvent`
\n– Read\/compare mod lists stored in world NBT data
\n– Trigger Minecraft’s built-in `WorldUpgrader` when needed
\n– Ensure compatibility with ReplayMod’s block ID system<\/p>\n
—<\/p>\n
*This mod solves a specific technical issue with ReplayMod compatibility. If you’re experiencing similar block ID or texture mapping issues after mod changes, this tool automates the manual optimization process that was previously required.*<\/p>\n","protected":false},"excerpt":{"rendered":"
A Minecraft Forge mod that automatically optimizes worlds when mod changes are detected, specifically designed to solve ReplayMod block ID mismatch issues.<\/p>\n","protected":false},"featured_media":171579,"template":"","meta":{"_minecraft_slug":"worldoptimiser","_minecraft_project_id":"tusgSpOV","_minecraft_author":"Pelotrio","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":2172,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"worldoptimiser.zip","_minecraft_size_bytes":7097,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:04:45.179374Z","_minecraft_date_created":"2025-09-24T05:04:58.859581Z","_minecraft_date_modified":"2025-09-17T23:39:38.803066Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/worldoptimiser","_minecraft_icon_attachment_id":171579,"_minecraft_imported_at":"2026-06-09T21:31:36+00:00","_minecraft_import_hash":"15f710e04d2911c21710ba84028d8d39","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[104,126,90,123],"mod_loader":[106],"minecraft_version":[36,60,93,94,101,102],"class_list":["post-171578","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-forge","mod_category-management","mod_category-optimization","mod_category-technology","mod_loader-forge","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6"],"yoast_head":"\n