Fzzy Core - Fzzy Core 核心库

欢迎来到 Fzzy Core！这是一个基础 API，为 fzzyhmstrs（就是我！）制作的一些 kotlin 模组提供支持。除了提供一些对许多不同类型模组都很有用的基础实用功能外，Fzzy Core 还包含了 Modifier System 的基础框架——这是一个灵活且强大的系统，能够修改……几乎任何东西！

Fzzy Core 在源码中集成了 KDoc 以提供使用指导。我也正在制作一个 wiki！

当前 Fzzy Core 仅支持 Fabric。目前没有移植到 Forge 的计划。

Fzzy Core 是我将 Amethyst Core 拆分为更具功能性组件的一部分项目。这个模组是这些组件的基础，我目录中的其他 API 都建立在这个基础之上（例如面向魔法模组的 Amethyst Core）

编码工具

Fzzy Core 包含若干能让模组开发稍微更轻松一些的工具！这些工具包括：

• 一个基础附魔类，可轻松与配置系统集成，以单独禁用/启用各个附魔。
• 一个 Text 包装器，可避免多版本模组开发中与 Text 变更相关的麻烦，以及持续与合并冲突作斗争。
• 一个持久化效果系统，可用于创建延迟、重复（或不重复）事件，而无需绑定到特定对象的 tick 或其他复杂实现。
• 一个粒子创建系统，允许在玩家视角中的特定位置放置客户端粒子。这样就可以实现物品上滴落粒子、会冒烟的火把等效果。

同步配置系统

创建一个易于管理的配置系统，支持随时间进行版本控制，并自动将服务器配置同步给加入的客户端！

• 利用 Kotlin 的一些独特功能，实现简洁清爽的写法
• 提供辅助方法，可自动将配置文件更新到新版本，并在替换前保留旧版本中的信息
• 简单实现自动同步功能。

自定义风味文本物品

为基础物品或工具物品添加风味文本！

• 默认实现只需在 lang 文件中添加几行
• 也提供用于更复杂文本的可选方法
• 还可添加描述文本，用于解释风味文本含义或说明物品功能

法力物品

添加一个简单框架，用于创建使用法力而不是以常规方式损耗耐久的物品。

Modifier Framework

Modifier Framework 是一个灵活且可扩展的系统，设计上与原版附魔系统平行。Modifier 旨在解决我在附魔中发现的两个最大问题：它们很容易被移除，而且它们不会将自身功能内化（除了少数几个伤害方法）。附魔也比本可以做到的更无趣，它们只是用简单数字显示等级。Modifier 的目标就是修复所有这些问题！

• Modifier 被设计为永久性的，更像词缀。例如，砂轮无法将其移除。
• Modifier 被设计为将功能内化，并且可以作为一个整体被调用，而不是零碎地处理。
• Modifier 通过“家族树”机制运作，从而实现更有风味的等级。想象一把剑从“Rusty”变成“Shiny”，再变成“Gleaming”等等。

该库内置了用于显示 modifier 的辅助方法

一个展示金色文本 modifier 的 tooltip 示例

有关这些功能的更多细节，请参见上方的 wiki 链接。一旦实现，Modifier 系统几乎可以做到任何事。例如，Amethyst Core 内置了一个 AugmentModifier，它可以影响法力消耗和冷却时间、改变法术伤害或范围，甚至触发高级效果，例如在任意一次成功施法时，让施法者周围 12 格半径内的所有生物都受到 Wither 效果。

Modifier 可以像传递原版 AttributeModifiers 的容器一样简单，也可以比上面描述的 AugmentModifier 复杂得多。如果需要，它们甚至可以纯粹用于风味表现！

Nbt 工具

Fzzy Core 包含了一个简单工具，可对 NBT 执行一些实用操作

• 通过一个辅助方法即可读写 BlockPos，而不用手动保存 X、Y、Z 坐标或转换为 Long
• 若干 NbtList 工具，用于从 NbtList 读取、向其中添加内容以及移除内容
• 一个 ItemStackId 系统，可为特定 itemstack 附加唯一标识符。例如，这可以让某个 ItemStack 绑定到特定方块实体……或者实现更多用途！
• 一个辅助方法，用于将非附魔 NBT 从一个 stack 转移到另一个 stack。

Raycaster 工具

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

• 服务端射线检测，用于检测游戏对象，而无需进行复杂网络通信
• 提供针对实体、方块以及定位某点周围区域内对象（如玩家周围）的辅助方法
• 可检查带任意旋转长方体内的实体。Minecraft 默认的检测系统都使用与 XYZ 网格对齐的盒体。这对于检测一个法术命中了哪些敌人之类的情况很有用，即使玩家正斜着朝上坡看也一样。

事件注册表

用于添加和跟踪与实体等特定对象无关的基础 ticking 对象的注册表。

• 适合创建每 X tick 才触发一次的周期时钟，从而实现不必每个 tick 都执行的 tick 方法。事实上，注册表内置了 1 秒、1.5 秒和 2 秒间隔的时钟。
• 添加了 TickUppable 接口和 Ticker 类，用于将对象注册到该注册表中。

物品模型注册表

想制作一个自定义三叉戟，却怎么都搞不明白该如何让手持时的三叉戟像 MC 原版那样显示？这个注册表就是为你准备的！

• 可为特定渲染模式（手持、地面上等）注册自定义物品模型
• 与标准的 Fabric BuiltinItemRendererRegistry.DynamicItemRenderer 集成

EffectQueue

是否讨厌在添加被动状态效果时，状态效果会在 GUI 中“打架”，快速来回切换显示？

• 这个简单工具会将所有传入的状态效果添加操作统一为可预测的顺序
• 使用 addStatusEffect 所具备的全部标准状态效果信息

Trinket 工具

Fzzy Core 可选地与 Trinkets 集成，并添加了一些可与其配合使用的实用功能

• getTrinketStacks 提供传入的 living entity 所装备的全部 Tirnkets 列表
• AugmentTasks 接口允许创建可与名为 Augments 的特殊附魔交互的 Trinkets。这些 augments 允许饰品拥有可自定义的被动与主动能力。