리버티게임:게임 메타데이터: 두 판 사이의 차이

2023년 10월 14일 (토) 19:36 판

버전: 0.6 / 최근 수정: 2023년 9월 14일 (목) 18:52 (KST)

게임 메타데이터는 게임에 대한 정보를 리버티게임의 다양한 시스템이 읽을 수 있도록 모아놓은 JSON 문서입니다. 게임 메타데이터는 기본적으로 최상위 게임 문서의 하위 문서인 /game.json(게임이름)/game.json에 작성됩니다. 문서 작성 이후 특수:콘텐츠모델바꾸기에서 콘텐츠 모델을 꼭 'JSON'으로 변경해주세요.

게임 메타데이터 규격은 아직 확정되지 않았습니다. 계속 논의 중이며, 언제든지 변경될 수 있습니다.

JSON 문법

이 부분의 본문은 리버티게임:JSON입니다.

요소

기본 정보

genre: 게임의 장르입니다. 배열을 사용함으로 여러 장르를 지정할 수 있습니다. 분류:리버티게임 장르별 분류에서 '게임'만 뗀 값입니다.

name: 게임의 이름입니다. 상위 문서명과 다르게 입력할 수 있으며, 여기에 입력한 대로 게임아이콘에 보여집니다. (문자열*50, 필수)

author: 게임의 소유자, 또는 주 기여자의 사용자 이름을 입력합니다. 다시 말해, 여러분의 사용자 이름을 입력하면 되겠습니다. 여러명이 제작한 합작 게임의 경우 배열을 사용할 수 있습니다. 유효한 사용자 문서 이름이어야 하고, 사용자: 이름공간은 생략합니다. 만약 사용자 문서가 아닌 다른 문서를 가리키는 제작 팀의 경우 이름공간까지 포함해서 해당 문서 제목을 입력해 주세요. 기본 이름공간의 경우 그냥 :(콜론)으로 시작하면 됩니다. 틀 이름공간이 아닌 문서를 틀처럼 끼워넣을 때와 비슷합니다. (문자열:문서명|배열:문자열:문서명, 필수)

summary: 게임에 대한 한 줄짜리 짧은 설명입니다. 80자 이내로 작성해 주세요. (문자열*80, 필수)

progress: 게임의 완성도를 입력합니다. (숫자:정수:0~5, 필수)

0: 변경하지 말아야 하는 공사중인 게임입니다.
1: 조금 완성된 게임입니다.
2: 중간 정도 완성된 게임입니다.
3: 거의 완성된 게임입니다.
4: 완성되었지만 추가할 수 있는 게임입니다.
5: 완성되어 변경하지 말아야 하는 게임입니다.

editpolicy: 게임 편집의 개방성을 결정하는 게임 편집 정책입니다. 다음 중 하나를 선택할 수 있습니다. (문자열, 필수)

open: 모두에게 편집이 개방되었습니다.
limited: 규칙에 따라 일부만 편집할 수 있습니다.
closed: 제작자 이외의 편집이 제한됩니다.

variant: 대체 제목 또는 별칭을 나타냅니다. 'name' 필드만으로 게임의 설계대로 구현할 수 없을때 사용하는 필드입니다. 만약 이 필드가 비어있으면 기본적으로 'name' 필드의 링크를 사용합니다. (문자열, 선택)

issuetracker: 게임의 이슈를 보고할 수 있는 트래커에 대한 링크입니다. 기본값은 해당 문서의 토론란이며, 형식은 url 문자열입니다.; 일반적으로 리버티게임 내부 게임은 해당게임 토론 이름공간으로 통일되기에 기입할 필요가 없습니다. 소스코드가 외부 저장소에 위치한 경우 해당 사이트의 이슈 게시란으로 명시하기 위한 필드입니다.

changelog: 게임의 변경이력에 대한 링크입니다. (문자열, 선택)

description: 게임에 대한 간단한 설명입니다. 한 문단 정도의 분량으로 최대한 간단히 작성해 주세요. (문자열*4000, 선택)

version: 현재 버전을 나타냅니다. (문자열, 선택)

