Skip to content

Blueprints: fill storage, what copy air/nowater do, entity height - #135

Merged
tastybento merged 1 commit into
masterfrom
docs/blueprint-fill
Nov 16, 2026
Merged

tastybento merged 1 commit into
masterfrom
docs/blueprint-fill

Conversation

@tastybento

Copy link
Copy Markdown
Member

Summary

Documents the blueprint changes in BentoBox 3.23.8: BentoBoxWorld/BentoBox#3117 (merged) and BentoBoxWorld/BentoBox#3118 (open).

Blueprints guide (BentoBox/Blueprints.md)

  • New What air and nowater do section: without air, the rest of the area is left as it is in the world; with air, the whole area replaces it, and since 3.23.8 the most common block (air, or water for a sea island) is stored once, so a big air copy is no longer a big file. air nowater can't use that, so air is stored block by block.
  • Troubleshooting: dropped "keep the selection tight, as air makes the file bigger"; added an entry for boats that sink / mobs stuck in slabs in blueprints copied before 3.23.8.

Blueprint File Format (BentoBox/Blueprint-Format.md), spec 2.1

  • fill, fillMin, fillMax, plus a Compact blueprints (fill) section: when a fill is used, how to paste it, compatibility both ways, and an example.
  • Entity y: the height within the block, used since 3.23.8.
  • Sizes count both corner blocks.
  • Serialization rules: empty Vector-keyed maps are written as {}, not [].

Checks

🤖 Generated with Claude Code

- Blueprints guide: new "What air and nowater do" section. A copy with
  air no longer makes a large file (the most common block is stored once
  since 3.23.8); air + nowater still stores air block by block. Drop the
  "keep the selection tight" advice; add a troubleshooting entry for boats
  that sink / mobs stuck in slabs in blueprints copied before 3.23.8.
- Blueprint File Format, spec 2.1: fill, fillMin, fillMax with a
  "Compact blueprints" section and example; entity y height; inclusive
  sizes; empty Vector-keyed maps are written as {}.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant