Sunshine Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Sunshine Alley Game Launcher ======

The **Sunshine Alley Game Launcher** is designed to manage and enhance your gaming experience by keeping mods organized and up-to-date. This guide will walk you through the various features and functionalities of the launcher.

{{:software:launcher_main.png?nolink&400|Main Launcher Screen}}

===== Features =====
The Sunshine Alley Game Launcher provides a streamlined and organized way to manage your game mods and configurations, ensuring a seamless gaming experience.
===== Select a World =====
There is a drop down box to select which World you want to play in.  See [[worlds:worlds|Worlds]]\\

If you are new to Sunshine Alley the only one you can enter will be a progression Server.\\
If there is more than one Progression server shown, Check Discord as to which one is appropriate for you.
==== Mod Management ====
  * **Up-to-Date Mods**: The launcher ensures that all mods used by the Sunshine Alley servers are kept up-to-date.
  * **Separate Mod Installation**: Mods are installed separately from the user's game files, ensuring that personal plugins for solo play are not affected.
  * **Server-Specific Mod Packs**: The mod pack is selected based on the server chosen from the dropdown menu.
  * **Optional Mods Interface**: Accessible by clicking on the label showing the number of optional mods enabled, allowing easy addition or removal of optional mods.

{{ :software:launcher_optionalmods.png?nolink&400 |Optional Mods Interface}}
==== Configuration and Setup ====
  * **Default Install Directory**: The launcher installs by default in the user's AppData/Local directory, following Windows standards.
  * **Customizable Config Files**: Users can manually customize config files for keybinds and other settings without the launcher overwriting these configurations.
  * **Access Config and Mod Log Files**: Clicking the folder icon in the launcher provides access to the config files and mod log files for the selected server/modpack.

==== Setup Window ====
  * **Repair Function**: Erases all files, user configurations, caches, and registry entries, and reinstalls everything from scratch.
  * **Uninstall Function**: Deletes all files related to the launcher.
  * **Shortcuts**: If you only need shortcuts, select "I just want shortcuts".


{{ :software:launcer_setup.png?nolink&400 |Setup Window}}
==== Additional Features ====
  * **Persistent Checkbox**: When checked, the game will launch with the current server/modpack setup without needing to start the launcher.
  * **Steam Integration**: Checking the Steam box allows the game to use Steam's launch method, preserving Steam overlay features like screenshots.
  * **Change Game Location**: Users can change the game location by clicking the label that displays the game's install directory.
  * **Progression Server for New Players**: Only the Progression Server is available initially. Additional servers become available after the launcher is recognized by the game server once the user has logged in with any character.
  * **Auto-Update**: The launcher automatically updates itself to the latest version.
  * **Status Text Interaction**: Clicking on the status text, such as "File scan complete", provides additional options and information.

===== Usage Guide =====

  - **Launch the Game**: Open the Sunshine Alley Launcher.
  - **Select a Server**: Choose the desired server from the dropdown menu.
  - **Manage Mods**: Click on the label showing the number of optional mods to add or remove mods as needed.
  - **Check Persistent Option**: If you want to skip the launcher next time, check the Persistent box.
  - **Launch with Steam**: Check the Steam box if you want to use Steam's launch method.
  - **Change Install Location**: Click on the game's install directory label to change the location if necessary.
  - **Access Config Files**: Click the folder icon to open config and mod log files.
  - **Setup Options**: Click Setup to repair or uninstall the launcher.

===== Setup Instructions =====
  - **Download**: Download the launcher from [[https://discord.gg/VSPYkATZJ7|Discord]] under **#server-info**. The [[:titles|Viking]] role is required to download the launcher.
  - **Run**: Run the downloaded executable.
  - **Options**: You can use the preselected install location or choose your own. A desktop shortcut is recommended; you can move this to any other location you want after the installation is complete.
  - **Install**: The executable will copy itself into the install location where it will restart to download all required mods.
  - **Installation File**: You can safely delete the downloaded executable and use the desktop shortcut provided by the installer. Starting the launcher from the downloaded executable should be avoided as it is never kept up to date.