YukiHub模拟器如何从Playnite导入数据

PC 上 Playnite 攒了几年的 Gal 收藏，到了手机却要从零建卡？YukiHub 支持直接导入 Playnite 数据——SDK 导出 JSON、传到手机、点几下，元数据、启动路径、游玩状态全部继承。自动去重、跳过无路径、导入前可预览，换设备不丢库。具体流程请看下文。

YukiHub如何从Playnite导入数据

1. 准备工作

确保您已经在电脑上安装并使用过 Playnite，并且有可用的游戏数据。游戏均有本地启动路径。

2. 导出 Playnite 数据

打开 Playnite，按照以下步骤导出游戏数据：

点击左上角的菜单按钮，选择 扩展 -> 交互式 SDK Powershell。

在弹出的 Powershell 窗口中，创建并执行以下脚本以导出游戏数据为 JSON 文件。

# 指定导出路径，请根据需要修改此路径
$exportPath = "D:\Playnite_GAL_Export.json"

try {
Write-Host "--- Start Exporting Game Data ---" -ForegroundColor Cyan

if ($null -eq $PlayniteApi) {
try { $PlayniteApi = [Playnite.SDK.API]::Instance } catch {}
}
if ($null -eq $PlayniteApi) {
throw "Cannot find Playnite API."
}

$allGames = $PlayniteApi.Database.Games
$exportGames = @()

foreach ($game in $allGames) {
$launchPath = ""
$playAction = $game.GameActions | Where-Object {
$_.IsPlayAction -eq $true -and ($_.Type -eq 0 -or $_.Type -eq "File")
} | Select-Object -First 1

if ($playAction) {
$expandedPath = $PlayniteApi.ExpandGameVariables($game, $playAction.Path)
if (![System.IO.Path]::IsPathRooted($expandedPath)) {
$launchPath = [System.IO.Path]::Combine($game.InstallDirectory, $expandedPath)
} else {
$launchPath = $expandedPath
}
}

$gameData = [PSCustomObject]@{
id  = $game.Id.ToString()
name= $game.Name
cover_url   = if ($game.CoverImage) { $PlayniteApi.Database.GetFullFilePath($game.CoverImage) } else { $null }
company = ($game.Developers -join ", ")
summary = $game.Description
path= $launchPath
save_path   = $null
source_type = "local"
source_id   = $game.GameId
cached_at   = (Get-Date).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")
created_at  = (Get-Date).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")
}
$exportGames += $gameData
}

$exportGames | ConvertTo-Json -Depth 5 | Out-File -FilePath $exportPath -Encoding UTF8
Write-Host "Export Success! Count: $($exportGames.Count)" -ForegroundColor Green
}
catch {
Write-Host "ERROR: $($_.Exception.Message)" -ForegroundColor Red
}

注意事项

请一定使用 Interactive SDK PowerShell 运行此脚本，确保 Playnite API 可用。

您可以保存这段脚本为 .ps1 文件，方便以后重复使用。

中文 Windows 用户必须使用 GBK 编码保存此脚本以避免乱码问题。

一定要确保脚本中的导出路径（$exportPath）是有效且可写的。

一切出现的数据问题，作者概不负责，请谨慎操作。

3. 导入数据

将导出的 JSON 文件传输到手机。

在 YukiHub 游戏库页面，点击 添加游戏 按钮，选择 从 Playnite 导入 选项。

在弹出的文件选择对话框中，找到并选择之前导出的 JSON 数据文件。

系统会自动预览将要导入的游戏列表，您可以查看哪些游戏将被导入、哪些已存在、哪些没有路径。

您可以选择是否跳过没有路径的游戏。

点击 导入 按钮，YukiHub 会自动解析文件并导入游戏数据。

4. 导入选项说明

跳过无路径的游戏：勾选此项将跳过没有本地路径的游戏（可能是网络游戏或已删除的游戏）。

预览功能：在导入前可以预览游戏列表，包括游戏名称、开发商、状态等信息。

5. 确认导入结果

导入完成后，您可以在游戏库中查看导入的游戏列表。系统会显示导入成功、跳过和失败的游戏数量，确保所有数据正确无误。YukiHub 会跳过已存在的游戏，避免重复导入。