Prepares existing Overworld chunks so Minecraft blends new terrain beside them after a seed or generator change.
Original mod by Mauro0805. Maintained by Mauro0805 and SasnycoN.
ForceBlend prepares existing Overworld chunks so Minecraft can blend new terrain beside them after a seed or generator change, a chunk import or a deletion. It prepares the existing side of the border. It does not generate terrain, change seeds or smooth a border whose two sides already exist. Back up important worlds before use.
Paper 1.21.9 can hang when the server stops, even without ForceBlend. This is a Paper bug, so ForceBlend 1.3.0 was not tested on 1.21.9. Use Paper 1.21.10 or newer.
Preparing the main world
Putting the jar in plugins/ does not prepare your main world. Minecraft locks the main world while the server runs, and ForceBlend never works around that lock. The main world is prepared by running the same jar as a command before the server starts. If your host does not let you run a command before Minecraft, you cannot prepare the main world with the plugin.
- Stop the server and close any world editors. Keep your own backup of worlds you care about.
- Put
ForceBlend-bukkit-1.3.0.jarnext to the server jar, together with the settings fileforceblend-settings-and-acceptance.properties. - Fill in
worldsand the exactminecraft-version, read the comments in the file, then setaccept-world-preparation=true. - From the server directory run the command below, and start Minecraft only if it exits with code 0.
java -Xmx128m -jar ForceBlend-bukkit-1.3.0.jar --settings forceblend-settings-and-acceptance.properties
Put that exit-code check in your startup script or panel, so a failed preparation never leads to the world being opened. A full backup is always made before any world file changes.
In plugins/ the jar can analyze worlds without changing them, or prepare extra worlds that are not loaded. Those settings are in plugins/ForceBlend/config.yml. Preparing from inside the server only works when ForceBlend is the only plugin, and it refuses any world that is locked. The command before startup has no such limit.
The preparation runs in a separate process with 512 MiB of memory by default. To give it more, add -Dforceblend.workerHeapMiB=1024 before -jar (256 to 4096 MiB), and leave enough RAM for the server and the OS.
Removing the plugin
Stop the server, delete the jar from plugins/, and take the ForceBlend command and its exit-code check out of your startup script. You can delete the settings and completion files too, but keep the backups. Minecraft reads prepared chunks and blends new terrain without ForceBlend installed.
Tested versions
Version 1.3.0 was tested once on every Minecraft release from 1.18 to 26.3, each time on Paper, Purpur or Spigot. 1.20.3, 1.21.2 and 26.1 had no server build to test with. Folia, other forks and setups with world-management plugins are not supported.
Fabric and NeoForge
ForceBlend is also a Fabric and NeoForge mod for singleplayer and modded servers. Get those files from the GitHub releases. The full documentation is in the README.
ForceBlend is MIT licensed. Any modpack or server may use it without asking.
Pinned Versions
- R1.18–26.3
Pages
Members
1Owner