펫 제출 방법

시작하기 전에

모든 과정은 PicoPixel 앱 안에서 진행됩니다. 제출 화면으로 가려면:

1. app.picopixel.io에서 앱을 엽니다.
2. 아직 로그인하지 않았다면 로그인합니다. Google 또는 GitHub 계정으로 로그인할 수 있습니다. 로그인하지 않으면 제출 전에 안내가 표시됩니다.
3. 왼쪽 사이드바 아래쪽의 계정을 클릭합니다.
4. "Your account"를 선택합니다.
5. "Submit Sprite"를 엽니다.

Submit Sprite 화면에는 아래의 두 가지 방법이 제공됩니다.

Petdex로 제출하기

권장되는 가장 빠른 방법입니다. Petdex는 petdex.crafter.run에 있는 외부 펫 디렉터리로, 펫을 둘러보고 만들고 호스팅할 수 있습니다. 모든 펫에는 https://petdex.crafter.run/pets/<pet-id> 형태의 공유 URL이 있습니다.

제출 방법:

1. Petdex에서 펫을 찾거나 만들고 URL을 복사합니다.
2. Submit Sprite 화면에서 "Submit via Petdex"를 선택합니다.
3. "Petdex URL" 필드에 펫 URL을 붙여 넣습니다.
4. 선택 사항인 "Notes" 필드에 도움이 되는 내용을 추가합니다.
5. 보냅니다.

GitHub로 제출하기

스프라이트를 직접 호스팅할 때 사용하는 방법입니다. Petdex 링크 대신 원본 파일을 제공합니다.

1. 스프라이트 시트 이미지와 그에 맞는 sprite.json을 공개 GitHub 저장소에 넣습니다.
2. Submit Sprite 화면에서 "Submit via GitHub"를 선택합니다.
3. 저장소 URL(https://github.com/...)을 붙여 넣습니다.
4. "Credits / Author"에 제작자 정보를 입력합니다.
5. 선택 사항인 "Notes" 필드에 유용한 내용을 추가한 뒤 보냅니다.

스프라이트 시트와 sprite.json은 특정 형식을 따라야 합니다. 다음 섹션에서 설명합니다.

나만의 나만의 펫 만들기

기존 Petdex 펫을 사용하는 대신 직접 펫을 만들어도 됩니다. OpenAI Codex나 AI 이미지 생성기를 활용하면 나만의 캐릭터 스프라이트 시트를 만들 수 있습니다.

스프라이트 시트는 균일한 그리드로 배치된 하나의 이미지(PNG 또는 WebP)이며 "atlas"라고도 합니다. 한 행에 하나의 애니메이션을 배치하고, 모든 프레임 크기를 동일하게 유지하세요.

sprite.json은 스프라이트 시트의 구성을 설명합니다. 크게 두 부분이 있습니다.

• atlas, 그리드 레이아웃: columns, rows, frameWidth, frameHeight.
• states, 애니메이션 목록입니다. 각 상태에는 id, label, 위치한 row, frames 수, 선택 사항인 durationMs, group, caption이 있습니다.

일반적인 상태에는 idle, wave, jump, run-right, run-left, running, waiting, failed, review가 있습니다. 스프라이트에는 최소 두 개의 상태가 필요하므로 최소한 idle과 하나의 동작을 생성하세요.

먼저 모든 프레임을 같은 크기로 만들고, 각 애니메이션을 한 행씩 규칙적인 그리드에 배치하세요. 그런 다음 sprite.json에 그리드와 상태 정보를 적고 Petdex나 GitHub로 제출하면 됩니다.

제출 후 처리 과정

제출하면 PicoPixel 팀이 펫을 검토하고, 필요한 경우 추가 확인을 요청할 수 있습니다. 승인된 펫은 펫 갤러리에 표시되며 제작자 정보가 함께 표시됩니다. 이후 커뮤니티 누구나 제출한 펫을 찾아 사용할 수 있습니다.

다음 단계

• LVGL 스프라이트, 스프라이트 상태와 프레임이 작동하는 방식.
• 이벤트 에디터, 디자인에 인터랙션 추가하기.
• 템플릿 제출 방법, 다른 사람이 시작점으로 사용할 PicoPixel 디자인 공유하기.
• 콘텐츠 신고 방법, 규칙을 어기는 펫 또는 템플릿 신고하기.
• 펫 갤러리, 커뮤니티 펫 둘러보기.