Skip to main content

BetterStructures Setup

BetterStructures still supports manual imports, but the current recommended workflow is Nightbreak-first and in-game.

Requirements​

  • WorldEdit or FAWE-compatible schematic support
  • Java 21 runtime for the current build line
  1. Install BetterStructures and WorldEdit, then start the server once.
  2. Run /bs initialize.
  3. Link a Nightbreak token with /nightbreaklogin <token>.
  4. Open /bs setup to browse structure packs and module packs.
  5. Use /bs downloadall for a quick bootstrap (it grabs a pending plugin update and all content).
  6. Use /bs updatecontent when package updates are available.

The Setup Menu​

/bs setup opens a paged menu where packages are split into two filters: Structure Packs and Module Packs. Each package shows whether it is installed, downloaded but not enabled, outdated, or needs Nightbreak access, and clicking it installs/updates it.

Alongside the packages, the menu also exposes shared MagmaCore controls bundled into BetterStructures:

  • Plugin Update - shows whether a newer BetterStructures build is available and lets you download it (a restart applies it).
  • Recommended Plugins - opens the companion-plugin recommendation view (same as /bs recommendedplugins).
  • Automatic Updates - a toggle for whether BetterStructures downloads plugin and content updates automatically on startup. This is off by default and is backed by the nightbreak.autoDownloadPluginUpdates key in config.yml. A restart is still required to apply a downloaded plugin update.

Manual Import Fallback​

Manual imports still work through:

plugins/BetterStructures/imports

Keep package zips intact, then run /bs reload if required.

See the shared guide: Manual imports vs in-game management.