contributor: 게임을 만드는데 크거나 작게 도움을 준 기여자(조력자)의 사용자 이름을 입력합니다. 주 기여자(author)는 입력하지 않습니다. 여러명을 입력하려는 경우 배열을 사용할 수 있습니다. 유효한 사용자 문서 이름이어야 하고, 사용자: 이름공간은 생략합니다. 만약 사용자 문서가 아닌 다른 문서를 가리키는 제작 팀의 경우 이름공간까지 포함해서 해당 문서 제목을 입력해 주세요. 기본 이름공간의 경우 그냥 :(콜론)으로 시작하면 됩니다. 틀 이름공간이 아닌 문서를 틀처럼 끼워넣을 때와 비슷합니다. (문자열:문서명|배열:문자열:문서명, 선택)

editpolicypage: 게임 편집 지침이나 규칙을 안내하는 문서의 제목을 작성합니다. 게임 대문(game.json의 상위 문서)을 기준으로 한 상대 경로를 사용할 수 있습니다. (문자열:문서명, 선택)

platform: 게임이 지원하는 플랫폼 목록입니다. 생략하면 web만 지원하는 것으로 간주됩니다. (문자열:소문자|배열:문자열:소문자, 선택)

web: 웹 (무설치) (기본값)
windows: 윈도우 (설치)
linux: 리눅스 (설치)
macos: 맥 OS (설치)
android: 안드로이드 (설치)
other: 기타

rating: 각 등급 분류 기관별 등급 분류 정보를 입력합니다. (객체|null, 선택)

null: 미분류 (기본값)

libertygame

리버티게임 자체 등급 심의의 등급 분류 정보입니다. 등급면제를 제외한 grac 등급 분류 정보가 있다면 생략해도 됩니다. (객체, 선택)

age: 게임 이용 등급 연령을 입력합니다. (숫자:정수|문자열, 필수)

"test": 평가용
"all": 전체 이용가
12: 12세 이용가
15: 15세 이용가
~~18: 18세 이용가~~(리버티게임: 등급 심의에서 삭제되어 지정 금지됨)

summary: 게임 내용정보를 입력합니다. 일반적으로 아래의 게임물관리위원회에서 사용되는 게임 내용정보과 같은 형식을 취합니다. (배열:문자열, 선택); 버:등급 심의에 정의되지 않은 사항입니다. 개편전까지 비표준인 필드이며 실제 효력이 없습니다.
date: 게임 이용 등급을 분류한 일자를 입력합니다. (문자열:날짜, 필수)

grac

게임물관리위원회(게임콘텐츠등급분류위원회 포함)의 등급 분류 정보입니다. 정식으로 등급분류나 등급면제/시험용 게임 확인을 받은 경우에만 작성하세요. (객체, 선택)

age: 게임 이용 등급 연령을 입력합니다. (숫자:정수|문자열, 필수)

"re": 등급면제
"test": 평가용
"all": 전체이용가
12: 12세이용가
15: 15세이용가
18: 18세이용가

summary: 게임 내용정보를 입력합니다. (배열:문자열, 선택)

sexuality: 선정성
violence: 폭력성
horror: 공포
language: 언어의 부적절성
drug: 약물
crime: 범죄
gambling: 사행성

id: age가 "test"면 평가확인증번호를, "re"면 등급면제 확인증번호를, 그 외이면 등급분류번호를 입력합니다. (문자열, 필수)

(GC-)CC-xx-yymmdd-nnn: 등급분류번호
yyyy-nnnn: 평가확인증번호
yyyy-REnnnn: 등급면제 확인증번호

title: 등급분류/시험용게임확인/등급면제확인 상 게임의 제명을 입력합니다. name과 같은 경우 입력하지 않으며, 다른 경우에만 입력합니다. (문자열, 선택)
author: 등급분류/시험용게임확인/등급면제확인 상 신청자를 입력합니다. (문자열, 필수)
date: 등급분류/시험용게임확인/등급면제확인 상 게임의 제작일자를 입력합니다. (문자열:날짜, 필수)

construction: 게임 공사 여부 및 기간을 입력합니다. true를 입력하거나 공사를 마치는 날짜를 년-월-일로 입력해 주세요. . (문자열:날짜|부울, 선택)

"yyyy-mm-dd": 해당 날짜까지 공사중인 게임입니다.
true: 공사중인 게임입니다. 기한은 마지막 편집으로부터 15일 뒤까지입니다.
false: 공사중인 게임이 아닙니다. (기본값)

repair: 게임 수리 여부 및 기간을 입력합니다. true를 입력하거나 수리를 마치는 날짜를 년-월-일로 입력해 주세요. (문자열:날짜|부울, 선택)

