Combination and State Presets v4.5

4.5 Repositories, Combinations and State Presets

中文 · Home · Stable 4.6.0 · Upgrade guide

Applies to v4.5.2 and v4.6.0; locations below are for 4.6.0. The 4.0 guide preserves older behavior; it does not describe current overlay capture or F10 hot apply.

Repositories and Characters

Switch Files, Covers or Presets at the top of Repositories. Selecting a Mod or switching views does not deploy it. Details contains Preview, Shortcuts and State Slots; deployment requires an explicit action.

Character avatars use a folder's .imm_avatar.* or avatar.* first, then a manual binding, then folder-name matching. Use Avatar in the More menu above the character list (or the right-click menu) to change images, bind, restore the previous image or remove a custom image.

Directory-link mode defaults to one Mod per character: enabling another replaces the other links for that character. Check Allow several enabled Mods in the same menu to keep several for that character; repository settings can change the default. Copy mode does not automatically remove other copies for that character. Combination restoration asks before using several members under a single-selection character.

Choose a Preset Type

Type	Saved content	Entry point
Combination preset	Enabled Mod set, optionally with matching persistent values	Repository Presets workspace; overlay Save preset
Single-Mod state slot	One named set of the current Mod's persistent values	Mod Details → State Slots; overlay Save single-Mod preset
Whole-file snapshot	Entire d3dx_user.ini, including other Mods' values	State Slots → More…

Only recognized numeric global persist values are supported. Captured values must exist in the active parameter file; Mod defaults do not fill missing data. New Mod versions, paths or namespaces may require recapturing.

Capture from the Main Window

1. Deploy the desired Mods, adjust in game, press F10 and wait for the loader to save.
2. For a combination, open Presets, optionally include parameters, select the active loader's d3dx_user.ini, then create and name a profile. Without parameters, capture records only the Mod set.
3. For one Mod, select the active parameter file in its State Slots page and save a named slot. The latest saved, updated or restored slot is marked current.

Automatic F10 below applies to the overlay capture actions. Confirm that the loader has saved before using other capture actions.

Capture from the Overlay in 4.5.2

1. Select the game window in Shortcuts, manually enable input, and open the overlay with Ctrl + Alt + K. Endfield requires an elevated manager.
2. Choose Save preset for a combination, or Save single-Mod preset to name and capture the Mod selected when clicked. Blank names, duplicate names within that Mod and missing parameters prevent saving; cancelling creates no preset. Focus returns to the game after naming.
3. With a parameter file configured, the manager sends F10, waits for a changed file and two matching reads, then captures. F10 briefly reloads the scene; a 5-second timeout cancels the save.
4. If no target is selected, input is off or permission is insufficient, cancel to configure input or explicitly read the existing file. That may capture stale values. Combination capture without a configured parameter file saves the Mod set alone.

This capture flow does not make the parameter file read-only; it waits for any active hot apply to finish. Refresh rereads deployed Mods, bindings and slots. Successful enable, disable, link switching or combination restoration also refreshes automatically.

Ordinary Offline Restoration

Exit the game and loader first. Review and confirm combination changes in the main window: recognized deployments restore first, followed by matching parameter writes that preserve other Mods' values. For a single-Mod slot, use Restore loader state and confirm the game is closed.

Targeted restoration does not rewrite original Mod INIs. Checks still guard unknown target folders, namespace conflicts, duplicate deployment names and concurrent edits; do not bypass conflict prompts. Copy mode matches a unique folder name and cannot distinguish a manually created same-name copy, so review removals. Link mode verifies actual destinations.

F10 Hot Apply While Running (Experimental)

• Explicitly choose the running-game F10 hot-reload option when restoring a slot or whole-file snapshot.
• Overlay switching requires enabling its separate slot-switching option in Shortcuts, off by default, plus a target window and input sending. Click a slot to apply it; ● marks the current slot.
• After backing up and writing values, the manager temporarily makes the parameter file read-only around F10 to prevent stale loader memory from overwriting it, then restores the original attributes.
• The loader must save and reread parameters on F10. The manager still sends F10 if you customized the reload key. Undelivered input can let old values overwrite the file on game exit; check the status line and actual rendering.
• Restore combinations in the main window. Slot switching does not imply universal live restoration of arbitrary combinations.

F10 before capture has simulated-loader verification without automated real-game verification yet. See the 4.5.0 notes for the simulated and user-reported scope of experimental hot apply; this does not prove compatibility with every game or Mod.

More Operations and Backups

• Update or rename slots: State Slots → More…; flush loader state before updating values.
• Write Mod defaults: a separate explicit operation that changes Mod INIs. Each file gets an .imm-persist-*.bak backup and read-back verification, with automatic restoration on failure. Copy mode also updates the deployed copy.
• Import variant files (unverified): each variant becomes a slot. Real exported files have not been verified; compatibility with all tools is not promised.
• Whole-file snapshots: save, restore or open the snapshot folder. Restoration first backs up the current file and affects other Mods' values as well, unlike targeted single-Mod restoration.
• Configuration and Undo: combinations and slots are stored in WinUI3/beta-shell.json. Targeted writes create adjacent d3dx_user.ini.imm-persist-*.bak files; deployment backups are in Updates. Deployment Undo does not undo parameters.

See the shortcut and overlay guide and state-slot testing and real-game checks. Third-party Mods and loaders may lead to account penalties.