Chunk Utilities
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Trivernis a4115ebdf7 Add ETA to periodic reports
Closes #17
5 years ago
.circleci Add ignore-worldborder config option 5 years ago
src/main Add ETA to periodic reports 5 years ago
.gitignore Add ignore-worldborder config option 5 years ago
LICENSE Add ignore-worldborder config option 5 years ago
README.md Update Readme 5 years ago
build.gradle Add ignore-worldborder config option 5 years ago
gradle.properties Added Spiral class 5 years ago
settings.gradle Add ignore-worldborder config option 5 years ago

README.md

chunkmaster

This plugin can be used to pre-generate the region of a world around the spawn chunk(s). The generation automatically pauses when a player joins the server (assuming the server was empty before) and resumes when the server is empty again. The generation also auto-resumes after a server restart. The plugin tracks the ticks per second and pauses the generation when the tps is lower than 2 (configurable).

Commands

All features can be accessed with the command /chunkmaster or the aliases /chm, chunkm, cmaster.

  • /chunkmaster generate [world] [chunk count] [unit] Starts the generation until the specified chunk count or the world border is reached.
  • /chunkmaster list Lists all running generation tasks
  • /chunkmaster cancel <Task id> Cancels the generation task with the specified id (if it is running).
  • /chunkmaster pause Pauses all generation tasks until the resume command is executed.
  • /chunkmaster resume Resumes all paused generation tasks.
  • /chunkmaster reload Reloads the configuration file.
  • /chunkmaster tpchunk <X> <Z> Teleports you to the specified chunk coordinates.

Config

generation:

  # If set to true the plugin ignores the vanilla world border and doesn't stop
  # the chunk generation when reaching it.
  # The value should be a boolean <true/false>
  ignore-worldborder: false

  # The maximum amount of chunks that are loaded before unloading and saving them.
  # Higher values mean higher generation speed but greater memory usage.
  # The value should be a positive integer.
  max-loaded-chunks: 10

  # Paper Only
  # The maximum amount of requested chunks with the asynchronous paper chunk
  # loading method. Higher values mean faster generation but more memory usage
  # (and probably bigger performance impact).
  # The value should be a positive integer.
  max-pending-chunks: 10

  # The period (in ticks) in which a generation step is run.
  # Higher values mean less performance impact but slower generation.
  # The value should be a positive integer.
  period: 2

  # The max amount of chunks that should be generated per step.
  # Higher values mean higher generation speed but higher performance impact.
  # The value should be a positive integer.
  chunks-per-step: 4

  # Paper Only
  # The number of already generated chunks that will be skipped for each step.
  # Notice that these still have a performance impact because the server needs to check
  # if the chunk is generated.
  # Higher values mean faster generation but greater performance impact.
  # The value should be a positive integer.
  chunk-skips-per-step: 100

  # The maximum milliseconds per tick the server is allowed to have
  # during the cunk generation process.
  # If the mspt is greather than this, the chunk generation task pauses.
  # The value should be a positive integer greater than 50.  
  mspt-pause-threshold: 500

  # If the chunk generation process should pause on player join.
  # Notice that playing on a server that constantly generates chunks can be
  # very laggy and can cause it to crash.
  # You could configure the values above so that the performance impact of the generation
  # process is minimal.
  # The value should be a boolean <true/false>
  pause-on-join: true

Spigot and Paper

The plugin works on spigot and paper servers but is significantly faster on paper servers (because it profits from asynchronous chunk loading an the better implementation of the isChunkGenerated method).