Twilight Souls 0.1.2.0 - Asylum Demo
Explore the Undead Asylum and Firelink Shrine as Link.

Requirements
Windows 10 or 11, 64-bit.
Winget (Microsoft App Installer) and an internet connection.
A GameCube Twilight Princess ISO or GCM image, any region or revision.
Compatibility with images other than USA revision 0 is untested.
Dark Souls Remastered, including its English text files.
At least 100 GB free if the installation and build folders share a drive.

Installation
1. Run TwilightSoulsSetup.exe. It contains and verifies its own setup files.
   If downloaded as a ZIP, extract the EXE and this README first.
2. Select both games and an installation folder.
3. Click Install / Repair. Setup downloads its tools and builds the demo.

The first installation can take several hours. Windows may ask for administrator
approval while Python, Blender, FFmpeg or C++ build tools are installed.
If winget is missing, install Microsoft App Installer before running setup.

Setup offers to enable Windows long-path support for compatible tools. This
optional change requires administrator approval and restarts setup with your
selections. Some applications may need a Windows restart. You can skip it.
Setup extracts its kit into your local application data folder under TS\kit.

If Windows refuses the Blender download with HTTP 403, setup pauses and offers
Open Blender Download. Install Blender 5.2.1 in its default location, then click
Continue. Setup checks that Blender is ready before continuing. You can cancel
setup while waiting and resume later with the same folders.

If interrupted, run setup again with the same games and folders to continue.
The build folder is under Advanced. Keep its path short, such as C:\TSBuild.
Keep that folder if you want to resume or repair without rebuilding everything.
Existing game installations remain unchanged. Repair preserves your demo profile.

Playing
Click Play when setup finishes, or use Play Twilight Souls.cmd in the installation
folder. Both Hyrule and Lordran are available. Lordran includes the Undead Asylum
and Firelink Shrine, with adjoining areas visible as scenery. Hyrule is completely
UNTESTED! So your mileage will vary. It may not work at all lol!

Link starts with the Ordon, Hero, Zora, Magic and Elite Knight armour sets. Fashion up!

It uses a separate profile from other Dusklight installations. Do NOT try to mix normal
Dusklight saves with Twilight Souls, they will probably end up corrupted.

Troubleshooting
Click Details to see setup's current steps. If setup fails, click Open Log and
keep that log when reporting the problem. It includes paths to the tool logs.
If armour validation fails, setup automatically adds an armour comparison to
this same log. Send the complete log, rather than a screenshot of its last line.
Keep the build folder so completed steps can be reused.
Setup repairs the older armour texture check automatically. PNG compression
and metadata can vary across PCs. Texture validation compares decoded pixels
and dimensions, including transparency. Use the same folders to resume.
Run setup again with the same folders after resolving the reported problem.
If setup reports a damaged download, download the setup executable again.
Older ZIP releases must be extracted afresh into a short folder such as
C:\TSSetup if Windows skipped long paths. Moving an incomplete folder cannot
restore files that were skipped.
If things continue to not work, please reach out on the Discord server for technical support.
The Discord link is https://discord.gg/bDaJ6apCT

Don't share the installed game or build folder. They contain files extracted
from your copies of Twilight Princess and Dark Souls Remastered.
