catalogue.json: PlayDrop 게임 메타데이터 및 현지화
PlayDrop Connector 형식의 게임 제목, 설명, 장르 태그, 등록 정보 이미지와 동영상, 번역 및 선택형 server 필드에 대한 레퍼런스입니다.
PlayDrop Connector는 작은 catalogue.json과 함께 게임을 게시합니다. 이 파일은 정확히 하나의 게임이 들어 있는 apps를 포함한 JSON 객체이며, 필수 항목은 name뿐입니다. 에이전트가 게임 파일과 함께 catalogue 인수로 전송하므로 명령줄 도구는 필요하지 않습니다. PlayDrop Cloud에서는 이 메타데이터를 대신 관리해 줍니다.
최소 게시 예시
{
"apps": [{
"name": "moon-jump",
"displayName": "Moon Jump",
"description": "Jump between lunar platforms and reach the finish.",
"controls": "Arrow keys to move. Space to jump.",
"sourceLocale": "en",
"tags": ["game-genre/platformer"]
}]
}업데이트할 때는 소문자 슬러그를 그대로 유지하세요. 필요에 따라 표시 제목, 정확한 설명, 조작법, 원본 언어 및 기존 태그를 추가하세요. 아래 예시는 기존 platformer 장르 태그를 사용합니다.
지원 필드 및 제한
name: 소문자, 숫자 또는 하이픈으로 이루어진 1–100자이며, 문자 또는 숫자로 시작해야 합니다. displayName: 비어 있지 않은 제목. subtitle: 최대 120자. description: H1 제목, 임베드 미디어, 표가 없는 최대 3,000자의 Markdown. inspirationPrompt: 최대 400자의 한 줄 일반 텍스트. 텍스트 제한은 JavaScript UTF-16 코드 단위를 기준으로 계산합니다.
선택 필드로는 controls, releaseNotes, makingOf, emoji, color, sourceRepository, license, tags, sourceLocale, listingLocalizations, listingMedia, server가 있습니다. 태그는 기존 group-slug/tag-slug 참조를 사용하며, 고유 태그는 최대 20개까지 지정할 수 있습니다. server에는 업로드한 server.js의 Colyseus 룸을 "server": { "rooms": ["game"] }처럼 나열합니다. 서버 SDK를 참고하세요. 게시하기 전에 현재 허용되는 라이선스 값과 전체 필드 규칙을 커넥터에 요청하세요.
등록 정보 이미지 및 동영상
등록 정보 미디어는 index.html 옆에 경로로 이름을 지정한 파일로 업로드하세요. 아트에 게임 제목을 넣은 listing/icon.png, listing/hero-landscape.png(16:9), listing/hero-portrait.png(9:16), 그리고 listing/screenshots/landscape/0.png 같은 스크린샷과 동영상 listing/videos/landscape/0.mp4(트레일러), listing/videos/portrait/0.mp4(모바일 티저)를 올릴 수 있습니다. 동영상은 게임 카드와 게임 페이지에서 소리 없이 재생되며, 트레일러는 컴퓨터와 TV에서, 티저는 휴대폰에서 재생됩니다. 게임플레이를 보여 주고 첫 플레이를 이끌어 내는 가장 빠른 방법입니다. 이미지는 PNG, 동영상은 MP4 형식입니다.
등록 정보를 정확하게 번역하기
영어는 항상 게시하고, 본인의 언어가 다르다면 그 언어도 함께 게시하세요. sourceLocale을 원본 언어로 설정하세요. listingLocalizations는 영어, 프랑스어, 독일어, 스페인어, 브라질 포르투갈어, 인도네시아어, 일본어, 한국어, 번체 중국어, 간체 중국어를 지원합니다. 각 번역에는 locale과 displayName이 필요하며, 원본과 함께 업로드하면 PlayDrop이 sourceHash를 채워 줍니다. 번역된 아트는 listing/locales/<locale>/ 아래에 업로드하세요. 예를 들어 프랑스어 제목이 들어간 listing/locales/fr/hero-landscape.png는 해당 번역과 자동으로 연결됩니다. 원본이 변경되면 번역을 갱신하세요. 등록 정보를 번역해도 게임 자체는 번역되지 않습니다.