Omniscye-SaveFileRenamer icon

SaveFileRenamer

Allows you to rename save files with custom display names directly in the save menu using right-click or F2. Names persist between sessions while preserving original files on disk.

Last updated 3 weeks ago
Total downloads 2561
Total rating 2 
Categories Mods Tools Client-side
Dependency string Omniscye-SaveFileRenamer-1.0.0
Dependants 4 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100
Zehs-REPOLib-2.1.0 icon
Zehs-REPOLib

Library for adding content to R.E.P.O.

Preferred version: 2.1.0

README

SaveFileRenamer

SaveFileRenamer is a utility mod for R.E.P.O. that allows you to rename your save files with custom display names directly from the in-game save menu. The actual save files remain unchanged on disk, but you can give them meaningful names for better organization.

SaveFileRenamer Screenshot

What It Does

  • Adds right-click or F2 editing functionality to save file entries in the menu
  • Creates an in-place text input field for renaming save files
  • Preserves original save file names on disk while displaying your custom names
  • Saves custom names to PlayerPrefs so they persist between game sessions
  • Integrates seamlessly with the game's existing menu system and sound effects
  • Character limit of 50 characters for display names
  • Escape to cancel editing, Enter or click away to confirm

How It Works

  • Uses Harmony to patch the MenuElementSaveFile class at runtime
  • Creates invisible input fields for each save file entry when the menu loads
  • Maps custom display names to original file names in memory
  • Stores the mapping in Unity's PlayerPrefs for persistence
  • Updates the display text while keeping the original saveFileName intact
  • Provides audio feedback using the game's native menu sound system

Usage

  1. Navigate to the save file menu in-game
  2. Right-click on any save file or press F2 while hovering over it
  3. Type your desired display name (up to 50 characters)
  4. Press Enter or click elsewhere to confirm, or Escape to cancel
  5. Your custom name will be saved and displayed immediately

Compatibility

  • Works with the existing save/load system without modification
  • Compatible with other mods that don't interfere with menu elements
  • Does not modify actual save files or file system operations
  • Only affects the visual display of save file names in menus

Technical

  • Written in C# using HarmonyLib for runtime patching
  • Patches MenuElementSaveFile.Start() and MenuElementSaveFile.Update() methods
  • Creates TMP_InputField components dynamically for text editing
  • Uses Unity's PlayerPrefs system for data persistence
  • Integrates with the game's MenuManager.MenuEffectClick() sound system
  • Handles input validation and UI state management

Credits

Created by Omniscye Idea was thought of by Jamie