🏛️ 시스템 아키텍처 및 패키지 구조
📌 저장소 소스 코드 면책 조항: 본 위키 문서는 저장소의 현재 소스 코드 상태를 반영하며, CurseForge 및 Modrinth의 공개 릴리스 빌드보다 앞선 미출시 커밋이나 개발 중인 기능을 포함할 수 있습니다.
| Design Principle | Architectural Policy |
|---|---|
| Core Philosophy | Vanilla Outsider (VO) — Diegetic, non-destructive, input-consistent |
| Design Rule | 1 File, 1 Function Law (Single-responsibility Cohesion) |
| Main Package Namespace | net.vanillaoutsider.betterbats |
| Thread Safety Model | Server-Thread Main Looper Sync (No async world mutation) |
☕ 1인 개발자 노트: 사실적인 3D BOIDs 군집 비행과 농작물을 비옥하게 만드는 구아노 시비 시스템이 마음에 드셨다면, Ko-fi에서 개발자를 후원해 주세요!
🌳 패키지 계층 구조도
net.vanillaoutsider.betterbats
├── BetterBatsFabric.java # Mod initialization, GameRules registration
├── BetterBatsFabricClient.java # Client render layer, debug toggles
├── ai/ # AI Goal domain logic
│ ├── BatDiveBombGoal.java # Predatory hunting of silverfish/endermites
│ ├── BatFlightHelper.java # 3D BOIDs flocking and vector math
│ ├── BatHuntLightGoal.java # Nighttime phototaxis light orbiting
│ ├── BatPanicGoal.java # Vibration acoustic panic dispersion
│ ├── BatRoostHelper.java # Daytime roost surface validator
│ └── BatSleepGoal.java # Roosting and guano accumulation
├── config/ # YACL v3 and Cloth Config menus
│ ├── BetterBatsConfig.java # Plain Java config data model
│ └── ModMenuIntegration.java # ModMenu screen factory provider
└── mixin/ # Bytecode injection layer
├── BatMixin.java # Injects AI goals, flight forces, save data
├── GameEventDispatcherMixin.java # Acoustic vibration listener hook
└── NaturalSpawnerMixin.java # Dynamic ambient spawner weight replacement🧩 핵심 클래스 역할
BatFlightHelper: Stateless mathematical engine computing flocking, cohesion, separation, alignment, and altitude bounds.BatRoostHelper: Checks valid roosting blocks (dripstone, chains, lanterns, leaves, solid ceilings).BatMixin: Surgical bytecode hooks ensuring complete vanilla world-save safety.
Next: Mixin 레퍼런스 및 주입점 | AI 행동 프로필 및 상태