Star Control: Origins (SCO) mods are contained in the ../My Games/Star Control/Universes/ directory.
To start one create a directory in this structure.
This new mod directory mirrors the Assets directory used by the main game. And most of the games assets and definitions are exposed to xml and csv files in this structure to make it easy for modders to add and modify content. If you look through the main games asset directory you can get a feel for the wide variety of options that are exposed and moddable. This document will not go through all of them, it will show examples that will allow you to make your own changes.
Making a mod requires a modder to get out into the file directories and get their hands dirty. Though there are parts that can be done from within the game (making new ships, buildings and uploading and updating your mod) and parts that can be done with Adventure Studio (creating dialog trees), it will also require manually updating files to bring it all together. We did that because with a tool you will only have the options the tool maker designs for you. When we give you access directly to the files you have the same control the designers who made the game have.
In that directory you will need to create a manifest file. The purpose of this file is to define what the Mod is.
With a new directory, and a manifest file you have made your very first Star Control: Origins mod. But it doesn't do anything yet. The next step is adding content.
Note: Your mod will not show up in Star Control's Multiverse screen until you've added content.
Adding content is fairly straight forward. Look in the main game directories at all the XML and CSV files and copy the structure under the Asset directory (so if the XML file is in the \Assets\Characters directory create a new \[Mod Directory]\Characters directory. Then add a new file with the same format for the new entries you want. Content, by default, is appended between the main game and mods so you can easily add new planets, solar systems, characters, ships, etc to the game.
Example: Adding a Ship - The Lander Tank (part 1)
In the Bounty Hunter mod, one of the bounties you are sent out to collect is for a crazy Drenkin who built a warship that is to heavy to get off of the planet. Now he just flies it around the planet destroying anything in his path. I call it the Lander Tank.
The first step is the most fun. We have to make a crazy tank in the games ship designer. This is what I came up with:
When you save these ship designs they are copied out to your ../My Games/Star Control/Designs/ directory. There will be three files, a png file (a picture of your ship), the scdesign file (the actual exported model), and a ShipXML file (which has the ships stats in it). Take all three files and put them in your mod's Ship directory. Go ahead and edit the ShipXML for whatever stats you would like it to have, the weapons you want it to use, etc. There are lots of parameters to tweak and hundreds of ships in SCO that you can use as examples.
With that done, you have added a ship to the game. But there is one giant problem. It doesn't show up anywhere. There isn't any in the universe, there is no way to get one, nothing. So we need more than just adding an asset to the game, we need the game to refer to it somewhere.
Since we want this ship to show up on a planet we want it to behave like a critter. So we will need to add a new critter to the game.
Example: Adding a Critter - The Lander Tank (part 2)
Critters are defined in the main games \Assets\Tables\Critters.csv file. CSV's are a different format than the xml used in most other places (I tried asking the developers about this, but they just grumbled at me). They are a little easier to read in Excel, and a bit more difficult to read in text editors like notepad++, but still easily moddable.
CSV files have a top line that defines what all the comma separated values are. Your mod needs that line and then lines for whatever content you are adding.
This is the CSV definition line for the Critters.csv file (shown in Excel):
The above line is just a copy from one of the drone critters that already exists in the game except we have switch the assetID to "LanderTank" (that's a ship design) and changed some of the values for health, wanderSpeed, etc.
Notice that we create a ship with the ship maker and now we are using that ship as a critter. Beneath the scenes ship designs can be used for many things. We can build immobile star bases, critters, buildings, things floating in space, weird things on planets. All as ship designs.
Now we have a new ship design, and a new critter that uses it. But it still doesn't show up anywhere in the game. There isn't any planet anywhere that has this new Lander Tank critter on it. to do that we are going to have to add a new planet template to the game.
Example: Adding a Planet template - The Lander Tank (part 3)
SCO's lead designer (Brad) had a lot of fun with planet templates. There are over 200 of them in SCO. Planet templates control just about every aspect of a planet, form the lighting and textures used, to the resources that are found there, to the critters and environmental hazards that are on them. Because we have so many planet templates and they may share some common features they are able to inherit from each other. So if a designer wants to create a new type of Green planet with more dangerous critters on it he can set it to inherit everything form Green and just change the critter definition. That way if we tweak the lighting or textures on the Green planet all the planet like it will get those changes.
This also means that when we add a new planet template with our mod (which we want to do to add the new Lander Tank critter on it) we can use inheritance to make it a very simple process.
This new planet template type inherits from Plutonic planets and its only change is that it adds the LanderTank critter that from the last step.
So now we have added a ship design, we have created a critter that uses that design, we have added a planet template that has that critter. But we still don't have anything in the game because no existing planet uses this new planet template. Our last step it to modify the galaxy file so that a planet in the SCO universe uses our new planet template.
Modifying Existing Content
Outside of adding new content with your mod, you may also want to modify existing content. When we do this we need to specify exactly what asset our mod is changing and supply the new values. To decrease the chance that we will conflict with another mod, we will want to specify only the specific changes we want. That way one mod can change the camera view in melee combat, while another changes the damage from crashing into a planet, and another changes lighting. Of course if two mods both change the damage from crashing into a planet, there will be a conflict but by minimizing our change we may conflicts less likely.
Example: Changing a Planet Template - The Lander Tank (part 4)
In the Bounty Hunter mod I change two of the existing planets in SCO to a new planet template. I switch one to an existing template (PlutonicDronesHard) and another to a new planet template provided by the mod (PlutonicLanderTank).
Looking through the game files I see that there is a ..\Assets\Galaxies\StarControlGalaxy.xml file. This file has the definitions for all the games stars, planets and moons. We have already covered how we would add new content to this structure, but in this example we want to modify some existing entries.
To do that, create a Galaxies directory (mirror the structure used by the main game) in our mod directory (..\Universes\BountyHunter\Galaxies\) and in that directory create a StarControlGalaxy.xml file (same name as the file for the main game). The following is the file that would change those planet types:
There are a few key differences between this and content we are adding. Note that we have to specify the internal name of the asset we are changing at each level. So at the Galaxy level we specify intenralID="Origins_Origins" (we get that name from the main game StarControlGalaxy.xml file where it is specified. We also add a append="true" to that line to tell the game that we are modifying an existing asset.
After that the change is simple. Because the planets we are changing are nested in a solar system we need to specify the solar system using the internal name that it has in the main game file, and then specify the planet we are modifying by the internal name. If we were modifying a moon we would have an additional layer to get to the moon.
Note that the only thing we change about the planet is the one thing we want to change. We could copy all the information if we wanted but it makes our mod more likely to conflict with other mods and makes it more difficult to track what we have actually changed. Anything we don't include here will keep the valued assigned by the main game.
Now we can finally go to that planet and checkout our Lander Tank.
Example: Changing Game Parameters
Some of the most interesting files to mod are the parameter files. These are located in the base \Assets\ directory. In particular gameparameters.xml, meleeparameters.xml, planetparameters.xml and roverparameters.xml have thousands of options you can play with. These are the direct options the game designers used to tweak the game, and weren't designed just for modding. Because of that some of the options may be deprecated (may not do anything), and many may be poorly named. But they are open for you to play with.
Note: the parameter files break the "mirror the directory structure of the main game" rule we use everywhere else. Instead of being in the base directory like they are for the main game they need to be put in a "Params" directory for your mod.
These are the parameters from the melee section of the meleeparameters.xml file. The file has other sections for asteroids, asteroid belt, death ring, opponent types, wormholes, ion storms, pickups and more.
For this example we are going to make three changes to the melee camera so that I can get a better look at the cool ships in SCO. Those changes are:
Note that in the above we had to specify the internal name of the object we were modifying ("Default_MeleeParameters") and we got that name from the main games meleeparameters.xml file. After that, all the rules we learned in the preceding section apply. Make sure we have append="true" and only include the changes we want to make.
With those changes we we fight in melee we now have a closer camera and we see our ships in 3/4 view.
Adventure Studio is a tool Stardock used to create all the quests in the game. It has been made publicly available so that modders can use it as well.
Adventure Studio can be found where Star Control is installed. Look for ..\Star Control\AdventureStudio\AdventureStudio.exe.
NOTE: Adventure Studio currently modifies the following base game files, Counters.xml, Flags.xml, GalaxyMarkers.xml, StarControlCharacters.xml and StarControlFleets.xml. This is dangerous because as you are modding the game you risk breaking the main game. A steam verify files will put you back to normal, but will also wipe out any mod work you have to those files. Stardock is working on an update to Adventure Studio which will correctly break out Mod content, but it isn't available at the time of this writing. In the meantime modders can use Adventure Studio to make mods, but then need to manually move mod content into their mod directories.
When you first open Adventure Studio it will be looking for a directory. This is the Assets directory where your game is installed.
Example: Creating a Character
A character can be a wide range of things. It can be a ship flying around in space, an inhabited planet, a building on a planet you are exploring, a star base floating in hyperspace. Basically anything you interact with. Even the missing parts of the Tywom ship at the start of the game are "characters". To create a new character make sure you are on the StarControlCharacters.xml tab in Adventure Studio and press the + button in the upper left.
Character have several attributes:
Uploading a Mod
Uploading a mod to Steam Workshop is easy. Within the game the multiverse screen has an Upload button in the bottom right corner.
Once that is pressed you are taken to the Upload Mod screen. If you have filled out the name and description in the Manifest and included a preview image, those will all show up here automatically. Otherwsie you can fill out a name an description (I recommend putting this information in the manifest file otherwise you will need to type it in every time you update your mod).
Lastly don't forget to select who can see your mod. Most of the time you probably want it set to "Everyone". But if you forget you can change the accessibility for the mod in steam workshop.