RanongTextureChanger Mod

Created by: RanongPatama
Version: 1.0.0
Target Game: House of Legacy (吾今有世家)

A BepInEx mod that allows players to customize and change their character's appearance (Hair, Face, Outfit/Clothes, and Expressions) in-game by swapping to other existing textures/assets already present in the original game files.

Features

• Fullscreen UI: Upgraded menu that dims the background and centers the character preview for a true character creator experience.
• Live Composite Preview: Instantly overlays layers (Back Hair -> Outfit -> Face -> Expression -> Front Hair) at a scaled-up 2.5x size on the UI Canvas with 100% native alignment and resolution.
• Category Support: Works with Clan Members, Spouses, and Retainers.
• Safety Checks: Validates asset IDs before applying them, preventing invalid inputs from corrupting your save files.
• Double-Buffered Transaction Undo: Reverts unsaved character preview changes back to their original states if you close the menu without applying.

Installation

1. Ensure you have BepInEx 5 installed for House of Legacy.
2. Place the RanongTextureChanger.dll file in your game's plugins folder: \House of Legacy\BepInEx\plugins\
3. Start the game.

How to Use

1. Load a save file and press F9 to open the changer.
2. Select a category (Clan Member, Spouse, Retainers) and select a character from the list.
3. Use the < and > buttons next to each appearance setting (or type a valid ID in the input box) to cycle through looks. Observe the live preview in the center of the screen.
4. Click Apply & Save Changes to commit your settings and update your save file.
5. Close the menu by pressing F9 or clicking the close button.

Changelog - RanongTextureChanger

1.0.0

• Initial release of RanongTextureChanger by RanongPatama.
• Fullscreen character creator interface layout.
• High-fidelity native Canvas-based composite portrait preview (renders hairs, outfits, faces, and expressions at a scaled-up 2.5x size).
• Double-buffered unsaved changes buffering and rollback undo system.
• Corrected gender mapping:
  • "0" -> Female ([F])
  • "1" -> Male ([M])
• Safe asset ID checks using the game's Resources.Load to block invalid values and prevent save file corruption.
• Instant ES3 save serialization and visual scene refresh.