模拟大都市:筑艺坊

模拟大都市:筑艺坊

为新式模拟器1.21.1构建扩展包管理器

管理

SimCity Expansion(模拟城市扩展)

适用于 New-Simukraft-1.21.1 的建筑扩展包管理器

将原版、Litematica 和 WorldEdit 的建筑结构导入游戏,转换并安装为可建造的 SimuKraft 建筑,在类似 Litematica 风格的管理器中编辑它们,并作为一键式压缩包分享。


为 NeoForge 制作 可在 CurseForge 获取 可在 Modrinth 获取

Minecraft NeoForge 无依赖 版本 许可 源代码


目录

概述

SimCity Expansion 是一个适用于 Minecraft 1.21.1 的 NeoForge 模组,为 New-Simukraft-1.21.1(一个城市建造模组)添加了完整的建筑扩展包工作流程。它允许你从三种常用格式导入建筑,将其转换为 SimuKraft 的可建造格式,通过类似 Litematica 风格的管理器进行组织和编辑,并将其打包为可移植的压缩包,实现一键安装和分享。

与 SimuKraft 的集成是一种纯粹的文件系统约定——该模组将 .sk 和 .nbt 文件写入 <游戏目录>/simukraftbuilding/<类别>/ 下——因此对 SimuKraft 没有编译时依赖。管理器基于 Minecraft 自己的 GUI 工具包构建,无需额外库,并且命令界面也可以在专用服务器上运行。

功能特性

  • 三种建筑格式 — 原版 .nbt、Litematica 的 .litematic(多区域自动合并)以及 Sponge/WorldEdit 的 .schem(v1/v2/v3),全部在安装时转换为 SimuKraft 的原版可建造格式。
  • 稳健的转换 — 旧版建筑会通过游戏的数据修复器进行升级,缺失的模组方块会对照注册表进行检测,方块实体内容(箱子物品栏、告示牌等)会被保留(实体则不保留)。
  • Litematica 风格的管理器(使用 \ 键打开) — 文件树、固定宽度的信息面板、材料列表以及分层预览:嵌入式缩略图、真实方块 3D 场景、等距体素视图和俯视地图。
  • 完整的建筑编辑器 — 放置/破坏/选取/替换、笔刷绘画、带填充/框架/掏空/扩展功能的框选、复制/剪切/粘贴、旋转和镜像、对称轴、撤销/重做、切片平面以及预设视角;可导出为 .litematic 或直接保存并安装。
  • 从世界中捕获 — 在游戏中标记两个角点,将所选区域捕获为蓝图,并可选择包含方块实体内容。
  • 压缩包生态系统 — 通过清单追踪安装/卸载功能、一键将已安装建筑导出为可分享的压缩包、可选的压缩包图标和 index.json 文件清单,以及透传 SimuKraft 原生的职业/交易定义(格式 v2)。
  • 无硬性依赖 — 管理器在 Minecraft 自己的 GUI 工具包上运行,SimuKraft 完全通过文件系统集成,因此两者都不是编译时依赖。
  • 对服务器友好 — /buildpack 命令(操作员等级 2,支持 Tab 补全)可在专用服务器上安装松散文件和压缩包,并捕获区域,复用与 GUI 相同的转换流程。
  • 本地化 — 支持英文、简体中文和繁体中文;数字、日期和文件大小会根据当前游戏语言进行格式化。

要求与安装

要求 版本
Minecraft 1.21.1
NeoForge 21.1.233 或更新版本

将 jar 文件放入你的 mods/ 文件夹——没有其他模组依赖。游戏内管理器可在客户端开箱即用;在专用服务器上,jar 文件以无头模式加载并暴露 /buildpack 命令。

打开管理器

在游戏中按下 \(反斜杠)键。所有按键绑定均可在 选项 -> 控制 中模组分类下重新绑定。

操作 默认按键
打开建筑包管理器 \
设置世界选区角点 A [
设置世界选区角点 B ]
将选区捕获为蓝图 '
切换“包含方块实体内容” 未绑定
清除世界选区 未绑定

管理器

左侧面板有三个选项卡:

  • 导入文件 — 导入目录中的松散 .nbt / .litematic / .schem 文件。
  • 包 — 导入目录中的压缩建筑包,显示为可展开的树状结构(包 -> 类别 -> 建筑)。任何建筑都可以直接从压缩包中预览和读取,无需事先解压。
  • 已安装 — 已存在于 SimuKraft 建筑目录中的建筑。

右侧信息面板显示元数据行、预览、材料列表(按方块类型计数,并标记缺失方块)以及一个 .sk 元数据表单(在导入选项卡上可编辑,其他地方为只读)。它支持拖放导入、搜索、排序、批量安装和双击删除。当浏览带有图标的包时,该图标会显示在预览区域。

建筑编辑器

