Ofon's Dimensional Borders & Pregeneration (ODBP)

Ofon's Dimensional Borders & Pregeneration

Ofon's Dimensional Borders & Pregeneration, or ODBP, is a server administration mod designed to combine independent world borders and persistent pregeneration jobs into one command system.

The main goal of ODBP is to make it easier to manage large worlds with multiple dimensions without needing to repeatedly set up separate tools or manually keep track of which dimension is being pregenerated.

ODBP is still a work in progress. Features, commands, performance behavior, and user interface elements may continue to change as the mod is tested and developed.

World Borders

ODBP allows separate world borders to be configured for individual dimensions.

This means the Overworld, Nether, End, and compatible modded dimensions can each have their own border size and center instead of sharing one global border configuration.

World border sizes use diameter, matching the way vanilla Minecraft describes world border size.

For example:

/odbp worldborder overworld 100000

This creates an Overworld border with a diameter of 100,000 blocks.

You can inspect the configured border with:

/odbp worldborder overworld

You can view all configured borders with:

/odbp worldborder list

The shorthand command:

/odbp list

shows the same world border overview.

Pregeneration

ODBP also provides persistent pregeneration jobs for individual dimensions.

Each dimension can have its own saved pregeneration job and progress. Only one dimension actively pregenerates at a time, but jobs in other dimensions remain saved.

This allows an administrator to pause one dimension and resume another without losing the progress of either job.

Pregeneration currently uses a square generation area matching the configured square world border. Additional pregeneration shapes may be considered in the future.

Pregeneration proceeds outward from the configured world border center rather than beginning at the outside edge of the world.

Starting Pregeneration

Before beginning pregeneration, configure an ODBP world border for that dimension.

For example:

/odbp worldborder overworld 100000

Then start pregeneration with:

/odbp pregen overworld start

A priority can also be specified:

/odbp pregen overworld start low

/odbp pregen overworld start medium

/odbp pregen overworld start high

/odbp pregen overworld start extreme

Pregeneration Priorities

LOW is designed for background pregeneration while people are actively using the server.

LOW automatically adjusts how much pregeneration work it submits depending on server activity.

When nobody is online, LOW can use a work window of up to 32 concurrent chunk generation requests.

When players are online, LOW limits itself to a maximum work window of 16.

When players are actively traveling across chunks and potentially causing normal gameplay chunk loading, LOW reduces its maximum work window to 8.

LOW can reduce itself even further when server tick health begins to deteriorate.

When player activity stops, LOW gradually increases its work window again instead of immediately returning to maximum load.

The purpose of LOW is to allow long pregeneration jobs to continue in the background without requiring an administrator to constantly pause and resume them whenever someone joins the server.

MEDIUM provides a more balanced pregeneration mode with a maximum work window of 64 concurrent chunk requests.

HIGH provides aggressive pregeneration with a maximum work window of 96 concurrent chunk requests.

EXTREME allows a maximum work window of 128 concurrent chunk requests and is intended primarily for maximum throughput when the server is otherwise idle.

EXTREME does not mean that Minecraft will generate 128 chunks per second or use 128 CPU threads. The work window controls how many chunk generation requests ODBP is willing to keep in progress at once.

Minecraft, NeoForge, C2ME if installed, world generation mods, storage performance, available CPU resources, and other server activity ultimately determine how quickly those requests are completed.

EXTREME may become increasingly useful on future processors and servers with more available multithreaded world generation capability than even current high end desktop processors such as the Ryzen 9 9950X can provide. Its larger work window is intentionally available for systems that can benefit from greater parallelism rather than assuming that every current system will benefit from using it.

Managing Pregeneration Jobs

To see all saved pregeneration jobs:

/odbp pregen list

To view detailed information for one dimension:

/odbp pregen overworld

The following command provides the same detailed status information:

/odbp pregen overworld status

To pause a running job:

/odbp pregen overworld pause

To resume it later:

/odbp pregen overworld resume

To change its priority while preserving the job:

/odbp pregen overworld priority low

/odbp pregen overworld priority medium

/odbp pregen overworld priority high

/odbp pregen overworld priority extreme

To cancel and remove the saved pregeneration job:

/odbp pregen overworld cancel

Canceling an ODBP pregeneration job does not delete chunks that have already been generated.

Persistent Jobs

Pregeneration jobs are saved independently for each dimension.

Only one job may actively generate at a time.

An administrator can pause one dimension and resume another to switch pregeneration work without losing saved progress.

After a server restart or singleplayer world restart, unfinished pregeneration jobs remain PAUSED until they are explicitly resumed.

Normal server shutdown using /stop and normal Save and Quit are safe.

When practical, it is recommended to pause an active pregeneration job before force closing or abruptly terminating the server or game. This allows outstanding work to finish and gives ODBP the cleanest possible stopping point.

Pregeneration Statistics

ODBP provides detailed statistics for active pregeneration jobs.

Processed represents the total number of chunk positions ODBP has finished handling.

Generated represents chunks that ODBP actually had to generate to full chunk status.

Existing represents chunks that were already fully generated when ODBP reached them, allowing ODBP to skip generating them again.

Failed represents chunks that ODBP attempted to generate but could not successfully complete because Minecraft, world generation, or another mod returned an error.

A failed chunk does not automatically mean that the chunk is corrupted. The server log should be checked for the underlying error.

The relationship between these statistics is:

Processed = Generated + Existing + Failed

ODBP displays short term, 30 second, 5 minute, and session chunk rates to make it easier to understand how a pregeneration job is performing.

Color Coding

ODBP uses color coding throughout its commands and status information to improve readability.

Processed information is displayed in aqua.

Generated information is displayed in green.

Existing chunk information is displayed in yellow.

Failed chunk information is displayed in red.

Dimensions, pregeneration priorities, progress information, warnings, and command actions also use consistent colors where practical so large status displays are easier to read quickly.

Performance and C2ME

ODBP does not attempt to replace C2ME.

ODBP controls which chunks should be pregenerated, when pregeneration work should be submitted, how aggressively that work should be submitted, and how progress is saved.

Minecraft and compatible optimization mods such as C2ME remain responsible for the actual chunk generation and threading behavior.

ODBP is designed to work without C2ME, but servers using C2ME may benefit significantly from its ability to perform world generation work across multiple CPU threads.

Server and Client Requirements

ODBP is currently intended to function as a server side administration mod.

Normal players do not currently need ODBP installed on their clients in order to join a server using it.

Administration commands require operator permission level 2.

A client side component may become useful in a future version if ODBP receives a graphical administration interface.

One planned possibility is an administrator HUD or menu with dropdown controls for selecting dimensions, pregeneration priority, world border settings, and other options before starting or managing a job.

If such an interface is added, the client component would be intended for administrators using the graphical interface while the server would remain authoritative over all ODBP actions and permissions.

Help Commands

For general ODBP help:

/odbp help

For world border help:

/odbp help worldborder

For pregeneration help:

/odbp help pregen

For a list of loaded and available dimension names:

/odbp dimensions

Work In Progress

Ofon's Dimensional Borders & Pregeneration is still actively being developed and tested.

The current focus is reliable world border management, persistent multidimensional pregeneration, understandable status information, good performance, and allowing background pregeneration to coexist with normal server gameplay.

Additional quality of life features, administration tools, pregeneration options, performance improvements, and an optional graphical interface may be added as development continues.

Feedback, bug reports, compatibility reports, and performance results from different hardware configurations are welcome.