Architectury API: Minecraft 크로스 플랫폼 모드를 위한 중개 라이브러리 개요

여러 Minecraft 로더용 모드를 만들 때 개발자는 보통 Fabric, Forge, NeoForge용 코드베이스를 각각 따로 작성하고 유지보수해야 합니다. Architectury API 라이브러리는 모드 코드와 각 로더 전용 API 사이에 중개 역할을 하는 추상화 계층을 제공함으로써 이 문제를 해결합니다. 이를 통해 개발자는 대부분의 코드를 공유하면서도 각 환경에 맞는 컴파일이 자동으로 이루어지는 크로스 플랫폼 모드를 만들 수 있습니다. 플레이어 입장에서 이 라이브러리는 수십 개의 인기 애드온을 실행하기 위한 필수 의존성입니다.

Architectury API의 개념과 기술적 장점

Architectury API의 주요 목적은 모드 개발 시 중복 코드를 최소화하는 것입니다. 개발자들은 Fabric과 Forge의 서로 다른 이벤트 및 등록 시스템을 각각 배워서 쓰는 대신, 통합된 중개 클래스를 사용합니다.

이 라이브러리가 개발자에게 제공하는 주요 메커니즘:

• 통합 레지스트리: 새로운 블록, 아이템, 바이옴, 엔티티를 하나의 공통 인터페이스를 통해 등록할 수 있으며, 라이브러리가 이를 각 로더의 요구 사항에 맞게 스스로 조정합니다.

• 네트워크 통신: Forge와 Fabric의 서로 다른 네트워크 프로토콜을 통합하여 클라이언트와 서버 간 커스텀 데이터 패킷 전송을 단순화합니다.

• 이벤트 처리: 블록 상호작용, 몹 사망, 메뉴 열기 등 공통 게임 이벤트 목록을 제공하여, 개발자가 시스템별로 별도의 이벤트 리스너를 작성할 필요를 없애줍니다.

• 빌드 자동화: 개발 환경용 전용 Gradle 확장이 공유 코드로부터 각 로더에 맞는 최종 .jar 파일을 자동으로 생성합니다.

호환성에 미치는 영향과 인기 있는 종속 모드

Architectury API를 사용하면 개발자가 자체 애드온의 로직을 다시 작성할 필요 없이 라이브러리 자체만 업데이트하면 되기 때문에, 새로운 Minecraft 버전에 맞춰 모드를 유지보수하고 업데이트하는 작업이 크게 단순해집니다. 이 덕분에 Architectury API는 여러 대규모 프로젝트의 근간이 됩니다.

이 라이브러리를 필요로 하는 유명 모드의 예:

• Cloth Config API: 설정 화면을 만들기 위한 인기 라이브러리로, Architectury의 도구를 사용해 설정 메뉴를 그립니다.

• Rough Enough Items (REI): 크로스 플랫폼 네트워크 패킷과 레지스트리에 의존하는 인기 있는 제작 레시피 열람 인터페이스입니다.

• Lighty: 밝기 레벨을 시각화하는 모드로, Fabric과 Forge 양쪽에서 렌더링 이벤트를 추적하기 위해 Architectury가 필요합니다.

• Better Archeology: 공유 등록 도구를 사용해 여러 로더에 새로운 고고학 구조물, 아이템, 블록을 추가하는 애드온입니다.

플레이어가 해당 버전의 Architectury API를 미리 설치하지 않은 채 이 모드들 중 하나라도 실행하려 하면, 게임 클라이언트는 즉시 로딩을 중단하고 라이브러리 추가를 요구하는 오류 메시지를 표시합니다.

호환성 세부 사항 및 설치 요구 사항

개발팀은 Architectury API를 순수하게 기술적인 플러그인으로 배포합니다. 플레이어는 자신의 게임 버전과 선택한 로더(Fabric, Forge, NeoForge 중 하나)에 정확히 일치하는 라이브러리 파일을 다운로드해야 합니다.

설치는 표준 방식을 따릅니다 — .jar 파일을 mods 폴더로 옮기면 됩니다. 이 라이브러리는 설정이 종속 모드에 직접 통합되어 있기 때문에 config 폴더에 자체 설정 파일을 생성하지 않습니다. 백그라운드에서 동작하며 설정에 수동으로 개입할 필요가 없어, 잘못된 설정으로 인한 충돌 위험이 없습니다.

결론

서로 다른 로더용으로 여러 개의 별도 프로젝트를 구축하고 유지보수하는 것과 비교하면, Architectury API는 개발자가 하나의 공유 프로젝트 안에서 작업할 수 있게 해줍니다. 이 라이브러리의 가장 큰 제약은 작성자가 내부 도구를 익히는 데 필요한 추가 시간입니다. 이 모드는 모드팩에서 현대적이고 기술적으로 발전된 모드를 사용하고자 하는 플레이어에게 필수 설치 항목입니다.