From technology to politics to video games; these are the random thoughts of a geek with too much time on his hands
Published on February 4, 2008 By Zoomba In Sins Modding

Download the Galaxy Forge Tool

Introduction

Note: Download the example map that accompanies this tutorial here.

Sins of a Solar Empire is an incredibly robust RT4X strategy game that allows you to grow your empire and conquer the galaxy. Games can last hours, weeks or even months. To start you off, Sins comes with dozens of pre-built maps, 3 sizes of randomized maps and a sophisticated in-game map generator that lets you define virtually every aspect of a map. Set your preferred planets, stars, distances etc and have the game automatically generate a map based on your choices. You can even share and distribute the map to friends, either via the Sins of a Solar Empire site, or directly in online multiplayer matches.

Unfortunately, the in-game designer doesn't give you complete control. You can't choose, for example, where you want a planet to be placed, or what you want it to connect to. You can't set how many militia forces are stationed there, or whether or not it's a homeworld, or if it's a pirate base. If you want to hand-craft your map, the in-game tools won't meet your needs.

Galaxy Forge is the answer to that problem. Part of the Forge Tools suite used by Ironclad Games to develop content for Sins of a Solar Empire, Galaxy Forge is a map editor tool that allows you to place stars, planets, travel lanes and more. You can build a map to your exact specifications. Do you want a multistar map with strategic choke points and no pirate base? No problem, just create it in Galaxy Forge and load it in the game. Galaxy Forge is a WYSIWYG editor, so placing planets, phase lanes, stars and more is as easy as a few clicks of the mouse.

While Galaxy Forge is incredibly easy to use for the amount of control it gives you, it's not fully an end-user-friendly tool. So, to get everyone up to speed as quickly as possible creating great maps to share with the community, I've created this short guide to building a complete map from start to finish..

WARNING: The editor has no undo feature, so be careful when you move elements or make any changes. Save early and often to make sure you don't accidentally delete something you've spent hours tweaking and customizing.

Getting Started with Galaxy Forge

Galaxy Forge is a stand-alone tool that does not use the main game to run. So you can install this on virtually any machine, even that old Pentium III you have stashed in the closet.

To start, make sure you have the Galaxy Forge tool downloaded to your PC. You can get a copy of the tools from the Sins of a Solar Empire website on the Downloads Page.

imageOnce you've downloaded and extracted the tool, open up Galaxy Forge.exe. You will be greeted by the following screen (pictured right). When you start the Galaxy Forge tool, you begin with a default map already setup with the following:

  • One Star set to random color
  • Two terran home planets
  • Two default players (NewPlayer0 and NewPlayer1)

Before you get started adding planets, phase lanes and more stars, you probably want to decide if this is going to be a 2,4,6,8 or 10 player map.

To modify the number of players in your game, go to the Edit menu and select "Players..."

image

imageThat will open up the Player editor tool. On a new map, you already have NewPlayer0 and NewPlayer1. Even if you want to make a two player map, you'll probably still want to edit the names of the players. Select a player from the left, and all of their editable options will appear in the box on the right.

For this simple guide, we'll focus on the following options:

  • Design Name - Name your race. This will be how the race is referenced in the editor only.
  • InGameName - The name of the race as displayed in-game if it belongs to the AI
  • StartingCredits - How many credits the player starts the game with.
  • StartingCrystal - How much crystal the player starts the game with.
  • StartingMetal - How much metal the player starts the game with.
I am going to stick with a simple two player map, and name the first player "Alcari Crusaders" and the second player "Vor Syndicate" and I'll leave them both with the default starting resources.

Naming Your Map & Filling in The Details

Now that you have a new map with your starting players setup, lets start to configure the big-picture details for the map. Click somewhere in the black space of the map to bring up the galaxy details in the settings panel on the right. imageThis is where you'll make some default changes about your map and how the editor works. Defaults These are basic settings for new planets, players and stars that are added to the map.

  • New Planet Type - The default planet type for any new planet you add to the map.
  • New Player Starting Credits/Metal/Crystal - The starting resources assigned when you add a new player to the map.
  • New Star Radius - The radius of any new star system added to the map

I'm going to leave these as my defaults for this tutorial map. Display The options for how the map is displayed in the map selection screen within Sins of a Solar Empire.

  • Browse Description - Description of your map. Put a line or two about the map, lore etc. This is the creative description players will read in the map browser.
  • Browse Picture - The icon associated with your designed map in the map browser. This image should be a .tga file and placed in the Textures directory where you installed Sins of a Solar Empire.

