Skip to content

Typing SVG

GitHub Modrinth CurseForge Website License: LGPLv3 Code of Conduct


🧬 相变晶 · 核心 + DLC 模组生态

相变晶 (PhasetransCrystal) 是基于 NeoForge、面向 Minecraft 26.1.2Java 25 的开源模组组织。我们遵循**一核心 + 多附属(DLC 模式)**的模块化设计,打造完全自成体系的大型科技魔法模组生态。官网:ptcrys.net

  • ⚛️ 核心模组 BreakdownKernel:包含全部 API(能量、材料、多方块、配方、渲染、世界生成)与基础产业线(矿石处理、基础机器、工具装备)。仅装核心即可完整体验
  • 💎 DLC 附属模组:所有拓展内容(高级科技、魔法、新维度)均在 DLC 中实现,独立加载,互不冲突。
  • 🔗 自成体系:不依赖 Create、Mekanism、GregTech 等第三方大型模组。所有系统自行实现,高度可控。
  • 🚀 面向未来:Minecraft 26.1.2 + Java 25,充分利用 record、sealed classes、pattern matching、FFM API 等现代特性。

🧩 DLC 架构

角色 模组 描述 状态
核心 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,所有配方/结构/研究树可覆写
性能 异步世界生成、机器网络增量更新、内存池管理

🤝 贡献方式

🧩 第三方 DLC 开发建议

欢迎基于 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

行为准则

遵守 Contributor Covenant 2.1


📄 许可证

类型 许可证
代码 (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

Pinned Loading

  1. BreakdownKernel BreakdownKernel Public

    Java

  2. GradleTemplate GradleTemplate Public

  3. Topology Topology Public

    Topology NeoForge 基础库 Mod — 提供机器、材料、管道、配方、矿石生成等基础设施。

    Java

Repositories

Showing 10 of 19 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…