Skip to content

游戏数据文件编写指南

Jump to bottom
滑稽HuaJi2333 edited this page Feb 13, 2024 · 13 revisions

一般的游戏数据文件收录流程如下图所示。根据贡献者所想添加游戏的资质等级和掌握游戏资料的丰富程度，我们划分出多个阶段来规划、编写游戏数据文件而后收录到 FGI 中。你可以根据掌握资料的情况前进到适合的阶段。

若在参照个别游戏数据文件时发现与本指南不符，请以本指南为准。

flowchart LR
  A(开始) --> threshold

  subgraph threshold [评判游戏资质]
  B(("是否符合准入标准？"))
  end

  B --- 是 --> meta
  B -- 否 --> Z

  subgraph meta [编写游戏元数据文件]
    确定游戏标识符 --> 创建数据文件 --> 填写名称属性 --> 选填被取代属性 --> 填写描述属性 --> 填写作者属性 --> 填写标签属性 --> 填写链接属性 --> 填写媒体属性
  end

  meta --> local

  subgraph local [本地化游戏数据文件]
    本地化游戏名称 --- 本地化游戏描述 --- 本地化链接名称
  end

  local --> cooperate

  subgraph cooperate [多人协作]
    创建拉取请求 --> X
    直接发送数据文件 --> X
    X((审查与补正))
  end

  X -- 通过 --> Y[收录] --> Z(结束)
  X -- 不通过 --> Z

目录

评判游戏资质

若你申请收入 FGI 的游戏（以下简称“该游戏”）不符合以下准入标准，我们将关闭拉取请求。

针对拉取请求的游戏准入标准

  1. 该游戏为电子游戏——即以电子设备为游戏媒介，同时玩家是推动游戏进程的根本动力源，视觉小说除外。
  2. 该游戏具有相当的原创性——即非未经作者明确授权的同人作品，作者事先允许二次创作的除外。
  3. 该游戏以兽人为重要题材——即在游戏的主要情节中，兽人是推动游戏进程发展的重要力量；或者在游戏的主要情景中，兽人是构成游戏画面的重要部分。FGI 所指的“兽人”是具有非人动物身体特征的生物或机械，且形态的兽化程度高于兽耳娘类形态。
  4. 该游戏可供大众游玩——即已正式发布或有公开的测试版。

编写游戏元数据文件

使用Python库预生成数据文件

我们可以使用GameYamlSpiderAndGenerator来帮助生成一份基本的YAML数据文件。 它可以帮助编者提高编写数据文件的效率，减少耗在机械性行为的时间。

安装

使用

python3.10 -m gameyamlspiderandgenerator https://store.steampowered.com/app/290340/Armello/

若遇到网络不通，可尝试自己编写一套配置文件来指定代理。

更多信息：Wiki

了解 FGI 游戏数据库

生成游戏页面的材料

FGI 抽取游戏的“元文件”及其“本地化文件”来生成其网站页面。​前者存放于本项目 games 仓库的 games 子目录（games/games），后者存放在 games/games/l10n 下各个语言的子文件夹。若欲修改现有的游戏页面，只需要编辑对应的数据文件；若欲创建新的游戏页面，则需要新建对应的数据文件。

除有特别说明外，下文各个属性都必须写在元文件中。

例如，Adastra 对应的元文件为 games/games 下的“Adastra.yaml”，简体中文的本地化文件为 games/games/l10n/zh-cn 下的“Adastra.yaml”。

元文件里的各个属性（如名称、描述、链接）的内容均默认以英文填写，即使你申请收入的游戏未有英语翻译，也需要首先在 games/games 下创建元文件，而后才在其他语言的目录（games/games/l10n）下创建本地化文件。但这不代表数据文件中的各信息都必须翻译为英文，若缺少合适的翻译，元文件中可以写入原语言文本。

例如，虽然《煦风新笺》的原始语言为中文，但也必须先创建元文件填写英文内容，之后再创建针对中文的本地化文件。

不得提供纯机器翻译的本地化文件。针对中文，若你只提供了简体中文或者繁体中文的本地化文件，FGI 将自动提供（由 OpenCC 转换）另一种文字的本地化文件。

引用媒体资源的方式

FGI 对图片及视频资源的引用有两种方式：

  • 通过文件名内部引用。
  • 通过 URI 外部引用。

游戏缩略图与作者头像始终存放于 FGI 项目仓库，通过文件名内部引用。其他资源如游戏演示截图、视频始终通过 URI 外部引用。

URI 链接中不得含有查询字符串，且必须包含可识别的媒体格式后辍。

例如，example.com/image.cgi?filename=picture.png 和 example.com/image.psd 对 FGI 就是无效的 URI 链接。

数据文件的编写要求

FGI 的游戏数据文件均为 YAML 格式文件，其内容格式（例如缩进用空格的个数和位置）必须符合 YAML 语法，否则 FGI 将无法正常处理此文件。虽然填写和修改数据文件需要了解的 YAML 语法很少，但如果你还不熟悉 YAML，我们建议你参考或套用现有的数据文件。

FGI 项目仓库已使用 .gitattributes 要求 git 使用 LF 换行符，数据文件内必须使用 LF 换行符。

另外，为增强数据文件的易读性，每个一级属性后应当插入一个空行。

游戏标识符

游戏标识符（ID）是用于引用游戏的字符串，游戏数据文件和对应的资源文件夹都以此命名。

每个游戏的标识符唯一且不可重复，并且只能包含 ASCII 字符集中的英文（大小写均可）、数字和下横线 _（U+005F），不得以单独一个下横线开头。

游戏标识符优先取用该游戏的官方正式英语名称（保留原始大小写）。​

例如，《水银疗养院》的游戏标识符是“Mercury_Abbey”，其元文件和本地化文件都是“Mercury_Abbey.yaml”。

若该游戏的官方英语名称有地区差异，按以下顺序优先取用：

  1. 最多数主创人员最长期居住地（以英语为官方语言的地区）的英语形式。
  2. 最多数主创人员出生地（以英语为官方语言的地区）的英语形式。
  3. 开发商所在地的英语形式。

若该游戏无英语名称：

  • 原名称为日语的，取其罗马音表示，每个词组的罗马字首字母大写。

例如，『オスケモアイランドの秘密』的游戏标识符为“Osukemoairando_No_Himitsu”。

  • 原名称为汉语的，取其拼音表示，每个字的拼音首字母大写。

例如，《〈苦〉〈黏〉〈寒〉〈毒〉四部曲》的游戏标识符为“Ku_Nian_Han_Du”。

若该游戏的名称包含空格或特殊符号，则应当以下横线代替，多个下横线应当合并成一个下横线。

例如，Them's Fightin' Herds 的游戏标识符为“Thems_Fightin_Herds”。

若该游戏与 FGI 已收入的游戏重名或容易混淆，则应当在原游戏游戏标识符后添加两个下横线，再添加开发者（组、商）名称后缀。开发者（组、商）名称的标识符化参照以上游戏名称标识符化规则。

例如，由 Might and Delight 制作的 Shelter 2 不是由 rausmutt 制作的 Shelter 的续作，因此前者的游戏标识符为“Shelter_2__Might_and_Delight”。

名称属性（name）

name: 游戏名称

此属性为必填属性。

游戏名称应当优先取用该游戏的官方英语正式名称（保留原始大小写），其次取用该游戏最广泛传播的英文译名。若该游戏没有英语名称，则取用原语言名称。不得使用任何来源的别称。

例如，《矛之酒馆》名称属性的值应当填写 Tavern of Spear。

若该游戏的英文名称存在地区差异，则应当遵照游戏标识符中的相关规则取用。

若该游戏名称带有西文冒号 :（U+003A）或西文撇号 '（U+0027），则应当使用西文引号 "（U+0022）将游戏名称括起来。

例如，《罗曼圣诞探案集》（Roman's Christmas）名称属性的值应当填写 "Roman's Christmas"。

为方便非日语用户检索日文名称游戏，你可以参照游戏标识符和本地化游戏数据文件中关于游戏名称的相关规则，为该游戏名称附上罗马字。

例如，『バカ部』名称属性的值可以填写 Bakabu / バカ部。

被取代属性（replaced-by）

replaced-by: 游戏标识符

此属性为选填属性。

若该游戏已中止开发且 FGI 已收入其重制版，则应当在该旧版游戏元文件中添加此属性，并填入新版游戏的游戏标识符。

