LostOdysseyRecomp README

项目的 README,来自 github.com/freefrank/LostOdysseyRecomp。合并为一个 markdown 文件:README.md。

Lost Odyssey Recomp logo

Lost Odyssey Recomp

A native port of Lost Odyssey for Xbox 360.

Latest release Downloads Stars License: GPL-3.0 Last commit Open issues Support on Ko-fi Discord

Windows x64 Linux x64 macOS arm64 Android arm64

Direct3D 12 Vulkan Metal

Download · Installation guide · 简体中文

Changelog · Report an issue · Discord · Project board · Build from source

Contents

Start playing

Download the package for your platform from the latest release.

Platform Package First launch
Windows x64 LostOdysseyRecomp-windows-x64-<version>.zip Extract the whole ZIP to a writable folder and run LostOdysseyRecomp.exe. Needs a CPU with AVX.
Linux x64 LostOdysseyRecomp-linux-x64-<version>.AppImage Make it executable with chmod +x, then run it.
Linux x64 LostOdysseyRecomp-linux-x64-<version>.flatpak Install the Freedesktop 26.08 runtime, then the bundle (commands).
macOS arm64 LostOdysseyRecomp-macos-arm64-<version>.dmg Drag LostOdysseyRecomp.app to Applications. Needs an Apple Silicon Mac with macOS 15 or later.
Android arm64 LostOdysseyRecomp-android-arm64-<version>.apk Install the APK and open it once. Needs a 64-bit Android 8.0+ device with Vulkan.

On Steam Deck, use Settings → System → Add to Steam with either Linux package to add the game and its library artwork (steps). Artwork is generated from your game files; if that fails, the game uses bundled fallback artwork.

  1. Import your game data. The importer opens when no game is found. Select an extracted game folder, default.xex, an ISO or GOD data.
  2. Get the shaders. On the first start the game offers precompiled shaders for your renderer; if you skip, it compiles them once.
  3. Add the other discs and DLC in Settings → System → Import discs & DLC. With all four discs imported, the game changes discs on its own.

Disc 1 is required to start. Use one supported four-disc set (Asian multilingual or USA/Europe) and don't mix editions; the installation guide shows how to check yours.

macOS

The app is not notarized, so macOS blocks the first launch: try to open it once, then choose Open Anyway in System Settings → Privacy & Security. To update, replace the app with the new one. Step-by-step guide.

Android

Step-by-step guide.

Nintendo Switch

Ad0ky maintains an experimental homebrew build for Switch consoles running custom firmware. It is not part of the releases here: download it from Ad0ky's releases, which also have the install steps.

HDR

Turn on HDR in Graphics and save. HDR peak brightness opens a calibration page; LB / RB switch between the game scene and a test pattern. HDR is available on Windows, Linux and macOS.

Features

