Skip to content

遊戲資料檔案編寫指南

Jump to bottom
开普以尔 edited this page Jan 4, 2025 · 12 revisions

本页面由“Open Chinese Convert 開放中文轉換”机器转译而成，欢迎精通繁体中文的台湾朋友帮助我们进行人工翻译。

一般的遊戲資料檔案收錄流程如下圖所示。根據貢獻者所想新增遊戲的資質等級和掌握遊戲資料的豐富程度，我們劃分出多個階段來規劃、編寫遊戲資料檔案而後收錄到 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
Loading

目錄

評判遊戲資質

若你申請收入 FGI 的遊戲（以下簡稱“該遊戲”）不符合以下准入標準，我們將關閉拉取請求。

針對拉取請求的遊戲准入標準

  1. 該遊戲為電子遊戲——即以電子裝置為遊戲媒介，同時玩家是推動遊戲程序的根本動力源，視覺小說除外。
  2. 該遊戲具有相當的原創性——即非未經作者明確授權的同人作品，作者事先允許二次創作的除外。
  3. 該遊戲以獸人為重要題材——即在遊戲的主要情節中，獸人是推動遊戲程序發展的重要力量；或者在遊戲的主要情景中，獸人是構成遊戲畫面的重要部分。FGI 所指的“獸人”是具有非人動物身體特徵的生物或機械，且形態的獸化程度高於獸耳娘類形態。
  4. 該遊戲可供大眾遊玩——即已正式釋出或有公開的測試版。

編寫遊戲元資料檔案

使用Python庫預生成資料檔案

我們可以使用GameYamlSpiderAndGenerator來幫助生成一份基本的YAML資料檔案。 它可以幫助編者提高編寫資料檔案的效率，減少耗在重複行為的時間。

安裝

使用

python -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-tw 下的“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），不得以單獨一個下橫線開頭。

遊戲識別符號優先取用該遊戲的官方正式英語名稱（保留原始大小寫）。​

例如，《家有大貓》的遊戲識別符號是“Nekojishi”，其元檔案和本地化檔案都是“Nekojishi.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: 遊戲名稱

此屬性為必填屬性。

遊戲名稱應當優先取用該遊戲的官方英語正式名稱（保留原始大小寫），其次取用該遊戲最廣泛傳播的英文譯名。若該遊戲沒有英語名稱，則取用原語言名稱。不得使用任何來源的別稱。

例如，《Beek - 使魔與毛茸茸》名稱屬性的值應當填寫 Beek - Familiar Spirit。

若該遊戲的英文名稱存在地區差異，則應當遵照遊戲識別符號中的相關規則取用。

若該遊戲名稱帶有西文冒號 :（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
afdian 愛發電
patreon Patreon
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