"yyyy-mm-dd": 해당 날짜까지 수리중인 게임입니다.
true: 수리중인 게임입니다. 기한은 마지막 편집으로부터 15일 뒤까지입니다.
false: 수리중인 게임이 아닙니다. (기본값)

abandon: 버려진 게임을 나타냅니다. (부울, 선택)

true: 버려진 게임입니다.
false: 버려진 게임이 아닙니다. (기본값)

login: 로그인 필요 여부를 선택합니다. (문자열, 선택)

required: 로그인한 사용자만 이용할 수 있는 게임입니다. 로그인하지 않으면 모든 기능이 사용 불가능할 때 선택하세요.
recommended: 로그인하여 플레이할 것을 권장하는 게임입니다. 로그인하지 않으면 일부 기능이 제한될 때 선택하세요.
unnecessary: IP 사용자도 이용할 수 있는 게임입니다. 로그인하지 않아도 모든 기능을 제한없이 사용할 수 있을 때 선택하세요. (기본값)

saves: 세이브 저장형 게임의 경우 데이터가 저장되는 위치를 나타냅니다. 사용자는 $1에 표기됩니다. 문자열 혹은 문자열의 배열의 형식을 취합니다.
privacypolicy: 개인 정보를 수집하는 게임의 개인 정보 취급 방침 문서를 지정합니다. 게임 대문(game.json의 상위 문서)을 기준으로 한 상대 경로를 사용할 수 있습니다. (문자열:문서명, 선택)

created: 게임이 만들어진 날짜를 기입합니다. (문자열:날짜)
image: 게임을 대표하는 이미지를 지정합니다. 리버티게임 내부에 있는 파일만 지정 할 수 있으며, 네임스페이스는 제외하고 지정합니다. 예) 파일:fishing.PNG
tech: 사용한 기술 수준을 깅비합니다. 플랫폼 구분 없이 0~2까지 3단계로 지정합니다.; 일반적으로 링크만 있는 텍스트 게임의 경우 0, cgi나 url파라미터를 사용한 게임은 1, 해당 게임을 위한 자체 자바스크립트/모듈을 사용을 작성한 게임의 경우 2를 사용합니다.

featured

특집게임에 대한 추가 정보를 기입합니다. (객체|null, 선택)

date: 게임이 특집 게임으로 선정된 날짜를 나타냅니다. (문자열: 날짜, 필수)
description: 특집 게임의 추천평을 기입합니다. (문자열, 선택)
author: 추천평을 작성한 사용자명을 기입합니다. (문자열, 선택)

DB2 키 정보

DB2 키 정보는 gameDB키에 입력합니다.

기본적으로 아래와 같은 구조입니다.

{
    "gameDB": {
        "default": {
            "description": "(설명)"
        },
        "keys": {
            "(키)": {
                "description": "(설명)"
            }
        }
    }
}

gameDB

(객체, 선택)

default: 기본키에 대한 정보를 입력합니다. (객체:키 정보 객체, 선택)
keys: 사용자 지정 키에 대한 정보를 입력합니다. 키에 키 이름을, 값에 키 정보 객체를 작성합니다. (객체:{[문자열]:키 정보 객체}, 선택)

키 정보 객체

description: 키에 대한 설명을 입력합니다. (문자열, 필수)

스키마

JSON 스키마

@@ 70번째 줄: / 70번째 줄: @@
 ::* 15: [[파일:GRAC 15 Square.svg|16px|15세 이용가]] 15세 이용가
 ::* <s>18: [[파일:GRAC 18 Square.svg|16px|18세 이용가]] 18세 이용가</s>([[리버티게임: 등급 심의]]에서 삭제되어 지정 금지됨)
-::; summary: 게임 내용정보를 입력합니다. 아래의 게임물관리위원회에서 사용되는 게임 내용정보과 같은 형식을 취합니다. (배열:문자열, 선택)
+::; summary: 게임 내용정보를 입력합니다. 일반적으로 아래의 게임물관리위원회에서 사용되는 게임 내용정보과 같은 형식을 취합니다. (배열:문자열, 선택)
 ::: [[버:등급 심의]]에 정의되지 않은 사항입니다. 개편전까지 비표준인 필드이며 실제 효력이 없습니다.
 ::; date: 게임 이용 등급을 분류한 일자를 입력합니다. (문자열:날짜, '''필수''')