MySims String Editor

A quick 'n dirty string viewer and editor for MySims and MySims Kingdom.

Features

• View, edit, and organize string resources used in the supported MySims titles
• Export modified string tables to STR (game binary format)
• Live search functionality to quickly find strings by their ID or content
• Supports editing complex formatted strings with variables like $PLAYERNAME$, $COMBO_NAME$, $COMBO_OBJECTS$, and $COMBO_INTERESTS$
• Easily browse UI tooltips, category labels, and character names
• Scrollable and resizable UI for navigating large string tables

Example Use Case

• Modify in-game character names (e.g., change "Pigglez" to "Oinkster")
• Update or localize tooltips like Create a Random Sim or Change Glasses
• Patch category titles or UI labels for modding or translation purposes

Compatibility

The games in the list below are confirmed to be compatible with MySims String Editor:

• MySims (Cozy Bundle)
• MySims Kingdom (Cozy Bundle)
• MySims (Wii)
• MySims Kingdom (Wii)

How to Use

1. Open an .str file from the game data
   • MySims Cozy Bundle (Steam):
     C:\Program Files (x86)\Steam\steamapps\common\MySims\data\GameData\TextEAGLE\pc
   • MySims Kingdom Cozy Bundle (Steam):
     C:\Program Files (x86)\Steam\steamapps\common\MySims Kingdom\data\GameData\TextEAGLE\pc
   • MySims Cozy Bundle (EA):
     C:\Program Files\EA Games\MYSIMS\data\GameData\TextEAGLE\pc
   • MySims Kingdom Cozy Bundle (EA):
     C:\Program Files\EA Games\MYSIMS KINGDOM\data\GameData\TextEAGLE\pc
   • MySims and MySims Kingdom Wii:
     <path to your disk dump>\GameData\Text\wii
2. Optionally, open an .xml file from the game data to load readable string keys, found in the same directory as the previous step
3. Use the search bar to find string keys (e.g. BUNNY_CUTE_02) or values (e.g. Tubbert)
4. Edit the Text field as desired
5. Save your changes by exporting the file in .str format
6. Replace the in-game file to apply your edits

NOTE: You can also drop files onto the editor window to open them!

Placeholders

For a list of unique placeholders found in both games' XML files, please see the following documents:

• MySims
• MySims Kingdom

Building from Source

Windows

1. Clone the repository:
   • git clone --recurse-submodules https://github.com/bottledlactose/mysims-str-editor.git
2. Open the cloned folder in your preferred IDE
3. Build and run using MSVC or Clang-cl (recommended).

Linux

1. Ensure you have the correct dependencies installed:
   • GCC + CMake + X11 libraries + GTK3 (needed for NFD): sudo apt install build-essential cmake libx11-dev libxext-dev libxrandr-dev libxcursor-dev libxi-dev libxinerama-dev libgtk-3-dev
2. Clone the repository and compile the code:
   • git clone --recurse-submodules https://github.com/bottledlactose/mysims-str-editor.git
   • cd mysims-str-editor
   • mkdir build && cd build
   • cmake .. -DCMAKE_BUILD_TYPE=Release
   • make -j
3. Run the compiled binary:
   • ./mysims-str-editor

NOTE: Linux is supported, but with no pre-built binary available, you'll need to compile it yourself.

License

This project is licensed under the MIT License.