添加此属性将使得该游戏从 FGI 游戏列表中移除，但会保留在站内搜索结果和通用搜索引擎结果中。FGI 将于游戏页面顶端提示该游戏已被取代，并附上新游戏的链接。

例如，冒险小说类的《履云录》中止开发后，重制为了策略战棋类游戏。因此我们为老版本添加了被取代属性。

描述属性（brief-description | description | description-format）

简要描述属性

brief-description: 游戏的简要描述

此属性为选填属性。

简要描述属性承载游戏简要的文字描述，用于 FGI 游戏列表的标准视图和游戏页面 HTML 的 description 元数据。若未添加此属性，FGI 将自动从完整描述属性的值提取前480个单字节字符（240个汉字）当作简要描述。

西文字母、数字、空格或其他西文符号通常为单字节字符，中日韩文字及其标点符号通常为双字节字符。

简要描述应当短于完整描述，若完整描述字数少于480个单字节字符，可以不添加简要描述属性。​简要描述的字数推荐多于200个单字节字符，少于400个单字节字符，不得超过480个单字节字符。

完整描述属性

description: |
  游戏的完整描述第一段
  游戏的完整描述第二段
  以此类推……

此属性为必填属性。

完整描述属性承载游戏完整的文字描述。描述的内容应在 description: | 后换行写入，并且每段描述前必须空两格。

在内容上，简要描述与完整描述属性都应：

  • 优先取用官方原文。
  • 不涉及关键情节或选择分支后剧情的剧透。
  • 不包含敏感信息或违反目标语言当地法律法律的字词、文段。

描述格式属性

description-format: plain | markdown

此属性为选填属性。

完整描述属性的内容格式支持 Markdown，在完整描述属性之后添加描述格式属性并填入值 markdown 即可启用该功能。我们不建议在描述属性中插入媒体资源，若确有必要，则应当遵照了解 FGI 游戏数据库中引用媒体资源的相关规则。

作者属性（authors）

authors:
  - name: 作者一名称
    role: [ 分工角色 ]
  - name: 作者二名称
    role: [ 分工角色一, 分工角色二 ]
  以此类推……

此属性为必填属性。

作者属性以 authors: 开头，而后依次按重要程度和知名程度添加作者条目。若该游戏的作者成一个或多个团队，则应当以各自的团队条目代替所有对应的非核心作者条目，且团队条目按重要程度和知名程度置顶。

若欲添加的作者已收录至 FGI 作者数据库，name 分属性的值必须取用对应作者数据文件中名称属性的值。其他情况则应当直接填写作者知名度最广的官方名称。

每位作者必须至少指定一个分工角色，单个作者的多个分工角色间以一个西文逗号加一个空格 , （U+002C、U+0020）间隔。

分工角色 含义
producer 总制作（一般适用于独立作者和制作团队，或分工不易细分的游戏的作者）
animator 动画制作
artist 绘图
character-designer 角色设计
musician 音乐创作；配乐指导
programmer 编程
publisher 发行
scenographer 场景设计
screenwriter 剧本编写
translator 翻译
voice-actor 配音
others 其他

若该作者非该游戏的核心作者，且未与 FGI 数据库中的其他游戏相关联，FGI 未有该作者的作者数据文件。则应当在该作者的条目中添加添加 standalone 属性，并填入 true 值启用该属性。

此属性为选填属性。

  - name: 作者名称
    standalone: true
    avatar: 头像引用路径
    link-uri: 作者社交平台链接
    role: [ 分工角色 ]

此时可以使用 avatar 分属性为该作者指定头像图片，此图片的命名、规格应当遵照作者数据文件编写指南中关于头像的相关规则，并存放于 games/assets 下由游戏标识符命名的文件夹中（若不存在则需要自行创建）。

还可以使用 link-uri 分属性为该作者链接一个社交平台页面，该游戏页面中该作者的名称将变为超链接。

以上属性为选填属性。

标签属性（tags）

tags:
  标签类别一:
    - 标签
    - 标签
    - 以此类推……
  标签类别二:
    - 标签
    - 以此类推……
  以此类推……

此属性为必填属性。

