Mixin

Mixin é uma estrutura trait/mixin para Java usando ASM e conectando-se ao processo de carregamento de classe em tempo de execução por meio de um conjunto de serviços conectáveis ​​integrados ou fornecidos pelo usuário. Os serviços integrados atualmente suportam o sistema LegacyLauncher da Mojang, embora esteja obsoleto em favor do ModLauncher da cpw, que tem maior extensibilidade e suporte para Java 8 e posterior.

Documentação

A documentação principal do Mixin pode ser encontrada no Wiki.

Documentação adicional para recursos e anotações individuais pode ser encontrada no extenso Javadoc. Para ajuda adicional use o canal #mixin no Sponge Discord Server.

Binários

Os binários Mixin estão disponíveis via Jenkins e são publicados nos seguintes repositórios maven:

• https://repo.spongepowered.org/repository/maven-public/ - SNAPHOTs e compilações RELEASE
• https://files.minecraftforge.net/maven/ - Somente compilações RELEASE

Ferramentas

Para lidar com tarefas de ofuscação, o Mixin fornece um processador de anotação que funciona em tempo de compilação para gerar mapeamentos de ofuscação para serem aplicados pelo seu conjunto de ferramentas. Se estiver usando Gradle 5 ou posterior, os processadores de anotação não serão mais carregados automaticamente a partir de configurações compile e deverão ser especificados explicitamente por meio de configurações annotationProcessor . Para este propósito, Mixin fornece artefatos "fat jar" contendo todas as dependências necessárias através do classificador :processor . Por exemplo, se sua compilação usa a dependência org.spongepowered:mixin:1.2.3 então sua configuração annotationProcessor deve especificar a dependência org.spongepowered:mixin:1.2.3:processor .

Se você estiver usando o Mixin em um projeto do Minecraft Forge, o plugin MixinGradle pode ser usado para simplificar a configuração do processador de anotação Mixin. Ele fornece uma sintaxe simples para configurar o Mixin AP para o seu projeto, consulte o README do MixinGradle para saber como configurar o MixinGradle.

Integração com Eclipse

Ao desenvolver usando Mixin , você pode usar o Mixin Annotation Processor no Eclipse para fornecer erros e avisos sensíveis ao contexto para ajudá-lo a solucionar problemas de seus mixins com mais facilidade. Para fazer isso:

1. Execute o comando gradle build para gerar o mixin jar
2. Abra as propriedades do seu projeto Eclipse e navegue até Java Compiler -> Annotation Processing -> Factory Path
3. Marque a caixa de seleção Enable project specific settings
4. Clique no botão Add External JARs e selecione o mixin jar gerado com o sufixo -processor (dica: deve estar em Mixin/build/libs )
5. Navegue um nível acima até Java Compiler -> Annotation Processing
6. Marque a caixa de seleção Enable project specific settings
7. Marque a caixa de seleção Enable annotation processing
8. Clique no botão New... próximo à caixa Processor options

• Definir Key para reobfSrgFile
• Defina Value como o caminho totalmente qualificado para o arquivo mcp-srg.srg (a localização do arquivo de mapeamento varia de acordo com a plataforma, se você não tiver certeza de onde encontrá-lo, siga o link discord abaixo).

9. Clique em OK para aplicar as alterações

Integração com IntelliJ IDEA

Funcionalidade aprimorada para trabalhar com Mixin no IntelliJ IDEA está disponível por meio do plugin Minecraft Development for IntelliJ IDEA desenvolvido pela DemonWav.

Histórico de versões

Especificar a propriedade minVersion em suas configurações é extremamente importante. O histórico de versão a seguir pode ser usado para determinar quando os recursos foram introduzidos (e às vezes quando bugs importantes são eliminados) para ajudá-lo a determinar qual minVersion você deve especificar.

