﻿Better Super Mario Sunshine (BSMSO) v1.1

Better Super Mario Sunshine (BSMSO) is online multiplayer for Super Mario Sunshine
via Dolphin Emulator and Better Sunshine Engine (BSE).

Quick start:
1. Run BSMSO.Launcher.exe.
2. In Settings, set your username, Dolphin path, and game ISO path (extracted folder or .iso/.gcm).
3. Settings -> Game modules -> Install / patch modules.
   Requires an original Super Mario Sunshine copy with nothing installed on it.
   This installs the full Better Sunshine Engine / Kuribo runtime:
   Kuribo!\System\ (KuriboKernel.bin), BSE-patched sys\main.dol and sys\boot.bin,
   BetterSunshineEngine.kxe, BetterSunshineMoveset.kxe, and _BSMSO.kxe. (.gcz is not supported.)
   It also overlays title/UI archives (nintendo.szs, option.szs) into files\data\.
4. Launch Dolphin, enter a stage, then Host Server or Connect.

Custom models:
- CustomModels\ ships with this zip. The launcher syncs them into your AppData
  library on launch (overwriting older bundled packs) and into the game folder
  when modules are installed / when a game path is set, so the Mario model
  dropdown matches this release.

Important files:
- BSMSO.Launcher.exe - main BSMSO launcher app
- BSMSO.ServerHost.exe - optional dedicated server host (in server\)
- BetterSunshineEngine.kxe - official BSE release module (required parent; also installed by the launcher)
- BetterSunshineMoveset.kxe - Better Sunshine Moveset module (installed with the other .kxe files)
- _BSMSO.kxe - BSMSO game module (loads after BSE)
- CustomModels\ - bundled character packs (Shadow Mario, Luigi, Needle, etc.)
- assets\ - level data + disc UI overlays (assets\data\nintendo.szs, option.szs)
- server\ - headless dedicated server host

Default port: 27015 (TCP + UDP).
Do not run SMSCoop alongside BSMSO.
