mirror of
https://github.com/valentderah/totk-pc-recomp.git
synced 2026-11-19 20:25:57 +00:00
One folder per mod as emulators take them: romfs, exefs and cheats folders, the Atmosphere layout and TKMM's output (romfslite counts as romfs). A mod with its own code (subsdk or a replaced main) stays off as a whole, so does one with ExeFS patches until a rebuild applies them; cheat files are listed, not loaded yet. The scan goes through the platform layer, so Linux builds it. probe-mods covers the layouts and the order keys; probe-cfg fails on a key listed twice in the defaults table. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
42 lines
2.6 KiB
C
42 lines
2.6 KiB
C
// Player mods (mods.c): one folder per mod under mods/ next to totk.exe (TOTK_MODS_DIR), unpacked as emulators take
|
|
// them: <mod>/romfs, <mod>/exefs and <mod>/cheats, the Atmosphere layout (atmosphere/contents/<title id>/romfs) or
|
|
// TKMM's merged output (romfs or romfslite, exefs, cheats). The list is scanned once at start (romfs.c overlay_init);
|
|
// its order and switches live in totk.ini [mods] (TOTK_MODS_ORDER: names top first, separated by '|';
|
|
// TOTK_MODS_DISABLED: names switched off). The top mod wins a file two mods replace.
|
|
#pragma once
|
|
#include <stdint.h>
|
|
|
|
enum { MOD_ROMFS = 1, MOD_EXEFS = 2, MOD_SUBSDK = 4, MOD_CHEATS = 8 }; // ModInfo.kind bits
|
|
typedef enum {
|
|
MOD_OK,
|
|
MOD_EMPTY, // no RomFS file, no ExeFS patch, no cheat file
|
|
MOD_PLUGIN, // has code modules (exefs/subsdk*, a replaced exefs/main): the port has no module loader, so the
|
|
// whole mod stays off (its RomFS files may expect that code)
|
|
MOD_EXEFS_LATER, // has ExeFS patches (.ips, .pchtxt): a rebuild of the game code applies them, not yet here; the
|
|
// whole mod stays off until then
|
|
MOD_CHEATS_LATER, // only cheat files, which the port does not load yet
|
|
MOD_BAD_NAME, // its folder name holds '|', the separator of the order keys
|
|
} ModProblem;
|
|
|
|
typedef struct {
|
|
char name[256]; // folder name, UTF-8
|
|
char romfs[2048]; // UTF-8 path of its RomFS root; "" none
|
|
char exefs[2048]; // UTF-8 path of its ExeFS folder; "" none
|
|
char cheats[2048]; // UTF-8 path of its cheats folder; "" none
|
|
int kind, enabled;
|
|
ModProblem problem;
|
|
uint32_t replaced, added, overridden; // romfs.c: files served (replacing / added), files a higher mod serves
|
|
uint32_t other_version; // romfs.c: files for another game version (*.Product.<n>.*), not served
|
|
char overridden_by[256]; // the first higher mod that took one of its files
|
|
} ModInfo;
|
|
|
|
void mods_scan(void); // once; later calls return at once
|
|
const char *mods_dir(void); // the folder scanned (default: <dir of totk.exe>/mods)
|
|
int mods_count(void);
|
|
ModInfo *mods_at(int i); // 0 = top of the order; NULL out of range
|
|
// Menu edits (present path). They change the list mods_at shows and write TOTK_MODS_ORDER / TOTK_MODS_DISABLED with
|
|
// cfg_set; romfs.c used the start state, so they apply at the next start.
|
|
void mods_set_enabled(int i, int on);
|
|
void mods_move(int i, int delta); // -1 up, +1 down; nothing at the ends
|
|
int mods_changed(void); // 1 when the order or a switch differs from the start
|