Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for SasnycoN

Prepares existing Overworld chunks so Minecraft blends new terrain beside them after a seed or generator change.

Report ForceBlend?

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.

  1. Stop the server and close any world editors. Keep your own backup of worlds you care about.
  2. Put ForceBlend-bukkit-1.3.0.jar next to the server jar, together with the settings file forceblend-settings-and-acceptance.properties.
  3. Fill in worlds and the exact minecraft-version, read the comments in the file, then set accept-world-preparation=true.
  4. 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.

Information

Category
World Management
Published
November 16, 2026
License
0Downloads
0Stars

Pinned Versions

Members

1