EriAPI

模组

· 作者 JLSkyzer

适用于 Forge 1.12.2 的综合库模组 —— 提供用于 GUI、物品、方块、数据存储、调度器、聊天、能力、事件、按键绑定和网络通信的流畅 API。无需样板代码即可构建模组。

0 本站下载 0 关注 更新于 7 个月前

最新 1.12.2 · 1.12.2 · Forge

一键开服(送7天)

EriAPI Logo

EriAPI

Minecraft Forge 1.12.2 的一体化模组开发框架

Documentation (EN) · Documentation (FR) · Issues & Ideas


EriAPI 是什么?

EriAPI 是一个面向 Minecraft Forge 1.12.2 的综合库模组,旨在消除样板代码,并为常见的模组开发任务提供简洁、流畅的 API。你无需再与 Forge 冗杂的内部实现打交道,只需编写表达性强的单行代码,剩下的工作交由 EriAPI 处理。

无论你是正在构建一个简单的实用工具模组,还是一个庞大的整合包核心,EriAPI 都能开箱即用地为你提供生产级工具——无需复制粘贴,无需重复造轮子。

模块

GUI 框架

一套完整的 UI 工具包,采用 1920x1080 设计像素 标准设计,并支持自动缩放至任意屏幕分辨率。利用 30 多种即用型组件构建丰富的界面:按钮、文本框、滑块、复选框、单选按钮、滚动面板、标签页视图、图表、颜色选择器、右键菜单、工具提示、Toast 通知等。每个组件均支持动画、音效反馈以及流畅 API 模式。

物品与方块构建器

使用流畅的构建器创建物品、方块和配方——无需手动注册类、处理事件或编写 JSON 模型。支持基础物品、食物、工具(镐、斧、剑、锹、锄)、盔甲套装,以及具有自定义掉落物、方块实体和交互回调的方块。

数据与存储

使用简单的注解 POJO 进行持久化数据存储。通过 @EriData 声明一个类,使用 @Sync 标记字段以实现自动客户端同步,框架即可透明地处理 NBT 序列化、能力附加、死亡后数据保留、维度切换以及登录同步。

任务调度器

无需触碰 tick 事件即可安排延迟任务、循环任务、顺序链式任务和异步操作。内置线程池用于非主线程工作,并提供对主线程的安全回调。

聊天构建器

使用流畅 API 构建包含颜色、样式、点击事件、悬停工具提示和 URL 的丰富聊天消息。内置分页器功能,可通过可点击的导航按钮显示长列表。

能力系统

简化 Forge 能力机制。使用 @EriCapability 注解一个 POJO,指定目标对象(玩家、实体、物品或方块实体),框架即可自动处理注册、附加、NBT 持久化、死亡后数据复制以及客户端同步。

事件系统

一行代码订阅任意 Forge 事件。添加过滤器、设置优先级、设置为仅触发一次,或设置延迟后自动过期——所有操作均无需创建专用的事件处理器类。

按键绑定管理器

使用流畅 API 注册键盘快捷键:支持简单按键、多键组合(如 Ctrl+Shift+X)、双击检测以及长按回调。支持上下文感知激活(仅限游戏内、仅限 GUI 或始终激活),并具备自动冲突检测功能。

网络层

用于 GUI 交互的客户端-服务器通信。通过集中的网络处理器发送动作、同步数据和远程打开 GUI,并自动完成数据包注册。

安全框架

服务端防刷怪与漏洞预防工具包。通过零信任验证保护任何容器 GUI 免受物品复制漏洞的影响。包括 GuiRateLimiter(按玩家限制操作频率)、ItemIntegrityValidator(快照/验证/回滚物品数量)、ContainerLock(同步并发访问)以及 DupeAlertManager(实时管理员警报)。专为高玩家数量的服务器(500-1000 名玩家)设计。

致开发者

EriAPI 是一个库模组——它自身不执行任何操作。将其作为依赖项添加到你的模组中,即可开始使用其任意模块。所有 API 均遵循相同的流畅模式,因此一旦掌握其中一个,便通晓全部。

快速入门

将 EriAPI 添加到你的 build.gradle 中:

dependencies {
    compile files('libs/eriapi-1.0-SNAPSHOT-1.12.2.jar')
}

在 @Mod 注解中声明依赖:

@Mod(modid = "yourmod", dependencies = "required-after:eriapi")

