Access Widening
Aprenda a como usar access wideners dos arquivos de modificadores de classe.
Access Widener é um tipo de modificador de classe] usado para flexibilizar o limite de acesso a classes, métodos e campos, refletindo essa mudança no código-fonte descompilado. Isso inclui tornando-os públicos, estendível e/ou mutável.
Entradas de access widener podem ser transitivas para fazer mudanças visíveis aos mods dependendo do seu mod.
Para acessar campos ou métodos, pode ser mais seguro e simples usar mixins, mas existem duas situações onde accessadores são insuficientes e access wideners são necessários:
- Se você precisa acessar uma classe
private,protectedou package-private - Se você precisa sobrescrever um método
finalou criar uma subclasse da classefinal
No entanto, ao contrário dos acessores de mixin, modificadores de classe apenas funcionam em classes do Minecraft Vanilla, e não em outros mods.
Access Directives
As entradas de access widener começam com um das três palavra-chaves das diretivas básicas para especificar o tipo de modificação que deve ser aplicada.
Depois da palavra-chave vem os parâmetros, normalmente os alvos do widening.
A mesma classe, método ou campo podem ser alvos de múltiplas entradas de access widening, uma em cada linha.
Access directives também podem ser tornadas transitivas ao adicionar o prefixo transitive- antes da base do access directive.
Accessible
accessible pode ter como alvo classes, métodos e campos:
- Classes e Campos são tornados públicos.
- Métodos são tornados públicos e finais se eram originalmente privados.
Ao tornar um método ou campo acessível, a sua classe também é tornada acessível.
Extendable
extendable pode ter como alvo apenas classes e métodos:
- Classes são tornados públicas e não-finais.
- Métodos são tornados não-finais.
Ao criar um método estendível, a sua classe também é tornada estendível.
Mutable
mutable pode tornar um campo não-final.
Especificando Alvos
Para modificadores de classe, classes usam os nomes internos. Para campos e métodos, você deve especificar os nomes de suas classes, os seus nomes e os seus descritores de bytecode.
Formato:
<accessible / extendable> class <className>Exemplo:
# Makes the inner class MenuSupplier in MenuType public
accessible class net/minecraft/world/inventory/MenuType$MenuSupplier2
Gerando Entradas
Escrever entradas de access wideners manualmente gasta muito tempo, além de ser sujeito a erros humanos. Vamos dar uma olhada nas ferramentas que simplificam parte do processo ao te permitir gerar e copiar entradas.
mcsrc.dev
mcsrc permite que você descompile e navegue na fonte do Minecraft pelo navegador e copie Mixin ou alvos do access transformer para a área de transferência.
Para copiar uma entrada de access widerer, primeiro navegue até a classe que você quer modificar, clique com o botão direito do mouse no seu alvo para abrir um menu pop-up.

Então, clique no Copy Class Tweaker / Access Widener, uma confirmação deve aparecer no topo da página.
![]()
Você pode então colar a entrada no seu arquivo de modificador de classe.
Plugin de Desenvolvimento do Minecraft (IntelliJ IDEA)
Plugin de Desenvolvimento do Minecraft, também conhecido como MCDev, é um plugin do IntelliJ IDEA que ajuda em vários aspectos do desenvolvimento de mods do Minecraft. Por exemplo, ele te permite copiar entradas de access widener do código-fonte descompilado alvo para a área de transferência.
Para copiar uma entrada de access widerer, primeiro navegue até a classe que você quer modificar, clique com o botão direito do mouse no seu alvo para abrir um menu pop-up.

Então, clique em Copy / Paste Special e AW Entry.

Agora uma confirmação deve aparecer no elemento que você clicou com o botão direito.

Você pode então colar a entrada no seu arquivo de modificador de classe.
Aplicando Mudanças
Para ver as suas mudanças aplicadas, você deve recarregar o seu projeto do Gradle e regenerar fontes. Os elementos que você tinha como alvo devem ter os seus limites de acesso modificados de acordo. Tenha certeza de reabrir 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 verificar se algum erro aparece.



