For my tutorial map, I'm going to use the description "An example map created to go along with the Galaxy Forge guide"

For Browse Picture, I'm going to be lazy and just take one of the existing scenario images and reuse that. In this case I'll use: ScenarioPicture-Fulcrum (found in \Textures\ScenarioPicture-Fulcrum.tga)

Edit

These are settings to edit how the editor works with scrolling and zooming and shows your current zoom level. These settings will not impact the map itself.

Galaxy

These are some overall game settings for your map. They will impact how the game plays.

  • Is First Capital Ship Free - Sets whether or not the first capital ship is free for players to purchase.
  • Planet Artifact Density - Value 0-100. Controls what percentage of planets will have artifacts on them.
  • Planet Bonus Density - Value 0-100. Controls what percentage of planets will have bonuses on them
  • Players - How many players have been added to the map (this number is based off of the Player editor)
  • Recommended Players - Set what kind of game(s) the map is best suited for (i.e. solo, 2v2, 4v4, FFA etc.)
  • Scale - Controls how big the galaxy is. Large values will spread out your galaxy more.

imageTo set the Recommended Players, click on the field, and you'll see a [...] button on the right. Click on that to bring up the Galaxy Scenario Game Type window.

By default, this is empty. Click "Add" and a new game type will be added. By default it's set to "Solo". However, if you select the item from the left, on the right you can change the type from a drop-down menu.

You can add multiple types if you have a large map you feel would work well for multiple configurations of players. A map designed for 10 players for example could be set for Solo, FFA, 5v5, 2v2v2v2v2 to fill all spots.

For the tutorial map, I think I'll leave the first capital ship as free, but bump up the % of planets with artifacts from the default 15 to 50 (I want this to be a rich map), but I'll leave the bonus density alone. I'm also going to designate my map as a solo only map since it's just two players.

Home Planet

These are the default settings for any planet you designate as a homeworld in your game. Setting any of these to 10 locks it, preventing the player from upgrading it further.

  • Exploration - How much of the planet has been explored. You explore planets to discover artifacts and planet bonuses.
  • Infrastructure - How much infrastructure the planet starts with. Building this up helps defend your planet against bombardment
  • Logistical - How much logistical infrastructure the planet starts with. Logistics limit the number of orbital structures you can place around a planet.
  • Population - How much population support your planet starts with. This limits how many people can live on a planet.
  • Tactical - How much tactical infrastructure your planet starts with. This limits the number of defense placements you can build around a planet.

For the tutorial map, I'm going to leave these alone. Ok, we have successfully configured all the meta details for our map. We've set description, picture, game type and messed with the distribution of artifacts. Now that all of the fluff details are out of the way, it's time to get down to the business of making the map!

Making the Map: Adding Planets, Stars and Phase Lanes

Ok, now for the fun part, actually drawing out the game map! For this part you'll be focusing almost exclusively on the map window, instead of the details window like the previous section. Here you'll place, move and connect up all the planets and stars you want to add to your map.

To start, lets look at our map as it stands

image

We have one star, two home worlds on opposite ends of the system, and that's it. There isn't even a phase lane connecting anything so if you loaded this map right now, you wouldn't be able to travel anywhere. The planets were auto-assigned to the two players we edited earlier.

Before we get started editing the map, there are a few controls that will make life much easier when trying to move around the map:

  • Panning The Map - Hold the middle mouse button and drag in any direction.
  • Zooming in and out - Scroll Wheel. When zooming in, it will center on wherever your mouse cursor is.
Now that that's out of the way, lets add a planet! There are two ways to do this:
  1. Double-click anywhere within the radius of the star
  2. Right-click anywhere within the radius of the star and select "Add Planet"

The planet added will have the default settings you defined when you were tweaking the overall map settings. So for this tutorial, it will auto-place a Terran planet.

I'm going to place a handful of planets around the map....

image

So now that I have all of my planets laid out approximately where I want them, it's time to connect them all together. To do this, right click on any planet, select "Add Connection" and then left click on the planet you want to connect with. Now let me connect up all of my planets...

image

At this point I have a fully functional game map. I could save this, load it up in the game and play it, but it would be a little bit boring considering all I have are Terran type planets, no pirates and just one other player to fight.

Editing Planets, Stars & Making Things Interesting

Every planet object on my map right now are terran planets with nothing special about them. We also have a star with the color set to random. Oh, and we haven't named a single planet, the star, or anything. Sure it's a technically complete map, but it just doesn't feel right. Here's a snapshot of the map loaded in the game:

