角色展示

Display your character on the main menu, with mouse-based editing of its position and configurable options—including hiding the camera—via a config file.

While browsing Xiao Hei He (a Chinese gaming community), I saw someone asking why there’s no character showcase screen, so I made this mod.

Now compatible with model-replacement mods that use Custom Model Manager as a dependency!

This mod loads your character model onto the main menu (the model is generated only after clicking "Continue").
Initially, an instruction prompt will appear:
You can edit the model in the right portion of the screen (clicking this area closes the prompt).

• Left-click and drag to adjust the character’s horizontal and vertical position
• Use the mouse scroll wheel to adjust the character’s Z-axis position
• Right-click and drag to rotate the character
• Hold right-click and scroll to spin the character continuously
• Hold Shift and scroll to scale the character
• Click the middle mouse button to make the character face the camera
• Hold Ctrl and click the middle mouse button to reset to the default position

You can configure whether to hide the original camera model via the configuration file located in the mod directory.
The config file is loaded when the mod initializes and saved upon exiting the game.

• modelPosition: The model’s position relative to the camera (Y+ = up, X+ = right, Z+ = forward)
• modelRotation: The model’s Euler rotation angles
• modelScale: The model’s scale multiplier (default is 1)
• use: Whether to use the above-defined values (if set to false, defaults are used—but it automatically becomes true after first run for initialization)
• tip: Whether to show the instruction prompt (default is true; hidden after the first mouse click in the editable area)
• hideCamera: Whether to hide the original camera model (enabled by default)
• showSetEditButton: Whether to display the toggle button for edit mode (enabled by default)
• canEdit: Whether position editing is enabled (enabled by default)
• editSpeed: Sensitivity multiplier for editing actions (default is 1x)
• showEquipment: Whether to display equipped gear from your save file (enabled by default)
• supportCustomModel: Whether to detect custom model replacements (disabling this slightly speeds up loading—by less than 0.05s—but included for completeness) (enabled by default)
• useModConfig: Whether to generate settings for ModConfig (enabled by default)
• useModSetting: Whether to generate settings for ModSetting (enabled by default) (takes precedence over ModConfig if both are present)

The APIs of ModConfig and ModSetting introduce significant performance overhead; disabling them greatly improves loading speed.

1. Add editable equipment display — Implemented in v1.2
2. Support custom model replacement — Implemented in v1.4

V1.1

• Added a toggle button (bottom-right corner) to enable/disable editing (auto-fades to 10% opacity when idle)
• New config options:

– showSetEditButton: Show/hide the edit-mode toggle button (default: on)
– canEdit: Enable/disable position editing (default: on)
– editSpeed: Editing sensitivity multiplier (default: 1x)

• Adjusted movement, rotation, and scaling sensitivity for smoother, more consistent control

V1.2

• Added support for displaying equipped gear from your save file (does not include weapons)
• New config option:

– showEquipment: Whether to show equipped gear (default: on)

V1.3

• Added integration with ModConfig. If present, settings will appear in the in-game options menu (note: this mod only modifies the pause menu settings; since our mod operates on the main menu, full integration may require a separate mod that enables main-menu settings)

V1.4

• Added compatibility with model-replacement mods that depend on Custom Model Manager
• Note: This requires both Custom Model Manager and HarmonyLib as dependencies. Native functionality remains unaffected.
• Compatibility is implemented via Harmony patches and non-standard calls, so it may break after future game updates—please report issues promptly.

• New config option:

– supportCustomModel: Toggle detection of custom model replacement mods

V1.5

• Added support for ModSetting. If present, UI settings will be generated (this takes priority over ModConfig)
• New config options:

– useModConfig: Generate ModConfig-related settings (default: on)
– useModSetting: Generate ModSetting-related settings (default: on) (used preferentially if both are present)

---

Submit via BML