Minecraft 1.20.1, 1.21.1用Kube Utils MOD

Kube Utils

Kube UtilsはKubeJSのシンプルなアドオンで、既存の機能に新しい機能を追加し、より高性能で簡潔かつ簡潔なコードを可能にする新しいシステムを分岐して作成します。

仕組み

Kube Utils（以下Ku）は、明確で簡潔かつ一貫性のあるAPIのような設計というコンセプトで設計されています。このMODによって追加されるすべてのものはグローバルなKuオブジェクト内に保持されます。つまり、レベルAPIにアクセスしたい場合はKu.Level経由でアクセスし、流体を扱いたい場合はKu.Fluidsなどを使用します。

機能

現在、KubeJSのサポートが比較的少ない分野に対するいくつかのヘルパーのみを提供していますが、システム開発のライフサイクルを通じてこれを大幅に拡張する予定です。提案がある場合は、機能リクエストをお送りください！

• ブロック位置での構造物の取得、構造物のスポーン、エンティティや空きスペースの検索、バウンディングボックス内でのランダムな位置の取得など、Levelへの追加機能。
• 流体：名前空間に基づいて流体のリストを取得でき、流体が空かどうかを確認できます。
• 重み付きテーブルに基づいてランダムなエントリを取得するなど、Listへの追加機能。
• nullOrEmptyのような汎用ユーティリティの追加。これにより、アイテム、ブロック、ItemStack、文字列、流体、ItemEntityのいずれであっても、オブジェクトがnullまたは空かどうかを常に簡単に把握できます！（必要に応じてさらにサポートを追加予定）
• 完全にドキュメント化されたコード
• 本番環境で検証済み
• 明確でシンプルなAPI

私たちの目標

• Minecraft、Forge、Fabricによって絶対に強制されない限り、破壊的な変更は決して行わないことを目指しています。破壊的な変更を行うために分岐する必要があると判断した場合は、既存のコードに影響を与えないオプションの方法で行います。
• 追加機能を過度に複雑にしないこと
• 追加機能は常に平易な英語で文書化すること

ドキュメント

すべての新機能とその使用方法を文書化したウェブサイトを公開することを目標としています。

現在は、コード内で追加した機能について読むことができます。BaseBindingクラスは、Kuオブジェクトで使用できるオブジェクトを示しています。たとえば、BaseBindingsにはフィールドとしてStreamsが含まれています。これはKu.Streams.MethodNameを使用できることを意味します。利用可能なメソッドは、関連するモジュールのクラスファイル内で確認できます。ClassWrapper<?>で囲まれたフィールドがある場合、KubeJSでそのフィールドを使用するにはオブジェクトを作成する必要があります。たとえば、LevelはClassWrapper<LevelUtils>でラップされているため、new Ku.Level(player.level)のようにフィールドを使用する必要があります。少し複雑ですが、ウェブサイトの準備ができれば、はるかに簡単になります。

免責事項

免責事項：ベータ版の間は、コードを破壊する可能性のある変更が発生する可能性があります。安定版リリースに達した時点でこのメッセージは削除され、それ以降コードには破壊的な変更は含まれません！

問題

問題を報告する場合は、問題を検証できるよう、サンプルコードとともに問題トラッカーに報告してください。