# Launcher

Launcher updates, diagnostics and troubleshooting.

# Launcher Crash Logs & Self-Healing

## What's New
Launcher v4.1.12 added one-click crash log sharing and automatic file repair.

## Copy and Share Crash Logs
1. Open the launcher and scroll the right-hand panel to **Diagnostics & Crash Logs**.
2. Click **Copy Latest Crash Logs**. The newest crash report (`.txt`) and memory dump (`.mdmp`) are copied and a confirmation appears.
3. Paste with `Ctrl+V` into the support or bug-report channel of the SWG Secura Discord, with a note on what you were doing.

The **Open Folder** button next to it opens your game folder in Explorer.

## Automatic Self-Healing
| Problem | What the launcher does |
|---|---|
| Missing or quarantined game files | Re-downloads them during the update check |
| Missing or corrupt `user.cfg` | Generates a fresh one |
| Invalid install path (shell shortcut or GUID path) | Cleans it; if unreachable, falls back to the default folder in your user profile |

## FAQ and Known Details
**What is in a crash log?** Client version, OS and hardware or driver info, the error code, and a call stack. Passwords and private files are not included.

**"No recent crash logs found"?** A dump is only created on an abnormal crash; a normal exit or Task Manager kill leaves none. Also confirm the launcher Install Directory is the folder your client runs from.

# Launcher Update Reliability (4.1.9)

## What's New in 4.1.9
- **Stable downloads**: fixes for large downloads disconnecting early ("curl 18" and unpack errors).
- **Stale lock cleanup**: aborted downloads no longer leave a lock file that blocks retries or **Check Client**.
- **Faster verification**: updates use direct binary indexing instead of unpacking loose files.
- **Auto-recovery**: after a network drop the launcher stops lingering tasks, cleans temporary files and retries.

## How to Update
1. Start the launcher; it checks for launcher and game updates automatically.
2. If an update was stuck, click **Check Client** (bottom left). Locks are cleared and downloads resume.
3. When the bar reaches 100% and shows **Asset synchronization complete**, **Play** unlocks.

## FAQ and Known Details
**"shallow.lock: File exists"?** Update the launcher and click **Check Client**.

**Do I redownload everything?** No, only missing or incomplete files.

**Still stuck?** Open a ticket in the SWG Secura Discord or the BetaHub tracker and include your launcher logs.

# Unified Game Directory & Fast Server Switching

## What's New
Live and Test now share one game folder, so switching servers is faster and uses far less disk space.

- **One install**: the default folder is `SWGNge_Public` in your user profile. No second 10 GB copy is needed.
- **Fast switching**: choosing **Live** or **Test** in the launcher only updates the files that differ.
- **Settings kept**: keymaps, chat colors, macros, UI positions and graphics settings survive a switch.
- **Login settings kept**: auto-login username, avatar name and 4K UI mode carry over.

## FAQ and Known Details
<p class="callout info">[NOTE] You can change the install folder in the launcher; an invalid path falls back to the default.</p>

# Launcher 4.2.8 - Live Logs, Sync Client and Per-Server Characters

<p class="callout success">[Completed] Released on Live. Launcher 4.2.8 updates itself the next time you start it.</p>

## What's New in 4.2.8
- **Live Launcher Logs**: the log panel now updates on its own. The last lines of the startup sync ("Configured login.cfg ..." and "Game files are up to date and ready to play.") no longer wait for you to click something before they appear.
- **Sync Client**: the **Check Client** button is now called **Sync Client**. It runs the same sync the launcher does at startup, for the server you have selected.
- **Remembered character per server**: the launcher remembers your auto-login character separately for Live, Test, Development and Experimental.

## How to use Sync Client
1. Pick your server in the launcher.
2. Click **Sync Client** (bottom left). The launcher checks for a newer launcher version, then updates that server's game files.
3. Watch the Launcher Logs. You will see a "Sync Client requested" line and a result line when it finishes.
4. When the logs say the game files are up to date, **Play Game** unlocks.

Sync Client is available whenever the launcher is idle, including after a failed sync, so you can simply try again. It is greyed out while a sync or a launcher update is running.

## Character memory per server
| Server | Remembered separately |
|---|---|
| Live | Yes |
| Test | Yes |
| Development | Yes |
| Experimental | Yes |

- Choose **None (Select at Login Screen)** on a server and the launcher keeps that choice. It will not pick a character for you on that server later.
- If you used an older launcher, your previous choice is carried over once for each server.
- Switching servers now switches to the character you chose for that server.

## FAQ
**Do I need to download anything?** No. The launcher updates itself on start.

**Is Sync Client different from Check Client?** Same sync, new name. It is now also usable after a failed sync.

**Does Sync Client redownload everything?** No, only missing or changed files.

**The log looked stuck before.** That was the display not refreshing. Update to 4.2.8.

**Still stuck?** Open a ticket in the SWG Secura Discord or the BetaHub tracker and include your launcher logs.

# Launcher 4.3.1 - Galaxy Resources and Cleaner Server Details

<p class="callout success">[Completed] Released on Live. Launcher 4.3.1 updates itself the next time you start it. Requires nothing else from you.</p>

## What's New in 4.3.1
- **Resources for both galaxies**: the Resources screen now has a **Secura Horizon / Secura Origins** selector. Each galaxy has its own resource spawns, so pick the galaxy you play on to see what is actually available there.
- **Cleaner Server and Launcher Details**: the details panel now lists everything in a clear order: Live Login Server Status, Secura Horizon game server status, Secura Origins game server status, Secura Horizon population, Secura Origins population, then the Launcher Version.

## How to check resources
1. Open the launcher and go to **Resources**.
2. Use the selector at the top to choose **Secura Horizon** or **Secura Origins**.
3. Browse or search the list as usual.

The launcher remembers your choice until you close it. If the data cannot be loaded, the screen says the resources are unavailable right now; try again in a minute.

<p class="callout info">[NOTE] The same selector is on the website Resources page. There your choice is remembered per browser.</p>

## FAQ

**Are the resources the same on both galaxies?**
No. Each galaxy has its own spawns, and only a handful of resource names appear on both. Always check the galaxy you are playing on.

**Where can I read about Secura Origins?**
See [Secura Origins](/link/186).