在编辑器中打开一个建筑进行精修,然后再安装:

  • 编辑 — 放置、破坏、选取和替换方块;带有可调节大小和笔触的画笔;一键移除或替换整个方块类型。
  • 选择 — 框选一个区域(点击两个单元格或拖动一个框面),然后执行填充/框架/掏空/扩展/清除操作,以及复制、剪切和粘贴。
  • 变换 — 沿任意轴旋转 90 度和镜像,带有用于镜像编辑的对称轴。
  • 历史 — 撤销和重做。
  • 视图 — 循环切换切片平面、适配并聚焦选择区域、预设摄像机角度、切换网格和 Gizmo 工具,以及切换透视。
  • 输出 — 另存为新文件、保存并安装,或导出为 .litematic。

在编辑器内按下 H 键可查看完整的快捷键列表。

从世界中捕获建筑

在你的世界中建造一些东西,然后在不离开游戏的情况下将其转变为蓝图:

  1. 看向一个方块并按 [ 键设置角点 A,然后按 ] 键设置角点 B。选区框会绘制在世界中。
  2. 按 ' 键捕获选区并将其导出到导入目录。
  3. 可选择绑定“包含方块实体内容”键来捕获箱子物品栏等数据,以及绑定“清除选区”键来重置角点。

同样的操作可通过 /buildpack capture 在服务器上使用(参见命令)。

建筑包

建筑被分为五个固定的类别:residential(住宅)、commercial(商业)、industry(工业)、public(公共)和 other(其他)。

  • 安装/卸载 — 安装一个包会将每个建筑转换到相应的类别目录,并在 simcity_expansion/installed_packs.json 中记录一个清单,因此卸载会精确移除该包添加的文件。

  • 导出(已安装选项卡 -> 导出) — 将列出的建筑(遵循当前搜索过滤器)打包成一个压缩包。选项包括:

    • 包含 .sk 元数据,
    • 包含 SimuKraft 职业/交易 JSON,
    • 包含一个图标 — 勾选该框并将路径留空,以便从第一个建筑的预览自动渲染一个图标,或提供自定义 PNG 路径。

    一个 index.json 文件清单(包含每个打包文件的类型、类别、大小和 SHA-256 值)总是写入压缩包的根目录。

  • 清单 — pack.json(格式 2)包含 id(标识符)、name(名称)、version(版本)、author(作者)、description(描述)、可选的 icon(图标)以及一个 generated(生成时间戳)。

完整的包规范(目录布局、pack.json、.sk / .meta.json 元数据、原生职业/交易 JSON、icon.png 和 index.json)记录在 docs/pack-format.zh.md 中。

建筑格式

扩展名 来源 安装时转换
.nbt 原版结构方块模板 按原样安装;旧版本会自动升级
.litematic Litematica 投影 多区域合并为一个边界框;读取嵌入的名称/作者/创建时间/缩略图
.schem Sponge / WorldEdit 示意图 支持 v1、v2 和 v3

所有格式在安装时都会转换为原版 .nbt(SimuKraft 的建筑系统只读取原版格式)。在转换过程中,建筑会通过数据修复器升级到当前游戏版本,方块实体的位置会被重新映射并保留,调色板会对照注册表检查缺失的方块,合并后的体积上限为 16,000,000 个方块。

目录布局

<游戏目录>/
├── simcity_expansion/
│   ├── import/                 导入目录(在此放置松散文件和压缩包)
│   ├── export/                 导出的建筑包
│   └── installed_packs.json    已安装包注册表
└── simukraftbuilding/<类别>/   SimuKraft 建筑目录(安装目标)

命令

所有 /buildpack 子命令都需要操作员等级 2(游戏管理员)并提供 Tab 补全功能。

命令 描述
/buildpack list 列出导入目录中的文件
/buildpack packs 列出已安装的包
/buildpack install <文件> [类别] [名称] 安装一个松散的建筑文件
/buildpack installpack <zip> 安装整个压缩包
/buildpack uninstallpack <标识符> 根据标识符卸载一个包
/buildpack activate <zip> 虚拟地为 SimuKraft 提供一个包(不安装) — 需要 SimuKraft
/buildpack deactivate <标识符> 停止提供已激活的包
/buildpack active 列出当前激活的包
/buildpack capture <起点> <终点> [名称] [格式] 将区域捕获为蓝图

文档

文档 面向读者
使用指南 玩家:导入、安装、管理、导出
包格式规范 v2 包作者:布局、pack.json、元数据、转换

中文版本也可用:usage.zh.md 和 pack-format.zh.md。

从源代码构建

该项目使用 Gradle Wrapper 和 NeoForge ModDevGradle 工具链(JDK 21)。

./gradlew build

构建好的 jar 文件会写入 build/libs/ 目录。

许可

保留所有权利。版权所有 © 2026 xinian。 本源代码仅供参考发布;未经许可不得用于再分发或衍生作品。 在整合包中使用时,必须链接回原始链接。

致谢

关于旧版本

  • 1.20.1 Forge 版本已停止开发。