🧩 Arquitetura & Alvos de Mixin (MC 26.1.2)
📌 Aviso sobre o Código-Fonte do Repositório: A documentação nesta Wiki reflete o estado atual do código-fonte no repositório, que pode incluir commits recentes ainda não lançados ou recursos em desenvolvimento antes das compilações públicas oficiais no CurseForge e Modrinth.
| Infobox de Arquitetura | Parâmetros Técnicos |
|---|---|
| Pacote Raiz | net.instantgratification.magnet |
| Configuração do Mixin | src/main/resources/magnet.mixins.json |
| Access Widener | src/main/resources/magnet.accesswidener |
| Nível de Compatibilidade | JAVA_25 |
| Total de Classes Mixin | 2 (MixinEntity, PlayerMixin) |
🌳 Árvore de Arquitetura de Pacotes
text
net.instantgratification.magnet/
├── IMagnetEntity.java # Interface de entidade para flags de NoClip e magnetização
├── MagnetCommand.java # Registro de comandos no servidor (/magnet toggle)
├── MagnetManager.java # Loop de varredura espacial e execução de entidades
├── MagnetMod.java # Inicializador do mod e receptores de pacotes
├── MagnetModClient.java # Inicializador do cliente, atalho Ctrl+M e avisos na actionbar
├── MagnetMovement.java # Matemática vetorial de trajetória, velocidade lerp e partículas
├── MagnetPlayerState.java # Armazenamento em ConcurrentHashMap thread-safe para alternância do jogador
├── MagnetTogglePayload.java # Registro de pacote de rede e composição com StreamCodec
├── SecondaryVisionCheck.java # Raycasting granular de blocos (Flora, Entidades de Bloco, Vidro)
├── config/
│ ├── ClothConfigScreenHelper.java # Construtor da interface gráfica Cloth Config Fabric
│ ├── MagnetConfig.java # Armazenamento da configuração JSON e campos POJO
│ └── ModMenuIntegration.java # Ponto de entrada seguro contra reflexão da API ModMenu
├── mixin/
│ ├── MixinEntity.java # Injeta NoClip e cancelamento de gravidade em Entity
│ └── PlayerMixin.java # Injeta execução de tick e coleta instantânea em Player
└── registry/
└── ModGameRules.java # Registros no DynamicGameRuleManager📋 Detalhamento dos Alvos de Injeção de Mixin
1. net.instantgratification.magnet.mixin.MixinEntity
Tem como alvo net.minecraft.world.entity.Entity e implementa IMagnetEntity.
| Método Injetado | Ponto Alvo de Injeção | Ação & Comportamento |
|---|---|---|
ig_magnet$decrementNoClipTicks | @Inject(method = "tick", at = @At("HEAD")) | Decrementa a contagem regressiva de noClipTicks em 1 a cada tick quando ativo. |
ig_magnet$preventPushOut | @Inject(method = "moveTowardsClosestSpace", at = @At("HEAD"), cancellable = true) | Cancela a velocidade de empurrão para fora do vanilla se noClipTicks > 0 no servidor. |
ig_magnet$forceNoClipOnMove | @Inject(method = "move", at = @At("HEAD")) | Armazena em cache originalNoPhysics e força entity.noPhysics = true se noClipTicks > 0. |
ig_magnet$restoreNoPhysicsAfterMove | @Inject(method = "move", at = @At("RETURN")) | Restaura entity.noPhysics = originalNoPhysics após a conclusão do movimento. |
ig_magnet$conditionalCancelGravity | @Inject(method = "applyGravity", at = @At("HEAD"), cancellable = true) | Cancela a aceleração da gravidade para baixo apenas quando o item está dentro de um bloco sólido. |
2. net.instantgratification.magnet.mixin.PlayerMixin
Tem como alvo net.minecraft.world.entity.player.Player.
| Método Injetado | Ponto Alvo de Injeção | Ação & Comportamento |
|---|---|---|
ig_magnet$tick | @Inject(method = "tick", at = @At("HEAD")) | Invoca MagnetManager.tick(player) no servidor a cada tick de jogo. |
ig_magnet$expandPickupArea | @ModifyVariable(method = "aiStep", at = @At("STORE"), ordinal = 0) | Expande a caixa de colisão de coleta (pickupArea.inflate(range)) quando ig:magnet_instant é verdadeiro. |