标签是对游戏信息的抽象概括，为游戏添加完善的标签有助于 FGI 更好地分类游戏，优化筛选和搜索功能。标签属性以 tags: 开头，而后依次添加标签类别，再在各类别下依次添加具体标签。

type

此标签类别为必填标签类别。

用于指明游戏的类型。其中，若添加了 yiff 与 gore 标签，该游戏页面将显示敏感内容警告。

点此查看 type 类别下的标签
标签 含义
action 动作游戏
adventure 冒险游戏
board 棋牌游戏
business-sim 模拟经营游戏
casual 休闲游戏
comedy 搞笑游戏
dating-sim 模拟约会游戏
fighting 格斗游戏
horror 恐怖游戏
music 音乐游戏
puzzle 解谜游戏
roguelike 类 Rogue 游戏
role-playing 角色扮演游戏
shooter 射击游戏
sports 体育游戏
strategy 策略游戏
tragedy 悲情游戏
visual-novel 视觉小说
non-indie 非独立游戏
bara 包含较多男同性恋向内容的游戏
yuri 包含较多女同性恋向内容的游戏
yiff 包含成人内容的游戏
gore 包含血腥内容的游戏

species

此标签类别为必填标签类别。

用于指明游戏中主要角色的物种类型。

点此查看 species 类别下的标签
猫类
标签 含义
cat 猫兽人
cheetah 猎豹兽人
leopard 豹兽人
lion 狮兽人
lynx 猞猁兽人
tiger 虎兽人
犬类
标签 含义
coyote 郊狼兽人
dog 犬兽人
fox 狐兽人
raccoon-dog 貉兽人
wolf 狼兽人
爬行类
标签 含义
crocodile 鳄鱼兽人
lizard 蜥蜴兽人
snake 蛇兽人
turtle 龟兽人
鼬类
标签 含义
badger 獾兽人
ferret 雪貂兽人
otter 水獭兽人
weasel 鼬兽人
水生及两栖类
标签 含义
dolphin 海豚兽人
frog 蛙兽人
orca 虎鲸兽人
shark 鲨鱼兽人
其他
标签 含义
humankind 智人
mixed 跨物种杂交兽人
non-anthro 纯动物
bat 蝙蝠兽人
bear 熊兽人
beaver 河狸兽人
bird 鸟兽人
eagle 鹰兽人
cattle 牛兽人
dragon 龙兽人（西方）
hedgehog 刺猬兽人
horse 马兽人
hyena 鬣狗兽人
kangaroo 袋鼠兽人
lung 龙兽人（东方）
mouse 鼠兽人
monkey 猴兽人
opossum 负鼠兽人
pig 猪兽人
rabbit 兔兽人
raccoon 浣熊兽人
red-panda 小熊猫兽人
rhino 犀牛兽人
panda 大熊貓兽人
sheep 绵羊兽人
goat 山羊兽人

fetish

此标签类别为选填标签类别。

用于指明游戏展示的主要角色外观、性行为、性偏好。

点此查看 fetish 类别下的标签
外观
标签 含义
futanari 包含扶她
males-only 只有雄性
females-only 只有雌性
shota 包含外观年幼的雄性
loli 包含外观年幼的雌性
muscle 肌肉丰满
性行为
标签 含义
anal 肛交
blowjob 口交
group 群交
fisting 拳交
face-fucking 面交
frottage 阴茎摩擦
cockslapping 阴茎击打
masturbation 自己手淫
handjob 为别人手淫
rimjob 舔舐肛门
footjob 足交
paizuri 乳交
brain-fuck 将性器通过眼、鼻、耳、口捅入头颅
slit-vore 通过生殖腔吞入角色
cock-vore 通过阴茎吞入角色
rape 强奸
性偏好
标签 要素
human-on-furry 人类与兽人之间发生性关系
animal-on-furry 纯动物与兽人之间发生性关系
transform 外观大幅度转换
transfur 兽化
bondage 绑缚
master-slave 主人与奴隶关系
dominance-submission 支配与臣服关系
public-use 肉便器
exhibitionism 公众场合裸露
netorare 伴侣与其第三人发生性关系
mind-break 洗脑
mind-control 催眠
corruption 腐化
parasite 寄生
drugs 嗑药
body-swap 身体交换
time-stop 时间停止
guro 肢解
tentacles 触手
body-modification 人工替换身体部位
conjoined 两个或两个以上的头共用一个身躯
muscle-growth 肌肉膨大
inflation 腹部呈球形向外鼓胀
absorption 吸收某人或某物
vore 通过嘴吞入角色
petrification 石化
stomach-deformation 腹部因异物外捅突起

