Q: I installed TerraformGenerator, why isn't it working?
A: Here are a common reason why:
- You didn't follow methods 1 or 2. These methods are needed in order for TerraformGenerator to generate the world.
If you did fix suggested above, you should find the startup log of TerraformGenerator, and the reason why it's disabled/not working should be there. You can always join our discord server for further support
Q: What is pregeneration and when should I do it?
A: When using terraformgenerator, it is heavily recommended to always pregenerate. The plugin was not designed with live generation. Pregeneration is pre-emptively generating your world's chunks up to a certain world border that you set, so players don't trigger chunk generation when they play. This is so the plugin will never cause lag in your server's live environment where players are trying to play the game.
Q: How do I pre-generate the world?
A: There are a lot of plugins that can do this, I'll list some of them:
-
Fast Chunk Pregenerator -
/fcp start <radius> [worldName] -
Chunkmaster -
/chm generate [worldName] <radius> -
Chunky -
/chunky radius <radius>then/chunky start
The commands listed can be used. However, we recommend taking a look at their respective wiki/spigot page for more information. Pregenerating the world may take some time, and a bit of resources. We don't recommend pre-generating while players are online.
Q: I got an error in the console. What should I do?
A: Depends on the error.
[14:03:15] [Paper Watchdog Thread/ERROR]: --- DO NOT REPORT THIS TO PAPER - THIS IS NOT A BUG OR A CRASH - git-Paper-344 (MC: 1.16.4) ---
[14:03:15] [Paper Watchdog Thread/ERROR]: The server has not responded for 10 seconds! Creating thread dump
[14:03:15] [Paper Watchdog Thread/ERROR]: ------------------------------
[14:03:15] [Paper Watchdog Thread/ERROR]: Server thread dump (Look for plugins here before reporting to Paper!):
If you get this message during pregeneration, you can apply the fix below if it's too spammy.
If you didn't pregenerate, and you're getting this error, go pregenerate. If you did not pregenerate, do not apply the fix below, it will not fix your lag. Pregeneration is the only way to fix lag caused by TerraformGenerator.
You can suppress this stack trace by making the following changes in paper.yml:
watchdog:
early-warning-every: 5000000
early-warning-delay: 10000000
This will effectively disable watchdog. After you're done with all the world generation, turn those settings back to their originals. The watchdog is meant to detect sources of lag and to stop the server if it detects a long freeze. World generation is already known to be a laggy process, so we don't want watchdog warning us that world generation is laggy. So while pregenerating, it may be a good idea to suppress watchdog, especially if your machine has very little memory or a slow cpu.
If the errors result in players being kicked out because the server is shutting down, or you get an internal error of some sort, you have probably encountered a bug. You can get support and report bugs in discord. If it looks like paper's watchdog terminated the server, you can apply the fix above in server freezes.
A note on CraftBukkit
Using TerraformGenerator on a Server running CraftBukkit may not work and could crash the server.
We recommend you use Paper as it improves performance compared to CraftBukkit and Spigot.
