Abstractium

模组

· 作者 StockiesLad

一个用于简化模组与依赖之间交互抽象的 API。

0 本站下载 0 关注 更新于 2 年前

最新 0.3.25 · 1.20.1 · Fabric / Quilt

一键开服(送7天)

简介

Abstractium 是一个相对简单的模组,旨在提供工具以抽象模组与给定依赖项之间的交互代码。

它的作用是什么?

Abstractium 的分支结构大致如下:

  • Abstractium = "Api" + "Minecraft Abstraction"(Minecraft 抽象层);
  • Api = "Events"(事件系统)+ "Abstraction Tools"(抽象工具)。

Events(事件系统)的功能与其他大多数事件系统类似,但不同之处在于它还具备并发能力和基于字符串的标识系统。它用于保存 mixin 的主要“功能”,这些功能可能在其他更新中无法正常工作。

Abstraction Tools(抽象工具)提供了一种简便的方式来实现预定义调用的接口,即“抽象映射”(Abstraction Mappings)。不同版本的抽象映射通过入口点(entrypoint)进行注册。AbstractionHandler.java 类会自动处理所有版本控制问题。抽象映射还允许存在“子抽象”(sub-abstraction),即特定的调用子集可以驻留其中。以下是一个示例层级结构:

  • AbstractClientCalls{
    • AbstractRenderCalls{
      • AbstractWorldRenderCalls{
        • AbstractBlockRenderCalls{},
        • AbstractEntityRenderCalls{} },
      • AbstractGuiRenderCalls{} },
    • AbstractSoundCalls{
      • AbstractEntitySoundCalls{},
      • AbstractBlockSoundCalls{} } }

Minecraft Abstraction(Minecraft 抽象层)将上述内容整合在一起,为其他模组提供一个内置的抽象层。请注意,目前这远未完成。仅实现了让我的模组移植到该抽象层所需的最基本功能。如果你愿意贡献代码,请记住我只会接受适用于此 API 支持的所有内置版本的抽象实现。

如何使用它?

如果你想使用我内置的 Minecraft 抽象层,实际上非常简单!只需将我的模组添加到你的依赖列表中(文档即将发布),然后访问 AbstractiumClient#CLIENT_ABSTRACTION_HANDLER 或 AbstractiumCommon#COMMON_ABSTRACTION_HANDLER。如果你想创建自己的抽象处理逻辑,那就复杂得多,但你需要遵循 net.feltmc.abstractium.library 中的实现方式。未来某个时候会有一个维基(Wiki)。

开发路线图

目前目标相当有限。支持 fabric 1.18.2 到 最新版本。未来有可能性而非计划涉及以下内容:

  • Code Wrapper(代码包装器):这将允许来自不同版本的模组在新版本上运行而无需修改。
  • Legacy Support(旧版支持):支持低于 1.18.2 的版本。
  • Forge Abstraction(Forge 抽象层):抽象并包装 Forge 代码(取决于另一个 PatchworkMC 项目)

为什么制作这个?

我制作这个 API 是因为 Mojang 喜欢重构他们自己的代码。我知道模组开发者们都同意我的观点,Mojang 的重构使得模组开发变得如此繁琐且令人沮丧。它迫使我们开发者将精力从改进模组转移到重写代码以适应最新版本上。此外,如果有人想维护多个版本,就必须用补丁/改进更新多个分支,这在后勤上是一场噩梦。对于用户来说,这导致许多模组分散在不同的版本中。这使得人们无法在最新版本的一个整合包中玩到他们所有的最爱模组。这种挫败感被积极地转化为一个雄心勃勃的 API,旨在彻底消除这些恼人的麻烦。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源