Injeção de Interface
Aprenda a como implementar interfaces nas classes do Minecraft no código-fonte descompilado.
A injeção de interface é um tipo de modificador de classe usado para adicionar implementações de interface nas classes do Minecraft no código-fonte descompilado.
A implementação sendo visível no código-fonte descompilado remove a necessidade de transmitir para a interface para usar os seus métodos.
Além disso, injeções de interface podem ser transitivas, permitindo que bibliotecas exponham os seus métodos adicionados aos mods que dependem deles mais facilmente.
Para mostrar a injeção de interface, os trechos dessa página usarão um exemplo onde nós adicionamos um novo método ajudante ao FlowingFluid.
Criando a Interface
Em um pacote que não seja o seu pacote de mixins, crie a interface que você gostaria de injetar:
public interface BucketEmptySoundGetter {
default Optional<SoundEvent> example_mod$getBucketEmptySound() {
throw new AssertionError("Implemented in Mixin");
}
}2
3
4
5
No nosso caso, lançaremos uma exceção por padrão, pois planejamos implementar o método por meio de um mixin.
WARNING
Os métodos das interfaces injetadas devem ser todas default para serem injetadas com um modificador de classe, mesmo se você planeja implementar os métodos na classe alvo usando um mixin.
Os métodos também devem ser prefixados pelo ID do seu mod com um separador como $ ou _, fazendo com que eles não entrem em conflito com os métodos adicionados de outros mods.
Implementando a Interface
TIP
Se os métodos da interface estão totalmente implementados com os defaults da interface, você não precisa usar um mixin para injetar a interface, a entrada do modificador de classe será o suficiente.
Para criar sobrescritas dos métodos da interface na classe alvo você deve usar um mixin que implementa a interface e tenha como alvo a classe que você deseja injetar a interface.
@Mixin(FlowingFluid.class)
abstract class FlowingFluidMixin extends Fluid implements BucketEmptySoundGetter {
@Override
public Optional<SoundEvent> example_mod$getBucketEmptySound() {
return Optional.of(this.is(FluidTags.LAVA) ? SoundEvents.BUCKET_EMPTY_LAVA : SoundEvents.BUCKET_EMPTY);
}
}2
3
4
5
6
7
A sobrescrita será adicionada a classe alvo em tempo de execução, mas não aparecerá no código-fonte descompilado mesmo se você usar um modificador de classe para deixar a implementação de interface visível.
Criando a Entrada do Modificador de Classe
A injeção de interface usa a seguinte sintaxe:
inject-interface <targetClassName> <injectedInterfaceName>Para modificação de classe, classes e interfaces use os seus nomes internos.
Para a nossa interface de exemplo, a entrada deve ser:
inject-interface net/minecraft/world/level/material/FlowingFluid com/example/docs/interface_injection/BucketEmptySoundGetterInterfaces Genéricas #generic-interfaces}
Se a sua interface possui tipos genéricos, você pode especificá-los na entrada. Para isso, adicione <> colchetes angulares no final do nome da interface com os tipos genéricos em formato de assinatura do bytecode Java entre os colchetes.
O formato de assinatura é:
| Descrição | Exemplo Java | Sintaxe | Exemplo de Formato de Assinatura |
|---|---|---|---|
| Tipo de classe | java.lang.String | Formato do Descritor | Ljava/lang/String; |
| Tipo de array | java.lang.String[] | Formato do Descritor | [Ljava/lang/String; |
| Primitivo | boolean | Caractere do Descritor | Z |
| Variável de tipo | T | T + nome + ; | TT; |
| Tipo de classe genérica | java.util.List<T> | L + nome interno + < + tipos genericos + >; | Ljava/util/List<TT;>; |
| Curinga | ?, java.util.List<?> | * caractere | *, java/util/List<*>; |
| Limite curinga extends | ? extende String | + + o limite | +Ljava/lang/String; |
| Limite curinga super | ? super string | - + o limite | -Ljava/lang/String; |
Então para injetar a interface:
package com.example.docs.interface_injection;
public interface GenericInterface<T, U> {
}2
3
4
5
com os genéricos <? extends String, Boolean[]>
A entrada do modificador de classe ficaria:
inject-interface net/minecraft/world/level/material/FlowingFluid com/example/docs/interface_injection/GenericInterface<+Ljava/lang/String;[Ljava/lang/Boolean;>Aplicando Mudanças
Para ver a sua implementação de interface aplicada, você deve recarregar o seu projeto do Gradle e regenerar os arquivos de código-fonte. Certifique-se de abrir novamente qualquer classe alvo do código-fonte descompilado para ver as modificações.
TIP
Se as modificações não aparecem, você pode tentar validar o arquivo e checar se algum erro aparece.
Agora os métodos adicionados podem ser usados nas instâncias da classe onde a interface foi injetada:
void example(FlowingFluid flowingFluid) {
Optional<SoundEvent> sound = flowingFluid.example_mod$getBucketEmptySound();
// ...
}2
3
4
Você também pode sobrescrever os métodos nas sub-classes do alvo de injeção da interface caso necessário.









