Liquid Lab

模组

· 作者 HersheyLightning

一个流畅的 API,用于简化自定义流体和气体的创建。

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

需要前置:Fabric API

最新 2.2.0 · 1.21.1 · Fabric

一键开服(送7天)

描述

Liquid Lab 是一个流体 API,旨在简化 Fabric 平台上自定义流体的创建过程,因为几乎所有流体属性都是硬编码的。该 API 包含的功能包括设置雾效颜色、数据驱动的混合行为以及会向上流动的自定义气态流体。此 API 的存在是为了制作高质量的流体,而不仅仅是换皮的“水”或“熔岩”。

功能

基础流体更改

向基础 Fluid 类添加了许多实用方法。

实体溅射效果

  • 通过 onEntityEntry 实现
  • 当实体首次接触流体时调用
  • 参数:
    • 实体所在的 World(世界)
    • 接触流体的 Entity(实体)

实体交互

  • 通过 onEntityCollision 实现
  • 当实体位于流体内部时调用
  • 参数:
    • 实体所在的 World(世界)
    • 流体的 Block Position(方块位置)
    • 位于流体内的 Entity(实体)

实体粘度

  • 通过 getFluidMotion 实现
  • 用于控制流体的推力及粘度
  • 参数:
    • 实体所在的 World(世界)
  • 返回一个 FluidMotion 对象,存储以下信息:
    • 实体的 XYZ 速度乘数
    • 流体的推力
    • 实体主动移动时的移动速度

物品粘度

  • 通过 getItemMotion 实现
  • 用于控制物品实体的浮力和粘度
  • 参数:
    • 实体所在的 World(世界)
  • 返回一个 FluidMotion 对象,存储以下信息:
    • 物品的 XYZ 速度乘数
    • 物品的最大垂直速度
    • 物品在流体中上升的速度

雾效

  • 通过 getFogProperties 实现
  • 允许流体拥有特殊的雾效
  • 参数:
    • 实体所在的 World(世界)
    • Camera(相机/玩家视角)的位置
    • 正在观察雾效的 Entity(实体)
  • 返回一个 FogProperties 对象,存储以下信息:
    • 雾效起始距离(以方块为单位)
    • 雾效结束距离(以方块为单位)
    • 雾效的 RGB 颜色

雨滴粒子

  • 通过 getRainParticle 实现
  • 当雨水落在流体上时,为流体提供独特的溅射粒子效果
  • 返回:
    • 当流体被雨水击中时应使用的粒子

桶的声音

  • 通过 getBucketEmptySound 实现
  • 不仅允许流体拥有自定义的填充声音,还允许拥有自定义的倒出声音
  • 返回:
    • 倒空桶时应播放的声音

寻路

  • 通过 canPathfindThrough 实现
  • 允许流体直接判断是否有实体尝试在其内部进行寻路
  • 参数:
    • 实体拥有的导航类型
  • 返回:
    • 是否允许在该流体中进行寻路

流体标签

API 添加了 7 个流体标签:

  • liquid_lab:enhanced_mobility
    • 定义该流体可游泳且支持冲刺游泳
  • liquid_lab:swimmable
    • 定义该流体是否可以游泳
  • liquid_lab:drowns
    • 定义浸没在其中的实体是否会溺水
  • liquid_lab:evaporates
    • 定义该流体无法在下界(Nether)中放置
  • liquid_lab:fall_damage_reducing
    • 使该流体对摔落伤害的影响方式与熔岩相同
  • liquid_lab:fall_damage_resetting
    • 使该流体对摔落伤害的影响方式与水相同
  • liquid_lab:gaseous
    • 简单地将流体标记为气体,不具备其他功能

气态流体

此外,API 还添加了反向流动(向上流动)的流体。气态流体的注册方式与普通流体相同,但方块形式需使用 GasFluidBlock 创建,流体形式需通过继承 FlowableGasFluid 创建。在渲染方面,请在客户端初始化器中使用 SimpleGasFluidRenderHandler,而不是 SimpleFluidRenderHandler。

流体混合

提供了一个简单而灵活的系统,用于创建数据驱动的流体混合,以实现模组间的兼容性。

文件夹结构

要添加流体混合配方,首先在命名空间文件夹中创建一个名为 fluid_mixing 的文件夹。此处的文件应为 JSON 格式,文件名需为该命名空间下的有效流体标签,以便正常运行。

文件结构

  • replace 可选。表示此文件是否替换该流体的所有规则
  • rules 该流体需遵循的规则列表
    • type 定义规则适用的时机。可以是 on_update(当流体被邻近方块更新时应用规则)或 on_flow(当另一种流体流入此流体时应用规则)。
    • is_still 可选。表示该流体必须是静态源还是流动方块。如果未定义,则接受任何形式的流体
    • smoke 可选。表示此交互是否会产生烟雾粒子
    • predicate 必须通过的方块谓词,交互才能成功
    • transform 用于放置交互结果方块的方块状态提供者

方块谓词

  • 添加了 liquid_lab:touching_fluids
    • 当相邻流体匹配 fluids 参数,且该流体可以流入该方块时判定通过
  • 添加了 liquid_lab:adjacent_blocks
    • 当相邻方块匹配谓词的 blocks 参数时判定通过

工具类

API 添加了一些简单的实用方法,以使实现某些流体相关功能更加简单。

流体工具 (Fluid Utils)

包含与流体交互相关的方法,例如 splashEntity,可用于 onEntityEntry 中以轻松实现自定义溅射效果。

粒子工具 (Particle Utils)

包含与注册方块泄漏粒子相关的方法。该类允许独立或一次性地为流体和气体注册滴水、下落和着陆粒子。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源