Skip to content

펫 가져오기 ​

펫은 캐릭터 파일이에요. 앱에 든 기본 펫과 Codex의 펫 폴더(~/.codex/pets)에 있는 펫은 아무것도 하지 않아도 초대 탭에 보이고, 다른 펫은 가져와야 해요.

링크로 한 번에 가져오기 0.1.0부터 ​

펫 갤러리에 PlayPets에서 열기 같은 링크가 있으면 누르기만 하면 돼요. 링크는 playpets://import?url=<펫 페이지 주소> 꼴이에요. PlayPets가 설치돼 있으면 먼저 "이 펫을 가져올까요?" 하고 링크가 어느 사이트에서 왔는지 보여 주고, 가져오기로 하면 그 펫을 가져온 뒤 초대 탭을 열어요. 갤러리를 운영한다면 펫 페이지에 이 링크를 달아 주세요.

text
playpets://import?url=https%3A%2F%2Fpetdex.dev%2Fpets%2Fboba

펫 가져오기 창 0.1.0부터 ​

초대 탭 위쪽의 펫 가져오기를 누르면 창이 열려요. 두 가지 방법이 있어요.

  • 펫 페이지 주소에 커뮤니티 사이트의 펫 페이지 주소나 GitHub 펫 폴더 주소를 붙여 넣고 가져오기를 눌러요.
  • 내 컴퓨터의 폴더에서 가져오기를 눌러 펫 폴더를 골라요.

가져오기가 끝나면 그 펫이 바로 놀이터에 친구로 초대돼요. "새 펫을 가져와 놀이터에 초대했어요" 알림이 떠요.

파일은 https 주소에서만, 그리고 붙여 넣은 주소의 사이트(와 그 하위 도메인)에서만 받아요. 펫 페이지가 다른 사이트의 파일을 가리키면 가져오지 않아요.

지원하는 사이트 0.1.0부터 ​

다른 펫 찾아보기는 처음에 접혀 있어서 주소 입력과 가져오기 버튼을 찾기 쉬워요. 펼치면 사이트 목록과 가져오기 안내가 짧게 보여요. 사이트를 열고 마음에 드는 펫 페이지의 주소를 위 입력창에 붙여 넣으면 돼요. 커뮤니티 링크이며, 목록에 있다고 제휴 관계를 뜻하지는 않아요.

사이트사이트 주소
OpenPets Registryopenpets.sh
Petdexpetdex.dev
Codex PokéPetsgithub.com/dnnyngyen/codex-pokepets
Awesome Codex Petcodexpet.top
Codex Petscodex-pets.net

칩에 없는 곳도 돼요. GitHub의 펫 폴더(pet.json이 있는 폴더) 주소와 codex-pet-share로 만든 사이트의 펫 페이지 주소도 가져올 수 있어요.

위 사이트에는 전용 가져오기 기능이 있어요. (구경만) 표시가 붙은 사이트에는 전용 가져오기 기능이 없지만, 지원하는 일반 펫 페이지 형식이라면 주소를 붙여 넣어 가져올 수 있어요. 목록에 사이트를 추가하는 것만으로 가져오기 기능이 생기지는 않아요.

주소가 틀리거나 사이트가 응답하지 않으면 창 안에 이유가 나와요. 가져오는 중에는 창을 닫을 수 없어요.

내 컴퓨터의 폴더 0.1.0부터 ​

내 컴퓨터의 폴더에서 가져오기로 고른 폴더는 복사하지 않고 그 자리를 그대로 봐요. 그래서 초대 탭에서 내 컴퓨터에서 고른 펫 묶음에 폴더 이름과 함께 보여요.

폴더를 옮기면 친구가 기다려요

친구는 펫 폴더의 경로로 펫을 알아봐요. 고른 폴더를 옮기거나 지우면(또는 그 폴더가 있는 드라이브를 빼면) 다음에 앱을 열 때 그 펫의 친구가 놀이터에 나오지 못해요. 지워지는 건 아니에요. 친밀도를 그대로 지닌 채 기다리고, 몇 명이 기다리는지 알림이 떠요. 폴더를 같은 자리로 되돌리면 다시 나와요.

어디에 저장되나요 0.1.0부터 ​

주소로 가져온 펫은 데이터 폴더의 pets/에 폴더 하나로 저장돼요. 초대 탭의 주소로 가져온 펫 묶음에 폴더 열기 버튼이 있어서 그 폴더를 바로 열 수 있어요. PlayPets 기본 펫과 Codex 펫 폴더 묶음에도 같은 버튼이 있어요. 내 컴퓨터에서 고른 펫 묶음에는 버튼 대신 카드마다 폴더 이름이 적혀 있어요.

가져온 펫의 pet.json에는 출처가 함께 적혀요. 초대 탭의 카드에 "Petdex · 제작자 · CC BY-NC 4.0"처럼 사이트, 제작자, 라이선스가 한 줄로 보여요. 커뮤니티 펫은 각 제작자의 저작물이니 라이선스를 확인하고 써 주세요.

더 쓰지 않는 펫은 pets/ 안의 폴더를 지우면 돼요. 그 펫으로 만든 친구는 위와 같이 다음 시작부터 놀이터 밖에서 기다려요. 친구도 함께 없애려면 먼저 내보내 주세요.

직접 만들기 ​

펫 하나는 pet.json과 스프라이트 시트(PNG 또는 WebP) 한 장이 든 폴더예요. 형식은 Codex 펫과 같아서, Codex용으로 만든 펫이면 그대로 쓸 수 있어요.

json
{
  "id": "white",
  "displayName": "White",
  "kind": "animal",
  "description": "A puppy.",
  "spriteVersionNumber": 2,
  "spritesheetPath": "spritesheet.webp"
}
  • 시트는 너비 1536px이고, 한 칸이 192×208px, 한 행이 8칸이에요. v1은 9행(1872px), v2는 11행(2288px)이에요.
  • v1의 9행은 차례로 쉬기, 오른쪽으로 걷기, 왼쪽으로 걷기, 손 흔들기, 점프, 오류, 기다리기, 일하기, 완료예요. v2는 16방향 시선 두 행이 더 있어서 바탕화면에서 마우스를 따라 봐요.
  • description은 새 친구의 처음 성격이 돼요.

행별 애니메이션과 검사 규칙은 개발자 문서 펫 파일 형식에 있어요. 만든 폴더는 내 컴퓨터의 폴더에서 가져오기로 바로 초대할 수 있어요.

MIT 라이선스로 공개된 오픈소스예요. OpenAI와 관계가 없고, Codex는 OpenAI의 상표예요.