相变晶 (PhasetransCrystal) 是基于 NeoForge、面向 Minecraft 26.1.2 和 Java 25 的开源模组组织。我们遵循**一核心 + 多附属(DLC 模式)**的模块化设计,打造完全自成体系的大型科技魔法模组生态。官网:ptcrys.net。
- ⚛️ 核心模组 BreakdownKernel:包含全部 API(能量、材料、多方块、配方、渲染、世界生成)与基础产业线(矿石处理、基础机器、工具装备)。仅装核心即可完整体验。
- 💎 DLC 附属模组:所有拓展内容(高级科技、魔法、新维度)均在 DLC 中实现,独立加载,互不冲突。
- 🔗 自成体系:不依赖 Create、Mekanism、GregTech 等第三方大型模组。所有系统自行实现,高度可控。
- 🚀 面向未来:Minecraft 26.1.2 + Java 25,充分利用 record、sealed classes、pattern matching、FFM API 等现代特性。
| 角色 | 模组 | 描述 | 状态 |
|---|---|---|---|
| 核心 | BreakdownKernel | 相变晶基石。能量系统、材料、基础机器、工具、世界生成、数据驱动。必装。 | 🟢 开发中 |
| 科技 DLC | BreakdownTech: Induction | 高级电力产线、自动化装配、多方块反应堆、跨维度物流。 | 🟡 规划中 |
| 魔法 DLC | BreakdownMagic: Alchemy | 晶化仪式、法阵绘图、元素共鸣、咒术构造体。 | 🟡 规划中 |
| 维度 DLC | BreakdownWorld: Void | 「虚空晶界」维度:新生物群系、矿石、结构、BOSS。 | 🟡 规划中 |
| 整合包 | BreakdownPack: Epoch | 官方整合包,魔改任务线、进度树、定制配方。 | 🟡 规划中 |
| 兼容 | BreakdownCompat | 可选桥接 JEI、TOP、JourneyMap 等(不破坏自成体系)。 | 🟡 规划中 |
💡 玩家仅下核心即可获得完整基础体验;按需加 DLC 自动扩展内容,所有 DLC 共享相变能统一能量单位。
- 核心不拆改:BreakdownKernel 是一个整体——包含全部 API 与基础产业线。不赞同二次开发(fork / 魔改)核心本体,这会破坏 DLC 兼容性。
- DLC 即扩展:所有拓展内容通过 DLC 模组实现。欢迎社区基于 BreakdownKernel 的公开 API 开发第三方 DLC,与官方 DLC 平等共存。
- 上游优先:如需新增 API 或修改核心机制,请向 BreakdownKernel 主仓库提交 PR,而非自行 fork。
| 领域 | 选型 |
|---|---|
| 平台 | NeoForge (NeoDevGradle) |
| Minecraft | 26.1.2 |
| Java | 25 |
| 构建 | Gradle 9.6.1 |
| 渲染 | 顶点缓冲自定义渲染器 + 着色器管线 |
| 数据驱动 | JSON + Data Pack,所有配方/结构/研究树可覆写 |
| 性能 | 异步世界生成、机器网络增量更新、内存池管理 |
欢迎基于 BreakdownKernel 公开 API 开发第三方 DLC。建议遵循以下约定:
工程搭建
- 使用 GradleTemplate 初始化项目,确保 MC/NeoForge/Java 版本一致。
- 将 BreakdownKernel 作为
implementation依赖,不要 fork 或 shade 核心代码。 - 命名建议:
Breakdown<Category>-<name>(如BreakdownTech-induction),便于玩家识别。
发布与兼容
- 在
mods.toml中声明breakdownkernel为依赖,指定版本范围。 - 如需桥接 JEI/TOP 等,优先通过 BreakdownCompat 统一处理。
- 发布到 Modrinth / CurseForge 时,在描述中注明"基于相变晶 (BreakdownKernel)"。
向核心贡献
- Bug 修复 / API 改进 → 向 BreakdownKernel 提交 PR。
- 纹理 / 模型 / 文档 → 提交资产或完善 Wiki。
- 代码风格:Google Java Style,Spotless 检查。提交前运行
gradle test && gradle spotlessCheck。
| 类型 | 许可证 |
|---|---|
| 代码 (BreakdownKernel + DLC) | LGPL v3.0 |
| 资产 (纹理/模型/音效/语言) | CC BY-NC-SA 4.0 |
| 整合包 | ARR(内部模组遵循各自许可证) |
相变晶 · 核心与 DLC 共创科技魔法纪元
© 2026 PhasetransCrystal · LGPL v3 & CC BY-NC-SA · 26.1.2 / Java 25 · NeoForge