EmulationStation游戏列表(gamelist.xml)配置完全指南-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00128/article/details/148891196

EmulationStation游戏列表(gamelist.xml)配置完全指南

EmulationStation A flexible emulator front-end supporting keyboardless navigation and custom system themes. 项目地址: https://gitcode.com/gh_mirrors/em/EmulationStation

什么是游戏列表文件

在EmulationStation模拟器前端中，gamelist.xml文件是存储游戏元数据的核心配置文件。它为每个游戏系统定义了一系列元数据信息，包括但不限于：

游戏显示名称
游戏描述文本
游戏封面或截图
发行日期
游戏评分
开发商和发行商信息
游戏类型
支持玩家数量等

文件存储位置与加载顺序

EmulationStation会按照以下优先级顺序查找gamelist.xml文件，使用找到的第一个有效文件：

系统ROM目录下的gamelist.xml（[SYSTEM_PATH]/gamelist.xml）
用户目录下的配置文件（~/.emulationstation/gamelists/[SYSTEM_NAME]/gamelist.xml）
系统全局配置文件（/etc/emulationstation/gamelists/[SYSTEM_NAME]/gamelist.xml）

这种多位置查找机制既支持系统级的统一配置，也允许用户自定义个人游戏库的元数据。

XML文件结构详解

一个完整的gamelist.xml文件由<gameList>根标签包裹，内部包含多个<game>或<folder>子元素。每个游戏或文件夹的元数据都封装在对应的标签中。

基础示例

<gameList>
    <game>
        <path>/home/user/ROMs/snes/chrono_trigger.sfc</path>
        <name>时空之轮</name>
        <desc>史克威尔1995年发行的经典RPG游戏，被誉为史上最伟大的游戏之一。</desc>
        <image>~/.emulationstation/downloaded_images/snes/chrono_trigger.png</image>
        <releasedate>19950311T000000</releasedate>
        <developer>Square</developer>
        <publisher>Square</publisher>
        <genre>角色扮演</genre>
        <players>1</players>
    </game>
</gameList>

元数据类型说明

EmulationStation支持多种元数据类型，每种类型都有特定的格式要求：

字符串(string) - 普通文本内容
图片路径(image_path) - 支持三种格式：
- 绝对路径（如/path/to/image.png）
- 相对于系统游戏目录的相对路径（以./开头，如./cover.png）
- 相对于用户主目录的路径（以~/开头）
注意：图片会被自动缩放以适应主题，建议使用适当分辨率以平衡显示效果和加载速度
浮点数(float) - 以字符串形式表示的浮点数值
整数(integer) - 以字符串形式表示的整数值
日期时间(datetime) - ISO格式日期时间字符串，格式为%Y%m%dT%H%M%S%F%q

游戏元数据标签全集

游戏(`<game>`)标签支持以下属性：

name：游戏显示名称（必填）
desc：游戏详细描述（支持长文本自动滚动）
image：游戏封面/截图路径
thumbnail：缩略图路径（当前版本未使用）
rating：游戏评分（0-1之间的浮点数）
releasedate：游戏发行日期（ISO格式）
developer：开发商名称
publisher：发行商名称
genre：游戏类型
players：支持玩家数量
playcount：游玩次数统计（自动记录）
lastplayed：最后游玩时间（自动记录）

文件夹(`<folder>`)标签支持以下属性：

name：文件夹显示名称
desc：文件夹描述
image：文件夹图标路径
thumbnail：文件夹缩略图路径（当前版本未使用）

实用技巧与注意事项

路径处理：EmulationStation会自动尝试将图片路径转换为相对路径，便于配置迁移
字符编码：当前版本不支持Unicode字符，建议使用ASCII字符集
默认值优化：对于等于默认值的属性（如players=1），系统不会写入XML文件以减少冗余
特殊功能：
- 游戏条目可以指向文件夹（如果扩展名匹配）
- 文件夹元数据仅当其内部有游戏时才会生效
- 系统会保留无法找到对应文件的游戏条目
命令行参数：
- --gamelist-only：仅显示gamelist.xml中定义的游戏
- --ignore-gamelist：忽略gamelist.xml文件
显示逻辑：只要系统中有一个游戏配置了图片，就会自动启用详细视图模式