사용자 이름으로 플레이어 머리 주기: 프로필 구성 요소의 작동 방식과 머리가 비어 보이는 이유
머리에는 스킨 스냅샷이 저장될 뿐, 실시간 링크가 저장되는 것은 아닙니다. 여기서는 프로필 구성 요소, 오래된 머리가 잘못된 스킨을 표시하는 이유, 그리고 UUID 조회가 어떻게 맞물리는지 살펴봅니다.
플레이어의 머리를 주는 건 인수 하나면 될 것 같습니다. 실제로 그렇긴 한데, 저장되는 내용이 사람들이 기대하는 것과 달라서 머리 관련 이상한 점 대부분이 여기서 설명됩니다.
명령어
/give @p player_head[profile="Notch"]profile 구성 요소는 예전 SkullOwner NBT를 대체했습니다. {SkullOwner:"Notch"}를 사용하는 코드 조각은 1.20.5 이전 것이며 지금은 아무 효과도 없습니다.
실제로 저장되는 것
profile="Notch"로 주는 머리에는 이름만 저장됩니다. 이는 동적 프로필이며 — 아이템 툴팁에도 그렇게 표시됩니다 — 각 플레이어의 클라이언트가 머리를 그릴 때 이름을 조회해서 스킨을 가져옵니다. 머리에 고정 스냅샷이 담기는 것은 프로필에 텍스처 자체가 포함된 경우뿐입니다:
"profile": {
"name": "Notch",
"id": [I; …],
"properties": [{ "name": "textures", "value": "<base64>" }]
}두 가지 결과가 따릅니다:
- 이름 기반 머리는 플레이어의 현재 스킨을 따라갑니다. 그릴 때마다 다시 조회되며, 클라이언트는 조회한 스킨을 5분 동안 사용되지 않을 때까지 보관합니다.
textures속성을 가진 머리만 하나의 스킨으로 고정됩니다. - 해석이 이루어지는 곳은 보는 사람의 컴퓨터입니다.
textures속성이 내장된 머리는 조회 없이 그대로 렌더링됩니다. 이름 기반 머리는 서버의 온라인 모드가 아니라, 각 사용자의 클라이언트가 Mojang에 접속할 수 있는지에 달려 있습니다.
머리가 비어 있거나 스티브로 보이는 이유
가능성이 높은 순서대로:
- 이 클라이언트에서 이름이 해석되지 않았습니다. Mojang API에 접속할 수 없었거나 조회가 아직 진행 중이며, 해석될 때까지 머리는 기본 스킨을 표시합니다.
- 이름이 존재하지 않습니다. 삭제되었거나 한 번도 등록된 적 없는 계정에 대해 Mojang은 아무것도 반환하지 않습니다.
- 아직 해석 중입니다. 조회는 백그라운드에서 실행되므로, 머리가 처음 시야에 들어온 직후 잠시 동안 기본 스킨을 표시할 수 있습니다.
이름 기반 머리는 캐시 항목이 만료되면 스스로 다시 시도합니다. 대신 스킨을 고정하려면 textures 속성과 함께 머리를 주면 됩니다 — /fetchprofile name <name>는 플레이어를 해석하고 복사할 전체 구성 요소나 바로 줄 수 있는 완성된 머리를 제공합니다.
사용자 지정 머리는 이름이 아니라 텍스처를 사용합니다
장식용 머리 — 가구, 음식, 카탈로그의 몹 머리 — 에는 소유자가 없습니다. 이들은 텍스처 URL을 가리키는 base64 덩어리와 함께 properties 텍스처 값만 가지고 있습니다. 그래서 긴 give 명령어 하나로 공유할 수 있고, 플레이어가 이름을 바꿔도 절대 깨지지 않습니다.
base64는 textures.minecraft.net에 대한 textures.SKIN.url을 포함하는 작은 JSON으로 디코딩됩니다. 렌더링에 있어 그 안의 다른 것은 아무것도 중요하지 않습니다.
UUID 형식
두 가지 형태가 존재하며, 모든 상황에서 서로 바꿔 쓸 수 있는 것은 아닙니다:
trimmed 069a79f444e94726a5befca90e38aaf5
dashed 069a79f4-44e9-4726-a5be-fca90e38aaf5명령어와 NBT는 일반적으로 대시 형태나 정수 배열을 요구합니다. 웹 API는 보통 대시 없는 형태를 반환합니다. 둘 사이의 변환은 기계적입니다 — 8, 12, 16, 20번째 문자 뒤에 대시를 넣으면 됩니다.
사용자 이름으로 머리를 주거나, 장식용 머리 카탈로그를 둘러보거나, UUID 형식 간에 변환하려면 플레이어 머리 및 사용자 이름 도구를 이용하세요.