ATM10 (All The Mods 10) 시스템 엔지니어링 가이드

자동화 설계 표준 및 서버 충돌(Crash) 해결을 위한 공식 기술 문서

Chapter 1. Storage & Logistics (저장 및 물류 네트워크)
Applied Energistics 2 (AE2)
대규모 자동 조합 진행 중, 특정 재료에서 연산이 정지하며 시스템이 무한 대기 상태에 빠지는 현상.
패턴 인코딩 터미널에서 조합법을 등록할 때, 우측의 대체품 허용 (Allow Substitutions) 옵션을 반드시 비활성화(Off)해야 합니다. 해당 옵션 활성화 시 NBT 데이터 충돌로 인해 조합 CPU가 정지할 수 있습니다.
ME 컨트롤러의 한 면에서 사용할 수 있는 채널은 32개로 제한됩니다. 대규모 네트워크 설계 시, P2P Tunnel - ME를 사용하여 32채널을 1개의 채널로 압축하여 전송하는 아키텍처가 필수적입니다. 컨트롤러의 한 면을 P2P 입력 전용으로 할당하면, 케이블 하나로 수백 개의 채널을 원격지 서브 네트워크로 전송할 수 있습니다.
조약돌, 흙, 네더랙 등 대량으로 수급되는 아이템을 값비싼 ME 스토리지 셀에 저장하는 것은 비효율적입니다. Storage BusStorage Drawers의 Drawer Controller에 연결하고, 스토리지 버스의 우선순위(Priority)를 ME 드라이브보다 높게 설정하여 대용량 아이템을 드로워 시스템에 우선적으로 보관하도록 설계합니다.
Sophisticated Storage
Mystical Agriculture 에센스 등 대량으로 생산되는 아이템은 AE2 연산을 거치지 않고, 인벤토리에 Advanced Compacting Upgrade를 장착하여 전력 소모 없이 실시간으로 블록 압축을 수행하도록 설계합니다.
Chapter 2. Automation & Tech (자동화 및 기계 공학)
Super Factory Manager (SFM)
Ars Nouveau의 아케인 제단(Arcane Pedestal) 등 1칸의 물리적 인벤토리 제한을 가진 기계의 자동화.
주변 제단들을 단일 그룹으로 묶은 뒤, SFM 노드에서 AMOUNT 값을 설정하여 아이템을 분배합니다. 재료 부족으로 인한 시스템 정지를 방지하기 위해 반드시 조건문(Condition)을 논리 회로에 추가하여 요구 수량이 100% 충족되었을 때만 투입되도록 제어해야 합니다.
RFTools Utility (Crafter Tier 3)
네더의 별 5x 압축 블록과 같은 고연산 아이템 제작 시, AE2 조합 CPU의 과부하를 방지하기 위해 RFTools 조합기에 연산을 위임합니다. 하위 압축 단계(1~4차)의 산출물 설정은 내부 인벤토리 유지(Int)로 지정하여 외부 배출 없이 즉각적인 상위 압축이 이루어지도록 세팅합니다.
Chapter 3. Spawners & Resources (스포너 및 자원 생산)
Apothic Spawners (Apotheosis)
스켈레톤 등 원거리 AI를 가진 몹이 킬존(Kill Zone)으로 이동하지 않아 스포너의 개체 수 제한(Max Nearby Entities)에 걸려 스폰이 중단되는 현상.
스포너에 가스트의 눈물을 사용하여 최대 스폰 제한을 늘리고, 드래곤의 알을 사용하여 빛 밝기 등의 스폰 조건을 무시하도록 개조합니다. 물리적으로는 Mob Grinding Utils의 몹 선풍기(Mob Fan)를 활용해 강제 이송을 구현합니다.
Productive Bees
Amber Bee에 의해 몹이나 엔티티가 호박석(Amber)에 갇혔을 경우, 파괴 도구를 사용하지 않고 하단에 모닥불(Campfire)을 설치하여 안전하게 융해시킵니다. (생산물인 Amber Comb은 일반 콤브와 동일하게 원심분리기를 사용합니다.)
Chapter 4. Building & Utility (건축 및 다목적 도구)
Building Gadgets 2 & FTB Ultimine
기지 리모델링 시 Exchanging Gadget을 사용할 때, Soul Surge나 파이프 계열 등 내부 데이터(NBT)를 포함하는 타일 엔티티 블록은 데이터 증발 위험이 있어 스왑이 제한됩니다.
특수 블록 및 배관 시스템 교체 시에는 강제 스왑을 시도하지 않고, FTB Ultimine의 광맥 채굴 기능을 사용하여 안전하게 일괄 철거한 후 재설치하는 표준 규격을 권장합니다.
Chapter 5. Server Administration (서버 장애 대응)
MCA Selector 기반 크래시 복구 프로토콜
Ars Nouveau의 Wixie Cauldron 등 타일 엔티티 데이터 처리 오류로 인해 서버 기동 시 즉각적인 충돌(Crash)이 발생하는 치명적 오류.
에러 무시 컨피그(Config)가 작동하지 않는 하드 크래시의 경우, 자바 기반 외부 맵 에디터인 MCA Selector를 운용합니다. 서버의 world 폴더를 로드한 뒤, 크래시 리포트에 명시된 좌표(Block Location)로 이동(Ctrl+G)하여 해당 에러 청크를 완전히 삭제(Delete)함으로써 서버를 정상화할 수 있습니다.
Chapter 6. Server & Client Performance Optimization (서버 및 클라이언트 최적화)
JVM (Java Virtual Machine) Arguments Optimization
대형 모드팩 실행 시 발생하는 주기적인 렉(Stutter) 및 프레임 드랍 현상.
기본 JVM 설정 대신, 최신 가비지 컬렉터(Garbage Collector)를 사용하도록 인자를 수정합니다. ShenandoahGC 또는 ZGC 사용을 권장하며, 최소 8GB에서 최대 12GB의 RAM을 할당하는 것이 안정적입니다. (-Xmx10G -XX:+UseShenandoahGC) 시스템 메모리의 절반 이상을 할당하는 것은 오히려 시스템 불안정성을 초래할 수 있으니 피해야 합니다.
In-Game Entity & Rendering Management
서버 랙의 주범인 과도한 엔티티 생성을 제어해야 합니다. Mob Grinding Utils의 Dreadful Dirt나 Apawtheosis의 스포너을 사용할 경우, 생산된 몹이 즉시 처리되도록 Absorption Hopper와 킬링 시스템을 구축해야 합니다. 또한, 클라이언트 측면에서는 비디오 설정에서 Render Distance를 8~10チャン크로, Simulation Distance를 5~6으로 줄이는 것이 체감 성능 향상에 가장 효과적입니다.