﻿Better Super Mario Sunshine (BSMSO) v2.0

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

License:
- GPL-3.0 works in this package (BSE, Moveset, _BSMSO.kxe). See LICENSE and
  SOURCE_OFFER.txt. You must own Super Mario Sunshine / Eclipse.

Quick start:
1. Extract the whole zip folder (do not run files from inside the archive).
2. Double-click BSMSO.Launcher.exe.
3. In Settings, set your username, Dolphin path, and Game ISO (clean NTSC-U SMS
   or your Eclipse workspace - you must own the game).
4. Settings -> Game modules -> Install BSE + online (Kuribo / BSE / _BSMSO.kxe).
5. 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 (zip root):
- BSMSO.Launcher.exe - start the launcher
- _BSMSO.kxe / BetterSunshineEngine.kxe / BetterSunshineMoveset.kxe - game modules
- LICENSE / SOURCE_OFFER.txt - licensing and source offer
- CustomModels\ / CustomStages\ - bundled packs
- BSMSO.Launcher\ - app runtime (leave this folder next to the exe)
- server\ - optional dedicated server (BSMSO.ServerHost.exe)

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