-
Notifications
You must be signed in to change notification settings - Fork 1
Troubleshooting
Warning
WPR is currently in early alpha development.
Many games are still partially supported, unstable, or completely unsupported.
Please try the following first:
WPR changes rapidly during development.
An issue you experience may already have been fixed in newer commits.
Always test using the latest version before reporting problems.
Some issues can be caused by:
- incomplete imports
- corrupted game data
- outdated cached files
- old save/configuration data
Try:
- Removing the game from WPR
- Re-importing the XAP
- Launching the game again
Some games are:
- unsupported
- partially working
- known to crash
- missing required functionality
Before opening an issue, check:
If a game:
- crashes immediately
- hangs on a black screen
- never reaches gameplay
- freezes during startup
this may simply mean the title is not currently supported yet.
WPR is still in active development and compatibility is incomplete.
If the issue still happens:
Please search GitHub Issues first to avoid duplicates.
Open a new issue and include:
| Information | Example |
|---|---|
| Game Name | Hydro Thunder GO |
| Platform | Windows / Android |
| Device | Galaxy S24 Ultra |
| Commit Hash | abc123 |
| Issue | Black screen after intro |
| Logs | Attached if available |
Possible causes:
- unsupported rendering features
- incomplete graphics implementation
- failed content loading
Possible causes:
- missing API implementations
- unsupported engine behaviour
- timing issues
- audio or graphics bugs
Audio support is still incomplete for some titles.
Often caused by:
- incomplete Silverlight support
- unsupported UI controls
- rendering issues
Performance may vary heavily depending on:
- hardware
- Vulkan support
- graphics drivers
- game complexity
Optimisation is still ongoing.
Check:
- Android version support
- unknown sources enabled
- APK architecture compatibility
Some devices have incomplete Vulkan driver support.
Possible symptoms:
- startup crashes
- missing textures
- graphical corruption
Silverlight support is currently experimental.
Many Silverlight-based titles are:
- incomplete
- unstable
- unsupported
Because WPR is in alpha, the following are expected:
- Games failing to boot
- Random crashes
- Missing graphics
- Broken audio
- Performance issues
- Incomplete functionality
Even failed tests are useful.
Reporting:
- what works
- what crashes
- where it crashes
- screenshots/logs
helps improve WPR significantly.
Thank you for helping test and preserve Windows Phone games ❤️