Feature What you get
Import Folder, XEX, ISO and GOD sources, DLC and disc replacement. Your original files are not changed.
Languages Menus in English, Japanese, Korean, Traditional Chinese and Simplified Chinese. Game languages depend on your edition.
Display Windowed or fullscreen, monitor and GPU choice, 16:9 and 21:9 resolutions (taller screens such as 16:10 are filled), HDR and Brightness / Gamma. Cutscenes and the pause overlay use a centred 16:9 area.
Anti-aliasing and upscaling FXAA, SMAA, TAA, DLSS, FSR 3.1, XeSS (Windows Direct3D 12) and MetalFX (macOS).
Graphics options Shadow resolution 1×/2×/4×, SSAO/GTAO, anisotropic filtering, depth of field and bloom.
Frame rate 30/60/90/120 FPS; VSync Off, On or FreeSync / G-SYNC Compatible VRR. Performance overlay shows the frame rate, or a bar with the upscaler, frame generation, CPU and GPU load.
Loading speed Graphics → Loading speed: Original keeps the Xbox 360 loading pace; Fast (default) loads at a higher frame rate. Effects play at normal speed either way.
Frame generation DLSS, FSR or XeSS on Windows Direct3D 12; DLSS on Windows Vulkan. It pauses while cinematic black bars are shown and resumes in gameplay.
DLSS 5 neural rendering Windows with DLSS on an RTX GPU. It needs nvngx_dlssnr.dll, which the game does not include: put your own copy (tested with 310.8.0.0) next to LostOdysseyRecomp.exe and restart.
Shaders Precompiled shaders downloaded on the first start, or compiled once and cached.
Audio Stereo, 5.1 surround, or matrix surround for an AV receiver. Cutscene dialogue has its own volume.
Input Controllers, keyboard and rumble; touch controls on Android.
Mods Windows only: texture, model, menu and font replacements, cutscene videos, text translations and language packs (which can add letters the game's fonts lack), and PlayStation button prompts, installed by hand or with Mod Organizer 2 (its plugins are in the Windows ZIP). Other platforms may load mods but are not supported. See the modding guide. Ready-made mods, such as the 4x HD texture pack, are shared in the #mods forum on Discord.
Achievements The game's 36 Xbox 360 achievements, with an Xbox 360-style notification and sound when you unlock one. Settings → System → Achievements lists them with your unlock dates and turns the notification on, silent or off. An achievement.wav next to settings.ini replaces the sound.
Discord status Windows, Linux and macOS: Discord Rich Presence shows your location, disc and activity. Settings → System → Discord status is on by default; changes take effect immediately. If status is missing, check the runtime log for connection and activity diagnostics.
Debug menu Render captures, Save Anywhere, encounter switches, teleport, fast-forward and cheats. See Debug menu.

Controls

Controllers and the keyboard work together for player 1. If your controller is not recognized, see the input reference.

Game action Keyboard
Start / Back Enter / Backspace
A / B / X / Y Z / X / A / S
D-pad / left stick Arrow keys / I, J, K, L
Left / right shoulder Q / W
Left / right trigger E / R
Title menu: Settings (Y) S
Title menu: Quit game (Back / View) Backspace
Debug Menu F1

These are the default keys. Settings → Gameplay → Controls changes the keys and the controller buttons, and sets the button prompts and the vibration strength.

Quitting from the title menu asks for confirmation, with No selected by default.

Press Back to zoom the minimap; hold it for about half a second to hide the minimap. For Ring actions, use the controller's right trigger or R.

Debug menu

Press F1, or LB+RB on a controller (L1+R1 on PlayStation layouts), to open or close the Debug Menu. The game pauses while it is open. It has three pages, Overview, Teleport and Cheats, and uses the keyboard or a controller.

Action Keyboard Controller
Select a row ↑ / ↓ D-pad up / down
Change a value ← / → D-pad left / right
Confirm Enter A
Return or close Esc B
Previous / next page Q or Tab / E LB / RB
Change Cheats category Select the category row, then ← / → LT / RT
Open or close the overlay F1 LB+RB

Overview: captures and game actions

Overview shows the current map and has the menu language, Capture render state, Save Anywhere, Return to title (outside battles) and an action that wins the current battle.

Teleport: positions within the current map

Teleport has a position bookmark, editable X/Y/Z coordinates and the map's points of interest. On the coordinate row, press Enter to pick X, Y or Z and ←/→ to move it. Confirm, then close the menu to move.

Debug Event Room, at the bottom of the page, takes you to the game's own event-debug map (z0g_9). Hold LB and press Up there to open Scenario Jump.

Cheats: speed and game-data tools

Category What it does
Quick tools Fast-forward, Encounter rate, Battle EXP ×2, menu animation speed, Allow memory edits, gold and HP/MP.
Characters HP/MP, EXP (0–99, not the level) and skills.
Inventory Set items and materials to 1, 10, 50 or 99, or fill whole categories. Sort the in-game inventory to refresh it.
Equipment Weapon, ring and accessory changes.
Party Party members, rows and field character.
Developer The original EDIT MENU: enable it, close F1, press LT+RT.

Menu animations sets camp menu opening, closing and submenu transitions to Normal (1×), Fast (2×) or Faster (4×). The choice is saved; Normal is the default. Gameplay and audio keep their usual speed.

Fast-forward runs at 2×–8× while you hold the selected button (Hold) or after you press it (Toggle). Set it in Cheats → Fast-forward button (next to Speed mode); choose LT (default) or LB. With LT selected, holding RT at the same time blocks fast-forward; with LB selected, RB does. Fast-forward audio defaults to Keep pitch; choose Speed up to raise the pitch with the speed. The choices are saved.

Encounter rate offers Normal, Half, None and Every step. Half skips every other random encounter; Every step starts a battle on each step in areas with random encounters. Story battles and bosses are unaffected. Every step is a temporary testing aid: restarting restores your last Normal/Half/None choice. Battle EXP ×2 is a separate, saved switch for experience earned from won battles.

The EXP bonus applies after the game's level-based calculation and keeps its normal per-battle cap. SP and gold stay the same.

Memory edits are off by default. Back up your save, turn on Allow memory edits, choose an action, confirm Yes and close F1 to apply it.

Files and folders

The Windows ZIP is portable: everything stays in the folder you extracted it to. The AppImage, Flatpak and macOS app keep your files in your user folders:

Package Settings Saves, cache and game data Logs
Windows ZIP folder with LostOdysseyRecomp.exe same same
Linux AppImage ~/.config/lost-odyssey-recomp/ ~/.local/share/lost-odyssey-recomp/ ~/.local/state/lost-odyssey-recomp/
Linux Flatpak ~/.var/app/io.github.freefrank.LostOdysseyRecomp/config/lost-odyssey-recomp/ ~/.var/app/io.github.freefrank.LostOdysseyRecomp/data/ ~/.var/app/io.github.freefrank.LostOdysseyRecomp/.local/state/lost-odyssey-recomp/
macOS app ~/Library/Application Support/LostOdysseyRecomp/ same ~/Library/Logs/LostOdysseyRecomp/
Android inside the app saves inside the app by default, optionally <game folder>/save/; game data in Android/data/io.github.freefrank.lostodyssey/files/game/ or the chosen folder Android/data/io.github.freefrank.lostodyssey/files/logs/
What Where Notes
Saves save/ Keep when updating. Xenia and Xbox 360 saves can be imported.
Profiles profile/ Keep when updating.
Settings settings.ini Delete it to go back to the default settings.
Imported game game/ with disc1/–disc4/ and dlc/ The importer's default location; game-path.txt remembers another one.
Shader cache cache/shaders/ Rebuilt if deleted.
Downloaded shaders shaders/
Logs logs/runtime-*.log The last three runs are kept.
Render captures captures/
Mods mods/

More detail is in file locations.

Command-line options

Option Effect
--game <path> Use this game folder (with default.xex or disc1/) or default.xex file, skipping the importer.
--install Open the importer even when a game is already set up.
--add-to-steam Add the game to Steam with library artwork, then exit with a status code. Close Steam first; add it again if you move the game.
--setup Windows: open the setup page, then start the game.
--prepare-shaders-only Prepare all shaders, then exit without starting the game.
LostOdysseyRecomp.exe --game "D:\Games\Lost Odyssey"
./LostOdysseyRecomp-linux-x64-<version>.AppImage --game ~/Games/LostOdyssey
flatpak run io.github.freefrank.LostOdysseyRecomp --game ~/Games/LostOdyssey
Environment variable Effect
LO_GRAPHICS_API d3d12 or vulkan on Windows.
LO_FPS Frame-rate cap; 0 means uncapped.
LO_FAST_LOADING=0/1 Override Loading speed: 0 selects Original pacing; 1 selects Fast. Without the override, loading_transitions=0/2 in settings.ini stores Original/Fast. Fast loading on Android and devices with a detected battery is capped at 4× the selected limit, up to 240 FPS (240 FPS if uncapped).
LO_NO_UPDATE=1 Skip the update check.
LO_MODS=0 Disable mods.
LO_AUDIO_MUTE=1 Mute audio.
LO_CONTROLLER_RUMBLE=0 Turn rumble off.
LO_OPTISCALER_PATH Load your own OptiScaler.dll on Windows (setup).

Reporting a problem

Open an issue with the version, operating system, graphics backend, GPU and driver, game edition and disc, and the steps or scene that show the problem. Attach the newest logs/runtime-<timestamp>.log. Settings → System → Debug log is on by default. If you turned it off, turn it back on, save and restart before showing the problem again.

For a visual problem, make a render capture while it is on screen. Do not attach game files, saves or personal data.

Optional log collection is off by default; see Privacy.

Screenshots

Lost Odyssey title screen — Press START
Ring combat City exploration
Kaim attacking with the Ring timing interface Exploring the industrial city

Development

See Building, Developer tools, the roadmap and the documentation index.

Sponsors

Thank you to CarlosVonSexron, Atlas, stratosG, iambRad, Frenzy Fresh, José Antonio Martínez Godoy, C_BAR, Arakon, Efren V, Torresmo, doc_haz, Whitesun and Cristian on Ko-fi, and to Norghat, Morgan and one anonymous supporter on Buy Me a Coffee, for supporting the project.

Credits and game data

Thanks to everyone who sent pull requests and patches: MikeRavenelle, dj5927, Xarishark, navjack, frankzzz, cngjd, faisalkindi and Ad0ky. The macOS port started from MikeRavenelle's Apple Silicon work, and Ad0ky ported the game to the Nintendo Switch on the LostOdysseyNX branch.

With research and tools from UnleashedRecomp, re:Blue, XenonRecomp, XenosRecomp, plume and Xenia. Audio uses the Xenia FFmpeg fork (license). The Android Turnip GPU drivers come from the driver list of the Eden emulator and load through libadrenotools; the Mali PanVK driver comes from panvk-kbase-android.

Lost Odyssey and its assets belong to their respective owners. This is an unofficial project. Supply data extracted from your own discs; do not commit game executables, resource archives, textures, audio, video, generated game code or captures to this repository. Dependencies retain their respective licenses.

LostOdysseyRecomp (freefrank/LostOdysseyRecomp)

正在搜索数据库…

这是什么?Lost Odyssey Recomp 是一个实验性的原生 PC/主机移植版,移植的是 Xbox 360 日式角色扮演游戏 Lost Odyssey,采用静态重编译技术构建。它不包含任何游戏资源,因此你需要自己合法拥有一份游戏。
这是模拟器,还是别的东西?它不是传统意义上的模拟器:静态重编译会把 Xbox 360 原版游戏代码直接转换为各平台(Windows、Linux、macOS、Android)的原生代码,而不是在运行时模拟 Xbox 360 硬件。
我该怎么让它运行起来?下载适用于你所用平台的发行包(Windows 的 ZIP、Linux 的 AppImage/Flatpak、macOS 的 DMG 或 Android 的 APK),运行它;导入器打开后,选择你解压出来的游戏文件夹、default.xex、ISO 镜像或 GOD 数据。游戏首次启动时可以下载预编译的着色器,其余光盘和 DLC 之后可以在设置中添加。
我是否必须拥有 Lost Odyssey 的实体光盘?是的。项目本身不附带任何游戏资源,因此你必须提供自己解压出来的游戏数据(文件夹、default.xex、ISO 或 GOD),且来源须为受支持的四碟版本,即亚洲多语言版或美国/欧洲版。
macOS 应用开箱即可直接启动吗?并非如此:macOS 版本未签名、未公证,因此 Gatekeeper 会阻止首次启动,你需要在系统设置中手动点击“仍要打开”,才能运行。
它能在 Android 上运行吗?需要什么条件?可以,但需要一台 64 位、Android 8.0+ 且支持 Vulkan 的设备。高通设备需要先下载 Turnip GPU 驱动,Mali 设备则需要 PanVK 驱动(Mali-G57/G68/G77/G78/G610 或更新的型号),游戏才能启动。
有哪些超分辨率和帧生成选项?Windows Direct3D 12 支持 FXAA、SMAA、TAA、DLSS、FSR 3.1 和 XeSS,并支持帧生成;Windows Vulkan 支持带帧生成的 DLSS;macOS 则使用 MetalFX。如果你自备 nvngxdlssnr.dll,还可以在 RTX 显卡上使用可选的 DLSS 5 神经渲染模式。
可以安装模组吗?可以,但仅限 Windows:支持替换贴图、模型、菜单和字体,替换过场视频、文本翻译以及 PlayStation 按键提示,可手动安装,也可以使用 Mod Organizer 2 安装。其他平台或许也能加载模组,但官方并不支持。
调试菜单能做什么?按下 F1(或 LB+RB)会打开一个三页的浮层,其中包括渲染捕获、随处存档、传送到任意坐标,以及快进、可调节的遇敌率、双倍战斗经验,还能编辑 HP/MP、道具、装备和队伍成员等作弊功能。
它会记录原版 Xbox 360 成就吗?会的,它还原了全部 36 项原版 Xbox 360 成就,并配有 Xbox 风格的弹窗与音效;设置菜单中会列出你的解锁日期。
作者
freefrank
大小
47.1 MB
星标
990
时长
2个月
提交 · 90 天