mirror of
https://github.com/tangerineturtle1/NX2navi.git
synced 2026-11-16 11:49:59 -04:00
A new launcher.json starts with sounds at low instead of off, and a value the file cannot hold falls back to low too (launcher/ui/sound.py DEFAULT_LEVEL). The player can still pick Off, Medium or High in Customize Launcher. The sounds are still only the game's select and back sounds, read from the player's own game. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
64 lines
3.5 KiB
Python
64 lines
3.5 KiB
Python
"""data/launcher.json: the player's choices and what the launcher remembers between runs."""
|
|
import json
|
|
import os
|
|
import shutil
|
|
from pathlib import Path
|
|
|
|
DEFAULTS = {
|
|
'game_dir': '', # the built game; empty until the first install picks one
|
|
'dump': '', # the .nup (or the folder with exefs/ and romfs/) the game was built from
|
|
'auto_check': True, # look for a new version when the launcher opens, and every hour while it runs
|
|
'auto_install': True, # install a downloaded update by itself whenever the game is not running
|
|
'channel': 'stable', # 'stable' or 'preview' (GitHub pre-releases)
|
|
'hide_while_playing': True, # hide the window while the game runs, show it again when it exits
|
|
'keep_cache': True, # keep build-cache/ (the lift and objects) so an update recompiles only changes
|
|
'desktop_shortcut': True,
|
|
'save_export_dir': '', # where Saves > Export Save writes its zip; empty: the Downloads folder
|
|
'export_with_log': True, # Export Save adds the game's latest log and nx2navi.ini (for a bug report)
|
|
'theme': 'kokiri', # the colour scheme (launcher/ui/art.py THEMES)
|
|
'background': '', # the picture the player chose as the background; its fitted copy is data/background.npy
|
|
'background_dim': 40, # how much that picture is darkened, in percent
|
|
'animations': True, # the cursor glides, screens slide in, sparks drift, Navi bobs
|
|
'sounds': 'low', # the game's select and back sounds: off, low (sound.py DEFAULT_LEVEL), medium, high
|
|
'feed_repo': '', # owner/name overriding feed.json, for testing a fork's releases
|
|
'github_token': '', # only for a private release repository; stored as plain text
|
|
'last_check': 0.0,
|
|
'last_seen': '', # the newest version the player was told about
|
|
'rolled_back': '', # the last version that failed to start; it is never downloaded or installed by itself
|
|
}
|
|
|
|
|
|
class Settings(dict):
|
|
def __init__(self, path):
|
|
super().__init__(DEFAULTS)
|
|
self.path = Path(path)
|
|
self.unreadable = False # the file is there but is no JSON; a copy of it is kept as launcher.json.bad
|
|
try:
|
|
# utf-8-sig: the docs ask players to edit the file by hand, and an editor may save it with a BOM
|
|
data = json.loads(self.path.read_text(encoding='utf-8-sig'))
|
|
if isinstance(data, dict):
|
|
self.update({k: v for k, v in data.items() if k in DEFAULTS and type(v) is type(DEFAULTS[k])})
|
|
except OSError:
|
|
pass
|
|
except ValueError:
|
|
# a typo made by hand: keep what the player wrote before the next save() replaces it with the defaults
|
|
self.unreadable = True
|
|
try:
|
|
shutil.copyfile(self.path, self.path.with_name(self.path.name + '.bad'))
|
|
except OSError:
|
|
pass
|
|
|
|
def save(self):
|
|
self.path.parent.mkdir(parents=True, exist_ok=True)
|
|
tmp = self.path.with_name(self.path.name + '.tmp')
|
|
tmp.write_text(json.dumps(dict(self), indent=1), encoding='utf-8')
|
|
os.replace(tmp, self.path)
|
|
|
|
def reset(self):
|
|
"""Default Settings: the choices go back to their defaults; the game folder, dump and history stay."""
|
|
keep = {k: self[k] for k in ('game_dir', 'dump', 'last_check', 'last_seen', 'feed_repo', 'github_token',
|
|
'rolled_back')}
|
|
self.clear()
|
|
self.update(DEFAULTS)
|
|
self.update(keep)
|