[Ecentrix] 进阶核心

[Ecentrix] 进阶核心

轻量级共享库,为所有Progressive Mods提供支持,确保稳定性、性能和无缝兼容性。

基础库

Banner

CurseForge Modrinth Fabric API

📖 关于

Progressive Core 是 Progressive Mods 生态系统中所有模组的共享基础。

它集中管理通用系统、工具和内部框架,使每个单独的模组保持轻量、专注且易于维护。通过将共享逻辑移至专门的核心模块,更新得以简化,跨模组兼容性也显著提升。

Progressive Core 本身不会添加游戏内容。 它唯一的用途是提供一个稳定且一致的后端,确保所有 Progressive 模组可靠且高效地协同工作。

🔌 包含的 API 与系统

Progressive Core 包含多个供 Progressive 模组构建的内部 API:

  • 核心 API 入口点(EcentrixAPI)
    用于注册模组、共享功能以及获取核心服务的单一访问点。

  • 模组与功能注册表(ModRegistry)
    一个中央注册表,每个 Progressive 模组都可以在其中注册自身,并可选地通过 ResourceLocation ID 发布跨模组功能。这使得干净的可选集成成为可能(例如“如果存在 Storage,则启用 X”),而无需硬依赖。

  • 网络工具(NetworkManager)
    用于创建一致的数据包 ID(可在核心命名空间或每个模组的命名空间中)的共享辅助工具,这样功能模组就不必重新发明命名约定和冲突避免机制。

  • 多加载器平台抽象(Services + IPlatformHelper)
    一个服务加载的平台辅助工具,允许通用代码查询模组加载器/平台(Fabric/NeoForge)、检查其他模组是否已加载,以及检测开发环境与生产环境。

  • 客户端模型加载辅助工具(客户端 API)
    EcentrixClientAPI、ModelLoaderRegistry 和 CustomModelResolver 提供了一个用于注册基于命名空间的模型解析器的小型框架。Progressive 模组可以接入自定义模型解析,而无需在各个加载器之间重复样板代码。

  • 用于容器/背包的共享 GUI 屏幕(客户端 API)
    GenericContainerScreen 和 GenericBackpackScreen 提供了可复用的容器 UI 逻辑(按行自动调整大小、共享纹理),使功能模组能够保持客户端代码精简且一致。

⚙️ 功能

  • 为所有 Progressive 模组提供集中化的共享代码库
  • 确保 Progressive Backpacks、Storage 和 Furnaces 之间行为一致
  • 减少冗余,保持功能模组轻量
  • 简化维护和长期更新
  • 针对性能和稳定性进行优化
  • 仅供内部使用——并非通用模组开发库

🛠️ 安装

✅ 客户端和服务端均需安装

  • Fabric:需要 Fabric API
  • NeoForge:无额外依赖(除 NeoForge 本身外)
  • 所有受支持的 Progressive 模组会自动使用

⭐ 相关模组

Progressive Storage

Progressive Furnaces

Progressive Backpacks