mirror of
https://github.com/tangerineturtle1/NX2navi.git
synced 2026-11-15 19:19:58 -04:00
b2074499de
The launcher's home has a Saves screen: Export Save writes NX2navi-save-<date>_<time>.zip into Downloads (or a chosen folder) with a manifest, the save the game would load next and, for a bug report, the game's latest log and nx2navi.ini, never a key file; Import a Save checks a zip's manifest, game, paths and CRCs, backs the current save up into the saves folder and replaces it while the game is not running. The game's Game tab has the same exports and an import that waits in profile/save-import and becomes the save at the next start, since the running game would write its progress back over a save replaced under it. The zip code (runtime/save_zip.c) and the import at start are checked without game files by tests/save_zip_check.py and tests/save_share_check.py; the launcher side by its test suite. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
41 lines
2.4 KiB
C
41 lines
2.4 KiB
C
// Sharing a save (save_share.c): the menu's Export writes the save the game would load next into one zip, for a bug
|
|
// report or another player, and its Import checks such a zip and leaves its save for the game's next start
|
|
// (fs_host.c import_pending). The launcher writes and reads the same zip (launcher/saves.py export_save, import_zip).
|
|
#pragma once
|
|
#include <stddef.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef enum {
|
|
SAVE_SHARE_OK,
|
|
SAVE_SHARE_NO_SAVE, // export: the game has not saved yet
|
|
SAVE_SHARE_READ_FAILED, // export: a save file could not be read; import: the zip could not be read
|
|
SAVE_SHARE_WRITE_FAILED, // export: the zip could not be written; import: its save could not be put in place
|
|
SAVE_SHARE_NOT_A_SAVE, // import: not a zip of an NX2navi save (no manifest, another format, no save files)
|
|
SAVE_SHARE_OTHER_GAME, // import: the manifest names another game
|
|
SAVE_SHARE_NEWER, // import: a newer NX2navi made it, in a format this one does not know
|
|
SAVE_SHARE_DAMAGED, // import: a member's data or CRC is wrong
|
|
SAVE_SHARE_UNSAFE, // import: a path outside the save, a link, or far more than a save
|
|
} SaveShareResult;
|
|
|
|
// Writes NX2navi-save-<local date>_<time>[-bug-report].zip into dir (made when missing); bug_report adds this run's
|
|
// log and nx2navi.ini. path gets the zip's path. Never a key file.
|
|
SaveShareResult save_share_export(const char *dir, int bug_report, char *path, size_t cap);
|
|
// Checks the zip at zip_path (manifest, game, paths, sizes, CRCs) and stages its save for the next start. detail gets
|
|
// "<NX2navi version>, <export date>" from its manifest ("?" for what it lacks).
|
|
SaveShareResult save_share_import(const char *zip_path, char *detail, size_t cap);
|
|
int save_share_pending(void); // 1 while an import waits for the next start
|
|
int save_share_cancel(void); // drops the waiting import; 0 on success
|
|
// Where Export writes and Import's file dialog opens: the player's Downloads folder, else the game folder. 0 when
|
|
// neither is known.
|
|
int save_share_default_dir(char *out, size_t cap);
|
|
// A new folder name <game folder>/saves/backup <local date> <time> (with " (2)" and up when taken), the saves folder
|
|
// made; the folder itself is not. Where the launcher keeps the backups of its imports. 0 when it cannot be named.
|
|
int save_share_backup_dir(char *out, size_t cap);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|