feat: 2.5.1 default xml, improved preset handling, fsmp3 image, dependency guard to prevent config corruption

[KaninHop]

Changes

MCM script (FSMPM.psc)

• Dependency safety: new checkDependencies() verifies JContainers and PapyrusUtil SE at init. If either is missing, the MCM disables itself and shows a "Missing: <dep>" page instead of corrupting configs.xml with empty defaults
• Improved Preset detection on load: configMatchesPreset() compares current config values against the saved preset (or Default.xml as fallback) and clears the preset label if neither matches, so the MCM reflects reality when the XML was edited externally
• Welcome page: OnPageReset("") now loads interface/FSMP/Logo.dds via LoadCustomContent (with early return, matching SkyUI's splash pattern)
• Version upgrade logic: bumped GetVersion() to 302; OnVersionUpdate re-runs init and clears stale preset name on upgrade

Assets

• New SKSE/Plugins/hdtSkinnedMeshConfigs/configsPresets/2.5.1 Default.xml — stock FSMP 2.5.1 values as a selectable preset
• New interface/FSMP/Logo.dds — MCM welcome-page banner

Test plan

• MCM opens with Logo on the default page
• Load 2.5.1 Default.xml preset; verify values apply and label shows "Loaded!"
• Modify a value externally in configs.xml; reopen MCM and confirm preset label clears
• Uninstall JContainers → MCM shows "Missing: JContainers" and configs.xml is not overwritten
• Uninstall PapyrusUtil SE → same, with correct label
• Upgrade from v3 save → version notification fires, preset detection runs fresh

You can try it by downloading the build here;

https://github.com/DaymareOn/FSMP-MCM/actions/runs/24492378227

Screenshots:

Note, the help section was something I experimented with, but removed. This is to show the dependency guard is working. Also validated configs.xml files were not corrupted.

Debug messages:
With only 1 missing dependency

With both missing dependencies

[coderabbitai]

📝 Walkthrough

Walkthrough

The pull request adds a new HDT Skinned Mesh Configs preset file and updates the FSMP MCM script to include dependency verification, preset auto-detection, and version management. Additionally, the build workflow now includes the Logo.dds asset in the distribution package.

Changes

Cohort / File(s)	Summary
Build Distribution .github/workflows/build.yml	Adds directory creation and file copying step to include Logo.dds in the packaged FSMP-MCM.zip output under Interface/FSMP/ path.
HDT Skinned Mesh Preset SKSE/Plugins/hdtSkinnedMeshConfigs/configsPresets/2.5.1 Default.xml	New XML configuration preset defining SMP subsystem settings (logging, NPC face parts, hair, rotation clamping, culling, skeleton auto-adjust), solver parameters (iterations, MLCP, ERP, FPS thresholds), and wind effect configuration.
MCM Script Logic Source/Scripts/FSMPM.psc	Updated version to 302 with version-upgrade handling; added dependency checking for JContainers and PapyrusUtil SE; implemented preset auto-detection via config matching; added helper functions checkDependencies() and configMatchesPreset(); modified initialization to gate configuration loading on dependency availability and display missing-dependencies page when needed.

Sequence Diagram(s)

sequenceDiagram
    participant MCM as MCM Script
    participant JC as JContainers
    participant PU as PapyrusUtil SE
    participant CF as Config Files
    participant UI as MCM UI

    MCM->>MCM: OnConfigInit() triggered
    MCM->>JC: JMap.object() test
    JC-->>MCM: result received
    MCM->>PU: PapyrusUtil.StringArray() test
    PU-->>MCM: result received
    MCM->>MCM: checkDependencies() evaluates
    alt Dependencies OK
        MCM->>CF: Load configFilePath
        CF-->>MCM: config loaded
        MCM->>CF: Check last preset name
        CF-->>MCM: preset data
        MCM->>MCM: configMatchesPreset() iterate tags
        MCM->>MCM: Auto-detect active preset
        MCM->>UI: Show config pages
    else Dependencies Missing
        MCM->>MCM: Build sMissingDependencies string
        MCM->>UI: Render disabled "Missing Dependencies" page
        MCM->>MCM: Exit early, skip map init
    end

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

• chore: update default configuration and quality presets #3: Modifies hdtSkinnedMeshConfigs preset settings including solver parameters (numIterations, maxSubSteps) that overlap with the new Default.xml preset configuration.
• feat: Ensure Max Active Skeletons Slider can be adjusted even when Auto Adjust the max number of NPC's is disabled and Add Default Preset #6: Updates FSMPM.psc preset-handling and initialization logic (preset naming and auto-detection behavior) that directly relates to the added preset matching functionality.
• feat: add support for frame time budget to configs and mcm #4: Changes FSMPM.psc version-upgrade handling and preset initialization flow, both of which are modified in this PR's script updates.

Poem

🐰 A preset hops into the mix,
Dependencies checked, no more tricks!
Version bumped to 302's glow,
Logo packed, watch our package grow—
Auto-detection steals the show! ✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title comprehensively captures the main changes: 2.5.1 preset addition, preset handling improvements, FSMP logo asset, and dependency guard mechanism to prevent config corruption.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}