适用于 Minecraft 1.20.1, 1.21.1 的 Kube Utils 模组

Kube Utils

Kube Utils 是 KubeJS 的一个简单附属模组，它为现有功能添加了新功能，并分支出来创建新系统，从而允许更高效、更简化、更简洁的代码。

工作原理

Kube Utils（以下简称为 Ku）的设计理念是清晰、简洁且一致的类似 API 的设计。此模组添加的所有内容都保存在全局 Ku 对象中，这意味着如果你想访问等级 API，你将通过 Ku.Level 访问它，如果你想对流体进行操作，你将使用 Ku.Fluids 等等。

功能

目前，我们只为 KubeJS 中一些支持较少的领域提供了一些辅助工具，但我们计划在系统开发的生命周期内大幅扩展这一功能。如果你有任何建议，请提出功能请求！

• 等级添加功能，例如能够在方块位置获取结构、生成结构、查找实体并清空空间、获取带有边界框的随机位置等。
• 流体，允许你根据其命名空间获取流体列表，并能够检查流体是否为空。
• 列表添加功能，例如根据加权表获取随机条目
• 添加通用工具，例如 nullOrEmpty，它为你提供了一种非常简单的方法来始终知道一个对象是否为 nullOrEmpty，无论它是物品、方块、物品堆、字符串、流体还是物品实体！（根据需要会提供更多支持）
• 完全文档化的代码
• 生产环境验证
• 清晰简单的 API

我们的目标

• 我们的目标是除非被 Minecraft、Forge 或 Fabric 绝对强制，否则绝不进行破坏性更改。当我们觉得需要分支并进行破坏性更改时，将以不影响现有代码的可选方式进行。
• 绝不使添加的内容过于复杂
• 始终用通俗易懂的英语记录添加的内容

文档

我们的目标是发布一个网站，记录所有新添加的内容以及如何使用它们。

目前，你可以在代码中阅读我们添加的功能。我们的 BaseBinding 类向你展示了可以在 Ku 对象中使用哪些对象。例如，BaseBindings 包含 Streams 作为一个字段。这意味着你可以使用 Ku.Steams.MethodName。你可以在相关模块的类文件中找到可用的方法。如果你看到一个字段被 ClassWrapper<?> 包围，这意味着要在 KubeJS 中使用该字段，你必须创建该对象。例如，Level 被 ClassWrapper<LevelUtils> 包装，这意味着你需要像这样使用该字段 new Ku.Level(player.level)。这有点复杂，但一旦网站准备好，就会简单得多。

免责声明

免责声明，在测试版期间，预计可能会出现破坏代码的更改。一旦我们达到稳定版本，此消息将被删除，从那时起，代码将不再包含破坏性更改！

问题

请将任何问题报告到我们的问题跟踪器，并附上示例代码，以便我们验证问题。