Chunkmaster 1.3.2

A chunk pregeneration plugin for 1.14 and above.

  1. Trivernis
    Native Minecraft Version:
    1.14
    Tested Minecraft Versions:
    • 1.14
    • 1.15
    • 1.16
    Source Code:
    https://github.com/Trivernis/spigot-chunkmaster
    Languages Supported:
    German Mandarin French
    Chunkmaster_banner.png
    [​IMG]

    This plugin can be used to pre-generate the region of a world around the spawn chunk.

    Important: With Beta Release 0.16 the command syntax changed!

    Features
    • Pregeneration of a specific area around the world center
    • Configuration of world centers
    • Integration into dynmap
    • Teleportation to chunks
    • Auto-Pause when the server is not empty
    • Highly configurable
    • Skipping of already generated chunks

    Commands

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

    • /chunkmaster generate [world] [radius] [<square|circle>]: 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|world>: 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 chunkcoordinates
    • /chunkmaster setCenter [[<world>] <chunkX> <chunkZ>]: Sets the center chunk of the world
    • /chunkmaster getCenter [<world>]: Returns the center chunk of the world
    Examples
    Generate a 100 blocks * 100 blocks square around the center:

    /chm generate [world] 50
    Generate 200 blocks in every direction from the center:
    /chm generate [world] 200
    Generate a circle with a diameter of 1000 around the center:
    /chm generate [world] 500 circle

    Config File

    # The language settings.
    # Supported out of the box are german (de), mandarin (zh), french (fr) and english (en).
    # Additional languages can be configured in the plugins folder under i18n.
    # The file name must be in the format <language>.i18n.properties and the content
    # must be in the java-property-file format.
    # For non-defined translations the default (english) version is used.
    # For built-in support please create a PullRequest with your translation.
    language: en

    # Actiates/deactivates the dynmap integration.
    # With the setting set to 'true' the plugin tries to trigger the rendering
    # of generated chunks right before unloading them. It also adds an area
    # marker to the dynmap to show the area that will be pregenerated.
    # The marker is removed automatically when the task is finished or canceled.
    # The value should be a boolean <true/false>
    dynmap: true


    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: 1000

    # 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
    # bigger performance impact. Configuring it too hight might crash the server.
    # The value should be a positive integer.
    max-pending-chunks: 500

    # The period in ticks for how often loaded chunks get unloaded.
    # Unloading happens in the main thread and can impact the server performance.
    # You can tweak this setting with the max-loaded-chunks setting to have either
    # a lot of chunks unloaded at once or fewer chunks unloaded more often.
    # If the maximum number of loaded chunks is reached the generation pauses until the
    # unloading task runs again so keep that in mind.
    # The value should be a positive integer.
    unloading-period: 50

    # 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

    # Pauses the generation if the number of players on the server is larger or equal
    # to the configured value
    # Notice that playing on a server that constantly generates chunks can be
    # very laggy and can cause it to crash.
    # The value should be a posivitve integer > 1.
    pause-on-player-count: 1

    # if the generation should automatically start on server startup
    # the value should be a boolean
    autostart: true

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

    Translation
    The Mandarin translation is provided by NPBeta and was validated by ed3d3d.

    The French translation is provided by Corenb and was validated by Fiwel00 and Youssef Habri.

    The German and English translation is provided by me. You can translate the plugin yourself and start a PR to this repository to add it to the provided translation.

    1. create an i18n folder in the Chunkmaster folder (plugins/Chunkmaster)
    2. copy the default translations file into the newly created folder and rename it to .i18n.properties
    3. modify the values in the file for your translation (you can use minecraft § formatting sequences)
    4. set the language property in the config file to your language abbrevation
    5. start the server
    Now you should see your translation being used by the plugin for localized messages.


    Dynmap Integration
    Starting with version Beta 0.15 the plugin integrates with dynmap if the dynmap plugin is detected. It triggers the rendering of tiles for the chunks that have been generated and displays the generation area as a marker on the map.


    feature_dynmap-integration-1.png

    The dynmap rendering process is slower than the chunk generation, so you can't expect to have a fully rendered map after the chunk generation has finished. You can check how many tiles are still waiting to be processed with /dynmap stats. If there aren't any pending chunks and the map is still not fully rendered you have to force the rerendering the map by using /dynmap fullrender <world>.

    Questions/Bugs/Feature Requests
    For bugs you've discovered or just features you want it to have please open an issue on Github.

    For questions you can also join my discord server or contact me at support[at]trivernis[dot]net.

    bStats

    This plugin uses bStats to gain insights on how you use this plugin.You can opt out using the global bStats config.


    [​IMG]

Recent Reviews

  1. Process
    Process
    5/5,
    Version: 1.3.2
    Perfect plugin!
    It's so perfect that I want to introduce it to a Chinese Minecraft forum(www.mcbbs.net).I am looking forward to your allowance.
    Meanwhile,I will stress the original forum(spigotmc) and the author(You).
    Thanks a lot! :D
  2. npbeta
    npbeta
    5/5,
    Version: 1.2.2
    Awesome plugin and awesome author. The plugin is easy to use and no bugs. The author is very friendly. Thanks!
  3. Meza
    Meza
    5/5,
    Version: 1.2.1
    I use this plugin to pre-generate resource worlds each month. I've tried a few in that pursuit, and this one was by far the best tool for the job!
  4. melonzio
    melonzio
    5/5,
    Version: version 1.0.1
    P E R F E C T


    this is more faster than worldborder, thanks!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  5. PowerMasterYT
    PowerMasterYT
    5/5,
    Version: version 1.0.1
    Chunkmaster does what it was created to do, no errors at all. Lower's the tps a little while doing it, but that's a given considering how it's loading chunks.
  6. Bigg_Daddyy
    Bigg_Daddyy
    5/5,
    Version: version 1.0.1
    Wonderfull just wonderfull i been looking for something like this for soooo long Thanks mate <3
  7. JoeyPlayzTV
    JoeyPlayzTV
    5/5,
    Version: version 1.0.1
    Very fast NO LAG nice auto complete and very easy to understand. Clean and beautiful, lightweight and awesome. Thanks for making it. Please keep up this good work. You will help a lot of servers with that.
  8. Klausar
    Klausar
    5/5,
    Version: version 1.0
    This is the best chunk generation plugin! Thanks to the developer for creating and maintaining it.
  9. EchoRapidz
    EchoRapidz
    5/5,
    Version: version 1.0
    The best chunk generation plugin for 1.14-1.16 servers.

    This plugin is awesome, it's just like worldborder, but a lot more optimized.
    It's really fast and with the recent update it's even faster (24 chunks/sec for me) The dynmap integration is really helpful although it does like to leave a lot of gaps, not sure if that's dynmaps fault or chunkmaster.

    If you're in need of an optimized chunk generation plugin, this is the one.
    5*
  10. TattlingElk
    TattlingElk
    5/5,
    Version: 0.15-Beta
    Compared to other plugins that do the same this one performs the best so far. Nice and fast with barely any tps loss. And it gives an ETA so you know how long it will roughly take.