Skip to main content

Blueprint

Every build gets its own world, and every world gets an undo button.

Blueprint is a Paper plugin for running a build server. It creates, imports, clones, renames, and deletes build worlds with one command each, and takes snapshots you can roll back to when a build goes wrong. Every world it manages is set up for building: empty void terrain, permanent daytime, and no mobs.

How it works​

  1. Point Paper at a blueprint/ folder once, in bukkit.yml. Every world, including your main one, lives there from then on.
  2. Run /bp create <name> to make a new build world. You arrive on a small glass platform in an empty void world.
  3. Build. Take a snapshot with /bp snapshot create before any risky change.
  4. When a build is finished, /bp lock it so nobody can change it by accident, or /bp clone it to start a variation.
  5. If something goes wrong, /bp snapshot restore puts the world back exactly as it was.

Key features​

  • One-command worlds - create, import, clone, rename, and delete worlds without touching the file system or restarting.
  • Build-ready by default - new worlds are an empty void with a spawn platform. Every managed world runs at permanent noon, with no mob spawning, mob griefing, raids, or phantoms.
  • Snapshots - copy a world at any moment and restore it later. Blueprint takes an automatic backup before every restore, so a restore can be undone too.
  • Locking - lock a finished world so blocks cannot be placed or broken. Staff with the bypass permission can still edit.
  • Open and close - unload worlds nobody is using to save memory, and load them again when needed. Open worlds are reloaded automatically after a restart.
  • Safe file operations - players are moved out before a world is unloaded, and two operations can never run on the same world at once.
  • Audit log - every create, clone, snapshot, restore, rename, and delete is recorded with who did it.

Where to go next​