Jump to content

Logs & Diagnostics: Difference between revisions

From LumiWiki
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'''
| Records game execution and runtime events.
| Game execution and runtime events.
| Startup failures, gameplay problems, runtime errors
| Startup failures, gameplay problems, runtime errors
|-
|-
| '''crash.log'''
| '''play-anterior.log'''
| Records crash-related diagnostic information when generated.
| 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'''
| Records diagnostic output from isolated startup or preparation checks.
| Diagnostic output from isolated startup or preparation checks.
| Isolated startup failures, update preparation problems
| Isolated startup and update preparation failures
|-
|-
| '''capture.log'''
| '''capture.log'''
| Records diagnostic output associated with preparation or capture operations.
| Diagnostic output associated with preparation or capture operations.
| Update preparation and related failures
| Update preparation and related failures
|}
|}


Not every installation or failure generates all four files.
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.


=== crash.log ===
'''When to collect:'''


The '''crash.log''' file may be generated when the game encounters a crash.
* <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, it may contain:
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.
 
'''Location:'''


The exact location has not yet been verified. Check available diagnostic directories and provide the file if generated.
'''Observed location:''' <code>&lt;ZA Recomp installation folder&gt;\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, include both crash.log and play.log if available. The execution log may provide context about events immediately preceding the 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:
 
Open PowerShell and run the following command, replacing 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", "crash.log", "smoke.log", "capture.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 for the listed log files.
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.
 
It does not modify or delete any files.


{{Notice
{{Notice
Line 252: Line 297:
|-
|-
| Game fails to start
| Game fails to start
| play.log, crash.log if generated
| 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, play.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
| Relevant launcher or import diagnostic output
| launcher.log and relevant import error messages
|-
|-
| Multiplayer connection fails
| Multiplayer connection fails
| play.log and relevant connection error messages
| play.log or play-anterior.log, lumiose-launch.log if relevant, and exact connection error messages
|-
|-
| Performance problems
| Performance problems
| play.log, hardware specifications, and graphics settings
| 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


LumiWiki › Main Page › Logs & Diagnostics

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.


Platform Differences
The diagnostic files and locations described below are primarily associated with the Windows standalone launcher (ZA Recomp). Other platforms may generate different logs or use different diagnostic methods.

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:

  1. Open the folder containing lasrecomp.exe.
  2. Open the logs directory.
  3. Locate play.log.
  4. 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.log is empty.
  • play.log does 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.


Crash Investigation
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.

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:

  1. Open the folder containing lasrecomp.exe.
  2. Navigate to lumiose → update-work.
  3. Look for a directory beginning with initial-.
  4. Open that directory.
  5. Locate smoke.log.
  6. Copy the file to another location before retrying the failed update.
  7. Attach the copied log when requesting technical support.


Temporary Diagnostic Files
The initial-* working directory is normally removed after update preparation completes successfully. If an update fails and the directory remains available, collect its diagnostic files before retrying. A later successful update may remove the directory and its contents.

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.


Diagnostic Log Availability
Some logs are only generated during specific operations or failure conditions. A missing log file does not necessarily indicate an installation problem.

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.


Searching for Temporary Logs
If smoke.log or capture.log cannot be found after a successful update, the temporary working directory may already have been removed. This is expected behavior for completed update preparation.

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


Emulator Support
Problems originating from the emulator itself may require assistance from the Eden development or support community rather than the Lumiose Online development team.

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:

  1. Reproduce the problem, if possible.
  2. Record the exact error message.
  3. Locate the relevant diagnostic files and check their modification times.
  4. If update preparation failed, copy any temporary logs before retrying.
  5. Close the game or launcher when appropriate.
  6. Preserve the logs associated with the affected session. If play.log is empty, check play-anterior.log.
  7. Review the files for sensitive information.
  8. Attach the relevant logs when requesting support.


Preserve Logs Before Retrying
Avoid deleting or overwriting diagnostic logs until you have collected the files associated with the failure. Reinstalling, retrying updates, or repeatedly relaunching the application may make the original diagnostic information unavailable.

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:

Lumiose Online Discord