Cosmoteer: Starship Architect & Commander

Cosmoteer: Starship Architect & Commander

speed control
 This topic has been pinned, so it's probably important
Kwhwwymwn  [developer] 19 Nov, 2022 @ 8:11am
Guide : How to modify Speed Control (adding and removing game speeds)
1) Locating the mod to copy

Depending on where you installed steam, the location of the steam folder can change, but its default location is C:\Program Files (x86)\Steam\

The mod is located at Steam\steamapps\workshop\content\799600\2879483102

"2879483102" (the ID of the mod) is the name of the mod folder, you want to copy that folder so any update of the mod won't remove your modifications, you should also rename your copy with an understandable name (the name of the folder doesn't matter) and move it somewhere easier to reach (at the end, to use your modified mod, it will be placed in C:\Users\[your name]\Saved Games\Cosmoteer\[your ID]\Mods).




2) The inside of the mod folder

In the mod folder, there is the mod.rules file, the logo and the Strings folder

.rules files can be opened as txt files, you don't need any special software, microsoft notepad works but a programming text editor with syntax highlighting (like notepad++ or vscode) is recommended for modding.

2)a) The mod.rules file

Every mod have a mod.rules file, it contain the mod metadata and the list of all the actions done by the mod.

For more informations, you can check the mod.rules of the example mod located at Steam\steamapps\common\Cosmoteer\Standard Mods\example_mod

In the mod.rules, there is the following metadata :
  • ID = "your_name.your_mod_name"
  • Name = "mod name"
  • Version = 1.2.3
  • CompatibleGameVersions = ["game version"]
  • ModifiesMultiplayer = true
  • Author = "your name"
  • Description = "text"
  • StringsFolder = "Strings"
  • Logo = "logo.png"

You should change the ID, Name, Author, and Description, especially if you are sharing your mod

The Version doesn't matter, it's optional so you can remove it and it's only useful to differenciate different versions of the mod

The CompatibleGameVersions doesn't matter much either, when it doesn't correspond to your game version, the game will display a warning but it won't prevent you from loading the mod, it is still recommended to list the game versions the mod was designed for

ModifiesMultiplayer = true shouldn't be moddified, it's here to prevent the mod users from playing with people that don't have the same version of the mod because that would cause a crash

StringsFolder = "Strings" and Logo = "logo.png" shouldn't be modified if you don't rename the Strings folder and the logo.png, the logo is optional so you can remove that line if you don't have one


There is also the Actions list that is the list off all changes made by the mod

2)b) the Strings folder

In this folder are stored the .rules files containing the text that will be displayed ingame (also called string files), only the en.rules (en for english) is necessary, but other languages can be added (like fr.rules for french, es.rules for spanish... you can check Steam\steamapps\common\Cosmoteer\Data\strings for all language in the game).

If you are playing comsoteer in a language that isn't part of the mod, the mod will diplay the english text instead.




3) Understanding the mod

This mod has 2 actions :

The first one remove the all the existing game speeds, because otherwise the new ones would be added after the existing ones, and it wouldn't be in ascending order

The second recreate the list of games speed with all the wanted values

The game speed element :

{ Speed=VALUE; NameKey="PATH1"; LongNameKey="PATH2" }

VALUE is the number corresponding to the speed, 1 is the regular speed, 2 is twice as fast and 0.5 is half of the regular speed. (I haven't tested but I assume it has to be greater than 0, I doubt setting it to -1 will make the game run in reverse)

You can write numbers as a fraction (ie: 1/2), a decimal with a zero (ie: 0.5) or a decimal without zero (ie: .5), all are understood by the game

PATH1 is the path inside the string file for the short name (displayed in the bar at the top of thescreen during a game)

PATH2 is the path inside the string file for the long name (displayed when choosing a game speed for a pvp match)

Some game speed elements are labelled vanilla, those have been copy pasted from the game file

The string files :

Curently the only string file is en.rules because half of the strings are the same as vanilla (and the translations are present in the game files) and most of the rest are numbers.

In this mod, all of the strings are under Hud, so all the paths will start by Hud/

The name of the strings don't matter much as long as they are unique and the paths are correct, but special characters aren't allowed

The content of the string must be between quotes and this is what will be displayed ingame




4) Modifying the mod

4)a) Removing a game speed

This is the easiest to do, you just have to delete the game speed element you don't want (including the "{" and "}")

You can also delete its names in the strings files, but the mod won't break if you forget that

Instead of deleting, you can comment out by adding // in front of the line, the game ignore what's written after the //

4)b) Adding a game speed

First you have to add a new game speed element to the list (it can be at the start, in the middle or at the end, depending of the speed value)

Then you have to add the coresponding names in the string files (and check if the paths are correct)




5) Using your mod

Once you have done your modifications and want to test your mod, you have to put your mod folder in C:\Users\[your name]\Saved Games\Cosmoteer\[your ID]\Mods

Then you can launch cosmoteer and your mod should appear in the mod list (if it doesn't and an error message pop up, it means you messed up somewhere)

After selecting it and restarting the game to load your mod, you can start a game and try every speeds, if it doesn't crash it means there is no error in your mod




If it crash and you need help, or if you have questions, you can message me here and I'll help when I'll get the time




I allow you to share your mod on the workshop, you don't have to but I'll apreciate if you credit me
< >
Showing 1-1 of 1 comments
Dr_Brixx 7 Jan @ 11:34am 
Thanks a lot. FYI you can set the VALUE to -1 and it launches without crashing, but trying to use this speed crashes the game, bc "Speed must not be less than zero. (Parameter 'value')" So I think it isn't possible (Maybe with some more modding, but I have never done that).
< >
Showing 1-1 of 1 comments
Per page: 1530 50