Structural Tools

Structural Tools 是一个专为整合包开发者和模组制作者设计的辅助模组。它可以将游戏内的建筑结构导出为 JSON 文件，用于制作多方块结构或自定义机器模型。 Structural Tools is a utility mod designed for modpack creators and developers. It exports in-game structures into JSON files, essential for creating multiblock structures or custom machine models. 主要功能 / Key Features

• 结构导出 / Structure Export: 将选定的区域导出为标准 JSON 数据。 Export selected areas as standard JSON data.
• MMCE 支持 / MMCE Support: 支持导出为 Modular Machinery Community Edition (MMCE) 格式，用于定义机器结构。 Supports exporting to Modular Machinery Community Edition (MMCE) format for defining machine structures.
• 轻量级 / Lightweight: 仅在服务端或单人游戏需要，专注于结构数据处理。 Server-side/Single-player only, focused purely on structure data processing.

游戏内操作 / In-Game Usage

1. 结构魔杖 / Structure Wand 使用 Structure Wand 物品进行选区和操作。 Use the Structure Wand item for selection and interaction.

• 选区操作 / Selection:
  • Right-Click: 设置选区点 2 (Set Pos 2)
  • Shift + Right-Click: 设置选区点 1 (Set Pos 1)
  • Alt + Scroll: 向视线方向扩展/收缩选区 (Expand/Contract selection in looking direction)

2. 投影与自动建造 / Projection & Auto-Build 模组提供投影功能，可以将导出的结构投影回世界，并支持在创造模式下自动填充。 The mod offers a projection feature to visualize exported structures in the world, with auto-fill support in Creative Mode.

• 打开投影菜单 / Open Projection Menu:按 P 键 (默认 / Default)
• 调整投影位置 / Adjust Projection:
  • Ctrl + Scroll: 沿视线方向移动投影原点 (Move projection origin along looking direction)
• 自动建造 / Auto-Build:
  • 仅限 创造模式 (Creative Mode only)。
  • 在投影菜单中启用自动填充后，会自动将投影的方块放置到世界中（需手持 Structure Wand）。
  • Enable auto-fill in the projection menu to automatically place projected blocks into the world (requires holding Structure Wand).

Blockbench 插件 / Blockbench Plugin

随模组附带一个强大的 Blockbench 插件 (structural_tools_importer.js)，用于可视化编辑和优化导出的结构。 A powerful Blockbench plugin (structural_tools_importer.js) is included for visual editing and optimizing exported structures.

它能够将复杂的结构转换为低面数的模型，通过智能合并（Smart Merging）和Force Max模式大幅减少方块数量，适合用于预览模型或简化复杂的建筑。 It can convert complex structures into low-poly models, significantly reducing block count via Smart Merging and Force Max modes, ideal for preview models or simplifying complex builds.

插件亮点 / Plugin Highlights

• 智能导入 / Smart Import: 自动合并相邻方块，优化模型面数。 Automatically merges adjacent blocks to optimize polygon count.
• Force Max 模式 / Force Max Mode: 提供极端的模型简化算法（如外壳提取、空腔填充），生成用于预览的超低模。 Offers extreme model simplification algorithms (like shell extraction, cavity filling) to generate ultra-low-poly previews.
• 辅助工具 / Utilities: 包含外壳保护、可见面保留和等比缩放工具。 Includes shell preservation, visible-face retention, and uniform scaling tools.

快速使用 / Quick Usage

1. 导出结构 / Export Structure 在游戏内使用指令导出结构，文件将生成于 config/structural_tools_exports/。 Use in-game commands to export structures; files are generated in config/structural_tools_exports/.

• 标准导出 / Standard Export: /structural_tools export <name>
• MMCE 导出 / MMCE Export: /structural_tools export_mmce <name>

2. 安装插件 / Install Plugin

3. 打开 Blockbench，进入 文件 -> 插件 -> 从文件加载插件。 Open Blockbench, go to File -> Plugins -> Load Plugin from File.

4. 浏览到模组目录并选择： Navigate to the mod directory and select: tools/blockbench/structural_tools_importer/structural_tools_importer.js

5. 导入与编辑 / Import & Edit 在 Blockbench 中通过 文件 -> 导入 -> Import Structural Tools Export 加载生成的 JSON 文件进行编辑。 Load the generated JSON file in Blockbench via File -> Import -> Import Structural Tools Export for editing.