misc

此标签类别为选填标签类别。

用于指明游戏工程或状态的相关信息。

点此查看 misc 类别下的标签
视听体验
标签 游戏特性
freeware 主要内容免费（不含试玩版）
3d 主要以三维画面形式呈现
pixel-art 主要以像素风格画面形式呈现
grayscale 主要以黑白画面形式呈现
uncensored 成人内容未经审查删减与修改，或可开启、还原被审查的内容
full-audio 提供配音等完整的音频体验
游玩模式
标签 游戏特性
multiplayer 支持多人游玩
co-op 支持合作模式（依赖 multiplayer 标签）
pvp 支持玩家间对战（依赖 multiplayer 标签）
online 提供互联网在线服务或联机功能
内容情节
标签 游戏特性
multiple-endings 有多种结局
multiple-series 系列作品、同一独创世界观作品
homophobia 包含反同性恋内容或情节
outside-furry-fandom 创作者不是或不一定是兽迷
not-only-furry-topic 兽人不是游戏的支配性题材
unofficial 同人作品
moddable 可添加自定义模组
制作技术
标签 游戏特性
engine-renpy 使用 RenPy 开发
engine-unity 使用 Unity 开发
engine-rpg-maker 使用 RPG Maker 开发
engine-godot 使用 GoDot 开发
engine-ue4 使用虚幻引擎4开发
engine-tyranobuilder 使用 TyranoBuilder 开发
adobe-flash 使用 Adobe Flash 开发
drm 使用数字版权管理
运营状态
标签 游戏特性
unpublished 未发布
work-in-process 处于开发（测试）阶段
suspended 开发已暂停
died 开发已中止或暂停超过 2 年没有更新预告
expired 官方获取（下载）方式已失效
geographical 分地区服务器
centralized 依赖游戏运营商服务器

lang

此标签类别为必填标签类别。

用于指明游戏官方或非官方支持的语言。

点此查看 lang 类别下的标签
标签 语言
ar 阿拉伯语
cs 捷克语
da 丹麦语
de 德语
en 英语
en-unofficial 英语（非官方）
es 西班牙语
fi 芬兰语
fr 法语
hu 匈牙利语
it 意大利语
ja 日语
ja-unofficial 日语（非官方）
ko 韩语
nl 荷兰语
no 挪威语
pl 波兰语
pt 葡萄牙语
ru 俄语
sv 瑞典语
tr 土耳其语
zh 汉语
zh-unofficial 汉语（非官方）

publish

此标签类别为必填标签类别。

用于指明游戏发行（上架）的平台。

点此查看 publish 类别下的标签
标签 平台
website 官方自建网站
steam Steam
itchio itch.io
google-play Google Play
apple-appstore App Store
patreon Patreon
afdian 爱发电
epic Epic Games Store
gog GOG.com
microsoft-store Microsoft Store
booth BOOTH
digiket DiGiket
e-shop Nintendo eShop

platform

此标签类别为必填标签类别。

用于指明游戏支持的操作系统或平台。

点此查看 platform 类别下的标签
标签 操作系统或平台
web 采用 Web 技术构建的平台（网页游戏）
shockwave-flash Shockwave Flash
windows Microsoft Windows
android Android
ios iOS
macos Mac OS X、OS X、macOS
linux GNU/Linux
xbox Microsoft Xbox
playstation Sony PlayStation
psp Sony PlayStation Portable
psv Sony PlayStation Vita
nintendo-switch Nintendo Switch
wii-u Nintendo Wii U
3ds Nintendo 3DS
2ds Nintendo 2DS
nds Nintendo DS

sys

此标签类别为选填标签类别。

用于表示该游戏在 FGI 的内部状态。

标签 含义
staging 该游戏处于预览阶段
tagme 该游戏标签不完善

链接属性（links）

