리버티게임:게임 메타데이터/스키마.json 문서 원본 보기

{
	"$schema": "http://json-schema.org/draft-07/schema#",
	"$id": "http://libertyga.me/wiki/Special:UrlRedirector/H#",
	"title": "리버티게임 게임 메타데이터",
	"description": "게임 메타데이터는 게임에 대한 정보를 리버티게임의 다양한 시스템이 읽을 수 있도록 모아놓은 JSON 문서입니다.\n게임 메타데이터는 기본적으로 최상위 게임 문서의 하위 문서인 `/game.json`에 작성됩니다.\n게임 메타데이터 규격은 아직 확정되지 않았습니다. 계속 논의 중이며, 언제든지 변경될 수 있습니다.",
	"$defs": {
		"genre": {
			"title": "장르",
			"type": "string",
			"description": "게임의 장르입니다.",
			"oneOf": [
				{
					"const": "어드벤처",
					"title": "어드벤처 게임",
					"default": "어드벤처"
				},
				{
					"const": "오픈 월드",
					"title": "오픈 월드 게임",
					"default": "오픈 월드"
				},
				{
					"const": "철도 교통",
					"title": "철도 교통 게임",
					"default": "철도 교통"
				},
				{
					"const": "도로 기행",
					"title": "도로 기행 게임",
					"default": "도로 기행"
				},
				{
					"const": "탈출",
					"title": "탈출 게임",
					"default": "탈출"
				},
				{
					"const": "함정 피하기",
					"title": "함정 피하기 게임",
					"default": "함정 피하기"
				},
				{
					"const": "액션",
					"title": "액션 게임",
					"default": "액션"
				},
				{
					"const": "퍼즐",
					"title": "퍼즐 게임",
					"default": "퍼즐"
				},
				{
					"const": "퀴즈",
					"title": "퀴즈 게임",
					"default": "퀴즈"
				},
				{
					"const": "보드",
					"title": "보드 게임",
					"default": "보드"
				},
				{
					"const": "음악",
					"title": "음악 게임",
					"default": "음악"
				},
				{
					"const": "롤플레잉",
					"title": "롤플레잉 게임",
					"default": "롤플레잉"
				},
				{
					"const": "시뮬레이션",
					"title": "시뮬레이션 게임",
					"default": "시뮬레이션"
				},
				{
					"const": "전략",
					"title": "전략 게임",
					"default": "전략"
				},
				{
					"const": "캐주얼",
					"title": "캐주얼 게임",
					"default": "캐주얼"
				},
				{
					"const": "예언",
					"title": "예언 게임",
					"default": "예언"
				},
				{
					"const": "스포츠",
					"title": "스포츠 게임",
					"default": "스포츠"
				},
				{
					"const": "시간 낭비하기",
					"title": "시간 낭비하기 게임",
					"default": "시간 낭비하기"
				},
				{
					"const": "멀티플레이",
					"title": "멀티플레이 게임",
					"default": "멀티플레이"
				}
			]
		},
		"platform": {
			"title": "플랫폼",
			"type": "string",
			"description": "게임이 지원하는 플랫폼입니다.",
			"oneOf": [
				{
					"const": "web",
					"title": "웹",
					"description": "웹 (무설치)",
					"icon": "language",
					"default": "web"
				},
				{
					"const": "windows",
					"title": "윈도우",
					"description": "윈도우 (설치)",
					"icon": "desktop_windows",
					"default": "windows"
				},
				{
					"const": "linux",
					"title": "리눅스",
					"description": "리눅스 (설치)",
					"icon": "terminal",
					"default": "linux"
				},
				{
					"const": "macos",
					"title": "맥 OS",
					"description": "맥 OS (설치)",
					"icon": "laptop_mac",
					"default": "macos"
				},
				{
					"const": "android",
					"title": "안드로이드",
					"description": "안드로이드 (설치)",
					"icon": "android",
					"default": "android"
				},
				{
					"const": "other",
					"title": "기타",
					"description": "기타",
					"icon": "dynamic_feed",
					"default": "other"
				}
			],
			"pattern": "[a-z]"
		},
		"DB2KeyInfo": {
			"title": "DB2 키 정보 객체",
			"type": "object",
			"properties": {
				"description": {
					"title": "키 설명",
					"type": "string",
					"description": "키에 대한 설명을 입력합니다."
				}
			},
			"required": [
				"description"
			],
			"additionalProperties": false
		}
	},
	"type": "object",
	"properties": {
		"genre": {
			"title": "장르",
			"description": "게임의 장르입니다. 배열을 사용해 여러 장르를 지정할 수 있습니다. [[분류:리버티게임 장르별 분류]]의 하위 분류에서 '게임'만 뗀 값입니다.",
			"anyOf": [
				{
					"$ref": "#/$defs/genre"
				},
				{
					"type": "array",
					"items": {
						"$ref": "#/$defs/genre"
					}
				}
			]
		},
		"author": {
			"title": "저자 이름",
			"description": "게임의 소유자, 또는 주 기여자의 사용자 이름을 입력합니다. 다시 말해, 여러분의 사용자 이름을 입력하면 되겠습니다. 여러명이 제작한 합작 게임의 경우 배열을 사용할 수 있습니다. 유효한 사용자 문서 이름이어야 하고, 사용자: 이름공간은 생략합니다. 만약 사용자 문서가 아닌 다른 문서를 가리키는 제작 팀의 경우 이름공간까지 포함해서 해당 문서 제목을 입력해 주세요. 기본 이름공간의 경우 그냥 :(콜론)으로 시작하면 됩니다. 틀 이름공간이 아닌 문서를 틀처럼 끼워넣을 때와 비슷합니다.",
			"anyOf": [
				{
					"type": "string",
					"format": "uri-reference"
				},
				{
					"type": "array",
					"items": {
						"type": "string",
						"format": "uri-reference"
					}
				}
			]
		},
		"name": {
			"title": "게임 이름",
			"type": "string",
			"description": "게임의 이름입니다. 상위 문서명과 다르게 입력할 수 있으며, 여기에 입력한 대로 게임아이콘에 보여집니다.",
			"maxLength": 50
		},
		"vairant": {
			"title": "대체 제목",
			"type": "string",
			"description": "이 필드는 게임의 대체 제목 또는 별칭을 나타냅니다. 'name' 필드만으로 게임의 설계대로 구현할 수 없을때 사용하는 필드입니다.",
			"maxLength": 50,
			"default": null
		},
		"issuetracker": {
			"title": "이슈 트래커",
			"type": "string",
			"format": "iri",
			"description": "게임의 이슈를 보고할 수 있는 트래커에 대한 링크입니다. 리버티게임 내부 게임은 해당게임 토론 이름공간으로 통일되기에 기입할 필요가 없습니다. 소스코드가 외부 저장소에 위치한 경우 해당 사이트의 이슈 게시란으로 명시하기 위한 필드입니다."
		},
		"changelog": {
			"title": "변경이력",
			"type": "string",
			"description": "게임의 변경이력에 대한 링크입니다."
		},
		"summary": {
			"title": "짧은 설명",
			"type": "string",
			"description": "게임에 대한 한 줄짜리 짧은 설명입니다. 80자 이내로 작성해 주세요.",
			"maxLength": 80
		},
		"description": {
			"title": "설명",
			"type": "string",
			"description": "게임에 대한 간단한 설명입니다. 한 문단 정도의 분량으로 최대한 간단히 작성해 주세요.",
			"maxLength": 4000
		},
		"version": {
			"title": "현재 버전",
			"type": "string",
			"description": "현재 버전을 나타냅니다."
		},
		"contributor": {
			"title": "기여자",
			"description": "게임을 만드는데 크거나 작게 도움을 준 기여자(조력자)의 사용자 이름을 입력합니다. 주 기여자(author)는 입력하지 않습니다. 여러명을 입력하려는 경우 배열을 사용할 수 있습니다. 유효한 사용자 문서 이름이어야 하고, 사용자: 이름공간은 생략합니다. 만약 사용자 문서가 아닌 다른 문서를 가리키는 제작 팀의 경우 이름공간까지 포함해서 해당 문서 제목을 입력해 주세요. 기본 이름공간의 경우 그냥 :(콜론)으로 시작하면 됩니다. 틀 이름공간이 아닌 문서를 틀처럼 끼워넣을 때와 비슷합니다.",
			"anyOf": [
				{
					"type": "string"
				},
				{
					"type": "array",
					"items": {
						"type": "string"
					}
				}
			]
		},
		"progress": {
			"title": "완성도",
			"type": "integer",
			"description": "게임의 완성도를 입력합니다.",
			"oneOf": [
				{
					"const": 0,
					"title": "변경하지 말아야 하는 공사중인 게임",
					"description": "변경하지 말아야 하는 공사중인 게임입니다.",
					"icon": "signal_cellular_0_bar",
					"default": 0
				},
				{
					"const": 1,
					"title": "조금 완성된 게임",
					"description": "조금 완성된 게임입니다.",
					"icon": "signal_cellular_1_bar",
					"default": 0
				},
				{
					"const": 2,
					"title": "중간 정도 완성된 게임",
					"description": "중간 정도 완성된 게임입니다.",
					"icon": "signal_cellular_2_bar",
					"default": 2
				},
				{
					"const": 3,
					"title": "거의 완성된 게임",
					"description": "거의 완성된 게임입니다.",
					"icon": "signal_cellular_3_bar",
					"default": 3
				},
				{
					"const": 4,
					"title": "완성되었지만 추가할 수 있는 게임",
					"description": "완성되었지만 추가할 수 있는 게임입니다.",
					"icon": "signal_cellular_4_bar",
					"default": 4
				},
				{
					"const": 5,
					"title": "완성되어 변경하지 말아야 하는 게임",
					"description": "완성되어 변경하지 말아야 하는 게임입니다.",
					"icon": "signal_cellular_connected_no_internet_4_bar",
					"default": 5
				}
			],
			"minimum": 0,
			"maximum": 5
		},
		"editpolicy": {
			"title": "게임 편집 정책",
			"type": "string",
			"description": "게임 편집의 개방성을 결정하는 게임 편집 정책입니다.",
			"oneOf": [
				{
					"const": "open",
					"title": "편집 가능",
					"description": "모두에게 편집이 개방되었습니다.",
					"icon": "lock_open_right",
					"default": "open"
				},
				{
					"const": "limited",
					"title": "규칙에 따라 편집 가능",
					"description": "규칙에 따라 일부만 편집할 수 있습니다.",
					"icon": "lock_open",
					"default": "limited"
				},
				{
					"const": "closed",
					"title": "편집 금지",
					"description": "제작자 이외의 편집이 제한됩니다.",
					"icon": "lock",
					"default": "closed"
				}
			],
			"pattern": "[a-z]"
		},
		"editpolicypage": {
			"title": "게임 편집 지침 문서",
			"type": "string",
			"description": "게임 편집 지침이나 규칙을 안내하는 문서의 제목을 작성합니다. 게임 대문(game.json의 상위 문서)을 기준으로 한 상대 경로를 사용할 수 있습니다.",
			"format": "uri-reference"
		},
		"platform": {
			"title": "플랫폼",
			"description": "게임이 지원하는 플랫폼 목록입니다. 생략하면 web만 지원하는 것으로 간주됩니다.",
			"default": "web",
			"anyOf": [
				{
					"$ref": "#/$defs/platform"
				},
				{
					"type": "array",
					"items": {
						"$ref": "#/$defs/platform"
					}
				}
			]
		},
		"rating": {
			"title": "등급 분류",
			"description": "각 등급 분류 기관별 등급 분류 정보를 입력합니다.",
			"default": null,
			"oneOf": [
				{
					"const": "null",
					"type": "null",
					"title": "등급 판정 필요",
					"description": "등급 판정이 필요한 게임입니다.",
					"icon": "hourglass_empty"
				},
				{
					"type": "object",
					"properties": {
						"libertygame": {
							"type": "object",
							"title": "리버티게임 등급 분류 정보",
							"description": "리버티게임 자체 등급 심의의 등급 분류 정보입니다. 등급면제를 제외한 grac 등급 분류 정보가 있다면 생략해도 됩니다.",
							"properties": {
								"age": {
									"type": [
										"integer",
										"string"
									],
									"title": "이용 등급",
									"description": "게임 이용 등급 연령을 입력합니다.",
									"oneOf": [
										{
											"const": "test",
											"title": "평가용",
											"description": "등급 판정중인 게임입니다.",
											"icon": "hourglass_top",
											"default": "test"
										},
										{
											"const": "all",
											"title": "전체 이용가",
											"description": "모든 연령이 즐길 수 있습니다.",
											"icon": "cruelty_free",
											"default": "all"
										},
										{
											"const": 12,
											"title": "12세 이용가",
											"description": "12세 미만이 이용시 부모의 지도가 필요합니다.",
											"icon": "12mp",
											"default": 12
										},
										{
											"const": 15,
											"title": "15세 이용가",
											"description": "15세 미만이 이용시 부모의 지도가 필요합니다.",
											"icon": "15mp",
											"default": 15
										}
									]
								},
								"date": {
									"type": "string",
									"title": "등급 분류 일자",
									"description": "게임 이용 등급을 분류한 일자를 입력합니다.",
									"format": "date"
								}
							},
							"required": [
								"age",
								"date"
							]
						},
						"grac": {
							"type": "object",
							"title": "게임물관리위원회 등급 분류 정보",
							"description": "게임물관리위원회(게임콘텐츠등급분류위원회 포함)의 등급 분류 정보입니다. 정식으로 등급분류나 등급면제/시험용 게임 확인을 받은 경우에만 작성하세요.",
							"properties": {
								"age": {
									"type": "object",
									"title": "이용 등급",
									"description": "게임 이용 등급 연령을 입력합니다.",
									"oneOf": [
										{
											"const": "re",
											"title": "등급면제",
											"default": "re"
										},
										{
											"const": "test",
											"title": "평가용",
											"default": "test"
										},
										{
											"const": "all",
											"title": "전체이용가",
											"default": "all"
										},
										{
											"const": 12,
											"title": "12세이용가",
											"default": 12
										},
										{
											"const": 15,
											"title": "15세이용가",
											"default": 15
										},
										{
											"const": 18,
											"title": "18세 이용가",
											"default": 18
										}
									]
								},
								"contentdescriptor": {
									"type": "array",
									"title": "내용정보",
									"description": "게임 내용정보를 입력합니다.",
									"items": {
										"type": "string",
										"oneOf": [
											{
												"const": "sexuality",
												"title": "선정성",
												"default": "sexuality"
											},
											{
												"const": "violence",
												"title": "폭력성",
												"default": "violence"
											},
											{
												"const": "horror",
												"title": "공포",
												"default": "horror"
											},
											{
												"const": "language",
												"title": "언어의 부적절성",
												"default": "language"
											},
											{
												"const": "drug",
												"title": "약물",
												"default": "drug"
											},
											{
												"const": "crime",
												"title": "범죄",
												"default": "crime"
											},
											{
												"const": "gambling",
												"title": "사행성",
												"default": "gambling"
											}
										]
									}
								},
								"id": {
									"type": "string",
									"title": "등급분류번호/확인증번호",
									"description": "age가 \"test\"면 평가확인증번호를, \"re\"면 등급면제 확인증번호를, 그 외이면 등급분류번호를 입력합니다.",
									"oneOf": [
										{
											"title": "등급분류번호",
											"pattern": "^(GC-)?CC-([A-Z]{2})-\\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\\d|3[01])-\\d{3}$"
										},
										{
											"title": "평가확인증번호",
											"pattern": "^\\d{4}-\\d{4}$"
										},
										{
											"title": "등급면제 확인증번호",
											"pattern": "^\\d{4}-RE\\d{4}$"
										}
									]
								},
								"title": {
									"type": "string",
									"title": "제명",
									"description": "등급분류/시험용게임확인/등급면제확인 상 게임의 제명을 입력합니다. name과 같은 경우 입력하지 않으며, 다른 경우에만 입력합니다."
								},
								"author": {
									"type": "string",
									"title": "제작자/상호",
									"description": "등급분류/시험용게임확인/등급면제확인 상 신청자를 입력합니다."
								},
								"authorid": {
									"type": "string",
									"title": "게임물 제작업자 및 배급업자의 신고번호 및 등록번호",
									"description": "게임물 제작업자 및 배급업자의 신고번호 및 등록번호를 입력합니다. 개인이 비영리로 게임을 만드는 리버티게임의 특성 상 거의 사용되지 않습니다."
								},
								"date": {
									"type": "string",
									"title": "게임 제작 일자",
									"description": "등급분류/시험용게임확인/등급면제확인 상 게임의 제작일자를 입력합니다.",
									"format": "date"
								}
							},
							"required": [
								"age",
								"id",
								"author",
								"date"
							],
							"additionalProperties": false
						}
					},
					"minProperties": 1,
					"additionalProperties": false
				}
			]
		},
		"construction": {
			"title": "공사중",
			"oneOf": [
				{
					"type": "string",
					"format": "date",
					"description": "해당 날짜까지 공사중인 게임입니다."
				},
				{
					"type": "boolean",
					"oneOf": [
						{
							"const": true,
							"title": "공사중",
							"description": "공사중인 게임입니다. 공사 기간은 마지막 편집으로부터 15일 뒤까지입니다.",
							"default": true
						},
						{
							"const": false,
							"description": "공사중인 게임이 아닙니다.",
							"default": false
						}
					]
				}
			],
			"description": "게임 공사 여부 및 기간을 입력합니다. true를 입력하거나 공사를 마치는 날짜를 년-월-일로 입력해 주세요."
		},
		"repair": {
			"title": "수리중",
			"anyOf": [
				{
					"type": "string",
					"format": "date",
					"description": "해당 날짜까지 수리중인 게임입니다."
				},
				{
					"type": "boolean",
					"oneOf": [
						{
							"const": true,
							"title": "수리중",
							"description": "수리중인 게임입니다. 수리 기간은 마지막 편집으로부터 15일 뒤까지입니다."
						},
						{
							"const": false,
							"description": "수리중인 게임이 아닙니다."
						}
					]
				}
			],
			"default": false,
			"description": "게임 수리 여부 및 기간을 입력합니다. true를 입력하거나 수리를 마치는 날짜를 년-월-일로 입력해 주세요."
		},
		"abandon": {
			"title": "버려진 게임",
			"type": "boolean",
			"description": "버려진 게임 여부입니다. 버려진 게임이 아닐 경우 입력할 필요가 없습니다.",
			"default": false
		},
		"login": {
			"title": "로그인 필요 여부",
			"type": "string",
			"description": "로그인 필요 여부를 선택합니다.",
			"default": "unnecessary",
			"oneOf": [
				{
					"const": "required",
					"title": "로그인 필수",
					"description": "로그인한 사용자만 이용할 수 있는 게임입니다. 로그인하지 않으면 모든 기능이 사용 불가능할 때 선택하세요."
				},
				{
					"const": "recommended",
					"title": "로그인 권장",
					"description": "로그인하여 플레이할 것을 권장하는 게임입니다. 로그인하지 않으면 일부 기능이 제한될 때 선택하세요."
				},
				{
					"const": "unnecessary",
					"title": "로그인 불필요",
					"description": "IP 사용자도 이용할 수 있는 게임입니다. 로그인하지 않아도 모든 기능을 제한없이 사용할 수 있을 때 선택하세요."
				}
			],
			"pattern": "[a-z]"
		},
		"privacypolicy": {
			"title": "개인정보 취급 방침",
			"type": "string",
			"description": "개인 정보를 수집하는 게임의 개인 정보 취급 방침 문서를 지정합니다. 게임 대문(game.json의 상위 문서)을 기준으로 한 상대 경로를 사용할 수 있습니다.",
			"format": "uri-reference"
		},
		"gameDB": {
			"title": "DB2 키 정보",
			"type": "object",
			"properties": {
				"default": {
					"title": "기본키",
					"$ref": "#/$defs/DB2KeyInfo",
					"description": "기본키에 대한 정보를 입력합니다."
				},
				"keys": {
					"title": "사용자 지정 키",
					"type": "object",
					"description": "사용자 지정 키에 대한 정보를 입력합니다. 키에 키 이름을, 값에 키 정보 객체를 작성합니다.",
					"additionalProperties": {
						"$ref": "#/$defs/DB2KeyInfo"
					}
				}
			},
			"additionalProperties": false
		},
		"created": {
			"title": "작성일",
			"type": "string",
			"description": "게임이 생성된 일자를 기입합니다.",
			"format": "date"
		},
		"image": {
			"title": "대표 이미지",
			"type": "image",
			"description": "게임에서 사용되는 대표 이미지를 지정합니다. 리버티 게임 내부의 파일만 허용되며, 파일 네임스페이스는 제외하여 기재합니다."
		},
		"featured": {
			"title": "특집 게임 정보",
			"type": "object",
			"properties": {
				"date": {
					"title": "특집 게임 날짜",
					"type": "string",
					"description": "특집 게임이 선정된 날짜를 지정합니다.",
					"format": "date"
				},
				"description": {
					"title": "특집 게임 추천평",
					"type": "string",
					"description": "특집 게임의 추천평을 기입합니다."
				},
				"author": {
					"title": "추천평 작성자",
					"type": "string",
					"description": "추천평을 작성한 사용자명을 기입합니다."
				}
			},
			"required": [
				"date"
			],
			"description": "특집게임에 대한 추가 정보를 기입하는 섹션입니다."
		}
	},
	"required": [
		"genre",
		"author",
		"name",
		"summary",
		"progress",
		"editpolicy"
	],
	"additionalProperties": false
}