至此完成。所有模块立即可用。

完整文档

  • English:
  • French:


EriAPI

Minecraft Forge 1.12.2 的一体化模组开发框架

Documentation (FR) · Documentation (EN) · Issues & Ideas


EriAPI 是什么?

EriAPI 是一个面向 Minecraft Forge 1.12.2 的综合库模组,旨在消除冗余代码,并为常见的模组开发任务提供简洁、流畅的 API。你无需再与 Forge 冗杂的内部实现打交道,只需编写表达性强的单行代码,EriAPI 即可处理其余部分。

无论你是正在构建一个简单的实用工具模组,还是一个庞大的整合包核心,EriAPI 都能开箱即用地为你提供生产级工具——无需复制粘贴,无需重复造轮子。

模块

GUI 框架

一套完整的 UI 工具包,采用 1920x1080 像素设计,并支持自动缩放至任意分辨率。使用超过 30 种开箱即用的组件构建丰富的界面:按钮、文本字段、滑块、复选框、单选按钮、可滚动面板、标签页、图表、颜色选择器、上下文菜单、工具提示、Toast 通知等。每个组件均支持动画、音效反馈以及流畅 API 模式。

Item & Block Builder(物品与方块构建器)

使用流畅的构建器创建物品、方块和配方——无需手动注册类、管理事件或编写 JSON 模型。支持基础物品、食物、工具(镐、斧、剑、铲、锄)、全套盔甲,以及带有自定义掉落物、方块实体和交互回调的方块。

Data & Storage(数据与存储)

通过简单的注解 POJO 实现持久化数据存储。只需声明一个带有 @EriData 注解的类,并使用 @Sync 标记字段以实现客户端自动同步,框架便会透明地处理 NBT 序列化、Capability 附加、死亡后数据保留、维度切换以及登录时的同步——一切尽在不言中。

Task Scheduler(任务调度器)

安排延迟任务、重复任务、顺序链和异步操作,而无需触碰 Tick 事件。内置线程池用于在主线程之外执行工作,并提供安全回调至主线程的支持。

Chat Builder(聊天构建器)

通过流畅 API 构建包含颜色、样式、点击事件、悬停工具提示和 URL 的丰富聊天消息。内置分页器,可通过可点击的导航按钮显示长列表。

Systeme de Capabilities(能力系统)

简化的 Forge Capability 系统。用 @EriCapability 注解一个 POJO,指定目标类型(玩家、实体、物品或方块实体),框架会自动处理注册、附加、NBT 持久化、死亡时复制以及客户端同步。

Systeme d'Events(事件系统)

仅需一行代码即可监听任何 Forge 事件。添加过滤器、定义优先级、设置仅触发一次或超时自动过期——所有这些功能均无需创建专用的 Handler 类。

Keybinding Manager(按键绑定管理器)

使用流畅 API 注册键盘快捷键:支持单键、多键组合(Ctrl+Shift+X)、双击检测以及长按回调。支持上下文激活(仅限游戏中、仅限 GUI 中或始终启用),并具备自动冲突检测功能。

Couche Reseau(网络层)

用于 GUI 交互的客户端-服务器通信。发送动作、同步数据和远程打开 GUI——所有这些都通过中央网络管理器完成,并自动注册数据包。

Framework de Securite(安全框架)

服务端防刷取和防止漏洞利用的工具包。通过零信任验证保护任何容器 GUI 免受物品 duplication 漏洞的影响。包括 GuiRateLimiter(按玩家限制操作频率)、ItemIntegrityValidator(物品数量快照/验证/回滚)、ContainerLock(并发访问同步)和 DupeAlertManager(实时管理员警报)。专为高负载服务器(500-1000 名玩家)设计。

致开发者

EriAPI 是一个库模组——它本身不执行任何操作。将其作为依赖项添加到您的模组中,即可开始使用其任意模块。所有 API 均遵循相同的流畅模式,因此一旦您掌握其中一种,便通晓所有接口。

快速入门

将 EriAPI 添加到您的 build.gradle 中:

dependencies {
    compile files('libs/eriapi-1.0-SNAPSHOT-1.12.2.jar')
}

在 @Mod 注解中声明依赖:

@Mod(modid = "votremod", dependencies = "required-after:eriapi")

至此完成。每个模块立即可用。

完整文档

  • Francais :
  • English :

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源