Cloth Config API — Minecraft의 설정 화면용 모드

Cloth Config API — Minecraft의 설정 화면용 모드

Cloth Config API는 Minecraft의 수십 개 모드가 자신의 설정을 텍스트 파일이 아닌 게임 내 메뉴 형태로 표시하기 위해 필요로 하는 라이브러리입니다. 그 자체로는 게임에 아무것도 추가하지 않습니다. 아이템도, 블록도, 새로운 메커니즘도 없습니다. 이것은 종속성입니다. 이것이 없으면 그것을 연결한 모드들은 실행되지 않고 모드 목록에 오류를 표시합니다.

모드가 필요한 경우

라이브러리는 단독으로 설치하는 것이 아니라 다른 모드들과 함께 설치합니다. 특정 모드 묶음에 필요한지는 두 가지 방법으로 알 수 있습니다:

• Modrinth 또는 CurseForge의 모드 설명에서 Dependencies 목록에 Cloth Config API가 표시되어 있습니다.

• 묶음을 실행할 때 게임이 종료되고, 로그(logs/latest.log)에 cloth-config 또는 cloth-config-2가 없다는 언급이 나타납니다.

내부 이름 cloth-config-2는 같은 모드에 속합니다. 이는 라이브러리의 두 번째 메이저 버전부터 등장한 식별자입니다. 누군가 「cloth-config-2가 필요하다」라고 쓴다면, 이는 Cloth Config API의 최신 버전을 가리킵니다.

모드 설정을 여는 방법

Forge와 NeoForge에서는 설치된 모드 목록이 게임 메인 메뉴에 내장되어 있습니다. Mods 항목입니다. Cloth Config를 연결한 각 모드 옆에는 설정 아이콘이 나타납니다. 클릭하면 바로 그 모드의 모든 매개변수가 담긴 별도 화면이 열립니다.

Fabric에서는 로더에 표준 모드 목록이 없으므로, Cloth Config 화면에 대한 접근은 모드를 표시하는 외부 도구를 통해 구현됩니다. 이 도구는 설치된 항목 목록을 보여 주고 원하는 항목 옆의 버튼을 클릭할 수 있게 해 줍니다.

Cloth Config를 이용한 모드 설정 

화면 자체는 어떻게 생겼는가

모드의 모든 화면은 동일한 구조로 구성되어 있습니다. 왼쪽에는 매개변수 카테고리, 가운데에는 매개변수 자체, 아래에는 저장 및 취소 버튼이 있습니다. 각 매개변수는 그 값의 유형에 맞는 인터페이스 요소로 표시됩니다. 

화면 상단에는 수십 개의 매개변수가 있는 설정의 경우 검색 필드가 있어 이름으로 목록을 필터링합니다. 모드 제작자가 설명을 지정한 매개변수 옆에는 커서를 올리면 설명이 담긴 툴팁이 나타납니다.

허용 범위를 벗어나거나 허용되지 않는 형식으로 값을 입력하면 필드가 강조 표시되고, 오류를 수정할 때까지 저장 버튼이 비활성화됩니다. 각 매개변수 옆에는 초기화 버튼이 있어, 값을 모드 제작자가 기본값으로 지정한 값으로 되돌립니다.

결론

Cloth Config API는 인프라적 종속성입니다. 이것이 없으면 일부 모드는 그저 실행되지 않지만, 모드 자체는 연결된 다른 모드 없이는 게임에서 눈에 보이는 어떤 것도 제공하지 않습니다. 그 역할은 Minecraft의 다양한 모드 설정을 수십 가지의 서로 다른 인터페이스 대신 공통의 시각적 표준으로 통합하는 것입니다. Fabric과 멀티플랫폼 묶음에서 Cloth Config API는 가장 널리 쓰이는 공통 표준으로 남아 있습니다.