image

The game will automatically name planets and stars you don't name, so technically you don't have to worry about that detail, but there's a lot more you probably want to tweak and fiddle with.

First off, having a few dozen Terran planets just doesn't look right. This is space, and habitable M class worlds are supposed to be rare right? Well, lets change things up a bit. To start with, we'll select the planet directly below the Vor Syndicate's home world. image

For editing the planet, you're going to be focusing on the details panel again.

Advanced

  • SpawnProbability - The chance that a planet exists in the game. 1 means always, 0 means never. You can set the value between the two for a % chance.
  • StartingUpgradeForArtifact - Controls what level of artifact upgrade the planet starts with
  • Starting UpgradeForCivilianModules - Controls what level of civilian module upgrade the planet starts with
  • StartingUpgradeForPopulation - Controls what level of population upgrade the planet starts with
  • StartingUpgradeForTacticalModules - Controls what level of tactical module upgrade the planet starts with.
Items
  • UseDefaultTemplate - Do you want to use the predefined planet template for this planet? This just gives you the standard structures and resources if it's an owned world, or if it's an empty planet occupied by militia.
Misc
  • Position - The X,Y coordinates of the planet on your map. Only edit these if you want very precise planet placement.
Name
  • Design Name - The name of the planet as displayed in the Galaxy Forge
  • InGame Name - What you want the planet to be named in the game.
Ownership
  • IsHomePlanet - Is this a homeworld?
  • Owner - Which player owns the planet at the start of the game.
Properties
  • Type - What type of planet do you want this to be? Terran, Ice, Gas Giant etc.
For a quick-and-dirty map, the only field you really have to play with is "Type" in the properties section. From there you can select any standard planet type programmed into the game. I will now go around my map, changing up the planet types to give me a slightly more interesting map to play on.

image

I now have a map with volcanic, ice, desert and terran planets. Various asteroids, Plasma & Magentic Storms, even a Pirate Base. This map pretty much covers everything and if you want to just do the basics to build a map that is playable with default settings, you're done. Just save the file and hand it out to your friends, or upload it to the Sins of a Solar Empire website for everyone to download.

There's a lot more under the covers that you can play with and tweak, but this guide was just meant to get your feet wet and familiarize you with the basic, bare-minimum steps needed to make a map.

And always remember you can open any map that comes with the game in Galaxy Forge to see exactly how Ironclad built each of the maps, what special options they used etc. It's perfectly alright to borrow heavily from great maps when you're trying to figure out how to get a planet to start with a specific artifact, or to give players a quick start by giving them a handful of ships to start out with.

If you have any more questions, be sure to visit the Sins of a Solar Empire Modding Forums. Players and developers alike will hopefully be able to answer any question you might have.

FAQ

Like with every mod tool, there are a handful of "gotchas" or places that aren't quite clear enough.  As people encounter problems/ask for help, we'll update this FAQ section with questions and answers we think everyone should know about when using the Galaxy Forge.

  1. I tried to load the map in my game, but I immediately get a victory/defeat screen after loading.  What's going on?
    Make sure you save the galaxy file in the Galaxy folder wherever you installed Sins of a Solar Empire (i.e. c:\Program Files\Stardock Games\Sins of a Solar Empire\Galaxy).  Do NOT save it in your local settings/app data directory.  Maps created with Galaxy forge will not load properly from that folder.

Comments (Page 71)
80 PagesFirst 69 70 71 72 73  Last
on Jul 11, 2012

Thanks for taking the time to answer my question. I may have just another one in store for you  

When looking through the wiki about the galaxy forge, It says how to set the percentage of you finding an artifact on a planet. But how to put a specific artifact on a planet is not mentioned in the tutorial, except that I could open original maps to look how they did it, though I have no idea which map uses that function.
 

on Jul 12, 2012

the only map that DOES use the fixed artifact is ancient gifts, and it is added to the spawn items for the planet.

harpo

 

on Jul 15, 2012

Hi guys,

I tried everything and I can't manage to play with the map I just downloaded. The actual map that I have downloaded is the 5-star fortress by Mascan (Updated Jan 14, 2011 by mascan). I got all the sins expension but I only play Rebellion. Using windows 7. Plz, anyone can help me? thank you!

 

EDIT : I was using the wrong map version. Found out that there is a Rebellion version of this map...

on Jul 15, 2012

Harpo, Or anyone for that matter:

I just downloaded the galaxy forge program and made a map in it. I put the map in the galaxy forge folder - MyDocuments\MyGames\Ironcladgames\SIns of a Solar Empire Rebellion\Galaxy Forge blah blah blah.

