Logs & Diagnostics: Difference between revisions
No edit summary |
No edit summary |
||
| Line 54: | Line 54: | ||
=== Diagnostic Log Reference === | === Diagnostic Log Reference === | ||
The following files have been observed in the <code>logs</code> directory of a Windows ZA Recomp installation. The precise contents and availability may vary by launcher version. | |||
{| class="wikitable" | {| class="wikitable" | ||
! Log File | ! Log File | ||
! Purpose | ! Likely Purpose | ||
! Typical Use | ! Typical Use | ||
|- | |||
| '''launcher.log''' | |||
| ZA Recomp launcher and game preparation diagnostics. | |||
| Installation, import, and launcher startup failures | |||
|- | |||
| '''lumiose-launch.log''' | |||
| Lumiose Online launch-related diagnostics. | |||
| Failures starting Lumiose Online | |||
|- | |- | ||
| '''play.log''' | | '''play.log''' | ||
| | | Game execution and runtime events. | ||
| Startup failures, gameplay problems, runtime errors | | Startup failures, gameplay problems, runtime errors | ||
|- | |- | ||
| '''crash.log''' | | '''play-anterior.log''' | ||
| | | An additional gameplay log, potentially containing earlier session output. Its exact rotation behavior has not yet been verified. | ||
| When play.log is empty or does not cover the affected session | |||
|- | |||
| '''crash-YYYYMMDD-HHMMSS.log''' | |||
| Timestamped crash diagnostics, when generated. | |||
| Application crashes, exceptions, access violations | | Application crashes, exceptions, access violations | ||
|- | |- | ||
| '''smoke.log''' | | '''smoke.log''' | ||
| | | Diagnostic output from isolated startup or preparation checks. | ||
| Isolated startup | | Isolated startup and update preparation failures | ||
|- | |- | ||
| '''capture.log''' | | '''capture.log''' | ||
| | | Diagnostic output associated with preparation or capture operations. | ||
| Update preparation and related failures | | Update preparation and related failures | ||
|} | |} | ||
Not every installation or failure generates | The first five filename patterns above were observed in an installation's <code>logs</code> directory. The <code>smoke.log</code> and <code>capture.log</code> files may instead appear in temporary update working directories. Not every installation or failure generates every file. | ||
=== Finding the Main Log Directory === | |||
Open the folder containing '''lasrecomp.exe''', then open its '''logs''' directory. | |||
'''Example:''' <code>D:\Games\Switch\ZA Recomp\logs\</code> | |||
Check file modification times to identify logs associated with the reported failure. A log may be empty, and an older log may describe a different incident. | |||
=== launcher.log and lumiose-launch.log === | |||
These files have been observed in the main <code>logs</code> directory. Based on their names, they are useful starting points for launcher and Lumiose Online startup failures, respectively. Their exact contents have not yet been verified. | |||
'''When to collect:''' | |||
* The launcher cannot import or prepare the game. | |||
* Lumiose Online fails to start. | |||
* An error occurs before normal gameplay begins. | |||
Collect both files when the source of a startup failure is unclear, if they are present. | |||
=== play.log === | === play.log === | ||
| Line 114: | Line 148: | ||
* The launcher displays a runtime error. | * The launcher displays a runtime error. | ||
When possible, reproduce the issue and collect the log from the affected session. | When possible, reproduce the issue and collect the log from the affected session. If <code>play.log</code> is empty, check <code>play-anterior.log</code> and its modification time. | ||
=== play-anterior.log === | |||
The '''play-anterior.log''' file has been observed alongside <code>play.log</code> in the main <code>logs</code> directory. It may contain earlier gameplay output, but the exact file rotation behavior has not yet been verified. | |||
'''When to collect:''' | |||
* <code>play.log</code> is empty. | |||
* <code>play.log</code> does not cover the session in which the issue occurred. | |||
* Support staff request additional runtime context. | |||
Depending on the failure, | Check the file's modification time before assuming it contains the relevant session. | ||
=== Timestamped crash logs === | |||
Crash diagnostic files have been observed with names such as <code>crash-20261109-153832.log</code>. The general observed pattern is: | |||
<code>crash-YYYYMMDD-HHMMSS.log</code> | |||
Depending on the failure, these files may contain: | |||
* Exception codes | * Exception codes | ||
| Line 128: | Line 176: | ||
* Crash-related diagnostic information | * Crash-related diagnostic information | ||
For example, an exception code such as '''0xC0000005''' indicates an access violation. | For example, an exception code such as '''0xC0000005''' indicates an access violation. An access violation does not, by itself, establish the underlying cause of a crash. | ||
An access violation does not, by itself, establish the underlying cause of a crash. | |||
'''Observed location:''' <code><ZA Recomp installation folder>\logs\</code> | |||
'''When to collect:''' | '''When to collect:''' | ||
| Line 146: | Line 190: | ||
|type=tip | |type=tip | ||
|title=Crash Investigation | |title=Crash Investigation | ||
|When reporting a crash, | |When reporting a crash, collect the timestamped crash log matching the incident and the relevant gameplay log if available. Avoid sending unrelated crash logs from older sessions unless requested. | ||
}} | }} | ||
| Line 223: | Line 267: | ||
== Finding Logs with PowerShell == | == Finding Logs with PowerShell == | ||
Windows users can search their ZA Recomp installation for diagnostic files using PowerShell. | Windows users can search their ZA Recomp installation for diagnostic files using PowerShell. Replace the example installation path with the location of your own ZA Recomp installation: | ||
<pre> | <pre> | ||
Get-ChildItem -Path "C:\Games\ZA Recomp" -Recurse -File -ErrorAction SilentlyContinue | | Get-ChildItem -Path "C:\Games\ZA Recomp" -Recurse -File -ErrorAction SilentlyContinue | | ||
Where-Object { $_.Name -in @("play.log", " | Where-Object { | ||
Select-Object Name, FullName | $_.Name -in @("launcher.log", "lumiose-launch.log", "play.log", "play-anterior.log", "smoke.log", "capture.log") -or | ||
$_.Name -like "crash-*.log" -or | |||
$_.Name -eq "crash.log" | |||
} | | |||
Select-Object Name, FullName, LastWriteTime, Length | | |||
Sort-Object LastWriteTime -Descending | |||
</pre> | </pre> | ||
The command searches the installation directory and its subdirectories | The command searches the installation directory and its subdirectories, displays modification times and file sizes, and does not modify or delete any files. It also checks for a legacy or alternate <code>crash.log</code> filename, although timestamped crash filenames were observed in the installation documented here. | ||
{{Notice | {{Notice | ||
| Line 252: | Line 297: | ||
|- | |- | ||
| Game fails to start | | Game fails to start | ||
| play.log, crash | | launcher.log, lumiose-launch.log, play.log (if populated), and relevant crash log if generated | ||
|- | |- | ||
| Game crashes during gameplay | | Game crashes during gameplay | ||
| crash.log | | Timestamped crash log and play.log; check play-anterior.log if needed | ||
|- | |- | ||
| Update preparation fails | | Update preparation fails | ||
| smoke.log, capture.log if generated | | launcher.log, lumiose-launch.log, smoke.log, capture.log if generated | ||
|- | |- | ||
| Isolated startup did not finish | | Isolated startup did not finish | ||
| smoke.log, capture.log if generated | | smoke.log, capture.log if generated; launcher.log and lumiose-launch.log | ||
|- | |- | ||
| Game import fails | | Game import fails | ||
| | | launcher.log and relevant import error messages | ||
|- | |- | ||
| Multiplayer connection fails | | Multiplayer connection fails | ||
| play.log and | | play.log or play-anterior.log, lumiose-launch.log if relevant, and exact connection error messages | ||
|- | |- | ||
| Performance problems | | Performance problems | ||
| | | Relevant gameplay log, hardware specifications, and graphics settings | ||
|} | |} | ||
These recommendations apply primarily to the Windows standalone launcher. | These recommendations apply primarily to the Windows standalone launcher. Collect files whose timestamps correspond to the issue; file availability varies by failure and version. | ||
== Other Platforms == | == Other Platforms == | ||
| Line 332: | Line 377: | ||
# Reproduce the problem, if possible. | # Reproduce the problem, if possible. | ||
# Record the exact error message. | # Record the exact error message. | ||
# Locate the relevant diagnostic files. | # Locate the relevant diagnostic files and check their modification times. | ||
# If update preparation failed, copy any temporary logs before retrying. | # If update preparation failed, copy any temporary logs before retrying. | ||
# Close the game or launcher when appropriate. | # Close the game or launcher when appropriate. | ||
# Preserve the logs associated with the affected session. | # Preserve the logs associated with the affected session. If play.log is empty, check play-anterior.log. | ||
# Review the files for sensitive information. | # Review the files for sensitive information. | ||
# Attach the relevant logs when requesting support. | # Attach the relevant logs when requesting support. | ||
Revision as of 06:48, 14 November 2026
Welcome to the Lumiose Online diagnostic documentation.
This page explains how to locate and collect diagnostic information when troubleshooting installation failures, launcher errors, game crashes, multiplayer connectivity problems, and other technical issues.
Diagnostic logs help the development team identify where a failure occurred and determine which components may be responsible.
Supported Platforms
Lumiose Online supports four installation methods:
| Platform | Installation Method | Diagnostic Information |
|---|---|---|
| Windows | ZA Recomp (Native) | Launcher, gameplay, update preparation, and crash diagnostics |
| macOS | MonZaMac (Native) | Platform-specific diagnostic information |
| PC | Eden Emulator | Emulator and mod-related diagnostics |
| Nintendo Switch | Atmosphère | Platform-specific diagnostic information |
The availability and location of diagnostic logs depend on the platform, application version, and type of failure.
Windows Standalone Launcher (ZA Recomp)
The Windows standalone launcher can generate diagnostic files during game preparation, update installation, and normal execution.
Some logs are stored in persistent directories, while others are generated in temporary working directories.
Diagnostic Log Reference
The following files have been observed in the logs directory of a Windows ZA Recomp installation. The precise contents and availability may vary by launcher version.
| Log File | Likely Purpose | Typical Use |
|---|---|---|
| launcher.log | ZA Recomp launcher and game preparation diagnostics. | Installation, import, and launcher startup failures |
| lumiose-launch.log | Lumiose Online launch-related diagnostics. | Failures starting Lumiose Online |
| play.log | Game execution and runtime events. | Startup failures, gameplay problems, runtime errors |
| play-anterior.log | An additional gameplay log, potentially containing earlier session output. Its exact rotation behavior has not yet been verified. | When play.log is empty or does not cover the affected session |
| crash-YYYYMMDD-HHMMSS.log | Timestamped crash diagnostics, when generated. | Application crashes, exceptions, access violations |
| smoke.log | Diagnostic output from isolated startup or preparation checks. | Isolated startup and update preparation failures |
| capture.log | Diagnostic output associated with preparation or capture operations. | Update preparation and related failures |
The first five filename patterns above were observed in an installation's logs directory. The smoke.log and capture.log files may instead appear in temporary update working directories. Not every installation or failure generates every file.
Finding the Main Log Directory
Open the folder containing lasrecomp.exe, then open its logs directory.
Example: D:\Games\Switch\ZA Recomp\logs\
Check file modification times to identify logs associated with the reported failure. A log may be empty, and an older log may describe a different incident.
launcher.log and lumiose-launch.log
These files have been observed in the main logs directory. Based on their names, they are useful starting points for launcher and Lumiose Online startup failures, respectively. Their exact contents have not yet been verified.
When to collect:
- The launcher cannot import or prepare the game.
- Lumiose Online fails to start.
- An error occurs before normal gameplay begins.
Collect both files when the source of a startup failure is unclear, if they are present.
play.log
The play.log file records information about game execution.
Depending on the launcher version, it may contain:
- ZA Recomp version information
- Windows version
- CPU and system information
- Game initialization events
- Launcher status messages
- Runtime warnings and errors
Location (Windows standalone launcher):
<ZA Recomp installation folder>\logs\play.log
For example:
D:\Games\Switch\ZA Recomp\logs\play.log
How to locate play.log:
- Open the folder containing lasrecomp.exe.
- Open the logs directory.
- Locate play.log.
- Attach the file when requesting technical support.
When to collect:
- The game fails to launch.
- The game starts but encounters errors.
- Gameplay behaves unexpectedly.
- The launcher displays a runtime error.
When possible, reproduce the issue and collect the log from the affected session. If play.log is empty, check play-anterior.log and its modification time.
play-anterior.log
The play-anterior.log file has been observed alongside play.log in the main logs directory. It may contain earlier gameplay output, but the exact file rotation behavior has not yet been verified.
When to collect:
play.logis empty.play.logdoes not cover the session in which the issue occurred.- Support staff request additional runtime context.
Check the file's modification time before assuming it contains the relevant session.
Timestamped crash logs
Crash diagnostic files have been observed with names such as crash-20261109-153832.log. The general observed pattern is:
crash-YYYYMMDD-HHMMSS.log
Depending on the failure, these files may contain:
- Exception codes
- Faulting memory addresses
- Host backtraces
- Guest function references
- Crash-related diagnostic information
For example, an exception code such as 0xC0000005 indicates an access violation. An access violation does not, by itself, establish the underlying cause of a crash.
Observed location: <ZA Recomp installation folder>\logs\
When to collect:
- The game closes unexpectedly.
- The launcher or game crashes during startup.
- The game crashes during gameplay.
- An exception or backtrace is generated.
smoke.log
The smoke.log file contains diagnostic information associated with isolated startup or update preparation checks.
This log may be relevant when the launcher reports errors such as:
- Update preparation failed
- Isolated startup did not finish
- Game preparation or validation failed
Location (Windows standalone launcher):
<ZA Recomp installation folder>\lumiose\update-work\initial-*\smoke.log
The initial- directory contains a variable suffix generated during update preparation.
For example:
D:\ZA-Recomp-windows\ZA Recomp\lumiose\update-work\initial-_ql5vc3z\smoke.log
The exact directory name differs between preparation attempts.
How to locate smoke.log:
- Open the folder containing lasrecomp.exe.
- Navigate to lumiose → update-work.
- Look for a directory beginning with initial-.
- Open that directory.
- Locate smoke.log.
- Copy the file to another location before retrying the failed update.
- Attach the copied log when requesting technical support.
When to collect:
Collect this log when an installation or update preparation operation fails and the file is available.
capture.log
The capture.log file contains diagnostic information associated with preparation or capture operations.
It may be useful when investigating:
- Update preparation failures
- Game preparation errors
- Failures occurring before normal gameplay begins
Location:
The exact location has not yet been verified.
If an update preparation failure occurs, inspect the relevant working directory under:
<ZA Recomp installation folder>\lumiose\update-work\
Look for capture.log if it is present.
When to collect:
Collect this log alongside smoke.log when investigating an update preparation failure, if both files were generated.
Finding Logs with PowerShell
Windows users can search their ZA Recomp installation for diagnostic files using PowerShell. Replace the example installation path with the location of your own ZA Recomp installation:
Get-ChildItem -Path "C:\Games\ZA Recomp" -Recurse -File -ErrorAction SilentlyContinue |
Where-Object {
$_.Name -in @("launcher.log", "lumiose-launch.log", "play.log", "play-anterior.log", "smoke.log", "capture.log") -or
$_.Name -like "crash-*.log" -or
$_.Name -eq "crash.log"
} |
Select-Object Name, FullName, LastWriteTime, Length |
Sort-Object LastWriteTime -Descending
The command searches the installation directory and its subdirectories, displays modification times and file sizes, and does not modify or delete any files. It also checks for a legacy or alternate crash.log filename, although timestamped crash filenames were observed in the installation documented here.
Which Logs Should I Collect?
Use the following table to identify the most relevant diagnostic files for a reported issue.
| Problem | Recommended Logs |
|---|---|
| Game fails to start | launcher.log, lumiose-launch.log, play.log (if populated), and relevant crash log if generated |
| Game crashes during gameplay | Timestamped crash log and play.log; check play-anterior.log if needed |
| Update preparation fails | launcher.log, lumiose-launch.log, smoke.log, capture.log if generated |
| Isolated startup did not finish | smoke.log, capture.log if generated; launcher.log and lumiose-launch.log |
| Game import fails | launcher.log and relevant import error messages |
| Multiplayer connection fails | play.log or play-anterior.log, lumiose-launch.log if relevant, and exact connection error messages |
| Performance problems | Relevant gameplay log, hardware specifications, and graphics settings |
These recommendations apply primarily to the Windows standalone launcher. Collect files whose timestamps correspond to the issue; file availability varies by failure and version.
Other Platforms
MonZaMac (macOS)
MonZaMac provides a native macOS implementation of Pokémon Legends: Z-A.
Diagnostic information may differ from the Windows launcher.
When reporting a problem, provide:
- macOS version
- Mac model and Apple Silicon chip
- MonZaMac release version
- Exact error messages
- Available application logs or crash reports
Eden Emulator (PC)
Eden uses its own emulation environment and diagnostic facilities.
When reporting a Lumiose Online issue while using Eden, provide:
- Eden version
- Operating system
- Pokémon Legends: Z-A game version
- Lumiose Online mod version
- Exact error messages
- Relevant diagnostic information, if available
Nintendo Switch (Atmosphère)
Nintendo Switch installations use Atmosphère custom firmware.
When reporting an issue, provide:
- Console model
- System firmware version
- Atmosphère version
- Pokémon Legends: Z-A game version
- Lumiose Online mod version
- Exact error messages
- Available diagnostic information
Problems originating from Atmosphère or the console environment may fall outside the scope of Lumiose Online support.
Collecting Diagnostic Logs
When troubleshooting an issue:
- Reproduce the problem, if possible.
- Record the exact error message.
- Locate the relevant diagnostic files and check their modification times.
- If update preparation failed, copy any temporary logs before retrying.
- Close the game or launcher when appropriate.
- Preserve the logs associated with the affected session. If play.log is empty, check play-anterior.log.
- Review the files for sensitive information.
- Attach the relevant logs when requesting support.
Protecting Sensitive Information
Diagnostic logs may contain system or environment information.
Before sharing them publicly, review the contents for:
- Windows or macOS usernames
- Local file paths
- Public IP addresses
- Authentication tokens or credentials
- Other personally identifiable information
Remove sensitive values where necessary while preserving the surrounding diagnostic information.
Do not post private keys, passwords, or authentication tokens in public support channels.
Reporting an Issue
When requesting technical assistance, provide the following information:
- Platform: Windows standalone, MonZaMac, Eden, or Nintendo Switch
- Operating system: OS name and version
- Game version: Installed Pokémon Legends: Z-A version
- Lumiose Online version: Installed mod or launcher version
- Hardware: CPU, GPU, and RAM, where applicable
- Problem: Description of the failure
- Reproduction steps: Actions required to trigger the problem
- Error message: Exact text or screenshot
- Diagnostic logs: Relevant files associated with the failure
If the problem occurs consistently, explain whether it happens every time or only under certain conditions.
For assistance, visit the official Lumiose Online Discord: