Difference between revisions of "Technical help"

From Summertime Saga Wiki
Jump to: navigation, search
m (Compatibility)
m (Naming a save file)
 
(15 intermediate revisions by the same user not shown)
Line 1: Line 1:
Because players regularly ask for support, this article aims to cover the main technical issues. For the story‐related blockings of the game, please follow to the [[walkthrough]]s available on the wiki.
+
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>
Line 14: Line 14:
 
== 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. The data are persistent and are only deleted by clicking {{button|Clear Persistent}} button in settings or cookie jar menus. The {{strong|save game files}} contain your progress in the game: with each new savegame created, a new individual file is generated.
+
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 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.
+
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 a better compatibility and prevent conflicts with running events, it’s advisable to load a save done on the town map.
+
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:''' <code><SS-game-folder>\game\saves</code> and <code>%AppData%\RenPy\SummertimeSaga</code> (two locations can coexist)
+
{|
* '''Android:''' <code>Android/data/com.kompasproductions.summertimesaga/files/saves</code>
+
|-
* '''Mac:''' <code>~/Library/RenPy/SummertimeSaga</code> (folder may be hidden)
+
|
* '''Linux:''' <code><SS-game-folder>/game/saves</code> and <code>$HOME/.renpy/SummertimeSaga</code> (two locations can coexist)
+
* '''Windows:'''
* '''Other:''' <code>%USERPROFILE%\.renpy\SummertimeSaga</code>
+
| {{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 at both save locations, please replace both.}}
+
{{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 by following these steps:
 
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. Official save file may be provided on the official ''Summertime Saga'' website exclusively.
+
# 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 <code>saves</code> folder if it does not yet exist.
+
# 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 display the correct loading page. Then click on the thumbnail corresponding to the downloaded save file.
+
# 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: <code>1-1-LT1.save</code>
+
Save files look like: {{kbd|1-1-LT1.save}}
  
The naming format is as follows <code>pageNumber-pageSlotNumber-LT1.save</code>. For example, <code>2-3-LT1.save</code> is the save file for the 3rd slot on the 2nd page. <code>2-3-LT1 (1).save</code> is not a valid save file. In this case, the file must be renamed and the last part <code>(1)</code> must be removed to make it valid.
+
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 ===
  
Quick saves are performed directly in‐game thanks to the Q.Save shortcut at the bottom of the screen. Six slots are reserved for them under the tab named Q, inside the load screen. The Q.Load shortcut opens the last one.
+
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 ===
 
=== Auto saves ===
  
The game makes automatic savegames at regular intervals, depending on your progress. The last saves are stored in the tab named A, inside the load screen.
+
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 65: Line 83:
 
# 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'''.
 
# 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, and click on the file which name begins with <code>SummertimeSaga</code> and ends with <code>.apk</code>. Do not install the game on an SD card; the app won’t launch from an external storage.
+
# 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.

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.

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:

  • Windows:
Summertime Saga game folder\game\saves and %AppData%\RenPy\SummertimeSaga (two locations can coexist)
  • Android:
Android/data/com.kompasproductions.summertimesaga/files/saves
  • Mac:
~/Library/RenPy/SummertimeSaga (folder may be hidden)
  • Linux:
Summertime Saga game folder/game/saves and $HOME/.renpy/SummertimeSaga (two locations can coexist)
  • Other:
%USERPROFILE%\.renpy\SummertimeSaga

Moving a save file

Warning red icon.pngIf 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:

  1. Quit the game.
  2. Download the save file. An official save file may be provided on the official Summertime Saga website exclusively.
  3. 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.
  4. Start the game and click on Load Game
  5. 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:

  1. Removed all previous installs of the game.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. When the install is completed, open your app folder.