I go to run the map in the game and as I select the map type to go to galaxy forge, the game gives me a run time error C++ and then closes me out. 

Earlier, someone posted this exact same thing, and you said that it must have been made in the map designer, but I know I made the map in galaxy forge right in front of me here,

So now what?

- Pat-Riot.

on Jul 20, 2012

ok im sure this been asked and i may have missed it and i have been looking but would someone mind giving me a simple for dummys how to makes the maps work? im running windows 7 64 bit and iv been messing with the galaxy forge and i just cant get the maps to show up. iv posted them in the galaxy folder nothing shows up at all. im playing trinity the one i got off steam and i had it working before i had my comp fixed (should have saw how i had it before to do dumb me forgot) so a lil help be great as i been at it for 3 hours trying to get this going.

on Jul 20, 2012

partriot98526, the issue is that the current rebellion can NOT successfully read a mapversion 3 map, this broke in 1.02 and has not been fixed yet, and I have a beta rebel map updater to convert mapversion 0,1,2 & 3 to mapversion 4 that has a reply in my map updater thread.

exo83, the correct location for the galaxyforge3 maps is in the galaxyforge folder next to the mods folders, and the standard advice to locate the galaxyforge folder

the galaxyforge3.rar is able to be correctly opened with either of the following programs

winrar from www.winrar.com (note trial ware for 30 days)

7zip from www.7zip.org (open source freeware)

and here is my standard advice for maps/mapping

 then extract the entire rar to a folder, then create a desktop shortcut to the galaxyforge.exe in the folder.


assuming you have sins 1.193/entrenchment 1.053/diplomacy 1.34,  the galaxy forge maps NEED to be placed here for xp

C:\Documents and Settings\'user name'\Local Settings\Application Data\Ironclad Games\Sins of a Solar Empire\GalaxyForge

or for vista/windows 7

C:\Users\'user name'\AppData\Local\Ironclad Games\Sins of a Solar Empire\GalaxyForge.

for rebellion.80 and later the new path is

 My Documents\My Games\Ironclad Games\Sins of a Solar Empire Rebellion\GalaxyForge

these paths assume that your windows installation is on the C: drive and the user space(xp documents and settings,vista/7 users is also on the C: drive, just substitute the drive letter for your fully qualified path to your documents folder)

for sins 1.15/entrenchment 1.00 and earlier, the correct location IS the program files \galaxy folder, and you also NEED to edit the entrenchment's galaxy.manifest to include the maps and also the total count of maps

NOTE the first two folders after the 'user name' are hidden , so to see them you must first click on 'tools' then 'folder options', then 'view', then click on 'show hidden files& folders' then click ok, then you will be able to browse your want to the folder. I suggest when you find the folder that you create a shortcut to it on the desktop

NOTE 2 the 'user name' in the above paths is your WINDOWS login user name, eg Administrator

also the galaxy forge maps in the local apps galaxyforge folder only show up in the galaxy forge tab of map types in sins 1.16+/entrenchment 1.02+

if the map IS a galaxy forge and giving the instant win/loss screen then MAKE sure that EACH player has a home planet and is not for a particular mod that has extra home planets and stars

if the galaxy forge map is placed in the program files galaxy folder, then the map NEEDS to be manually added to the entrenchment & diplomacy galaxy.manifests(not recommended as EACH update will replace any files that are different or have been changed)

and if a map you want to play was released before 25th feb 2009 OR created with an earlier version of galaxyforge than version 3  then you will also need the sins map updater from here
http://dl.dropbox.com/u/8023186/harpo%20sins%20map%20updater%20for%201.191%2Be%2Bd.rar.

there is a second type of map which SHOULD be placed in the mapdesigner folder, you can tell if it is by the eighth line reads randomizeStartingPositions TRUE', if this line is FALSE then it is a galaxyforge map and could be in an older map format. the current map format version is 3 this can be seen in line two of the file. if the map is a version 0,1 or 2 then the map updater will make it playable in current versions and expansions and rebellion's latest map format is 4, and should NOT attempt to read older maps as it WILL CTD with a runtime error

the differences between map versions0,1 & 2 were only the addition of ONE line near the start of the file, BUT mapversion3 has 5 new lines PER PLANET/player & template and 5 changed lines per planet/player & template and WILL CAUSE THE minidump/freeze curse if you just change the version number.

harpo

on Jul 23, 2012