links:
  - name: 链接一名称
    uri: 链接一网址
  - name: 链接二名称
    uri: 链接二网址
  以此类推……

此属性为必填属性。

链接属性中必须有该游戏资源的获取链接，最好有该游戏的官方社交平台账号链接，还可以有补丁、赞助、众筹、百科等游戏相关资源资讯的链接。

其中，社交平台不可指向非公开邀请的群组。优先取用官方专用的社交平台账号，若该游戏无此类账号，而该游戏作者的个人社交平台账号为该游戏的最主要宣传平台，则可以取用此作者的账号。

游戏资源的获取链接不可指向非官方站点，不可指向绕过付费渠道的官方站点，作者明确授权的除外。

我们为常见的链接名称创建了“预设名称”。在 name 分属性中写入预设名称，则可以在不同语言的 FGI 站点上自动显示该语言的链接名称，省去翻译的步骤。使用预设名称的链接也会自动配备对应站点的图标。

点此查看所有预设名称
预设名称 链接站点
.website 官方网站主页
.release-page 正式版获取（通用）
.demo-version 试玩版获取（通用）
.demo-version-steam 试玩版获取（Steam）
.demo-version-gog.com 试玩版获取（GOG.com）
.unofficial-archived-download 非官方存档资源获取
.steam Steam
.itch.io itch.io
.play-store Google Play
.apple-appstore App Store
.playstation-store PlayStation Store
.epic Epic Games Store
.gog.com GOG.com
.microsoft-store Microsoft Store
.booth BOOTH
.digiket DiGiket
.nintendo-e-shop Nintendo eShop
.patreon Patreon
.afdian 爱发电
.weibo 微博
.furaffinity Fur Affinity
.twitter Twitter
.facebook Facebook
.tumblr Tumblr
.pixiv Pixiv
.discord Discord
.youtube Youtube
.unofficial-patch-en 非官方英文补丁
.unofficial-version-en 非官方英文版本
.unofficial-patch-zh 非官方中文补丁
.unofficial-version-zh 非官方中文版本

我们还为常用的链接网址创建了“简写 URI”。在 uri 分属性中写入简写形式的网址，可以让数据文件更具可读性。

点此查看所有简写 URI
目标站点 简写 URI 特征字段来源
Steam steam:ID store.steampowered.com/app/ID
Google Play Store google-play-store:ID play.google.com/store/apps/details?id=ID
Twitter twitter:ID twitter.com/ID
Facebook facebook:ID facebook.com/ID
Discord discord:ID discord.gg/ID
Patreon patreon:ID patreon.com/ID
爱发电 afdian:ID afdian.net/a/ID
Youtube youtube:ID youtube.com/ID
Pixiv pixiv:ID pixiv.net/users/ID
Fur Affinity furaffinity:ID furaffinity.net/user/ID
Tumblr tumblr:ID ID.tumblr.com
DeviantArt deviantart:ID deviantart.com/ID
FGI misc page FGI-misc-page:ID （FGI 仓库）misc-pages/ID.md

若写入自定名称，可以选择为该链接指定一个图标以替换默认图标。即在 icon 分属性中填入 FGI 图标库中图标的文件名（不含格式后缀）。

此属性为选填属性。

  - name: 链接名称
    icon: 图标名称
    uri: 网址

媒体属性（thumbnail | screenshots）

缩略图属性

thumbnail: thumbnail.图片格式后缀

此属性为必填属性。

缩略图是辅佐文本描述展示游戏风貌的重要补充，制作合适的缩略图能方便大家挑选感兴趣的游戏。

在内容上，缩略图应当清晰、美观、展现游戏整体格调，优先取用游戏官方对外公布的图片，并满足以下要求：

  • 标题文字完整露出。
  • 背景不透明。
  • 不包含额外添加的外边框。
  • 不包含敏感信息。

在规格上，缩略图的标准（最大）尺寸为宽360px，高168px。

尽量制作标准尺寸规格的缩略图。若原始缩略图小于标准尺寸，则应当通过裁剪图片使图片宽高比例保持15:7，不得强制放大原图。若原始缩略图大于标准尺寸，则应当通过缩小、裁剪等方式使其符合标准尺寸。

