blockprint-core
0.2.2indexedParses Minecraft blueprints, generates GLB 3D models in real time, supports standard blocks and OBJ models, includes Create mod multi-part adapters and progress-aware export.
3
Stars
—
Used by
dependents
—
Health
/ 100
BlockPrint Core
零依赖 Kotlin Multiplatform 库，解析 Minecraft 蓝图并提供 GLB 3D 模型实时生成。
支持大部分模组标准方块和标准obj模型，但对**Create(机械动力)**单独适配支持中
平台：JVM 21+ / Android API 21+ ｜ 语言：Kotlin 2.2.10 ｜ 构建：Gradle 9.5.1
集成
repositories { mavenCentral() }
dependencies {
implementation("io.github.moxisuki:blockprint-core:0.2.1")
}
Android 推荐复合构建以获得 BitmapImageBackend：
// settings.gradle.kts
includeBuild("../blockprint-core")
或直接拉 Android 变体：io.github.moxisuki:blockprint-core-android:0.2.1
快速开始
import io.github.moxisuki.blockprint.core.*
import io.github.moxisuki.blockprint.core.glb.*
// 解析蓝图（自动检测 .litematic / .schematic / .nbt / gzip）
val lit = LitematicReader.read(File("house.litematic"))
// 材料统计
MaterialList.from(lit).toSortedByCount().forEach { (name, count) ->
println(" × ")
}
assetsDirs = listOf(Path.of())
LitematicToGlb.convert(lit, assetsDirs, File())
bytes = LitematicToGlb.convertToBytes(lit, assetsDirs) { p ->
println()
}
📖 详细 API：BLUEPRINT_API.md · GLB_PIPELINE.md
Create 模组支持
适配逻辑在 CreateModObjAdapter.kt。已适配 24 种方块的多部件合成几何：
其他 Create 方块走默认 blockstate 解析——外壳可渲染，多部件方块实体暂缺部件合成。
TODO
-
边建边写：
MeshBuilder先攒所有顶点再写出，500k 方块模型峰值 >1 GB，Android 必 OOM。双趟流式可降到 ~100 MB（详见 GLB_PIPELINE.md）
编译
./gradlew compileKotlinJvm # JVM
./gradlew build # 含 Android
./gradlew publishToMavenLocal # 本地发布
要求 JDK 21 + Android SDK 34+。
许可
MIT License