ok still nothing shows ups. do i need to make a folder named mods or galaxyforge? cause there is no mods folder in the trinity folder which is what i have cause thats what i got off steam and aside from the galaxyforge3 folder that has the program there is no galaxayforge folder ether.

 

I tryed makeing a mods folder and galaxyforge folder and still nothing at all when i run the game i run the trinity version dont know if that makes a difference. and my version of the game is up to date also.

on Jul 23, 2012

exo the path to the galaxyforge files on win7 64 bit IS


C:\Users\'user name'\AppData\Local\Ironclad Games\Sins of a Solar Empire\GalaxyForge.


NOTE the first two folders after the 'user name' are hidden , so to see them you must first click on 'control panel' then 'folder options', then 'view', then click on 'show hidden files& folders' then click ok, then you will be able to browse your want to the folder. I suggest when you find the folder that you create a shortcut to it on the desktop

NOTE 2 the 'user name' in the above paths is your WINDOWS login user name, eg Administrator

also the galaxy forge maps in the local apps galaxyforge folder only show up in the galaxy forge tab of map types in sins 1.16+/entrenchment 1.02+

harpo



on Jul 24, 2012

ok found it thanks sorry for the trouble been a big help none the less.

on Aug 05, 2012

wht cant i download anything from your website?

on Aug 05, 2012

if you are refering to my utilities, in the mod updater thread, I have both file fucktory(delay downloads refuse to allow due to 'no free download slots' and similar issues) and dropbox links, the dropbox usually work and am migrating to dropbox only due to the file fuctory issues.

 if you are refering to the galaxyforge links at the top of the page, I have no idea.

harpo

 

on Aug 29, 2012

Trying to mess around with this now, wanting to make a special 3 vs. 3 map with special planets. (wanting to have it so they ALWAYS have certain bonuses) But the only bonus I see is Crystal Miners. o.0

As for the extractors, how do you edit the planet so they always have 4 resource asteroids? (I think I see a way, but it lists them individually for each race...)

EDIT: (apparently I was using an older version...>.>)

...Yeah never mind, lol.

Better yet, just to be safe, where should I save it to open it up in Rebellion?

on Aug 29, 2012

the rebellion map location is 'My Games\Ironclad Games\Sins Of a Solar Empire Rebellion\GalaxyForge',

unless the map was a mapdesigner map then replace the 'GalaxyForge' with 'MapDesigner'.

and for rebellion there is my rebellion map updater for older maps and the galaxyforge included in the steamapps 'rebellion\galaxy forge' folder to create your own maps

harpo

 

on Sep 11, 2012

Hello,

Apologies if this has already been asked/explained, 40+ pages makes for some hefty reading.

I was wondering if someone could take the time to explain the following highlighted values to me for a planet?  I've already tried playing with some of them to try and find what they control, but I either notice no difference, or the game minidumps on me.  Oh, and this is Rebellion 1.3, Map ver 4.

 

    planet
        designName "Planet0"
        inGameName ""
        type "Terran"
        pos  [ 180 , 200 ]
        moveAreaRadius 40000.000000
        hyperspaceExitRadius 30000.000000
        owner ""
        isHomePlanet FALSE
        normalStartUpgradeLevelForPopulation 0
        normalStartUpgradeLevelForCivilianModules 0
        normalStartUpgradeLevelForTacticalModules 0
        normalStartUpgradeLevelForArtifacts 0
        normalStartUpgradeLevelForInfrastructure 0
        quickStartUpgradeLevelForPopulation 0
        quickStartUpgradeLevelForCivilianModules 0
        quickStartUpgradeLevelForTacticalModules 0
        quickStartUpgradeLevelForArtifacts 0
        quickStartUpgradeLevelForInfrastructure 0
        planetItems
            templateName ""
            subTemplates 2
            template "Template:LocalMilitia_Terran"
            template "Template:LocalMilitiaStrong"
            groups 1
            group
                condition
                    type "Always"
                    param ""
                owner "NoOwner"
                colonizeChance 0.000000
                items 1
                item "Artifact:PlanetBombingShield"
        spawnProbability 1.000000
        useDefaultTemplate FALSE
        entityCount 0
        asteroidCount 0

on Sep 11, 2012

furyofthestars
moveAreaRadius 40000.000000
hyperspaceExitRadius 30000.000000

Gravity well size.

furyofthestars
colonizeChance 0.000000

Chance for the planet to be colonized by militia. 1.0 = 100%.

furyofthestars
entityCount 0
asteroidCount 0

Don't mess with these.

80 PagesFirst 69 70 71 72 73  Last