缩略图文件名统一为 thumbnail，格式后缀按实际情况填写。缩略图文件应当存放于 games/assets 下由游戏标识符命名的文件夹中（若不存在则需要自行创建）。

缩略图文件体积不得超过100KiB，压缩超过此体积的图片时不得出现明显失真（振铃效应、方块效应、色调分离、噪点等）。

演示媒体属性

screenshots:
  - 图片一链接
  - 图片二链接
  - sensitive: true
    uri: 图片三链接
  以此类推……

此属性为必填属性。

演示媒体属性中既可以填入图片条目，又可以填入视频条目。

若欲插入图片，只需在横杠 - 后填入图片链接即可。若此图片包含敏感信息，则应当添加 sensitive 分属性并且赋值为 true，再在其后添加 uri 分属性填入图片链接。注意不要通过禁止上传敏感图片的图床托管包含敏感信息的图片，否则该图片容易被禁止访问或删除。

若欲嵌入 HTML 视频，需先插入 video 属性，并在 mime 分属性中填入视频的 MIME，而后在 uri 分属性中填入视频链接。一个视频条目可以包含多种格式的视频，只需在某一 video 属性中添加更多链接条目即可。

  - video:
    - mime: 视频 MIME（格式一）
      uri: 视频链接（格式一）
    - mime: 视频 MIME（格式二）
      uri: 视频链接（格式二）

若欲嵌入 Youtube 视频，则应插入 youtube 属性并填入该视频的标识符（ID）作值。

  - youtube: 视频标识符

本地化游戏数据文件

游戏名称

name: 目标语言的官方游戏名称 | 民间译名 / 原名称

此属性为选填属性。

若欲提供游戏名称的翻译，则应当在目标语言的本地化文件中添加名称属性，并且优先填入该游戏的目标语言官方游戏名称。

若无官方译名，可以仅取用翻译质量最高的民间译名，也可以写入多个知名的民间译名。但此时必须在民间译名后补充原名称，名称间以一个斜杠 /（U+002F）间隔，名称与斜杠间以一个空格 （U+0020）间隔。

例如，Echo 的民间简体中文译名是“回音”，则此游戏的简体中文本地化文件中的名称属性应填写 回音 / Echo。

游戏描述

brief-description: 目标语言的游戏简要描述
description: |
  目标语言的游戏完整描述

以上属性为选填属性。

若欲提供简要描述和完整描述的翻译，则应当在目标语言的本地化文件中添加简要描述或完整描述属性，再填入对应的翻译文本即可。

若该游戏的元文件的描述格式属性（description-format）启用了 Markdown 格式，则应当在本地化文件也添加描述格式属性，并启用 Markdown 格式。

链接名称（links-tr）

links-tr:
  "原链接一名称": "翻译后的链接一名称"
  "原链接二名称": "翻译后的链接二名称"
  以此类推……

此属性为选填属性。

若欲提供链接属性中链接名称的翻译，则应当在目标语言的本地化文件中添加链接名称翻译（links-tr）属性，再填入对应链接名称的翻译条目。链接名称应当用西文引号 "（U+0022）括起来。

附录

注释

# 注释

若在编写数据文件时有特殊或例外情况，应当在数据文件中通过注释的形式写明。

旧标识符属性（old-ids）

old-ids:
  - 旧标识符1
  - 旧标识符2
  以此类推……

此属性为选填属性。

若欲修改游戏标识符，则应当在元文件中使用此属性，列举此前曾使用过的标识符。修改游戏标识符需要除弃权外半数 FGI 成员（偶数）或超过半数 FGI 成员（奇数）投票同意。

软删除属性（expunge）

expunge: false | true

此属性为选填属性。

启用此属性将使得该游戏从 FGI 游戏列表、站内搜索结果和通用搜索引擎结果中移除。但该游戏的页面仍然实际存在，FGI 将于页面顶端提示该游戏已被软删除。该游戏仍会显示在其作者的页面与其作者的“更多游戏”小部件中。

若该游戏未正式发布或未有公开的测试版，则应当在元文件中添加此属性并启用，否则不得添加此属性。

例如，《寂静冒险》既没有正式发布，也没有公开的测试版，因此需要为其元文件添加软删除属性并启用。

💬🌏

关于 FGI

贡献指南

Clone this wiki locally