AE2AddonLib

AE2AddonLib

一个帮助 AE2 附属模组开发者将模组融入 AE2 生态的前置库。

注册

新增了多个类，用于提供辅助函数，让注册变得更简单。

只需创建自己的类，并为每个想要注册的内容添加一行代码，调用一个帮你处理所有事务的方法，注册就能轻松完成。

无需再处理延迟注册器；容器类会自动为你创建，并保存将来可能需要的一切。所有内容都使用 AE2 的“Definitions”，此外还添加了原模组中没有的两类定义：材料和流体！

此外，还有帮助你处理快捷键和设置（用于左侧菜单按钮）的类。

控件

这个模组开放了多个原本无法使用的 AE2 控件。以下是一些示例：

• AddonIconButton – 通用界面按钮。
• AddonActionButton – 可重复使用、外观和提示文本固定的按钮。
• AddonSettingToggleButton – 用于切换或循环调整机器设置的按钮。
• ServerSettingToggleButton – 以更易用的方式实现，只需调用 AddonSettingToggleButton 中的静态方法即可创建按钮。所有数据包都由你处理，十分方便！

这个前置库还添加了 AE2 中没有的新控件！例如：

• AddonSlider – Minecraft 滑块的扩展版本，新增了多项功能，采用 AE2 风格，并兼容 WidgetContainer。
• ColorPicker – 完整的颜色选择器，包含用于选择色相、饱和度、明度的子控件，还支持通过十六进制代码输入。
• ToolbarActionButton – 并非所有左侧工具栏操作都需要切换设置！这个按钮可按需求进行配置。
• FluidTankSlot – 一个控件及其配套类，可为界面添加流体储罐。

界面

这个前置库还提供了两个通用界面：

• OutputDirectionScreen – 用于让玩家选择机器导出物品的方向。
• SetAmountScreen – 显示一个 ItemStack，并提供用于调整数量的按钮，类似合成请求界面！

网络通信

库中提供了 NetworkHandler，其中包含辅助方法，可轻松注册数据包。库也提供并处理了一些数据包，例如用于处理流体槽和切换设置的数据包。对于 1.20.1 版本，网络处理器还提供了发送数据包所需的全部工具，这些工具在 Forge 中并不可用。

实用工具

这个前置库还包含一些其他实用类，例如：

• Colors – 支持 RGB/ARGB/HSV 之间的转换，提供实用的颜色处理功能。内置了所有原版颜色和大多数常见的 AE2 颜色。
• BlockUpgradeItem – 用于升级实体的物品通用基类，例如将一个样板供应器升级为另一种样板供应器。
• WaterBasedFluidType – 使用水纹理的流体通用基类。
• AddonEnum – 可附加到枚举的接口，便于处理与其他模组的交互。可用于检查模组是否已加载，或创建条件配方。
• AE2AddonModelProvider – AE2BlockStateProvider 的扩展，可使用附属模组的资源位置。它还提供了其他方法，方便创建完整方块模型、部件物品模型（用于总线或线缆样板供应器），以及带有两个图层的彩色物品模型。
• ConnectedTexturesBaseBakedModel – 用于连接纹理的完整烘焙模型。可高度自定义，包括正面与侧面的渲染类型以及自发光效果。

文档

该前置库的 Javadoc 文档覆盖率为 100%，并且还会持续改进。前置库本身也提供了一些用法示例。你还可以查看 AdvancedAE 的 GitHub 页面，了解一个几乎用到了该前置库所有功能的模组。

参与贡献

该前置库已经有了很好的起点，但仍有很大的发展空间，未来可以成为更强大的开发工具。欢迎提出建议或反馈问题，我们始终乐于倾听。你的意见弥足珍贵，也能帮助这款工具变得更好，惠及所有人。