Skip to content

Installed mod folders: one Settings > Mods toggle per finished mod, any platform - #77

Merged
schindlershadow merged 1 commit into
mainfrom
mod-folders
Nov 16, 2026
Merged

schindlershadow merged 1 commit into
mainfrom
mod-folders

Conversation

@schindlershadow

Copy link
Copy Markdown
Owner

A folder in the mods directory with a mod.json and an install/ folder (files at their game paths) is one mod. While its mod.json does not say "enabled": false, install/ is one more mods root: its files override the game's (loose files in win), its textures/ joins the texture pack, its obj/ counts for the model budget. The Settings > Mods page already listed such folders and flipped enabled; until now only run.sh's charmod build acted on it, so a mod could not be switched on Android or a release install.

Tested: desktop (on: overrides + texture pack + raised model budget; off: retail) and RP6 APK ("mod folder on" in the log, the mod in game).

Release notes

  • Mods: a finished mod folder in the mods folder can be turned on and off in Settings > Mods, also on Android.

🤖 Generated with Claude Code

…ny platform

A folder in the mods directory with a mod.json and an install/ folder
(files at their game paths) is one mod. While its mod.json does not say
"enabled": false, install/ is one more mods root: its files override the
game's like loose files (loose files in <mods> win), its textures/ joins
the texture pack, its obj/ counts for the model budget prescan. A folder
with a mod.json is never read as part of the loose-file tree.

The Mods page already lists such folders and flips "enabled" in their
mod.json; until now only run.sh's charmod build acted on it, so a mod
could not be switched on Android or a release install.

- hooks_io.cpp: mod_roots() (enabled folders' install/), passed to the
  package index as extra dirs; texture pack extra dirs provider
- package_mods.cpp walk(): skip folders that hold a mod.json
- hooks_models.cpp: budget prescan covers the mod folders' obj/
- psp_tex_pack: psp_texpack_set_extra_dirs_provider; ids found only in
  an extra dir load from it (the main pack wins on the same id)
- docs: loose-file-mods.md, mods/README.md, ARCHITECTURE.md

Tested on the desktop (Vulkan): a folder with 9 models + a 4096 px
texture: on = overrides + "[TEXPACK] mod folder pack", model budget
raised; "enabled": false = retail models, nothing from the folder.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@schindlershadow
schindlershadow merged commit 68ea2b1 into main Nov 16, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant