Minecraft 26.3용 Cape Provider 모드

케이프를 제공합니다!

다양한 제공자 중에서 선택하거나 직접 추가할 수 있습니다.

"Capes" 모드의 개선/재작업 버전:

• 케이프 제공자 통합이 개선되고 더 쉬워짐
• 제공자 순서 지정 가능
• 사용자 지정 제공자 지원
• 케이프 적용 방식을 세밀하게 조정할 수 있는 더 많은 옵션
• Java로만 작성됨 (Kotlin 불필요)
• 다양한 수정 및 개선

사용자 지정 케이프 제공자 만들기

이 모드는 제공자를 추가할 수 있는 다양한 방법을 제공합니다.

다음 가능성들은 간단한 순서대로 정렬되어 있습니다:

간단한 로컬 제공자

권장 대상:

• 사용자 지정 가능한 케이프를 원하는 사용자
• 모드팩 (config/cape-provider/simple-custom 사용)

케이프를 표시하는 가장 간단한 방법은 config/cape-provider 디렉터리로 가서 cape.png라는 이름의 케이프 텍스처 파일을 만드는 것입니다.

추가로 다음과 같은 선택적 파일들이 있습니다:

• owners.txt - 어떤 플레이어 이름 또는 UUID가 케이프를 표시받을지 결정합니다. 이 파일이 없으면 모든 플레이어가 케이프와 함께 표시됩니다.
• name.txt - 제공자의 표시 이름을 재정의합니다

config/cape-provider/simple-custom에 해당 디렉터리를 만들어 더 많은 제공자를 추가할 수도 있습니다. 예: config/cape-provider/simple-custom/my-super-cool-provider/cape.png

구성에서의 원격 제공자

권장 대상:

• 사용자 지정 원격 제공자를 추가하려는 사용자

이 데모는 custom-cape-demo 내부에서 케이프를 적용하는 방법을 보여줍니다.

• config/cape-provider/config.json에 있는 구성 파일을 엽니다
• remoteCustomProviders 섹션에 다음 항목을 추가합니다:

{ "id": "cp1", "name": "CustomProvider1", // 플레이어별로 케이프를 사용자 지정하려면 uuid를 $id, $name 또는 $idNoHyphen으로 바꿀 수 있습니다 "uriTemplate": "https://raw.githubusercontent.com/litetex-oss/mcm-cape-provider/refs/heads/dev/custom-cape-demo/uuid.png" }

SkinMC 예시

{ "id": "skinmc", "name": "SkinMC", "uriTemplate": "https://skinmc.net/api/v1/skinmcCape/$id" }

• 게임을 다시 시작하고 제공자를 활성화합니다

자세한 내용은 RemoteCustomProvider 및 RemoteCustomProviderConfig를 참고하세요

참고: 텍스처 리졸버는 textureResolverId 속성을 사용하여 선택할 수 있습니다 (자세한 내용은 아래 참조).

모드를 통한 방법

권장 대상:

• 모드

모드 개발자이고 예를 들어 모드의 후원자나 기여자를 위해 케이프를 표시하려는 경우, 모드의 리소스 및/또는 fabric.mod.json의 메타데이터를 사용하여 제공할 수 있습니다. 전반적인 동작은 modmenu가 이를 처리하는 방식과 유사합니다.

로컬/간단 (권장)

이 접근 방식은 네트워크 통신이 필요 없으며 권장되는 방법입니다. 케이프 디렉터리에서 메타데이터와 리소스를 읽어 작동합니다.

다음은 예시입니다:

• 다음 모드 메타데이터를 추가합니다:

fabric.mod.json

{ ... "custom": { "cape": "Contributors" } }

• resources 안에 cape 디렉터리를 만듭니다
• cape/cape.png에 케이프 텍스처를 추가합니다
• 케이프를 받아야 할 플레이어를 cape/owners.txt에 UUID 또는 이름으로 추가합니다

참고: 더 자세한 변형도 있습니다

fabric.mod.json

{ "custom": { "cape": { "name-extra": "Contributors", "owners": { // UUID도 사용할 수 있습니다 "names": [ "Notch" ] } } } }

이 모드 자체가 이 전략을 사용합니다. 자세한 내용은 fabric.mod.json 또는 cape 디렉터리를 참조하세요.

원격

다음은 원격 케이프 제공자를 추가하는 방법을 보여주는 예시 구현입니다:

fabric.mod.json

{ ... "custom": { "cape": "https://raw.githubusercontent.com/litetex-oss/mcm-cape-provider/refs/heads/dev/custom-cape-demo/uuid.png" } }

다음은 더 자세한 변형입니다

fabric.mod.json

{ "custom": { "cape": { // 모든 사람에게 크리스마스 케이프를 제공합니다 // 여기에서 $uuid 같은 변수도 사용할 수 있습니다. 자세한 내용은 위를 참조하세요 // $를 \로 이스케이프해야 할 수도 있고, 대신 $ 대신 §를 사용할 수도 있습니다 // 대안: "uriTemplate" "url": "https://example.org/textures/§uuid.png", "changeCapeUrl": "https://...", "rateLimitedReqPerSec": 20 // 기본값은 20 } } }

프로그래밍 방식

프로그래밍 방식의 케이프 제공자도 만들 수 있습니다.

추가 참고 사항

최대 크기

이미지/텍스처는 10MB를 초과하지 않아야 합니다. 그렇지 않으면 무시될 수 있습니다.

텍스처 리졸버 / 애니메이션 텍스처

현재 다음과 같은 리졸버가 내장되어 있습니다:

Resolver-ID - Animated - Format - Example - Notes

default / null - ❌ - PNG - uuid.png sprite - ✔ - Stacked PNG - animated.png | gif | ✔ | GIF | animated.gif | 사용을 권장하지 않음 GIF는 PNG 같은 최신 형식에 비해 더 많은 리소스를 필요로 합니다. |

애니메이션 텍스처는 설정에서 고정되거나 완전히 비활성화될 수 있습니다.