Fzzy Core

模组

· 作者 fzzyhmstrs

用于 fzzyhmstrs 模组中为 Kotlin 模组提供各种实用工具的 API

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

需要前置:Fabric API、Fabric Language Kotlin

最新 0.5.1+1.20.1 · 1.20.1 · Fabric / Quilt

一键开服(送7天)

欢迎来到 Fzzy Core!这是由 fzzyhmstrs(就是我啦!)制作的一些 Kotlin 模组所依赖的基础 API。除了提供许多不同类型模组都适用的基础实用功能外,Fzzy Core 还包含了 Modifier System(修饰符系统)的基本框架——这是一个灵活且强大的系统,用于修改……几乎任何东西!

Fzzy Core 的源代码中集成了 KDoc,方便查阅使用指南。我也正在努力创建一个维基!

Fzzy Core 目前仅支持 Fabric。暂无移植到 Forge 的计划。

Fzzy Core 是我将 Amethyst Core 拆分为更独立的功能组件这一计划的一部分。该模组是这些组件的基础,我目录中的其他 API 均在此基础上构建(例如用于魔法模组的 Amethyst Core)。

编码工具 (Coding Utils)

Fzzy Core 包含多种实用工具,让模组开发变得更加轻松!这些工具包括:

  • 一个基础的附魔类,可以轻松集成配置系统以启用或禁用单个附魔。
  • 对 Text 对象的封装,避免了多版本模组开发中因频繁处理 Text 变更而导致的合并冲突问题。
  • 一个持久化效果系统,允许创建延迟、重复(或非重复)事件,且这些事件不绑定于特定实体的 Tick 或其他复杂的实现逻辑。
  • 一个粒子创建系统,允许在玩家视角的特定位置放置客户端粒子。这使得物品可以拥有滴落粒子的效果,火把可以散发烟雾等。

同步配置系统

创建一个易于管理、支持版本控制并自动将服务器配置同步给加入客户端的配置系统!

  • 利用 Kotlin 的独特功能,实现简洁清晰的代码结构
  • 提供辅助方法,可自动将配置文件更新到新版本,并在替换前捕获旧版本的信息。
  • 简单的自动同步功能实现。

自定义风味物品 (Custom Flavor Items)

添加带有“风味文本”(Flavortext,即背景故事或趣味描述文字)的基础物品或工具!

  • 默认实现只需在语言文件中添加几行新文本即可
  • 可选方法支持更复杂的文本排版
  • 同时添加描述文本,用于解释风味文本的含义或说明物品功能

魔力物品 (Mana Items)

提供一个简单的框架,用于创建使用魔力而非通过常规方式损坏的物品。

修饰符框架 (Modifier Framework)

修饰符框架是一个灵活且可扩展的系统,旨在作为原版附魔系统的平行替代方案。修饰符旨在解决我发现的附魔系统的两个最大问题:附魔容易被移除,且其功能未内部化(除了几个伤害计算方法)。此外,附魔的表现形式也略显单调,仅用数字显示等级。修饰符旨在解决所有这些问题!

  • 修饰符设计为永久性效果,更像是一种词缀。例如,砂轮无法移除它们。
  • 修饰符设计为内部化其功能,可以作为整体调用,而非零散处理。
  • 修饰符通过“家族树”机制运作,从而实现富有风味的等级体系。想象一下一把剑从“生锈”变为“闪亮”再到“熠熠生辉”等过程。

该库附带了内置的辅助方法,用于显示修饰符。 一个展示金色文本修饰符的工具提示示例

有关这些功能的更多详细信息,请参阅上方的维基链接。一旦实现,修饰符系统几乎可以完成任何任务。例如,Amethyst Core 内置了一个 AugmentModifier(增幅修饰符),它可以影响魔力消耗和冷却时间,改变法术伤害或范围,甚至在每次成功施法时触发高级效果,如使施法者周围 12 格半径内的所有怪物受到凋零效果。

修饰符可以简单到仅作为一个传递原版 AttributeModifiers(属性修饰符)的容器,也可以比上述的 AugmentModifier 复杂得多。如果愿意,甚至可以将它们纯粹用于装饰效果!

NBT 工具 (Nbt Util)

Fzzy Core 包含一个简单的工具,用于对 NBT 执行一些有用的操作:

  • 使用单个辅助方法读取和写入 BlockPos,无需手动保存 X、Y、Z 坐标或进行 Long 类型转换
  • 多个 NbtList 实用工具,用于从 NbtList 中读取、添加和删除数据
  • 一个 ItemStackId 系统,可为某些物品堆栈附加唯一标识符。例如,这允许将物品堆栈与特定的方块实体关联……或者更多功能!
  • 一个辅助方法,用于将一个堆栈的非附魔 NBT 数据传输到另一个堆栈。

射线投射工具 (Raycaster Util)

一组用于定位对象的简单辅助方法:

  • 服务端射线投射,无需复杂的网络通信即可检测游戏对象
  • 针对实体、方块的辅助方法,以及定位某点(如玩家)周围区域物体的功能
  • 能够检查具有任意旋转立方体的实体。Minecraft 的默认检测系统均使用与 XYZ 网格对齐的盒子。这对于检查法术击中了哪些敌人非常有用,即使玩家是斜向上方观察也是如此。

事件注册表 (Event Registry)

用于添加和跟踪与特定对象(如实体)无关的基础 Tick 对象的注册表。

  • 适用于创建仅在每 X 刻触发一次的周期性时钟,从而可以创建不会在每一刻都触发的刻方法。实际上,该注册表内置了间隔为 1 秒、1.5 秒和 2 秒的时钟。
  • 添加了 TickUppable 接口和 Ticker 类,用于将对象注册到注册表中。

Item Model Registry

想要制作自定义三叉戟,但不知道如何让它像原版 Minecraft 那样在手持有正确的模型?这个注册表就是为你准备的!

  • 为特定的渲染模式(手持、地面放置等)注册自定义物品模型
  • 与标准的 Fabric BuiltinItemRendererRegistry.DynamicItemRenderer 集成

EffectQueue

讨厌添加被动状态效果时,GUI 中的状态效果会“打架”,快速来回切换吗?

  • 这个简单的工具将所有传入的状态效果添加统一到一个可预测的顺序中
  • 使用 addStatusEffect 中你期望的所有标准状态效果信息

Trinket Utils

Fzzy Core 可选地与 Trinkets 集成,添加了一些可用于它的实用函数

  • getTrinketStacks 提供所有装备到指定活体实体的饰品列表
  • AugmentTasks 接口允许创建与特殊附魔(称为 Augments)互动的饰品。这些增强功能允许饰具有可定制的被动和主动能力。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源