Riftx的库

Riftx的库

一个用于Minecraft Forge 1.20.1的模组开发库。功能包括：物理API（重力、碰撞）、错误弹窗API（自定义消息）、动画API（缩放、修饰符）、模型导入API（支持骨骼的OBJ、FBX、GLTF格式）。非常适合模组开发者使用。

Riftxs Lib

Riftxs Lib 是一个用于 Minecraft Forge 1.20.1 的库，帮助开发者制作 Minecraft 模组。它为开发者提供了可用于制作模组的工具和系统。

当你制作模组时，无需从零开始。Riftxs Lib 提供了你可以直接集成到模组中的功能，例如物理效果和动画。这可以为你节省大量时间和工作。

功能特性

物理 API

你可以为游戏中的实体和方块等对象创建自定义物理效果。这意味着你可以控制它们的移动方式以及对事物的反应。

  • 你可以自定义重力
  • 你可以控制物体移动的速度
  • 你可以对物体施加力
  • 你可以让物体受到空气阻力和拖拽影响
  • 你可以让方块感觉沉重或轻巧
  • 你可以让方块具有弹跳效果
  • 你可以让方块吸引附近的物体
  • 你可以自定义碰撞检测
  • 你可以过滤掉特定的碰撞

错误弹窗 API

你可以在游戏中创建自定义弹窗来向玩家显示信息。这些弹窗可以包含玩家可以点击的按钮。

功能包括：

  • 你可以创建仅用于提供信息的弹窗
  • 你可以创建用于警告玩家的弹窗
  • 你可以创建用于告知玩家错误的弹窗
  • 你可以创建用于告知玩家严重错误的弹窗
  • 你可以为你的弹窗添加按钮
  • 你可以创建弹窗队列
  • 你可以创建在屏幕上持续显示的通知

你可以使用这些按钮：

  • 确定
  • 取消
  • 是
  • 否
  • 重试
  • 忽略

动画 API

你无需编写大量代码即可更改实体的动画方式。这意味着你可以让它们以特定方式移动和表现。

功能特性：

  • 你可以让所有动画加速或减速
  • 你可以让单个动画加速或减速
  • 你可以让实体变大或变小
  • 你可以让实体的部分部件变小
  • 你可以添加自定义动画效果

有一些内置效果可供你使用：

  • 慢动作
  • 快进
  • 倒放
  • 冻结

模型导入 API

你可以将外部创建的模型导入到 Minecraft 中。这意味着你可以使用自制或在其他地方找到的模型。

Riftxs Lib 支持以下格式：

  • OBJ
  • FBX
  • glTF

它包含：

  • 完整的 OBJ 文件解析器
  • 网格支持
  • 材质支持
  • UV 映射支持
  • 法线支持
  • 骨骼系统
  • 动画支持
  • 模型注册表

安装

要使用 Riftxs Lib，你需要：

  • Minecraft 1.20.1
  • Minecraft Forge 更新版本
  • Java 17

你需要将 Riftxs Lib 添加到你的项目中。

Build.gradle

dependencies {

implementation fg.deobf("com.riftx.lib:riftxlib:1.0.0")

}

mods.toml

[[dependencies.yourmodid]]

modId="riftxlib"

mandatory=true

versionRange="[1.0.0,)"

ordering="AFTER"

side="BOTH"

以下是一个关于如何使用 Riftxs Lib 的示例：

import com.riftx.lib.RiftxLib;

// 物理

Riftxs Lib PHYSICS API sets the gravity of an entity to 0.5

Riftxs Lib PHYSICS API applies a force to an entity

// 错误弹窗

Riftxs Lib ERROR_POPUP_API shows an error popup

// 动画

Riftxs Lib ANIMATION_API sets the animation speed of a zombie to 2.0

// 模型导入

Riftxs Lib MODEL_IMPORT_API imports a model from a file

常见问题解答

Riftxs Lib 会为 Minecraft 增加游戏内容吗？

不，Riftxs Lib 不会为 Minecraft 增加游戏内容。它是一个帮助开发者制作模组的库。

我可以在我的模组中使用 Riftxs Lib 吗？

是的，你可以在你的模组中使用 Riftxs Lib。你可以在公共项目中自由使用它。

我可以在整合包中包含 Riftxs Lib 吗？

是的，你可以在整合包中包含 Riftxs Lib。你可以在私有整合包中使用它。

Riftxs Lib 支持 NeoForge、Fabric 或 Quilt 吗？

不，Riftxs Lib 目前不支持 NeoForge、Fabric 或 Quilt。它仅适用于 Minecraft Forge 1.20.1。

我应该在何处报告 Riftxs Lib 中的错误？

如果你在 Riftxs Lib 中发现错误，请告知我们。我们需要知道：

  • 你使用的 Minecraft 版本
  • 你使用的 Forge 版本
  • 你使用的 Riftxs Lib 版本
  • 崩溃报告的内容
  • latest.log 的内容
  • 如何复现该错误

使用条款

当你使用 Riftxs Lib 时，必须同意以下规则：

  • 不得声称你是 Riftxs Lib 的制作者
  • 你可以在私有模组中使用 Riftxs Lib
  • 你可以在整合包中包含 Riftxs Lib
  • 你可以为个人使用修改 Riftxs Lib 的源代码
  • 如果你分享修改过的 Riftxs Lib 版本，必须声明它已被修改
  • 你必须保留所有版权和许可声明
  • Riftxs Lib 按“现状”提供，不附带任何担保

致谢

Riftx 是 Riftxs Lib 的创建者和首席开发者。

Loldog 协助了脚本编写。

Minecraft 模组社区 为我们提供了反馈和灵感。

许可证

Riftxs Lib 使用 MIT 许可证 授权。你可以在 LICENSE.txt 文件中找到许可信息。