Balm — Minecraft에서 다양한 모드 로더로 모드를 작동시키는 라이브러리 모드
Balm은 단독으로는 아무 것도 추가하지 않는 라이브러리 모드로, Fabric·Forge·NeoForge에서 다른 모드가 동일하게 작동하도록 공통 코드를 제공합니다.
Balm은 단독으로는 아무 것도 추가하지 않는 라이브러리 모드로, Fabric·Forge·NeoForge에서 다른 모드가 동일하게 작동하도록 공통 코드를 제공합니다.
Balm — Minecraft에서 다양한 모드 로더로 모드를 작동시키는 라이브러리 모드
이 문서를 테스트하고 작성한 Minecraft 버전: 26.1.2
지원 버전 범위: 1.18.x – 26.2
Balm은 Minecraft의 다른 모드들이 의존하는 라이브러리로, 그 자체로는 블록, 아이템, 몹, 게임 메커니즘을 추가하지 않습니다. 단독으로 설치할 필요는 없으며, 다른 모드가 Balm을 필수 종속성으로 지정한 경우에만 필요합니다. 이 라이브러리의 역할은 모드 제작자에게 Fabric, Forge, NeoForge에서 동일하게 작동하는 공통 코드를 제공하여, 로더마다 별도의 버전을 작성할 필요를 없애는 것입니다.
Balm이 필요한 이유
각 모드 로더는 저마다 다르게 구성되어 있습니다. 아이템 등록, 이벤트 처리, 네트워크, 설정 등은 Fabric, Forge, NeoForge에서 각각 다른 방식으로 구현됩니다. 중간 계층이 없다면 제작자는 각각에 맞춰 별도의 코드를 작성해야 합니다. Balm은 이러한 차이를 대신 처리합니다 — 모드는 라이브러리의 공통 도구 세트를 호출하고, 라이브러리는 이를 각 로더에 맞는 방식으로 변환합니다.
플레이어 입장에서 결과는 간단합니다. 동일한 모드가 세 로더 모두를 위해 동시에 출시되며, 어디서나 동일하게 작동합니다. 원하는 모드의 종속성 목록에 Balm이 있다면, 사용 중인 로더와 Minecraft 버전에 맞는 두 파일을 내려받아 mods 폴더에 넣기만 하면 됩니다.
라이브러리 버전은 본체 모드가 빌드된 Minecraft 버전 및 로더와 일치해야 합니다. Fabric용 Balm 파일은 Forge에서 실행되지 않으며, 그 반대도 마찬가지입니다.
라이브러리가 담당하는 부분
게임 밖에서는 보이지 않지만, Balm은 이를 기반으로 한 모드의 동작 일부를 책임집니다. 라이브러리는 다음과 같은 영역을 포괄합니다.
콘텐츠 등록 — 모드의 아이템, 블록 및 기타 객체가 공통 메커니즘을 통해 추가됨;
게임 이벤트 — 모드가 단일한 핸들러 세트를 통해 플레이어와 월드의 동작에 반응함;
네트워크 — 클라이언트와 서버 간 데이터 전송, 추가 정보가 담긴 메뉴 열기;
설정 — 게임 내 별도 화면에 표시할 수 있는 설정 시스템.
또한 라이브러리는 레시피 뷰어, 정보 표시 HUD, 액세서리 모드 같은 외부 유틸리티에 대한 공통 접근점을 제공합니다. 덕분에 제작자는 이런 통합을 로더마다 일일이 수동으로 유지할 필요가 없습니다.
Balm을 통한 모드 설정
설정은 라이브러리가 단순히 로더로 변환하는 것이 아니라 직접 구현하는 몇 안 되는 부분 중 하나입니다. Balm 기반 모드는 모드 목록에서 접근 가능한 별도의 설정 화면에 매개변수를 표시할 수 있어, 파일을 수동으로 편집할 필요가 없습니다.
플레이어에게 눈에 띄는 두 번째 사항은 동기화입니다. 일부 설정은 접속 시 서버가 클라이언트에게 전달하므로, 규칙이 모든 참여자에게 동일하게 적용됩니다. 라이브러리는 또한 네트워크 버전의 일치 여부도 확인합니다. 클라이언트와 서버의 모드 버전이 다르면 연결이 메시지와 함께 거부되며, 게임 중 숨겨진 오류로 이어지지 않습니다.
결론
Balm은 제작자가 공통 코드로 Fabric, Forge, NeoForge용 모드를 동시에 출시할 수 있게 하며, 플레이어에게는 어떤 로더에서도 동일한 동작을 보장합니다. 다른 추상화 레이어와 달리, 이 라이브러리는 각 로더의 공식 도구만을 사용하며 외부 종속성을 끌어들이지 않습니다. Balm을 설치하는 것은 다른 모드가 이를 요구할 때만 의미가 있으며, 모드팩에는 보통 이미 자동으로 포함되어 있습니다.
설치
일반적인 설치는 약 5 분 정도 걸려요. 과정은 동일하고, Loader 와 그에 맞는 빌드만 달라요.
- 1Install a mod loader (Forge, Fabric or NeoForge) that matches your Minecraft version.
- 2Download the mod file (.jar) built for that same version.
- 3Place the .jar into your .minecraft/mods folder.
- 4Launch Minecraft with the modded profile and check the mod loads in-game.











