# LanMecca SWG External Access

## Download client
- Preferred web portal: `https://chat.lanmecca.net/swg/`
- Direct web zip: `https://chat.lanmecca.net/swg/LanMecca_SWG_Client.zip`
- Direct Titan fallback zip: published as `fallback_client_zip_url` in `https://chat.lanmecca.net/swg/release.json`
- Current direct fallback last verified on 2026-03-09: `http://136.58.111.91:8088/LanMecca_SWG_Client.zip`

## Install (Windows)
1. Download `LanMecca_SWG_Client.zip`.
2. Extract to any folder (for example `C:\Games\LanMecca_SWG`).
3. Run root `LAUNCH_LANMECCA.bat` (GUI-first).

## Connect modes
- LAN/local play: use GUI default profile or `LAUNCH_LANMECCA.bat play`
- WAN/external play: `LAUNCH_LANMECCA.bat external`
- WAN IP/host edit: `LAUNCH_LANMECCA.bat setip`

## Update behavior
- First-run updater is non-blocking (it initializes release marker and continues).
- Force full package sync anytime: `LAUNCH_LANMECCA.bat update`

## Version tracking
- Release manifest: `https://chat.lanmecca.net/swg/release.json`
- Version metadata: `https://chat.lanmecca.net/swg/lanmecca_versions.json`
- Host-side version command:
  - `sudo /usr/local/sbin/swg_set_versions.sh --launcher <launcher-version> --server <server-version>`
  - `sudo /usr/local/sbin/swg_set_versions.sh` (show current)

## Notes
- Titan now keeps the public fallback download URL aligned with the current WAN IP, but gameplay endpoint auto-switching is gated behind `SWG_PUBLIC_ENDPOINT_MODE=WAN` in `/etc/lanmecca/swg_public_endpoint.env`.
- Titan currently defaults to `LAN` endpoint mode so local MX/LAN clients do not stall at character select when the galaxy address points at the public IP.
- To pin SWG to a stable DNS or DDNS host later, set `SWG_PUBLIC_ENDPOINT_HOST=<hostname>` and switch `SWG_PUBLIC_ENDPOINT_MODE=WAN`.
- Manual override still works on Titan:
  - `/usr/local/sbin/swg_set_public_endpoint.sh <public-ip-or-host>`
- Router/NAT forwarding still required for WAN play:
  - `44453/udp`, `44462/udp`, `44463/udp`, `44455/tcp`