Skip to main content

Setup video

Required plugins

  • WorldEdit Note: WorldEdit or FastAsyncWorldEdit (FAWE) is required for reading schematic files. BetterStructures is compatible with both WorldEdit and FAWE.

Recommended plugins

Installing content

You are able to create your own content, so this step is not mandatory, but if you wish to install the hundreds of pre-made official BetterStructures builds you can follow these steps:

  1. Go to nightbreak.io (free content), magmaguy.itch.io (free & premium content), or patreon.com/magmaguy (premium content)
  2. Download the content you want
  3. Put the content - still zipped, as you downloaded it - in the folder ~plugins/BetterStructures/imports
  4. Run the command /bs reload

You are done! Structures will now begin spawning in new chunks. Chunks your server has already generated will not be able to get structures!

Useful commands

  • /bs reload - Reload configurations and import new content
  • /bs version - Display plugin version
  • /bs place <schematic> <type> - Test structure placement (valid types: SURFACE, SKY, LIQUID_SURFACE, UNDERGROUND_SHALLOW, UNDERGROUND_DEEP)
  • /bs lootify <treasure> <rarity> <minamount> <maxamount> <chance> - Add items to loot tables
  • /bs pregenerate <location> <shape> <radius> - Pre-generate world chunks with structures

Additional Configuration

Structure Spacing​

Control how densely structures spawn in your world using config.yml settings.

Distance Settings - Minimum blocks between structures of the same type:

  • distanceSurface: 31 blocks (surface structures)
  • distanceShallow: 22 blocks (shallow underground)
  • distanceDeep: 22 blocks (deep underground)
  • distanceSky: 95 blocks (sky structures)
  • distanceLiquid: 65 blocks (ocean/lava structures)
  • distanceDungeon: 80 blocks (modular dungeons)

Offset Settings - Random variation to prevent grid-like patterns:

  • maxOffsetSurface: 5 blocks
  • maxOffsetShallow: 5 blocks
  • maxOffsetDeep: 5 blocks
  • maxOffsetSky: 5 blocks
  • maxOffsetLiquid: 5 blocks
  • maxOffsetDungeon: 18 blocks

To make structures more common, decrease distance values. To make structures rarer, increase distance values.

Changes only affect newly generated chunks.

Performance Tuning​

BetterStructures includes performance controls in config.yml to prevent server lag during structure generation:

modularChunkPastingSpeed (default: 10)

  • Controls chunk pasting speed for modular dungeons
  • Affects how many chunks are processed per tick
  • Adjust based on server performance

percentageOfTickUsedForPasting (default: 0.2)

  • Limits how much server tick time can be used for pasting structures (20% maximum)
  • Lower values = less lag but slower structure pasting
  • Higher values = faster pasting but potential TPS drops
  • Recommended range: 0.1-0.3

For best results, pre-generate your world using Chunky before players explore.

FAQ

Have a problem or question? Check the FAQ!