JamLib — 다른 Minecraft 모드 구동을 위한 기술 라이브러리

JamLib — 다른 Minecraft 모드 구동을 위한 기술 라이브러리

JamLib는 Minecraft용 라이브러리 모드로, 그 자체로는 아이템, 블록, 몹, 구조물을 게임에 추가하지 않습니다. 이것은 다른 모드 제작자에게 다음을 제공하는 유틸리티 래퍼입니다: 로더 간 플랫폼 추상화, 완성된 설정 파일 시스템, 그리고 재패키징된 jar 파일 탐지 기능입니다. 이 라이브러리가 없으면 이를 요구하는 모드는 아예 실행되지 않습니다.

이 모드가 하는 일

이 라이브러리는 개발자를 위한 세 가지 작업을 동시에 해결합니다.

• Architectury 기반 플랫폼 추상화 — 동일한 코드가 Fabric, Forge, NeoForge, Quilt에서 별도의 분기 없이 작동합니다.

• 게임 내 자동 생성 설정 화면을 갖춘 JSON5 형식의 설정 API.

• 불법 «미러» 사이트에서의 재패키징 흔적을 확인하는 모드 jar 파일 검사.

플레이어 입장에서 이 라이브러리는 게임플레이에 아무것도 추가하지 않습니다. 유일하게 눈에 띄는 점은 설정에 JamLib를 사용하는 모드의 경우 모드 메뉴에 새 항목이 나타난다는 것입니다. 팩에 그런 모드가 있다면 해당 창에 슬라이더, 토글, 입력 필드가 있는 자동 생성 페이지가 표시됩니다.

JSON5 설정

표준 JSON은 코드 내 주석을 허용하지 않습니다. 라이브러리가 Jankson 의존성을 통해 다루는 JSON5는 이를 허용합니다. 실제로 이는 JamLib 기반으로 만들어진 모드의 설정 파일이 .json5처럼 보이며, 각 매개변수와 그 기본값을 바로 위에 설명하는 주석을 이미 포함하고 있다는 뜻입니다.

파일은 다시 쓰여질 때 사용자의 수정 내용을 유지합니다. //로 시작하는 자신만의 메모를 추가하면 설정이 다음에 저장된 후에도 그대로 남아 있습니다. 표준 JSON 라이브러리는 이를 할 수 없습니다.

설정 화면은 별도로 생성됩니다. Fabric과 Quilt에서는 표준 모드 메뉴를 통해 인터페이스가 표시되며, Forge와 NeoForge에서는 로더에 내장된 설정 화면 API를 통해 표시됩니다. 모드 제작자는 GUI를 직접 작성할 필요가 없습니다. JamLib는 설정 클래스에서 필드를 가져와 검증 기능이 포함된 위젯을 만듭니다 — 숫자 범위, 문자열용 정규식, 게임 재시작이 필요하다는 경고 등입니다.

재패키징 모드 탐지 기능

별도의 기능은 설치된 모드의 .jar 파일이 공식 소스에서 다운로드되었는지 확인합니다. 일부 사이트는 모드를 자신들의 이름으로 재패키징하며, 때로는 타사 소프트웨어를 함께 포함시키기도 합니다. JamLib는 실제 파일 이름을 매니페스트 내 JamLib-File-Name 필드와 비교합니다. 일치하지 않으면 월드 로드 후 채팅창에 경고가 표시됩니다. 메시지는 의심스러운 파일마다 한 번씩 표시되며, 이후 해당 .jar의 이름이 기억됩니다.

이 검사는 제작자가 의도적으로 JamLib-File-Name을 매니페스트에 추가한 모드(즉, 동일한 개발자의 모드이거나 이 기능을 수동으로 통합한 모드)에만 적용됩니다. 이 라이브러리는 mods 폴더 내 모든 .jar 파일을 바이러스나 악성 코드에 대해 검사하지 않습니다 — 이것은 백신 프로그램이 아닙니다.

결론

JamLib는 모드 개발자가 네 가지 로더를 위해 동시에 설정 시스템과 플랫폼 추상화를 직접 작성해야 하는 수고를 덜어줍니다. JamLib를 설치하는 것은 이를 요구하는 의존 모드와 함께일 때만 의미가 있습니다. 팩에 JamCoreModding이나 이 라이브러리를 기반으로 한 다른 타사 제작자의 모드가 하나도 없다면, JamLib의 .jar 파일은 활성 역할 없이 mods 폴더에 그대로 남아 있게 됩니다.