1.0.0
Compatibility
Changes
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
- 结构魔杖 / 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)
- 投影与自动建造 / 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
- 导出结构 / Export Structure
在游戏内使用指令导出结构,文件将生成于
config/structural_tools_exports/。 Use in-game commands to export structures; files are generated inconfig/structural_tools_exports/.
- 标准导出 / Standard Export:
/structural_tools export <name> - MMCE 导出 / MMCE Export:
/structural_tools export_mmce <name>
-
安装插件 / Install Plugin
-
打开 Blockbench,进入 文件 -> 插件 -> 从文件加载插件。 Open Blockbench, go to File -> Plugins -> Load Plugin from File.
-
浏览到模组目录并选择: Navigate to the mod directory and select:
tools/blockbench/structural_tools_importer/structural_tools_importer.js -
导入与编辑 / Import & Edit 在 Blockbench 中通过 文件 -> 导入 -> Import Structural Tools Export 加载生成的 JSON 文件进行编辑。 Load the generated JSON file in Blockbench via File -> Import -> Import Structural Tools Export for editing.
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:Llqm1h0K:LciQtUxl"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:Llqm1h0K:LciQtUxl"
}

