🔌 Mixin 바이트코드 주입 레퍼런스

📌 저장소 소스 코드 면책 조항: 본 위키 문서는 저장소의 현재 소스 코드 상태를 반영하며, CurseForge 및 Modrinth의 공개 릴리스 빌드보다 앞선 미출시 커밋이나 개발 중인 기능을 포함할 수 있습니다.

Better Bats uses Bytecode Mixins to modify vanilla entity and world spawning behavior while keeping world saves 100% vanilla-safe.

☕ 1인 개발자 노트: 사실적인 3D BOIDs 군집 비행과 농작물을 비옥하게 만드는 구아노 시비 시스템이 마음에 드셨다면, Ko-fi에서 개발자를 후원해 주세요!

📋 전체 Mixin 주입 매핑표

Mixin Class	Target Vanilla Class	Target Method	`@At` Injection Point	Cancellation / Behavior
`BatMixin`	`net.minecraft.world.entity.ambient.Bat`	`<init>`	`@At("TAIL")`	Registers custom AI goals (Panic, Sleep, HuntLight, DiveBomb) into `goalSelector`.
`BatMixin`	`net.minecraft.world.entity.ambient.Bat`	`customServerAiStep`	`@At("HEAD")`	`cancellable = true`. Completely replaces vanilla flight calculation with `BatFlightHelper` forces and resting logic.
`BatMixin`	`net.minecraft.world.entity.ambient.Bat`	`checkBatSpawnRules`	`@At("HEAD")`	`cancellable = true`. Validates surface nighttime spawning rules.
`BatMixin`	`net.minecraft.world.entity.ambient.Bat`	`addAdditionalSaveData`	`@At("TAIL")`	Writes `betterbats:guano_ticks` integer tag to `ValueOutput`.
`BatMixin`	`net.minecraft.world.entity.ambient.Bat`	`readAdditionalSaveData`	`@At("TAIL")`	Reads `betterbats:guano_ticks` integer tag from `ValueInput`.
`GameEventDispatcherMixin`	`net.minecraft.world.level.gameevent.vibrations.VibrationSystem$Listener`	`handleGameEvent`	`@At("HEAD")`	Notifies nearby bats of sprint/explosion vibrations.
`NaturalSpawnerMixin`	`net.minecraft.world.level.NaturalSpawner`	`m_6419_`	`@At("HEAD")`	Replaces vanilla bat spawn weights with `bat_spawn_weight` GameRule.