======= インターフェイスインジェクション =======

これは、特定の既存のクラスにメソッドを追加するために Loom 0.11 で導入された新しい手法です。
より具体的には、インターフェイスを作成し、このインターフェイスをクラスに注入できます。
その結果、ターゲットクラスは、インターフェイスのすべてのメソッドを、常に持っているかのように取得します。
インターフェイスインジェクションはコンパイル時のみの機能です。これは、ミックスインを使用してインターフェイスをターゲットクラスに実装する必要があることを意味します。

これはライブラリで特に便利です。これにより、既存のクラスに新しいメソッドを追加して、毎回インターフェイスをキャストまたは再実装する必要なくそれらを使用できます。

例を挙げて説明しましょう：

この例のスコープは、次のメソッドを ''<yarn net.minecraft.class_3609>'' に追加して、バケツが空になったときの音を取得することです。
''<yarn net.minecraft.class_3609>'' には同様のメソッドがないため、通常、これは不可能です。

<yarncode java [enable_line_numbers="false"]>
Optional<class_3414> getBucketEmptySound()
</yarncode>

メソッドをクラスに追加するには、まず最初にそれとのインターフェースを作成する必要があります：

<yarncode java [enable_line_numbers="false"]>
package net.fabricmc.example;

public interface BucketEmptySoundGetter {
	// 注入されたインターフェースのメソッドは default でなければなりません。
	// そうでなければ、それらを参照するコードはコンパイルされません！
	default Optional<class_3414> getBucketEmptySound() {
		return Optional.empty();
	}
}
</yarncode>

ここで、インターフェースを実装するミックスインを使用して、このインターフェースを ''<yarn net.minecraft.class_3609>'' に実装する必要があります：

<yarncode java [enable_line_numbers="false"]>
@Mixin(class_3609.class)
public class MixinFlowableFluid implements BucketEmptySoundGetter {
	@Override
	public Optional<class_3414> getBucketEmptySound() {
	    // これは、BucketItem クラスからコピーされたデフォルトのサウンドを取得する方法です。
	    return Optional.of(((class_3609) (Object) this).method_15791(class_3486.field_15518) ? class_3417.field_15010 : class_3417.field_14834);
	}
}
</yarncode>

最後に、インターフェイスを ''<yarn net.minecraft.class_3609>'' に注入する必要があります。
次のスニペットを fabric.mod.json ファイルに追加して、 ''<yarn net.minecraft.class_3609>'' クラスに 1 つ以上のインターフェイスを追加できます。
ここでのすべてのクラス名は、ドットの代わりにスラッシュを使用する  "internal names" 〔内部名〕を使用する必要があることに注意してください（例： ''path/to/my/Class''）。

<code json [enable_line_numbers="false"]>
{
	"custom": {
		"loom:injected_interfaces": {
			"net/minecraft/class_3609": ["net/fabricmc/example/BucketEmptySoundGetter"]
		}
	}
}
</code>

これで、新しいメソッドを使用できます：

<yarncode java [enable_line_numbers="false"]>
Optional<class_3414> sound = mytestfluid.getBucketEmptySound();
</yarncode>

<yarn class_3609> を拡張するクラスでこのメソッドをオーバーライドして、カスタム動作を実装することもできます。