Area Scale
将任意结构以你所需的任意比例捕获到一个便携物品中,然后将其作为微型/巨型模型展示,或还原到其原始尺寸放置。专为希望随身携带建筑作品、展示它们或在服务器上交易它们的玩家打造(出售紧凑型农场、商店设计、基地蓝图……)。
工作原理
1. 选择区域
制作或找到选择法杖(木棍 + 钻石,对角线合成)。左击一个方块设置角点 1,右击一个方块设置角点 2 —— 线框盒会实时显示你的选择范围。
更喜欢输入精确数值?在已有选区的情况下按下 U(可在“选项 > 控制”中的 Area Scale 里重新绑定),打开一个极简覆盖层,以六个可点击的按钮形式显示 X/Y/Z 的实际数值 —— 没有菜单装饰,背景除了浅色可读面板外完全透明,确保世界和线框盒保持完全可见。左击数值加 1,右击减 1(按住 Shift 键则 +/-10)。
2. 捕获结构
运行 /areascale expand <factor> 或 /areascale shrink <factor>(例如 /areascale shrink 4 表示 1/4 比例,/areascale expand 3 表示 3 倍)。这会移除原始方块并给你一枚结构胶囊(Structure Capsule)—— 一个包含所有内容的单一物品:每个方块、箱子/潜影盒内容、告示牌文字、刷怪笼设置,以及选区内任何盔甲架、生物或其他实体。
3. 展示它
放置展示平台(3 个石台阶排成一行),并用装满的结构胶囊右击它。整个结构会作为按比例缩放的模型出现在其上方 —— 真正可以是任意大小,因为它使用的是显示实体而非真实方块进行渲染。它会旋转至与你放置时面朝的方向一致。空手右击即可将其收回。
4. 或者将其还原放置
放置结构放置器(石台阶 / 指南针 / 石台阶),并用胶囊右击它以查看结构在真实、未缩放尺寸下的发光幽灵预览 —— 因为一个功能正常的农场必须以其实物尺寸建造,而不是模型的装饰性比例。再次右击确认:它将放置每个方块,恢复容器内容和方块实体数据,并在原处重生被捕获的实体。如果有障碍物阻挡,它会提示你且不会消耗胶囊。
5. 撤销,如果你改变主意
/areascale undo(仅限创造模式)可撤销你最近的一次捕获操作。
服务器管理员可配置项
config/areascale.json: 设置 maxCaptureBlocks(0 = 无限制)以限制单次捕获的最大规模。
- 挖空处理(跳过模型中永远不会被看到的内部方块)是通过几何计算完成的,而非硬编码列表 —— 但
data/areascale/tags/block/ 附带了两个空标签(never_occludes / always_occludes),以便你在需要时手动覆盖特定方块的行为。
已知限制
- 床、箱子、潜影盒、站立/墙壁告示牌、旗帜和装饰陶罐在模型中会渲染为粗糙的占位符 —— 这是原版渲染引擎对装饰性显示实体的限制,并非数据丢失(它们的真实数据在胶囊中得到完整保留)。使用结构放置器实际放置后,它们看起来完全正确。
- 水和熔岩在模型中显示为半透明的彩色玻璃,原因相同(流体渲染无法在悬浮的显示实体上运行) —— 使用结构放置器实际放置时流体会正确呈现。
- 被捕获的实体(生物、盔甲架等)在模型中完全不显示 —— 因为它们脚下没有地板支撑 —— 但它们的数据会被保留,并且在结构被实际放置的瞬间被正确重建。
- 模型纯粹是装饰性的 —— 没有碰撞体积,也无法被挖掘。
依赖项
许可证
GPL-3.0。允许在个人世界和私有服务器上免费使用。如果你在商业化服务器或商业化内容中使用本模组,建议注明对本项目的致谢。
Area Scale
Capture any structure into a portable item at whatever scale you want then either put it on display as a miniature/giant diorama, or place it back down at its original size. Built for players who want to carry builds around, show them off, or trade them on a server (sell a compact farm, a shop design, a base blueprint...).
How it works
1. Select an area
Craft or find the Selection Wand (stick + diamond, crafted diagonally). Left-click a block to set corner 1, right-click a block to set corner 2 - a wireframe box shows your selection live.
Prefer typing exact numbers? Press U (rebindable in Options > Controls > Area Scale) with a selection active to open a minimal overlay showing the six X/Y/Z values as real clickable buttons - no menu chrome, no dark background beyond a light legibility panel, so the world and the wireframe box stay fully visible. Left-click a value to +1 it, right-click to -1 (hold shift for +/-10).
2. Capture it
Run /areascale expand <factor> or /areascale shrink <factor> (e.g. /areascale shrink 4 for 1/4 scale, /areascale expand 3 for 3x). This removes the original blocks and gives you a Structure Capsule - a single item holding everything: every block, chest/shulker contents, sign text, spawner settings, and any armor stands, mobs, or other entities that were inside the selection.
3. Display it
Place a Display Platform (3 stone slabs in a row) and right-click it with a filled capsule. The whole structure appears above it as a scaled diorama - genuinely any size, since it's rendered with display entities rather than real blocks. It rotates to face whichever way you were looking when you placed it. Right-click empty-handed to pick it back up.
4. Or place it back down
Place a Structure Placer (stone slab / compass / stone slab) and right-click it with a capsule to see a glowing ghost preview at the structure's real, unscaled size - because a functioning farm needs to be built at its real size, not a diorama's cosmetic scale. Right-click again to confirm: it places every block, restores container contents and other block entity data, and respawns captured entities exactly where they were. If something's in the way, it tells you and doesn't consume the capsule.
5. Undo, if you change your mind
/areascale undo (creative mode only) reverts your most recent capture.
Configurable for server admins
config/areascale.json: set maxCaptureBlocks (0 = unlimited) to cap how large a single capture can be.
- Hollowing (skipping interior blocks that could never be seen in the diorama) is computed geometrically, not from a hardcoded list - but
data/areascale/tags/block/ ships two empty tags (never_occludes / always_occludes) if you ever need to override a specific block manually.
Known limitations
- Beds, chests, shulker boxes, standing/wall signs, banners, and decorated pots render as a rough placeholder in the diorama specifically - a vanilla rendering-engine limitation of decorative display entities, not data loss (their real data is fully preserved in the capsule). They look completely correct once placed for real with the Structure Placer.
- Water and lava show up as translucent colored glass in the diorama for the same reason (fluid rendering can't run on a floating display entity) - real fluid places correctly with the Structure Placer.
- Captured entities (mobs, armor stands, etc.) aren't shown in the diorama at all - there's no floor there for them to stand on - but their data is preserved and they're reconstructed correctly the moment the structure is placed for real.
- The diorama is purely decorative - no collision, can't be mined.
Requirements
License
GPL-3.0. Free to use on personal worlds and private servers. If you're using it on a monetized server or in monetized content, a credit back to this project is appreciated.
评论 0
登录后参与评分
还没有评论,来抢沙发吧