Versão	Data	Recursos/Alterações
0.8.3	Fevereiro de 2021	Adicionado suporte ao seletor de alvo dinâmico e seletor de alvo @Desc Adicionado seletor de alvo padrão Adicionado suporte de quantificador mais expressivo para seletores de alvo explícitos Facelift e melhorias gerais no javadoc
0.8.1 (0.8.2)	Setembro de 2020	Hotfix para suporte ao ModLauncher 7.0 Correção de problema crítico ao resolver membros ofuscados em interfaces herdadas Atualizado para ASM 7.2
0,8	Janeiro de 2020	Atualizado para ASM 6.2 Suporte para ModLauncher Adicionado reconhecimento para Java 9 e 10 Suporte para tabelas de ofuscação tsrg do ForgeGradle 3+ As configurações agora podem herdar de outras configurações @Invoke agora pode ser usado para expor construtores Relatórios de contexto drasticamente aprimorados de exceções inesperadas de aplicadores e pré-processadores, facilitando o diagnóstico quando um agente se engasga com um opcode específico Correções de bugs para Chamando membros de mixins acessadores de dentro do código mixin Tratamento incorreto de espaços em declarações de destino explícitas Comportamento inesperado ao tentar redirecionar um ctor Detecte corretamente a sobreposição de acessadores incompatíveis e ignore os válidos (não avise) Os acessadores estáticos da interface agora estão em conformidade com o destino corretamente se a interface for carregada antes da classe de destino Incompatibilidade de estática para o acessador detectada e relatada corretamente em vez de causar falha Erros de gerador e injetor corrigidos relacionados a operandos de palavra dupla na pilha que precisam de DUP2 Corrigido problema no gerador LVT dobrado do FabricMC Fail-fast quando um método final é acidentalmente ocultado por um mixin Corrija a aparência de instâncias perdidas de CallbackInfo em LVTs de injetores de captura local Dependência do Apache Commons-IO removida ASM sombreado renomeado removido Resolução aprimorada de variáveis ​​locais para injeções de captura de variáveis ​​locais @Coerce em injetores de retorno de chamada e redirecionamentos agora pode resolver superinterfaces, incluindo interfaces mistas
0.7.11	Julho de 2018	Correções para 3 pequenos bugs: manipulação de maxShiftBy corrigida, pesquisa permissiva BeforeInvoke aprimorada, desativação da fusão de assinaturas genéricas, a menos que o descompilador esteja ativo.
0.7.10	Junho de 2018	Registrar um erro quando uma classe mixin estiver sujeita a restrições do carregador de classe
0.7.9	Abril de 2018	Permitir que certos injetores tenham como alvo métodos mixin.
0.7.8	Abril de 2018	Correções de bugs para validação de declaração de membro, redirecionamentos de ctor não selvagens e erros internos no gerador de subclasse Args
0.7.7	Março de 2018	Correções para manipulação de gatilhos de mensagens de log para fase INIT e erro ao executar com configurações inesperadas do criador de logs Adicionar avisos para pontos de fatia inválidos e restrição de conversão em manipuladores ModifyConstant
0.7.6	Novembro de 2017	Corrigir herança para propriedades do sistema de strings
0.7.5	Outubro de 2017	Adicione suporte para @Coerce em injetores de redirecionamento.
0.7.4	Setembro de 2017	Adicionada anotação @Dynamic para decorar elementos mixin com alvos injetados dinamicamente.
0.7.3	Agosto de 2017	Mudanças internas para fornecer suporte ao modlauncher e java 9
0.7.2	Agosto de 2017	Adicione profiler para inspecionar o desempenho do mixin.
0.7.1	Agosto de 2017	Correções e melhorias no Mixin AP, corrigindo o tratamento de arrays multidimensionais e resolvendo métodos em superclasses de tipos derivados de classes ofuscadas Adicione o remapeamento de refmap em tempo de execução para oferecer suporte ao uso de dependências deobfCompile com diferentes versões de mapeamento.
0,7	Julho de 2017	Todos os binários oficiais agora estão assinados Atualizar para ASM 5.2 Adicione suporte para classes internas em Mixins Os injetores agora podem ter vários alvos explícitos As anotações @At agora podem ter seu próprio ID Adicionado suporte para usar @Overwrite em métodos não ofuscados como forma de verificar se existe um destino de substituição Melhore o suporte para pontes sintéticas, detecte métodos de ponte conflitantes Detectar e avisar sobre valores excessivos de At.Shift.BY ModifyConstant agora pode suportar múltiplas fatias Adicionar permissão aos injetores para detectar injeção excessiva
0.6.15	Julho de 2017	Adicione suporte para múltiplas constantes em ModifyConstant Adicione CONSTANT como ponto de injeção de uso geral Adicionar suporte para redirecionar o acesso ao comprimento do array em redirecionadores de campo
0.6.14	Julho de 2017	Adicionado suporte para usar @Coerce em tipos de referência em injetores de retorno de chamada para oferecer suporte a tipos derivados.
0.6.13	Julho de 2017	Adicione suporte para visibilidade conforme de métodos de substituição para corresponder à classe de destino. Corrige problemas onde um método de classe alvo foi modificado por um Transformador de Acesso para ter maior visibilidade
0.6.12	Junho de 2017	Adicionar argumento de fatia a @ModifyConstant Adicione o injetor @ModifyArgs que pode alterar vários argumentos de chamada de método com um único manipulador.
0.6.11	Junho de 2017	Corrigido o tratamento de @Unique quando o mesmo método exclusivo existe em mais de um mixin direcionado à mesma classe Corrigida a manipulação de lambdas mesclados para que lambdas de mixins sejam aplicados corretamente quando lambdas já existirem na classe de destino (tanto na classe original quanto quando aplicados por mixins anteriores)
0.6.10	Maio de 2017	(0.6.9) Pequena correção para remover a dependência do auxiliar obsoleto Respeite o remapeamento no Mixin para @At contido Exigir que os redirecionadores que ocorrem antes da chamada ao superctor sejam estáticos
0.6.8	Fevereiro de 2017	Permitir que @ModifyConstant conecte zero implícito em comparações
0.6.7	Janeiro de 2017	Adicione suporte para @Redirect no acesso ao array
0.6.6	Janeiro de 2017	Permitir métodos estáticos em mixins de acesso em Java 8 e superior
0.6.5	Janeiro de 2017	Adicionar suporte para fatias de injetor
0.6.4	Janeiro de 2017	Permitir descritores em NOVOS pontos de injeção
0.6.3	Dezembro de 2016	Suporte SourceDebugExtension
0.6.2	Dezembro de 2016	Adicionar suporte para mixins @Pseudo (alvo virtual)
0.6.1	Novembro de 2016	Processar anotações de implementos flexíveis no AP
0,6	Outubro de 2016	Suporte ao Mixin do Acessador
0.5.17	Outubro de 2016	Permitir que os injetores @Redirect direcionem NOVOS opcodes para redirecionamento do construtor
0.5.16	Outubro de 2016	Melhorias no processador de anotações. Suporta sombras e substituições em mixins multi-alvo Suporta ambientes de ofuscação conectáveis ​​em AP
0.5.14	Setembro de 2016	Adicionar suporte para descompilação assíncrona
0.5.13	Setembro de 2016	Adicionar estratégia alternativa para injetar inicializadores de campo
0.5.10	Junho de 2016	Suporte @Unique em campos
0.5.9	Junho de 2016	Falha grave se um alvo mixin necessário já foi transformado
0.5.8	Junho de 2016	Restrições de suporte em injetores
0.5.7	Junho de 2016	Adicionar anotação @Unique
0.5.6	Maio de 2016	Mudanças de ambiente, ambiente de suporte por meio de agentes
0.5.5	Abril de 2016	Adicionar injetor @ModifyConstant Adicionar anotação @Debug Permitir manipuladores @ModifyArg estáticos em métodos de instância
0.5.4	Abril de 2016	Os manipuladores de erros também recebem erros de preparação do mixin
0.5.3	Fevereiro de 2016	Injetores em conformidade Habilite o hotswapper automaticamente se o agente estiver ativo Corrija vários problemas com genéricos em processadores de anotação
0.5.2	Fevereiro de 2016	ID de suporte em injetores Prioridade de suporte para injetores
0.5.1	Fevereiro de 2016	Injetores de revisão, injetores de todos os mixins agora fazem a varredura antes que qualquer injetor seja realmente processado. Torna os injetores mais determinísticos.
0.4.19	Fevereiro de 2016	Adicione suporte para @Redirect em campos e também em métodos
0.4.18	Fevereiro de 2016	Adicionar injetor @ModifyLocal
0.4.17	Janeiro de 2016	Suporte ExtraSRGs no processador de anotações Incluir construtores no mapa de referência Adicione a anotação @Mutable para suprimir avisos @Final
0.4.15	Janeiro de 2016	Incluir alvos fáceis no refmap
0.4.14	Janeiro de 2016	Adicionar suporte para mixins de interface
0.4.13	Janeiro de 2016	Adicionar anotação @Final
0.4.11	Janeiro de 2016	Adicione suporte para agrupamento de injetores e valor de exigência em toda a configuração
0.4.10	Dezembro de 2015	Suporte para remapeamento em tempo de execução usando RemapperChain Ignore os transformadores de classe decorados com @Resource Suporta validação @reason e @author em substituições
0.4.8	Dezembro de 2015	Processador de anotações aprimorado para suportar MixinGradle Suporta vários ambientes de ofuscação de alvo em refmaps
0.4.6	Setembro de 2015	Adicione a fase INIT para lidar com a inicialização antecipada do FML Adicione suporte para lambdas em mixins Adicionar suporte para substituição de código ativo em mixins Melhore o suporte aos recursos do Java 8
0.4.4	Julho de 2015	Adicione restrições para substituições
0.4.3	Maio de 2015	Adicionar ponto de injeção INVOKE_ASSIGN Suporta retornos de chamada de injetores sem argumentos Suporta coerção de tipos de parâmetros covariantes em retornos de chamada Suporte ao truncamento de manipuladores de injetores de captura local Descompilação em tempo de execução de classes exportadas usando fernflower Adicionar filtro de exportação
0,4	Maio de 2015	Shade realocou o pacote ASM e usou em todo
0.3.2	Abril de 2015	Suporte ao manipulador de erros
0.3.1	Abril de 2015	Mesclagem de anotações Permitir que métodos de substituição tenham alias
0,3	Março de 2015	Ambientes Implementados Suporte ao método intrínseco Captura de variável local habilitada Suporte de alias
0,2	Março de 2015	Adicionado suporte a supermixin (mixins herdados de outros mixins)
0,1	Janeiro de 2015	Suporte básico para mixagem Suporte básico para injetores Processador de anotações