Overview

Adventure Localizer is a tool for adventure creators to make use of the localization fields present for adventures in Spore: Galactic Adventures. It adds 3 different cheats that interact with adventure text and localization tables, allowing players to easily convert non-localized text into localized text, and vice versa.

LocalizeAdventure - Saves adventure text into a locale file and inside adventures converts it into a format compatible with the now-created locale file.
SaveAdventureLocale - Saves adventure text into a locale file, but does not convert the adventure into a localized version. Good for transcribing adventures.
UnlocalizeAdventure - Converts a localized adventure into an unlocalized version, allowing the adventure to be shared online without the locale file installed to the game. Doing this also allows for the usual 192 character limit to be bypassed, proven text fields are not edited afterwards if Adventure Text Limit Break isn't installed.

Spore ModAPI Launcher Kit is required to install and use this mod!

Get Spore ModAPI Launcher Kit from here: http://davoonline.com/sporemodder/rob55rod/ModAPI/Public/

Guides - How to...

Create a localized adventure

You will need:

Text editor such as Notepad or Visual Studio Code
SporeModder FX
Spore ModAPI Launcher Kit and this mod installed to your game

Go to an adventure in the adventure editor. Press CTRL+SHIFT+C to open the cheat console after loading the adventure, and type in localizeAdventure. Press ENTER.

NOTE: Make sure you have all the text you need in the adventure before typing this out, and that you have generally finished work in it!
Save the adventure (preferably as new) and locate the .locale file with the same name as your adventure in C:\\Users\[username]\Documents\My Spore Creations\Locales.
Open the locale file with the text editor of your choosing. All of the adventure's text boxes' data should be there, stored safely.
Complete any changes to the script you want to finish, and then save the file. Create a new project in SporeModder FX where you will place your .locale file.

NOTE: If needed, line breaks in dialogues have to be replaced with ~br~, which will do the line breaks for you in runtime.

NOTE 2: There are two choices as for how you want to format your project.
- If you have plans for translating the adventure into multiple languages, having the following file structure in your project would help: (en-us and fi-fi correspond to language locales Spore uses, check which language code your game uses and adjust accordingly)
- If you no plans regarding translation, having this project layout is also fine (though not recommended in terms of compatibility):
Once you've done setting up your project in SporeModder FX, pack the mod and run the game again. Make sure the package has enough priority so it doesn't get overridden by other mods. If needed, set the package signature to GA Patch 5.1 in the project settings inside SporeModder FX.
- Load the adventure you localized. It should display the new contents of your locale file inside the adventure, depending on the game's language.
Currently localized adventures cannot be shared to the official Spore servers. I mean, you could try, but all your players would see are a bunch of *** characters, as they would need the mod you just created to view and play the adventure correctly.
- Good way to utilize localized adventures properly is to include them in a SporeModder FX project alongside their localisations. You will need to have the Creation ZIP Porter mod installed and input the adventureExport cheat from that mod immediately after localizeAdventure from this mod in the cheat console. This way, your just-localized adventure will appear as a .0x366A930D-type file in My Spore Creations\Archive, and should have the localizations applied once you pack the mod containing both the locale file and the adventure's files themselves.
  - Optionally, you can localize its Sporepedia card as well. For that purpose, you must find the first four values of the locale file, look at their values, and then reference them by replacing the author, tags, name and description fields with their "Locale" variants (authorLocale, tagsLocale, nameLocale and descriptionLocale) in the adventure's .pollen_metadata_t file, naming them in the format locale_name!0x[instance_id].
- For an offline creator who solely relies on PNGs for sharing, asking players to install this mod besides your localized adventure should prove no problem to you.

Unlocalize a localized adventure

For this to work, install Adventure Localizer with the Spore ModAPI Launcher Kit.
Go to an adventure that has been localized (like a Maxis adventure included with the install of the game, or an adventure localized with the localizeAdventure cheat and with the relevant locale file loaded in-game), open it in editor, and press CTRL+SHIFT+C to open the cheat console after loading has completed. Type in unlocalizeAdventure and press ENTER.
Save the adventure immediately afterwards (preferably as new if you need to do changes afterwards via the locale) and share it whichever method you prefer. Players will no longer need a locale file to view the adventure correctly, and as a bonus, text strings also don't comply to the 192 character limit imposed by the input fields of the adventure editor. Thus this will likely be the main thing you use this mod and localization in general for if, say, you share adventures to the official Spore servers.
- NOTE: It is recommended to install the Adventure Text Limit Break mod if you want to see your overlong text in the editor, and to fine-tune them accordingly after applying this cheat. It is not, however, needed for using the extended text as it is.

Save a locale file without modifying the adventure

Go to an adventure in the adventure editor. Press CTRL+SHIFT+C to open the cheat console after loading the adventure, and type in SaveAdventureLocale. Press ENTER.
A locale file of the adventure will be saved as if you just used localizeAdventure, but the adventure itself is not modified to adjust with that. This option is good if all you needed was a reference or a transcript of the dialogue boxes found in the adventure itself for archival/research purposes.

Credits

Liskomato/Tenderi4 - Creating and coding the cheats, formatting and execution
Auntie Owl/Plencka - Concept for localizing adventures and packing them into .package files.
Miikka64 - Creator of Master of Time - Interlude, one of the adventures used in the testing of this mod.

Special thanks to:

Emd4600 - Creating the Spore ModAPI and overall research into Spore's code
Kade - Analyzing Spore file formats and data
VanillaCold & Zarklord - Helping out with the bugs on this project

Liskomato / Spore-AdventureLocalizer