Forge Config API Port — Minecraft Java Edition

바닐라 Minecraft에는 게임 설정이나 모드를 편리하게 구성할 수 있는 내장 도구가 없기 때문에 개발자는 자체적인 설정 저장 시스템을 만들어야 합니다. Forge 모드 로더는 자체 구성 시스템의 형태로 기성 솔루션을 제공하지만 Fabric에는 역사적으로 이에 대한 단일 표준이 없습니다. 이로 인해 크로스 플랫폼 모드 제작자는 로더마다 별도의 설정 코드를 작성해야 하므로 많은 시간을 소비하게 됩니다. Forge Config API Port 라이브러리는 Forge의 오랜 테스트를 거친 구성 인터페이스를 Fabric 및 Quilt로 포팅하여 이 문제를 해결합니다.

라이브러리 작동 방식

Forge Config API Port는 모드 코드와 게임 파일 시스템 사이의 중재자 역할을 합니다. Fabric 환경에서 원래의 net.minecraftforge.common.ForgeConfigSpec 및 net.neoforged.fml.config 패키지를 완벽하게 재현합니다. 개발자는 표준 Forge 구문을 사용하여 구성을 한 번만 작성하면 라이브러리가 디스크에 적절한 파일을 자동으로 생성하고 로딩을 관리합니다.

TOML 구성 파일 형식

라이브러리는 모든 설정을 TOML 형식으로 저장합니다. 이 형식은 일반 텍스트 편집기를 사용하여 읽고 편집할 수 있는 편리한 구조를 제공합니다. 각 매개변수에는 주석, 기본값은 물론 허용되는 값의 명확한 한계(최소 및 최대 수치)가 포함될 수 있습니다. 구성 파일은 모드를 처음 시작한 후 게임의 루트 디렉토리 내 config 폴더에 자동으로 나타납니다. .toml 확장자와 모드 개발자가 지정한 이름이 있습니다.

자동 동기화 및 동적 재장전

Forge Config API Port의 가장 중요한 기능 중 하나는 구성 동기화 및 동적 재장전에 대한 기본 지원입니다:

• 서버와 클라이언트 간의 동기화 (Sync): 플레이어가 서버에 연결하면 서버가 자동으로 클라이언트에 설정을 보냅니다. 이를 통해 서버의 플레이어 간 구성 버전 차이로 인한 충돌을 방지할 수 있습니다.

• 동적 재장전 (Reload): 라이브러리는 실시간으로 TOML 파일의 변경 사항을 추적합니다. 게임 중에 구성 파일을 편집하고 저장하면 Forge Config API Port는 Minecraft 클라이언트를 다시 시작할 필요 없이 RAM의 매개변수를 즉시 업데이트합니다.

이러한 메커니즘은 자동으로 작동하므로 개발자가 구성 값 동기화를 위해 네트워크 상호 작용을 직접 코딩할 필요가 없습니다.

플레이어와 개발자에게 미치는 영향

일반 플레이어에게 Forge Config API Port는 눈에 띄는 콘텐츠, 새로운 블록이나 아이템을 추가하지 않습니다. 그 역할은 다른 모드가 작동하도록 보장하는 것입니다. 다른 모드가 이 라이브러리의 클래스를 참조하는 경우 이 라이브러리를 설치하지 않으면 게임이 시작되지 않습니다. Forge와 NeoForge는 구조적으로 기본적으로 이러한 기능을 갖추고 있기 때문에 이 모드는 주로 Fabric 사용자에게 필요합니다.

개발자에게 이 라이브러리는 크로스 플랫폼 프로젝트를 만들 때 필수적인 도구입니다. 이를 통해 다음을 수행할 수 있습니다:

1. 이전에는 다양한 로더를 위한 별도의 설정 저장 로직을 개발하는 데 사용되었던 수백 줄의 코드를 절약할 수 있습니다.

2. 구성 파일이 Fabric 및 Forge에서 동일한 구조를 가지므로 최종 사용자에게 모드 관리에 대한 동일한 경험을 제공할 수 있습니다.

3. 오류가 있는 사용자 입력을 자동으로 수정하여 충돌 시 매개변수를 기본값으로 되돌리는 강력한 Forge 값 검증 도구를 사용할 수 있습니다.

인기 있는 종속 모드

Fuzs (또는 Fuzs_)라는 이름으로 알려진 라이브러리 개발자는 자신이 만든 모든 인기 모드에서 이를 사용합니다. 몇 가지 유명한 예는 다음과 같습니다:

• Easy Magic: 인챈트 테이블의 메커니즘을 변경하여 테이블의 인벤토리 내에 아이템을 저장할 수 있게 하고 인챈트를 향상시키는 새로운 방법을 추가하는 모드.

• Trading Post: 주변의 모든 주민의 거래 제안을 단일 인터페이스로 결합하는 블록.

• Visuality: 다양한 몹의 행동에 따른 사실적인 흙 입자, 불꽃, 물 튀김을 추가하는 시각 효과 모드.

• Easy Shulker Boxes: 셜커 상자를 바닥에 놓지 않고도 인벤토리에서 직접 상호작용할 수 있습니다.

Fuzs의 프로젝트 외에도 수백 명의 다른 개발자가 Forge Config API Port를 사용하여 자신의 작업을 Forge에서 Fabric으로 포팅하고 있으며, 플레이어는 방대한 고품질 콘텐츠 라이브러리에 액세스할 수 있습니다.