Skip to content

Commit

Permalink
Merge pull request #39 from RWELabs/release-alpha
Browse files Browse the repository at this point in the history
Release alpha to stable
  • Loading branch information
RyanWalpole authored Apr 20, 2022
2 parents 2200607 + 7926278 commit 6d700bb
Show file tree
Hide file tree
Showing 71 changed files with 2,995 additions and 68 deletions.
124 changes: 100 additions & 24 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,45 +1,121 @@
<img height=50% src="https://github.com/RyanWalpoleEnterprises/Stardew-Valley/raw/release-stable/web/SDVMM_Logo.png?raw=true">
<p align="center">
<img height=300px src="https://github.com/RyanWalpoleEnterprises/Stardew-Valley/raw/release-stable/web/SDVMM_Logo.png?raw=true">
</p>

# Stardew Valley Mod Manager

| ![image](https://raw.githubusercontent.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/release-stable/web/Srelease-stable.png) | ![image](https://raw.githubusercontent.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/release-stable/web/Srelease-alpha.png) | ![image](https://raw.githubusercontent.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/release-stable/web/Srelease-development.png) |
|-------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|
| <b>Latest Stable:</b><br>[v220401](https://github.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/tree/release-stable) | <b>Latest Test Build:</b><br>[v220401](https://github.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/tree/release-alpha) | <b>Latest Developer Build:</b><br>[v220401](https://github.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/tree/development) |
The Stardew Valley Mod Manager and Modded Framework is an extension to SMAPI, the open-source modding framework API for Stardew Valley that lets players play the game with mods. Much alike SMAPI, The Stardew Valley Mod Manager does not edit or change any of the core game files and is installed as a completely separate executable to both the main game and the SMAPI launcher. This powerful new application allows you to do a variety of different operations pertaining to mod management and game save management. See "Features" for more information about the different things you can do with the Stardew Valley Mod Manager.

## Table of Contents

The Stardew Valley Mod Manager and Modded Framework is an extension to SMAPI, the open-source modding framework API for Stardew Valley that lets players play the game with mods. Much alike SMAPI, The Stardew Valley Mod Manager does not edit or change any of the core game files and is installed as a completely separate executable to both the main game and the SMAPI launcher. The Stardew Valley Mod Manager was designed and built with the following functions in mind:
- [Features](#features)
- [How-To/Documentation](#documentation)
- [Download and Install](#download-and-install)
- [Using the Mod Manager](#usage)
- [License](#license)
- [Download](#download)
- [System Requirements](#system-requirements)
- [Windows Download](#windows-download)
- [Branches](#branches)

1. <b>Install and Remove Mods</b>
Use the Stardew Valley Mod Manager to quickly install mods from Nexus. Simply select the mod (in .zip file format) and let the Mod Manager do the rest of the work. Similarly, uninstall mods with a single click.
## Features
The Stardew Valley Mod Manager comes with a plethora of features pertaining to mod management and game save management.

2. <b>Disable and Enable Installed Mods</b>
1. <b>Installing Mods</b>
Once you have downloaded your mod from NexusMods, all you need to do is open the Stardew Valley Mod Manager, click "Install Mods" then "Add New Mods (.zip)" and select your ZIP file downloaded from NexusMods. Once the Mod Manager has installed your mod, it will be automatically added to your Disabled Mods List, from which you can enable the mod.

2. <b>Uninstalling Mods</b>
Mods can be removed just as easily as they can be installed. Simply disable the mod (if it was enabled) and click the Delete button. Or simply disable the mod and enable it at a later date.

3. <b>Disable and Enable Installed Mods</b>
Have mods be disabled without having to delete them entirely. With a click of a button you can move a mod from disabled to enabled and back to disabled. Disabled mods will remain on your system but will not be active when you launch your modded save.

3. <b>Mod Presets</b>
Create mod presets so you can quickly mass enable and disable groups of mods depending on what save you're playing, making mod management that much better.
4. <b>Check Mod Updates (Beta)</b>
With just a few clicks you can check if a compatible mod is currently up to date. Simply open the "Check for Mod Updates [Beta]" window from the Mod Management screen, select your mod and click "Check for Updates". If the mod is compatible, you'll be able to see if the mod is up to date, and if it isn't, get a link to download the new version.*

5. <b>Save and Load Mod Presets</b>
Create mod presets so you can quickly mass enable and disable groups of mods depending on what save you're playing, making mod management that much better. By default, the Stardew Valley Mod Manager comes with a Default preset that includes only SMAPI default mods. Easily revert back to a clean slate with just a few clicks.

4. <b>Quick Modpack Install</b>
Install entire modpacks with just a single file. Simply install the .sdvmp file and let the Mod Manager find the mods, make sure you're running the minimum SMAPI version or above and even let the program create you a preset with the mods defined for the modpack. It's never been easier to install a collection of mods.
6. <b>Modpack Installer</b>
Install entire modpacks with just a single file. Simply install a .sdvmp file and let the Mod Manager find the mods, make sure you're running the minimum SMAPI version or above and even let the program create you a preset with the mods defined for the modpack. It's never been easier to install a collection of mods.

5. <b>Backup and Manage Game Saves</b>
7. <b>Backup and Manage Game Saves</b>
Create backups and delete any of your farms with built in Game Save Management tools.

6. <b>Check Mod Updates (Beta)</b>
Check compatible mods to see if you have the latest version installed*
*Please note that for a mod to be compatible, it must be configured with NexusMod update keys among some other specific criteria. For more information, [click here](https://github.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/wiki/How-To:-Check-a-Mod-for-Updates-(Beta))

## Documentation
### Download and Install
Simply [download](#download) the latest release of Stardew Valley Mod Manager from this repository and follow the installation prompts. From there, you can keep your Mod Manager updated with the built in update check tools. Please note that you may have trouble with Chrome, Edge and Windows trying to block you from installing the application as it is not a commonly downloaded application.

- [How-To: Downloading Stardew Valley Mod Manager](https://github.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/wiki/How-To:-Downloading-Stardew-Valley-Mod-Manager)
- [How-To: Setting Up Stardew Valley Mod Manager](https://github.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/wiki/How-To:-Setting-Up-Stardew-Valley-Mod-Manager)
- [How-To: Updating Stardew Valley Mod Manager](https://github.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/wiki/How-To:-Updating-Stardew-Valley-Mod-Manager)

*For more information on mod update check compatibility, [click here](https://github.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/wiki/How-To:-Check-a-Mod-for-Updates-(Beta))
### Using the Mod Manager
To make it easy for you to access, we've established a Wiki that contains a variety of "How-to" articles that outline and explain features and processes. We've got a couple of articles you can access here, or you can click "Visit our Wiki" to see more.

## How To
Access a series of helpful articles and how-to guides for how to download, install and use the Stardew Valley Mod Manager.

[Visit our Wiki](https://github.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/wiki)
- [How-To: Install a Mod](https://github.com/RyanWalpoleEnterprises/Stardew-Valley/wiki/How-To:-Add-and-Remove-Mods#adding-mods)
- [How-To: Uninstall a Mod](https://github.com/RyanWalpoleEnterprises/Stardew-Valley/wiki/How-To:-Add-and-Remove-Mods#removing-mods)
- [How-To: Backup a Game Save](https://github.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/wiki/How-To:-Create-a-Game-Save-Backup)
- [How-To: Create a Mod Preset](https://github.com/RyanWalpoleEnterprises/Stardew-Valley/wiki/How-To:-Create-Mod-Presets)
- [How-To: Load a Mod Preset](https://github.com/RyanWalpoleEnterprises/Stardew-Valley/wiki/How-To:-Load-Mod-Presets)

Or for more articles and information, [Visit our Wiki](https://github.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/wiki)

## License
It's your responsibility to read the license agreement when installing the software if you intend on using it as much as it's our responsibility to do our best to show it to you.
If you're modifying and/or downloading the source code, however, your responsibility to understand what you are and are not permitted to do become even more of a big deal - and it's your responsibility. Please familiarise yourself with our [license agreement](https://github.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/release-stable/LICENSE.md) before even downloading a copy of the source code.

## Download
Download the most recent version of Stardew Valley Mod Manager by visiting our releases page.
Once you've downloaded and installed the application for the first time, you'll be able to check (and download) new updates directly from the program!

[View Latest Release](https://github.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/releases/latest) | [View All Releases](https://github.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/releases)
### System Requirements
<hr>

#### Recommended Specifications
<b>Operating System</b>
- Designed for Windows 11
- Windows 10 Compatible

<b>Hardware Requirements</b>
- 300mb Disk Space
- 150mb Disk Space for Installation
- 50mb Disk Space for Download
- 100mb Disk Space for In-App Downloads

<hr>

#### Minimum Specifications
<b>Operating System</b>
- Windows 7 or above (Untested)

<b>Hardware Requirements</b>
- 200mb Disk Space
- 150mb Disk Space for Installation
- 50mb Disk Space for Download

<hr>

### Windows Download
Download the most recent version of Stardew Valley Mod Manager by visiting our releases page. Once you have downloaded Stardew Valley Mod Manager and installed the application, you can keep it up to date from within the application, never needing to return to this repository (as of v220401). We recommend downloading our latest release, as it is the most stable release with the most features.

- [View Latest Release](https://github.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/releases/latest)
- [View All Releases](https://github.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/releases)

#### Need Help?
If you're running into any issues with downloading or installing the application, see [download and installation help](#download-and-install.)

## Branches

Please see a list of branches for this repository:

<p align="left" style="margin-bottom: 0px !important;">
<a href="https://github.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/tree/release-stable">
<img src="https://raw.githubusercontent.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/release-stable/web/Srelease-stable.png" alt="Stable Release" align="left">
</a>
<a href="https://github.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/tree/release-alpha">
<img src="https://raw.githubusercontent.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/release-stable/web/Srelease-alpha.png" alt="Alpha Release" align="left">
</a>
<a href="https://github.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/tree/development">
<img src="https://raw.githubusercontent.com/RyanWalpoleEnterprises/Stardew-Valley-Mod-Manager/release-stable/web/Srelease-development.png" alt="adf" align="left">
</a>
</p>
Binary file modified source-code/Mod Manager/.vs/Mod Manager/v16/.suo
Binary file not shown.
Binary file added source-code/Mod Manager/.vs/Mod Manager/v17/.suo
Binary file not shown.
5 changes: 4 additions & 1 deletion source-code/Mod Manager/Stardew Mod Manager/App.config
Original file line number Diff line number Diff line change
Expand Up @@ -41,14 +41,17 @@
<value />
</setting>
<setting name="Version" serializeAs="String">
<value>220401</value>
<value>220402</value>
</setting>
<setting name="CheckUpdateOnStartup" serializeAs="String">
<value>TRUE</value>
</setting>
<setting name="CancelDownload" serializeAs="String">
<value>False</value>
</setting>
<setting name="IsUpdateModInactive" serializeAs="String">
<value>False</value>
</setting>
</Stardew_Mod_Manager.Properties.Settings>
</userSettings>
</configuration>
Loading

0 comments on commit 6d700bb

Please sign in to comment.