Difference between revisions of "Technical help"
From Summertime Saga Wiki
m (→Compatibility) |
m (→Naming a save file) |
||
| (30 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | + | This article aims to cover the main technical issues of the game. For the story‐related blockings, please follow to the [[walkthrough]]s. | |
== System requirements == | == System requirements == | ||
| − | ''Summertime Saga'' is available for Windows, Linux, macOS and Android. iOS builds are not possible due to Apple’s publishing restrictions. The game uses the Ren’Py software engine, which is light on computer system requirements. 2GB of free space is recommended: 1GB is reserved for downloading, another 1GB for the installation and the saves. | + | ''Summertime Saga'' is available for Windows, Linux, macOS, and Android. iOS builds are not possible due to Apple’s publishing restrictions. The game uses the Ren’Py software engine, which is light on computer system requirements. 2GB of free space is recommended: 1GB is reserved for downloading, another 1GB for the installation and the saves. |
<gallery class="center" mode="nolines" heights=75px> | <gallery class="center" mode="nolines" heights=75px> | ||
| − | File:Android logo.png|alt=Android logo|Android 5.0 {{nowrap|or higher}} | + | File:Android logo.png|link=|alt=Android logo|Android 5.0 {{nowrap|or higher}} |
| − | File:Windows logo.png|alt=Windows logo|Windows XP {{nowrap|or higher}} | + | File:Windows logo.png|link=|alt=Windows logo|Windows XP {{nowrap|or higher}} |
| − | File:Linux logo.png|alt=Linux logo|Linux x86/x86_64 | + | File:Linux logo.png|link=|alt=Linux logo|Linux x86/x86_64 |
| − | File:macOS logo.png|alt=macOS logo|macOS X 10.6 {{nowrap|or higher}} | + | File:macOS logo.png|link=|alt=macOS logo|macOS X 10.6 {{nowrap|or higher}} |
</gallery> | </gallery> | ||
== Savegames and persistent data file == | == Savegames and persistent data file == | ||
| − | The {{strong|persistent data file}} contains the scenes you unlocked in the [[cookie jar]], your [[achievement]]s and your preferences. These data are | + | The {{strong|persistent data file}} contains the scenes you unlocked in the [[cookie jar]], your [[achievement]]s and your preferences. These data are kept between games and are only deleted by clicking on the button {{summertimesaga button|color=red|Clear Persistent}} in the settings menu. The scenes can also be cleaned up by clicking on the button {{summertimesaga button|color=red|Reset}} in the cookie jar.<br> |
| + | The {{strong|save game files}} contain your progress in the game: with each new savegame created, a new individual file is generated. | ||
=== Compatibility === | === Compatibility === | ||
| − | The compatibility | + | The compatibility with saves from previous versions results from an effort by the team members. However, it’s not 100% guaranteed because of the many code changes between each stage of development. Therefore, savegames from a too old version cannot be restored and are displayed grayed out with a red icon in the loading menu; savegames dating back to one previous version can be migrated, after a warning message, and appear in sepia color with a yellow icon. |
| − | To ensure | + | To ensure better compatibility and prevent conflicts with running events, it’s advisable to load a save done on the town map. |
=== Directories === | === Directories === | ||
Both savegames and persistent data files are stored in these locations: | Both savegames and persistent data files are stored in these locations: | ||
| − | * '''Windows:''' | + | {| |
| − | * '''Android:''' | + | |- |
| − | * '''Mac:''' | + | | |
| − | * '''Linux:''' | + | * '''Windows:''' |
| − | * '''Other:''' | + | | {{kbd|{{var|Summertime Saga game folder}}\game\saves}} and {{kbd|%AppData%\RenPy\SummertimeSaga}} (two locations can coexist) |
| + | |- | ||
| + | | | ||
| + | * '''Android:''' | ||
| + | | {{kbd|Android/data/com.kompasproductions.summertimesaga/files/saves}} | ||
| + | |- | ||
| + | | | ||
| + | * '''Mac:''' | ||
| + | | {{kbd|~/Library/RenPy/SummertimeSaga}} (folder may be hidden) | ||
| + | |- | ||
| + | | | ||
| + | * '''Linux:''' | ||
| + | | {{kbd|{{var|Summertime Saga game folder}}/game/saves}} and {{kbd|$HOME/.renpy/SummertimeSaga}} (two locations can coexist) | ||
| + | |- | ||
| + | | | ||
| + | * '''Other:''' | ||
| + | | {{kbd|%USERPROFILE%\.renpy\SummertimeSaga}} | ||
| + | |} | ||
=== Moving a save file === | === Moving a save file === | ||
| − | {{ | + | {{message box warning|If the same file exists in both save locations, please replace both.}} |
| − | Save files, whether provided by the game team or by other players, have to be downloaded and moved | + | Save files, whether provided by the game team or by other players, have to be downloaded and moved by following these steps: |
# Quit the game. | # Quit the game. | ||
| − | # Download the save file. | + | # Download the save file. An official save file may be provided on the official ''Summertime Saga'' website exclusively. |
| − | # Move the downloaded file to the location(s) mentioned above; if there are multiple locations, copy to all; create the | + | # Move the downloaded file to the location(s) mentioned above; if there are multiple locations, copy to all; create the {{kbd|saves}} folder if it does not yet exist. |
| − | # Start the game and click on {{button|Load Game}} | + | # Start the game and click on {{summertimesaga button|color=blue|Load Game}} |
| − | # Use the {{button|Previous}} and {{button|Next}} buttons to | + | # Use the {{summertimesaga button|color=blue|Previous}} and {{summertimesaga button|color=blue|Next}} buttons to move to the correct loading page. Then click on the thumbnail corresponding to the downloaded save file. |
=== Naming a save file === | === Naming a save file === | ||
| − | Save files look like: | + | Save files look like: {{kbd|1-1-LT1.save}} |
| − | The naming format is as follows | + | The naming format is as follows {{kbd|{{var|page number}}-{{var|page slot number}}-LT1.save}}. For example, {{kbd|2-3-LT1.save}} is the save file for the 3rd slot on the 2nd page. {{kbd|2-3-LT1 (1).save}} is not a valid save file. In this case, the file must be renamed and the last part {{kbd|(1)}} removed to make it valid. |
=== Quick saves === | === Quick saves === | ||
| − | + | Players can perform a quick save directly in‐game by using the {{summertimesaga button|Q.Save}} shortcut at the bottom of the screen. Six slots are reserved for them under the {{summertimesaga button|color=blue|Q}} tab inside the load screen. The {{summertimesaga button|Q.Load}} shortcut quick loads the last one. | |
| − | === | + | === Auto saves === |
| − | The game makes automatic savegames at regular intervals, depending on your progress. The last | + | The game makes automatic savegames at regular intervals, depending on your progress. The last ones are stored in the {{summertimesaga button|color=blue|A}} tab inside the load screen. |
== Android installation == | == Android installation == | ||
| Line 63: | Line 81: | ||
# Removed all previous installs of the game. | # Removed all previous installs of the game. | ||
# Make sure you have at least 2GB of free space available on your device; 1GB is reserved for downloading, another 1GB is recommended for the installation and the saves. | # Make sure you have at least 2GB of free space available on your device; 1GB is reserved for downloading, another 1GB is recommended for the installation and the saves. | ||
| − | # You may also | + | # You may also disable Google Play Protect: open '''Play Store''' application, tap on '''Menu''' button and select '''Play Protect''' option. Disable the options '''Scan device for security threats'''. |
# Download the last version of ''Summertime Saga'' on the official website exclusively. Private download servers are provided for Patreon contributors. Choose '''ANDROID''' platform and validate. | # Download the last version of ''Summertime Saga'' on the official website exclusively. Private download servers are provided for Patreon contributors. Choose '''ANDROID''' platform and validate. | ||
| − | # Open the download folder of the web browser | + | # Open the download folder of the web browser and click on the file which name begins with {{kbd|SummertimeSaga}} and ends with {{kbd|.apk}}. Do not install the game on an SD card; the app won’t launch from external storage. |
# Enable “Unknown sources” setting on your device: | # Enable “Unknown sources” setting on your device: | ||
#* On Android Nougat or lower: The exact names of the settings entries may vary, but the overall process should be similar. Navigate to your device’s '''Settings''' menu, then look for an entry titled either '''Security''' or '''Lock screen and security'''. Simply tick the box or toggle the switch next to '''Unknown sources''', then press '''OK''' on the popup. | #* On Android Nougat or lower: The exact names of the settings entries may vary, but the overall process should be similar. Navigate to your device’s '''Settings''' menu, then look for an entry titled either '''Security''' or '''Lock screen and security'''. Simply tick the box or toggle the switch next to '''Unknown sources''', then press '''OK''' on the popup. | ||
Latest revision as of 14:27, 24 July 2020
This article aims to cover the main technical issues of the game. For the story‐related blockings, please follow to the walkthroughs.
Contents
System requirements
Summertime Saga is available for Windows, Linux, macOS, and Android. iOS builds are not possible due to Apple’s publishing restrictions. The game uses the Ren’Py software engine, which is light on computer system requirements. 2GB of free space is recommended: 1GB is reserved for downloading, another 1GB for the installation and the saves.
Android 5.0 or higher
Windows XP or higher
Linux x86/x86_64
macOS X 10.6 or higher
Savegames and persistent data file
The persistent data file contains the scenes you unlocked in the cookie jar, your achievements and your preferences. These data are kept between games and are only deleted by clicking on the button Clear Persistent in the settings menu. The scenes can also be cleaned up by clicking on the button Reset in the cookie jar.
The save game files contain your progress in the game: with each new savegame created, a new individual file is generated.
Compatibility
The compatibility with saves from previous versions results from an effort by the team members. However, it’s not 100% guaranteed because of the many code changes between each stage of development. Therefore, savegames from a too old version cannot be restored and are displayed grayed out with a red icon in the loading menu; savegames dating back to one previous version can be migrated, after a warning message, and appear in sepia color with a yellow icon.
To ensure better compatibility and prevent conflicts with running events, it’s advisable to load a save done on the town map.
Directories
Both savegames and persistent data files are stored in these locations:
|
Summertime Saga game folder\game\saves and %AppData%\RenPy\SummertimeSaga (two locations can coexist) |
|
Android/data/com.kompasproductions.summertimesaga/files/saves |
|
~/Library/RenPy/SummertimeSaga (folder may be hidden) |
|
Summertime Saga game folder/game/saves and $HOME/.renpy/SummertimeSaga (two locations can coexist) |
|
%USERPROFILE%\.renpy\SummertimeSaga |
Moving a save file
 | If the same file exists in both save locations, please replace both. |
Save files, whether provided by the game team or by other players, have to be downloaded and moved by following these steps:
- Quit the game.
- Download the save file. An official save file may be provided on the official Summertime Saga website exclusively.
- Move the downloaded file to the location(s) mentioned above; if there are multiple locations, copy to all; create the saves folder if it does not yet exist.
- Start the game and click on Load Game
- Use the Previous and Next buttons to move to the correct loading page. Then click on the thumbnail corresponding to the downloaded save file.
Naming a save file
Save files look like: 1-1-LT1.save
The naming format is as follows page number-page slot number-LT1.save. For example, 2-3-LT1.save is the save file for the 3rd slot on the 2nd page. 2-3-LT1 (1).save is not a valid save file. In this case, the file must be renamed and the last part (1) removed to make it valid.
Quick saves
Players can perform a quick save directly in‐game by using the Q.Save shortcut at the bottom of the screen. Six slots are reserved for them under the Q tab inside the load screen. The Q.Load shortcut quick loads the last one.
Auto saves
The game makes automatic savegames at regular intervals, depending on your progress. The last ones are stored in the A tab inside the load screen.
Android installation
Summertime Saga app for Android devices is not available on Google Play Store. It must be downloaded from the official website then installed manually. Please follow these steps:
- Removed all previous installs of the game.
- Make sure you have at least 2GB of free space available on your device; 1GB is reserved for downloading, another 1GB is recommended for the installation and the saves.
- You may also disable Google Play Protect: open Play Store application, tap on Menu button and select Play Protect option. Disable the options Scan device for security threats.
- Download the last version of Summertime Saga on the official website exclusively. Private download servers are provided for Patreon contributors. Choose ANDROID platform and validate.
- Open the download folder of the web browser and click on the file which name begins with SummertimeSaga and ends with .apk. Do not install the game on an SD card; the app won’t launch from external storage.
- Enable “Unknown sources” setting on your device:
- On Android Nougat or lower: The exact names of the settings entries may vary, but the overall process should be similar. Navigate to your device’s Settings menu, then look for an entry titled either Security or Lock screen and security. Simply tick the box or toggle the switch next to Unknown sources, then press OK on the popup.
- On Android Oreo or higher: When you launch Summertime Saga install file, you’ll be prompted to allow the permission. Tap Settings on the prompt, then toggle the switch next to Allow from this source on the following screen. Hit the back button, then you can resume installation.
- When the install is completed, open your app folder.
