🧩 아키텍처 및 Mixin 주입 대상 (MC 26.1.2)
📌 저장소 소스 코드 고지 사항: 이 Wiki의 문서는 CurseForge 및 Modrinth의 공개 릴리스 빌드에 앞서 최근에 커밋된 미출시 커밋이나 개발 중인 기능이 포함될 수 있는 저장소의 현재 소스 코드 상태를 반영합니다.
| 아키텍처 정보 상자 | 기술적 세부 파라미터 |
|---|---|
| 루트 패키지 | net.instantgratification.magnet |
| Mixin 설정 파일 | src/main/resources/magnet.mixins.json |
| Access Widener | src/main/resources/magnet.accesswidener |
| 호환성 레벨 | JAVA_25 |
| 총 Mixin 클래스 수 | 2 (MixinEntity, PlayerMixin) |
🌳 패키지 아키텍처 트리
text
net.instantgratification.magnet/
├── IMagnetEntity.java # NoClip 및 자화 플래그를 위한 엔티티 인터페이스
├── MagnetCommand.java # 서버 명령어 등록 (/magnet toggle)
├── MagnetManager.java # 엔티티 공간 스캔 및 실행 루프
├── MagnetMod.java # 모드 초기화 및 패킷 수신기
├── MagnetModClient.java # 클라이언트 초기화, Ctrl+M 단축키 및 오버레이 토스트
├── MagnetMovement.java # 궤적 벡터 수학, Lerp 속도 보간 및 파티클
├── MagnetPlayerState.java # ConcurrentHashMap 기반 스레드 안전 플레이어 상태 저장소
├── MagnetTogglePayload.java # 네트워크 패킷 레코드 및 StreamCodec 복합체
├── SecondaryVisionCheck.java # 정밀 블록 레이캐스팅 (식물, 블록 엔티티, 유리)
├── config/
│ ├── ClothConfigScreenHelper.java # Cloth Config Fabric GUI 빌더
│ ├── MagnetConfig.java # JSON 설정 저장소 및 POJO 필드
│ └── ModMenuIntegration.java # 리플렉션 안전 ModMenu API 연동
├── mixin/
│ ├── MixinEntity.java # Entity에 NoClip 및 중력 조건부 무효화 주입
│ └── PlayerMixin.java # Player에 틱 실행 및 즉시 수집 주입
└── registry/
└── ModGameRules.java # DynamicGameRuleManager 등록부📋 Mixin 주입 대상 상세 분석표
1. net.instantgratification.magnet.mixin.MixinEntity
net.minecraft.world.entity.Entity를 대상으로 하며 IMagnetEntity를 구현합니다.
| 주입 대상 메서드 | 주입 위치 (At Point) | 동작 및 동작 방식 |
|---|---|---|
ig_magnet$decrementNoClipTicks | @Inject(method = "tick", at = @At("HEAD")) | NoClip 활성화 시 매 틱마다 noClipTicks 카운트다운을 1씩 차감합니다. |
ig_magnet$preventPushOut | @Inject(method = "moveTowardsClosestSpace", at = @At("HEAD"), cancellable = true) | 서버에서 noClipTicks > 0일 때 바닐라 블록 탈출 튕겨냄 속도를 취소합니다. |
ig_magnet$forceNoClipOnMove | @Inject(method = "move", at = @At("HEAD")) | noClipTicks > 0일 때 originalNoPhysics를 캐싱하고 entity.noPhysics = true를 강제합니다. |
ig_magnet$restoreNoPhysicsAfterMove | @Inject(method = "move", at = @At("RETURN")) | 이동 완료 후 entity.noPhysics = originalNoPhysics 원본 값으로 복원합니다. |
ig_magnet$conditionalCancelGravity | @Inject(method = "applyGravity", at = @At("HEAD"), cancellable = true) | 아이템이 고체 블록 내부에 겹쳐 있을 때만 중력 가속도를 취소합니다. |
2. net.instantgratification.magnet.mixin.PlayerMixin
net.minecraft.world.entity.player.Player를 대상으로 합니다.
| 주입 대상 메서드 | 주입 위치 (At Point) | 동작 및 동작 방식 |
|---|---|---|
ig_magnet$tick | @Inject(method = "tick", at = @At("HEAD")) | 매 게임 틱마다 서버 측에서 MagnetManager.tick(player)를 호출합니다. |
ig_magnet$expandPickupArea | @ModifyVariable(method = "aiStep", at = @At("STORE"), ordinal = 0) | ig:magnet_instant 가 true일 때 수집 바운딩 박스를 확장합니다 (pickupArea.inflate(range)). |